Внешние характеристики.
Примечание. Если разрабатываемое ПО является расширением уже существующего, то описываются, главным образом, его дополнительные характеристики. В любом случае наибольшее внимание должно уделяться самым важным для конечного пользователя вопросам. Эти разделы являются основой документа и содержат полное и окончательное описание всех свойств программного изделия.
ВНУТРЕННЯЯ СПЕЦИФИКАЦИЯ
Документ «Внутренняя спецификация» — предполагает наличие документов «Соглашение о требованиях» и «Внешняя спецификация». При этом предполагается также, что вся информация о том, что представляет собой программное изделие содержится в вышеназванных спецификациях.
Внутренняя спецификация должна объяснять, как изделие устроено и как достигаются установленные для него цели и требования. От внутренней спецификации не требуется, чтобы она обеспечивала полное понимание пользователем работы программного обеспечения без обращения к тексту программ. Однако совместно с текстами программ внутренняя спецификация должна представлять пользователю информацию в полном объеме.
Внутренние спецификации являются своего рода записной книжкой проекта, заполняющейся по мере разработки программного изделия, которое она описывает («Рабочий проект».) Внутренняя спецификация описывается и утверждается еще до начала фазы программирования, так что руководство группы разработки имеет гарантию того, что проект тщательно продуман. Во внутренние спецификации всегда включаются описания всех используемых алгоритмов.
Программирование начинается лишь тогда, когда имеется достаточно полное описание данных и алгоритма их обработки, так что частичное тестирование программного обеспечения приобретает смысл, а блок-схема будущего изделия отработана настолько, что можно гарантировать корректную обработку нетривиальных исходных данных и получение нетривиальных результатов. С этого момента внутренняя спецификация и машинные программы разрабатываются совместно и могут снабжаться ссылками друг на друга для обеспечения полноты описания внутренней структуры программного обеспечения.
В процессе создания программ желательно включать в их листинги как можно больше информации, относящейся к документации внутреннего проектирования, чтобы внутренняя спецификация не содержала избыточных сведений. При этом на вынесенные в листинги сведения в документе «Внутренняя спецификация» заменяются соответствующими ссылками.
Внутренняя спецификация имеет много назначений.
Начинается она как рабочий журнал проекта, который показывает, как создается программное изделие, каковы его функции и что представляют собой алгоритмы, используемые для реализации этих функций. Без такого рабочего журнала мало надежды на сохранение информации о сложной внутренней структуре программного обеспечения при уходе основного персонала, занимающегося проектом, или при отсрочке работы над проектом даже на месяц.
По мере развития проекта и его внутренней спецификации последняя может использоваться как субъективный индикатор текущего состояния проекта.
Позже внутренняя спецификация включается в спецификацию сопровождения, которая представляет собой сочетание внутренней спецификации и листингов программ.
Наконец, внутренняя спецификация является широко используемым справочным документом, содержащим описания идей проекта, алгоритмов и даже модулей, которые могут быть полезны в последующих разработках.
3.4.1 Архитектура функций /процедур
Описание структуры программы - ее относительно независимых кусков (процедур,
функций, модулей...) и интерфейса между ними (например, какие
параметры они друг другу передают и каков их содержательный
смысл - в терминах, сигнатуры). Использоуемый язык программирования.
