Надежность, эргономика и качество АСОИУ

120

5. ДОКУМЕНТИРОВАНИЕ АСОИУ

5.1.Общие сведения о документации АСОИУ

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

Требования к содержанию документов, разрабатываемых при создании АСОИУ, установлены РД 50-34.698-90 (редакция от 14 февраля 2005 года), а также соответствующими государственными стандартами Единой системы программной документации (ЕСПД), Единой системы конструкторской документации (ЕСКД), Системы проектной документации для строительства (СПДС) и ГОСТ 34.602.

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

Содержание каждого документа, разрабатываемого при проектировании АИС согласно ГОСТ 34.201, определяет разработчик в зависимости от объекта проектирования (системы, подсистема и т. д.).

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

121

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

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

По своему назначению можно выделить следующие типы документации:

проектная и общесистемная документация. Эта докумен-

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

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

Техническую документацию, в свою очередь, можно разде-

лить на пользовательскую и технологическую (внутреннюю)

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

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

122

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

5.2. Проектная и общесистемная документация

5.2.1. Технические предложения

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

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

5.2.2. Техническое задание

Техническое задание (ТЗ) на создание АСОИУ разрабатывает организация-разработчик системы на основании технических требований (заявки заказчика, технических предложений и т. п.) в соответствии с ГОСТ 34.602-89 (см. прил. 1) при непосредственном участии заказчика. Техническое задание является основным документом, в соответствии с которым проводят создание АСОИУ и приемку его заказчиком. Основанием для технического задания, кроме технических предложений, служит технико-экономическое обоснование, в котором должны найти отражение все положения, рассмотренные на этапе концептуального проектирования (полное описание содержания формы данного документа см. ГОСТ 11.091.655-84).

Техническое задание содержит следующие разделы:

характеристика объекта из существующей системы управления;

123

цели, функции, задачи создания автоматизированной системы;

ожидаемые технико-экономические результаты;

выводы и предложения.

«Введение» должно содержать: предполагаемые сроки; периоды, содержащие работы; объемы, порядок финансирования и источники; ссылки на методически нормированные документы.

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

Вразделе «Экономическая эффективность» указывается перечень основных источников экономической эффективности и ожидаемые затраты.

Вразделе «Выводы и предложения» находится сопоставление ожидаемых результатов внедрения автоматизированной системы с заданными целями и критериями ее развития. Выводы о целесообразности создания системы и описание концептуальной модели.

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

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

Замечания по проекту ТЗ должны быть представлены с техническим обоснованием. Решения по замечаниям должны быть приняты разработчиком проекта ТЗ и заказчиком системы до утверждения ТЗ.

Если при согласовании проекта ТЗ возникли разногласия между разработчиком и заказчиком (или другими заинтересованными организациями), то составляется протокол разногласий

124

в произвольной форме и конкретное решение принимается в установленном порядке.

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

Копии утвержденного ТЗ в 10-дневный срок после утверждения высылаются разработчиком ТЗ участникам создания системы. Изменения к ТЗ не допускается утверждать после представления созданной системы или ее очереди на приемосдаточные испытания для принятия ее в опытную или промышленную эксплуатацию.

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

5.2.3. Исходная спецификация на систему

Спецификация (технические требования) — это доку-

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

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

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

125

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

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

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

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

Вописании функций содержится:

обоснование выбора определенных функций;

условия, вызывающие исполнение каждой функции;

последовательность задач, действий или событий;

начальные условия, состояние системы при инициализации функции;

возможности дальнейшего расширения функции;

подробности процедуры верификации.

В спецификации указываются следующие характеристики системы:

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

планируемый показатель качества функционирования, включая точность;

временные характеристики;

другие существующие ограничения и обязательные усло-

вия;

функции обработки ввода/вывода, протокол синхронизации передачи данных;

127

итоговые данные расчета по каждой оцениваемой функции (функциональной подсистеме) АИС и каждому нормируемому показателю надежности;

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

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

5.2.5.Программа и методика испытаний АСОИУ

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

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

В программу испытаний включается перечень проверок:

соответствие системы ТЗ;

комплектность системы;

комплектность и качество документации;

комплектность, достаточность состава программных средств

ипрограммной документации и уровень их качества;

количество и квалификация обслуживающего персонала;

степень выполнения требований функционального назначения системы;

контролепригодность системы;

128

выполнение требований техники безопасности, противопожарной безопасности, промышленной санитарии, эргономики;

функционирование системы с применением программных средств.

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

Программа испытаний содержит разделы:

объект испытаний;

цель испытаний;

общие положения;

объем испытаний;

условия и порядок проведения испытаний;

материально-техническое обеспечение испытаний;

метрологическое обеспечение испытаний;

отчетность.

В разделе «Объект испытаний» указывают:

полное наименование системы, обозначение;

комплектность испытательной системы.

Вразделе «Цель испытаний» указывают конкретные цели и задачи, которые должны быть достигнуты и решены в процессе испытаний.

Вразделе «Общие положения» указывают:

перечень руководящих документов, на основании которых проводят испытания;

место и продолжительность испытаний;

организации, участвующие в испытаниях;

перечень ранее проведенных испытаний;

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

В разделе «Объем испытаний» указывают:

перечень этапов испытаний и проверок, а также количественные и качественные характеристики, подлежащие оценке;

режим испытаний и последовательность их проведения;

требования по испытаниям программных средств;

перечень работ, проводимых после завершения испытаний, требования к ним, объем и порядок проведения.

129

Вразделе «Условия и порядок проведения испытаний» указывают:

условия проведения испытаний;условия начала и завершения отдельных этапов испытаний;

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

проведения испытаний;порядок взаимодействия организаций, участвующих в ис-

пытаниях;порядок привлечения экспертов для исследования воз-

можных повреждений в процессе проведения испытаний;требования к персоналу, проводящему испытания, и поря-

док его допуска к испытаниям.

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

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

Вразделе «Отчетность» указывают перечень отчетных документов, которые должны оформляться в процессе испытаний

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

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