Щетинин Игорь, shchetinin@i-teco.ru Руководитель группы технического документирования 1 Цель • Начальный набор знаний, который позволил бы в дальнейшем самостоятельно разобраться в документах ГОСТ серии 34.
• Практические рекомендации по использованию
положений ГОСТ.
• Описание наиболее типичных ошибок.
2 План 1. Особенности проектов создания АС; 2. «Экологическая ниша» ГОСТ 34.ХХХ в проектах создания современных АС; 3. Стадии и этапы создания АС по ГОСТ; 4. Выпускаемые документы; 5. Работа «по ГОСТ»: практические рекомендации и типичные ошибки;
3 Что есть ГОСТ? 1. Панацея? 2. Смирительная рубашка?
Подход, разработанный на основе
лучшего опыта и доказавший свою применимость в реализации АС разного назначения, в разное время, в разных местах, разными исполнителями и коллективами
«Дорожная разметка» 4 Чего мы ждем от ГОСТ? Возможность обеспечить: • Применимость; • Предсказуемость; • Эффективность; • Рациональность.
Ответов на вопросы: • «С чего начать?» • «Что делать?» • «Кто виноват?»
5 Что дает ГОСТ для проекта? Прямо затрагиваются: • временные параметры (выпуск документации) • качество работ по проекту • вопросы снижения рисков в проекте • коммуникации в проекте • вопросы изменений в проекте • предметная область проекта
Не затрагиваются: • управление персоналом в проекте • управление стоимостью и финансами в проекте • управление поставками и контрактами в проекте 6 АС: «старые добрые времена» Платформа – самодостаточный АПК от одного производителя, несовместимый с продукцией других производителей. За работоспособность системы в целом нес ответственность поставщик платформы. Решение по автоматизации принималось на уровне высшего руководства. Применение АС только для очевидных задач (не требовался прогноз экономической эффективности решения). Финансовая схема – лизинг (снижение доли инвестиционных затрат и упрощение оценки стоимости владения решением). 7 АС: современные проекты Переход от разработки преимущественно к настройке («привязке»). Снизились уровень и согласованность принятия решений о приобретении. Частота принятия таких решений возросла. Переход от «платформы» к ограниченно- совместимым решениям от разных поставщиков ради низкой стоимости «кубиков». Переход от лизинга к приобретению (затраты – инвестиционные, вопрос окупаемости). За поддержание работоспособности отвечает Заказчик (эксплуатационные затраты становятся неочевидными и резко возрастают). 8 ГОСТ серии 34 включает: • Перечень терминов и обозначений (ГОСТ 34.003); • Перечень стадий и этапов (ГОСТ 34.601). • Перечень и последовательность выполняемых работ (ГОСТ 34.601). • Требование к результатам стадий и этапов (ГОСТ 34.601). • Требования к составу (ГОСТ 34.201) и содержанию (РД 50-34.698) выпускаемых документов. • Требования к видам испытаний (ГОСТ 34.603).
Некоторые документы «остались» в ГОСТ 24.
9 ГОСТ: общий замысел • Изучение и формализация ожиданий пользователей (бизнеса) от внедрения АС. • Преобразование ожиданий пользователей (бизнеса) в технические требования к АС. • Проверка полноты соответствия ожиданий пользователей и технических требований к АС, а также меры по снижению рисков реализации. • Реализация АС и проверка ее соответствия техническим требованиям.
10 ГОСТ: стадии создания АС Название стадии Роли Формирование требований к АС М, К, З Разработка концепции АС М, К, З Техническое задание К, Т Эскизный проект К, П Технический проект К, П Рабочая документация П, Т Ввод в действие Т, К Сопровождение АС Т, М, З
Утилизация (не ГОСТ 34)
11 ГОСТ: стадии и этапы Этап – работы, сгруппированные по соображениям рационального планирования и организации работ. Стадия – работы или этапы, сгруппированные по соображениям получения законченного результата.
12 Соотношение стадий Концепция
ТП НЕПРАВИЛЬНО ППС ПС
ТЗ Внедрение
ПРИЕМЛЕМО ПС ППС
13 Формирование требований к АС Этапы:
1. Обследование объекта и обоснование
необходимости создания АС; 2. Формирование требований пользователя к АС; 3. Разработка «Отчета об обследовании» и заявки на разработку АС;
14 Формирование требований к АС Состав работ:
• Сбор данных об объекте и видах деятельности;
• Оценка качества функционирования объекта и видов деятельности; • Выявление проблем, решаемых с помощью автоматизации; • Оценка целесообразности создания АС; • Подготовка ИД для формирования требований; • Документирование требований пользователей; • Разработка отчетных документов – «Отчета об обследовании» и заявки на разработку АС;
15 Формирование требований к АС Содержание «Отчета об обследовании»:
• Характеристика объекта и результатов его
функционирования; • Описание существующей ИС; • Описание недостатков существующей ИС; • Обоснование необходимости совершенствования ИС объекта; • Цели, критерии и ограничения создания АС; • Функции и задачи создаваемой АС; • Выводы и предложения.
16 Разработка концепции АС Этапы:
1. Детальное изучение объекта;
2. Проведение необходимых НИР; 3. Разработка вариантов концепции, удовлетворяющих требованиям пользователя; 4. Оформление отчетных документов.
17 Разработка концепции АС Состав работ: • Детальное изучение объекта. • Проведение необходимых НИР и оформление отчетов по ним. • Разработка вариантов концепции АС, оценка необходимых ресурсов для создания и функционирования, оценка преимуществ и недостатков, определение порядка оценки качества и условий приемки АС, оценка эффекта для каждого варианта. • Выбор и защита наиболее оптимального варианта концепции АС. • Оформление и утверждение «Концепции АС». 18 Разработка концепции АС Содержание документа «Концепция АС»: • Результаты изучения объекта автоматизации; • Преимущества и недостатки альтернативных вариантов концепции создания АС; • Сопоставительный анализ требований пользователя к АС и возможностей вариантов концепции АС; • Обоснование выбора оптимального варианта концепции и описание предлагаемой АС; • Ожидаемые результаты и эффективность реализации выбранного варианта концепции АС; • План реализации выбранного варианта концепции АС; • Необходимые затраты ресурсов на разработку, ввод в действие и обеспечение функционирования; • Требования, гарантирующие качество АС; • Условия приемки системы. 19 Техническое задание Этапы:
1. Разработка и утверждение ТЗ на создание АС.
Состав работ:
• Разработка и оформление проекта ТЗ.
• Согласование и корректировка ТЗ. • Утверждение ТЗ. 20 Техническое задание Содержание документа «ТЗ на создание АС»: • Общие сведения; • Назначение и цели создания (развития) системы; • Характеристика объектов автоматизации; • Требования к системе; • Состав и содержание работ по созданию системы; • Порядок контроля и приемки системы; • Требования к составу и содержанию работ по подготовке объекта автоматизации к вводу системы в действие; • Требования к документированию; • Источники разработки.
Каждый пункт раздела «Требования к системе»
должен быть подтвержден в ходе ПИ. 21 Эскизный проект Этапы:
1. Разработка предварительных проектных решений
по АС и ее частям; 2. Разработка документации на АС и ее части;
Примечание: Допускается исключать стадию
«Эскизный проект».
22 Эскизный проект Состав работ:
• Определение перечня решаемых задач и состава
комплексов задач. • Определение функций АС и ее составных частей, их целей и обеспечиваемых эффектов. • Определение состава АС. • Определение состава вычислительной системы. • Определение функций и параметров основных программных средств. • Разработка комплекта документов ЭП, обычно - «Пояснительной записки к ЭП».
23 Эскизный проект Содержание «Пояснительной записки»:
• Общие положения. • Описание процесса деятельности. • Основные технические решения, включая сведения об обеспечении заданных в техническом задании (ТЗ) потребительских характеристик системы (подсистем), определяющих ее качество. • Мероприятия по подготовке объекта автоматизации к вводу системы в действие.
24 Технический проект Этапы:
1. Разработка проектных решений по АС и ее
частям. 2. Разработка документации на АС и ее части. 3. Разработка и оформление документации на поставку изделий для комплектования АС или ТТ (ТЗ, ЧТЗ) на их разработку. 4. Разработка заданий на проектирование в смежных частях проекта объекта автоматизации.
25 Технический проект Состав работ: • Разработка общих решений по алгоритмам решения задач, функционально-алгоритмической структуре системы и ее частей, функциям персонала и оргструктуре, структуре КТС, системе классификации и кодирования. • Разработка, оформление, согласование и утверждение проектной документации в объеме требований ТЗ, а также заданий на проектирование в смежных частях проекта. • Подготовка и оформление документации на поставку изделий, либо ТТ для несерийных изделий. 26 Технический проект Требования к документации (РД 50-34.698): • Требования к перечню документов – из ТЗ. • Виды и комплектность документов регламентированы ГОСТ 34.201. • Содержание документов является общим для всех видов АС и, при необходимости, может дополняться разработчиком документов, в зависимости от особенностей создаваемой АС. Допускается включать в документы дополнительные разделы и сведения, объединять и исключать разделы. • Содержание каждого документа, разрабатываемого при проектировании АС согласно ГОСТ 34.201, определяет разработчик в зависимости от объекта проектирования (системы, подсистема и т.д.). 27 Рабочая документация Этапы:
1. Разработка рабочей документации на систему и
ее части. 2. Разработка и адаптация программ.
Примечание: Допускается объединять стадии
«Технический проект» и «Рабочая документация» в стадию «Технорабочий проект» (если выполняется «привязка» типового проекта).
28 Рабочая документация Состав работ: • Разработка, оформление, согласование и утверждение рабочей и эксплуатационной документации, содержащей все необходимые и достаточные сведения для выполнения работ по вводу АС в действие и ее эксплуатации, а также поддержания уровня эксплуатационных характеристик в соответствие с проектными решениями. • Разработка организационной документации. • Разработка ПО и программной документации; либо выбор, адаптация (настройка) приобретаемого ПО.
29 Рабочая документация Требования к документации (РД 50-34.698): • Требования к документированию – из ТЗ. • Виды и комплектность документов регламентированы ГОСТ 34.201. • Содержание документов является общим для всех видов АС и, при необходимости, может дополняться разработчиком документов, в зависимости от особенностей создаваемой АС. Допускается включать в документы дополнительные разделы и сведения, объединять и исключать разделы … • На этом этапе разрабатываются ПиМ согласно перечню испытаний из ТЗ. • Документ «Программа ОЭ» в ГОСТ 34.201 отсутствует, но рекомендуется выпускать и его. 30 Ввод в действие Этапы: 1. Подготовка объекта автоматизации к вводу АС в действие. 2. Подготовка персонала. 3. Комплектация АС поставляемыми изделиями (программными и техническими средствами, программно-техническими комплексами, информационными изделиями). 4. Строительно-монтажные работы. 5. Пусконаладочные работы. 6. Проведение предварительных испытаний. 7. Проведение опытной эксплуатации. 8. Проведение приёмочных испытаний. 31 Ввод в действие Состав работ: 1. Реализация проектных решений по оргструктуре, тиражирование эксплуатационной документации. 2. Подготовка персонала. 3. Получение комплектующих, их входной контроль. 4. Строительно-монтажные работы. 5. Пусконаладочные работы, включая начальное наполнение баз данных. 6. Проведение предварительных испытаний и устранение замечаний. 7. Проведение опытной эксплуатации и устранение замечаний. 8. Проведение приёмочных испытаний и устранение недостатков. 32 Ввод в действие Предварительные испытания Проводятся для определения работоспособности АПК АС и возможности ее приемки в опытную эксплуатацию. Могут быть автономными (АИ) и комплексными (КИ). • АИ охватывают части АС; • КИ проводят для АС в целом. Проводятся после отладки и тестирования АС, а также выпуска извещения о готовности АС. Проводятся на основании ПиМ. Разработчик документа оговаривается в договоре или ТЗ.
Примечание: проверка полноты соответствия АС требованиям
ТЗ необязательная. 33 Ввод в действие Опытная эксплуатация Проводится с целью: • Определения фактических количественных и качественных характеристик АС; • Определения фактической эффективности АС; • Проверки готовности персонала к работе в условиях функционирования АС; • Достаточности и правильности сведений, приводимых в документации.
Примечание: ГОСТ 34.201 не упоминает документ
«Программа опытной эксплуатации», но упоминание есть в ГОСТ 34.603. 34 Ввод в действие Приемочные испытания (ПИ) Проводятся на основании ПиМ с целью: • Определения соответствия АС требованиям ТЗ (по каждому пункту раздела «Требования к АС»); • Оценки результатов опытной эксплуатации; • Решения вопроса о возможности принятия АС в постоянную эксплуатацию. Проверяются: АПК, Персонал, ЭД, АС в целом. Предъявляются: • ТЗ, • акт приемки в ОЭ, • акт завершения ОЭ и допуска к ПИ, • журналы ОЭ, • ПиМ. 35 Ввод в действие Документация стадии: • Извещения о готовности АС к испытаниям и эксплуатации. • Приказы о составе Комиссии по проведению испытаний. • Распоряжения о начале испытаний, опытной и постоянной эксплуатации. • Протоколы проведения испытаний. • Акты завершения испытаний или этапа работы;
Требования к содержанию см. РД 50-34.698, Прил. 2.
На основании Акта завершения испытаний выпускается приказ
о приемке АС в постоянную эксплуатацию.
36 Сопровождение АС Этапы: 1. Выполнение работ в соответствии с гарантийными обязательствами. 2. Послегарантийное обслуживание.
Состав работ: 1. Анализ функционирования системы; 2. Устранение недостатков в работе АС; 3. Внесение необходимых изменений в эксплуатационную документацию; 4. Подготовка рекомендаций по развитию и модернизации (и утилизации) АС. 37 Ввод в действие Выпускаемые документы: 1. Изменения и дополнения к существующим документам. 2. Отчетные материалы по изучению функционирования АС. 3. Рекомендации по развитию и модернизации АС.
38 ГОСТ Р ИСО/МЭК 15910-2002 Работа Трудо-затраты, чел/час Изучение сведений о создаваемой системе 24 на проект Определение перечня выпускаемой документации 16 на проект Определение нормативных требований к выпускаемой документации 24 на проект Разработка плана выпуска документации 48 на проект Разработка «рыбы» документа 8 на том Выпуск первой редакции документа 1 на лист А4 Разработка графических материалов 5 на лист А4 Объединение текстовых и графических материалов 0,5 на лист А4 Проверка первой редакции 0,5 на лист А4 Корректировка первой редакции и графики 0,5 на лист А4 Внесение замечаний пользователя 0,5 на лист А4 Грамматическое редактирование 0,25 на лист А4 Подготовка второй и последующих редакций 0,25 на лист А4 Проверка второй и последующих редакций 0,25 на лист А4 Корректировка второй и последующих версий 0,16 на лист А4 Нормоконтроль документации 0,25 на лист А4 Печать и переплетение документации 40 на комплект Подготовка к рассылке 8 на комплект 39 Поставленные задачи: Применимость обеспечивается благодаря соответствию технических показателей АС и требований пользователей. Предсказуемость обеспечивается благодаря снижению рисков проектирования, реализации и эксплуатации АС. Эффективность обеспечивается благодаря тщательному проектированию и тестированию АС. Рациональность обеспечивается благодаря оптимальному планированию и выполнению работ, а также обеспечению предсказуемости работы АС.
40 Основные вопросы «С чего начать?» 1. Какие документы есть? – Отчет об обследования? – ТТ? – Концепция? – ТЗ? – Проектные и рабочие документы? 2. Какие работы выполнены? 3. Какие сведения в документах отсутствуют? 4. Какие работы не выполнены?
Начать с этапа, для которого отсутствуют сведения,
документы или результаты работ. 41 Основные вопросы «Что делать?» Список работ
Стадия 1 Стадия 2
Этап 1 Этап 2 Этап 3
Работа 1 Работа 1 Работа 1
Работа 2 Работа 2 Работа 2
Работа 3 Работа 3 Работа 3
42 Основные вопросы «Кто виноват?» Скорее всего, такой вопрос не возникнет.
Тем не менее: 1. Формальные требования ГОСТ – соблюдать; 2. Помнить про «области видимости» документов; 3. Замечания Заказчика к проектам – отдельным документом с указанием «авторства»; 4. Не работать «с голоса» и не «проектировать на лету»; 5. Утверждать документы на высоком уровне;
43 Практические рекомендации Когда использовать? Проектная зрелость Заказчика Необходимость, %
использования ГОСТ «по умолчанию». 44 Практические рекомендации • ГОСТ 34 относится только к АС. Никакого строительства, сигнализаций и ломов. • На маркетинговых стадиях привлекать маркетологов и пресейл-специалистов. • Привлекать Руководителей Проекта начиная с предпроектных стадий. • Не менять порядок и состав стадий и работ без достаточных оснований. • Получать официальные подписи высокого уровня на всех документах, являющихся источниками разработки для последующих стадий. • Не пренебрегать предпроектными стадиями. 45 Практические рекомендации «Области видимости» документации: 1. «Отчет об обследовании» и «Концепция»* - по стадию «Технический проект». 2. ТЗ – до приемочных испытаний; 3. Проектная документация: • Без замечаний - до стадии «Рабочая документация»; • С замечаниями – до Приемочных испытаний; 4. РД* – до Предварительных испытаний; 5. ОргД* – до Приемочных испытаний; 6. ЭД – на весь срок службы АС. * - далее по согласованию с Заказчиком. 46 Практические рекомендации • Уже на стадии «Разработка ТЗ» рекомендуется разработать оргдокумент «Схема деления». • ТЗ разрабатывает Исполнитель. • ТЗ не должно утверждаться без «визы» ГК (СА), который уже на этапе разработки ТЗ должен представлять как реализовывать и испытывать АС. • ТЗ может корректироваться вплоть до выпуска Исполнителем извещения о готовности АС к приемочным испытаниям. • При каждом изменении ТЗ по инициативе Заказчика обязательно корректировать объемы, сроки и стоимость работ. 47 Практические рекомендации • Требования ТЗ не должны ограничивать разработчика системы (ГОСТ 34.602, п. 1.4). • Некоторые сведения (Тема работ и т.п.) должны предоставляться Заказчиком. • Не стесняться оговаривать в договоре перечень сведений, предоставляемых Заказчиком. И обязательно их «стрясать». • На стадии ТП допускается разработка «Заданий на проектирование» в объеме ТЗ без выпуска отдельного ТЗ. • Если нет каких-то сведений в документах предпроектных стадий, их можно попробовать получить на стадии «Эскизный проект» в форме замечаний к ЭП. 48 Практические рекомендации • Не вносить замечания Заказчика в проекты – такой работы нет в ГОСТ. Оформлять приложением с указанием «авторства». • Материалы предпроектных и проектных стадий в эксплуатирующие подразделения не передаются. • Чтобы не согласовывать всю рабочую документацию с Заказчиком (и конкурентами), иногда выпускают протоколы стыковки (нет в ГОСТ). • Эксплуатационная документация утверждается только Исполнителем. Заказчик может дать замечания в рабочем порядке.
49 Практические рекомендации • Иногда Заказчик соглашается на использование англоязычной документации – особенно если используемый продукт не локализуется. • Конструктивно относиться ко всем получаемым замечаниям вплоть до этапа ОЭ – именно для того все эти стадии и этапы существуют. • Замечания Заказчика, выходящие за рамки ТЗ, также обязательно фиксировать и упоминать. Хороший повод продолжить проект. • Главное – не оставлять серьезные недостатки на приемочные испытания. Здесь могут помочь замечания к проектам, утвержденные самим же Заказчиком. 50 Полезные ресурсы \\hudson\i-teco\i-lib\
• Библиотека нормативов; • Библиотека системы качества.
