24. Основные программные и эксплуатационные документы

Программная и эксплуатационная документация может использо­ваться для изготовления и сопровождения программного изделия, для его тестирования (испытания), для его эксплуатации.

ЕСПД предусматривает создание следующих основные документов в процессе разработки:

Текст программ — запись программы с необходимыми коммента­риями.

Описание программы — сведения о логической структуре и функ­ционировании программы.

Программа и методика испытании — требования, подлежащие проверке при испытании программы, а также порядок и методы их кон­троля.

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

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

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

Эксплуатационные документы:

Руководство пользователя — сведения о назначении программы, области применения, применяемых методах, ограничениях при приме­нении, конфигурации технических средств; сведения для обеспечения процедуры общения пользователя с вычислительной системой в про­цессе выполнения программы. Создается на основе документов «Опи­сание применения» и «Руководство оператора», описанных в ЕСПД.

Руководство системного администратора — сведения для обес­печения установки, функционирования и настройки программ на усло­вия конкретного применения. Создается на основе документа «Руково­дство системного программиста», описанного в ЕСПД.

Программная и эксплуатационная документация должна:

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

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

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

• 25. Общее и детальное планирование испытаний

Общее планирование испытаний

Главная цель при решении этой задачи — установить, какие кон­кретно работы будут проводиться в ходе испытаний, и составить их ка­лендарный план. План создается разработчиками совместно с заказчи­ками (пользователями) и затем утверждается руководством. Общий план испытаний должен включать следующие разделы:

1. Описание общей стратегии тестирования системы.

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

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

Детальное планирование испытаний

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

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

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

В заголовочной части бланка указывается название продукта и об­щая характеристика испытания. Разделы «Дата испытания» и «Состав комиссии» заполняются во время проведения испытаний.

Для каждого типа входных данных просматривается их «путь» в системе и записываются все условия (допустимые и недопустимые), ре­акция на которые подлежит проверке.

Графа «Фактический результат» также заполняется во время про­ведения испытаний.

Контрольные бланки составляют основной объём раздела «Методы испытаний» документа «Программа и методика испытаний».