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

Внешние характеристики.

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

ВНУТРЕННЯЯ СПЕЦИФИКАЦИЯ

Документ «Внутренняя спецификация» — предполагает нали­чие докумен­тов «Соглашение о требованиях» и «Внешняя специ­фикация». При этом предполагается также, что вся информация о том, что представляет собой программное изделие содержится в вышеназванных спецификациях.

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

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

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

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

Внутренняя спецификация имеет много назначений.

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

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

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

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

3.4.1 Архитектура функций /процедур

Описание структуры программы - ее относительно независимых кусков (процедур,

функций, модулей...) и интерфейса между ними (например, какие

параметры они друг другу передают и каков их содержательный

смысл - в терминах, сигнатуры). Использоуемый язык программирования.