Кальтер / Блог

Баг или новая функция: как заказчику оформить замечание подрядчику

Как оформить воспроизводимый дефект относительно принятого требования и отделить его от запроса на новую функцию.

Материал подготовлен с помощью ИИ; источники и примеры проверены редакцией ZASLON. Учебные примеры не описывают результаты клиентов.

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

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

В глоссарии ISTQB запись defect report (отчёт о дефекте) фиксирует возникновение, характер и статус дефекта. Confirmation testing — повторная проверка после исправления, подтверждающая, что исходный сбой больше не возникает. ISTQB называет acceptance testing уровнем проверки, который помогает решить, принимать ли систему. Это термины тестирования, а не коммерческие правила договора. ISTQB Glossary: defect report, acceptance testing, confirmation testing.

Учебный пример: сортировка поиска в CRM

В критерии приёмки версии 1.4 записано: «Результаты поиска компаний сортируются по названию в алфавитном порядке». Оператор вводит ал и видит две тестовые компании в неверной последовательности. Ожидаемое поведение: «Алмаз» → «Альфа». Фактически CRM показывает «Альфа» → «Алмаз». По русскому алфавиту буква М стоит раньше мягкого знака, поэтому «Алмаз» должна отображаться первой.

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

В соседнем тесте заказчик предлагает добавить поиск по ИНН. Если такого требования нет в спецификации версии 1.4 и согласованном объёме работ, это запрос на изменение, а не дефект. Если подписанная спецификация уже требовала поиск по ИНН, тогда нужно проверить именно это условие. Решение о цене и сроке сверяют по документам, а не по одному ярлыку в трекере.

Шаблон отчёта о дефекте

Поле Что записать
Требование и версия Раздел 4.2, спецификация v1.4
Среда Тестовая среда (staging), номер сборки и commit, браузер, операционная система, дата и время
Предусловия В CRM есть тестовые компании «Алмаз» и «Альфа»
Шаги Открыть CRM → раздел «Компании» → ввести ал → сравнить порядок
Ожидаемое Сначала «Алмаз», затем «Альфа»
Фактическое Сначала «Альфа», затем «Алмаз»
Повторяемость Например, 3 из 3 проверок — только если это действительно проверено
Доказательство Снимок экрана с тестовыми данными, запись экрана или журнал без персональных сведений
Влияние Пользователь может выбрать не ту организацию; серьёзность согласуется отдельно
Статус и ответственный Новое замечание, назначенный исполнитель, ожидает проверки или исправления
Повторная проверка После исправления повторить те же шаги и подтвердить, что исходный сбой устранён

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

Шаблон запроса на изменение

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

Если замечание блокирует приёмку, внеси его в общий журнал и укажи, какие другие сценарии можно продолжать проверять. После исправления повтори исходные шаги; если затронуты связанные функции, согласуй набор дополнительных регрессионных проверок. Сохрани отчёт, ответ подрядчика, ссылку на pull request или GitHub Release и результат повторной проверки.

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

Для общей приёмки системы смотри проверку по бизнес-сценариям, а для границ интеграции — что согласовать перед интеграцией CRM с сайтом.