Информационная система определение гост 34. Какие бывают госты? Требования к программному обеспечению АСУ

Дата введения 01.01.92

Настоящий стандарт распространяется на автоматизированные системы (АС), используемые в различных видах деятельности (исследование, проектирование, управление и т. п.), включая их сочетания, создаваемые в организациях, объединениях и на предприятиях (далее — организациях).

Стандарт устанавливает стадии и этапы создания АС. В приложении 1 приведено содержание работ на каждом этапе.

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

2. Стадии и этапы создания АС

Приложение 1 (справочное)

Приложение 2 (справочное)

1. ОБЩИЕ ПОЛОЖЕНИЯ

1.1. представляет собой совокупность упорядоченных во времени, взаимосвязанных, объединенных в стадии и этапы работ, выполнение которых необходимо и достаточно для создания АС, соответствующей заданным требованиям.

1.2. Стадии и этапы создания АС выделяются как части процесса создания по соображениям рационального планирования и организации работ, заканчивающихся заданным результатом.

1.3. Работы по развитию АС осуществляют по стадиям и этапам, применяемым для создания АС.

1.4. Состав и правила выполнения работ на установленных настоящим стандартом стадиях и этапах определяют в соответствующей документации организаций, участвующих в создании конкретных видов АС.

Перечень организаций, участвующих в работах по созданию АС, приведен в приложении 2.

2. СТАДИИ И ЭТАПЫ СОЗДАНИЯ АС

2.1. Стадии и этапы создания АС в общем случае приведены в таблице.

2.2. Стадии и этапы, выполняемые организациями - участниками работ по созданию АС, устанавливаются в договорах и техническом задании на основе настоящего стандарта.

Допускается исключать стадию «Эскизный проект» и отдельные этапы работ на всех стадиях, объединять стадии «Технический проект» и «Рабочая документация» в одну стадию «Технорабочий проект». В зависимости от специфики создаваемых АС и условий их создания допускается выполнять отдельные этапы работ до завершения предшествующих стадий, параллельное во времени выполнение этапов работ, включение новых этапов работ.

ПРИЛОЖЕНИЕ 1.Справочное

1. На этапе 1.1 «Обследование объекта и обоснование необходимости создания АС» в общем случае проводят:

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

2. На этапе 1.2 «формирование требований пользователя к АС» проводят:

• подготовку исходных данных для формирования требований к АС (характеристика объекта автоматизации, описание требований к системе, ограничения допустимых затрат на разработку, ввод в действие и эксплуатацию, эффект, ожидаемый от системы, условия создания и функционирования системы);
• формулировку и оформление требований пользователя к АС.

3. На этапе 1.3 «Оформление отчета о выполненной работе и заявки на разработку АС (тактико-технического задания)» проводят оформление отчета о выполненных работах на данной стадии и оформление заявки на разработку АС (тактико-технического задания) или другого заменяющего ее документа с аналогичным содержанием.

4. На этапах 2.1 «Изучение объекта» и 2.2 «Проведение необходимых научно-исследовательских работ» организация-разработчик проводит детальное изучение объекта автоматизации и необходимые научно-исследовательские работы (НИР), связанные с поиском путей и оценкой возможности реализации требований пользователя, оформляют и утверждают отчеты о НИР.

5. На этапе 2.3 «Разработка вариантов концепции АС и выбор варианта концепции АС, удовлетворяющего требованиям пользователя» в общем случае проводят разработку альтернативных вариантов концепции создаваемой АС и планов их реализации; оценку необходимых ресурсов на их реализацию и обеспечение функционирования; оценку преимуществ и недостатков каждого варианта; сопоставление требований пользователя и характеристик предлагаемой системы и выбор оптимального варианта; определение порядка оценки качества и условий приемки системы; оценку эффектов, получаемых от системы.

6. На этапе 2.4 «Оформление отчета о выполненной работе» подготавливают и оформляют отчет, содержащий описание выполненных работ на стадии, описание и обоснование предлагаемого варианта концепции системы.

7. На этапе 3.1 «Разработка и утверждение технического задания на создание АС» проводят разработку, оформление, согласование и утверждение технического задания на АС и, при необходимости, технических заданий на части АС.

8. На этапе 4.1 «Разработка предварительных проектных решений по системе и ее частям» определяют: функции АС; функции подсистем, их цели и эффекты; состав комплексов задач и отдельных задач; концепции информационной базы, ее укрупненную структуру; функции системы управления базой данных; состав вычислительной системы; функции и параметры основных программных средств.

9. На этапе 5.1 «Разработка проектных решений по системе и ее частям» обеспечивают разработку общих решений по системе и ее частям, функционально-алгоритмической структуре системы, по функциям персонала и организационной структуре, по структуре технических средств, по алгоритмам решений задач и применяемым языкам, по организации и ведению информационной базы, системе классификации и кодирования информации, по программному обеспечению.

10. На этапах 4.2 и 5.2 «Разработка- документации на АС и ее части» проводят разработку, оформление, согласование и утверждение документации в объеме, необходимом для описания полной совокупности принятых проектных решений и достаточном для дальнейшего выполнения работ по созданию АС. Виды документов - по ГОСТ 34.201.

11. На этапе 5.3 «Разработка и оформление документации на поставку изделий для комплектования АС и (или) технических требований (технических заданий) на их разработку» проводят подготовку и оформление документации на поставку изделий для комплектования АС; определение технических требований и составление ТЗ на разработку изделий, не изготавливаемых серийно.

12. На этапе 5.4 «Разработка заданий на проектирование в смежных частях проекта автоматизации» осуществляют разработку, оформление, согласование и утверждение заданий на проектирование в смежных частях проекта объекта автоматизации для проведения строительных, электротехнических, санитарно-технических и других подготовительных работ, связанных с созданием АС.

13. На этапе 6.1 «Разработка рабочей документации на систему и ее части» осуществляют разработку рабочей документации, содержащей все необходимые и достаточные сведения для обеспечения выполнения работ по вводу АС в действие и ее эксплуатации, а также для поддерживания уровня эксплуатационных характеристик (качества) системы в соответствии с принятыми проектными решениями, ее оформление, согласование и утверждение. Виды документов - по ГОСТ 34.201.

14. На этапе 6.2 «Разработка или адаптация программ» проводят разработку программ и программных средств системы, выбор, адаптацию и (или) привязку приобретаемых программных средств, разработку программной документации в соответствии с ГОСТ 19.101.

15. На этапе 7.1 «Подготовка объекта автоматизации к вводу АС в действие» проводят работы по организационной подготовке объекта автоматизации к вводу АС в действие, в т. ч.: реализацию проектных решений по организационной структуре АС; обеспечение подразделений объекта управления инструктивно-методическими материалами; внедрение классификаторов информации.

16. На этапе 7.2 «Подготовка персонала» проводят обучение персонала и проверку его способности обеспечить функционирование АС.

17. На этапе «Комплектация АС поставляемыми изделиями» обеспечивают получение комплектующих изделий серийного и единичного производства, материалов и монтажных изделий. Проводят входной контроль их качества.

18. На этапе 7.4 «Строительно-монтажные работы» проводят: выполнение работ по строительству специализированных зданий (помещений) для размещения технических средств и персонала АС; сооружение кабельных каналов; выполнение работ по монтажу технических средств и линий связи; испытание смонтированных технических средств; сдачу технических средств для проведения пусконаладочных работ.

19. На этапе 7.5 «Пусконаладочные работы» проводят автономную наладку технических и программных средств, загрузку информации в базу данных и проверку системы ее ведения; комплексную наладку всех средств системы.

20. На этапе 7.6 «Проведение предварительных испытаний» осуществляют:

• испытания АС на работоспособность и соответствие техническому заданию в соответствии с программой и методикой предварительных испытаний;
• устранение неисправностей и внесение изменений в документацию на АС, в т. ч. эксплуатационную в соответствии с протоколом испытаний;
• оформление акта о приемке АС в опытную эксплуатацию.

21. На этапе 7.7 «Проведение опытной эксплуатации» проводят, опытную эксплуатацию АС; анализ результатов опытной эксплуатации АС; доработку (при необходимости) программного обеспечения АС; дополнительную наладку (при необходимости) технических средств АС; оформление акта о завершении опытной эксплуатации.

22. На этапе 7.8 «Проведение приемочных испытаний» проводят:

• испытания на соответствие техническому заданию согласно программе и методике приемочных испытаний;
• анализ результатов испытаний АС и устранение недостатков, выявленных при испытаниях;
• оформление акта о приемке АС в постоянную эксплуатацию.

23. На этапе 8.1 «Выполнение работ в соответствии с гарантийными обязательствами» осуществляют работы по устранению недостатков, выявленных при эксплуатации АС в течение установленных гарантийных сроков, внесению необходимых изменений в документацию на АС.

24. На этапе 8.2 «Послегарантийное обслуживание» осуществляют работы по:

• анализу функционирования системы;
• выявлению отклонений фактических эксплуатационных характеристик АС от проектных значений;
• установлению причин этих отклонений;
• устранению выявленных недостатков и обеспечению стабильности эксплуатационных характеристик АС;
• внесению необходимых изменений в документацию на АС.

ПРИЛОЖЕНИЕ 2. Справочное

ПЕРЕЧЕНЬ ОРГАНИЗАЦИЙ, УЧАСТВУЮЩИХ В РАБОТАХ ПО СОЗДАНИЮ АС

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

2. Организация-разработчик, которая осуществляет работы по созданию АС, представляя заказчику совокупность научно-технических услуг на разных стадиях и этапах создания, а также разрабатывая и поставляя различные программные и технические средства АС.

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

4. Организация-генпроектировщик объекта автоматизации.

5. Организации-проектировщики различных частей проекта объекта автоматизации для проведения строительных, электротехнических, санитарно-технических и других подготовительных работ, связанных с созданием АС.

6. Организации строительные, монтажные, наладочные и другие.

Примечания:

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

2. Стадии и этапы выполняемых ими работ по созданию АС определяются на основании настоящего стандарта.

ИНФОРМАЦИОННЫЕ ДАННЫЕ

1. РАЗРАБОТАН И ВНЕСЕН Государственным комитетом СССР по управлению качеством продукции и стандартам

РАЗРАБОТЧИКИ

Ю.Х. Вермишев, д-р техн. наук; Я.Г. Виленчик; В.И. Воропаев, д-р техн. наук; Л.М. Зайденберг, канд. техн. наук; Ю.Б. Ирз, канд. техн. наук; В.Д. Костюков, канд. техн. наук; М.А. Лабутин, конд. техн. наук; Н.П. Лесковская; И.С. Митяев; В.Ф. Попов (руководитель темы); С.В. Гаршина; А.И. Глуховеря; Ю.Г. Жуков, канд техн. наук; З.П. Задубовская; В.Г. Иванов; Ю.И. Караванов, канд техн. наук; А.А. Клочков; В.Ю. Королев; В.И. Махнач, канд. техн. наук; С.Б. Михалев, д-р техн. наук; В.Н. Петрикевич; В.А. Рахманов, канд. экон. наук; А.А. Ратъкович; Р.С. Седегов, д-р экон. наук; Н.В. Степанчикова; М.С. Суровец; А.В. Флегентов; Л.О. Хвилевский, канд. техн. наук; В.К. Чистов, канд. экон. наук

2. УТВЕРЖДЕН И ВВЕДЕН В ДЕЙСТВИЕ Постановлением Государственного комитета СССР по управлению качеством продукции и стандартам от 29.12.90 № 3469

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

Что такое стандарты на документацию?

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

Это базовый документ, в котором приводится полный перечень документации ГОСТ 34, рекомендации по кодированию документов, к каким стадиям проекта относятся документы (стадии описываются в ГОСТ 34.601-90), а также как их можно объединить между собой.

Фактически, этот стандарт представляет собой большую таблицу с комментариями. Ее можно загнать в Excel для удобства использования.

Объемистый стандарт, с различной степенью детальности описывающий содержание проектных документов. В качестве индекса используется упомянутый выше ГОСТ 34.201-89.

К стандарту РД 50-34.698-90 существует множество вопросов и трактовок его положений, которые ввиду их неконкретности, часто понимают по-разному заказчик и исполнитель или даже члены проектной команды. Но ничего более конкретного у нас, к сожалению, нет.

Рассмотрим теперь плюсы и минусы стандартов, начав традиционно с минусов.

Минусы стандартов

• приложения двухуровневые, состоящие из клиентской программы и сервера СУБД (никаких трех- и более «уровневых» приложений, никаких Weblogic или JBoss)
• структура таблиц базы данных, будучи описана, даст представление о логической модели данных (то, что между приложением и базой может находиться какой-нибудь Hibernate, тогда казалось нехорошим излишеством)
• пользовательский интерфейс однооконный (а разве бывает другой? А что такое «браузер»?)
• Отчетов в системе немного, все они бумажные и печатаются на матричном принтере
• Разрабатываемая программа ориентирована на решение «задачи обработки информации», которая имеет четкий вход и выход и узко специализирована. В основе обработки информации лежит «алгоритм». Иногда «алгоритмов» бывает несколько. (Объектно-ориентированное программирование тогда делало лишь свои первые шаги и серьезно не рассматривалось).
• администратор базы данных понимает, какая информация лежит в таблицах и активно участвует в редактировании системных справочников (а разве бывает один сервер СУБД для 50 разных приложений?)

5.8. Чертеж формы документа (видеокадра)
В документе должно быть приведено изображение формы документа или видеокадра в соответствии с требованиями государственных стандартов унифицированной системы документации Р 50-77 и необходимые пояснения.

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

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

Сейчас уже нам ничего не говорят слова «машинограмма», «видеокадр», «АЦПУ». Я тоже их не застал в употреблении, хотя заканчивал профильный институт в 90-е. Это было время появления Windows 3.1, VGA дисплеев, трехдюймовых дискет и первых отечественных интернет-сайтов. Но в стандарте эти слова есть, и заказчик иногда капризно требует предоставить ему полный комплект документации в соответствии с ГОСТ 34.201-89. Более того, подобные формулировки в ТЗ кочуют из одного министерства в другое и стали уже неким негласным шаблоном, в который вбивают содержательную часть.

Так что документ с дурацким названием «Чертеж формы документа (видеокадра)» в проекте должен быть и должен быть не пустым.

Что в стандарте хорошо

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

А стандарты ГОСТ 34 хороши еще и тем, что они составлялись умными людьми, обкатывались годами и у них есть четкая цель - максимально полно описать на бумаге сложную абстрактную сущность, которую представляет собой любая АСУ.

Когда вам требуется грамотно поставить задачу западным подрядчикам, которые про наши ГОСТы слыхом не слыхивали, можно также опираться на эти стандарты, а точнее на их контент, смысловую составляющую. Потому что, повторюсь, гарантия полноты информации дорогого стоит. Как бы мы себя не тешили высоким уровнем своего профессионализма, мы можем забыть включить в состав наших требований элементарные вещи, тогда как тот же ГОСТ 34.602-89 «помнит» обо всем. Если вам непонятно, как должен выглядеть результат работы западных подрядчиков, посмотрите на требования к документированию, к рекомендуемым разделам. Уверяю вас, лучше не придумать! Скорее всего, есть западные аналоги наших стандартов, в которых все может быть полнее, современнее и лучше. К сожалению, я с ними не знаком, так как не было пока ни одного случая, чтобы наших ГОСТов было бы недостаточно.

Можно смеяться над тем, что создатели стандартов ничего не знали о java или.NET, о HD мониторах и Интернете, но я бы не советовал недооценивать масштаб проделанной ими работы и ее ценность для нашего профессионального сообщества.

Как читать и понимать стандарты документации по ГОСТ серии 34

Стандарт делит все документы по двум осям - время и предметная область. Если посмотреть таблицу 2 в ГОСТ 34.201-89, то хорошо видно это деление (колонки «Стадия создания» и «Часть проекта»

Стадии создания АСУ

• Эскизный проект (ЭП)
• Технический проект (ТП)
• Разработка рабочей документации (РД)

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

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

Части (разделы) проектной документации по созданию АСУ

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

Для того, чтобы полностью описать этот «автомат», сделаны следующие разрезы (как в черчении):

Математическое обеспечение (МО) , отвечающее на вопросы: какая логика зашита внутри «черного ящика»? Почему выбраны именно эти алгоритмы, именно такие формулы и именно такие коэффициенты?

Математическое обеспечение ничего не знает ни о процессорах, ни о базах данных. Это отдельная абстрактная область, обитель «сферических коней в вакууме». Но математическое обеспечение бывает очень плотно связано с предметной областью, aka Реальная жизнь. Например, управляющие алгоритмы для систем управления дорожным движением требуется согласовать в ГИБДД перед тем, как их будет согласовывать заказчик. И тут понимаешь, зачем их выделяют в отдельную книжицу. Потому что в ГИБДД никому не интересно, на какой ОС будет работать сервер приложения, а вот какой знак и ограничение скорости выскочит на табло в дождь или в снег очень даже интересно. Они отвечают за свою часть, и ничего другого подписывать не собираются. С другой стороны, когда они подписали, не будет вопросов к технической стороне вопроса - почему выбрали те, а не другие табло или светофоры. Мудрость «предков» как раз и проявляется в таких вот практических кейсах.

Информационное обеспечение (ИО) . Еще один срез системы. На этот раз делается прозрачным черный ящик нашей системы и мы смотрим на циркулирующую в нем информацию. Представьте себе модель кровеносной системы человека, когда все остальные органы невидимы. Вот что-то подобное и есть Информационное обеспечение. В нем описываются состав и маршруты прохождения информации внутри и снаружи, логическая организация информации в системе, описание справочников и систем кодирования (кто делал программы для производства, тот знает, как они важны). Основная описательная часть приходится на этап ТП, но в этап РД перетекают некоторые «рудименты», наподобие документа «Каталог баз данных». Понятно, что раньше он содержал именно то, что написано в названии. Но сегодня попробуйте для сложной комплексной системы сформировать такой документ, когда очень часто в составе системы используются покупные подсистемы со своими загадочными информационными хранилищами. Я уж не говорю о том, что этот документ не особенно сейчас и нужен.

Или вот «Ведомость машинных носителей информации». Понятно, что раньше в нем были номера магнитных барабанов или бобин с пленкой. А сейчас что туда вносить?

Короче, на фазе РД документы Информационного обеспечения представляют собой довольно зловредный рудимент, так как формально они быть должны, но наполнять их особенно нечем.

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

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

Техническое обеспечение (ТО) . Не менее любимая всеми часть проектной документации. Радужную картину омрачает только обилие документов, которые требуется разрабатывать. Всего по стандарту требуется разработать 22 документа, из них 9 на стадии ТП.

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

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

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

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

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

Руководство пользователя . Комментарии излишни, я думаю.

Методика (технология) автоматизированного проектирования . В этот документ при необходимости можно поместить описание процесса сборки ПО, управления версиями, тестирования и т.п. Но это если в ТЗ заказчик желает самолично осуществлять сборку ПО. Если он этого не требует (и не платит за это), то вся ваша внутренняя кухня не его ума дело, и этот документ делать не нужно.

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

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

Технологическая инструкция является прослойкой между ОРД и руководством пользователя. РП подробно описывает как нужно делать те или иные действия в системе. Технологическая инструкция говорит о том, какие действия необходимо выполнять в тех или иных случаях, связанных с эксплуатацией системы. Грубо говоря, технологическая инструкция это краткий дайджест по РП для конкретной должности или роли. Если у заказчика роли не сформированы или он хочет, чтобы вы сами сформировали роли и требования к должностям, включите в документ самые базовые роли, например: оператор, старший оператор, администратор. Замечания заказчика на тему, «а у нас не так» или «а нам не нравится» должны сопровождаться перечнем ролей и описанием должностных обязанностей. Потому что бизнес-процессы мы не ставим . Мы эти бизнес-процессы автоматизируем .

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

Описание технологического процесса обработки данных (включая телеобработку) . Жалкий рудимент пещерного века, когда были специально выделенные «Операторы ЭВМ», скармливающие машине перфокарты и упаковывающие распечатку результата в конвертик. Эта инструкция - для них. Что в нее писать в XXI веке - я вам точно сказать не могу. Выкручивайтесь сами. Самое лучшее, это просто забыть про этот документ.

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

А в-третьих, в состав ОР входит мега-документ под названием «Пояснительная записка к техническому проекту», который по задумке представляет собой некий Executive Summary, а по факту многие проектанты пихают в него вообще все полезное содержание стадии ТП. Подобный радикальный подход бывает оправдан и даже взаимно выгоден и заказчику и исполнителю работ, но в определенных случаях.

Варианты использования ГОСТ 34

1. Полное и точное следование стандарту . Добровольно никто, естественно, такую тучу документов писать не будет. Поэтому полный комплект документов готовится только по настоятельной просьбе заказчика, которую он закрепил в ТЗ и еще договором сверху придавил. В таком случае требуется понимать все буквально и отдать заказчику физические «книжки», на которых будут стоять названия документов из таблицы 2 ГОСТ 34.201-89 за исключением совсем уж ненужных, перечень которых вы обязательно должны обговорить и закрепить письменно. Содержание документов также должно без всякой фантазии соответствовать РД 50-34.698-90, вплоть до названия разделов. Для того, чтобы у заказчика взорвался мозг, иногда большую систему делят на подсистемы, и для каждой подсистемы выпускают отдельную проектную документацию. Выглядит это устрашающе и нормальному контролю при помощи земного разума не подлежит. Особенно в части интеграции подсистем. Что значительно упрощает приемку. Главное, чтобы вы сами при этом не запутались и чтобы ваша система все-таки заработала как надо.
2. Мы просто любим ГОСТы . В серьезных больших компаниях любят стандарты. Потому, что они помогают людям лучше понимать друг друга. Если ваш заказчик замечен в любви к порядку и стандартизации, постарайтесь придерживаться стандартной идеологии ГОСТ при разработке документов, даже если этого не требует ТЗ. Вас лучше поймут и одобрят согласующие специалисты, а вы сами не забудете включить в документацию важную информацию, лучше будете видеть целевую структуру документов, точнее планировать работы по их написанию и сэкономите себе и коллегам массу нервов и денег.
3. Нам плевать на документацию, лишь бы все работало . Исчезающий вид безответственного заказчика. Подобный взгляд на документацию пока еще можно встретить у небольших и бедных заказчиков, а также в оставшихся со времен перестройки авторитарных «идиотократиях», где босс окружен верными друзьями - директорами, и все вопросы решаются в личных беседах. Вы вольны в подобных условиях забивать на документирование вообще, но лучше, все таки, прицел не сбивать и хотя бы схематично наполнять содержимым документацию. Если не этому заказчику, так следующему передадите (продадите).

Заключение

Эта статья была о наших ГОСТах на документирование АСУ. ГОСТы старые, но, как оказалось, до сих пор очень даже полезные в хозяйстве. Не считая некоторые явные рудименты, структура документации обладает свойствами полноты и непротиворечивости, а следование стандарту снимает многие проектные риски, о существовании которых мы можем по началу не догадываться.

Надеюсь, изложенный материал был вам полезен, или, как минимум, интересен. Несмотря на внешнюю скуку, документирование является важной и ответственной работой, аккуратность в которой так же важна, как и при написании хорошего кода. Пишите хорошие документы, коллеги! А я на следующей неделе отправляюсь в две подряд командировки, так что публикацию новых материалов не гарантирую (загашника у меня нет, пишу из головы).

с 01.01 1987 г.

Настоящий стандарт распространяется на автоматизированные системы управления (АСУ) всех видов (кроме общегосударственных) и устанавливает общие требования к АСУ в целом, функциям АСУ, подготовленности персонала и видам обеспечения АСУ, безопасности и эргономики, виды и порядок проведения испытаний при вводе АСУ в действие, комплектность АСУ, гарантии.

Стандарт не устанавливает требования к АСУ, определенные спецификой объектов управления. Эти требования формулируются в техническом задании на создание или развитие каждой АСУ или в других нормативно-технических документах ведомства заказчика АСУ.

Дополнительные требования к АСУ технологическими процессами, АСУ предприятиями, производственными и научно-производственными объединениями, отраслевыми АСУ установлены в обязательных приложениях 1-3 соответственно.

В справочном приложении 4 приведены пояснения к некоторым терминам, применяемым в стандарте.

1. ТРЕБОВАНИЯ К АСУ

1.1. Требования к АСУ в целом

1.1.1. АСУ любого вида должна соответствовать требованиям настоящего стандарта, требованиям технического задания на ее создание или развитие (далее - ТЗ на АСУ), а также требованиям нормативно-технических документов, действующих в ведомстве заказчика АСУ.

1.1.2. Ввод в действие АСУ должен приводить к полезным технико-экономическим, социальным или другим результатам, например:

• снижению численности управленческого персонала;
• повышению качества функционирования объекта управления;
• повышению качества управления и др.

1.1.3. Конкретное содержание требований по пп. 1.1.2, 1.1.5-1.1.11, 1.2, 1.3, 1.4.2, 1.4.3, 1.4.6, 1.4.9, 1.5.2, 1.5.4, 1.5.6, 1.5.7, 1.6.2, 1.6.6, 1.6.12, 1.7.2, 1.7.3 устанавливают в ТЗ на АСУ.

1.1.4. АСУ должна обеспечивать достижение целей ее создания (развития), установленных в ТЗ на АСУ.

1.1.5. В АСУ должна быть обеспечена совместимость между ее частями, а также с автоматизированными системами (АС), взаимосвязанными с данной АСУ.

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

1.1.6. АСУ в целом и все виды ее обеспечения должны быть приспособлены к модернизации, развитию и наращиванию в пределах требований, указанных в ТЗ на АСУ.

1.1.7. Надежность АСУ в целом и каждой ее автоматизированной функции должна быть достаточна для достижения установленных целей функционирования системы при заданных условиях применения.

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

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

1.1.10. В АСУ, имеющих измерительные каналы, должна быть предусмотрена возможность контроля метрологических характеристик измерительных каналов.

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

1.1.12. Любая поступающая в АСУ информация вводится в систему однократно с помощью одного входного канала, если это не приводит к невыполнению требований, установленных в ТЗ на АСУ (по надежности, достоверности и т. п.).

1.1.13. Выходная информация одного и того же смыслового содержания должна быть сформирована в АСУ однократно, независимо от числа адресатов.

1.1.14. Информация, содержащаяся в базах данных АСУ, должна быть актуализирована в соответствии с периодичностью ее использования при выполнении функций системы.

1.1.15. АСУ должна быть защищена от утечки информации, если это оговорено в ТЗ на АСУ.

1.1.16. Наименование АСУ должно включать наименование вида АСУ и объекта управления.

Например:

• АСУТП нагрева металла в методической печи;
• организационно-технологическая АСУ цехом № 5;
• АСУП завода «Серп и молот»

1.2. Требования к функциям АСУ

1.2.1. АСУ в необходимых объемах должна автоматизированно выполнять:

• сбор, обработку и анализ информации (сигналов, сообщений, документов и т. п.) о состоянии объекта управления;
• выработку управляющих воздействий (программ, планов и т. п.);
• передачу управляющих воздействий (сигналов, указаний, документов) на исполнение и ее контроль;
• реализацию и контроль выполнения управляющих воздействий;
• обмен информацией (документами, сообщениями и т. п.) с взаимосвязанными автоматизированными системами.

1.2.2. Состав автоматизированных функций (задач, комплексов задач - далее функций) АСУ должен обеспечивать возможность управления соответствующим объектом в соответствии с любой из целей, установленных в ТЗ на АСУ.

1.2.3. Состав автоматизированных функций АСУ и степень их автоматизации должны быть технико-экономически и (или) социально обоснованы с учетом необходимости освобождения персонала от выполнения повторяющихся действий и создания условий для использования его творческих способностей в процессе работы.

1.3. Требования к подготовленности персонала АСУ

1.3.1. Квалификация персонала АСУ должна обеспечивать эффективное функционирование системы во всех заданных режимах.

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

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

1.4. Требования к техническому обеспечению АСУ

1.4.1. Комплекс технических средств АСУ должен быть достаточным для выполнения всех автоматизированных функций АСУ.

1.4.2. В комплексе технических средств АСУ должны в основном использоваться технические средства серийного производства. При необходимости допускается применение технических средств единичного производства.

1.4.3. Тиражируемые АСУ и их части должны строиться на базе унифицированных технических средств.

1.4.4. Технические средства АСУ должны быть размещены с соблюдением требований, содержащихся в технической, в том числе эксплуатационной, документации на них, и так, чтобы было удобно использовать их при функционировании АСУ и выполнять техническое обслуживание.

1.4.5. Размещение технических средств, используемых персоналом АСУ при выполнении автоматизированных функций, должно соответствовать требованиям эргономики: для производственного оборудования по ГОСТ 12.049-80, для средств представления зрительной информации по ГОСТ 21829-76, в том числе для табло коллективного пользования из цифровых знакосинтезирующих электролюминесцентных индикаторов по ГОСТ 21837-76.

1.4.6. Технические средства АСУ, используемые при взаимодействии АСУ с другими системами, должны быть совместимы по интерфейсам с соответствующими техническими средствами этих систем и используемых систем связи.

1.4.7. В АСУ должны быть использованы технические средства со сроком службы не менее десяти лет. Применение технических средств с меньшим сроком службы допускается только в обоснованных случаях и по согласованию с заказчиком АСУ.

1.4.8. Любое из технических средств АСУ должно допускать замену его средством аналогичного функционального назначения без каких-либо конструктивных изменений или регулировки в остальных технических средствах АСУ (кроме случаев, специально оговоренных в технической документации на АСУ).

1.4.9. Технические средства АСУ допускается использовать только в условиях, определенных в эксплуатационной документации на них. В случаях, когда необходимо их использование в среде, параметры которой превышают допустимые значения, установленные для этих технических средств, должны быть предусмотрены меры защиты отдельных технических средств АСУ от влияния внешних воздействующих факторов.

1.4.10. В АСУ должны быть использованы средства вычислительной техники, удовлетворяющие общим техническим требованиям по ГОСТ 22552-84.

1.4.11. В АСУ должны быть использованы технические средства, соответствующие:

• по устойчивости к внешним воздействующим факторам - ГОСТ 12997-76 для промышленных приборов и средств автоматизации ГСП, ГОСТ 14254-80 для оболочек изделий электротехники, ГОСТ 17516-72 для изделий электротехники в части воздействия механических факторов внешней среды, ГОСТ 21552-84 для средств вычислительной техники;
• по параметрам питания - ГОСТ 12997-76 для промышленных приборов и средств автоматизации ГСП, ГОСТ 21552-84 для средств вычислительной техники;
• по категории исполнения - ГОСТ 12997-76 для промышленных приборов и средств автоматизации ГСП, ГОСТ 21552-84 для средств вычислительной техники.

1.4.12. Защита технических средств АСУ от воздействия внешних электрических и магнитных полей, а также помех по цепям питания должна быть достаточной для эффективного выполнения техническими средствами своего назначения при функционировании АСУ.

1.4.13. В АСУ в соответствии с требованиями, предусмотренными « Общесоюзными нормами допускаемых индустриальных помех » 1-72 - 9-72 и ГОСТ 23450-79, должны быть предусмотрены меры по защите внешней среды от индустриальных радиопомех, излучаемых техническими средствами АСУ при работе, а также в момент включения и выключения.

1.4.14. Общие эргономические требования к мнемосхемам - по ГОСТ 21480-76, к счетным устройствам индикаторов визуальных - по ГОСТ 22902-78, к табло коллективного пользования на цифровых знакосинтезирующих электролюминесцентных индикаторах - по ГОСТ 21837-76, к трубкам электронно-лучевым для отображения визуальной информации - по ГОСТ 23144-78.

1.4.15. Общие эргономические требования к выключателям на пультах: поворотным - по ГОСТ 22613-77, клавишным и кнопочным - по ГОСТ 22614-77, типа « Тумблер » - по ГОСТ 22615-77.

1.4.16. Общие эргономические требования к сигнализаторам звуковых первичных сообщений - по ГОСТ 21786-76.

1.4.17. Общие эргономические требования, регламентирующие организацию рабочего места, взаимное расположение средств отображения информации, органов управления и средств связи в пределах рабочего места - по ГОСТ 22269-76, в том числе пультов - по ГОСТ 23000-76.

1.4.18. Общие эргономические требования к креслам операторов по ГОСТ 21889-76.

1.4.19. Общие эргономические требования к залу, кабинам операторов и взаимному расположению мест - по ГОСТ 21958-76.

1.5. Требования к программному обеспечению АСУ

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

1.5.2. Программное обеспечение АСУ должно обладать следующими свойствами:

• функциональная достаточность (полнота);
• надежность (в том числе восстанавливаемость, наличие средств выявления ошибок);
• адаптируемость;
• модифицируемость;
• модульность построения и
• удобство эксплуатации.

1.5.3. Программное обеспечение АСУ должно быть преимущественно построено на базе существующих пакетов прикладных программ и других программ, заимствованных из государственных, отраслевых и других фондов алгоритмов и программ, допускать загрузку и проверку по частям и позволять производить замену одних программ без коррекции других.

1.5.4. В АСУ должны быть преимущественно использованы системы управления базами данных (СУБД), зарегистрированные в установленном порядке.

1.5.5. Программное обеспечение АСУ должно быть построено таким образом, чтобы отсутствие отдельных данных не сказывалось на выполнении функций АСУ, при реализации которых эти данные не используются.

1.5.6. Программное обеспечение АСУ должно иметь средства диагностики технических средств АСУ и контроля на достоверность входной информации.

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

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

1.5.9. Все программы специального программного обеспечения конкретной АСУ должны быть совместимы как между собой, так и с ее общим программным обеспечением.

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

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

1.6. Требования к информационному обеспечения АСУ

1.6.1. Информационное обеспечение АСУ должно быть достаточным для выполнения всех автоматизированных функций АСУ.

1.6.2. Для кодирования информации, используемой только в данной АСУ, должны быть применены классификаторы, принятые у заказчика АСУ.

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

1.6.4. Общие эргономические требования к кодированию информации - по ГОСТ 21829-76.

1.6.5. В АСУ для связи между устройствами комплекса технических средств должны быть применены:

• входные и выходные сигналы:
  • электрические - тока и напряжения по ГОСТ 26.011-80, с дискретным изменением параметров по ГОСТ 26.013-81, кодированные по ГОСТ 26.014-81,
  • гидравлические по ГОСТ 26.012-80,
  • пневматические по ГОСТ 26.015-81;
• наборы символов алфавитно-цифровые по ГОСТ 19767-74;
• коды 8-битные по ГОСТ 19768-74.

1.6.6. Информационное обеспечение АСУ должно быть совместимо с информационным обеспечением систем, взаимодействующих с ней, по содержанию, системе кодирования, методам адресования, форматам данных и форме представления информации, получаемой и выдаваемой АСУ.

1.6.7. Формы документов, создаваемых АСУ, должны соответствовать требованиям стандартов УСД или нормативно-технических документов ведомства заказчика АСУ.

1.6.8. Формы документов и видеокадров, вводимых, выводимых или корректируемых через терминалы АСУ, должны быть согласованы с соответствующими техническими характеристиками терминалов.

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

1.6.10. Форма представления выходной информации АСУ должна быть согласована с заказчиком (пользователем) системы.

1.6.11. Применяемые в выходных документах АСУ термины и сокращения должны быть общепринятыми в данной предметной области и согласованы с заказчиком системы.

1.6.12. В АСУ должны быть предусмотрены необходимые меры по контролю и обновлению данных в информационных массивах АСУ, восстановлению массивов после отказа каких-либо технических средств АСУ, а также контролю идентичности одноименной информации в базах данных.

1.7. Требования к организационному обеспечению АСУ

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

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

1.7.3. Требования к распределению обязанностей среди персонала, участвующего в функционировании АСУ в режиме реального времени, определяют с учетом требований п 11 обязательного приложения 1.

1.7.4. Инструкции организационного обеспечения АСУ должны определять действия персонала АСУ, необходимые для выполнения каждой автоматизированной функции, во всех режимах функционирования АСУ, с учетом заданных требований по безошибочности и быстродействию реализации персоналом АСУ своих функциональных обязанностей, а также содержать конкретные указания о действиях в случае возникновения аварийных ситуаций или нарушении нормальных условий функционирования АСУ. Требования к содержанию инструкций - по ГОСТ 24.209-80.

1.7.5. По каждой автоматизируемой функции, которая выполняется во взаимодействии данной АСУ с другими системами, инструкции персоналу АСУ и этих систем должны быть взаимоувязаны для всех режимов выполнения данной функции и содержать указания о действиях персонала при отказах технических средств АСУ.

1.8. Требования к лингвистическому обеспечению АСУ

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

1.8.2. В лингвистическом обеспечении АСУ должны быть:

• предусмотрены языковые средства для описания любой используемой в АСУ информации;
• унифицированы используемые языковые средства;
• стандартизованы описания однотипных элементов информации и записи синтаксических конструкций;
• обеспечены удобство, однозначность и устойчивость общения пользователей со средствами автоматизации АСУ;
• предусмотрены средства исправления ошибок, возникающие при общении пользователей с техническими средствами АСУ.

1.8.3. Лингвистическое обеспечение АСУ должно быть отражено в документации (инструкциях, описаниях) организационного обеспечения АСУ в виде правил общения пользователей с техническими средствами АСУ во всех режимах функционирования системы.

1.9. Требования к правовому обеспечению АСУ

Правовое обеспечение АСУ должно включать совокупность правовых норм:

• определяющих юридическую силу информации на носителях данных и документов, используемых при функционировании АСУ и создаваемых системой;
• регламентирующих правоотношения между людьми, входящими в состав персонала АСУ (права, обязанности и ответственность), а также между персоналом АСУ и персоналом систем, взаимодействующих с АСУ.

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

1.10. Требования к эксплуатационной документации на АСУ

1.10.1. Эксплуатационная документация на АСУ должна быть достаточной для ввода АСУ в действие и ее эффективного функционирования.

1.10.2. Эксплуатационная документация на АСУ должна:

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

2. ТРЕБОВАНИЯ БЕЗОПАСНОСТИ

2.1. Неправильные действия персонала АСУ не должны приводить к аварийной ситуации.

2.2. Требования по безопасности электротехнических изделий, используемых в АСУ, - по ГОСТ 12.2.007.0-75.

2.3. Требования по безопасности средств вычислительной технике, используемых в АСУ, - по ГОСТ 25861-83.

2.4. Все внешние элементы технических средств АСУ, находящиеся под напряжением, должны иметь защиту от случайного прикосновения, а сами технические средства иметь зануление или защитное заземление в соответствии с ГОСТ 12.1.030-81 и « Правилами устройства электропитания ».

2.5. Технические средства АСУ, размещаемые на взрыво- и пожароопасных установках, должны отвечать требованиям « Правилами устройства электропитания ».

2.6. Технические средства АСУ должны быть установлены так, чтобы обеспечивалось их безопасная эксплуатация и техническое обслуживание.

2.7. Требования безопасности должны быть установлены специальным разделом должностных инструкций и (или) инструкции по эксплуатации АСУ и иметь ссылки на инструкции по эксплуатации технических средств.

2.8. Общие эргономические требования к рабочим местам персонала АСУ - по ГОСТ 22269-76.

2.9. Комфортные условия обитаемости персонала АСУ должны соответствовать действующим санитарным нормам, предельно допустимые условия обитаемости - по ГОСТ 12.1.005-76, допустимые уровни влияния опасных и вредных производственных факторов - по ГОСТ 12.0.003-74.

2.10. Общие эргономические требования к микроклимату рабочих помещений персонала АСУ - по ГОСТ 12.1.005-76.

2.11. Уровни шума и звуковой мощности в местах расположения персонала АСУ не должны превышать значений, установленных ГОСТ 12.1.003-83 и санитарным нормам, при этом должны быть учтены уровни шумов и звуковой мощности, создаваемые всеми источниками, в том числе и акустическими средствами передачи данных.

2.12. Уровни освещенности рабочих мест персонала АСУ должны соответствовать характеру и условиям труда. Должны быть предусмотрены защита от слепящего действия света и устранения бликов.

2.13. Общие эргономические требования к вибрации оборудования на рабочих местах персонала АСУ - по ГОСТ 12.1.012-78.

2.14. Сигнальные цвета и знаки безопасности по ГОСТ 12.4.026-76.

3. ВИДЫ И ПОРЯДОК ПРОВЕДЕНИЕ ИСПЫТАНИЙ ПРИ ВВОДЕ АСУ В ДЕЙСТВИЕ

Настоящий раздел распространяется на все АСУ, кроме создаваемых по заказам Министерства обороны.

3.1. АСУ или отдельно сдаваемая функция АСУ (далее - АСУ) при вводе ее в действие должна пройти предварительные и приемочные испытания, а также испытания, предусмотренные нормативно-техническими документами, действующими в ведомстве заказчика АСУ.

3.2. Приемочным испытаниям АСУ должна предшествовать ее опытная эксплуатация на объекте управления.

3.3. Испытания АСУ проводят в соответствии с документом «Программа испытаний», который готовит разработчик АСУ. Требования к содержанию программы испытаний - по ГОСТ 24.208-80 .

3.4. Испытания АСУ допускается проводить в один или несколько этапов.

По результатам испытаний АСУ составляют «Протокол испытаний». Требования к содержанию протокола испытаний - по ГОСТ 24.208-80 .

При поэтапном испытании АСУ в «Протоколе испытаний» по результатам предыдущего этапа должен быть вывод о возможности представления АСУ на последующий этап испытаний.

3.5. Предварительные испытания АСУ

3.5.1. Предварительные испытания АСУ проводят для определения ее работоспособности и решения вопроса о возможности приемки АСУ в опытную эксплуатацию.

3.5.2. «Программу испытаний» для предварительных испытаний АСУ утверждает заказчик АСУ.

3.5.3. Предварительные испытания АСУ организует заказчик и проводят разработчик АСУ и заказчик совместно.

3.5.4. Комиссию для проведения предварительных испытаний АСУ образуют приказом заказчика. Председателем комиссии назначают представителя заказчика АСУ.

3.5.6. В «Протоколе испытаний», составленном по результатам предварительных испытаний АСУ, приводят заключение о возможности приемки АСУ в опытную эксплуатацию, а также перечень необходимых доработок и рекомендуемые сроки их выполнения.

3.6. Опытная эксплуатация АСУ

3.6.1. Результаты приемки АСУ в опытную эксплуатацию оформляют «Актом приемки в опытную эксплуатацию», составленным на основании «Протокола испытаний» комиссией, проводившей предварительные испытания АСУ. Требования к содержанию акта - по ГОСТ 24.208-80 .

3.6.2. Продолжительность опытной эксплуатации АСУ определяют по срокам, необходимым для проверки правильности функционирования АСУ при выполнении каждой автоматизированной функции и готовности персонала АСУ к участию в выполнении всех автоматизированных функций АСУ.

3.6.3. Минимальную длительность опытной эксплуатации АСУ (кроме ОАСУ) перед приемочными испытаниями определяют для каждой сдаваемой автоматизированной функции АСУ, она должна соответствовать значениям, указанным в таблице. Если общая продолжительность нарушений непрерывности выполнения автоматизированной функции превышает значение, указанное в таблице, опытная эксплуатация должна быть продолжена до получения результатов, соответствующих таблице, или до принятия решения о ее прекращении.

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

1. Нарушением непрерывности выполнения автоматизированной функции АСУ считают ее невыполнение в предусмотренный технической документацией на АСУ момент времени, если это не вызвано нарушением условий функционирования АСУ или объекта управления.

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

3.6.4. Во время опытной эксплуатации АСУ ведется рабочий журнал, в который заносят сведения: о продолжительности функционирования АСУ, о результатах наблюдения за правильностью функционирования АСУ, об отказах, сбоях, аварийных ситуациях, об изменениях параметров объекта управления и проводимых корректировках технической документации.

3.6.5. По результатам опытной эксплуатации составляют акт о завершении работ по проверке АСУ в режиме опытной эксплуатации. Требования к содержанию акта - по ГОСТ 24.208-80 .

3.7. Приемочные испытания АСУ

3.7.1. Приемочные испытания АСУ проводят для определения ее соответствия ТЗ на АСУ, требованиям настоящего стандарта и определения возможности ввода АСУ в действие.

3.7.2. В зависимости от важности объекта управления и АСУ приемочные испытания могут быть:

• государственные;
• межведомственные;
• ведомственные

3.7.3. Председателем приемочной комиссии назначают представителя заказчика АСУ. В состав приемочной комиссии обязательно включают представителей разработчика АСУ.

3.7.4. Работа приемочной комиссии не включает приемку зданий, сооружений и вспомогательного оборудования, создание которых осуществлено в связи с созданием АСУ. Комиссия проверяет только наличие актов о приемке их в эксплуатацию и выполнение требований, содержащихся в заданиях на проектирование в смежных частях проекта объекта, выданных в ходе проектирования АСУ.

3.7.5. Приемочной комиссии заказчик и разработчик предъявляют следующую документацию:

• техническое задание на создание АСУ;
• проект программы приемочных испытаний;
• протокол предварительных испытаний АСУ;
• акт приемки АСУ в опытную эксплуатацию;
• акт (акты) о завершении работ по проверке АСУ в режиме опытной эксплуатации;
• техническую документацию на АСУ (по решению приемочной комиссии).

3.7.6. Перед предъявлением на приемочные испытания АСУ, имеющей измерительные каналы, проводят их метрологическую аттестацию в соответствии с действующими стандартами.

3.7.7. Перед предъявлением АСУ на приемочные испытания система и ее техническая документация должны быть доработаны по замечаниям протокола предварительных испытаний и акта о завершении работ по проверке АСУ в режиме опытной эксплуатации.

Допускается по решению приемочной комиссии доработка технической документации АСУ после ввода ее в действие. Сроки доработки технической документации АСУ указывают в протоколе приемочных испытаний системы.

3.7.8. Приемочные испытания АСУ должны быть проведены на функционирующем объекте управления.

3.7.9. «Программа испытаний» для приемочных испытаний АСУ должна быть утверждена решений приемочной комиссии. Согласование программы приемочных испытаний с заказчиком АСУ обязательно.

3.7.10. По результатам приемочных испытаний комиссия составляет протокол испытаний и акт о вводе АСУ в действие (или заключение о неприемке АСУ с перечнем необходимых доработок и рекомендуемыми сроками их выполнения). Требования к содержанию протокола и акта по ГОСТ 24.208-80 . Требования к содержанию заключения о неприемке АСУ аналогичны требованиям к содержанию акта о вводе АСУ в действие.

3.7.11. В случае поэтапного проведения приемочных испытаний акт о вводе АСУ в действие оформляют на основании актов о вводе в действие отдельных частей системы и (или) «Протоколов испытаний» всех этапов приемочных испытаний АСУ.

3.7.12. Датой ввода АСУ в действие считают дату подписания акта о вводе в действие приемочной комиссией.

3.7.13. Акт о вводе АСУ в действие утверждает министерство (ведомство) заказчика.

4. КОМПЛЕКТНОСТЬ АСУ, ВВОДИМОЙ В ДЕЙСТВИЕ

4.1. В АСУ должны входить:

• технические средства АСУ в виде комплекса технических средств АСУ, подготовленного к эксплуатации;
• запасные изделия и приборы (ЗИП), приборы и устройства для проверки работоспособности, наладки технических средств и контроля метрологических характеристик измерительных каналов АСУ в объеме, предусмотренном заказной проектной документацией, согласованной с заказчиком АСУ и службой метрологии пользователя в части аппаратуры проверки;
• эксплуатационной документацией по ГОСТ 2.601-68 на каждое из изделий, входящих в состав КТС АСУ;
• не менее двух экземпляров программ на носителях данных и эксплуатационной документации на них по ГОСТ 19.101-77 , с учетом ограничений и дополнений по ГОСТ 24.101-80 и ГОСТ 24.207-80 ;
• формуляр на программное обеспечение АСУ в целом или на программное обеспечение функции АСУ, вводимой в действие отдельно и формуляры на программные изделия (по ГОСТ 19.004-80), каждый в одном экземпляре. Требования к формуляру - по ГОСТ 19.501-78 ;
• два экземпляра эксплуатационной документации на АСУ по ГОСТ 24.101-80 , в том числе необходимая документация информационного обеспечения АСУ (формуляр АСУ в одном экземпляре).

По согласованию между разработчиком АСУ и заказчиком АСУ комплектность АСУ может быть расширена.

4.2. Штаты АСУ должны быть укомплектованы персоналом, удовлетворяющим требованиям п. 1.3.

4.3. Для комплектации создаваемой АСУ могут быть использованы поставляемые как продукция производственно-технического назначения:

• комплекс (комплексы) технических и программных средств с эксплуатационной документацией на них по ГОСТ 2.601-68;
• программные изделия с эксплуатационной документацией на них по ГОСТ 19.101-77 ;
• технические средства с эксплуатационной документацией на них по ГОСТ 2.601-68.

4.4. Порядок разработки, постановки на производство и испытаний поставляемых комплектующих, использованных в АСУ, должен соответствовать Государственным стандартам системы разработки и постановки продукции на производство.

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

5. ГАРАНТИИ

5.1. Разработчик АСУ гарантирует соответствие АСУ требованиям настоящего стандарта и ТЗ на АСУ при соблюдении пользователем условий и правил эксплуатации.

5.2. соответствие применяемых в АСУ и поставляемых как продукция производственно-технического назначения технических, программных средств и комплексов средств автоматизации требованиям стандартов и ТУ на них гарантируют изготовители этих видов продукции при соблюдении пользователем условий и правил эксплуатации.

5.3. Гарантийный срок эксплуатации на АСУ исчисляют со дня ввода АСУ в действие.

5.4. Гарантийный срок эксплуатации на АСУ должен быть установлен в ТЗ на АСУ и не может быть менее 18 мес.

ПРИЛОЖЕНИЕ 1
Обязательное

ДОПОЛНИТЕЛЬНЫЕ ТРЕБОВАНИЯ К АВТОМАТИЗИРОВАННЫМ СИСТЕМАМ УПРАВЛЕНИЯ ТЕХНОЛОГИЧЕСКИМИ ПРОЦЕССАМИ (АСУ ТП)

1. АСУ ТП в промышленности и в непромышленной сфере должна управлять технологическим объектом в целом и снабжать взаимосвязанные с ней системы достоверной технологической и технико-экономической информацией о работе технологического объекта управления (ТОУ).

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

3. АСУ ТП должна выполнять управляющие, информационные и вспомогательные функции.

4. АСУ ТП должна быть совместима со всеми взаимосвязанными с ней автоматизированными системами (АС), указанными в ТЗ на АСУ ТП, в том числе с системами, входящими вместе с данной АСУ ТП в состав гибкого автоматизированного производства, например, САПР технологии, автоматизированными складскими и транспортными системами, АС технологической подготовки производства.

5. Управляющие воздействия в АСУ ТП должны вырабатываться автоматически или формироваться ее оперативным персоналом с помощью комплекса средств автоматизации, входящего в систему.

6. АСУ ТП должна обеспечивать управление объектом в нормальных, переходных и предаварийных условиях его функционирования, а также защиту или остановку объекта при угрозе аварии.

7. АСУ ТП должна осуществлять функцию контроля исполнения управляющих воздействий на ТОУ и сигнализировать о выходе исполнительных органов в предельно допустимые положения.

8. При реализации функции аварийного автоматического отклонения оборудования в АСУ ТП должна быть обеспечена сигнализация об этом оперативному персоналу с помощью светового и, при необходимости, звукового сигналов с автоматической регистрацией времени отключения.

9. В качестве основных технических средств АСУ ТП должны быть использованы изделия Государственной системы промышленных приборов и средств автоматизации (ГСП), другие изделия, удовлетворяющие требованиям стандартов ЕССП, и средства вычислительной техники, соответствующие ГОСТ 21552-84.

10. Технические средства АСУ ТП, размещаемые на технологическом оборудовании, должны соответствовать требованиям, предъявляемым к ним условиям эксплуатации.

11. Обязанности между операторами должны быть распределены с учетом:

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

12. Каждое лицо, входящее в состав персонала, должен обладать:

• знаниями, объем и глубина которых позволяет ему выполнять действия (взаимодействия), входящее в соответствующие автоматизированные и взаимосвязанные с ними неавтоматизированные функции АСУ ТП, а также принимать правильные решения в аварийных ситуациях или при других нарушениях нормальной эксплуатации;
• отработанными навыками, позволяющими с заданными безошибочностью и быстродействием выполнять все действия и взаимодействия.

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

14. Коды и условные обозначения, используемые в АСУ ТП, должны быть приближены к терминам и понятиям, применяемым технологическим персоналом объекта управления, и не должны вызывать трудностей при их восприятии.

15. Измерительные каналы АСУ ТП должны иметь метрологические характеристики, обеспечивающие выполнение ее информационных функций с показателями, заданными в ТЗ на АСУ ТП.

16. Требования к испытаниям АСУ ТП

16.1. Предварительные испытания АСУ ТП проводят на действующем ТОУ.

16.2. Предварительные испытания функций АСУ ТП, необходимых для проведения пуска и обкатки технологического оборудования, допускается проводить на объекте с помощью имитаторов.

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

ПРИЛОЖЕНИЕ 2
Обязательное

ДОПОЛНИТЕЛЬНЫЕ ТРЕБОВАНИЯ К АСУ ПРЕДПРИЯТИЯМИ, ПРОИЗВОДСТВЕННЫМИ И НАУЧНО-ПРОИЗВОДСТВЕННЫМИ ОБЪЕДИНЕНИЯМИ

1. АСУ должна повышать эффективность производственно-хозяйственной деятельности предприятиями, производственного или научно-производственного объединения (в дальнейшем - предприятия).

2. АСУ предприятием (АСУП) должна обеспечивать автоматизированный сбор и обработку информации с широким использованием методов оптимизации по основным задачам и подсистемам управления общезаводского и цехового уровня, в том числе при необходимости в реальном масштабе времени в режиме телеобработки и диалога.

3. АСУП должна быть реализована в виде совокупности совместно функционирующих подсистем, взаимодействие между которыми должно происходить через общую (единую или распределенную) базу данных.

4. Организационное обеспечение АСУП должно предусматривать совершенствование методов управления и структуры системы управления предприятиями при создании и развитии АСУП.

ПРИЛОЖЕНИЕ 3
Обязательное

ДОПОЛНИТЕЛЬНЫЕ ТРЕБОВАНИЯ К ОТРАСЛЕВЫМ АВТОМАТИЗИРОВАННЫМИ СИСТЕМАМ УПРАВЛЕНИЯ (ОАСУ)

1. ОАСУ должна обеспечивать:

• улучшение характеристик объекта управления (повышение производительности труда в отрасли, повышение качества продукции, своевременное выполнение поставок продукции, снижение себестоимости выпускаемой продукции);
• совершенствование процессов обработки информации (снижение стоимости обработки информации, повышение достоверности исходных, повышение точности и оперативности расчетов);
• совершенствование организации выполнения функций управления (в частности, рациональное распределение работ между подразделениями аппарата управления, вычислительными центрами и научно-исследовательскими организациями и предприятиями).

2. В ОАСУ должны быть автоматизированы функции управления отраслью, например:

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

3. ОАСУ должна быть реализована в виде совокупности совместно функционирующих подсистем, взаимодействие между которыми должно происходить через общие базы данных.

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

5. ОАСУ должна обеспечивать интерактивный режим работы с базами данных системы.

6. Создание ОАСУ должно приводить к совершенствованию методов и структуры управления отраслью.

7. Продолжительность опытной эксплуатации частей ОАСУ должна обеспечивать однократное проведение всех расчетов, необходимых для выполнения автоматизированных функций вводимой части ОАСУ, и не должна превышать 3 мес.

Конкретную продолжительность опытной эксплуатации ОАСУ устанавливают по согласованию между разработчиком и заказчиком.

ПРИЛОЖЕНИЕ 4
Справочное

ПОЯСНЕНИЕ К НЕКОТОРЫМ ТЕРМИНАМ, ПРИМЕНЯЕМЫМ В НАСТОЯЩЕМ СТАНДАРТЕ

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

Наращивание АСУ - совокупность мер, принимаемых в АСУ при расширении ее объекта управления без изменения состава функций АСУ.

Видеокадр (в АСУ) - изображение на экране электронно-лучевой трубки документа рисунка или текста сообщения, используемых в АСУ.

Измерительный канал АСУ - функционально объединенная совокупность технических и (при необходимости) программных средств, предназначенная для реализации одной простой измерительной функции АСУ.

Предварительные испытания АСУ - контрольные испытания, проводимые с целью определения возможности приемки АСУ в опытную эксплуатацию.

Приемочные испытания АСУ - контрольные испытания АСУ, проводимые для определения ее соответствия техническому заданию на создание АСУ, требованиям стандартов и определения возможности ввода АСУ в действие.

Государственные испытания - приемочные испытания АСУ, проводимые государственной комиссией.

Межведомственная испытания - приемочные испытания АСУ, проводимые комиссией из представителей нескольких заинтересованных министерств и (или) ведомств.

Ведомственная испытания - приемочные испытания АСУ, проводимые комиссией из представителей заинтересованного министерства или ведомства.

Редактор А.И. Ломина
Технический редактор Н.П. Замолодчикова
Корректор Е.И. Евтеева
Сдано в набор 16.01.86. Подписано в печать 08.04.86. Усл. печ. л. 1,5. Усл. кр.-отт. 1,5 Уч.-изд. л. 1,5.
Тираж 40000 Цена 10 коп.
Ордена «Знак Почета» Издательство стандартов, 123810, Москва, ГСП, Новопресненский пер., 3
Тип. "Московский печатник", Москва, Лялин пер., 6. Заказ 1772

Введение

В современном мире каждый день появляется десятки и сотни различных программ, приложений, информационных систем. Они могут быть разработаны как для государственного или коммерческого сектора, так и для обычных пользователей. 90% всех пользователей не читает документацию, считает её скучной, занудной и неинтересной, а открывает руководство пользователя только тогда, когда что-то не получается или разобраться без инструкции уж совсем невозможно. Общепринято теперь строить пользовательский интерфейс таким образом, чтобы он был интуитивно понятен, и пользователь мог разобраться с системой, не прибегая к чтению длиннейших мануалов. Однако, при работе с крупными заказчиками практически всегда необходимо сдать определённый пакет документов – руководств, инструкций, проектных решений, оформленных по ГОСТу.
Когда впервые сталкиваешься с написанием документации по ГОСТу, то приходишь в ступор и полный шок, так как этих ГОСТов «море» и, как и чего по ним писать становится неясно.
В этой статье рассмотрены ГОСТы для написания документации и их основные моменты.

Какие бывают ГОСТы?

Для начала надо разобраться какие бывают ГОСТы. Все лишь знают, что ГОСТ — это нечто, что разрабатывалось при Союзе и их просто бесконечное количество. Спешу вас успокоить для сферы IT ГОСТов не так много, и они все, несмотря на свой срок создания, не потеряли своей актуальности.
В первую очередь стандарты для написания документации делятся на два типа:

1. Международные стандарты (ISO, IEEE Std);
2. Российские или Советские ГОСТы.

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

1. IEEE Std 1063-2001 «IEEE Standard for Software User Documentation» - стандарт для написания руководства пользователя;
2. IEEE Std 1016-1998 «IEEE Recommended Practice for Software Design Descriptions» - стандарт для написания технического описания программы;
3. ISO/IEC FDIS 18019:2004 «Guidelines for the design and preparation of user documentation for application software» - ещё один стандарт для написания руководства пользователя. В данном документе есть большое количество примеров. Так сказать, это больше похоже на руководство по написанию руководства пользователя. Начинающим специалистам будет особенно полезен;
4. ISO/IEC 26514:2008 «Requirements for designers and developers of user documentation» - ещё один стандарт для дизайнеров и разработчиков пользователей документации.

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

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

Чем отличаются ГОСТы серий 19 и 34?

Первый вопрос, который возникает, а чем, вообще, эти ГОСТы 19 и 34 отличаются друг от друга.
В ГОСТе 19.781-90 «Единая система программной документации. Программное обеспечение систем обраб0отки информации. Термины и определения» указаны определения:

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

В ГОСТе 34.003-90 «Информационная технология. Комплекс стандартов на автоматизированные системы. Автоматизированные системы. Термины и определения» указано определение:

1. Автоматизированная система (АС) - система, состоящая из персонала и комплекса средств автоматизации его деятельности, реализующая информационную технологию выполнения установленных функций.
   В зависимости от вида деятельности выделяют, например, следующие виды АС: автоматизированные системы управления (АСУ), системы автоматизированного проектирования (САПР), автоматизированные системы научных исследований (АСНИ) и другие.

В зависимости от вида управляемого объекта (процесса) АСУ делят, например, на: АСУ технологическими процессами (АСУТП), АСУ предприятиями (АСУП) и т.д.
Также ГОСТ 34 делает разделение на виды обеспечения АС:

1. Организационное;
2. Методическое;
3. Техническое;
4. Математическое;
5. Программное обеспечение;
6. Информационное;
7. Лингвистическое;
8. Правовое;
9. Эргономическое.

В итоге Автоматизированная система - это не программа, а комплекс видов обеспечения, среди которых есть и программное обеспечение. АС, как правило, несёт в себе организационное решение под конкретного пользователя и заказчика, а Программа может быть создана и растиражирована под большое количество пользователей без привязки к какому-либо предприятию.
Поэтому если вы разрабатываете документацию на программу, которую создали под конкретное предприятие, то ваш ГОСТ 34. Если же пишете документы на массовую программу, то ваш ГОСТ 19.

ГОСТ 34

Серия ГОСТов 34 (ГОСТ 34.ххх Стандарты информационной технологии) состоит:

1. ГОСТ 34.201-89 Виды, комплектность и обозначения документов при создании автоматизированных систем - данный стандарт устанавливает виды, наименование, комплектность и номера документов. Является одним из основных документов серии ГОСТов 34. По сути, это базовый документ, так что новичкам необходимо ознакомиться с ним в первую очередь.
2. ГОСТ 34.320-96 Концепции и терминология для концептуальной схемы и информационной базы - настоящий стандарт устанавливает основные понятия и термины концептуальных схем и информационных баз, охватывающие разработку, описание и применение концептуальных схем и информационных баз, манипулирования информацией, а также описание и реализацию информационного процесса. Стандарт определяет роль концептуальной схемы. Положения, изложенные в нём, носят рекомендательный характер и могут использоваться для оценки систем управления базами данных (СУБД). Этот документ не описывает конкретные методы применения средств поддержки концептуальных схем. Описанные в стандарте языки концептуальных схем не следует рассматривать как стандартные.
3. ГОСТ 34.321-96 Информационные технологии. Система стандартов по базам данных. Эталонная модель управления - данный документ устанавливает эталонную модель управления данными.
   Эталонная модель определяет общую терминологию и понятия, относящиеся к данным информационных систем. Такие понятия используются для определения услуг, предоставляемых системами управления базами данных или системами словарей данных.
   Эталонная модель не рассматривает протоколы для управления данными.
   Область применения эталонной модели включает процессы, которые касаются управления постоянными данными и их взаимодействия с процессами, отличающимися от требований конкретной информационной системы, а также общие услуги управления данными, для определения, хранения, поиска, обновления, ввода, копирования, восстановления и передачи данных.
4. ГОСТ 34.601-90 Автоматизированные системы. Стадии создания - стандарт устанавливает стадии и этапы создания АС.
5. ГОСТ 34.602-89 Техническое задание на создание автоматизированной системы (Взамен ГОСТ 24.201-85) - устанавливает состав, содержание, правила оформления документа «Техническое задание на создание (развитие или модернизацию) системы».
   Данный документ является одним из часто используемых документов серии ГОСТ 34. При разработке ТЗ по этому ГОСТу следует помнить и о других стандартах, даже если в этом документе нет ссылок на эти стандарты.
6. ГОСТ 34.603-92 Информационная технология. Виды испытаний автоматизированных систем - стандарт устанавливает виды испытаний АС автономные, комплексные, приёмочные испытаний и опытная эксплуатация) и общие требования к их проведению.
7. РД 50-34.698-90 Автоматизированные системы. Требования к содержанию документов - один из важнейших документов 34 ГОСТа, так как именно в нём описано содержание практически всех документов, а также описание каждого пункта документа.
8. ГОСТ Р ИСО/МЭК 8824-3-2002 Информационная технология. Абстрактная синтаксическая нотация версии один - настоящий стандарт является частью абстрактной синтаксической нотации версии 1 (АСН.1) и устанавливает нотацию для спецификации ограничений, определённых пользователем, и табличных ограничений.
9. ГОСТ Р ИСО/МЭК 10746-3-2001 Управление данными и открытая распределённая обработка.
   В настоящем стандарте:
   • определено, как специфицируются системы открытой распределённой обработки (ОРО) с использованием понятий, введённых в ГОСТ Р ИСО/МЭК 10746-2;
   • идентифицированы характеристики, по которым системы относятся к системам ОРО.

   В стандарте установлен каркас для координации разработки стандартов по системам ОРО.

10. ГОСТ Р ИСО/МЭК 15271-02 Процессы жизненного цикла программных средств - данный ГОСТ необходимо больше, на мой взгляд, для аналитиков при проектировании и моделировании АС.
    Этот документ полезен, с моей точки зрения, в чисто образовательных целях.
11. ГОСТ Р ИСО/МЭК 15910-2002 Процесс создания документации пользователя программного средства - определяет минимально необходимый процесс создания документации пользователя всех видов для программного средства, имеющего интерфейс пользователя. Данные виды охватывают печатную документацию (например, руководства пользователя и краткие справочные карты), диалоговую (оперативную) документацию, справочный текст («хелпы») и системы диалоговой документации.

Итак, исходя из всего выше написанного, видно, что основных документов в 34 ГОСТе 3: ГОСТ 34.201-89, РД 50-34.698-90 и ГОСТ 34.602-89.
При разработке пакета документации, для начала, необходимо открыть ГОСТ 34.201-89 и выбрать стадию создания Эскизный проект, Технический проект и Рабочая документация. Далее, следует выбрать документы для разработки, которые соответствуют стадии создания.

Перечень документов 34 ГОСТа

Примечание к таблице:

1. В таблице приняты следующие обозначения:
   • ЭП — эскизный проект;
   • ТП — технический проект;
   • РД — рабочая документация;
   • ОР — общесистемные решения;
   • ОО — решения по организационному обеспечению;
   • ТО — решения по техническому обеспечению;
   • ИО — решения по информационному обеспечению;
   • ПО — решения по программному обеспечению;
   • МО — решения по математическому обеспечению.
2. Знак Х — обозначает принадлежность к проектно-сметной или эксплуатационной документации.
3. Номенклатуру документов одного наименования устанавливают в зависимости от принятых при создании системы проектных решений.

Когда перечень документов определён, то в РД 50-34.698-90 следует найти выбранные документы и разработать их строго по указанным пунктам. Все пункты содержания, которые указаны, обязательно должны быть в документе.
Если разрабатывается Техническое задание, то сразу нужно открыть ГОСТ 34.602-89 и разработать ТЗ строго согласно пунктам.

ГОСТ 19

Серия ГОСТов 19 (ГОСТ 19.ххх Единая система программной документации (ЕСПД)) состоит:

1. 1. ГОСТ 19.001-77 Общие положения - слишком общий документ, практической пользы он не несёт. Поэтому его можно пропустить.
   2. ГОСТ 19781-90 Термины и определения - хороший список определений в области программного обеспечения систем обработки информации. Кроме как определений больше не содержит ничего.
   3. ГОСТ 19.101-77 Виды программ и программных документов - один из главных документов 19 ГОСТа. Именно с него следует начинать работу с 19 ГОСТом, так как в нём содержится полный перечень и обозначения документов ГОСТа.

Перечень документов 19 ГОСТа

Условные обозначения:
— документ обязательный;
— документ обязательный для компонентов, имеющих самостоятельное применение;
— необходимость составления документа определяется на этапе разработки и утверждения технического задания;
- — документ не составляют.

1. ГОСТ 19.102-77 Стадии разработки - содержит описание стадий разработки. Полезен в образовательных целях. На мой взгляд, особой практической пользы не несёт.
2. ГОСТ 19.103-77 Обозначения программ и программных документов - содержит описание присвоения номера (кода) документу. Даже после прочтения этого ГОСТа остаётся куча вопросов о том, как же присвоить этот самый номер документу.
3. ГОСТ 19.104-78 Основные надписи - устанавливает формы, размеры, расположение и порядок заполнения основных надписей листа утверждения и титульного листа в программных документах, предусмотренных стандартами ЕСПД, независимо от способов их выполнения. Так как документы 19 ГОСТа оформляются в рамочках, то данный документ очень важен.
4. ГОСТ 19.105-78 Общие требования к программным документам - устанавливает общие требования к оформлению программных документов. Требования слишком общие. Как правило для разработки документа этот ГОСТ почти не применяется, так как хватает специального ГОСТа на документ, но для общих знаний в данный ГОСТ все же лучше заглянуть разок.
5. ГОСТ 19.106-78 Требования к программным документам, выполненным печатным способом - содержит требования к оформлению всех документов 19 ГОСТа.
6. ГОСТ 19.201-78 Техническое задание, требования к содержанию и оформлению - устанавливает порядок построения и оформления технического задания на разработку программы или программного изделия.

   Пункты ТЗ 34 ГОСТа и 19 ГОСТа отличаются.

7. ГОСТ 19.601-78 Общие правила дублирования, учёта и хранения - общие правила дублирования, обращения, учёта и хранения программных документов. В ГОСТе в нескольких пунктах описано как сделать так, чтобы документы не потерялись.
8. ГОСТ 19.602-78 Правила дублирования, учёта и хранения программных документов, выполн-х печ. Способом - дополнение к ГОСТу 19.601-78.
9. ГОСТ 19.603-78 Общие правила внесения изменений - устанавливает общие правила внесения изменений в программные документы. По сути, описывает длинный бюрократический алгоритм внесения изменений в документы.
10. ГОСТ 19.604-78 Правила внесения изменений в программные документы, выполненных печатным способом - описывает порядок работы и заполнения с Листа регистрации изменений.

Список специализированных ГОСТов, то есть в каждом из них описано содержание и требования к определённому документу:

1. ГОСТ 19.202-78 Спецификация. Требования к содержанию и оформлению;
2. ГОСТ 19.301-79 Программа и методика испытаний. Требования к содержанию и оформлению;
3. ГОСТ 19.401-78 Текст программы. Требования к содержанию и оформлению;
4. ГОСТ 19.402-78 Описание программы;
5. ГОСТ 19.403-79 Ведомость держателей подлинников;
6. ГОСТ 19.404-79 Пояснительная записка. Требования к содержанию и оформлению;
7. ГОСТ 19.501-78 Формуляр. Требования к содержанию и оформлению;
8. ГОСТ 19.502-78 Описание применения. Требования к содержанию и оформлению;
9. ГОСТ 19.503-79 Руководство системного программиста. Требования к содержанию и оформлению;
10. ГОСТ 19.504-79 Руководство программиста. Требования к содержанию и оформлению;
11. ГОСТ 19.505-79 Руководство оператора. Требования к содержанию и оформлению;
12. ГОСТ 19.506-79 Описание языка. Требования к содержанию и оформлению;
13. ГОСТ 19.507-79 Ведомость эксплуатационных документов;
14. ГОСТ 19.508-79 Руководство по техническому обслуживанию. Требования к содержанию и оформлению.

Порядок работы с 19 ГОСТом:

1. В ГОСТе 19.101-77 выбрать документ и его код согласно стадии разработки.
2. Согласно ГОСТу 19.103-77 присвоить номер документу.
3. Затем по ГОСТам 19.104-78 и 19.106-78 оформить документ.
4. Из специализированного списка ГОСТов следует выбрать тот, который соответствует разрабатываемому документу.

Заключение

ГОСТ - это не страшно и несложно! Главное понять, что нужно написать и какой для этого ГОСТ используется. Наши основные ГОСТы 19 и 34 для написания документации очень старые, но и по сей день актуальны. Написание документации по стандарту снимает множество вопросов между исполнителем и заказчиком. Следовательно, несёт в себе экономию времени и денег.

ГОСТ 34.601-90 Информационная технология. Комплекс стандартов на автоматизированные системы. Автоматизированные системы. Стадии создания.

Г О С У Д А Р С Т В Е Н Н Ы Й С Т А Н Д А Р Т С О Ю З А С С Р

Дата введения
с 01.01.1992г.

Настоящий стандарт распространяется на автоматизированные системы (АС), используемые в различных видах деятельности (исследование, проектирование, управление и т.п.), включая их сочетания, создаваемые в организациях, объединениях и на предприятиях (далее - организациях).

Стандарт устанавливает стадии и этапы создания АС. В приложении 1 приведено содержание работ на каждом этапе.

1. ОБЩИЕ ПОЛОЖЕНИЯ

1.1. Процесс создания АС представляет собой совокупность упорядоченных во времени, взаимосвязанных, объединённых в стадии и этапы работ, выполнение которых необходимо и достаточно для создания АС, соответствующей заданным требованиям.

1.2. Стадии и этапы создания АС выделяются как части процесса создания по соображениям рационального планирования и организации работ, заканчивающихся заданным результатом.

1.3. Работы по развитию АС осуществляют по стадиям и этапам, применяемым для создания АС.

1.4. Состав и правила выполнения работ на установленных настоящим стандартом стадиях и этапах определяют в соответствующей документации организаций, участвующих в создании конкретных видов АС.

Перечень организаций, участвующих в работах по созданию АС, приведён в приложении 2.

2. СТАДИИ И ЭТАПЫ СОЗДАНИЯ АС

2.1. Стадии и этапы создания АС в общем случае приведены в таблице.

2.2. Стадии этапы, выполняемые организациями - участниками работ по созданию АС, устанавливаются в договорах и техническом задании на основе настоящего стандарта.

Допускается исключить стадию "Эскизный проект" и отдельные этапы работ на всех стадиях, объединять стадии "Технический проект" и "Рабочая документация" в одну стадию "Технорабочий проект". В зависимости от специфики создаваемых АС и условий их создания допускается выполнять отдельные этапы работ до завершения предшествующих стадий, параллельное во времени выполнение этапов работ, включение новых этапов работ.

ПРИЛОЖЕНИЕ 1
(справочное)

1. На этапе 1.1. "Обследование объекта и обоснование необходимости создания в АС" общем случае проводят:

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

2. На этапе 1.2. "Формирование требований пользователя к АС" проводят:

• а) подготовку исходных данных для формирования требований АС (характеристика объекта автоматизации, описание требований к системе, ограничения допустимых затрат на разработку, ввод в действие и эксплуатацию, эффект, ожидаемый от системы, условия создания и функционирования системы);
• б) формулировку и оформление требований пользователя к АС.

3. На этапе 1.3. "Оформление отчёта о выполненной работе и заявки на разработку АС (технико-технического задания)" проводят оформление отчета о выполненных работах на данной стадии и оформление заявки на разработку АС (тактико-технического задания) или другого заменяющего её документа с аналогичным содержанием.

4. На этапах 2.1. "Изучение объекта" и 2.2. "Проведение научно-исследовательских работ" организация-разработчик проводит детальное изучение объекта автоматизации и необходимые научно-исследовательские работы (НИР), связанные с поиском путей и оценкой возможности реализации требований пользователя, оформляют и утверждают отчёты о НИР.

5. На этапе 2.3. "Разработка вариантов концепции АС и выбор варианта концепции АС, удовлетворяющего требованиям пользователя" в общем случае, проводят разработку альтернативных вариантов концепции создаваемой АС и планов их реализации; оценку необходимых ресурсов на их реализацию и обеспечение функционирования; оценку преимуществ и недостатков каждого варианта; определение порядка оценки качества и условий приёмки системы; оценку эффектов, получаемых от системы.

6. На этапе 2.4. "Оформление отчёта о выполненной работе" подготавливают и оформляют отчет, содержащий описание выполненных работ на стадии описания и обоснования предлагаемого варианта концепции системы.

7. На этапе 3.1. "Разработка и утверждение технического задания на создание АС" проводят разработку, оформление, согласование и утверждение технического задания на АС и, при необходимости, технических заданий на части АС.

8. На этапе 4.1. "Разработка предварительных проектных решений по системе и её частям" определяются: функции АС; функции подсистем, их цели и эффекты; состав комплексов задач и отдельных задач; концепция информационной базы, её укрупнённая структура; функции системы управления базой данных; состав вычислительной системы; функции и параметры основных программных средств.

9. На этапе 5.1. "Разработка проектных решений по системе и её частям" обеспечивает разработку общих решений по системе и её частям, функционально-алгоритмической структуре системы, по функциям персонала и организационной структуре, по структуре технических средств, по алгоритмам решения задач и применяемым языкам, по организации и ведению информационной базы, системе классификации и кодирования информации, по программному обеспечению.

10. На этапах 4.2. и 5.2. "Разработка документации на АС и её части" проводят разработку, оформление, согласование и утверждение документации в объёме, необходимом для описания полной совокупности принятых проектных решений и достаточном для дальнейшего выполнения работ по созданию АС. Виды документов - по ГОСТ 34.201-89 .

11. На этапе 5.3. "Разработка и оформление документации на поставку изделий для комплектования АС и (или) технических требований (технических заданий) на их разработку" проводят: подготовку и оформление документации на поставку изделий для комплектования АС; определение технических требований и составление ТЗ на разработку изделий, не изготовляемых серийно.

12. На этапе 5.4 "Разработка заданий на проектирование в смежных частях проекта объекта автоматизации" осуществляют разработку, оформление, согласование и утверждение заданий на проектирование в смежных частях проекта объекта автоматизации для проведения строительных, электротехнических, санитарно-технических и других подготовительных работ, связанных с созданием АС.

13. На этапе 6.1 "Разработка рабочей документации на систему и её части" осуществляют разработку рабочей документации, содержащей все необходимые и достаточные сведения для обеспечения выполнения работ по вводу АС в действие и её эксплуатации, а также для поддержания уровня эксплуатационных характеристик (качества) системы в соответствии с принятыми проектными решениями, её оформление, согласование и утверждение. Виды документов по ГОСТ 34.201-89 .

14. На этапе 6.2 "Разработка или адаптация программ" проводят разработку программ и программных средств системы, выбор, адаптацию и (или) привязку приобретаемых программных средств, разработку программной документации в соответствии с ГОСТ 19.101 .

15. На этапе 7.1 "Подготовка объекта автоматизации к вводу АС в действие" проводят работы по организационной подготовке объекта автоматизации к вводу АС в действие, в том числе:

• реализацию проектных решений по организационной структуре АС;
• обеспечение подразделений объекта управления инструктивно-методическими материалами;
• внедрение классификаторов информации.

16. На этапе 7.2 "Подготовка персонала" проводят обучение персонала и проверку его способности обеспечить функционирование АС.

17. На этапе 7.3 "Комплектация АС поставляемыми изделиями (программными и техническими средствами, программно-техническими комплексами, информационными изделиями)" обеспечивают получение комплектующих изделий серийного и единичного производства, материалов и монтажных изделий, проводят входной контроль их качества.

18. На этапе 7.4 "Строительно-монтажные работы" проводят:

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

19. На этапе 7.5 "Пусконаладочные работы" проводят:

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

20. На этапе 7.6 "Проведение предварительных испытаний" осуществляют:

• а) испытания АС на работоспособность и соответствие техническому заданию в соответствии с программой и методикой предварительных испытаний;
• б) устранение неисправностей и внесение изменений в документацию на АС, в том числе эксплуатационную в соответствии с протоколом испытаний;
• в) оформление акта о приёмке АС в опытную эксплуатацию.

21. На этапе 7.7 "Проведение опытной эксплуатации" проводят:

• опытную эксплуатацию АС;
• анализ результатов опытной эксплуатации АС;
• доработку (при необходимости) программного обеспечения АС;
• дополнительную наладку (при необходимости) технических средств АС;
• оформление акта о завершении опытной эксплуатации.

22. На этапе 7.8 "Проведение приёмочных испытаний" проводят:

• а) испытания на соответствие техническому заданию в соответствии с программой и методикой приёмочных испытаний;
• б) анализ результатов испытания АС и устранение недостатков, выявленных при испытаниях;
• в) оформление акта о приёмке АС в постоянную эксплуатацию.

23. На этапе 8.1 "Выполнение работ в соответствии с гарантийными обязательствами" осуществляются работы по устранению недостатков, выявленных при эксплуатации АС в течении установленных гарантийных сроков, внесению необходимых изменений в документацию по АС.

24. На этапе 8.2 "Послегарантийное обслуживание" осуществляют работы по:

• а) анализу функционирования системы;
• б) выявлению отклонений фактических эксплуатационных характеристик АС от проектных значений;
• в) установлению причин этих отклонений;
• г) устранению выявленных недостатков и обеспечению стабильности эксплуатационных характеристик АС;
• д) внесению необходимых изменений в документацию на АС.

ПРИЛОЖЕНИЕ 2
(справочное)

ПЕРЕЧЕНЬ ОРГАНИЗАЦИЙ, УЧАСТВУЮЩИХ В РАБОТАХ ПО СОЗДАНИЮ АС.

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

2. Организация-разработчик, которая осуществляет работы по созданию АС, представляет заказчику совокупность научно-технических услуг на разных стадиях и этапах создания, а также разрабатывает и поставляет различные программные и технические средства АС.

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

4. Организация-генпроектировщик объекта автоматизации.

5. Организации-проектировщики различных частей проекта объекта автоматизации для проведения строительных, электротехнических, санитарно-технических и других подготовительных работ, связанных с созданием АС.

6. Организации строительные, монтажные, наладочные и другие.

Примечания:

• а) в зависимости от условий создания АС возможны различные совмещения функций заказчика, разработчика, поставщика и других организаций, участвующих в работах по созданию АС;
• б) стадии и этапы выполняемых ими работ по созданию АС определяются на основании настоящего стандарта.