Работа в Microsoft Visual Studio

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

Показывать лекцию целиком

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

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

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

  • Документ описания структуры проекта
  • Документ оценки рисков
  • Общее описание и рамки проекта (Vision\Scope)
  • Разумеется, никто не ограничивает документацию по проекту только предложенными MSF типами документов, это лишь рекомендации, следование которым, должно, по мнению Microsoft, упростить и облегчить процесс создания IT решения.

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

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

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

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

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

    Подробно описание рисков рассмотрено в лекции 3, практический пример процесса управления рисками описан в семинаре 1.

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

    Vision\Scope документ

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

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

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

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

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

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

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

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

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

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

  • Предотвращению рисков
  • Смягчению последствий рисков
  • Данные мероприятия составляются для каждого из рисков (подробнее см Семинар 1)

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

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

    (рис 22.1)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Шаблон Vision\Scope документа

    Project Portfolio Server Vision Scope Document Final Report from the Envisioning Workshop

    TABLE OF CONTENTS

    I. INITIATIVE BACKGROUND

    II. BUSINESS CHALLENGE / OPPORTUNITY

    III. VISION STATEMENT

    IV. PPS INITIATIVE APPROACH, TIMELINES, AND DELIVERABLES

    A. Approach

    B. Timeline

    V. GOALS, OBJECTIVES, ASSUMPTIONS, CONSTRAINTS, AND RISKS

    A. Goals And Objectives

    B. Assumptions

    C. Constraints

    D. Risks

    VI. INITIATIVE SCOPE

    A. In Scope

    B. Out Of Scope

    VII. PPS INITIATIVE BUSINESS REQUIREMENTS

    A. PPS Primary Use Cases

    B. Roles Definition and Usage Scenarios

    VIII. PPM GOVERNANCE PROCESS

    A. High-Level Governance Workflow

    B. Decision Making Process

    C. Governance Team Composition

    D. Timeframe for Deployment

    IX. INITIATIVE ACCEPTANCE CRITERIA

    X. PROJECT ORGANIZATION AND STAFFING

    A. Customer

    B. Implementation Partner

    C. Microsoft

    XI. GENERAL CUSTOMER RESPONSIBILITIES

    Initiative Background

    [Общее описание проекта. Причины, по которым к участию в фазе Envision должен быть привлечен представитель заказчика.]

    Business Challenge / Opportunity

    [Описание проблем бизнеса, на которые влияет создаваемое ITрешения. Ранжирование выявленные проблем по степени значимости для бизнеса]

    Business Challenge or Opportunity for Improvement Priority Ranking Areas Affected Consequence of Not Responding
     
     

    Vision Statement

    [Описание видения организацией – заказчиком создаваемого IT решения]

    PPS Initiative Approach, Timelines, and Deliverables

    Approach

    [Описание подхода группы разработчиков к созданию решения]

    Timeline

    [Описание основных вех, дат их начала и окончания]

    Milestone Approximate Date of Phase End Go/No Go Decision Point
     
     

    Deliverables

    [Describe the main Deliverable(s) of the PPS initiative, intermediate, and finals.]

    Objectives, Goals, Risks, and Constraints

    Objectives and Goals

    [Описание целей готового решения]

    Constraints

    [Описание таких параметров проекта как бюджет, время и т.п.]

    Risks

    [Описание рисков проекта. Главная таблица рисков с указанием причин возникновения]

    Initiative Scope

    In Scope

    [Описание мероприятий, которые входят в состав данной итерации проекта]

    Out of Scope

    [Описание мероприятий, оставшихся за рамками данной итерации, но которые могут быть (будут) проведены в следующей итерации]

    PPS Initiative Business Requirements

    [Требования к решению со стороны заказчика. Выявляются в течении фаз Envision, частично - Planning]

    PPS Primary Use Cases

    Roles Definition and Usage Scenarios

    PPM Governance Process

    [Описание процесса руководства проектом]

    High-Level Governance Workflow

    Decision Making Process

    Governance Team Composition

    Timeframe for Deployment

    Project Organization and Staffing

    [Состав команды разработчиков, их роли и области ответственности]

    Характеристики участников процесса разработки со стороны заказчиков, партнеров и компании Microsoft (если необходимо):

    Customer
    Name Role Core team member
     
     

    Implementation Partner
    Name Role Core team member
     
     

    Microsoft (if applicable)
    Name Role Core team member
     
     

    General Customer Responsibilities

    [Описание специфичных критериев и ситуаций, которые могут влиять на успех проекта]

    Описание действий заказчика, которые могут способствовать созданию эффективного IT решения:

    (Пример):

  • Активное участие в обсуждении дальнейших действий команды разработчиков
  • Status calls – регулярные отчетности о состоянии дел по телефону (и не только)
  • Поддержка постоянной коммуникации с непосредственными разрабтчиками
  • Приложение Б

    Пример календарного плана - графика

    Вернуться к учебному плану