Сергей Сыроежкин Бизнес-аналитик, консультант В рамках курса лекций: «Разработка требований к программному обеспечению», мехмат, БГУ Спецификация

Итог разработки требований Задокументированное соглашение между клиентами и разработчиками о создаваемом продукте: Документ об образе и границах – бизнес- требования Варианты использования – пожелания пользователей Спецификация к требованиям – подробные функциональные и нефункциональные требования

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

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

Именование Нумерация по порядку Иерархическая нумерация Иерархические текстовые тэги

Вопросы при создании: Что делать, если информации не хватает? Пользовательские интерфейсы и спецификация требований к ПО Шаблон спецификации

Структура спецификации 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 Предположения и зависимости - Предположением (assumption) называется положение, которое считается истинным при отсутствии доказательства или определяющей информации

Структура спецификации 3. Функции системы З.х Функция системы X З.х.1 Описание и приоритеты З.х.2 Последовательности «воздействие - реакция» З.х.З Функциональные требования

Структура спецификации 4. Требования к внешнему интерфейсу - требования к внешнему интерфейсу определяют оборудование, ПО или элементы баз данных, с которыми система или компонент должны взаимодействовать. Пример: «Войны интерфейсов» - API vs GUI. 4.1 Интерфейсы пользователя 4.2 Интерфейсы оборудования 4.3 Интерфейсы ПО 4.4 Интерфейсы передачи информации

Структура спецификации 5. Другие нефункциональные требования 5.1 Требования к производительности - этот раздел можно пропустить, если все необходимые требования уже расписаны в других разделах Приложение А. Словарь терминов Приложение Б. Модели анализа Приложение В. Список вопросов

Принципы создания требований Идеального способа не существует. Лучший учитель опыт, который нарабатывается со временем. Есть только набор рекомендаций: полные предложения, последовательно используйте термины, детализируйте до ясности, излагайте последовательно, «списки, рисунки, графики и таблицы», избегайте двусмысленных и субъективных терминов…. и т.п.

Принципы создания требований Подробно, но без избыточности (ограничения при разработке). Нужный уровень детализации + варианты тестирования. Соблюдайте уровень детализации. Избегайте длинных повествовательных абзацев. Избегайте излишних положений о требованиях. Попытайтесь найти наиболее эффективный метод представления каждого требования. При создании требования сразу проверяйте его на качество.

Спасибо за внимание!