User Story на пальцах: как написать понятную историю

Одна фраза ещё не объясняет всё поведение системы. Чтобы передать историю в работу, обсудим детали.

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

Что нужно выяснить на обсуждении

• Какие статусы есть и кто их меняет?
• Где покупатель открывает свой заказ?
• Можно ли увидеть чужой заказ, подставив его номер в адрес?
• Что показать, если статус временно не удалось получить?
• Какие слова понятны покупателю вместо внутренних кодов системы?

Пусть команда согласовала четыре статуса: «Оформлен», «Собирается», «Готов к выдаче» и «Выдан». Это правила вымышленного магазина, а не универсальный перечень для любого продукта.

Пример Acceptance Criteria

Критерии приёмки (Acceptance Criteria, AC) описывают условия, по которым команда и заказчик проверят результат конкретной истории. В нашем случае:

1. Покупатель видит статус своего заказа. При открытии карточки собственного заказа на самовывоз отображается статус, полученный от сервиса заказов.
2. Статус показан понятным текстом. Используются согласованные названия: «Оформлен», «Собирается», «Готов к выдаче» или «Выдан».
3. Чужой заказ недоступен. При попытке открыть его по прямой ссылке данные заказа и его статус не раскрываются; покупатель видит сообщение «Заказ недоступен».
4. Ошибка загрузки не превращается в статус заказа. Если сервис недоступен, интерфейс показывает «Не удалось загрузить статус» и действие «Повторить», а не выдуманное состояние покупки.

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

Один критерий в формате «Дано — Когда — Тогда»

Удобно проверить правило на конкретной ситуации:

Дано: покупатель вошёл в личный кабинет, ему принадлежит заказ на самовывоз со статусом «Готов к выдаче».
Когда: покупатель открывает карточку этого заказа.
Тогда: в карточке отображается «Готов к выдаче».

И отдельно — доступ к чужим данным:

Дано: покупатель вошёл в личный кабинет, но заказ принадлежит другому покупателю.
Когда: он открывает прямую ссылку на этот заказ.
Тогда: отображается «Заказ недоступен», данные и статус заказа не раскрываются.

Здесь «Дано» задаёт исходные условия, «Когда» — действие, «Тогда» — наблюдаемый результат. Такую структуру используют в Given–When–Then и Gherkin. Чтобы обсудить пример с командой, автоматизировать тест сразу не требуется; для его запуска в инструменте понадобятся дополнительные определения шагов. Документация Cucumber.