Документирование прецедентов

Каждый прецедент должен быть описан с помощью документально зафиксированного потока событий (flow of events). Соответствующий текстовый документ определяет, что должна делать система, когда субъект инициирует прецедент. Структура документа, описывающего прецеденты, может варьироваться, однако типичное описание должно содержать следующие разделы:

● Предусловия, необходимые для инициирования прецедента.

● Детализированное описание потока событий, которое включает:

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

○ альтернативные потоки для определения исключительных ситуаций.

● Постусловия, определяющие состояние системы, по достижении которого прецедент завершается.

Документ, содержащий описания прецедента, развивается по ходу разработки. На ранней стадии определения требований составляется только краткое описание. Остальные части документа создаются постепенно и итеративно. Полный документ возникает в конце этапа спецификации требований. На этой стадии документ может быть дополнен прототипами GUI_экранов. Позднее документ по прецедентам используется для создания пользовательской документации для реализуемой системы.

Описательная спецификация прецедента Заказ сконфигурированного компьютера (Интернет-магазин) приведена в таблице 4.2.

Таблица 4.2. Прецедент Заказ сконфигурированного компьютера

Краткое описание	● Прецедент дает возможность Клиенту ввести заказ на покупку. Заказ включает адреса доставки товара и оплаты счета, а также детали условий оплаты
Актеры	● Клиент
Предусловия	● Клиент с помощью Internet-браузера выбирает страницу производителя компьютеров для ввода заказа. На Web-странице отображается подробная информация о сконфигурированном компьютере вместе с его ценой
Основной поток	● Начало прецедента совпадает с решением клиента заказать сконфигурированный компьютер с помощью выбора функции Продолжить (или аналогичной функции) при отображении на экране детализированной информации, относящейся к заказу. ● Система просит клиента ввести детали покупки, в том числе: имя продавца (если оно известно); детали, касающиеся доставки (имя и адрес клиента); детальную информацию по оплате (если она отличается от информации по доставке); способ оплаты (карточка или наличные) и произвольные комментарии. ● Клиент выбирает функцию Покупка (или аналогичную функцию) для отправки заказа производителю. ● Система присваивает уникальный номер заказа и клиентский учетный номер заказу на покупку и запоминает информацию о заказе в базе данных. ● Система отправляет клиенту по электронной почте номер заказа и ● клиентский номер клиенту вместе со всеми деталями, относящимися к заказу, в качестве подтверждения принятия заказа.
Альтернативные потоки	● Клиент инициирует функцию Покупка до того, как введет всю обязательную информацию. Система отображает на экране сообщение об ошибке и просит ввести пропущенную информацию. ● Клиент выбирает функцию Сброс (или аналогичную) для того, чтобы вернуться к исходной форме заказа на покупку. Система дает возможность клиенту вновь ввести информацию
Постусловия	● Если прецедент был успешным, заказ на покупку записывается в базу данных. В противном случае состояние системы остается неизменным