Документирование разработки программного продукта.
Как было показано на рисунке 1.1. ЖЦ ПП сопровождается разработкой таких документов, как потребность в автоматизации, функциональная архитектура, системная архитектура и программный продукт. Остановимся подробнее на содержании этих документов, сопровождающих процесс разработки программ.
Потребность в автоматизации - в технике подобный документ называется техническим заданием (для его обозначения часто используется аббревиатура - ТЗ). Этот документ содержит описание целей автоматизации (или целей разрабатываемого программного продукта) с точки зрения пользователя ( или заказчика ПП).
В качестве примера можно привести следующий вариант ТЗ.
Разработать автоматизированную систему анализа успеваемости студентов одного факультета, которая позволяла бы:
получать итоговые ведомости успеваемости по отдельным академическим группам и по предметам;
получать списки неуспевающих студентов в академической группе и по предметам;
получать рейтинговые ведомости успеваемости студентов в академической группе и по предметам;
хранить и отображать ‘историю’ успеваемости студента до момента окончания вуза.
Словесная формулировка целей разрабатываемого ПП, как правило, сопровождается формами входных и выходных документов, перечислением отделов или других служб организации, которые являются источниками входной информации, указанием периодичности и сроков получения выходных документов, а также сроков хранения архива и другой подобной информацией (в данном тексте не приводятся).
Функциональная архитектура включает формализованное описание предъявляемых к ПП требований как с точки зрения пользователя, так и с точки зрения разработчика программ. В технике аналогичный документ называется техническими требованиями (аббревиатура - ТТ). В состав функциональной архитектуры должны входить: описание функций ПП, требуемых режимов функционирования среды, в которой будет реализовываться программный продукт.
Описание функций ПП удобно представлять в виде дерева целей, как на рисунке 1.4, на котором изображены основные и обеспечивающие функции, соответствующие приведенному выше техническому заданию.
Системная архитектура представляет собой документ, отражающий модульно-иерархическую структуру проектируемого программного продукта с подробным описанием функциональных спецификаций отдельных модулей. Последнее есть ни что иное, как блок-схемы программ (в ГОСТ они называются схемами программ) и другие схемы, описанные в том же ГОСТ. Следуя Винеру формулу программного продукта можно записать как ‘программный продукт = коды программ + проект’. Под проектом разработчики понимают окончательное и исчерпывающее обоснование и описание средств реализации поставленных целей.
. . . . . |
Сохранение архив. копий |
Защита от несакц. доступа |
Получение итоговой ведомости успеваемости |
Получение списков неуспевающих |
Получение рейтинговой ведомости успеваемости |
Восстановление из архив. копий |
Ввод результатов экзаменов |
Ввод информации из зачетной ведомости |
Корректировка инф-и об успеваемости |
Ввод информации об успеваемости |
Обработка информации об успеваемости |
Автоматизация анализа успеваемости студентов |
ь
Вывод результатов анализа |
. . . . . |
Рисунок 1.4. Пример функциональной архитектуры
При документировании проекта разработки ПО применяют схемы:
работы системы, в которой формализуется процесс выполнения программы, взаимодействие с пользователем и данными;
программ (или иначе блок-схем), в которых формализуется алгоритм обработки данных;
данных, в которых уточняются потоки данных между процессами и (или) носителями данных;
взаимодействия программ, отображающих путь активации программ и взаимодействий с данными;
ресурсов системы, отображающих конфигурацию блоков данных и обрабатывающих блоков, требуемую для решения задачи или набора задач.
Правила оформления схем описаны в ГОСТ 19.701-90 и /3/.
Общие рекомендации к выполнению схем следующие:
— схемы выполняются без соблюдения масштаба, действительное пространственное расположение составных частей изделия в схеме не учитывается или учитывается приближенно;
— в схемах применяют условные графические обозначения: чаще всего прямоугольники или другие простые фигуры. Размеры условных графических обозначений и толщина составляющих их линий должны быть одинаковыми на всех схемах проекта;