Добавить новую функцию

Подходит для нового или изменённого поведения с проверяемым результатом. Разберём добавление фильтра по наличию товара.

Постановка

Добавить в каталог переключатель «В наличии». Учитывать остаток на выбранном складе. Если подходящих товаров нет, показать понятное сообщение.

Критерии приёмки описывают поведение для пользователя:

1. Без фильтра каталог работает как раньше.
2. С фильтром видны товары, доступные на выбранном складе.
3. Смена склада меняет выдачу.
4. Пустой результат корректно отображается.

Схема процесса

Изучение → План → Утверждение человеком → Реализация → Проверки → Приёмка

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

Этап	Зачем нужен	Ожидаемый результат
Изучить проект	Найти каталог, данные остатков и связанное поведение.	Карта изменения и замеченные ограничения.
Составить план	До работы с кодом определить подход и проверки.	План, связанный с критериями приёмки.
Утвердить план	Проверить объём и допустимость решения.	Решение человека или замечание автору плана.
Реализовать	Внести согласованное изменение.	Код и предусмотренные планом проверки.
Проверить	Убедиться в корректности и готовности стенда.	Покрытие критериев, доказательства, открытые дефекты и ограничения проверки.
Принять работу	Сопоставить результат с исходной задачей.	Приёмка или возврат исполнителю.

Что настроить в проекте

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

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

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

Выбрать сценарии по рискам

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

Что затронуто	Что проверить
Исходное состояние и OFF/ON	Сравнить поведение до изменения, с выключенным и включённым фильтром.
Сохранение настройки, если оно предусмотрено	Сохранить, закрыть и снова открыть экран; проверить загруженное значение и выдачу.
Намеренно пустой выбор, если он допустим	Убрать все выбранные значения, сохранить и открыть снова. Согласованный смысл пустого выбора не должен подменяться значениями по умолчанию.
Выключенные сущности в настройках	Если отключённый склад или другая сущность участвует в настройках, проверить согласованное поведение для её сохранённого выбора.
Пересечение параметров	Совместить переключатель, склад и другие влияющие на выдачу параметры; проверить общий результат.
Обновление уже открытого экрана	Если ожидается появление результата без перезагрузки, оставить экран открытым и проверить обновление после завершения обработки.

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

Пример инструкции этапу

Определи, где каталог получает остатки и выбранный склад.
Составь план добавления фильтра «В наличии».
Для каждого критерия приёмки укажи способ проверки.
Сохрани существующее поведение при выключенном фильтре.
Если информации о складе недостаточно, сформулируй вопрос человеку.

Эта инструкция — содержательный пример. В редакторе ей нужно назначить требуемый контекст и ожидаемый результат этапа.

Если работа не принята

На стенде обнаружилось, что фильтр учитывает общий остаток. Замечание:

Товар есть на другом складе, но отображается как доступный на выбранном. Учитывай остаток текущего склада и добавь проверку этого случая.

Возврат ведёт к исполнителю. Затем повторяются затронутые проверки, необходимые проверки прежнего поведения и приёмка. На повторе действуют правила проверяющего этапа. Сам повтор проверяющего этапа на прежнем коде проблему не исправляет.

Когда сократить маршрут

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

Следующий шаг: создать этот процесс в редакторе.