Документ описания требований

Содержание документа

Предварительные замечания к проекту

1.1. Цели и рамки проекта

1.2. Деловой контекст

1.3. Участники проекта

1.4. Идеи в отношении решений

1.5. Обзор документа

Системные сервисы

2.1. Рамки системы

2.2. Функциональные требования

2.3. Требования к данным

Системные ограничения

3.1. Требования к интерфейсу

3.2. Требования к производительности

3.3. Требования к безопасности

3.4. Эксплуатационные требования

3.5. Политические и юридические требования

3.6. Другие ограничения

Проектные вопросы

4.1. Открытые вопросы

4.2. Предварительный план-график

4.3. Предварительный бюджет

Приложения

Глоссарий

Деловые документы и формы

Ссылки

Рис.1 Содержание документа описаний требований

Хотя документ описания требований может быть как угодно далек от технических решений, все же важно обсудить идеи, касающиеся решения на самых ранних этапах жизненного цикла (ЖЦ) разработки. Особый интерес представляют готовые решения. Всегда неплохо рассмотреть вариант приобретения готового продукта вместо его разработки «с нуля». Документ описания требований должен предоставлять перечень существующих программных пакетов и компонент, которые должны быть в дальнейшем изучены в качестве вариантов возможных решений. Обратите внимание, что приобретение готового решения изменяет процесс разработки, однако это не избавляет от необходимости проведения анализа требований и проектирования системы!

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

Системные сервисы

Основная часть документа описания требований посвящена определению системных сервисов. Эта часть может занимать до половины всего объема документа. Это также, пожалуй, единственная часть документа, которая может содержать обобщенные модели — модели бизнес-требований. Рамки системы можно моделировать с помощью диаграммы контекста.

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

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

Системные ограничения

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

 Требования к интерфейсу.

 Требования к производительности.

 Требования к безопасности.

 Эксплуатационные требования.

 Политические и юридические требования.

Требования к интерфейсу определяют, как система взаимодействует с пользователями. В документе описания требований определяется только «впечатление и ощущение» от GUI-интерфейса. Начальное проектирование (закрашивание экрана) GUI-интерфейса проводится во время спецификации требований и позже во время системного проектирования.

В зависимости от области приложения требования к производительности могут играть довольно значительную роль в успехе проекта. В узком смысле они задают скорость (время отклика системы), с которой должны выполняться различные задания. В широком смысле, требования к производительности включают другие ограничения — в отношении надежности, готовности, пропускной способности и т. д.

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

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

Политические требования и юридические требования скорее подразумеваются, чем явно формулируются в документе описания требований. Подобная ошибка может обойтись очень дорого. Пока эти требования не выведены явно, программный продукт может быть трудно развернуть по политическим или юридическим причинам. Возможны и другие виды ограничений. Например, в отношении некоторых систем могут предъявляться повышенные требования к легкости их использования (требования в отношении пригодности к использованию) или легкости их сопровождения (требования в отношении пригодности к сопровождению). Значение выработки недвусмысленных определений для системных ограничений трудно переоценить. Существует немало примеров проектов, которые провалились из-за упущенных или неверно понятых ограничений. Эта проблема в равной мере относится как к заказчикам, так и к разработчикам. Недобросовестные или нерассудительные разработчики могут разыграть «карту системных ограничений», чтобы получить преимущество в своем стремлении уклониться от ответственности.

Проектные вопросы

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

В этой же части необходимо представить предварительный план- график выполнения основных проектных заданий. Сюда же относится предварительное распределение людских и других ресурсов. Для выработки стандартных плановых графиков можно использовать программные средства управления проектами, например, такие как система PERT (program evaluation_and_review technique — метод оценки и пересмотра планов) или карты Ганта.

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

Приложения

Приложения содержат остальную, полезную для понимания требований, информацию. Основным добавлением здесь служит глоссарий. Глоссарий определяет термины, сокращения и аббревиатуры, используемые в документе описания требований. Значение толкового глоссария трудно переоценить. Неверное истолкование терминологии таит в себе большую опасность для проекта. Одна из особенностей, которую часто упускают из виду при составлении документа описания требований, состоит в том, что в проблемной области, определяемой документом, можно довольно неплохо разобраться с помощью изучения документов и форм, используемых в процессах делопроизводства. При возможности следует включать в документ заполненные формы — «пустые» формы не дают такого же уровня понимания бизнес-процессов. Раздел ссылок содержит перечень документов, которые упоминаются или используются при подготовке документа описания

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