Как спецификации связывают решение с кодом и тестами
Запрос «Добавить назначение специалиста на выезд» описывает задачу в общих чертах. Для реализации нужно решить, кто назначает специалиста, какие записи занимают время в расписании и что произойдёт при конфликте.
Уточнить ожидаемый результат
Часть ответов может быть в действующих требованиях. Например, права на назначение уже описаны для роли диспетчера. Оставшиеся решения можно сформулировать отдельно.
В нашем примере подтверждённый выезд занимает время специалиста. При пересечении система отклоняет новое назначение и сохраняет расписание. Диспетчер получает объяснение и может выбрать другое время или специалиста. Правило действует и при одновременных запросах.
Отразить правило в связанных спецификациях
В требовании фиксируем критерии приёмки. В сущности данных уточняем состояния выезда и связь со специалистом. В описании API указываем ответ при конфликте. В спецификации экрана определяем сообщение и доступные после отказа действия.
Перед применением проверьте, что записи согласованы. Если интерфейс обещает другой результат, чем контракт API, это нужно решить до внесения правок в код.
- Намерение
«Назначить техника»
Задать намерение - Уточнение
Какие визиты?Пересечения?При конфликте?
Ответить на вопросы - Спецификации
Предложения измененийТребования · ДанныеUI · API
Проверить и согласовать - Реализация
Связанные изменения кодаUI · APIДанные · Правила
Кодовый агент - Проверка
Код ↔ спецификацииВыполненные тестыQA через интерфейс
Проверить реализацию
Передать контекст в разработку
Укажите агенту запрос на изменение или ключ требования и нужную ветку. Из связанных спецификаций и архитектурных правил он может определить, какие части кода предстоит изменить.
Спецификация оставляет пространство для инженерного выбора. Например, команда задаёт ожидаемое поведение при параллельном назначении, а разработчик выбирает способ обеспечить его в действующей архитектуре.
Проверить реализацию
- При ревью найдите все пути назначения и проверьте, применяется ли ограничение в каждом из них.
- В автоматических тестах проверьте допустимый выезд, конфликт времени и параллельные запросы. Сверьте ответы API и сохранённые данные.
- Через интерфейс проверьте, может ли диспетчер понять причину отказа и продолжить работу.
Сохраните результаты вместе с редакцией требования и версией кода. Если выяснится, что правило не учитывает выезды, созданные через другой путь планирования, уточните исходное решение и добавьте соответствующую проверку.
Использовать те же связи при следующем изменении
Когда понадобится добавить исключение, откройте существующее требование и связанные записи. Из них видно, в каких данных, операциях, экранах и тестах действует правило и кто использует его результат.
В Reqode предложения можно подготовить в ИИ-аналитике, проверить по отдельности и применить согласованные редакции. Порядок работы подробнее разобран в руководстве по управлению требованиями.