Главная

Категории:

ДомЗдоровьеЗоологияИнформатикаИскусствоИскусствоКомпьютерыКулинарияМаркетингМатематикаМедицинаМенеджментОбразованиеПедагогикаПитомцыПрограммированиеПроизводствоПромышленностьПсихологияРазноеРелигияСоциологияСпортСтатистикаТранспортФизикаФилософияФинансыХимияХоббиЭкологияЭкономикаЭлектроника






Обозначения и основные надписи программных документов


4.2.1. Обозначение программ и программных документов состоит из групп знаков (прописных букв и цифр), разделяемых точками, пробелами и дефисами.

Обозначение программы и ее программного документа - спецификации имеет следующую структуру:

АА.ББZZ.XXXXX‑YY,

где АА – буквенный код категории разработки (ДП – дипломный проект, КП – курсовой проект, КР – курсовая работа и т.д.);

ББZZ – номер учебной группы разработчика (содержит одну-две буквы кода специальности и одну-три цифры номера учебной группы);

XXXXX – регистрационный номер разработки (пятизначный цифровой, соответствует номеру зачетной книжки студента-разработчика);

YY – порядковый номер программы, созданной студентом-разработ­чиком за время обучения в институте (в порядке возрастания с 01 до 99, присваивается студентом самостоятельно).

Обозначение других программных документов включает обозначение программы в качестве общей части, а также переменную часть и имеет следующую структуру:

АА.ББZZ.XXXXX‑YY VV WW,

где VV – отделяемый пробелом от общей части двузначный цифровой код вида документа (см. п.4.1, объединенным документам присваивается код одного из составляющих документов);

WW – отделяемый пробелом от кода вида документа двузначный цифровой код, определяющий структуру программы (00…09 ‑ головные программные комплексы или самостоятельные программные компоненты, 10…19 – программные комплексы или компоненты первого уровня вложенности, 20…99 – программные компоненты последующих уровней вложенности).

4.2.2. Основные надписи в программном документе располагаются на титульном листе, а также на последующих листах документа. Форма титульного и последующих листов программного документа приведена в приложениях 1, 2.

Заполняемые поля 1…7 основной надписи, располагаемой на титульном листе программного документа, включают следующую информацию:

(1) - наименование министерства (только для основного программного документа), организации (института) и подразделения (кафедры), где выполнено проектирование;

(2) - полное наименование программного изделия (программы) – прописными буквами;

(3) - наименование (вид) программного документа, наименование документа «Пояснительная записка …» включает указание на вид разработки (дипломный / курсовой, проект / работа, дисциплина по учебному плану);

(4) - обозначение программного документа;

(5) - объем документа в листах, включая титульный лист – первый лист документа;

(6) - должности, подписи с датами подписания, инициалы и фамилии: руководителя подразделения (кафедры), руководителя (консультанта) разработки (проекта), исполнителя (разработчика), нормоконтролера;

(7) - год разработки документа (без указания слова «год» или «г.»).

На последующих листах программного документа заполняют поля 8,9,10:

(8) - обозначение программного документа (аналогично полю 4);

(9) - порядковый номер листа (страницы) документа;

(10) - текст документа.

Границы формата листов (минимальные значения): левая – 20, правая – 10, верхняя и нижняя – по 15 мм. Ограничивающую рамку допускается не наносить, за исключением основного программного документа – пояснительной записки в дипломных проектах.

4.3. Общие требования к структуре программных документов

4.3.1. Программный документ состоит из следующих условных частей: титульной (титульный лист), информационной (аннотация и содержание) и основной.

Титульный лист разрабатывается на каждый программный документ, за исключением технического задания на курсовое (дипломное) проектирование. Допускается также не разрабатывать титульный лист на спецификацию, а также на схему алгоритма (программы, данных, системы), если они располагаются на одном-двух листах ‑ в этом случае основная надпись выполняется по форме и правилам, предусмотренным ЕСКД.

В аннотации приводят сведения о назначении документа и краткое изложение его основной части, объем аннотации – не более 10 строк текста (для пояснительной записки – не более 20 строк). Содержание включает перечень записей о структурных элементах (разделы, подразделы, для текста программы – модули) основной части документа. Информационная часть не разрабатывается для технического задания, спецификации и схем алгоритмов (данных, программ, системы). Допускается также не разрабатывать информационную часть для программных документов, оформленных в виде приложений к пояснительной записке. Разделы АННОТАЦИЯ и СОДЕРЖАНИЕ не нумеруют.

Рекомендуемая структура основной части (состав нумеруемых разделов) программных документов различных видов определена ниже. В зависимости от особенностей программы допускается объединять отдельные разделы и вводить дополнительные, в названиях разделов опускать слово «программа» или заменять его наименованием программы. Степень детализации излагаемой в соответствующих разделах информации зависит от назначения разработки и комплектности разрабатываемых программных документов. Содержание разделов можно иллюстрировать таблицами, схемами, поясняющими примерами, экранными формами, которые размещаются либо в тексте раздела, либо (при большом их объеме) в виде отдельных иллюстрирующих приложений с соответствующими заголовками.

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

4.3.3. Отдельные программные документы учебных проектов выполняются, как правило, в виде приложений к основному документу – пояснительной записке, располагаемых после иллюстрирующих приложений (см. п.4.3.1). На титульном (первом) листе приложения в правом верхнем углу указывается слово ПРИЛОЖЕНИЕ (с порядковым номером, если их несколько), нумерация листов в иллюстрирующих приложениях – сквозная с основным документом, в приложениях – документах – самостоятельная. Все приложения и их наименования (заголовки) перечисляются в информационной части (содержании) пояснительной записки, а в основной ее части должны присутствовать ссылки на каждое из них.

 

Требования к содержанию и оформлению текстовых программных документов

Отдельные виды текстовых программных документов выполняют в соответствии с ГОСТ 19.201-78, 19.202-78, 19.301-78, 19.401-78, 19.402-78, 19.404-78, 19.502-78, 19.503-79, 19.504-79, 19.505-79.

Спецификация

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

Основная часть спецификации содержит текст, разбитый на графы:

– «Обозначение» ‑ для обозначений основных и дополнительных программных документов данного комплекса, а также входящих в него комплексов и компонентов;

– «Наименование» ‑ для наименований разработанных и заимствованных документов на данный комплекс, полных наименований программы и основного документа для входящих комплексов и компонентов;

– «Примечание» ‑ для дополнительных сведений, относящихся к записанным документам и программам.

Ширина граф, соответственно ‑ 80, 70 и 30 мм, высота строк – 7..10 мм.

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

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

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

5.2. Техническое задание

Техническое задание на разработку учебных программных изделий оформляется в виде «Задания на курсовое (дипломное) проектирование» по соответствующим формам и правилам и включается в пояснительную записку листом со вторым порядковым номером.

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

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

Текст программы

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

Для лучшего представления структуры программы запись текста программы рекомендуется (а в случае использования нескольких языков программирования – необходимо) оформлять в виде нескольких разделов с соответствующими наименованиями (заголовками), с отражением этого в содержании документа. Если запись текста программы состоит из одного раздела, то ему также присваивается заголовок, но содержание не составляется.

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

Описание программы

Документ включает следующие разделы основной части, содержащие необходимую информацию:

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

функциональное назначение – классы (виды) решаемых задач, сведения о функциональных ограничениях на применение;

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

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

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

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

Программа и методика испытаний

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

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

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

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

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

методы испытаний – последовательное описание используемых проверок (тестовых примеров) с указанием контрольных результатов.

Пояснительная записка

Составление информационной части является обязательным. Содержание включает: номера и заголовки разделов, подразделов основной части с номерами листов (страниц); номера и наименования приложений (при наличии). Содержание размещают на отдельной (нумерованной) странице (страницах) перед разделом введения и снабжают не нумерованным заголовком СОДЕРЖАНИЕ. Пояснительная записка к дипломному проекту (работе) должна содержать также аннотацию, которую размещают на отдельной (нумерованной) странице перед содержанием и снабжают не нумерованным заголовком АННОТАЦИЯ. В аннотации кратко (не более 20 строк текста) излагают назначение и содержание разработки, указывают объем документа, количество рисунков (иллюстраций), таблиц, использованных источников (литературы), приложений.

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

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

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

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

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

(нумеруемый раздел) – анализ результатов тестирования и испытания программы;

(нумеруемый раздел) – расчет технико-экономических показателей раз­работки, обосновывающий преимущества выбранного технического решения;

выводы; заключение (не нумеруемые разделы);

список использованной литературы (не нумеруемый раздел) – перечень книг, описаний, статей, нормативных документов и других научно-технических материалов, на которые есть ссылки в тексте основных разделов.

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

Описание применения

Документ включает следующие разделы основной части, содержащие необходимую информацию:

назначение программы – назначение, функции и возможности программы, основные характеристики, ограничения области применения;

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

описание задачи – определения решаемых задач, применяемые методы их решения;

входные и выходные данные – структурная организация и форматы представления входных и выходных данных.



Последнее изменение этой страницы: 2016-07-22

headinsider.info. Все права принадлежат авторам данных материалов.