АИС СоколКонтакты

Как согласовать приёмку программного модуля на понятных примерах

Подготовлено

Согласуйте приёмку модуля до начала работы на нескольких понятных примерах: исходное состояние, действие, ожидаемый результат, свидетельство и принимающий специалист. Успешный путь, ошибочные данные и недоступный ответ должны различаться.

Формулировка «модуль работает правильно» оставляет участникам разные способы её понять. Разработчик может показать отдельный расчёт, а заказчик ожидать готовый результат в основной системе. Матрица приёмки помогает заранее увидеть это расхождение и договориться о наблюдаемом итоге.

Переведите обещание в наблюдаемое действие

Учебный пример: модуль проверяет заявку и показывает результат сотруднику. Вместо «проверка заявок должна быть удобной» запишите конкретное действие: сотрудник открывает заявку и видит результат проверки с понятным указанием отсутствующих обязательных сведений.

Теперь можно обсуждать предмет приёмки: какую заявку открывают, какие сведения обязательны, что считается проверкой и где отображается итог. Эти условия предлагаются для учебной постановки. Они не описывают функции готового продукта и не заменяют согласование правил с его владельцем.

Один пример должен проверять один различимый результат. Если в него одновременно включить загрузку, расчёт, согласование и отправку в другую систему, будет трудно понять, на каком шаге расходятся ожидания. Общий путь полезно проверить отдельно после проверки его частей.

Опишите обычный успешный пример

Начните с заявки, в которой есть все согласованные обязательные сведения. Укажите исходное состояние, действие сотрудника и видимый итог. «Ответ не содержит ошибки» слишком неопределённо: важно назвать, что именно должен увидеть принимающий.

СлучайИсходное состояние и действиеОжидаемый результатСвидетельство и принимающий
Обычная заявкаВсе обязательные сведения есть; сотрудник запускает проверкуПоказан согласованный результат, относящийся к этой заявкеОбезличенный экран или запись проверки; назначенный специалист партнёра
Пустое обязательное полеВ учебной заявке не заполнена тема; сотрудник запускает проверкуПоказано, какое сведение отсутствует; успешная проверка не объявленаРезультат именно этого случая; тот же принимающий сверяет согласованное правило
Внешний ответ недоступенДля части проверки нужен внешний ответ, который не полученНезавершённая проверка различима с успешной и с подтверждённой ошибкой данныхСостояние проверки и доступное объяснение; при сквозной проверке участвует владелец внешней части

В этой матрице три заполненных учебных случая. Точные названия состояний, вид экрана и правила данных участники выбирают для своего модуля. Матрица не доказывает, что чужая система уже умеет их показывать.

Добавьте граничный и отрицательный примеры

Граничный пример помогает уточнить допустимый предел, а отрицательный — ожидаемое поведение при непригодных данных. Выбирайте их из реального состава задачи. Если ограничение длины поля ещё не согласовано, нельзя выдавать придуманное число символов за обязательное правило.

Для учебного модуля полезно сначала взять отсутствие одного обязательного сведения и отсутствие внешнего ответа. Это разные причины незавершённого результата. В первом случае может потребоваться исправление заявки, во втором — действие владельца внешней системы или проверка исхода запроса.

Не превращайте приёмочную таблицу в бесконечный перечень всевозможных сбоев. Сначала покройте согласованный пользовательский путь и существенные исключения. Если при разборе обнаруживается новая задача, отдельно определите, входит ли она в текущий объём.

Назовите свидетельство результата

К каждому примеру добавьте то, по чему принимающий сможет проверить итог: экран, запись, ответ системы или отчёт проверки. Одного сообщения «готово» недостаточно для сравнения с конкретным условием. При этом технический журнал не заменяет пользовательский результат, если в задании требуется видимое действие в интерфейсе.

Свидетельство должно относиться к нужному примеру и версии модуля. Снимок другой заявки или проверка прежней сборки не подтверждают новый результат. Не обязательно заранее выбирать сложный инструмент отчётности: для обсуждения достаточно согласовать, какое доказательство будет доступно участникам.

Различайте подготовленный сценарий, выполненную проверку и решение о приёмке. Таблица с ожидаемыми результатами — ещё не выполненный тест. Внутренняя проверка разработчика — ещё не решение назначенного принимающего.

Разведите проверку модуля и сквозную проверку

Отдельная проверка показывает поведение модуля при согласованном входе. Сквозная — результат в связанном продукте: от начала пользовательского действия до нужного итогового состояния. Для них могут требоваться разные участники и условия.

Например, модуль правильно описывает результат на подготовленном образце, но основная система передаёт другие данные. Это повод проверить границу, а не объявить весь продукт готовым на основании одного успешного случая. Назначьте, кто готовит общий вход, кто предоставляет внешнюю часть и кто подтверждает итог.

Если сквозная проверка пока недоступна, назовите точную зависимость. Можно сохранить результат отдельной проверки, не выдавая его за подтверждение всей связки. Правила фиксации самого решения в процессе рассмотрены отдельно в материале об обосновании согласования.

Согласуйте принимающего и изменённый объём

У принимающего должны быть полномочия подтвердить нужный результат и доступ к свидетельствам. Иначе таблица останется согласованной только на словах. До начала работы также определите, как записываются замечания и изменения требований.

Пример и версия согласованных условий:
Исходное состояние:
Действие пользователя:
Ожидаемый результат:
Где его наблюдаем:
Кто и чем подтверждает:
Что получилось фактически:
Есть ли расхождение:
Чего не хватает для вывода:
Решение принимающего и следующий шаг:

Если результат расходится с согласованным условием, разбирают ошибку в этом объёме. Если нужен иной результат, которого в условии не было, обсуждают изменение. Не каждое новое пожелание автоматически включается в прежнюю стоимость. УТП АИС Сокол «До результата — без доплат за наши ошибки.» относится к согласованной задаче; изменённые требования оцениваются отдельно.

Матрицу удобно использовать при обсуждении устройства и приёмки отдельного участка. Начать можно с одного действия и нескольких примеров, не составляя заранее большое техническое задание.

Если такой участок есть в вашем проекте, опишите одно действие и нужный результат. Первый разговор бесплатный; готовое ТЗ не обязательно.

Обсудить свою задачу