Приложения
При изучении наук примеры полезнее правил.
Приложение А. Спецификация и ее структура
1. Общее описание.
Раздел, содержащий краткую характеристику программной единицы разработки (назначение, краткое описание, ограничения реализации).
2. Описание интерфейса.
Раздел, содержащий описание правил, форматов взаимодействия программы с внешним миром. В тех случаях, когда специфицируется программный модуль с несколькими вызываемыми процедурами, описания входа, выхода, хранимых данных могут повторяться для каждой компоненты.
2.1. Входные данные.
2.1.1. Данные, вводимые пользователем с клавиатуры.
В разделе описываются форматы входных строк данных, получаемых от пользователя. Возможно включение текстов приглашающих сообщений из раздела 2.2.1.
2.1.2. Параметры - данные, передаваемые из среды ОС.
В разделе описывается формат данных командной строки, передаваемой из среды операционной системы при вызове программы.
2.1.3. Хранимые данные.
Раздел описывает форматы данных на внешних носителях, может быть вынесен в пункт 2.3.
2.1.4. Информационное окружение до начала работы.
Раздел описывает структуру носителей данных директории, файлы, ограничения доступа и может быть вынесен в пункт 2.3.
2.2. Выходные данные.
2.2.1. Сообщения программы.
Форматы выходных строк сообщений на терминал пользователя. Желательно сопровождать комментариями, отражающими причину вывода сообщения.
2.2.2. Результаты вычисления.
Форматы вывода основных результатов работы программы: количество строк, позиционирование, точность представления и пр.
2.2.3. Хранимые данные.
Раздел описывает форматы данных на внешних носителях, может быть вынесен в пункт 2.3.
2.2.4. Информационное окружение после завершения работы.
Раздел описывает структуру носителей данных директории, файлы, ограничения доступа, сформированные в процессе работы программы, и может быть вынесен в пункт 2.3.
2.3. Хранимые данные (в файлах на внешних носителях).
Раздел может отсутствовать, если все было соотнесено со входом и выходом.
2.3.1. Общая структура информационного окружения.
В разделе описывается структура носителей, директорий.
2.3.2. Свойства файлов (наборов данных).
В разделе описываются свойства файлов, ограничения доступа, правила создания/уничтожения.
2.3.3. Форматы записей.
В разделе описываются форматы записей файлов, сведения об их упорядоченности, свойствах полей.
3. Функциональные требования.
Раздел содержит структурированный список требований. Первый способ: структура требований ориентирована на декомпозицию функций программы (ввод, вывод, контроль данных, расчет параметров, вычисление результата и т.п.). Второй способ ориентирован на про-цедурное описание требований. То есть производится описание того, как должна действовать программа.
Каждое требование должно иметь свой уникальный номер 3.1., 3.1.1. и иметь вид:
Программа должна проверить, что если ... то ...
4. Тест-требования.
Раздел содержит описание того, что надо проверить, для того, чтобы убедиться, что соответствующая функциональность присутствует в программной реализации.
Каждое требование должно иметь свой уникальный номер 4.1., 4.1.1. и иметь вид:
Проверить, что ...
5. Реализация.
- Проект реализации.
- Код программы.
- Дополнительные тест-требования.
В разделе описываются свойства, определяемые спецификой реализации.
6. Тест-план.
Тест-план - программа действий, направленных на то, чтобы убедиться, что все требования к программе выполняются и проверены. Обычно имеет формат таблицы с полями:
- порядковый номер теста,
- проверяемые требования,
- исходные данные,
- ожидаемый результат,
- комментарий к сути проверяемого свойства.
Часто совмещают в одной таблице и тест-план, и протокол выполнения тестов, добавляя поле фактического результата.
Тест-план должен проверять реальную работу алгоритма при заданных требованиями входных воздействиях и поведение программы во внештатных ситуациях.
7. Отчет о прогоне тестов.
Результаты выполнения тестов.