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
- 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.>>>
- 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.>>>
- 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.>>>
- 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 :>>>
- 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)>>>
- 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.>>>
- High-level Information View
<< SML >>
<<<The high-level information view shows the relationship between
Interaction devices
Data stores
Business functionality>>>
- 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.>>>
- High-level Technology View
<< SML >>
<<<This high-level view shows the physical infrastructure where the application will execute.>>>
- 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.>>>
- 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>
| |
Life Expectancy | <until date> or years mm/dd/yyyy | |
Limitations | <known limitations>
| |
Advantages | <good points >
| |
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>>>
- 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>>>
- 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>>>
- 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>>>
- 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.>>>
- 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> |
| | |
- 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.>>>
- 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.>>>
- 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 |
- 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 |
- 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.>>>
.
- 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 |
| | | | |
- 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 |
| |
- 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)>>>
| Function | Dev MKT Campaign | Track MKT Share | Bill Customers | Track Customer Satisfaction | | | | | | | | | | | | | | | | | |
Business Unit | | | | | | | | | | | | | | | | | | | | | | |
Billing | | | | X | | | | | | | | | | | | | | | | | | |
Marketing | | X | X | | | | | | | | | | | | | | | | | | | |
Customer Service | | | | | X | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | |
| 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 | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | | | | |