56. Рабочая документация.

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

Значительную часть рабочей документации составляет так называе­мая программная документация, описывающая структуру, организацию и функционирование созданного программного продукта. Номенклатура и содержание программных документов определяется стандартами Еди­ной системы программной документации (ГОСТ 19.ххх), большая часть которых давно морально устарела и может рассматриваться только в ис-торико-справочном контексте.

Пользователями рабочей документации являются:

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

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

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

В составе рабочей документации можно выделить:

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

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

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

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

Состав и содержание рабочих документов регламентируются такими нормативными материалами, как уже упоминавшиеся методические ука­зания РД 50-34.698-90, а также стандартами Единой системы программ­ной документации ГОСТ 19.101 и Единой системы конструкторской до­кументации ГОСТ 2.601.