Документы по программному обеспечению.
Одной из обязательных составляющих рабочей документации АСУ является документация по программному обеспечению. Разработчик программных средств должен руководствоваться в своей работе большим количеством ГОСТов. Состав документов ПО приведен в Руководящем документе "РД 50-34.698-90. Автоматизированные системы. Требования к содержанию документов. Раздел 6. Требования к содержанию документов с решениями по программному обеспечению", серии ГОСТов ЕСПД и других.
Документация ПО предназначена:
1)Для описания проектных решений ПО в документе "Описание программного обеспечения", в котором приводятся:
- вводная часть:
- основные сведения о техническом, информационном и других видах обеспечения АСУ необходимых для разработки АСУ.
- раздел "Структура ПО":
- перечень частей ПО, с указанием их взаимосвязей и обоснований выделения каждой из них.
- раздел "Основные функции частей ПО":
- назначение и описание основных функций ПО;
- состав проектных документов, подлежащих разработке.
- раздел "Методы и средства разработки ПО":
- перечень методов программирования и средств разработки ПО АСУ с указанием частей ПО, где следует использовать соответствующие методы и средства.
- раздел "Операционная система":
- наименование, обозначение, краткая характеристика ОС, обоснование выбора и указание источника описания ОС;
- указание руководства, в соответствии с которым должна проводиться генерация выбранного варианта ОС;
- требования к варианту генерации ОС.
- раздел "Средства, расширяющие возможности ОС":
- наименование, обозначение и краткая характеристика средств, расширяющих возможности ОС, необходимость использования дополнительных средств и способы реализации этих средств, их настройка и конкретное применение.
2)Для установления требований к программе или комплексу программ в документе "Техническое задание" (ГОСТ 19.201-78).
3)Для описания решений, обеспечивающих сопровождение, изготовление и эксплуатацию программ в документах:
- "Пояснительная записка" (ГОСТ 19.404-79);
- "Общее описание" (ГОСТ 19.502-78);
- "Описание программы" (ГОСТ 19.402-78);
- "Спецификация" (ГОСТ 19.202-78);
- "Руководство программиста" (ГОСТ 19.504-79);
- "Руководство оператора" (ГОСТ 19.505-79);
- "Текст программы" (ГОСТ 19.401-78);
- "Формуляр" (ГОСТ 19.501-78);
- "Порядок и методика испытаний" (ГОСТ 19.301-78).
4)Для проверки работоспособности программных средств в документе "Описание контрольного примера (КП)":
- назначение: перечень параметров и краткая характеристика функций, проверяемых контрольным примером;
- исходные данные: описание исходных данных для проверки программы с приведением исходных данных;
- результаты расчета: результаты обработки исходных данных программой, позволяющие оценить правильность выполнения проверяемых функций и значение проверяемых параметров;
- проверка программы, в том числе:
- описание состава технических средств, необходимых для проверки работы программы;
- описание процедур формирования исходных данных для проверки программы, вызова проверяемой функции и получения результатов расчета;
- описание действий оператора при подготовке исходных данных при проверке программ на КП.
При разработке и внедрении программных средств особое внимание необходимо обращать на их качество.
Под качеством программного средства понимается совокупность свойств программного средства, которые обуславливают его пригодность удовлетворять заданные или подразумеваемые потребности в соответствии с назначением.
Качество ПС характеризуется следующими группами показателей:
- надежности;
- сопровождения;
- удобства применения;
- эффективности;
- универсальности;
- корректности.
Более подробно качество ПС рассмотрено в ГОСТах:
ГОСТ 28806-90. Качество программных средств. Термины и определения. Введен с 1.01.92.
ГОСТ 28195-89. Оценка качества программных средств. Общие положения.