Системная документация
(классификация документов, существовавшая
с 1970 по 1980 годы и не отмененная в настоящее время) по стадиям ЖЦ ИС:
постановка задачи:
1)
техническое задание (ТЗ), включает в свой состав: технико-
экономическое описание проекта (ТЭО); календарный план проек-
тирования; сметную калькуляцию проекта; каталожное описание
разработки (КО), технические требования (ТТ) и технические усло-
вия (ТУ), относящиеся к проектируемому изделию и т.п.;
разработка:
2)
проектная документация, в составе: проект системы; подготовка
данных; разработка программы;
реализация испытаний:
3)
пособия руководства: руководство пользователя; руководство по
99
обслуживанию; руководство оператора; руководство администра-
торов (данных, баз данных, серверного обеспечения, сетевого обес-
печения, сервера защиты и т.п.)
эксплуатация:
4)
реализация: программный код; информация, вызываемая системой;
тесты и тестовые прогоны программы; требования, процедуры и
условия сертификации продукта.
Альтернативный состав документации, предусмотренный действующими
стандартами (по стадиям ЖЦ ИС):
выработка требований:
1)
требования к функциональной структуре;
2)
требования к информационной структуре;
проектирование:
3)
системная спецификация и описание подсистем;
4)
программная спецификация;
5)
спецификация БД;
6)
руководство системных специалистов, администраторов;
7)
руководство пользователя, план испытаний;
программирование, испытание, сертификация:
8)
руководство по эксплуатации;
9)
руководство по сопровождению;
Единая система программной документации (ЕСПД)
ЕСПД – комплекс государственных стандартов Российской Федерации,
устанавливающих взаимосвязанные правила разработки, оформления и обра-
щения программ и программной документации. В стандартах ЕСПД устанавли-
вают требования, регламентирующие разработку, сопровождение, изготовление
и эксплуатацию программ. Сопровождение программы включает анализ функ-
ционирования, развитие и совершенствование программы, а также внесение
100
изменений в нее с целью устранения ошибок. Различают следующие классифи-
кационные группы стандартов ЕСПД:
1)
общие положения;
2)
основополагающие стандарты;
3)
правила выполнения документации при разработке;
4)
правила выполнения документации при изготовлении;
5)
правила выполнения документации при сопровождении;
6)
правила выполнения документации при эксплуатации;
7)
правила обращения к программной документации;
8)
резервные группы;
9)
прочие стандарты.
Подразумевается, что за счет единых средств формирования документов,
унификации их структуры, последовательности выполнения операций, исполь-
зование указанных групп стандартов
обеспечивает
взаимный обмен програм-
мами, применение ранее разработанных программ в новых разработках и сни-
жение затрат на разработку, оформление и использование программ.
Согласно ЕСПД предусмотрен следующий перечень обязательных доку-
ментов, входящих в состав ИС:
спецификация
;
ведомость держателей подлин-
ников
;
текст программы
–
сведения о логической структуре и функции про-
грамм. Программа и методика испытаний в составе этого пакета документов
отображает требования, подлежащие проверке, а также методы контроля.
В
техническом задании (ТЗ)
обосновываются назначение и области приме-
нения программы, технические, технико-экономические и специальные требова-
ния, необходимые стадии и сроки разработки, виды испытаний. Каждая созданная
или привлеченная в проект программа сопровождается пояснительной запиской, в
которой наряду с ее обобщенным описанием приводятся схема алгоритма и общее
описание алгоритма и функция программы, а также обоснование принятых реше-
ний. Эта записка входит в состав расчетно-пояснительной записки к проекту ИС.
Эксплуатационные документы
содержат сведения необходимые для обеспечения
функционирования и эксплуатации системы и включают в состав:
101
ведомость эксплуатационных документов на программу;
•
формуляр (основные характеристики, комплектность, сведения об экс-
плуатации);
•
описание применения (сведения о назначении, класс задач, область при-
менения, используемые методы, организация, минимальная конфигура-
ция технических средств, в том числе по вопросам организации АРМ
пользователей, серверного хозяйства, маршрутизации, сетевого обеспе-
чения, организации бесперебойного энергопитания, средств защиты, пе-
риферийных устройств и ТСО);
•
руководство системного программиста (сведения для проверки, обеспе-
чения функционирования и настройки программы);
•
руководство программиста (сведения для эксплуатации программ);
•
руководство оператора (сведения для осуществления действий по выпол-
нению программой / системой требований);
•
руководство по техническому обеспечению;
•
журнал документов;
•
руководство (инструкции) по сертификации, модернизациям, масштаби-
рованию и ликвидации ИС (АСУ) по истечении действия предусмотрен-
ного проектом полного жизненного цикла системы;
•
обучающие и учебно-методические материалы по системе, ознакоми-
тельные с ней материалы (демоверсии и их описание);
•
другие эксплуатационные документы (специального назначения), огово-
ренные в ТЗ.
Стандарты в составе ЕСПД:
•
ГОСТ 19.001-77. ЕСПД. Общие положения;
•
ГОСТ 19.003-80. ЕСПД. Схемы алгоритмов и программ. Обозначения
условные графические. Заменен на ГОСТ 19.701-90;
•
ГОСТ 19.005-85. ЕСПД. Р-схемы алгоритмов и программ. Обозначения
условные графические и правила выполнения;
102
•
ГОСТ 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. ЕСПД. Руководство оператора. Требования к содержа-
нию и оформлению;
103
•
ГОСТ 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). ЕСПД. Схемы алгоритмов, программ,
данных и систем. Условные обозначения и правила выполнения.
Техническое задание на создание ИС
Do'stlaringiz bilan baham: |