Project :Industry: Security, Manufacturing, Human Resources, Research and Development Services Provided: Project Management, Organizational Change Management Company: The client is a global leader in

PMO

<Sponsor>

..........













<Project name>

Requirements Planning Document








Author: <Author>


Version: <Version>


Date: <Date>




Document History


Version

Date

Status

Completed by

Reviewed by

Authorized by

1.0

mm/dd/yyyy

<Author>

<Reviewer>

<Authorizer>



Supporting Document Links:

<File link> (Sharepoint Location/link)


Related Documents


(Examples) Project Concept Document, Project Charter, PDD, Application Development Master Plan, Customer request



Template Notes

  • The document template contains some other basic templates.

  • Graphic templates are Visio drawings that include the set of symbols and eventually a prototype diagram. They are not true Visio templates.

  • When a UML diagram is required, the template is not included. A UML modelling tool (such as Rational Rose) may be used. Same can apply to Mercury & other tools

  • The template may be converted to landscape format for better spacing of tables and graphs. The text in italics and blue are comments about the template and should be removed.

  • PROPOSED METHDOLOGY RULE (PROJECT CATEGORIZATION):

The flag << SML >> indicates if the section or chapter is required for a Small, Medium, or Large project. Everything is required for a large project. S and M are indicated where applicable.


Requirements Analysis Team:



Name

Title

Role

Contact Info

<<< Requirements Team .>>>

<<<Title in the organization >>>

<<<role of the person in the project – Lead BA>>>

<<<Date of authorization>>>

Authorization page


Name

Title

Role

Date

Signature

<<< name of the person authorizing the requirements – Business Line Exec. PPM Governance Committee, etc.>>>

<<<Title in the organization >>>

<<<role of the person in the project >>>

<<<Date of authorization>>>



CONTENTS


1 Overview 4

1.1Introduction 4

1.1Approach<< SML >> 4

1.2Scope 5

1.2.1High-level Functional Structure 6

1.2.2High-level Process Definition 7

1.2.3High-level Information View 8

1.2.4High-level Integration View 8

1.2.5High-level Technology View 10

1.3Business Impact 12

1.4Current Systems 12

<<<Include the main characteristics of the current systems and immediate plans within the scope of the project.>>> 12

1.5Constraints 13

1.6Assumptions 14

2BUSINESS MODEL 15

2.1Process Diagram 15

2.2Process Descriptions 16

A brief description of each event is sufficient.>>> 16

<Event name> 16

<Event description…> 16

Process 16

Location 16

<process 1> 16

<location 1> 16

2.3Process Volumes 16

2.4Business Entity Model Diagram 16

2.5Business Entity Descriptions 17

2.6Data Volumes 17

3REQUIREMENTs definition 18

3.1Functional Requirements 19

Description 21

Performance Parameters 21

Issues/Constraints 21

3.2Non-functional Requirements 22

3.3Requirement Dependencies 25

APPENDICES 27

<<<Appendices should be included when any further detail is required. 27

Business Unit/Function Matrix 27

Function/Location Matrix 28







  1. Overview

<< SML >>


<<< A brief summary conveying the essentials of the project.

It is aimed at business line & management level and should not contain technical terms. Explanation of terms that are unavoidable should be provided in an appendix.>>>

    1. Introduction

<< SML >>

<<< A brief introduction providing essential background to the project.

Other topics could include:

  • Business background

  • Origins of the project

  • Existing systems overview

  • Major issues

  • Major limitations for the existing business or systems

  • Existing relevant documentation – full references are given here or in an Appendix.

A note is helpful clarifying the nature and structure of the requirement analysis, such as:

The document presents the requirements independent of any potential implementation. The document structure follows the business functions analysed and presented in the functional structure section of the report.>>>

    1. Approach<< SML >>

<<<A short statement of how the investigation and analysis was carried out.>>>

<<<Any formal techniques should be described at a high-level (Agile, SCRUM,Etc) l. The approach to presenting the report should be described in outline and reference to any special matters given, e.g.:

Sources and any limits to the techniques should be clearly stated.>>>




    1. Scope

<< SML >>

<<<A clear statement of the scope of the requirements analysis, showing areas analyzed and boundaries.

Possible ambiguities should be clarified by stating what is NOT included. Limitations should be described.

Diagrams can be helpful to improve clarity – put these in this section or refer to them in an appendix. Refer to the methodology if appropriate, such as :>>>


      1. High-level Functional Structure

<< SML >>


<<<This section includes a diagram that represents the functionality of the application to be developed. It may be described as one of the following:

  • A high-level use case model. A UML Use Case Diagram or a hierarchy diagram (e.g. Story Points) may be used.


  • A high-level functional decomposition. A hierarchy diagram may be used.

The diagram should show the structure of business processes, not the place in the organization where the process occurs. Each node in the diagram will need a unique identifier that will link it to more detailed views of the functional structure. (Req Breakdown Structure)>>>

      1. High-level Process Definition

<< SML >>


<<<A “swim lane” diagram may be used to describe the high-level process. The actual level of detail may depend on the application.>>>



      1. High-level Information View

<< SML >>


<<<The high-level information view shows the relationship between

  • Interaction devices

  • Data stores

  • Business functionality>>>


      1. High-level Integration View

<< SML >>

<<<The high-level integration view shows the high-level components used to integrate the business functionality components. It may be seen as a high-level view of the middleware required to support the application.>>>


      1. High-level Technology View

<< SML >>


<<<This high-level view shows the physical infrastructure where the application will execute.>>>



    1. Business Impact

<< SML >>


<<<Include a short statement describing the potential impact of this document’s requirements and recommendations upon the business as a whole. >>>

<<<Topics could include:

  • Strategic issues – how this project implements or supports the business strategy

  • Life expectancy of current systems

  • Business expansion or contraction

  • Broad business benefits – such as direction, major issues resolved, and competitive edge.>>>

    1. Current Systems

<< SML >>

<<<Include the main characteristics of the current systems and immediate plans within the scope of the project.>>>


<<<Use bullet points to highlight the most significant matters. It is not appropriate to describe current systems in detail.>>>


<system name>

<Include a short one-paragraph description of the system. It should not contain details.>

Basic Functionality

<A bulleted list of the main system functionality>

  • Function 1

  • Function 2

Life Expectancy

<until date> or years

mm/dd/yyyy

Limitations

<known limitations>

  • Limitation 1

  • Limitation 2

Advantages

<good points >

  • Advantage 1

  • Advantage 2

Relation to New System



<<<Points to consider include:


  • Nature of the systems, such as manual procedures, legacy systems, or end-user computing solutions

  • Relevant recent history, such as application development and investment

  • Life expectancy of current systems

  • How well current systems match the target technical environment and technical strategy

  • Limitations of current systems

  • Impact on the current business and its opportunities

  • Advantages and disadvantages of the current facilities

Relationship to the business organization and any limitations>>>



    1. Constraints

<< SML >>


<<<Include a short list of the main business constraints to be considered when identifying requirements and possible solutions.>>>

<<<Possible categories include:

  • Regulatory (Basel 2, Sarbox, Needed for MU Attestation, etc)

  • Business Policy

  • Other systems development projects

  • Infrastructure

  • Technical architecture

  • Business strategy

  • IT strategy

  • Product availability and reliability

  • Marketplace Timeliness to market>>>


    1. Assumptions

<< SML >>

<<<A list of the assumptions on which the requirements are stated. This may well be in addition to those identified earlier in the project.>>>

<<<Points to consider include:

Business circumstances, such as the business environment

Business strategy

IT strategy

Organizational plans or constraints

Other development activity outside the scope of this project

Other business activity outside the scope of this project

External factors

Timing

Availability of critical Lahey resources

Integration to other Lahey projects

Continuity

Priorities as outlined by PPM Governance>>>


  1. BUSINESS MODEL

<<<Include a high-level definition of the business processes within the scope of the project.

This is in three parts:

Diagram(s) of the high-level business view

Description of the main processes

Process volumes>>>



    1. Process Diagram

<< SML >>


<<<Include a high-level flow/activity diagram of the main business processes covered by the scope of the project. An outline of related processes (or functions) can be shown if relevant or helpful.>>>



    1. Process Descriptions

<< ML >>


<<<Include short descriptions of the main business processes and events.


Other items to be considered for a process are:


Objective of the process

Specifications/Directives


A brief description of each event is sufficient.>>>


<Event name>

<Event description…>



Process

Location


<process 1>

<location 1>






    1. Process Volumes

<< SML >>


<<<Estimate the volumes of the main business processes.

Volumes for the significant processes at any level should be Rough Order of Magnitude (ROM) estimated. This is particularly necessary if the process volume is likely to affect the sizing of the project infrastructure requirements.>>>





    1. Business Entity Model Diagram

<< SML >>

<<<Include a diagram of the relationships of the significant business entities within the scope of the project. The diagram uses UML notation for Class Model but may include any attribute or operation for the business entities.>>>


    1. Business Entity Descriptions

<< SML >>


<<<Brief description of each business entity in the model (often called Personas).

A short description of the entity is required. Optionally, a bullet list of the entity attributes can be added (usually included in the diagram). The descriptions should be short and logically exact. Some background explanation can be added, if it is necessary to clarify.>>>

Entity

Description

Attributes



    1. Data Volumes

<< SML >>


<<<Include an initial estimate of the volumes of data for each of the business entities contained in the entity model.>>>



Business entity

Current/Initial volume

Growth

Archive volume




  1. REQUIREMENTs definition


<<<The requirements should be clearly and simply described, without ambiguity.

It is a distinct advantage, where possible, for requirements to be quantifiable and relate to the business purpose stated earlier.

It is valid to describe the requirement at an outline level where a package solution is to be considered, rather than try to define the exact business mechanism.

Requirements may be:

  • High Level Business Objectives

  • Functional requirements

  • Non functional requirements.

The templates are described below.>>>

.




    1. Functional Requirements

<< SML >>

<<<This section includes a diagram that represents the functionality required for the application to be developed. It may be described as of the following four options (Note: This is the detail that feeds the overview section):

  • A high-level use case model. A UML Use Case Diagram or a hierarchy diagram may be used.

  • A high-level functional decomposition. A hierarchy diagram may be used.

  • a Table describing the functionality hierarchy


## Function





##.## Function





##.##.## Function





##.##.##.## Function




##.##.##.## Function



##.##.## Function





##.##.##.## Function


##.## Function





##.##.## Function


  • A description for every node in the diagram. The description will include:

Code - Name of Requirement

Where adequate, code may represent the hierarchy of requirements (#.#.#).

Description

General description of the requirement.

Priority

Mandatory, Desirable, or Optional.

Performance Parameters

The dynamic business performance requirements of throughput, frequency of use and growth expected, such as stock turn, planning lead-time, number of business transactions, peak load, commercial windows, and response times required. All must be in terms of business performance requirements, and not in any way second-guess the design of the solution.

Issues/Constraints

Issues and constraints relating to Design, Location or Organization that may not be addressed within this specification, but that need to be documented here so that they do not get overlooked.>>>


Reqmnt. code

Description

Priority

Performance parameters

Issues/ Constraints







    1. Non-functional Requirements

<< SML >>

<<<Non-functional Requirements are those requirements not representing business functionality. They are represented as lists of requirements, grouped as appropriate.

Non-functional requirements may be applicable to:

  • The complete application (required)

  • A specific functional requirement (optional)

The following non-functional requirements represent the minimum set to be specified :Also refer to Non-Functional Requirements (NFR guidelines)>>>


Performance

Req. code

Factor

Limits



Security

Req. code

Category

Description

Authentication

Authorization

Encryption

Non-repudiation

Logging

Auditing



Availability (e.g. HA)

Req. code

Schedule

Limits





Regulatory

Req. code

Schedule

Limits




Recoverability (e.g. DR / Business Continuity)

Req. code

Area

Scope

Client

Middleware

Application Server

Database Server




Reliability (e.g SLA, Required Uptime Objectives)

Req. code

Factor

Limits




Scalability

Req. code

Description

Limits



Portability

Req. code

Level

Platforms




Reusability

Req. code

Level

Strategy


Testability

Req. code

Testing facility

Limits



Management

Req. code

Factor

Scope

Strategy

Profiling

Dynamic management

Static management



User Interface

Req. code

Factor

Limits



<<<Any other non-functional requirement will be included here. A requirement code will be attached to every requirement. These other non-functional requirements may include:

  • Internationalization

  • Accessibility (support for the handicapped)

  • Interoperability

  • Special technologies (such as support for Kiosk multimedia)>>>


Other Requirements

Req. code

Description




    1. Requirement Dependencies

<< ML >>


<<<This section describes the dependencies between requirements. This may be represented by one of the following options:

  • A dependencies diagram (where every requirement is a node, and an arrow indicates a dependency)

  • A matrix (requirements vs. requirements) indicating the type of dependency.

Requirement1

Requirement2

Requirement3

Requirement…






Requirement1

****

Requirement2

****

Requirement3

****

Requirement4

****


The text inside the box linking two requirements may indicate or describe the type of dependency.>>>

APPENDICES

<<<Appendices should be included when any further detail is required.


Examples that could occur include:


  • References to related documents

  • More detailed information on the business modelling

  • Related business volume or background for estimates

  • Additional matrices that may help define the current or required system(s)

(Samples given below)>>>


Business Unit/Function Matrix


Function

Dev MKT Campaign

Track MKT Share

Bill Customers

Track Customer Satisfaction


















Business Unit























Billing




X



















Marketing


X

X




















Customer Service





X





























































































































































Function/Location Matrix


Location

Bedford (USA)

NYC (USA)

London (UK)

Dublin (IRE)

Boxborough (USA)


















Function
























Bill Customers






X


















Market Service


X




X


















Develop Product


X

X

X

X