Опыт применения еспд. Единая система программной документации Единая система программных документов еспд
Устанавливающих взаимосвязанные правила разработки, оформления и обращения программ и программной документации.
В стандартах ЕСПД устанавливают требования, регламентирующие разработку, сопровождение, изготовление и эксплуатацию программ, что обеспечивает возможность:
- унификации программных изделий для взаимного обмена программами и применения ранее разработанных программ в новых разработках;
- снижения трудоемкости и повышения эффективности разработки, сопровождения, изготовления и эксплуатации программных изделий;
- автоматизации изготовления и хранения программной документации.
Сопровождение программы включает анализ функционирования, развитие и совершенствование программы, а также внесение изменений в неё с целью устранения ошибок.
Поскольку ЕСПД представляет собой набор ГОСТов , в настоящее время её применение на территории РФ носит только рекомендательный характер, то есть ЕСПД применяется на добровольной основе (если иное не предусмотрено договором, контрактом, отдельными законами, решением суда и т.п.) .
Энциклопедичный 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. Обеспечение систем обработки информации программное. Термины и определения.
Комплекс стандартов на автоматизированные системы (КСАС)
Единая система программной документации (ЕСПД) - отечественный комплекс стандартов на программную документацию . В профессиональном просторечии его еще называют «девятнадцатым гостом» , что не совсем правильно, поскольку речь идет не об одном, а примерно о 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 | Единая система программной документации. Правила внесения изменений в программные документы, выполненные печатным способом |
Приобретение стандартов
ЕСПД – относится к комплексным системам общетехнических стандартов
ЕСПД представляет собой систему межгосударственных стандартов стран СНГ, действующих на территории РФ, на основе межгосударственного соглашения по стандартизации. Стандарты ЕСПД охватывают ту часть документации, которая создается в процессе разработки программных средств и связанны по большей части с документированием функциональных характеристик программных средств. Стандарты ЕСПД носят рекомендательный характер
ЕСПД – это комплекс государственных стандартов, устанавливающих взаимоувязанные правила разработки, оформления и обращения программ и программной документации
Стандарты ЕСПД устанавливают требования, регламентирующие разработку, сопровождение изготовление и эксплуатацию программ, что обеспечивает возможность:
1. Унификации программных изделий для взаимного обмена программами и применение ранее разработанных программ в новых разработках
2. Снижение трудоемкости и повышение эффективности разработки, сопровождения, изготовление и эксплуатации программных изделий
3. Автоматизации, изготовление и хранение программной документации
Сопровождение программы включает анализ функционирования, развитие и совершенствование программы, а также внесение изменений в нее с целью устранения ошибок
Правила и положения, установленные в стандартах ЕСПД распространяются на программы и программную документацию для вычитательных машин, комплексов и систем, независимо от иъ назначения и области применения
В состав ЕСПД входят:
1. Основополагающие и организационно-методические стандарты
2. Стандарты, определяющие формы и содержание программных документов, применяемых при обработке данных
3. Стандарты, обеспечивающих автоматизацию разработки программных документов
Разработка организационно-методической документации, определяющей и регламентирующей деятельность организаций по разработке, сопровождению и эксплуатации программ должна проводится на основе стандартов ЕСПД
Стандарты ЕСПД подразделяются на классификационные группы
Стандарты ЕСПД обозначаются следующим образом:
ГОСТ 19.001-77
19 – принадлежность стандартов к ЕСПД
0 – Общие положения
77 – год утверждения
ГОСТ 19.503-79 - руководство системного программиста. Требования к содержанию и оформлению. Аннотация и содержание обязательно. Руководство системного программиста должно содержать следующие разделы:
1. Общие сведения о программе
Назначение и функции программы и сведения о технических и программных средствах, обеспечивающих выполнение данной программы
2. Структура программы
Сведения о структуре программы, ее составных частях, о связях между составными частями и о связях с другими программами
3. Настройка программы
Описание действий по настройке программы на условие конкретного применения (настройка на состав технических средств, выбор функций и другое)
4. Проверка программы
Описание способов проверки, позволяющих дать общие заключения о работоспособности программы (контрольные примеры, методы прогона, результаты)
5. Дополнительные возможности
Описание дополнительных разделов, функциональных возможностей программы и способов их выбора
6. Сообщение системному программисту
Тексты сообщений, выдаваемых в ходе выполнения программы, описание их содержания и действий, которые необходимо выполнять по этим сообщениям
7. Перечень документов
В зависимости от особенности документа допускается объединять отдельные разделы и вводить новые. В обоснованных случаях допускается раздел «дополнительные возможности» не приводить, а в наименованиях разделов – опускать слово программа, или заменять его на наименование программы
В приложении к руководству системного программиста могут быть приведены дополнительные материалы (примеры, иллюстрации, таблицы, графики…)
ГОСТ 19.504-79 - руководство программиста. Требования к содержанию и оформлению. Аннотация и содержание обязательны. Руководство программиста должно содержать следующие разделы:
1. Назначение и условия применения
Назначение и функции, условия, необходимые для выполнения (объем RAM, требования к составу и параметрам периферийных устройств, требования к ПО)
2. Характеристики программы
Описание основных характеристик и особенности программы (временные характеристики режим работы, средства контроля правильности выполнения и самовосстонавлеваемости программы)
3. Обращение к программе
Описание процедур вызова программы (способы передачи управления и параметров данных)
4. В/В данные
Описание организации В/В информации и при необходимости ее кодирование
5. Сообщение
Тексты сообщений, выдаваемых программисту или оператору, в ходе выполнения программы, описание их содержания и действий, которые необходимо выполнять по этим сообщениям
6. Перечень документов
В зависимости от особенности документа допускается объединять отдельные разделы и вводить новые. В приложении к руководству программиста могут быть приведены дополнительные материалы (примеры, иллюстрации, таблицы, графики…)
ГОСТ 19.505-79 - руководство оператора. Требования к содержанию и оформлению. Аннотация и содержание обязательны. Руководство оператора должно содержать следующие разделы:
1. Назначение программы
Сведения о назначении и информация, достаточная для понимания функций программы и ее эксплуатации
2. Условия выполнения программы
Условия, необходимые для выполнения программы (минимальный и (или) максимальный состав аппаратурных и программный средств)
3. Выполнение программе
Последовательность действий оператора, обеспечивающих загрузку, запуск и завершение программы (должно быть приведено описание функций, формата и возможных вариантов команд, с помощью которых оператор осуществляет загрузку и управляет выполнением программы, а так же ответы программы на эти команды
4. Сообщение оператору
Тексты сообщений, выдаваемых в ходе выполнения программы, описание их содержания и соответствующих действий оператора (действия оператора в случае сбоя, возможности перезапуска программы…)
5. Перечень документов
В зависимости от особенности документа допускается объединять отдельные разделы и вводить новые. Допускается содержание разделов иллюстрировать поясняющими примерами, таблицами, схемами и графиками. В приложении к руководству оператора допускается включать различные материалы, которые нецелесообразно включать в разделы руководства
ГОСТ 19.101-77
Группа Т55
МЕЖГОСУДАРСТВЕННЫЙ СТАНДАРТ
Единая система программной документации
ВИДЫ ПРОГРАММ И ПРОГРАММНЫХ ДОКУМЕНТОВ
Unified system for program documentation. Types of programs and program documents
МКС 35.080
Дата введения 1980-01-01
Постановлением Государственного комитета стандартов Совета Министров СССР от 20 мая 1977 г. N 1268 дата введения установлена 01.01.80
ИЗДАНИЕ (январь 2010 г.) с Изменением N 1, утвержденным в июне 1981 г. (ИУС 9-81).
Настоящий стандарт устанавливает виды программ и программных документов для вычислительных машин, комплексов и систем независимо от их назначения и области применения.
Стандарт полностью соответствует СТ СЭВ 1626-79.
(Измененная редакция, Изм. N 1).
1. ВИДЫ ПРОГРАММ
1. ВИДЫ ПРОГРАММ
1.1. Программу (по ГОСТ 19781-90) допускается идентифицировать и применять самостоятельно и (или) в составе других программ.
1.2. Программы подразделяют на виды, приведенные в табл.1.
Таблица 1
Вид программы | Определение |
Компонент | Программа, рассматриваемая как единое целое, выполняющая законченную функцию и применяемая самостоятельно или в составе комплекса |
Комплекс | Программа, состоящая из двух или более компонентов и (или) комплексов, выполняющих взаимосвязанные функции, и применяемая самостоятельно или в составе другого комплекса |
1.3. Документация, разработанная на программу, может использоваться для реализации и передачи программы на носителях данных, а также для изготовления программного изделия.
1.2, 1.3. (Измененная редакция, Изм. N 1).
2. ВИДЫ ПРОГРАММНЫХ ДОКУМЕНТОВ
2.1. К программным относят документы, содержащие сведения, необходимые для разработки, изготовления, сопровождения и эксплуатации программ.
2.2. Виды программных документов и их содержание приведены в табл.2.
Таблица 2
Вид программного документа | |
Спецификация | Состав программы и документации на нее |
Перечень предприятий, на которых хранят подлинники программных документов |
|
Текст программы | Запись программы с необходимыми комментариями |
Описание программы | Сведения о логической структуре и функционировании программы |
Требования, подлежащие проверке при испытании программы, а также порядок и методы их контроля |
|
Техническое задание | Назначение и область применения программы, технические, технико-экономические и специальные требования, предъявляемые к программе, необходимые стадии и сроки разработки, виды испытаний |
Пояснительная записка | Схема алгоритма, общее описание алгоритма и (или) функционирования программы, а также обоснование принятых технических и технико-экономических решений |
Эксплуатационные документы | Сведения для обеспечения функционирования и эксплуатации программы |
2.3. Виды эксплуатационных документов и их содержание приведены в табл.3.
Таблица 3
Вид эксплуатационного документа | |
Перечень эксплуатационных документов на программу |
|
Формуляр | Основные характеристики программы, комплектность и сведения об эксплуатации программы |
Описание применения | Сведения о назначении программы, области применения, применяемых методах, классе решаемых задач, ограничениях для применения, минимальной конфигурации технических средств |
Сведения для проверки, обеспечения функционирования и настройки программы на условия конкретного применения |
|
Руководство программиста | Сведения для эксплуатации программы |
Руководство оператора | Сведения для обеспечения процедуры общения оператора с вычислительной системой в процессе выполнения программы |
Описание языка | Описание синтаксиса и семантики языка |
Сведения для применения тестовых и диагностических программ при обслуживании технических средств |
2.4. В зависимости от способа выполнения и характера применения программные документы подразделяются на подлинник, дубликат и копию (ГОСТ 2.102-68), предназначенные для разработки, сопровождения и эксплуатации программы.
2.5. Виды программных документов, разрабатываемых на разных стадиях, и их коды приведены в табл.4.
Таблица 4
Код | Вид документа | Стадии разработки |
|||
Эскизный проект | Технический проект | Рабочий проект |
|||
компонент | комплекс |
||||
Спецификация | |||||
Ведомость держателей подлинников | |||||
Текст программы | |||||
Описание программы | |||||
Ведомость эксплуатационных документов | |||||
Формуляр | |||||
Описание применения | |||||
Руководство системного программиста | |||||
Руководство программиста | |||||
Руководство оператора | |||||
Описание языка | |||||
Руководство по техническому обслуживанию | |||||
Программа и методика испытаний | |||||
Пояснительная записка | |||||
Прочие документы |
Условные обозначения:
- документ обязательный;
- документ обязательный для компонентов, имеющих самостоятельное применение;
- необходимость составления документа определяется на этапе разработки и утверждения технического задания;
- - документ не составляют.
2.2-2.5. (Измененная редакция, Изм. N 1).
2.6. Допускается объединять отдельные виды эксплуатационных документов (за исключением ведомости эксплуатационных документов и формуляра). Необходимость объединения этих документов указывается в техническом задании. Объединенному документу присваивают наименование и обозначение одного из объединяемых документов.
В объединенных документах должны быть приведены сведения, которые необходимо включать в каждый объединяемый документ.
2.7. На этапе разработки и утверждения технического задания определяют необходимость составления технических условий, содержащих требования к изготовлению, контролю и приемке программы.
Технические условия разрабатывают на стадии "Рабочий проект".
2.8. Необходимость составления технического задания на компоненты, не предназначенные для самостоятельного применения, и комплексы, входящие в другие комплексы, определяется по согласованию с заказчиком.
(Введен дополнительно, Изм. N 1).
Электронный текст документа
подготовлен АО "Кодекс" и сверен по:
официальное издание
Единая система программной
документации: Сб. ГОСТов. -
М.: Стандартинформ, 2010
- Конструктор Arduino: новый взгляд сквозь SparkFun Pro Micro Arduino pro micro как работает
- Ожидания и реалии в CRM-проектах Безапелляционный detail php id
- Как узнать IMEI (серийный номер) iPhone?
- Оптимизация OS X для продления жизни SSD
- Функциональные устройства на операционных усилителях линейные аналоговые вычислительные схемы на оу Что такое аналоговая микросхема
- Не высвечивается дисковод
- Установка системы лицензирования конфигураций (СЛК) на сервер Linux