ТЕМА 2. Технологии проектирования информационных систем Лекция 11. Состав и структура проектной документации. Типы и функции документации Типы технической документации: документация разработки (служит для информационного обмена непосредственных участников разработки); документация продукции (передается пользователю для осуществления эксплуатации системы); документация управления проектом. Функции технической документации: сохранение и передача информации; нормативная (для фиксации взаимных обязательств участников разработки) 2 3 Стандарты, регламентирующие составление проектной документации ГОСТ 34.003-90 «Информационная технология. Комплекс стандартов на автоматизированные системы. Термины и определения» ГОСТ 34.602-89 «Комплекс стандартов на автоматизированные системы. Техническое задание на создание автоматизированной системы» РД 50 - 34.698 – 90 «Методические указания. Информационная технология. Комплекс стандартов и руководящих документов на автоматизированные системы. Автоматизированные системы. Требования к содержанию документов» ГОСТ 7.32-2001 «Система стандартов по информации, библиотечному и издательскому делу. Отчет о научно-исследовательской работе. Структура и правила оформления» 4 Стадии жизненного Основные документы цикла Анализ предметной Техническое задание области Проектирование Технический проект Разработка (реализация) Рабочий проект Внедрение Программа, методика и протоколы испытаний 5 Состав проектной документации стадии анализа предметной области 1. Отчет о выполненной работе по формированию требований пользователя. 2. Концепция ИС 3. Технико-экономическое обоснование необходимости разработки ИС. 4. Техническое задание на разработку ИС. 6 Содержание отчета РД 50 - 34.698 – 90 1. Характеристика объекта и результатов его функционирования 2. Описание существующей информационной системы 3. Описание недостатков существующей информационной системы 4. Обоснование необходимости совершенствования информационной системы объекта 5. Цели, критерии и ограничения создания АС 6. Функции и задачи создаваемой АС 7. Ожидаемые технико-экономические результаты создания АС 8. Выводы и предложения 7 Концепция ИС Концепция – это видение того, какой должна быть система. Основная цель создания этого документа – указать высокоуровневые требования (возможности, свойства) продукта и наиболее существенные ограничения. Документ «Концепция ИС» создается для первого руководителя предприятия-заказчика. Концепция позволяет Заказчику выявить именно те требования к системе, которые помогут ему оптимизировать работу своего предприятия в долгосрочной перспективе. 8 Содержание документа «Концепция ИС» РД 50 - 34.698 – 90 1) 2) 3) 4) 5) 6) 7) 8) 9) Описание результатов изучения объекта автоматизации; описание и оценка преимуществ и недостатков разработанных альтернативных вариантов концепции создания ИС; сопоставительный анализ требований пользователя к ИС и вариантов концепции ИС на предмет удовлетворения требований пользователя; обоснование выбора оптимального варианта концепции и описание предлагаемой ИС; ожидаемые результаты и эффективность реализации выбранного варианта концепции ИС; ориентировочный план реализации выбранного варианта концепции ИС; необходимые затраты ресурсов на разработку, ввод в действие и обеспечение функционирования; требования, гарантирующие качество ИС; условия приемки системы. 9 Содержание ТЭО Анализ и общая характеристика экономического объекта; обоснование необходимости разработки; описание выполняемых системой функций; сроки завершения отдельных этапов, форма приемки/сдачи работ, необходимые ресурсы; совокупность условий эксплуатации: архитектура системы, аппаратные и программные ресурсы, условия функционирования, обслуживающий персонал и пользователи системы; ограничения, риски, критические факторы, которые могут повлиять на успешность проекта; возможности развития системы; что не будет реализовано в рамках проекта. 10 Классификация функций Метод MuSCoW, предложенный в 1994 г., классифицирует функции по степени важности: Must have - необходимые функции (обеспечивают критичные для успешной работы системы возможности); Should have - желательные функции; Could have - возможные функции; Реализация функций этих категорий ограничивается временными и финансовыми рамками Won't have - отсутствующие функции (обеспечивают четкое представление границ проекта). 11 II этап I этап Отчет о формировании требований пользователей Концепция ИС Техникоэкономическое обоснование разработки ИС Техническое задание на разработку ИС 12 Содержание ТЗ по ГОСТ 34.602-89 Общие сведения Назначение и цели создания (развития) системы Характеристика объектов автоматизации Требования к системе Состав и содержание работ по созданию системы Порядок контроля и приемки системы Требования к составу и содержанию работ по подготовке объекта автоматизации к вводу системы в действие 8. Требования к документированию 9. Источники разработки 1. 2. 3. 4. 5. 6. 7. 13 1. Общие сведения полное наименование системы и ее условное обозначение; шифр темы или шифр (номер) договора; наименование предприятий разработчика и заказчика системы, их реквизиты; перечень документов, на основании которых создается ИС; плановые сроки начала и окончания работ; сведения об источниках и порядке финансирования работ; порядок оформления и предъявления заказчику результатов работ по созданию системы. 14 2. Назначение и цели создания системы Назначение вид автоматизируемой деятельности; перечень объектов, на которых предполагается использование системы Цели создания наименования и требуемые значения технических, технологических, производственноэкономических и др. показателей объекта автоматизации, которые должны быть достигнуты при внедрении АС; критерии оценки достижения целей создания 15 системы. Назначение и цели создания системы Назначение системы: система предназначена для решения перечисленных ниже задач (обеспечения выполнения перечисленных ниже процессов): задачи 1… (процесс 1); задачи 2…(процесс 2); Цели создания системы: целями создания системы являются: увеличение скорости...; повышение точности...; уменьшение издержек...; снижение потребления...; улучшение показателей...; Назначение системы АИС «Кадры» предназначена для комплексного информационно-аналитического обеспечения следующих процессов: - расчета заработной платы; - оперативного учета движения кадров; - ведения документооборота по персоналу и т.д. АИС «Кадры» предполагается использовать в Федеральном агентстве "Государственные кадры» и в его территориальных органах, задействованных в исполнении вышеперечисленных процессов. Цели создания системы Замещение существующей информационной системы, которая не предоставляет возможности комплексного информационно-аналитического обеспечения вышеперечисленных процессов. Повышение эффективности исполнения вышеперечисленных процессов путем сокращения непроизводительных, дублирующихся и неавтоматизированных операций, оптимизации информационного взаимодействие участников процессов. Повышение качества принятия управленческих решений за счет оперативности представления, полноты, достоверности и удобства форматов отображения информации. Цели создания системы Для реализации поставленных целей система должна решать следующие задачи: В результате внедрения АИС «Кадры» будут достигнуты следующие значения показателей: Ведение нормативно-справочной информации; Построение аналитических отчетов и выписок. Стоимость выполнения процесса … снизится с … руб. до … руб. Время подготовки типового отчетного документа снизится с …ч. до … мин. Критериями оценки достижения целей создания системы считается способность АИС «Кадры» обеспечить возможность решения задач по своему 3. Характеристика объектов автоматизации краткие сведения об объекте автоматизации сведения об условиях эксплуатации и характеристиках окружающей среды ПРИМЕР: Объектом автоматизации являются процессы по управлению государственными кадрами, а также контроль эффективности выполнения указанных процессов. Процессы управления государственными кадрами включают в себя: - произведение расчета заработной платы; - оперативного учета движения кадров; - ведение административного документооборота по персоналу и учету труда, аттестации и определению потребностей работников; Данные процессы осуществляются следующими специалистами: - Экономистами планово-экономического отдела или отдела труда и заработной платы; - Инспекторами отделов кадров и менеджерами по персоналу; - Руководителями различного уровня, в т.ч. и высшим руководством; - Табельщиками и сотрудниками табельных бюро; - Бухгалтерами расчетной части и главными бухгалтерами предприятий. 20 Требования Требования к системе Функциональные требования по подсистемам Требования к функциям, выполняемым системой Требования к времени реализации функций Требования к видам обеспечения Требования к качеству реализации функций Перечень и критерии отказов функции 21 Требования к системе требования к структуре и функционированию системы; требования к численности и квалификации персонала системы и режиму его работы; показатели назначения; требования к надежности; требования безопасности; требования к эргономике и технической эстетике; требования к эксплуатации, техническому обслуживанию, ремонту и хранению компонентов системы; требования к защите информации от несанкционированного доступа; требования к сохранности информации при авариях; требования к защите от влияния внешних воздействий; требования к патентной чистоте; требования к стандартизации и 22 унификации 4.1.1 Требования к структуре и функционированию системы 1) 2) 3) 4) 5) 6) перечень подсистем, их назначение и основные характеристики, требования к числу уровней иерархии и степени централизации системы; требования к способам и средствам связи для информационного обмена между компонентами системы; требования к характеристикам взаимосвязей создаваемой системы со смежными системами, требования к ее совместимости, в том числе указания о способах обмена информацией (автоматически, пересылкой документов, по телефону и т.п.); требования к режимам функционирования системы; требования по диагностированию системы; перспективы развития, модернизации системы. 23 Пример требований к структуре системы В состав АС Кадры должны входить следующие подсистемы: - Подсистема хранения данных; - Подсистема управления нормативно-справочной информацией; - Подсистема формирования отчетности; Подсистема хранения данных предназначена для хранения оперативных данных системы, данных для формирования аналитических отчетов, а также документов системы, сформированных в процессе работы. Подсистема управления нормативно-справочной информацией предназначена для централизованного ведения классификаторов и справочников, используемых для обеспечения информационной совместимости подсистем. Подсистема формирования отчетности предназначена для создания и формирования отчетов в виде, удобном для вывода 24 на печатающие устройства. 4.1.2 Требования к персоналу требования к численности персонала (пользователей) АС; требования к квалификации персонала, порядку его подготовки и контроля знаний и навыков; требуемый режим работы персонала АС. 25 Пример требований к персоналу Численность персонала должна быть достаточной для реализации функций системы во всех режимах ее работы обеспечивать полную занятость персонала при реализации автоматизированных функций системы. Квалификация персонала должна обеспечивать эффективное функционирование технических и программных средств системы во всех режимах ее работы. Пользователи АСУ должны иметь базовые навыки работы с ОС Microsoft Windows, офисным программным обеспечением Microsoft Office. Все администраторы АСУ должны иметь квалификацию «инженер». Режим работы: Все специалисты должны работать с нормальным графиком работы не более 8 часов в сутки. 26 4.2. Требования к функциям (по подсистемам) перечень подлежащих автоматизации задач; временной регламент реализации каждой функции; требования к качеству реализации каждой функции, к форме представления выходной информации, характеристики точности, достоверности выдачи результатов; перечень и критерии отказов. 27 Формулировка требований к функциям системы Если функция автоматизированная, тогда система должна обеспечивать ВОЗМОЖНОСТЬ выполнения указанной функции. Система должна обеспечивать возможность поиска информации в справочниках по известным атрибутам. Если функция автоматическая, тогда система должна обеспечивать выполнение функции. Система должна обеспечивать автоматическое копирование данных на резервный носитель при закрытии базы данных по окончании рабочего дня. Подсистема управления нормативно-справочной информацией должна обеспечивать возможность выполнения следующих функций: a) b) c) d) e) f) g) Добавление новых элементов; Редактирование элементов; Удаление элементов; Просмотр элементов; Фильтрация и сортировка списка элементов; Поиск элементов; Экспорт и импорт элементов. Подсистема управления нормативно-справочной информацией должна обеспечивать ведение следующих справочников и реестров: Справочник «Сотрудники»; Справочник «Адреса»; Справочник «Предприятия»; 29 4.3. Требования к видам обеспечения математическому (состав и область применения мат. моделей и методов, типовых и разрабатываемых алгоритмов); информационному (состав, структура и организация данных, обмен данными между компонентами системы, информационная совместимость со смежными системами, используемые классификаторы, СУБД, контроль данных и ведение информационных массивов, процедуры придания юридической силы выходным документам); лингвистическому (языки программирования, языки взаимодействия пользователей с системой, системы кодирования, языки ввода- вывода); программному (независимость программных средств от платформы, качество программных средств и способы его контроля, использование фондов алгоритмов и программ); техническому; организационному (структура и функции эксплуатирующих подразделений, защита от ошибочных действий персонала); методическому (состав НТД). 30 Требования к ИО Информационное обеспечение АС «Кадры» должно обеспечивать: ввод, обработку, накопление и хранение информации, необходимой для реализации функций АС; представление информации в форме, удобной для работы пользователя, в соответствии с его функциональными обязанностями и установленным разграничением доступа; актуальность и достоверность информации в базах данных, ее хранение с необходимой избыточностью, а также контроль полноты и непротиворечивости вводимой информации; адаптируемость к возможным изменениям 31 информационных потребностей пользователей. Требования к ПО Используемое при разработке программное обеспечение и библиотеки программных кодов должны иметь широкое распространение, быть общедоступными и использоваться в промышленных масштабах. Базовой программной платформой должна являться операционная система MS Windows. ПО АС «Кадры» должно обеспечивать: решение пользовательских задач; замену, включение новых и удаление старых компонентов в процессе развития и совершенствования АС; управление базами данных. 32 Требования к ТО В состав комплекса должны входить следующие технические средства: – Серверы БД; – Серверы приложений; – Веб сервер; – ПК пользователей; – ПК администраторов. Требования к техническим характеристикам: Для обеспечения выполнения функций АС используется локальная вычислительная сеть с пропускной способностью не менее 100 Мбит/c. 33 Требования к организационному обеспечению Организационное обеспечение системы должно быть достаточным для эффективного выполнения персоналом возложенных на него обязанностей при осуществлении автоматизированных и связанных с ними неавтоматизированных функций системы. К работе с системой должны допускаться сотрудники, имеющие навыки работы на персональном компьютере, ознакомленные с правилами эксплуатации и прошедшие обучение работе с системой. Проектные решения по организационному обеспечению должны отвечать требованиям РД 50-34.698-90 в части подраздела «Требования к содержанию документов с решениями по организационному обеспечению». 34 4.3.2.1. Требования к лингвистическому обеспечению системы 4.3.2.1.1. Требования к применению в системе языков программирования высокого уровня (текст требования) Для лингвистического 4.3.2.1.2. Требования к языкам обеспечения системы взаимодействия пользователей и технических приводят требования к средств системы применению в системе требования) языков программирования (текст 4.3.2.1.3. Требования к кодированию данных высокого уровня, языков (текст требования) взаимодействия 4.3.2.1.4. Требования к декодированию пользователей и данных технических средств (текст требования) системы, а также 4.3.2.1.5. Требования к языкам ввода-вывода требования к кодированию данных и декодированию данных, к (текст требования) 4.3.2.1.6. Требования к языкам языкам ввода-вывода манипулирования данными данных, языкам требования) манипулирования данными, (текст 4.3.2.1.7. Требования к средствам описания средствам описания предметной области (объекта автоматизации) предметной области (текст требования) (объекта автоматизации), к 4.3.2.1.8. Требования к способам организации способам организации диалога диалога (текст требования) Пример формулировки требований к виду обеспечения Шаблонное построение фраз 4.3.2.1. Требования к применению в системе языков программирования высокого уровня В системе должны быть применены перечисленные ниже языки программирования высокого уровня: 1. язык C++; 2. язык Pascal; 3. и т.д. Нумерация разделов Вариант 1 Для решения задачи ведения НСИ программные средства системы должны обеспечивать выполнение перечисленных ниже функций: автоматизированной функции добавления записей в таблицы базы данных; автоматизированной функции удаления записей из таблиц базы данных; автоматизированной функции сортировки записей в таблицах базы данных...; Вариант 2 4.3.2.1. Для решения задачи ведения НСИ программные средства системы должны обеспечивать выполнение перечисленных ниже функций: 1. 2. 3. автоматизированной функции добавления записей в таблицы базы данных; автоматизированной функции удаления записей из таблиц базы данных; автоматизированной функции сортировки записей в таблицах базы данных...; 5. Состав и содержание работ по созданию системы перечень стадий и этапов работ сроки исполнения состав организаций — исполнителей работ вид и порядок экспертизы технической документации программа обеспечения надежности программа метрологического обеспечения 38 6. Порядок контроля и приемки системы виды, состав, объем и методы испытаний системы общие требования к приемке работ по стадиям статус приемочной комиссии 39 7. Требования к составу и содержанию работ по подготовке объекта автоматизации к вводу системы в действие преобразование входной информации к машиночитаемому виду изменения в объекте автоматизации сроки и порядок комплектования и обучения персонала 40 8. Требования к документированию согласованный разработчиком и Заказчиком системы перечень подлежащих разработке комплектов и видов документов, соответствующих требованиям ГОСТ 34.201 и НТД отрасли заказчика; при отсутствии государственных стандартов, определяющих требования к документированию элементов системы, дополнительно включают требования к составу и содержанию таких документов. 41 9. Источники разработки Документы и информационные материалы, на основании которых разрабатывалось ТЗ, и которые должны быть использованы при создании системы: технико-экономическое обоснование, отчеты о законченных научно-исследовательских работах, информационные материалы на отечественные, зарубежные системы-аналоги и др. 42 Общие приемы написания ТЗ Детализация Шаблонное построение фраз Штампы и унификация при подготовке текста Перечни и нумерация разделов Осторожное применение «тематических» ГОСТ Краткое содержание ТЗ Описание основных целей создания системы, критерии эффективности ее функционирования; описание состава и структуры разрабатываемой системы, порядок разработки подсистем; перечень основных показателей (параметров), которые должны быть достигнуты в условиях автоматизированного управления объектом; перечень функций управления с указанием входных и выходных документов, периодичность решения и формы представления информации для каждой функции; требования к видам обеспечения; этапы разработки системы. 44 Порядок разработки ТЗ 1. Проект ТЗ на АС разрабатывает организация-разработчик системы с участием заказчика на основании технических требований. Необходимость согласования проекта ТЗ на АС с органами государственного надзора и другими заинтересованными организациями определяют совместно заказчик системы и разработчик проекта ТЗ на АС. 2. Срок согласования проекта ТЗ на АС в каждой организации не должен превышать 15 дней со дня его получения. 3. Замечания по проекту ТЗ на АС должны быть представлены с техническим обоснованием. 4. Если при согласовании проекта ТЗ на АС возникли разногласия между разработчиком и заказчиком, то составляется протокол разногласий и конкретное решение принимается в установленном порядке. 5. Утверждение ТЗ на АС осуществляют руководители предприятий (организаций) разработчика и заказчика системы. 6. ТЗ на АС до передачи его на утверждение должно быть проверено службой нормоконтроля организации - разработчика ТЗ. 7. Согласование и утверждение дополнений к ТЗ на АС проводят в порядке, установленном для ТЗ на АС. 8. Изменения к ТЗ на АС не допускается утверждать после представления 45 системы на приемо-сдаточные испытания. Варианты разработки ТЗ силами самого Заказчика; непосредственным Исполнителем, в чьи обязанности в дальнейшем войдут проектирование и проведение испытаний; «конкурсным» Исполнителем, чьи взаимоотношения с Заказчиком завершатся разработкой технического задания; сторонним Исполнителем. 46 Взаимоотношения Заказчика и исполнителя при разработке ТЗ Умный Исполнитель Наивный Исполнитель Умный Заказчик Продление Бесконечные сроков договора переделки за счет Исполнителя Наивный Заказчик Высочайшая норма прибыли Исполнителя Бой быков 47