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. Требования к содержанию
Составление информационной части (аннотации и содержания) является необязательным.
Документ «Программа и методика испытаний» должен содержать следующие разделы:
объект испытаний;
цель испытаний;
требования к программе;
требования к программной документации;
средства и порядок испытаний;
методы испытаний.
В зависимости от особенностей документа допускается вводить дополнительные разделы.
В разделе «Объект испытаний» указывают наименование, область применения и обозначение испытуемой программы.
В разделе «Цель испытаний» указывают цель проведения испытаний.
В разделе «Требования к программе» указывают требования, подлежащие проверке во время испытаний и заданные в ТЗ на программу, к которым относятся:
требования устойчивости функционирования ПС при наличии ошибок во входных данных, а именно:
контроль корректности входных данных;
контроль принадлежности входных данных диапазону допустимых значений;
контроль форматов входных данных;
выдача диагностических сообщений пользователю при обнаружении ошибок во входных данных и предпринимаемые действия при обработке ошибок;
требования возможности обработки ошибочных ситуаций;
требования полноты обработки ошибочных ситуаций;
требования к программе по восстановлению процесса выполнения в случае сбоя операционной системы, процессора, периферийных устройств, а именно:
ведение системного журнала регистрации всех операций над данными;
наличие средств получения копий выбранных частей данных, БД для последующего их восстановления;
наличие средств восстановления для возврата БД или некоторых ее частей в первоначальное состояние;
наличие средств, которые, используя системный журнал, устраняют в БД выполненные транзакции (единичная операция);
наличие средств контроля, выявляющих нарушения и позволяющих отменять эффект выполнения предыдущей команды или нескольких предыдущих команд;
наличие контрольных точек и средств, которые позволяют вернуться в последнюю контрольную точку вместо возвращения к началу транзакции;
динамическое исключение неисправного устройства ввода–вывода из набора ресурсов ПС;
требования к программе по восстановлению результатов при отказах процессора, операционной системы, которые включают в себя:
восстановление вычислительного процесса и данных;
восстановление данных, скопированных за некоторое время до момента сбоя;
возможность повторного запуска ПС с последней контрольной точки;
требования к тестированию программ;
требования реализации диагностики всех граничных и аварийных ситуаций, которые создаются в процессе испытаний путем подбора входных данных;
требования к динамическому тестированию программ;
требования к статическому тестированию программ.
В разделе «Требования к программной документации» указывают состав программной документации, предъявляемой на испытания, и требования полноты и понятности изложения в документации информации:
о назначении ПС;
о принципах функционирования ПС;
о взаимосвязи ПС с другими подсистемами;
о входных и выходных данных;
о действиях, относящихся к освоению работы с ПС (настройка, запуск, выполнение);
о графическом представлении блок–схем, алгоритмов;
о принятых соглашениях об использовании комментариев, символических имен переменных;
о диагностических сообщениях, выдаваемых пользователю в ходе настройки, проверки и выполнения ПС;
о наличии всех необходимых рисунков, формул, таблиц, которые должны содержать ту информацию, которая заложена в ссылке на нее.
В разделе «Средства и порядок испытаний» приводят:
описание программной среды функционирования ПС, включающее в себя требования к:
операционным системам и средствам их расширения;
средствам управления базами данных;
прочим ПС, используемым программой в процессе функционирования;
описание программно–аппаратурной среды функционирования ПС, включающее в себя требования к:
объему внутренней и внешней памяти, необходимому для функционирования ПС;
периферийным устройствам;
базовому программному обеспечению;
другим техническим и программным средствам, используемым во время испытаний, а также порядку проведения испытаний;
процедуры проверки соответствия программно–аппаратной среды функционирования предъявленным требованиям и порядок их выполнения;
порядок выполнения процедур проверки корректности:
функционирования программы на соответствие предъявленным требованиям;
реализации всех основных функций;
реализации всех частных функций.
В разделе «Методы испытаний» приводят описания используемых методов испытаний, в частности, описания тестов и способов проверок с указанием ожидаемых результатов испытаний (перечней тестовых примеров, контрольных распечаток тестовых примеров и т.п.).