Professional Documents
Culture Documents
Disclaimers
The information contained in this document is the proprietary and exclusive property of XXX except as otherwise indicated. No part of this document, in whole or in part, may be reproduced, stored, transmitted, or used for design purposes without the prior written permission of XXX. The information contained in this document is subject to change without notice. The information in this document is provided for informational purposes only. XXX specifically disclaims all warranties, express or limited, including, but not limited, to the implied warranties of merchantability and fitness for a particular purpose, except as provided for in a separate software license agreement.
Privacy Information
This document may contain information of a sensitive nature. This information should not be given to persons other than those who are involved in the Project Name project or who will become involved during the lifecycle
Trademarks
[Trademarks are added here]
Version History
REVISION CHART Version Author(s) Description of Version Date Completed
Preface
Document Owner
The primary contact for questions regarding this document is: Author: Project Name Phone: Email:
Document Approval
Document Name: Publication Date: Contract Number: Project Number: Prepared by:
Approval:
__________________________
Concurrence:
_________________________
ii
Preface
Table of Contents
Introduction 1.1 Purpose of this document 1.2 Document Overview 1.3 Identification 1.4 Scope 1.5 Relationship to Other Plans 1.6 References 1.7 Methodology, Tools, and Techniques 1.8 Policies, Directives and Procedures 1.9 Key Stakeholders 1.10 Points of Contact Design Overview 2.1 Background Information 2.2 System Evolution Description 2.3 Technology Forecast 2.4 Application Overview 2.5 Current Process 2.6 Proposed Process 2.7 Business Context 2.8 Constraints 2.9 Risks 2.10 Issues 2.11 Assumptions 2.12 Dependencies Scope of Work 3.1 System-wide design decisions 3.2 System Functions 3.3 Similar System Information 3.4 User Characteristics 3.5 User Problem Statement 3.6 User Objectives 3.7 Performance Requirements 3.8 Security Requirements 3.9 Hardware Interfaces 3.10 Communications Interfaces
7 7 7 7 7 8 8 8 8 8 8 9 9 9 9 9 9 9 10 10 10 10 11 11 12 12 12 12 12 12 13 13 13 13 13
iii
Preface
3.11 3.12 3.13 3.14 3.15 3.16 3.17 3.18 3.19 3.20 3.21 3.22 4
Software Interfaces Design Constraints Data Dictionary Data Analysis Output Specifications Decision Tables Logical Database Model Data Conversion Value Definitions External System Dependencies Data Validation Data Migration and Transformation
13 13 14 14 14 15 15 15 15 16 16 16 17 17 17 17 17 17 17 18 18
18 18
System Design 4.1 System Architecture 4.2 Modules and Interaction 4.3 Data Design 4.4 Internal Data Structure 4.5 Global Data Structure 4.6 Temporary Data Structure 4.7 Database description 4.8 Object-Oriented Design
4.8.1 4.8.2 Object Decomposition Method Decomposition
4.9 5
Procedural Approach
18 19 19
19 19
5.2
19
19 19 19
5.3
20
20 20 20
5.4
[Module X]
5.4.1 5.4.2
21
21 21
6
iv
Interface Design
22
Preface
6.1 7
Interface Description
22 25 25
25 25 25
7.2 7.3 8
25 25 26 26 26 26 26 26 27 27 27 27 27 28 28 28 28 28 28 28 29
29 29
Non-Functional Requirements 8.1 Performance 8.2 Security 8.3 Licenses 8.4 Language 8.5 Others Testing 9.1 Test Plan Objectives 9.2 Test Strategy 9.3 System Test 9.4 Performance Test 9.5 Security Test 9.6 Automated Test 9.7 Stress and Volume Test 9.8 Recovery Test 9.9 Documentation Test 9.10 Beta Test 9.11 User Acceptance Test 9.12 Environment Requirements
9.12.1 9.12.2 Data Entry workstations MainFrame
9.13 9.14
29 29
29 29 30 30
9.15 9.16 10
30 30 31 31
v
Preface
31 31 32
32 32 32
10.5 10.6
32 32
32 32 32 32 33
10.7 10.8 11
Documentation Approvals
33 33 34 34 34 34 34
Appendices 11.1 Requirements Traceability Matrix 11.2 Packaging and Installation 11.3 Design Metrics 11.4 Glossary of Terms
Index of Tables
Table 1 Risks Table 2 Issues Table 3 Assumptions Table 4 Dependencies Table 5 Data Analysis Table 6 Decision Tables Table 7 Value Definitions Table 8 External System Dependencies Table 9 Roles and Responsibilities Table 10 Schedule Table 11 Approvals Table 12 Glossary of Terms 10 10 11 11 14 15 15 16 30 31 33 34
vi
Preface
1 Introduction
Provide a brief introduction to the system for which this design is being undertaken.
1.3 Identification
Include a full identification of the system and software to which this document applies, including, identification number(s), title(s), abbreviation(s), version number(s), and release number(s). Identify all standards (ANSI, ISO, IEEE, etc) that apply to the design document.
1.4 Scope
Describe the scope of the design document (and also what is outside of scope); scope of the requirements definition effort and outline the requirements elicitation team, e.g. users, customers, and developers.
Copyright XXX.
1.6 References
List any documents that are related to the document, e.g. technical specifications and administration guides. Include the version number, if appropriate.
2 Design Overview
Give a brief introduction to the proposed system or application. Outline how the system will fit into the companys business and technology environments, and discuss any strategic issues if appropriate.
Copyright XXX.
2.8 Constraints
Detail any constraints that were placed upon the requirements elicitation process, such as schedules, costs, or the software engineering environment used to develop requirements.
2.9 Risks
Identify the risks associated with the document, including contingency strategies.
Risk
Low
Med.
High
Contingency
Table 1 Risks
2.10 Issues
List any outstanding issues that may affect the design document.
Ref 1. 2. 3
Issue
Action
Table 2 Issues
Project Name
Copyright XXX
10
2.11 Assumptions
List all assumptions regarding the design effort. Ref 1. 2. 3 Assumption Impact
Table 3 Assumptions
2.12 Dependencies
List the main dependencies regarding the design effort. Ref 1. 2. 3 Dependency Action
Table 4 Dependencies
Copyright XXX.
11
3 Scope of Work
In this chapter, describe the business and technical requirements that the customer has requested. Outline the scope of work, including the inputs, processing functionality, and outputs.
Project Name
Copyright XXX
12
Copyright XXX.
13
Data Element
Characteristics
Behavior
Project Name
Copyright XXX
14
Field
Code
Value
Copyright XXX.
15
External System
Dependency
Project Name
Copyright XXX
16