Оформление документации по проекту

Вопросы семинара 4 "Оформление документации по проекту":

• Документация фазы Envision
• Документация фазы Planning
• Документация фазы Developing
• Документация фазы Stabilizing
• Документация фазы Deploying
• Заполнение Vision\Scope документа (см. Приложение)
• Составление плана – графика проекта

Документация фазы Envision

К документам фазы выработки концепции относятся:

• Документ описания структуры проекта
• Документ оценки рисков
• Общее описание и рамки проекта (Vision\Scope)

Разумеется, никто не ограничивает документацию по проекту только предложенными MSF типами документов, это лишь рекомендации, следование которым, должно, по мнению Microsoft, упростить и облегчить процесс создания IT решения.

Рассмотрим типы основных документов фазы выработки концепции.

Документ описания структуры проекта

В данный документ входят: информация об организации проектной группы, участники группы и их роли, персонификация областей ответственности каждого из членов проектной группы.

Также в данном документе должна быть представлена схемы взаимодействия группы разработчиков с заказчиками и заказчиков – с группой разработчиков.

Документ оценки рисков

Подробно описание рисков рассмотрено в "Дисциплины управления рисками и готовностью в методологии MSF" практический пример процесса управления рисками описан в "Организация работы в команде" .

Следует лишь отметить, что главная таблица рисков (см "Организация работы в команде" ) является частью документа Vision\Scope.

Vision\Scope документ

Формирование видения проекта и специфицирование его рамок – не одно и тоже, хотя для успеха проекта необходимо и то, и другое. Видение (vision) – это ничем не ограничиваемое представление о том, каким должно быть решение. Рамки (scope) же дают четкие границы того, что из предложенного этим видением будет реализовано в условиях существующих проектных ограничений.

Шаблон Vision\Scope см в Приложении А.

Документация фазы Planning

Документы фазы планирования:

• Функциональная спецификация
• План управления рисками
• Сводный план и календарный график проекта

Утвержденные спецификации, планы и календарные графики образуют базовую версию проекта (project baseline). Она включает все соглашения, принятые на основе консенсуса с учетом трех плановых параметров проекта: ресурсов, времени и функциональности решения. После того, как базовая версия проекта создана и утверждена, проектная группа приступает к фазе разработки.

Функциональная спецификация

Функциональные спецификации детально описывают вид и поведение каждой составляющей решения. Также для всех составляющих описывается их архитектура и дизайн.

Цели функциональной спецификации:

• Инструкции команде разработчиков о том, что они должны будут создать.
• Основа для оценивания объема работы.
• Четкое соглашение с заказчиком о том, что должно быть сделано.
• Синхронизация работы всей проектной команды.

План управления рисками

План управления рисками включает в себя описание мероприятий по

1. Предотвращению рисков
2. Смягчению последствий рисков

Данные мероприятия составляются для каждого из рисков (подробнее см "Организация работы в команде" )

Сводный план и календарный план проекта

Сводный план проекта представляет собой совокупность планов работы каждого из ролевых кластеров, см. рис. 22.1

Рис. 22.1.

Каждый из планов детализируется, также составляется календарный график для каждого из планов.

Сводный календарный график проекта включает в себя все детализированные календарные графики вплоть до даты выпуска решения. Сводный календарный график интегрирует в себе календарное планирование деятельности каждого ролевого кластера. Дата выпуска определяется после обсуждения со всеми заинтересованными сторонами базовой версии функциональной спецификации и анализа сводного плана проекта. Зачастую, с целью обеспечения выпуска решения в намеченный срок, проектная группа вносит коррективы в функциональную спецификацию и/или сводный план проекта.

Документация фазы Developing

Документы фазы "Разработка":

• Окончательная функциональная спецификация – содержит в себе подробное, детализированное описание реализованных функций
• Материалы поддержки решения – это такие материалы как: readme файлы, учебные материалы по работе с решением, техническое описание решения и т.п.

Документация фазы Stabilizing

Документы фазы "Стабилизация":

• Документация выпуска
• Материалы поддержки решения
• Результаты тестирования
• Проектная документация

Документация фазы Deploying

Документация фазы "Внедрение":

• Версии проектных документов, массивы данных (load sets) и программный код, разработанные во время проекта.
• Отчет о завершении проекта (project close-out report).
• Окончательные версии всех проектных документов.

Заполнение Vision\Scope документа

В рамках данного семинара студентам предлагается заполнить шаблон документа Vision\Scope. Заполнение всех полей и таблиц не является обязательным. Главное, что должно быть отражено в документе – состав проектной группы, представители заказчика, функциональные требования к решению, главная таблица рисков.

Шаблон документа Vision\Scope см в Приложении А

Составление плана – графика проекта

Также к числу обязательных документов, которые должны быть составлены до начала фазы "Разработка" относится сводный календарный план – график.

Заполнять его в строгом соответствии с рекомендациями MSF необязательно. В обязательном порядке он должен содержать наименования задач, сроки их выполнения и ответственные исполнители. Подобный план – график может быть составлен в MS Project.

Пример см в Приложении Б.

Использованные источники

1. Microsoft Solutions Framework White Papers. [Электронный ресурс]. – http://www.microsoft.com/technet/solutionaccelerators/msf/default.mspx/, свободный.