Единая система программной документации (ЕСПД)

1. ЕДИНАЯ СИСТЕМА ПРОГРАММНОЙ ДОКУМЕНТАЦИИ

2.

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

3. Обозначение стандартов

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

4. Стандарты ЕСПД ( не все)

ГОСТ 19.001-77 Единая система программной документации. Общие
положения
Гост 19.101-77 Виды программ и программной документации
Гост 19.102-77 Стадии разработки
Гост 19.105-78 Общие требования к программным документам.
Гост 19.301-79 Программа и методика испытаний
Гост 19.402-78 Описание программы
Гост 19.502-79 Руководство системного программиста
Гост 19.504-79 Руководство программиста
Гост 19.508-79 Руководство по техническому обслуживанию
Гост 19.701-90 Схемы алгоритмов, программ, данных и систем.

5. Стандартизация помогает унифицировать и автоматизировать:

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

6. Классификация документов по ЕСПД

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

7. Некоторые определения по ЕСПД

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

8. Виды программ по ЕСПД

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

9. Виды программной документации по ЕСПД

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

10. Виды эксплуатационной документации по ЕСПД

Ведомость эксплуатационных документов;
Формуляр – содержит основные характеристики ПИ,
состав и сведения об эксплуатации;
Описание применения – информация о назначении и
области применения, ограничениях при применении,
конфигурации технических средств.
Руководство системного программиста;
Руководство программиста;
Руководство оператора ЭВМ;
Описание языка;
Руководство по техническому обслуживанию

11. Основные стадии и этапы разработки программ и программной документации по ЕСПД (ГОСТ 19.102)

Техническое задание
Эскизный проект
Технический проект
Рабочий проект
Внедрение

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

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

13. Эскизный проект

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

14. Технический проект

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

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

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

16. Внедрение

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

17. Построение основных символов блок-схем в соответствии со стандартом ГОСТ 19.003-80

Линии потока должны быть параллельны линиям внешней
рамки схемы.
Направления линии потока сверху вниз и слева направо
принимают за основные и, если линии потока не имеют
изломов, стрелками можно не обозначать. В остальных
случаях направление линии потока обозначать стрелкой
обязательно.
Расстояние между параллельными линиями потока должно
быть не менее 3 мм, между остальными символами схемы –
не менее 5 мм.
Записи внутри символа или рядом с ним должны
выполняться машинописью с одним интервалом или
чертежным шрифтом по ГОСТ 2.304-81.

18.

b
a
a
a
a
a
a
0.75 b
Записи внутри символа должны быть представлены
так, чтобы их можно было читать слева направо и
сверху вниз, независимо от направления потока.
Порядковый номер символа на схеме проставляют
слева в верхней части символа в разрыве его контура.
Геометрические пропорции символов: a=2b