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

Специфікація є основним програмним документом для компонентів, що використовуються самостійно, та для комплексів. Для компонентів, які не мають специфікації, основним програмним документом є "Текст програми".

Форма специфікації наведена в додатку 8.

Специфікація в загальному випадку повинна містити такі розділи:

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

• комплекси;

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

Найменування кожного розділу вказують у вигляді заголовку в графі "Найменування". Для документів, виконаних друкованим способом, заголовок підкреслюють.

У розділ "Документація" вносять програмні документи на дану програму, крім специфікації і технічного завдання, в порядку зростання коду виду документу, що входить у позначення. Далі записують запозичені програмні документи. Їхній запис проводиться в порядку зростання кодів організацій (підприємств) – розробників і далі в порядку зростання коду виду документу, що входить у позначення.

Після кожного розділу специфікації необхідно залишити кілька вільних рядків

Графи специфікації заповнюються наступним чином.

У графі “Позначення” вказують:

• в розділі “Документація” – позначення документів програми, що записуються;

• в розділі “Комплекси” – позначення специфікацій комплексів, що входять до даного комплексу;

• в розділі “Компоненти” – позначення основних програмних документів компонентів.

В графі “Найменування” вказують:

• в розділі “Документація” – найменування і вид документа (для документів на дану програму), повне найменування програми, найменування і вид документа (для запозичених документів);

• в розділах “Комплекси” і “Компоненти” – повне найменування програми, найменування і вид документу;

У графі “Примітки” подаються додаткові відомості, що стосуються записаних у специфікації програм.

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

В графі “Позначення” запис виконується в один рядок. В інших графах специфікації записи допускаються у кілька рядків.

8. Програмні документи

1. Пояснювальна записка

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

• вступ;

• аналітична частина;

• проектна частина;

• висновок

Вступ має містити назву програми або задачі, що вирішується у ході виконання дипломної роботи. Також вказується документ, який є підставою для виконання дипломної роботи.

В аналітичній частині висвітлюються наступні питання:

• призначення та область застосування об’єкта проектування;

• огляд способів і засобів вирішення поставлених задач;

• аналіз переваг і недоліків існуючих методів;

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

• аналіз апаратних і програмних засобів.

В проектну частину включають такі розділи:

• загальні відомості про алгоритм;

• вибір алгоритму;

• функціональний аналіз алгоритму;

• опис логічної структури;

• опис і обґрунтування метода організації вхідних і вихідних даних;

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

• вибір мови програмування;

• застосовані методи оптимізації програмного продукту;

• надійність програми

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

У висновку подаються одержані наукові результати і техніко-економічні показники і робиться загальний висновок про вирішення задачі, поставленої в завданні на виконання дипломної роботи.

У кінці пояснювальної записки подається список джерел, використаних при розробці.

У додатках до пояснювальної записки наводяться таблиці, методики, обґрунтування, розрахунки та інші документи, використані при виконанні дипломної роботи.