Комплекс стандартов на автоматизированные системы (КСАС)

Единая система программной документации (ЕСПД) - отечественный комплекс стандартов на программную документацию . В профессиональном просторечии его еще называют «девятнадцатым гостом» , что не совсем правильно, поскольку речь идет не об одном, а примерно о 30 разных нормативно-технических документах.

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

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

Стандарты ЕСПД были приняты в конце 70-х годов и дошли до нас в виде, близком к первоначальному. В них отражена практика работы ведомственных вычислительных центров, где эксплуатировались большие ЭВМ. Взаимодействие человека с компьютерной системой тогда было построено совсем не так, как теперь, и осуществлялось через громоздкие пульты, перфокарты и распечатки, а для «простых смертных», решающих прикладные задачи, еще и при посредничестве квалифицированного персонала. Надо ли долго объяснять, насколько эти стандарты к настоящему времени устарели? Достаточно сказать, что им неведомы такие распространенные сегодня документы, как руководство пользователя и руководство администратора .

И все-таки ими продолжают активно пользоваться. Формально «девятнадцатому» есть современная альтернатива. Переведены на русский язык и приняты в России на правах национальных некоторые стандарты ИСО/МЭК в области системной и программной инженерии . Но крупные, в том числе, государственные заказчики переходить на них не торопятся. Это можно объяснить их косностью (или верностью традиции, как вам больше нравится), но лишь отчасти.

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

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

Состав нормативно-технических документов

Обозначение	Наименование
ГОСТ 19.001-77	Общие положения
ГОСТ 19.002-80	Единая система программной документации. Схемы алгоритмов и программ. Правила выполнения
ГОСТ 19.004-80	Единая система программной документации. Термины и определения
ГОСТ 19.005-85	Единая система программной документации. Р-схемы алгоритмов и программ. Обозначения условные графические и правила выполнения
ГОСТ 19.101-77	Единая система программной документации. Виды программ и программных документов
ГОСТ 19.102-77	Единая система программной документации. Стадии разработки
ГОСТ 19.103-77	Единая система программной документации. Обозначение программ и программных документов
ГОСТ 19.104-78	Единая система программной документации. Основные надписи
ГОСТ 19 105-78	Единая система программной документации. Общие требования к программным документам
ГОСТ 19.106-78	Единая система программной документации. Требования к программным документам, выполненным печатным способом
ГОСТ 19.201-78	Единая система программной документации. Техническое задание
ГОСТ 19.202-78	Единая система программной документации. Спецификация. Требования к содержанию и оформлению
ГОСТ 19.301-79	Единая система программной документации. Программа и методика испытаний. Требования к содержанию и оформлению
ГОСТ 19.401-78	Единая система программной документации. Текст программы. Требования к содержанию и оформлению
ГОСТ 19.402-78	Единая система программной документации. Описание программы
ГОСТ 19 403-79	Единая система программной документации. Ведомость держателей подлинников
ГОСТ 19.404-79	Единая система программной документации. Пояснительная записка. Требования к содержанию и оформлению
ГОСТ 19.501-78	Единая система программной документации. Формуляр. Требования к содержанию и оформлению
ГОСТ 19.502-78	Единая система программной документации. Описание применения . Требования к содержанию и оформлению
ГОСТ 19.503-79	Единая система программной документации. Руководство системного программиста . Требования к содержанию и оформлению
ГОСТ 19.504-79	Единая система программной документации. Руководство программиста
ГОСТ 19.505-79	Единая система программной документации. Руководство оператора . Требования к содержанию и оформлению
ГОСТ 19.506-79	Единая система программной документации. Описание языка . Требования к содержанию и оформлению
ГОСТ 19.507-79	Единая система программной документации. Ведомость эксплуатационных документов
ГОСТ 19.508-79	Единая система программной документации. Руководство по техническому обслуживанию. Требования к содержанию и оформлению
ГОСТ 19.601-78	Единая система программной документации. Общие правила дублирования, учета и хранения
ГОСТ 19.602-78	Единая система программной документации. Правила дублирования, учета и хранения программных документов, выполненных печатным способом
ГОСТ 19.603-78	Единая система программной документации. Общие правила внесения изменений
ГОСТ 19.604-78	Единая система программной документации. Правила внесения изменений в программные документы, выполненные печатным способом

Приобретение стандартов

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

Единая система программной документации. Схемы алгоритмов и программ. Обозначения условные графические

Единая система программной документации. Термины и определения.

Единая система программной документации. Р-схемы алгоритмов и программ.

Единая система программной документации. Виды программ и программных документов.

Единая система программной документации. Стадии разработки.

Единая система программной документации. Обозначения программ и программных документов.

Единая система программной документации. Основные надписи.

Единая система программной документации. Общие требования к программным документам.

Единая система программной документации. Требования к программным документам, выполненным печатным способом.

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

Единая система программной документации. Спецификация. Требования к содержанию и оформлению.

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

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

Единая система программной документации. Описание программы.

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

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

Единая система программной документации. Формуляр. Требования к содержанию и оформлению.

Единая система программной документации. Общее описание. Требования к созданию и оформлению.

Единая система программной документации. Руководство системного программиста. Требования к содержанию и оформлению.

Единая система программной документации. Руководство программиста. Требования к содержанию и оформлению.

Единая система программной документации. Руководство оператора. Требования к содержанию и оформлению.

Единая система программной документации. Описание языка. Требования к содержанию и оформлению.

Единая система программной документации. Ведомость эксплуатационных документов.

Единая система программной документации. Руководство по техническом обслуживанию. Требования к содержанию и оформлению.

Единая система программной документации. Общие правила дублирования, учета и хранения.

Единая система программной документации. Правила дублирования, учета и хранения программных документов, выполненных печатным способом.

Единая система программной документации. Общие правила внесения изменений.

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

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

Состав еспд

ГОСТ 19.004 ЕСПД. Термины и определения.

ГОСТ 19.101 ЕСПД. Виды программ и программных документов.

ГОСТ 19.102 ЕСПД. Стадии разработки.

ГОСТ 19.103 ЕСПД. Обозначения программ и программных документов.

ГОСТ 19.104 ЕСПД. Основные надписи.

ГОСТ 19.105 ЕСПД. Общие требования к программным документам.

ГОСТ 19.106 ЕСПД. Требования к программным документам, выполненным печатным способом.

ГОСТ 19.201 ЕСПД. Техническое задание. Требование к содержанию и оформлению.

ГОСТ 19.202 ЕСПД. Спецификация. Требование к содержанию и оформлению.

ГОСТ 19.401 ЕСПД. Текст программы. Требование к содержанию и оформлению.

ГОСТ 19.402 ЕСПД. Описание программы.

ГОСТ 19.501 ЕСПД. Формуляр. Требование к содержанию и оформлению.

ГОСТ 19.502 ЕСПД. Общее описание. Требование к содержанию и оформлению.

ГОСТ 19.503 ЕСПД. Руководство системного программиста. Требование к содержанию и оформлению.

ГОСТ 19.504 ЕСПД. Руководство программиста. Требование к содержанию и оформлению.

ГОСТ 19.505 ЕСПД. Руководство оператора. Требование к содержанию и оформлению.

ГОСТ 19.506 ЕСПД. Описание языка. Требование к содержанию и оформлению.

ГОСТ 19.601 ЕСПД. Общее правила дублирования, учета и хранения.

ГОСТ 19.602 ЕСПД. Правила дублирования, учета и хранения программных документов, выполненных печатным способом.

ГОСТ 19.603 ЕСПД. Общие правила внесения изменений.

ГОСТ 19.604 ЕСПД. Правила внесения изменений в программные документы, выполненные печатным способом.

ГОСТ 19.001 ЕСПД. Общие положения.

Единая система программной документации (ЕСПД) – комплекс государственных стандартов, устанавливающих взаимоувязанные правила разработки, оформления и обращения программ и программной документации.

В стандартах ЕСПД устанавливаются требования, регламентирующие

разработку,

сопровождение,

изготовление и

эксплуатацию программ.

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

В состав ЕСПД входят следующие группы стандартов:

0 – Общие положения.

1 – Основополагающие стандарты.

2 – Правила выполнения документации разработки.

3 – Правила выполнения документации выполнения.

4 – Правила выполнения документации сопровождения.

5 – Правила выполнения эксплуатационной документации.

6 – Правила обращения программной документации.

7 – Резервная группа.

8 – Резервная группа.

9 – Прочие стандарты.

ГОСТ 19.101 ЕСПД. Виды программ и программных документов.

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

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

Программа-оригинал. Программа, предназначенная для хранения и воспроизводства с нее дубликатов.

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

Копия программы. Программа, предназначенная для непосредственной эксплуатации.

Виды программных документов (выборка для условий проектирования программ для ПЭВМ):

Техническое задание. Назначение и область применения программы, технические, технико-экономические и специальные требования, предъявляемые к программе, необходимые стадии и сроки разработки, виды испытаний.

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

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

Текст программы. Запись программы с необходимыми коментариями.

Описание программы. Сведения о логической структуре и функционировании программы.

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

Порядок и методика испытаний. Требования, подлежащие проверке при испытании программы, а также порядок и методы их контроля.

Руководство оператора (пользователя). Сведения для обеспечения процедуры общения с вычислительной системой в процессе выполнения программы.

ГОСТ 19.102 ЕСПД. Стадии разработки.

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

ГОСТ 19.201 ЕСПД. Техническое задание. Требование к содержанию и оформлению.

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

Техническое задание должно содержать следующие разделы:

Наименование и область применения.

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

Основание для разработки.

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

Назначение разработки.

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

Технические требования к программе или программному изделию.

В разделе должны содержаться следующие подразделы:

Требования к функциональным характеристикам.

Условия эксплуатации.

Требования к составу и параметрам технических средств.

Требования к информационной и программной совместимости.

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

В подразделе «Требования к составу и параметрам технических средств» указывают необходимый состав технических средств с указанием их технических характеристик.

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

Технико-экономические показатели.

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

Стадии и этапы разработки.

Порядок контроля и приемки.

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

ГОСТ 19.402 ЕСПД. Описание программы.

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

В разделе «Функциональное назначение» указывается назначение программы и приводят общее описание функционирования программы и сведения об ограничениях на применение.

В разделе «Описание логики» указывают:

Описание структуры программы и ее составных частей.

Описание функций составных частей и связей между ними.

Сведения о языке программирования.

Описание входных и выходных данных для каждой из составных частей.

Описание логики составных частей (при необходимости составляются описания схем программ).

При описании логики программы необходима привязка к тексту программы.

ГОСТ 19.505 ЕСПД. Руководство оператора. Требование к содержанию и оформлению.

Документ должен содержать следующие разделы:

Назначение программы.

Условия применения.

Пуск программы.

Команды оператора.

Сообщения оператору.

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

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

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

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

В свое время, когда я только начинал работать программистом, часто приходилось слышать “напиши, пожалуйста, документацию к своей программе”. Я честно все описывал, отдавал начальнику, после чего начинался сеанс черной магии. Начальник через некоторое время меня вызывал и начинал мычать нечленораздельные звуки, мять распечатку моего “самого лучшего” текста в руках, бегая глазами. Общий смысл его мычания заключался в том, что получилось “не то”, “не так”, и “посмотри, как делают другие”. Так как никакого другого ответа из него вытянуть было невозможно, я шел за примерами документов к “другим”. Как правило, это были веселые ребята, смысл речей которых заключался в том, что “вот примеры”, “вообще то по ГОСТу” и “это все никому не нужно”. Так я узнал впервые, что программист может соприкоснуться со страшными ГОСТами.
Поразительно, что среди многих десятков моих коллег, очень неглупых программистов, не было никого, кто бы относился к ГОСТам по другому. Даже те несколько человек, которые их знали и, вроде как, даже умели оформлять документы, относились к ним презрительно-формально. Ситуация, когда даже люди, ответственные за управление разработкой не понимают, зачем нужны ГОСТы и как их применят, встречается на многих предприятиях, сплошь и рядом. Да, были и компании, в которых понимали, чем “Описание программы” отличается от “Описания применения”, но таких было явное меньшинство. В интернете вообще господствует точка зрения, что ГОСТы для программистов - это явный рудимент, и нужны только если “нагибают” под них. Эскизный проект считают “сравнительно честным способом отъемы лишних дензнаков у заказчика”. Вникнуть и разобраться пришлось относительно недавно - в процессе разработки системы управления требованиями, заточенной под отечественную специфику. Документацию которая, разумеется, должна генерировать “по ГОСТу”.

Здесь я хочу сосредоточиться только на одной теме, с которой приходиться иметь дело программисту в отечественных предприятиях, особенно в НИИ - на наборе стандартов ЕСПД. Не считаю себя большим знатоком ЕСПД - есть люди, которые десятки лет по нему работают, и наверняка меня поправят. Статья скорее пытается набросать контуры «дорожной карты» для тех, кто только входит в курс дела.

Стандарты

Рассмотрим кратко, какие бывают стандарты (фокусируясь на ИТ-области).

международные. Отличительный признак - принят международной организацией. Пример такой организации - ISO (международная организация стандартизации). Пример её стандарта: ISO 2382-12:1988 (Переферийное оборудование). Распространены совместные стандарты ISO и международной электротехнической комиссии(IEC, в по русски - МЭК): например, ISO/IEC 12207:2008 (жизненный цикл ПО);
региональные. Отличительный признак - принят региональной комиссией по стандартизации. К примеру, многие советские ГОСТы сейчас являются региональным стандартом, т.к. приняты межгосударственным советом, куда входят некоторые бывшие советские республики. Этим советом принимаются и новые стандарты - и они тоже получают обозначение ГОСТ. Пример: ГОСТ 12.4.240-2013;
стандарты общественных объединений; К примеру, той же МЭК: IEC 60255;
национальные стандарты. Для России в начале таких стандартов - “ГОСТ Р”. Могут быть трех типов:
1. точные копии международных или региональных. Обозначаются неотличимо от “самописных” (национальных, написанных самостоятельно);
2. копии международных или региональных с дополнениями. Обозначаются добавлением к шифру отечественного стандарта шифра международного, который был взят за основу. Например: ГОСТ Р ИСО/МЭК 12207;
3. собственно, национальные стандарты. Например, ГОСТ Р 34.11-94.

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

ГОСТ

Итак: стандарты бывают международные, межгосударственные(региональные) и национальные. ГОСТ, как мы выяснили, это региональный стандарт. ГОСТы имеют достаточно запутанную, на мой взгляд, систему обозначений. Полностью она изложена в ГОСТ Р 1.5-2004, я приведу минимум, что бы в ней ориентироваться. Во первых, надо различать обозначение ГОСТа и его классификацию. Обозначение - это, грубо говоря, уникальный идентификатор стандарта. Код по классификатору - это вспомогательный код, помогающий найти стандарт или определить, к какой области знаний он относиться. Классификаторов может быть много, в основном используются два: КГС (классификатор государственных стандартов) и его наследник ОКС (общероссийский классификатор стандартов). Например: “ГОСТ Р 50628-2000“ - это обозначение стандарта.По обозначению понятно только то, что он принят в 2000 году. Он имеет код по ОКС “33.100;35.160”: т.е. “33” - раздел “Телекоммуникации, аудио, видео”, “100” - подраздел “электромагнитная совместимость”. Однако он также входит в ветвь классификатора 35.160. “35” - “Информационные технологии. Машины конторские”, “160” - “Микропроцессорные системы....”. А по КГС он имеет код “Э02”, что означает “Э” - “Электронная техника, радиоэлектроника и связь”, “0” - “Общие правила и нормы по электронной технике, радиоэлектронике и связи”, и т.д.

Если известно обозначение стандарта, то получить его коды по КГС и ОКС можно, к примеру, на вот этом толковом сайте .
Итак, вернемся к обозначениям ГОСТов. Их может быть два варианта:

стандарт относиться к серии стандартов. В этом случае после индекса категории стандарта (например, ГОСТ, ГОСТ Р или ГОСТ РВ) идет код серии, точка и обозначение стандарта внутри серии. Правила обозначения стандартов внутри серии устанавливаются правилами серии. Например: ГОСТ РВ 15.201-2000, ГОСТ Р 22.8.0-99, ГОСТ 19.101-77;
стандарт не относиться к серии стандартов. Тогда после индекса категории идет просто порядковый номер стандарта, тире и год принятия. Например, ГОСТ Р 50628-2000.

Итак, если совсем просто - то обозначение ГОСТа - это либо просто порядковый номер, тире, год, либо номер серии, точка и дальше в зависимости от серии. В реальности все сложнее (к примеру, можно встретить что то типа ГОСТ 11326.19-79, и это будет вовсе не серия 11326 - но программистам такое нужно очень редко. За подробностями - в ГОСТ Р 1.5-2004).

ЕСПД

ЕСПД - одна из таких серий ГОСТов, номер 19. Т.е. все стандарты, относящиеся к ЕСПД, начинаются с префикса “19.”: например, ГОСТ 19.106-78. Расшифровывается как “Единая система программной документации”. Существуют и другие серии:

ГОСТ ЕСКД (единая система конструкторской документации, префикс “2.”);
ГОСТ ЕСТД (единая система технологической документации, префикс “3.”);
ГОСТ Р, Система разработки и постановки продукции на производство, префикс “15.”;
ГОСТ РВ, Вооружение и военная техника. Система разработки и постановки продукции на производство, префикс “15.”;
ГОСТ, Система технической документации на АСУ, префикс “24.”;
ГОСТ, Комплекс стандартов на автоматизированные системы, префикс “34.”.

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

19.001-77. Общие положения

Описывает правила присвоения обозначений стандартов в серии ЕСПД. В практической жизни не нужен.

19.102-80. Схемы алгоритмов и программ. Правила выполнения.

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

19.003-80. Схемы алгоритмов и программ. Обозначения условные графические

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

19.004-80. Термины и определения.

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

19.005-85. Р-схемы алгоритмов и программ

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

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

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

19.102-77. Стадии разработки

Важный и нужный стандарт, в котором описаны виды документов и приведены коды видов программных документов. Этот стандарт (совместно с 19.103-77) является одним из ключей к “разгадке” обозначений документов подобных АБВГ.10473-01 32 01-1.
В стандарте вводится понятие комплекса и компонента (на ряде предприятий добавляют третий вид - комплект, когда речь идет о несвязанных программных элементах), дается разделение: какие документы эксплуатационные, какие нет.
Следует аккуратно относиться к таблице 4, в которой показано, какой документ на какой стадии разработки выполняется. Стадии разработки обычно регламентируются в стандартах на выполнения ОКР, и там-же указывается, какие документы нужно предъявлять заказчику на каждом этапе.

19.102-77. Стадии разработки

На моей памяти этот стандарт не применялся ни разу: кто что делает на каком этапе и чем отчитывается прописывается в ТТЗ или делается отсылка к ГОСТам, где это прописано более четко (например, ГОСТ РВ 15.203). При этом для новичка он содержит неплохой в своей лаконичности конспект работ на основных этапах ОКР.

19.103-77. Обозначения программ и программных документов

Нужен, в основном, для того, что бы научиться читать обозначения документов подобных приведенному выше. Однако понимание схемы обозначений полезно в случае, когда приходиться выходить за рамки типовых работ: к примеру, помнить, что документы с кодами после 90 - пользовательские, т.е. любые. В моей практике мы выпускали документ 93, который назвали “Ведомость программной документации”, 96 документ - “Инструкция по сборке”.
Распространенное словосочетание “вариант исполнения” в ЕСПД отсутствует, и заменяется “номером редакции”. С одной стороны, это не совсем корректно: номер редакции задумывался для отслеживания эволюции программы: вначале выходит первая редакция, потом, к примеру, после доработки - вторая. Но на практике, когда нужно выпустить версию ПО для нескольких операционных систем (кросс-платформенное ПО), другого выхода нет. Точнее - есть, но неправильный: присвоить версии для каждой операционки свое обозначение - и закладывать в архив несколько дисков с исходниками (по числу операционок), разрабатывать (фактически - копировать) весь комплект документации и т.д… Т.е. чистой воды бестолковая и сбивающая с толку деятельность. Решение в виде присвоения версии под каждую операционку своего номера редакции позволяет часть документов сделать общими.
В ЕСПД используется смущающее многих программистов обозначение исходных текстов программы и результата сборки “документами”. Документ “текст программы”, согласно 19.101-77, имеет обозначение 12. Дальше принято, что исходники обозначаются как 12 01 - т.е. 01(первый) документ вида 12, а бинарники - как 12 02 - т.е. второй документ вида 12. В ряде случаев для сборки программы требуются дополнительные инструментальные средства - компиляторы, генераторы инсталляторов и т.д. Т.е. программы, которые не входят в поставку, но нужны для сборки. Решением может быть их обозначение как 12 03 - т.е. третий документ вида 12.

19.104-78. Основные надписи

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

как было уже сказано, часто предприятие не хочет раскрывать информацию о разработчике. Отделение ЛУ и его “зажатие” позволяет это сделать (штампа, в отличии от ЕСКД, в ЕСПД на листах документа нет, вся информация локализована только в ЛУ);
на ряде предприятий используется смешанный документооборот: подлинники документов хранятся в электронном виде в архиве предприятия, а ЛУ на них (с оригиналами подписей) - в бумажном;

Что касается оформления ЛУ, то сплошь и рядом на предприятиях используется смесь - часть надписей ЛУ оформляется по ЕСПД, часть - по ЕСКД, а часть - по своему. Поэтому лучше всего прежде, чем делать ЛУ самому, поискать, нет ли стандарта предприятия (СТО), или взять пример у местного нормоконтроля.
Также следует помнить, что ЛУ не нумеруется, и первый лист - титульный, а первый лист, на котором ставится номер - следующий за титульным. Но в том случае, если ЛУ больше одного (это бывает, если все подписи не влезли на лист), то ЛУ нумеруются отдельно.

19.105-78. Общие требования к программным документам

Вводится общая структура документа, не зависящая от способа его исполнения. Т.е. еще в 1978 году было заложено в стандарт, что документ может быть не обязательно бумажным. В частности, вводиться понятие содержания для полностью электронных документов. Для бумажного исполнения, распространенного в то время, был принят ГОСТ 19.106-78.
В настоящее время к этому стандарту приходиться обращаться очень редко: разве что забывается порядок следования основных частей документа.

19.106-78. Общие требования к программным документам, выполненным печатным способом

Самый объемный стандарт из ЕСПД, уступающий разве что описанию R-схем. Является основным рабочим стандартом при оформлении документации. Вводит правила оформления текста, элементов структуры документа, изображений, формул и т.д. Однако в отличии от соответствующего 2.106 из ЕСКД, 19.106 существенно менее подробный, что приводит к многочисленным неопределенностям.
Во первых, стандарт фактически не определяет межстрочное расстояние и величину вертикальных отступов между заголовками. Он вводит три правила определения интервала: для машинописного текста, машинного и типографского.
Машинописный текст - это текст, набранный на печатной машинке. Смещение следующей строки относительно предыдущей производилось автоматически при так называемом «переводе каретки» - переходе к печати следующей строки, производимым перемещением специального рычага. Как правило, интервал мог быть вручную скорректирован поворотом вала протяжки бумаги, и имел “настройку”, позволяющую задать величину интервала - одинарный или двойной.
Машинный - это, скорее всего, и есть распечатанный текст. Но для него есть только указание, что результат должен быть пригоден для микрофильмирования. Это неявная ссылка на 13.1.002-2003, в котором, к сожалению, задается межстрочный интервал (и, кстати, минимальная высота шрифта) только для рукописных документов (п.4.2.5).
Типографский - текст, набранный в типографии. Учитывая год принятия стандарта, скорее всего речь идет о
[высокой печати , где межстрочный интервал определялся используемыми литерами. Я не специалист в типографском деле, а информации о методах набора сейчас очень мало.
Какой интервал использовать в итоге часто определяется местным нормоконтролем или СТО. Типичные значения - полуторный интервал и 14 размер шрифта.
Часто вызывает много вопросов способ структурирования документа. 19.106 считает, что весь документ делится на разделы, подразделы, пункты и подпункты. У всех них (кроме раздела и подраздела) заголовок может быть и или не быть. При этом:

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

В отличии от ЕСКД, в ЕСПД принят странный способ оформления рисунков: сначала идет название рисунка, потом сам рисунок, потом опциональный “подрисуночный текст”, и потом, на новой строке, “Рис. N”.
Этот стандарт имеет ряд “дыр”, недостказанностей. К примеру, сказано: “иллюстрации, если их в данном документе более одной, нумеруют арабскими цифрами в пределах всего документа. “ Но если иллюстрация одна, то она ненумерованная, и как тогда на нее ссылаться? Аналогично и для таблиц. Для сносок ГОСТ не указывает способ их нумерации - в пределах всего документа или в пределах страницы.
Таблицы. В самом документе дана ссылка на ГОСТ 1.5.68. Судя по первой серии, несложно заключить, что это стандарт на разработку стандартов. Причем тут он, неясно. По смыслу он соответствует правилам оформления таблиц в ЕСКД, с небольшими исключениями. Этот стандарт был отменен, взамен веден, через несколько итераций, 1.5-2012, в котором правила оформления таблицы… просто исчезли. Еще в 1.5-2002 были, а уже в 1.5-2004 исчезли. В реальной жизни мы оформляем таблицы согласно ЕСКД.
Приложения. Стандарт не указывает, попадают ли рисунки, формулы и таблицы из приложений в общий перечень. Аналогично не сказано, нужно ли в оглавлении раскрывать структуру приложения, если оно содержит свои разделы, пункты и т.д. В нашей практике мы не раскрываем внутренности приложений.
Наконец, следует сказать об отступах. Абзацный отступ, равный 5 символам, является общим для:

красной строки;
отступа элемента структуры документа после раздела (подраздел, пункт, подпункт);
элемент перечисления.

В следующих частях планирую уже добраться до конца списка стандартов ЕСПД.

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

В стандартах ЕСПД устанавливают требования, регламентирующие разработку, сопровождение, изготовление и эксплуатацию программ, что обеспечивает возможность:

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

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

Поскольку ЕСПД представляет собой набор ГОСТов , в настоящее время её применение на территории РФ носит только рекомендательный характер, то есть ЕСПД применяется на добровольной основе (если иное не предусмотрено договором, контрактом, отдельными законами, решением суда и т.п.) .

Энциклопедичный YouTube

1 / 3

Расчет панельного здания

Вебинар: Новые возможности Advance Steel 2018 для проектирования металлоконструкций

Мастер-класс #2 «Autodesk Fusion 360 - единая среда инновационного проектирования

Субтитры

Классификация

Стандарты ЕСПД подразделяют на группы, приведенные в таблице.

Перечень стандартов, входящих в ЕСПД

ГОСТ 19.001-77. ЕСПД. Общие положения.
ГОСТ 19.002-80. ЕСПД. Схемы алгоритмов и программ. Правила выполнения. - Заменен на ГОСТ 19.701-90
ГОСТ 19.003-80. ЕСПД. Схемы алгоритмов и программ. Обозначения условные графические. - Заменен на ГОСТ 19.701-90
ГОСТ 19.004-80. ЕСПД. Термины и определения. - Заменен на ГОСТ 19.781-90
ГОСТ 19.005-85. ЕСПД. Р-схемы алгоритмов и программ. Обозначения условные графические и правила выполнения.
ГОСТ 19.101-77. ЕСПД. Виды программ и программных документов.
ГОСТ 19.102-77. ЕСПД. Стадии разработки.
ГОСТ 19.103-77. ЕСПД. Обозначение программ и программных документов.
ГОСТ 19.104-78. ЕСПД. Основные надписи.
ГОСТ 19.105-78. ЕСПД. Общие требования к программным документам.
ГОСТ 19.106-78. ЕСПД. Требования к программным документам, выполненным печатным способом.
ГОСТ 19.201-78. ЕСПД. Техническое задание. Требования к содержанию и оформлению.
ГОСТ 19.202-78. ЕСПД. Спецификация. Требования к содержанию и оформлению.
ГОСТ 19.301-79. ЕСПД. Программа и методика испытаний. Требования к содержанию и оформлению.
ГОСТ 19.401-78. ЕСПД. Текст программы. Требования к содержанию и оформлению.
ГОСТ 19.402-78. ЕСПД. Описание программы.
ГОСТ 19.403-79. ЕСПД. Ведомость держателей подлинников.
ГОСТ 19.404-79. ЕСПД. Пояснительная записка. Требования к содержанию и оформлению.
ГОСТ 19.501-78. ЕСПД. Формуляр. Требования к содержанию и оформлению.
ГОСТ 19.502-78. ЕСПД. Описание применения. Требования к содержанию и оформлению.
ГОСТ 19.503-79. ЕСПД. Руководство системного программиста. Требования к содержанию и оформлению.
ГОСТ 19.504-79. ЕСПД. Руководство программиста. Требования к содержанию и оформлению.
ГОСТ 19.505-79. ЕСПД. Руководство оператора. Требования к содержанию и оформлению.
ГОСТ 19.506-79. ЕСПД. Описание языка. Требования к содержанию и оформлению.
ГОСТ 19.507-79. ЕСПД. Ведомость эксплуатационных документов.
ГОСТ 19.508-79. ЕСПД. Руководство по техническому обслуживанию. Трбования к сдержанию и формлению.
ГОСТ 19.601-78. ЕСПД. Общие правила дублирования, учета и хранения.
ГОСТ 19.602-78. ЕСПД. Правила дублирования, учета и хранения программных документов, выполненных печатным способом.
ГОСТ 19.603-78. ЕСПД. Общие правила внесения изменений.
ГОСТ 19.604-78. ЕСПД. Правила внесения изменений в программные документы, выполненные печатным способом.
ГОСТ 19.701-90 (ИСО 5807-85). ЕСПД. Схемы алгоритмов, программ, данных и систем. Условные обозначения и правила выполнения.
ГОСТ 19781-90. Обеспечение систем обработки информации программное. Термины и определения.