Технічна документація, що забезпечує процес виконання робіт

Організація управління змістом робіт орієнтована на використання головним чином каскадної моделі життєвого циклу проекту. Стадії і етапи роботи описані в стандарті ГОСТ 34.601-90.

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

Стадії і етапи створення проекту, що виконуються організаціями-учасниками, прописуються в договорах і технічних завданнях на виконання робіт:

Стадія 1. Формування вимог до змісту робіт за проектом.

На початковій стадії проектування виділяють наступні етапи робіт:

· обстеження об'єкту і обгрунтування необхідності створення проекту;

· формування вимог користувачів до проекту;

· оформлення звіту про виконану роботу і тактико-технічного завдання на розробку.

Стадія 2. Розробка концепції змісту робіт за проектом.

· проведення необхідних науково-дослідних робіт;

· розробка варіантів концепції проекту, що задовольняють вимогам користувачів;

· оформлення звіту і затвердження концепції.

· розробка і затвердження технічного завдання на створення проекту.

· розробка попередніх проектних рішень по системі і її частинам;

· розробка ескізної документації на проект і її частини.

· розробка проектних рішень по системі і її частинам;

· розробка документації на проект і її частини;

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

· розробка завдань на проектування в суміжних частинах проекту.

· розробка робочої документації на проект і її частини;

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

· виконання робіт відповідно до гарантійних зобов'язань;

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

· обгрунтування розробки і поетапного впровадження систем;

· складання технічного завдання на розробку систем;

· розробки технічного і робочого проектів систем.

На етапі обстеження доцільно виділити дві складові: визначення стратегії впровадження проекту і детальний аналіз діяльності організації.

Основне завдання першого етапу обстеження - оцінка реального об'єму проекту, його цілей і завдань на основі виявлених функцій і інформаційних елементів об'єкту, що автоматизується, високого рівня. Ці завдання можуть бути реалізовані або замовником робіт за проектом самостійно, або із залученням консалтингових організацій. Етап припускає тісна взаємодія з основними потенційними користувачами системи і бізнес-експертами. Основне завдання взаємодії - отримати повне і однозначне розуміння вимог замовника. Як правило, потрібна інформація може бути отримана в результаті інтерв'ю, бесід або семінарів з керівництвом, експертами і користувачами.

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

Результатом етапу визначення стратегії є документ (техніко-економічне обґрунтування проекту), де чітко сформульовано, що отримає замовник, якщо погодиться фінансувати проект, коли він отримає готовий продукт (графік виконання робіт) і скільки це коштуватиме (для крупних проектів повинен бути складений графік фінансування на різних етапах робіт). У документі бажано відобразити не тільки витрати, але і вигоду проекту, наприклад час окупності проекту, очікуваний економічний ефект (якщо його вдається оцінити).

· обмеження, ризики, критичні чинники, які можуть вплинути на успішність проекту;

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

· терміни завершення окремих етапів, форма приймання/здачі робіт, ресурси, що привертаються, заходи по захисту інформації;

· інтерфейси і розподіл функцій між людиною і системою;

· вимоги до програмних і інформаційних компонентів ПО, вимоги до СУБД;

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

· інструктивно-методичні і директивні матеріали, на підставі яких визначаються склад підсистем і перелік завдань;

· можливості застосування нових методів вирішення завдань.

Аналітики збирають і фіксують інформацію в двох взаємозв'язаних формах:

· функції - інформація про події і процеси, які відбуваються в бізнесі;

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

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

· найменування завдання; терміни і періодичність її рішення;

· джерела інформації, необхідні для вирішення завдання;

· алгоритми розрахунку показників, що діють, і можливі методи контролю;

· засоби збору, передачі і обробки інформації, що діють;

· форми представлення початкових даних і результатів їх обробки, що діють, у вигляді документів;

· споживачі результатної інформації по завданню.

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

· взаємозв'язок документів при їх формуванні;

· місце використання і зберігання даного документа;

· внутрішні і зовнішні інформаційні зв'язки;

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

На етапі обстеження слід класифікувати плановані функції системи по ступеню важливості. Один з можливих форматів представлення такої класифікації - MuSCoW.

Ця абревіатура розшифровується так: Must have - необхідні функції; Should have - бажані функції; Could have - можливі функції; Won't have - відсутні функції.

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

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

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

Моделі діяльності організації створюються в двох видах:

· модель "як є" - відображає бізнес-процеси, що існують в організації;

· модель "як повинно бути" ("to-be") - відбиває необхідні зміни бізнес-процесів з урахуванням впровадження ІС.

На етапі аналізу необхідно привертати до роботи групи тестування для вирішення наступних завдань:

· отримання порівняльних характеристик передбачуваних до використання апаратних платформ, операційних систем, СУБД, іншого оточення;

· розробки плану робіт по забезпеченню надійності інформаційної системи і її тестування.

Залучення тестувальників на ранніх етапах розробки є доцільним для будь-яких

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

Для автоматизації тестування слід використовувати системи відстежування помилок (bug tracking). Це дозволяє мати єдине сховище помилок, відстежувати їх повторну появу, контролювати швидкість і ефективність виправлення помилок, бачити найбільш нестабільні компоненти системи, а також підтримувати зв'язок між групою розробників і групою тестування (повідомлення про зміни по e-mai l і тому подібне). Чим більше проект, тим сильніше потреба в bug tracking.

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

Технічне завдання - це документ, що визначає цілі, вимоги і основні початкові дані, необхідні для розробки автоматизованої системи управління.

При розробці технічного завдання необхідно вирішити наступні завдання:

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

· розробити і обґрунтувати вимоги, що пред'являються до підсистем;

· розробити і обґрунтувати вимоги, що пред'являються до інформаційної бази, математичного і програмного забезпечення, комплексу технічних засобів (включаючи засоби зв'язку і передачі даних);

· встановити загальні вимоги до проектованої системи;

· визначити перелік завдань створення системи і виконавців;

· визначити етапи створення системи і терміни їх виконання;

· провести попередній розрахунок витрат на створення системи і визначити рівень економічної ефективності її впровадження.

Типові вимоги до складу і змісту технічного завдання приведені в таблице 1.

Таблиця 1. Склад і зміст технічного завдання (ГОСТ 34.602- 89)

п\п	Розділ	Зміст

	Загальні відомості	· повне найменування системи і її умовне позначення · шифр теми або шифр (номер) договору; · найменування підприємств розробника і замовника системи, їх реквізити · перелік документів, на підставі яких створюється ІС · планові терміни почала і закінчення робіт · відомості про джерела і порядок фінансування робіт порядок оформлення і пред'явлення замовникові результатів робіт із створення системи, її частин і окремих засобів
	Призначення і цілі створення (розвитку) системи	· вид діяльності, що автоматизується · перелік об'єктів, на яких передбачається використання системи найменування і необхідні значення технічних, технологічних, виробничо-економічних і ін. показників об'єкту, які повинні бути досягнуті при впровадженні проекту
	Характеристика об'єктів проектування	· короткі відомості про об'єкт проектування · зведення про умови експлуатації і характеристики навколишнього середовища
	Вимоги до виробничої системи в цілому	вимоги до структури і функціонування системи (перелік підсистем, рівні ієрархії, ступінь централізації, способи інформаційного обміну, режими функціонування, взаємодія з суміжними системами, перспективи розвитку системи)
		· вимоги до персоналу (чисельність користувачів, кваліфікація, режим роботи, порядок підготовки) · показники призначення (ступінь пристосовності системи до змін процесів управління і значень параметрів) · вимоги до надійності, безпеки, ергономіки, транспортабельності, експлуатації, технічного обслуговування і ремонту, захисту і збереження інформації, захисту від зовнішніх дій, до патентної чистоти, по стандартизації і уніфікації Вимоги до функцій (по підсистемах): · перелік тих, що підлягають автоматизації завдань · часовий регламент реалізації кожної функції · вимоги до якості реалізації кожної функції, до форми представлення вихідної інформації, характеристики точності, достовірності видачі результатів · перелік і критерії відмов Вимоги до видів забезпечення: · математичному (склад і область застосування мат. моделей і методів, типових алгоритмів, що розробляються) · інформаційному (склад, структура і організація даних, обмін даними між компонентами системи, інформаційна сумісність з суміжними системами, використовувані класифікатори, СУБД, контроль даних і ведення інформаційних масивів, процедури додання юридичної сили вихідним документам) · лінгвістичному (мови програмування, мови взаємодії користувачів з системою, системи кодування, мови ввода- виводу) · програмному (незалежність програмних засобів від платформи, якість програмних засобів і способи його контролю, використання фондів алгоритмів і програм) · технічному · метрологічному · організаційному (структура і функції експлуатуючих підрозділів, захист від помилкових дій персоналу) методичному (склад нормативно-технічної документації)
	Склад і зміст робіт із створення системи	· перелік стадій і етапів робіт · терміни виконання · склад організацій — виконавців робіт · вигляд і порядок експертизи технічної документації · програма забезпечення надійності програма метрологічного забезпечення
	Порядок контролю і приймання системи	· види, склад, об'єм і методи випробувань системи · загальні вимоги до приймання робіт по стадіях статус приймальної комісії
	Вимоги до складу і змісту робіт з підготовки об'єкту автоматизації до введення системи в дію	· перетворення вхідної інформації до машиночитаємому вигляду · зміни в об'єкті автоматизації терміни і порядок комплектування і навчання персоналу
	Вимоги до документування	· перелік тих дій, що підлягають розробці документів перелік документів на машинних носіях
	Джерела розробки	документи і інформаційні матеріали, на підставі яких розробляється ТЗ і система

Ескізний проект передбачає розробку попередніх проектних рішень по системі і її частинам.

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

Зміст ескізного проекту задається в ТЗ на систему. Як правило, на етапі ескізного проектування визначаються:

· функції підсистем, їх цілі і очікуваний ефект від впровадження;

· склад комплексів завдань і окремих завдань;

· концепція інформаційної бази і її укрупнена структура;

· функції і параметри основних програмних засобів.

За наслідками виконаної роботи оформляється, узгоджується і затверджується документація в об'ємі, необхідному для опису повної сукупності ухвалених проектних рішень і достатньому для подальшого виконання робіт із створення системи.

На основі технічного завдання (і ескізного проекту) розробляється технічний проект виробничої системи. Технічний проект системи - це технічна документація, що містить загальносистемні проектні рішення, алгоритми вирішення завдань, а також оцінку економічної ефективності автоматизованої системи управління і перелік заходів щодо підготовки об'єкту до впровадження.

На цьому етапі здійснюється комплекс науково-дослідних і експериментальних робіт для вибору основних проектних рішень і розрахунок економічної ефективності системи.

Склад і зміст технічного проекту приведені в таблице 2.

п/п	Розділ	Зміст

	Записка пояснення	· підстави для розробки системи · перелік організацій розробників · коротка характеристика об'єкту з вказівкою основних техніко-економічних показників його функціонування і зв'язків з іншими об'єктами · короткі відомості про основні проектні рішення по функціональній і забезпечуючим частинам системи
	Функціональна і організаційна структура системи	· обґрунтування підсистем, що виділяються, їх перелік і призначення · перелік завдань, що вирішуються в кожній підсистемі, з короткою характеристикою їх змісту · схема інформаційних зв'язків між підсистемами і між завданнями в рамках кожної підсистеми
	Постановка завдань і алгоритми рішення	· організаційно-економічна суть завдання (найменування, мета рішення, короткий зміст, метод, періодичність і час рішення задачі, способи збору і передачі даних, зв'язок завдання з іншими завданнями, характер використання результатів рішення, в яких вони використовуються) · економіко-математична модель завдання (структурна і розгорнена форма уявлення) · вхідна оперативна інформація (характеристика показників, діапазон зміни, форми уявлення) · нормативно-довідкова інформація (НДІ) (зміст і форми уявлення) · інформація, що зберігається для зв'язку з іншими завданнями · інформація, що накопичується для подальших рішень даної задачі · інформація по внесенню змін (система внесення змін і перелік інформації, що піддається змінам) · алгоритм рішення задачі (послідовність етапів розрахунку, схема, розрахункові формули) · контрольний приклад (набір заповнених даними форм вхідних документів, умовні документи з накопичуваною інформацією, що зберігається, форми вихідних документів, заповнені за наслідками рішення економіко-технічної задачі і відповідно до розробленого алгоритму розрахунку)

	Організація інформаційної бази	· джерела надходження інформації і способи її передачі · сукупність показників, використовуваних в системі · склад документів, терміни і періодичність їх надходження · основні проектні рішення по організації фонду НДІ · склад НДІ, включаючи перелік реквізитів, їх визначення, діапазон зміни і перелік документів НДІ · перелік масивів НДІ, їх об'єм, порядок і частота коректування інформації · структура фонду НДІ з описом зв'язку між його елементами; вимоги до технології створення і ведення фонду · методи зберігання, пошуку, внесення змін і контролю · визначення об'ємів і потоків інформації НДІ · контрольний приклад по внесенню змін в НДІ пропозиції по уніфікації документації
	Альбом форм документів
	Система матеріального забезпечення	· обґрунтування структури матеріального забезпечення · обґрунтування вибору системи логістики
	Принцип побудови комплексу технічних засобів	· опис і обґрунтування схеми технологічного процесу · обґрунтування і вибір структури комплексу технічних засобів і його функціональних груп · обґрунтування вимог до розробки нестандартного устаткування · комплекс заходів щодо забезпечення надійності функціонування технічних засобів
	Розрахунок економічної ефективності проекту	· звідний кошторис витрат, пов'язаних з експлуатацією виробничої системи · розрахунок річної економічної ефективності, джерелами якої є оптимізація виробничої структури господарства (об'єднання), зниження собівартості продукції за рахунок раціонального використання виробничих ресурсів і зменшення втрат, поліпшення схвалюваних управлінських рішень
	Заходи щодо підготовки об'єкту до впровадження проекту	· перелік організаційних заходів щодо вдосконалення бізнес-процесів · перелік робіт по впровадженню проекту, які необхідно виконати на стадії робочого проектування, з вказівкою термінів і відповідальних осіб
	Відомість документів

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

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

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

Залежно від взаємозв'язків частин об'єкту і об'єкту автоматизації випробування можуть бути автономні або комплексні. Автономні випробування охоплюють частини системи. Їх проводять у міру готовності частин системи до здачі в дослідну експлуатацію. Комплексні випробування проводять для груп взаємозв'язаних частин або для системи в цілому.

Для планування проведення всіх видів випробувань розробляється документ "Програма і методика випробувань". Розробник документа встановлюється в договорі або ТЗ. Як додаток в документ можуть включатися тести або контрольні приклади.

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

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

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