Джина Гайд

Пример: требования и план их дополнения

Вымышленный сервис обработки обращений. Пример использует подход комплекта ПОС — два уровня HLR/REQ, предметные области, вопросы и связь с проверками. Он не описывает фактические требования ПОС и не задаёт обязательных бизнес-правил для других клиентов.

Исходное состояние

У команды есть код, трекер и несколько API-тестов. Целостного описания нет. Для Пилота выбраны изменения регистрации и маршрутизации обращений. Аналитик Мария отвечает за карту требований, владелец продукта Олег — за продуктовые решения, тестировщик Ирина — за сценарии проверки. Агент готовит черновики и предлагает связи.

Команда выбирает Markdown рядом с кодом. В другом проекте такими источниками могли бы остаться действующая база знаний и система тест-кейсов.

Источник Что в нём ведётся
Карта требований Регистрация, маршрутизация, ответ заявителю; сквозные права и сроки
Требования по областям Цели, границы и ожидаемые результаты
Спецификации Точные правила регистрации и маршрутизации
Приёмочные сценарии Условия, действия, ожидаемые результаты и данные
Вопросы и решения Неопределённости с владельцем и влиянием на задачи

Два уровня на одном примере

HLR-REG-001 — зарегистрировать обращение

REQ-REG-001 — успешная регистрация

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

REQ-REG-002 — отсутствует текст обращения

Если текст пуст или состоит только из пробелов, система не создаёт обращение и показывает у поля текста сообщение «Укажите текст обращения».

Для обеих спецификаций: родитель HLR-REG-001, источник DEC-REG-01, владелец Мария, статус согласовано. Правила длины текста, вложений и повторной отправки не следует домысливать из этих двух записей: они перечислены в карте как отдельные позиции для уточнения.

Связь с проверками

Правило Тест-кейс и ожидаемый результат Автоматизация Фактическая проверка
REQ-REG-001 CASE-REG-01: корректные данные → создано одно обращение, выдан номер, установлен статус Поддерживаемый API-тест; UI-проверка пока по сценарию Ссылка на прогон, ревизию кода, идентификатор сборочного артефакта, версии тестов и данных
REQ-REG-002 CASE-REG-02: пустая строка и пробелы → записи нет, отображается ожидаемое сообщение API-тест проверяет отказ; UI-автотест сообщения запланирован Результат API-прогона и отдельное доказательство проверки UI

Ожидаемые результаты взяты из согласованных правил. Успех API-теста не подтверждает отображение сообщения в UI. Запись о тест-кейсе не означает, что он уже автоматизирован или выполнен.

Работа с найденным расхождением

Агент обнаружил, что два запроса регистрации иногда создают два обращения. Это наблюдение кода и тестового прогона, а не согласованное требование.

Вопрос Q-REG-01: как распознавать повторную отправку, в течение какого периода и какой результат возвращать? Олег принимает решение, Мария уточняет правило, Ирина — проверки. До ответа не выполняется зависимое изменение обработки повторов; независимая задача переименования пункта меню продолжается.

Срез полноты и недельный план

На предварительной карте выбранного потока команда выделила 20 применимых позиций «сценарий × аспект». Из них 12 описаны и подтверждены, 5 описаны частично, 3 не описаны: 12/20 = 60%. Ещё две позиции признаны неприменимыми с обоснованием и в знаменатель не входят. Область подготовки ответа пока не обследована и в этот показатель не включена.

На неделе подтвердили ещё три позиции: 15/20 = 75% по той же карте. Затем нашли четыре существенные позиции по повторам и таймерам: новая карта даёт 15/24 = 62,5%. Это расширение известной области, а не потеря уже сделанной работы. Открытый вопрос о повторах виден отдельно от процента.

Работа параллельно продуктовым задачам Кто готовит / кто проверяет Ожидаемый результат недели
Уточнить повторы регистрации Агент и Мария / Олег Принято правило, описаны границы и исключения; обновлены затронутые спецификации
Описать таймер маршрутизации Агент и Мария / Олег и архитектор Согласованы начало отсчёта, календарь и поведение при просрочке
Дополнить проверки регистрации Агент / Ирина и разработчик Согласованные тест-кейсы связаны с правилами; новый API-тест повторяемо проходит, для UI есть отдельный план
Проверить соседние области Агент / Мария Уточнена карта зависимостей; новые пробелы внесены в общий план

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