Аннотация и содержание обязательны.

Текст документа должен состоять из следующих разделов: Назначение программы - назначение, возможности программы, ее основные характеристики, ограничения, накладываемые на область применения программы. Условия применения - условия, необходимые для выполнения программы (требования к необходимым для данной программы техническим средствам и другим программам, общие характеристики входной и выходной информации, а также требования и условия организационного, технического и технологического характера и т.п.). Описание задачи - определения задачи и методы ее решения. Входные и выходные данные - сведения о входных и выходных данных. В зависимости от особенностей программы допускается вводить дополнительные разделы или объединять отдельные разделы.

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

Аннотация и содержание обязательны.

Описание программы должно содержать следующие разделы: Общие сведения - обозначение и наименование программы; программное обеспечение, необходимое для функционирования программы; языки программирования, на которых написана программа. Функциональное назначение - классы решаемых задач и/или назначение программы и сведения о функциональных ограничениях на ее применение. Описание логической структуры - алгоритм программы; используемые методы; структура программы с описанием функций составных частей и связи между ними; связи программы с другими программами. Описание логической структуры программы выполняют с учетом текста программы на исходном языке. Используемые технические средства - типы ЭВМ и устройств, которые используются при работе программы. Вызов и загрузка - способы вызова программы с соответствующего носителя данных; входные точки в программу. Допускается здесь указывать адреса загрузки, сведения об использовании оперативной памяти, объем программы. Входные данные - характер, организация и предварительная подготовка входных данных, формат, описание и способ кодирования входных данных. Выходные данные - характер и организация выходных данных; формат, описание и способ кодирования выходных данных.

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

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

Пояснительная записка

Аннотация и содержание необязательны.

Пояснительная записка должна содержать следующие разделы: Введение - наименование программы и ее условное обозначение, а также документы, на основании которых ведется разработка, с указанием организации и даты утверждения. Назначение и область применения - назначение программы, краткая характеристика области применения программы. Технические характеристики - раздел должен содержать следующие подразделы: постановка задачи на разработку программы, описание применяемых математических методов и, при необходимости, описание допущений и ограничений, связанных с выбранным математическим аппаратом; описание алгоритма и (или) функционирования программы с обоснованием выбора схемы алгоритма решения задачи, возможные взаимодействия программы с другими программами; описание и обоснование выбора метода организации входных и выходных данных; описание и обоснование выбора состава технических и программных средств на основании проведенных расчетов и/или анализов, распределение носителей данных, которые использует программа. Ожидаемые технико-экономические показатели - технико-экономические показатели, обосновывающие преимущество выбранного варианта технического решения, а также, при необходимости, ожидаемые оперативные показатели. Источники, использованные при разработке - перечень научно-технических публикаций, нормативно-технических документов и других научно-технических материалов, на которые есть ссылки в основном тексте. В зависимости от особенностей документа отдельные разделы/подразделы допускается объединять, а также вводить новые.

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

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

Для облегчения вычерчивания и нахождения на схеме символов рекомендуется поле листа разбивать на зоны. Размеры зон устанавливают с учетом минимальных размеров символов, изображенных на данном листе. Допускается один символ размещать в двух и более зонах, если размер символа превышает размер зоны. Координаты зоны проставляют:
   по горизонтали - арабскими цифрами слева направо в верхней части листа;
     по вертикали - прописными буквами латинского алфавита сверху вниз в левой части листа.
Координаты зон в виде сочетания букв и цифр присваивают символам, вписанным в поля этих зон, например: A1, A2, A3, B1, B2, B3 и т.д. Если поле листа не разбито на зоны, символам присваивают порядковые номера.

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

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

Расстояние между параллельными линиями потока должно быть не менее 3 мм, между остальными символами схемы - не менее 5 мм.

Записи внутри символа или рядом с ним должны выполняться машинописью или чертежным шрифтом. Записи должны быть краткими. Сокращения слов и аббревиатуры, за стандартных и общепринятых, должны быть расшифрованы в нижней части поля схемы или в документе, к которому эта схема относится.
Записи внутри символа должны быть представлены так, чтобы их можно было читать слева направо и сверху вниз, независимо от направления потока. (Вид а должен быть прочитан как вид б).

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

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

Программа и методика испытаний

Аннотация и содержание необязательны.

Программа и методика испытаний должна содержать следующие разделы: Объект испытаний - наименование, область применения и обозначение испытуемой программы. Цель испытаний - цель проведения испытаний. Требования к программе - требования, подлежащие проверке во время испытаний и заданные в техническом задании на программу. Требования к программной документации - состав программной документации, предъявляемой на испытания, и специальные требования, если они заданы в техническом задании. Средства и порядок испытаний - технические и программные средства, используемые во время испытаний, а также проведения порядок испытаний. Методы испытаний - описания используемых методов испытаний. Методы испытаний рекомендуется по отдельным показателям располагать в последовательности, в которой эти показатели расположены в разделах "Требования к программе" и "Требования к программной документации". В методах испытаний должны быть приведены описания проверок с указанием результатов проведения испытаний (перечней тестовых примеров, контрольных распечаток тестовых примеров и т.п.).; В зависимости от особенностей документа допускается вводить дополнительные разделы.

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

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

Аннотация и содержание обязательны.

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

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

Аннотация и содержание обязательны.

Руководство программиста должно содержать следующие разделы: Назначение и условия применения - назначение и функции, условия, необходимые для выполнения (объем оперативной памяти, требования к составу и параметрам периферийных устройств, требования к программному обеспечению). Характеристики программы - описание основных характеристик и особенностей программы (временные характеристики, режим работы, средства контроля правильности выполнения и самовосстанавливаемости программы и т.п.).. Обращение к программе - описание процедур вызова программы (способы передачи управления и параметров данных и др.). Входные и выходные данные - описание организации входной и выходной информации и, при необходимости, ее кодирования. Сообщения -тексты сообщений, выдаваемых программисту или оператору в ходе выполнения программы, описание их содержания и действий, которые необходимо предпринять по этим сообщениям. В зависимости от особенностей документа допускается объединять отдельные разделы и вводить новые.

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

Аннотация и содержание обязательны.

Руководство системного программиста должно содержать следующие разделы: Общие сведения о программе - назначение и функции программы и сведения о технических и программных средствах, обеспечивающих выполнение данной программы. Структура программы - сведения о структуре программы, ее составных частях, о связях между составными частями и о связях с другими программами. Настройка программы - описание действий по настройке программы на условия конкретного применения (настройка на состав технических средств, выбор функций и др.). Проверка программы - описание способов проверки, позволяющих дать общее заключение о работоспособности программы (контрольные примеры, методы прогона, результаты). Дополнительные возможности - описание дополнительных разделов функциональных возможностей программы и способов их выбора. Сообщения системному программисту - тексты сообщений, выдаваемых в ходе выполнения программы, описания их содержания и действий, которые необходимо выполнять по этим сообщениям. В зависимости от особенностей документа допускается объединять отдельные разделы и вводить новые.
В обоснованных случаях допускается раздел "Дополнительные возможности" не приводить, а в наименованиях разделов опускать слово "программа" или заменять его на "наименование программы".

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

	E5, B1, A, 5 - идентификаторы соединителей в виде:
	буквы и цифры (координаты зоны листа)	При большой насыщенности схемы символами отдельные линии потока между удаленными друг от друга символами допускается обрывать. При этом в конце (начале) обрыва должен быть помещен символ "Соединитель"
	буквы
	цифры

Соотношение геометрических размеров символов

Размер a должен выбираться из ряда 10, 15, 20 мм. Допускается увеличивать размер a на число, кратное 5. Размер b равен 1,5a.
П р и м е ч а н и е. При ручном выполнении схем алгоритмов и программ для обязательных символов 1-5, 11, 12, 16, 29 и рекомендуемых символов 3 и 4 допускается устанавливать b равным 2a. Обязательные символы 7-10, 14 и рекомендуемый символ 8 допускается представлять в виде равнобедренного треугольника с катетом a.

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

Спецификация

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

Форма спецификации приведена на рисунке ниже:.

Спецификация в общем случае должна содержать разделы: документация; комплексы; компоненты. Аннотацию и содержание можно не включать в документ.

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

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

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

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

В графе "Обозначение" запись производят в одну строку. В остальных графах спецификации записи допускаются в несколько строк.

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

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

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

Стадия ТЕХНИЧЕСКОЕ ЗАДАНИЕ состоит из следующих этапов Обоснование необходимости разработки программы - на этом этапе выполняются: постановка задачи; сбор исходных материалов; выбор и обоснование критериев эффективности и качества разрабатываемой программы; обоснование необходимости проведения научно-исследовательских работ. Научно-исследовательские работы - на этом этапе выполняются: определение структуры входных и выходных данных; предварительный выбор методов решения задачи; обоснование целесообразности применения ранее разработанных программ; определение требований к техническим средствам; обоснование принципиальной возможности решения поставленной задачи. Разработка и утверждение технического задания - на этом этапе выполняются: определение требований к программе; разработка технико-экономического обоснования разработки программы; определение стадий, этапов и сроков разработки программы и документации на нее; выбор языков программирования; определение необходимости проведения научно-исследовательских работ на последующих стадиях.

Стадия ЭСКИЗНЫЙ ПРОЕКТ состоит из следующих этапов Разработка эскизного проекта - на этом этапе выполняются: предварительная разработка структуры входных и выходных данных. уточнение методов решения задачи; разработка общего описания алгоритма решения задачи; разработка технико-экономического обоснования. Утверждение эскизного проекта - на этом этапе выполняются: разработка пояснительной записки; согласование и утверждение эскизного проекта.

Стадия ТЕХНИЧЕСКИЙ ПРОЕКТ состоит из следующих этапов Разработка технического проекта - на этом этапе выполняются: уточнение структуры входных и выходных данных; разработка алгоритма решения задачи; определение формы представления входных и выходных данных; определение семантики и синтаксиса языка; разработка структуры программы; окончательное определение конфигурации технических средств. Утверждение технического проекта - на этом этапе выполняются: разработка плана мероприятий по разработке и внедрению программы; разработка пояснительной записки; согласование и утверждение технического проекта.

Техническое задание

Аннотацию и содержание допускается в документ не включать.

Техническое задание должно содержать следующие разделы: Введение - наименование, краткая характеристика, область применения программы и объекта, в котором используют программу. Основание для разработки - документ/документы, на основании которых ведется разработка; организация, утвердившая этот документ, и дата его утверждения; наименование и/или условное обозначение темы разработки. Назначение разработки - функциональное и эксплуатационное назначение программы. Требования к программе или программному изделию - раздел должен содержать следующие подразделы: Требования к функциональным характеристикам - требования к составу выполняемых функций, организации входных и выходных данных, временным характеристикам и т.д. Требования к надежности - требования к обеспечению надежного функционирования (обеспечения устойчивого функционирования, контроль входной и выходной информации, время восстановления после отказа и т.п.). Условия эксплуатации - условия эксплуатации (температура окружающего воздуха, относительная влажность и т.п. для выбранных типов носителей данных), при которых должны обеспечиваться заданные характеристики, а также вид обслуживания, необходимое количество и квалификация персонала. Требования к составу и параметрам технических средств - необходимый состав технических средств с указанием их основных технических характеристик. Требования к информационной и программной совместимости - требования к информационным структурам на входе и выходе и методам решения, исходным кодам, языкам программирования и программным средствам, используемым программой. Требования к маркировке и упаковке - требования к маркировке программного изделия, варианты и способы упаковки. Требования к транспортированию и хранению - транспортирования, места хранения, условия хранения, условия складирования, сроки хранения в различных условиях. Специальные требования. Требования к программной документации - предварительный состав программной документации и, при необходимости, специальные требования к ней. Технико-экономические показатели - ориентировочная экономическая эффективность, предполагаемая годовая потребность, экономические преимущества разработки по сравнению с лучшими отечественными и зарубежными образцами или аналогами. Стадии и этапы разработки - стадии разработки, этапы и содержание работ (перечень программных документов, которые должны быть разработаны, согласованы и утверждены), а также, как правило, сроки разработки и состав исполнителей. Порядок контроля и приемки - виды испытаний и общие требования к приемке работы.

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

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

Аннотация и содержание не являются обязательными.

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

Каждый из этих разделов характеризуется одним из типов символической записи, например: символическая запись на исходном языке; символическая запись на промежуточных языках; символическое представление машинных кодов и т.п.

В символическую запись разделов рекомендуется включать комментарии.

Титульный лист заполняют по форме и правилам, установленным для ЛУ, но при этом: Поле 1 - заполняется по требованию заказчика; Поле 2 - не заполняется. Поля 3,4 - как в ЛУ. Поле 5 - указывают объем документа; поле 6 - не заполняют; Поля 7-10 - как в ЛУ.

На титульном листе в левом верхнем углу должна быть надпись: Утвержден -------------- обозначение ЛУ

Пример заполнения титульного листа приведен ниже:

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

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

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

Состав и структура основной части программного документа устанавливаются стандартами ЕСПД на соответствующие документы.

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

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

1) Включается в документ при необходимости
2) Составляется в алфавитном порядке
3) Составляется в порядке возрастания номеров

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

Виды программ

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

Возможные варианты обозначения символов в схемах

	B2, B3, C2 - координаты зоны листа, в которой размещен символ	Координату зоны символа или порядковый номер проставляют слева в верхней части символа в разрыве его контура
	18, 19, 20 - порядковые номера символов на схеме
		Допускается не проставлять координаты символов при выполнении схем от руки и при наличии координатной сетки

Возможные варианты отображения решения

	A=B, P>=0 - условия решений; A, B, P - параметры	При числе исходов не более трех признак условия решения (Да, Нет, =, >,
	yi - условие i-го исхода, 011T1, 016A3, 005B5, 015T4 - адреса исходов. Структура адреса имеет вид:	При числе исходов более трех условие исхода проставляется в разрыве линии потока. Адрес исхода проставляется в продолжении условия исхода и отделяется от него пробелом;
	B5 - знак, указывающий, что условия решения даются в виде таблицы или символа "Комментарий", расположенных на данном листе в зоне B5	в символе "Соединитель" указывают координату зоны, куда должна помещаться таблица или символ "Комментарий";
		в таблице (в символе "Комментарий") приводят адреса всех исходов

Взаимодействие материальных потоков

	Применяют: при пересечении материальных потоков
	при объединении материальных потоков
	при разветвлении материальных потоков