Череповец
Указания к выполнению курсового проекта (работы): Учеб.-метод. пособие. Череповец: ЧГУ, 2004. ___ с.
Рассмотрено на заседании кафедры программного обеспечения ЭВМ 11 апреля 2003 г., протокол № 8.
Одобрено редакционно-издательской комиссией Института математики, физики и информатики ЧГУ __________ г., протокол № __.
Рецензенты: А.Н. Зуев – канд. техн. наук, доцент (ЧГУ); Е.В. Королева – канд. техн. наук, инженер (ЦНСА ОАО «Северсталь»)
Составители: Е.В. Ершов – канд. техн. наук, доцент;
Л.Н. Виноградова – ст. преподаватель.
© Череповецкий государственный
университет, 2004
ВВЕДЕНИЕ
Данное учебно-методическое пособие содержит описание и порядок выполнения курсового проекта (работы) по дисциплинам кафедры ПО ЭВМ и предназначено для формирования у студентов навыков разработки программного обеспечения (ПО) и оформления курсового проекта (работы).
В пособии рассматриваются следующие разделы: составление технического задания и руководства пользователя, основные правила оформления расчетно-пояснительной записки и программной документации.
Составление программной документации - очень важный процесс. На каждое ПО разрабатывается документация двух типов: для пользователей различных групп и для разработчиков.
Раздел 1
Техническое задание
Техническое задание - документ, в котором сформулированы основные цели разработки, требования к ПО, сроки и этапы разработки, а также регламентирован процесс приемно-сдаточных испытаний.
Согласно ГОСТ 19.201-78 «Техническое задание. Требования к содержанию и оформлению» техническое задание содержит следующие разделы:
· титульный лист (см. Приложение 1);
· введение;
· основания для разработки;
· назначение разработки;
· требования к программе;
· требования к программной документации;
· технико-экономические показатели;
· стадии и этапы разработки;
· порядок контроля и приемки.
Введение включает наименование и краткую характеристику области применения программы, а также объекта, в котором предполагается их использовать.
В разделе Основания для разработки содержится наименование документа, на основании которого ведется разработка, организации, утвердившей данный документ, дата его утверждения, а также наименование темы разработки.
В разделе Н азначение разработки содержится описание функционального и эксплуатационного назначения программы.
В разделе Требования к программе содержатся следующие подразделы:
- требования к функциональным характеристикам (перечисляются выполняемые функции, описываются состав, характеристики и формы представления исходных данных и результатов, а также указываются критерии эффективности: максимально допустимое время ответа системы, максимальный объем используемой оперативной и внешней памяти и др);
- требования к надежности (указываются требования к обеспечению надежного функционирования, время восстановления после сбоя, контроль входной и выходной информации, создание резервных копий промежуточных результатов);
- условия эксплуатации (температура окружающей среды, относительная влажность воздуха для выбранных типов носителей данных, вид обслуживания, необходимое количество и квалификация персонала);
- требования к составу и параметрам технических средств (тип микропроцессора, объем памяти, наличие внешних устройств и т.п.);
- требования к информационной и программной совместимости (определяется язык и среда программирования, используемая операционная система и другие системные и пользовательские программные средства, с которыми взаимодействует разрабатываемое программное обеспечение, а также степень защиты информации);
- требования к маркировке и упаковке (указываются требования к маркировке ПО, варианты и способы упаковки);
- требования к транспортированию и хранению (условия транспортирования ПО, место хранения, условия и сроки хранения, условия складирования);
- специальные требования.
В разделе Требования к программной документации указывается наличие руководства программиста, руководства пользователя, руководства системного программиста, расчетно-пояснительной записки и т.п.
Раздел Т ехнико-экономические показатели содержит ориентировочную экономическую эффективность, предполагаемую годовую потребность и экономические преимущества разработки по сравнению с существующими отечественными и зарубежными аналогами.
Раздел Стадии и этапы разработки содержит стадии разработки, этапы и содержание работ, а также сроки разработки и исполнители.
Раздел Порядок контроля и приемки содержит виды испытаний и общие требования к приемке работ.
В случае, если какие-либо требования, предусмотренные техническим заданием, к ПО не предъявляются, в соответствующем месте необходимо указать «Требования не предъявляются».
В зависимости от особенностей разрабатываемого ПО разрешается уточнение содержания разделов (использование подразделов, ввод новых разделов, объединение их).
Раздел 2
расчетно-пояснительнАЯ запискА
Для оформления пояснительной записки необходимо внимательно изучить ГОСТ 7.32-91 (ИСО 5966-82) «Отчет по научно-исследовательской работе. Структура и правила оформления». В соответствии с этим стандартом пояснительная записка включает в себя:
· титульный лист (см. Приложение 2);
· аннотацию;
· оглавление;
· введение;
· основную часть;
· заключение;
· список литературы;
· приложения.
Титульный лист оформляют в соответствии с ГОСТ 19.104—78 «Единая система программной документации. Основные надписи».
На второй странице располагается аннотация на разрабатываемое ПО. Аннотация в сжатом виде содержит сведения о количестве листов документа, иллюстраций, таблиц, приложений, а также цели работы, перечень основных терминов и особенности разработки программного продукта.
На третьей странице располагается оглавление, включающее в себя: введение, наименование всех разделов, подразделов, пунктов, заключение, список литературы, перечень приложений с указанием номеров страниц.
На четвертой странице и далее следуют введение и основная часть.
Основная часть содержит следующие разделы:
· общие сведения;
· функциональное назначение;
· описание логической структуры;
· используемые технические средства;
· вызов и загрузка;
· входные данные;
· выходные данные.
В зависимости от особенностей программы допускается вводить дополнительные разделы или объединять отдельные разделы.
В разделе «Общие сведения» указываются обозначение и наименование программы, а также программное обеспечение, необходимое для функционирования программы и язык программирования, на котором написана программа.
В разделе «Функциональное назначение» указываются классы решаемых задач и (или) назначение программы и сведения о функциональных ограничениях на применение.
В разделе «Описание логической структуры» указываются: алгоритм программы, используемые методы, структура программы с описанием функций составных частей и связи между ними, связи программы с другими программами. Описание логической структуры программы выполняют с учетом текста программы на исходном языке.
В разделе «Используемые технические средства» указываются типы электронно-вычислительных машин и устройств, которые используются при работе программы.
В разделе «Вызов и загрузка» указывается способ вызова программы с соответствующего носителя данных, а также входные точки в программу. Можно указывать адреса загрузки, сведения об использовании оперативной памяти, объем программы.
В разделе «Входные данные» указываются характер, организация и предварительная подготовка входных данных, а также формат, описание и способ кодирования входных данных.
В разделе «Выходные данные» указываются характер и организация выходных данных, а также формат, описание и способ кодирования выходных данных.
Допускается содержание разделов иллюстрировать пояснительными примерами, таблицами, схемами, графиками.
После заключения, в котором в краткой форме излагаются выводы о проделанной работе, результатах исследования в данной проблемной области, следуют список литературы и приложения, где содержится материал, не вошедший в пояснительную записку, но представляющий определенный интерес для более глубокого понимания материала (например, техническое задание - ГОСТ 19.201-78, схемы алгоритмов и программ – ГОСТ 19.002-80, программа и методика испытаний - ГОСТ 19.301-79, текст программы – ГОСТ 19.401-78, руководство пользователя).
В приложении 3 приведен пример оглавления расчетно-пояснительной записки к курсовому проекту по дисциплине «Технология разработки программного обеспечения».
Раздел 3
Руководство пользователя
Составление документации для пользователей имеет свои особенности, так как пользователь, как правило, не является профессионалом в области разработки программного обеспечения. Поэтому руководство должно содержать подробные инструкции, необходимые пользователю на доступном языке, без узко специальной терминологии. Необходимые термины, используемые в руководстве, объясняются.
Руководство пользователя содержит следующие разделы:
· общие сведения о программе;
· описание установки;
· описание запуска;
· инструкции по работе (или описание пользовательского интерфейса);
· сообщения пользователю.
В разделе Общие сведения о программе содержится наименование программы, краткое описание ее функций, реализованных методов и областей применения.
В разделе Описание у становки содержится подробное описание действий по установке программы и сообщений, которые при этом могут быть получены.
В разделе Описание з апуска описываются действия по запуску программы и сообщения, которые при этом могут быть получены.
В раздел Инструкции по работе содержится описание режимов работы, возможных настроек, форматов ввода-вывода информации.
В разделе Сообщения пользователю содержится перечень возможных сообщений, описание их содержания и действий, которые необходимо предпринять по этим сообщениям.
В зависимости от вида ПО может возникнуть необходимость создания отдельного руководства системного программиста и (или) оператора.
Согласно ГОСТ 19.503-79 «Руководство системного программиста. Требования к содержанию и оформлению» руководство системного программиста содержит всю информацию, необходимую для установки программного обеспечения, его настройки и проверки работоспособности.
Руководство системного программиста содержит следующие разделы:
· общие сведения о ПО,
· структура;
· настройка;
· проверка;
· дополнительные возможности;
· сообщения системному программисту.
Согласно ГОСТ 19.505-79 «Руководство оператора. Требования к содержанию и оформлению» руководство оператора содержит следующие разделы:
· назначение программы;
· условия выполнения программы;
· выполнение программы;
· сообщения оператору.
Раздел 4
Основные правила оформления
программной документации
При оформлении текстовых и графических материалов, входящих в курсовой проект (работу) следует придерживаться действующих стандартов (ГОСТ 19.ХХХ).
Оформление текстового материала
Текстовые документы оформляются на белых листах формата А4, графический материал допускается представлять на листах формата A3. В соответствии с общими требованиями поля листа определяются следующим образом: левое — 30, правое - 10, верхнее – не менее 15, а нижнее - не менее 20 мм.
Нумерация всех страниц (в том числе и приложений) - сквозная. Номер проставляется либо сверху справа, либо снизу справа арабской цифрой. Первая страница - титульный лист. Номер страницы на титульном листе не проставляется.
Наименование разделов пишется прописными буквами посередине строки. Расстояние между заголовками и текстом, а также между заголовками разделов и подразделов должно быть равно:
· при выполнении документа машинописным способом — двум интервалам;
· при выполнении рукописным способом — 10 мм.
Наименования подразделов и пунктов размещаются с абзацного отступа и печатаются вразрядку с прописной буквы, без подчеркивания и без точки в конце. Расстояние между последней строкой текста предыдущего раздела и последующим заголовком при расположении их на одной странице должно быть равно:
· при выполнении документа машинописным способом - трем интервалам;
· при выполнении рукописным способом — не менее 15 мм.
Разделы и подразделы нумеруются арабскими цифрами с точкой. Разделы имеют порядковые номера 1, 2, и т. д. Номер подраздела состоит из номера раздела и порядкового номера подраздела, входящего в данный раздел, разделенных точкой. Например: 1.1, 2.5. При использовании ссылок на пункты, разделы и подразделы указывается порядковый номер раздела или пункта, например: «в разд. 2», «в п. 2.3».
Текст разделов печатается через 1,5 интервала при высоте букв не менее 2 мм (шрифты № 12-13).
При работе в текстовом редакторе перечисления нумеруются арабскими цифрами со скобкой (например: 2), 3) и т. д.) с абзацного отступа, используя для этого нумерованные списки. Допускается также применение маркированных списков.
