Качество ПО Учебник

4.5 Стандарты документирования программных средств 171

определяющими все аспекты документирования программ

иданных;

•официальным руководством по принятой стратегии документирования конкретного проекта ПС;

•планами документирования как органической частью всего ЖЦ конкретного ПС;

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

иданных;

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

ирекомендуемыми процедурами автоматизированного документирования ПС, его компонентов и процессов.

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

По своему назначению и ориентации на определенные задачи

игруппы пользователей документацию ПС можно разделить:

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

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

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

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

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

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

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

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

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

4.5 Стандарты документирования программных средств 173

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

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

Основу отечественной нормативной базы в области документирования ПС составляет комплекс стандартов Единой системы программной документации (ЕСПД). Основная и большая часть комплекса ЕСПД была разработана в 70-е и 80-е годы. Стандарты ЕСПД в основном охватывают ту часть документации, которая создается в процессе разработки ПС, и связаны, по большей части, с документированием функциональных характеристик ПС.

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

Номенклатуру программных документов определяет ГОСТ 19.101-77 «ЕСПД. Виды программ и программных документов». В качестве основных видов программ стандартом определяются:

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

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

Виды программных документов и их краткое содержание представлены в стандарте описаниями, приведенными в табл. 4.5.

Таблица 4.5 – Виды программных документов

Перечень эксплуатационных документов, рекомендуемых ЕСПД, представлен в табл. 4.6.

4.5 Стандарты документирования программных средств 175

Таблица 4.6 – Виды эксплуатационных документов

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

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

ГОСТ 19.701-90 «Единая система программной документации. Схемы алгоритмов, программ, данных и систем. Обозначения условные и правила выполнения». Стандарт распространяется на условные обозначения (символы) в схемах алгоритмов, программ, данных и систем и устанавливает правила выполнения схем, используемых для отображения различных видов задач обработки данных и средств их решения.

В РФ действует ряд стандартов в части документирования ПС, разработанных на основе прямого применения международных стандартов ИСО.

ГОСТ Р ИСО/МЭК 9294-93 «Информационная технология. Руководство по управлению документированием программного обеспечения». Стандарт устанавливает рекомендации по эффективному управлению документированием ПС для руководителей, отвечающих за их создание. Целью стандарта является оказание помощи в определении стратегии документирования ПС; выборе стандартов по документированию; выборе процедур документирования; определении необходимых ресурсов; составлении планов документирования.

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

4.6 Профили стандартов жизненного цикла ПС

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

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

Основными целями применения профилей стандартов при создании и применении ПС являются:

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

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

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

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

•обеспечение переносимости программ и данных между

разными аппаратно-программными платформами.

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

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

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

статусы утверждения:

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

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

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

ВЖЦ ПС можно выделить две группы профилей ПС:

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

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

Для эффективного применения конкретного профиля необходимо:

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

!азо%ы' ()ан+а,)ы а+мини(),а)и%но/о 01,а%л'ния

4)ан+а,)ы, ,'/лам'н)и,0ющи' 1,о='((ы жизн'нно/о =икла 1,о/,аммны9 (,'+()%

4)ан+а,)ы, ,'/лам'н)и,0ющи' кач'()%о 1,о/,аммны9 (,'+()%

:0ко%о+()%а 1о %ы1олн'нию э)а1о% жизн'нно/о =икла 1,о/,аммны9 (,'+()%

:а>очи' ин(),0к=ии и(1олни)'лям э)а1о% жизн'нно/о =икла 1,о/,аммны9 (,'+()%

:а>очи' ин(),0к=ии (1'=иали()ам (и()'мы кач'()%а 1,о/,аммны9 (,'+()%

Рис. 4.6 – Базовый профиль жизненного цикла ПС

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

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

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

Уровень и полнота профилей, процессов и объектов их применения отражается не только на технико-экономических показателях

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Контрольные вопросы по главе 4

.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1)Какой нормативный документ определяет участников работ по стандартизации, правила разработки стандартов и их взаимосвязь с техническими регламентами?

2)Какие положения устанавливают основополагающие стандарты?

3)Какой статус в настоящее время имеют стандарты?

4)Какая модель жизненного цикла ПС характерна для периода 1970 — 1985 гг.?

5)В чем состоит отличие спиральной модели ЖЦ ПС от каскадной?

6)Какие способы получения информации о ПС приведены

встандарте ГОСТ 28195-89?

7)Какой стандарт необходимо применить для оценки качества ПС, если необходимо оценить уровень автоматизации ПС?

8)Дайте определение фактора «надежность ПС» и перечислите его критерии качества согласно ГОСТ 28195-89.

9)Что такое качество документации ПС?

10)Что такое профиль стандартов?