2.3 Вимоги до змісту та оформлення розділу «Керівництво програміста»

Згідно ГОСТ 19.504-79 «Руководство программиста. Требования к содержанию и оформлению» розділ повинен містити наступні підрозділи:

– призначення і умови застосування програм;

– характеристика програми;

– звернення до програми;

– вхідні і вихідні дані.

2.3.1 Зміст підрозділів

У підрозділі «Призначення і умови застосування програм» повинні бути вказані призначення і функції, виконувані програмою, умови, необхідні для виконання програми (об'єм оперативної пам'яті, вимоги до складу і параметрів периферійних пристроїв, вимоги до програмного забезпеченню і т.п.).

У підрозділі «Характеристика програми» повинно бути приведено опис основних характеристик і особливостей програми (тимчасові характеристики, режим роботи, засоби контролю правильності виконання і т.п.).

У підрозділі «Звернення до програми» повинне бути приведене опис процедур виклику програми (способи передачі управління і параметрів даних і ін.).

У підрозділі «Вхідні і вихідні дані» повинно бути приведено опис організації використовуваної вхідної і вихідної інформації і, при необхідності, її кодування.

2.4 Вимоги до змісту та оформлення розділу «Керівництво користувача (оператора)»

Згідно ГОСТ 19.505-79 «Руководство оператора. Требования к содержанию и оформлению» розділ повинен містити наступні підрозділи:

– призначення програми;

– умови виконання програми;

– виконання програми;

– повідомлення оператору.

2.3.1 Зміст підрозділів

У підрозділі «Призначення програми» повинні бути вказані відомості про призначення програми і інформація, достатня для розуміння функцій програми і її експлуатації.

У підрозділі «Умови виконання програми» повинні бути вказані умови, необхідні для виконання програми (мінімальний і (або) максимальний склад апаратурних і програмних засобів і т.п.).

У підрозділі «Виконання програми» повинна бути вказана послідовність дій оператора, забезпечуючи завантаження, запуск, виконання і завершення програми, приведений опис функцій, формату і можливих варіантів команд, за допомогою яких оператор здійснює завантаження і управляє виконанням програми, а також відповіді програми на ці команди.

У підрозділі «Повідомлення оператору» повинні бути приведені тексти повідомлень, видаваних в ході виконання програми, опис їх змісту і відповідні дії оператора (дії оператора у разі збою, можливості повторного запуску програми і т.п.).

Допускається зміст підрозділів ілюструвати пояснюючими прикладами, таблицями, схемами, графіками.

2.5 Вимоги до змісту та оформлення розділу «Текст програми»

Згідно ГОСТ 19.401-78 «Текст программы. Требования к содержанию и оформлению» розділ повинен містити символічний запис на вихідній мові.

У символічний запис розділу рекомендується включати коментарі, які можуть відображати, наприклад, функціональне призначення, структуру

3 Приклад виконання розділів курсових робіт і звітів з практик

3.1 Приклад виконання технічного завдання

Технічне завдання

1 Введення

Найменування – тестова система контролю знань для студентів Машинобудівного коледжу Донбаської державної машинобудівної академії.

Коротка характеристика: ІС призначена для отримання оцінки знань студентами Машинобудівного коледжу Донбасівської державної машинобудівної академії.

Область застосування ІС – використовування її як повнофункціонального програмного комплексу для контролю знань студентами Машинобудівного коледжу Донбасівської державної машинобудівної академії.

2 Підстава для розробки

Розробка даного проекту ведеться на підставі завдання на проходження навчальної практики з дисципліни «Технологія програмування та створення програмних продуктів» (назва дисципліни відповідає назві дисципліни в рамках якої ведеться навчальна практика)

Дана ІС реалізується в рамках навчальної практики по темі «Тестова система контролю знань для студентів Машинобудівного коледжу Донбасівської державної машинобудівної академії».

3 Призначення розробки

Метою проекту – розробка комп’ютеризованої системи тестування для контролю одержаних знань, умінь і навиків студентами.

Вкажемо функціональне і експлуатаційне призначення комплексної системи, що розробляється:

1 Функціональне призначення: аналіз одержаних знань, умінь і навиків студентами Машинобудівного коледжу Донбасівської державної машинобудівної академії.

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

4 Вимоги до програмного виробу

При реалізації і використовуванні статистики по тестуванню знань студентів повинні бути враховані вимоги до функціональних характеристик, надійності проекту, умов експлуатації, складу і параметрів технічних засобів, апаратної і програмної сумісності.

4.1 Вимоги до функціональних характеристик

ІС повинна надавати наступні можливості:

– об'єктивність оцінки, оскільки в тестовому контролі вплив суб'єктивних чинників (наприклад, таких, як обізнаність екзаменатора про поточну успішність іспитується, облік його поведінки на учбових заняттях і т.п.) виключений;

– достовірність інформації про об'єм засвоєного матеріалу і про рівень його засвоєння;

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

– надійність – тестова оцінка однозначна і відтворна;

– диференціацію навчання – оскільки в тестах міститися завдання різного рівня;

– реалізацію індивідуального підходу в навчанні – можлива індивідуальна перевірка і самоперевірка знань навчаються;

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

ІС повинна надавати наступні можливості викладачу і адміністратору:

– надавати статистичні дані студента;

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

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

4.2 Вимоги до надійності

Система повинна виконувати наступні вимоги до надійності:

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

– обробляти помилкові дії користувача і повідомляти його про це;

– виключати аварійні ситуації, які прямо або побічно можуть привести до псування апаратної, програмної або інформаційної складової оточення користувача.

4.3 Умови експлуатації

Умови експлуатації повинні відповідати санітарним і технічним нормам експлуатації ЕОМ. Для обслуговування системи допускаються тільки спеціально навчені адміністратори, викладачі або розробники.

Умови експлуатації наступні:

– температура навколишнього повітря +5 – +30 ^0С;

– відносна вогкість для вибраних типів носіїв даних, не перевищуюча норму (45 – 60%);

– наявність кваліфікованого персоналу.

4.4 Вимоги до складу і параметрів технічних засобів

Мінімальні вимоги до програмних і апаратних засобів для нормального функціонування програмного продукту представлені в таблиці 1

Таблиця 1 – Вимоги до програмних і апаратних засобів

Найменування	Характеристика
Процесор	Intel Pentium III 600 і вище
Оперативний пристрій, що запам'ятовує	128Mb і більше
Операційна система	Windows 2000/NT/XP/2003
Монітор	SVGA дозвіл 1024х768
Місткість жорсткого диска	вільне місце не менше 1 Gb
Клавіатура	Genius KB–06 PS/2 –– роз'їм PS/2; 104 кл. + 3 енергосберег.; кабель 1.3м
Маніпулятор «Миша»	Genius Net Scroll+ PS/2 oem –– роз'їм PS/2; 2 кнопки + скролінг–кнопка; кабель 1.4м
Мережева карта	Швидкість не менше 10 Mb/s

4.5 Вимоги до інформаційної і програмної сумісності

Засіб реалізації – Delphi, тому що Delphi — одна з наймогутніших систем, що дозволяють на найсучаснішому рівні створювати як окремі прикладні програми Windows, так і розгалужені комплекси, призначені для роботи в корпоративних мережах і в Інтернет.

5 Вимоги до програмної документації

Попередній склад програмної документації встановлений відповідно до ДСТУ 3008–95 та Єдиній системі програмної документації. Нижче перерахований список програмних документів і їх зміст:

– структурна схема системи;

– текст програми – запис програми з необхідними поясненнями і коментарями;

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

– програма і методика випробувань – вимоги, що підлягають перевірці при випробуванні програми, також порядок і методи контролю;

– технічне завдання – цей документ;

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

– експлуатаційні документи – інструкції адміністратору, менеджеру і перевізнику.

6 Стадії і етапи розробки

Розробка програмного продукту проходить декілька стадій і етапів, які представлені в таблиці 2.

Таблиця 2 – Стадії і етапи розробки ПП

Стадії розробки	Етапи робіт	Зміст робіт
1	2	3
Технічне завдання 01.10.08.– 17.10.08.	Обґрунтування необхідності розробки програми	Коротка характеристика програмного забезпечення по організації тестування; підстава і призначення розробки; вимоги до програмного комплексу і документація; стадії і етапи розробки програми; порядок
	Науково-дослідні роботи

Закінчення таблиці 2

1	2	3
	Розробка і затвердження технічного завдання	контролю і приймання
Ескізний проект 20.10.08.– 31.10.08.	Розробка ескізного проекту	Попередня розробка структури вхідних і вихідних даних; уточнення середовища програмування; розробка і опис загальної алгоритмічної структури розробленої програми
	Затвердження ескізного проекту
Технічний проект 03.11.08.–14.11.08.	Розробка технічного проекту	Уточнення структури вхідних і вихідних даних, визначення форми їх уявлення; розробка докладного алгоритму; розробка структури програми; остаточне визначення конфігурації технічних засобів; розробка заходів щодо упровадження програмного комплексу
	Затвердження технічного проекту
Робочий проект 17.11.08.–24.11.08.	Розробка програми	Реалізація програмного комплексу по тестуванню знань студентів; відладка; розробка методики випробувань; проведення попередніх випробувань (тестування); коректування програмного забезпечення; розробка документації
	Розробка програмної документації
	Випробування програми
Впровадження 25.11.08.–01.12.08.	Підготовка і передача програми.	Підготовка і передача програмного комплексу; навчання персоналу використовуванню програмного комплексу; внесення коректувань в програмне забезпечення і документацію

7 Порядок контролю і приймання

Контроль здійснюється кінцевими користувачами системи, підключеними на етапі тестування системи.

Прийом комплексу здійснюється після його повної установки і настройки під конкретних користувачів і короткого курсу по навчанню користувачів.

Після закінчення розробки системи повинні бути проведені наступні види випробувань: тестування на захист від некоректного введення; тестування на повноту обміну інформацією між різними додатками.