Разделы пояснительной записки

Введение

1. Основание для разработки.

2. Назначение разработки и область применения.

3. Цели проекта. Цели продукта.

4. Анализ осуществимости проекта.

5. Требования пользователя.

5.1. Мандатные требования.

5.2. Ограничительные требования пользователя.

6. Требования к программному обеспечению.

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

6.2. Нефункциональные требования.

7. Матрица трассирования.

8. Проектирование программного обеспечения:

8.1. Функциональная модель

8.2. Модель данных ПО

8.3. Диаграмма классов

8.4. Описание алгоритмов

8.5. Описание программной реализации

9. Проектирование и проведение тестирования программного обеспечения.

10. Источники, использованные при разработке.

Приложения.

Приложения А. Экранные формы разработанного программного продукта в различные моменты его работы.

Приложение Б. Листинги исходных кодов разработанного программного продукта.

Содержание разделов

1 В разделе «Введение» следует указать наименование программы и (или) условное обозначение темы разработки. Коротко описать актуальность разработки.

2 В разделе «Основание для разработки» указать документ, на основе которого ведется разработка программного обеспечения с указанием даты утверждения документа и организации, которая его утвердила.

3 В разделе «Назначение и область применения» нужно описать назначение программы и краткую характеристику области её применения. Если проект будет использоваться как часть в комплексе с другими проектами. то надо описать систему или объект, с которым должна быть стыковка.

4 В разделе «Цели проекта. Цели продукта», прежде всего, перечислить цели проекта, а именно.

- Календарный план проекта.

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

- Цели для каждого вида тестирования.

- Особенности сопровождения создаваемого программного обеспечения, которые необходимо учитывать при разработке.

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

- Внутренняя организация документации при работе над проектом (архив, нотация, вид носителей).

- Критерии для оценки надёжности программного продукта и его эксплуатации.

- Ниже перечислены цели программного продукта, которые надо определить на этапе проектирования.

- Определение статуса и уровня доступа пользователей.

- Средства защиты (пароль, методы защиты).

- Подробное перечисление режимов и функций программного продукта.

- Определение среднего времени между отказами.

- Определение времени, необходимого для восстановления программы после отказа.

- Составление перечня возможных типов ошибок, которые надо учесть при проектировании тестов.

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

- Указание допустимого объема данных, часть которых может быть утрачена в случае отказа.

5 В разделе «Анализ осуществимости проекта» описание этого процесса.

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

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

Иерархическое представление также делает описание простым к пониманию, оценке на различных уровнях детализации и поддержке.

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

Рекомендуется использовать следующие методы.

- Метод, основанный на множестве опорных точек зрения.

- Сценарии и прецеденты. Модель прецедентов системы показывает связи между прецедентами.

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

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

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

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

9 В разделе «Требования к программному обеспечению» определение этих требований выполняется на основании АНАЛИЗА ТРЕБОВАНИЙ ПОЛЬЗОВАТЕЛЯ.

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

11 В разделе «Нефункциональные требования» о писывают характеристики программы, системного компонента, подсистемы и их окружения, ане поведение. Может быть приведен перечень ограничений, накладываемых на выполняемые действия и функции. Это может быть временные ограничения, ограничения на процесс разработки и стандарты. Указываются характеристики производительности, которым должна удовлетворять подсистема или ее компонент, такие, как скорость, точность или частота

12 В разделе «Матрица трассирования» должен быть выполнен анализ полноты требований к программному обеспечению, т.е. учитываются все требования пользователя. Одно требование пользователя может определять несколько требований к программному обеспечению Матрица трассировки не может содержать неучтенных требований пользователя и избыточных требований к ПО. Матрица трассировки – это таблица, содержащая атрибуты (номера) требований пользователя и требований к ПО, а также признаки соответствия между ними.

14. В разделе «Проектирование программного обеспечения» необходимо описать все этапы проектирования ПО: разработку моделей (функциональной, модели данных, диаграмм последовательности, кооперации и развертывания, диаграмму классов), разработку алгоритмов (результат оформить в виде блок-схем), детальное проектирование программного обеспечения (структурную схему ПО, межмодульные связи, описание модулей), реализацию программного обеспечения (описание программной реализации с указанием перечня модулей, их названия, назначения, параметров и переменных).

15. В разделе «Проектирование и проведение тестирования программного обеспечения» необходимо привести проектирование (план) тестирования и описание его проведения. Должны быть спроектированы и проведены системное, интеграционное и автономное тестирование. Результаты оформить в виде итоговых отчетов по каждому виду тестирования.

13 В разделе «Источники, используемые при разработке» необходимо указывать перечень научно-технических публикаций, нормативно-технических документов и других материалов, на которые есть ссылки в основном тексте.

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