Каждая организация, специализирующаяся на разработке ПО, должна принять один или несколько стандартных шаблонов спецификации требований к ПО для использования в проектах. Доступны различные шаблоны спецификации (Davis, 1993; Robertson и Robertson, 1999; Leffingwell и Widring, 2000). Многие применяют шаблоны, созданные на основе того, что описан в IEEE Standard 830-1998, «IEEE Recommended Practice for Software Requirements Specifications» (IEEE, 1998b). Он годится для самых разных проектов, однако в нем встречаются ограничения и неясные места. Если вы беретесь за проекты различных типов и размеров, от конструирования новой объемной системы до небольших улучшений уже работающих систем, заведите для проектов каждого крупного класса отдельный шаблон спецификации.
| 1. Введение 1.1 Назначение 1.2 Соглашения, принятые документах 1.3 Предполагаемая аудитория и рекомендации по чтению 1.4 Границы проекта 1.5 Ссылки |
| 2. Общее описание 2.1 Общий взгляд на продукт 2.2 Особенности продукта 2.3 Классы и характеристики пользователей 2.4 Операционная среда 2.5 Ограничения проектирования и реализации 2.6 Документация для пользователей 2.7 Предположения и зависимости |
| 3. Функции системы 3.x Функция системы X 3.x.1 Описание и приоритеты З.х.2 Последовательности «воздействие - реакция» З.х.3 Функциональные требования |
| 4. Требования к внешнему интерфейсу 4.1 Интерфейсы пользователя 4.2 Интерфейсы оборудования 4.3 Интерфейсы ПО 4.4 Интерфейсы передачи информации |
| 5. Другие нефункциональные требования 5.1 Требования к производительности 5.2 Требования к охране труда 5.3 Требования к безопасности 5.4 Атрибуты качества |
| 6. Остальные требования Приложение А. Словарь терминов Приложение Б. Модели анализа Приложение Г. Список вопросов |
Рис. 10-1. Шаблон для спецификации требований к ПО
На рис. 10-1 показан шаблон спецификации требований к ПО, созданный на основе стандарта IEEE 830; в нем предлагается множество примеров дополнительных требований к продукту, которые вы можете включить в свою спецификацию. В приложении Г показан пример спецификации требований к ПО, производной от этого шаблона. Измените его в соответствии с особенностями вашего проекта. Если какой-то раздел вашего шаблона не годится для конкретного проекта, не удаляйте его заголовок, но укажите, что он неприменим. В этом случае у пользователя не возникнет подозрения, что что-то важное было пропущено по невнимательности. Если вам постоянно приходится пропускать одни и те же разделы, это означает, что шаблон следует настроить. Создайте оглавление и журнал изменений спецификации требований к ПО, где указаны дата изменения, сотрудник, внесенное изменение и ее причина. Иногда фрагмент информации логически подходит для нескольких разделов шаблона. Гораздо важнее аккуратно и последовательно фиксировать информацию, чем горячо обсуждать, где следует хранить каждый элемент.
Сравните рис. 5-2 и 10-1. Вы увидите, что шаблон спецификации требований к ПО и шаблон документа об образе и границах в некоторых местах перекрываются (например, общие элементы есть в границах проекта, в описании особенностей продукта и в разделах операционной среды). Причина кроется в том, что вы создали только один документ, касающийся требований. Если вы используете оба шаблона измените их таким образом, чтобы ликвидировать избыточность, при необходимости объединив разделы. Возможно, соответствующие разделы спецификации требований к ПО пригодятся для детализации определенного прогноза или высокоуровневой информации, содержащихся в документе об образе и границах проекта. Если же вы решите вырезать и вставить фрагменты из одного документа в другой, то возможна опасность того, что в обоих появятся ненужные повторы.
В следующих разделах этой главы рассказано, какую информацию следует включать в каждый раздел спецификации требований к ПО. Вы можете объединить материал с помощью ссылки на другие документы (например, об образе и границах проекта или спецификацию интерфейса), а не дублировать его в спецификации требований к ПО.
Введение
Введение представляет собой обзор, помогающий читателям разобраться в структуре и принципе использования спецификации требований к ПО.
Назначение
Определите продукт или приложение, требования для которого указаны в этом документе, в том числе редакцию или номер выпуска. Если эта спецификация требований к ПО относится только к части системы, идентифицируйте эту часть или подсистему.