Основные принципы разработки документации
3.1 Представленный в данном документе порядок документирования охватывает этапы жизненного цикла системы от формирования концепции до внедрения и сопровождения.
В таблицах 3 и 4 приведен основной состав документов, которые предназначены для использования при создании, применении и сопровождении информационных системы, в том числе для определения, управления и совершенствования сложных комплексов программ. При разработке документов возможна их адаптация в соответствии с характеристиками проектов. Адаптация является процессом исключения компонентов документов, не применяемых в конкретном проекте. Добавление уникальных или специфических документов должно быть оговорено в соответствующем договоре и (или) техническом задании.
3.2 Стороны - участники проекта ответственны за выбор модели комплекта документации для конкретного проекта и за адаптацию приведенных в данном ОРММ документов. Стороны также ответственны за выбор и применение методов и инструментальных средств автоматизации разработки программного обеспечения.
3.3 При создании и применении больших систем и обеспечении их жизненного цикла документами целесообразно применять выборку из всей совокупности стандартов, детализирующих частные процессы, работы и документы. Поэтому рекомендуется на начальном этапе проектирования таких систем (в техническом задании) сформировать возможный комплект документов (или первичный профиль), обеспечивающий регламентирование всех этапов, работ и документов.
Порядок разработки и комплектования документации
3.4.1 Документация разрабатывается как на АС в целом, так и на отдельные функциональные части (задачи) и компоненты. Наименование конкретных документов на АС в целом или ее части (комплекс задач, автоматизированное рабочее место, задачу
и пр.) определено ГОСТ 34.201, на комплексы программ (программы) - ГОСТ 19.101.
3.4.2 В зависимости от специфики создаваемых АС и применяемых методов проектирования допускается разрабатывать групповые и базовые документы, выпускать документы отдельными самостоятельными частями, расширять номенклатуру документов, установленную стандартами и данным ОРММ ИСЖТ.
3.4.3 Компоненты АС могут быть частью системы или иметь самостоятельное применение. Документация для компонентов АС разрабатывается в соответствии с приведенными в таблице 2 системами Государственных стандартов.
Таблица 2 - Используемые системы ГОСТ для разработки компонентов
Системы
Наименование компонентов | Система ГОСТ |
Программные средства и программные изделия | ЕСПД |
Информационные средства и информационные изделия | КС АС, ЕСКД |
Программно-технические комплексы | КС АС, ЕСПД |
Автоматизированные рабочие места в АС | КС АС, ЕСПД |
Автоматизированные рабочие места автономные | ЕСПД |
Аппаратно-программные комплексы | ЕСКД, ЕСПД, КС АС |
Банки данных и базы данных в АС | КС АС, ЕСПД |
Технические средства в АС | ЕСКД, КС АС, ЕСПД |
3.4.4 Допускается выпуск проектной документации в соответствии с международными и национальными стандартами (в том числе ГОСТ Р ИСО/МЭК ТО 9294-93, ИСО 6592:1986 и др.), в первую очередь, при разработке систем с помощью закупленных CASE-средств, что должно быть указано в техническом задании.
3.4.5 В случае применения закупленных CASE-средств в техническом задании на систему при описании методологии, технологии и инструментального средства проектирования (CASE-средств) устанавливают требования к оформлению документации:
- комплектность, состав и структура на каждой стадии проектирования;
- требования к оформлению (включая требования к разделам документов) или ссылки на нормативные документы;
- требования к издательской системе, используемой в качестве встроенного средства подготовки документации;
- требования к настройке CASE-средств для обеспечения подготовки документации в соответствии с установленными правилами.
Допускается в документах, подготавливаемых с помощью CASE-средств, употребление английских слов в заголовках автоматически формируемых отчетов и диагностических сообщений. В этом случае в приложениях к документам должны быть приведены переводы типовых текстов.
3.4.6 Общий перечень документов, который используется при проектировании системы в целом и ее частей, приведен в таблице 3. Документация на АС, ее части и компоненты подразделяется на:
- документацию процесса разработки, включающую подробные технические описания и подготавливаемую для специалистов, ведущих проектирование, разработку и сопровождение информационных систем, обеспечивающую возможность отчуждения, детального освоения, развития и корректировки ими программ, баз данных и технологических процессов на всем жизненном цикле системы;
- эксплуатационную документацию (ЭД) - документацию продукции, создаваемую для конечных пользователей системы и позволяющую им осваивать и эксплуатировать ее для решения конкретных функциональных задач.
3.4.7 Документация разработки АС и ее частей содержит согласно ГОСТ 34.201 следующие части проекта (таблица 3):
- общесистемные решения (ОР);
- решения по организационному обеспечению (ОО);
- решения по техническому обеспечению (ТО);
- решения по информационному обеспечению (ИО);
- решения по программному обеспечению (ПО);
- решения по математическому обеспечению (МО).
Приведенные части проекта являются разделами "Ведомости технического проекта", "Ведомости рабочей документации" или "Ведомости технорабочего проекта".
3.4.8 Эксплуатационная документация (ЭД), отмеченная в таблице 3 знаком "Х", включает документы, предназначенные для:
- пользователей, которые эксплуатируют АС и ее компоненты;
- общую информацию, описывающую АС и ее компоненты для всех заинтересованных лиц.
Таблица 3 - Перечень документов, который используется при