6.10. Гост 19.202. Спецификация. Требования к содержанию и оформлению

Настоящий стандарт устанавливает форму и порядок составления программного документа «Спецификация», определенного ГОСТ 19.101. Спецификация является основным программным документом для компонентов, применяемых самостоятельно, и для комплексов. Для компонентов, не имеющих спецификации, основным программным документом является «Текст программы».

Информационную часть (аннотацию и содержание) допускается в документ не включать.

Форма спецификации приведена на рис.6.9.

Спецификация в общем случае должна содержать разделы:

• документация;

• комплексы;

• компоненты.

Наименование каждого раздела указывают в виде заголовка в графе «Наименование». Для документов, выполненных печатным способом, заголовок подчеркивают.

Р ис.6.9. Форма спецификации

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

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

Графы спецификаций заполняют следующим образом:

• в графе «Обозначение» указывают:

• в разделе «Документация» – обозначение записываемых документов программы;

• в разделе «Комплексы» – обозначение спецификаций комплексов, входящих в данный комплекс;

• в разделе «Компоненты» – обозначения основных программных документов компонентов;

• в графе «Наименование» указывают:

• в разделе «Документация» – наименование и вид документа для документов на данную программу; полное наименование программы, наименование и вид документа для заимствованных документов;

• в разделах «Комплексы» и «Компоненты» – полное наименование программы, наименование и вид документа;

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

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

6.11. Гост 19.301. Программа и методика испытаний. Требования к содержанию, оформлению и контролю качества

Настоящий стандарт устанавливает требования к содержанию и оформлению программного документа «Программа и методика испытаний». Содержит номенклатуру показателей качества ПС, определяемых на основе результатов анализа данного документа, и методические указания по определению количественных значений показателей качества. Применяемость показателей качества и соответствующих им требований при разработке документа и контроле качества осуществляют в зависимости от принадлежности документируемой программы к конкретному подклассу ПС и устанавливают в соответствии с ГОСТ 28195. В п.6.11.2–6.11.5 рассмотрена методика определения количественных значений показателей качества документируемого ПС. Наименования и обозначения показателей качества приведены по ГОСТ 28195.

6.11.1. Требования к содержанию

Составление информационной части (аннотации и содержания) является необязательным.

Документ «Программа и методика испытаний» должен содержать следующие разделы:

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

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

• требования к программе;

• требования к программной документации;

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

• методы испытаний.

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

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

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

В разделе «Требования к программе» указывают требования, подлежащие проверке во время испытаний и заданные в ТЗ на программу, к которым относятся:

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

• контроль корректности входных данных;

• контроль принадлежности входных данных диапазону допустимых значений;

• контроль форматов входных данных;

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

• требования возможности обработки ошибочных ситуаций;

• требования полноты обработки ошибочных ситуаций;

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

• ведение системного журнала регистрации всех операций над данными;

• наличие средств получения копий выбранных частей данных, БД для последующего их восстановления;

• наличие средств восстановления для возврата БД или некоторых ее частей в первоначальное состояние;

• наличие средств, которые, используя системный журнал, устраняют в БД выполненные транзакции (единичная операция);

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

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

• динамическое исключение неисправного устройства ввода–вывода из набора ресурсов ПС;

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

• восстановление вычислительного процесса и данных;

• восстановление данных, скопированных за некоторое время до момента сбоя;

• возможность повторного запуска ПС с последней контрольной точки;

• требования к тестированию программ;

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

• требования к динамическому тестированию программ;

• требования к статическому тестированию программ.

В разделе «Требования к программной документации» указывают состав программной документации, предъявляемой на испытания, и требования полноты и понятности изложения в документации информации:

• о назначении ПС;

• о принципах функционирования ПС;

• о взаимосвязи ПС с другими подсистемами;

• о входных и выходных данных;

• о действиях, относящихся к освоению работы с ПС (настройка, запуск, выполнение);

• о графическом представлении блок–схем, алгоритмов;

• о принятых соглашениях об использовании комментариев, символических имен переменных;

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

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

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

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

• операционным системам и средствам их расширения;

• средствам управления базами данных;

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

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

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

• периферийным устройствам;

• базовому программному обеспечению;

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

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

• порядок выполнения процедур проверки корректности:

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

• реализации всех основных функций;

• реализации всех частных функций.

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