7.7.2. Технологическая документация

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

• регламентировать структуру и состав этапов, работ и сопутствующих им документов ЖЦ ПС;

• обеспечивать их адаптацию к характеристикам объекта проектирования, внешней и операционной среды;

• поддерживать и регламентировать процессы организации и планирования реализации ЖЦ конкретных ПС;

• формализовать выполнение и документирование конкретных работ при проектировании, разработке и сопровождении ПС;

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

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

7.7.3. Эксплуатационная документация

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

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

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

При формировании эксплуатационных документов кроме базовых стандартов ЖЦ могут использоваться ряд ведомственных нормативных документов и руководств предприятий.

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

• планирование использования памяти и производительности вычислительной системы в рабочем режиме применения ПС, оперативное управление и распределение ресурсов информационной системы;

• инсталляция и генерация рабочей версии ПС для пользователя;

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

• управление, корректировка и учет внешней среды при реконфигурации конкретного ПС;

• управление средствами защиты информации и санкционированного доступа пользователей, анализ попыток взлома системы защиты, восстановление информации БД при искажениях;

• сбор статистики о функционировании ПС в составе системы обработки информации.

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

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

Приобретение, поставка, разработка, функционирование и сопровождения ПС в значительной степени зависит от квалификации персонала.

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

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

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

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

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