Структура файлов базы данных (Структура программных модулей)

Подраздел Структура файлов базы данных должен содержать схему взаимосвязи таблиц (файлов) базы данных и/или ER-модель (модель "сущность - связь").

Структура файла может быть описана следующим образом:

а) наименование и назначение файла;

б) обозначение файла (латиница);

в) перечень реквизитов (атрибутов) в порядке их следования в записях, с указанием по каждому реквизиту: наименования атрибута; обозначения атрибута (латиница); длины в знаках и диапазоны изменения (при необходимости); логических и семантических связей с другими реквизитами данного файла (отношения) или других; и т. д.

Перечень и структура файла могут быть описаны, например, в виде таб­лицы 1.

Таблица 1 - Структура файла "Gard.gdb"

Идентификатор поля	Тип поля	Длина поля	Описание поля
...

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

Рабочий проект

Этот раздел должен содержать подразделы: Алгоритм решения задачи, Описание программы, Контрольный пример, Руководство оператора (пользователя), Руководство программиста.

Алгоритм решения задачи

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

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

Описание стандартных символов блок-схемы алгоритма должно соответствовать правилам ЕСПД (ГОСТ 19.002-80 и 19.003-80).

Описание программы

Содержание программного документа «Описание программы» определенно ГОСТ 19.101-77. В соответствии с этим подраздел Описание программыраздела Рабочий проект должен содержать:

- общие сведения;

- функциональное назначение;

- описание логической структуры;

- используемые технические средства;

- вызов и загрузка;

- входные данные;

- выходные данные.

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

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

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

- размер программы (размер в байтах, количество отдельных модулей программы);

- основные типы данных, с которыми придется иметь дело (количество файлов данных, типы файлов данных);

- характер и уровень использования аппаратных, средств - центральных и периферийных.

В пункте "описание логической структуры" должны быть указаны:

- алгоритм программы;

- используемые методы;

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

- связи программы с другими программами.

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

В пункте "вызов и загрузка" должны быть указаны:

- способ вызова программы с соответствующего носителя данных;

- входные точки в программу.

Допускается указывать адреса загрузки, сведения об использовании оперативной памяти, объем программы.

В пункте "входные данные" должны быть указаны:

- характер, организация и предварительная подготовка входных данных;

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

В пункте "выходные данные" должны быть указаны:

- характер и организация выходных данных;

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

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

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

4.5.2.3 Контрольный пример

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

Подраздел Контрольный пример должен включать следующие пункты:

- назначение, основные функции;

- исходные данные;

- результаты расчета;

- проверка программы.

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

Пункты "исходные данные" и "результаты расчета" должны включать соответственно описания исходных и результатных данных для проверки программы (комплекса программ) и сами эти данные (дан­ные можно разместить всоответствующие приложения).

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

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

4.5.2.4 Руководство оператора (пользователя)

Структура и оформление программного документа «Руководство оператора (пользователя)» устанав­ливаются в соответствии с ГOCT 19.105 - 78. Руководство оператора должно содержать:

- сведения о назначении программы и информацию, достаточную для понимания функций программы и ее эксплуатации;

- условия, необходимые для выполнения программы (минималь­ный и (или) максимальный состав аппаратных и программных средств и т . п.);

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

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

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

Руководство программиста

Структура и оформление программного документа «Руководство программиста» устанав­ливаются в соответствии с ГOCT 19.504 - 79. Руководство программиста должно содержать следующие разделы:

- назначение и условия применения программ;

- характеристика программы;

- обращение к программе;

- входные и выходные данные;

- сообщения.

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

В разделе “характеристика программы” должно быть приведено описание основных характеристик и особенностей программы (временные характеристики, режим работы, средства контроля правильности выполнения и самовосстанавливаемости программы и т.п.).

В разделе “обращение к программе” должно быть приведено описание процедур вызова программы (способы передачи управления и параметров данных и др.).

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

В разделе “сообщения” должны быть указаны тексты сообщений, выдаваемых программисту или оператору в ходе выполнения программы, описание их содержания и действий, которые необходимо предпринять по этим сообщениям.

В приложении к руководству программиста могут быть приведены дополнительные материалы (примеры, иллюстрации, таблицы, графики и т.п.).

В зависимости от особенностей документы допускается объединять отдельные разделы или вводить новые.