信息技术系统设计报告编写规范.docx

该【信息技术系统设计报告编写规范 】是由【1772186****】上传分享，文档一共【18】页，该文档可以免费在线阅读，需要了解更多关于【信息技术系统设计报告编写规范 】的内容，可以使用淘豆网的站内搜索功能，选择自己适合的文档，以下文字是截取该文章内的部分文字，如需要获得完整电子版，请下载此文档到您的设备，方便您编辑和打印。信息技术系统设计报告编写规范
系统设计报告编写规范
文件编号:
NW506101
生效日期:
2004-2-20
受控编号:
密级:秘密
版次:
修改状态:
总页数
19
正文
4
附录
15
编制:张俊岭、郑泽梅
批准:
中科海鑫信息技术有限公司
(版权所有,翻版必究)
Introduction介绍
描述这个文档的编写目的;
描述这个文档的适用范围;
描述这个文档的读者;
确定这个系统/产品的名称与/或者版本号;
定义重要的术语、缩写词或者缩略语;
总结(或者给出一个概要)这个文档的内容。
2.
SystemOverview系统概述
对软件系统的通常性描述,包含系统的功能与其他与设计有关的内容。
DesignConsiderations设计上的考虑
本节描述在完成一个完整的设计解决方案之前务必阐明或者解决的问题。
AssumptionsandDependencies假设与依靠有关的软件与硬件
操作系统最终用户特征
在功能上可能发生的变化
GeneralConstraints通常限制描述对软件系统的设计有重要影响的全局限制或者约束。
硬件或者软件环境;最终用户环境;
资源的可用性与挥发性;标准的兼容;(option)
协同工作的要求;接口/协议的要求;
数据储存与公布要求;安全性的要求(或者其它类似的规则);
内存与其它的容量限制;性能要求;
网络通信;(option)验证与确认的要求(测试);
其他质量目标的要求;在需求分析说明书中所描述的其它要求。
GoalsandGuidelines目标与指导方针描述所有支配软件系统设计的目标、指导方针、原则或者者优先权。
尽量保持它简单易用;强调速度与内存使用的矛盾;
象像对待一个已经存在的产品那样工作、观察或者者体会。
DevelopmentMethods开发方法简要地描述用于软件设计的方法。假如使用正式/已公布的方法,那么就要对这些方法进行全面描述,同时还要简单解释一下为什么使用这个方法或者其中的某些部分。
ArchitecturalStrategies体系结构策略
描述所有影响整个系统的组织与结构的设计决定与/或者策略,这些策略深入描述系统体系结构所使用的关键技术与机制O关于每个设计决定与/或者策略都要描述其产生原因(可能要引用前面阐述的设计目标与原则),与它们是如何得到均衡与折中的,涉及内容:
使用特定类型产品(编程语言、数据库、函数库等);
重用现有组件;
软件未来扩展与升级的计•划;
用户接口模型(或者系统的输入与输出模型);
硬件或者软件接口模型;
错误检测与恢复;
内存管理策略;
外部数据库与/或者数据存储管理与保护;
网络上分布式数据或者操纵;
操纵的通常方法;
并发与同步;
通信机制;
其它资源的管理。
每一个被使用的重要战略务必在相应的子章节内加以讨论。
SystemArchitecture系统体系结构
在本节应该在一个较高的层次来说明如何将系统的功能划分给各个子系统或者组件,不要涉及这些组件本身的细节(后面有一个小节专门来全面描述组件)。本节的要紧目标是描述系统是如何进行分解、这样分解的原因与各部分是如何协作工作以完成预定功能。在较高的层次上描述系统所要承担的要紧工作责任、系统所扮演的各类角色;描述如何将系统划分成各个组件/子系统,每个组件/子系统的作用是什么;描述高层组件之间是如何协调工作已完成预期的功能;进行系统分解时所使用的基本原则;能够使用图表、模型、流程图等形式来描述上述内容。
SubsystemArchitecture子系统的体系结构
建立一个子章节来全面描述某一组件的作用,进一步描述该组件是如何分为子组件的与各个子组件之间的关系。
PoliciesandTactics政策与实施策略
描述影响系统的接口细节与系统实现细节的各个方面:
选择特定产品来使用(如编译器、解释器、数据库、函数库等);
工程上的折中;
编码规范与惯例;
一个或者多个子系统、模块或者子程序的协议;
选择某一特定算法或者编程用语来实现系统的一部分;
功能性说明;
保证需求可回溯性的计划;
软件测试计划;
软件保护计划;
最终用户、软件、硬件与通信的接口;
将源代码按照物理形态(文件与路径)进行分层组织;
如何构造与/或者产生系统的交付物(如何编译、链接、加载等)。
以上各项内容务必有相应的子章节进行讨论。假如还有其他方案可供选择时,要说明你没有选择这些方案的原因。能够使用图表、模型、流程图等形式来描述上述内容。
DetailedSystemDesign全面设计
在系统体系结构中所描述的绝大多数组件需要在本章节进行更深一步的讨论,同样,其它低层的组件与子组件也需要描述。为每个组件建立一个子章节来全面描述组件,包含下列内容:
Classification分类组件的种类,比如是一个子系统、模块、类、包、函数、文件等等。
Definition定义组件的确切用途与语义。可能需要参照需求说明。
Responsibilities责任
该组件的要紧责任与/或者行为,要完成什么?扮演什么角色?给客户提供哪写服务?可能需要参照需求说明。
Constraints约束
与该组件有关的任何假设、限制、或者者约束,如时间、存储或者组件状态,还可能包含与该组件进行交互的规则(前提条件,后置条件,不变量,其它在输入与输出值、局部或者全局值上的限制,数据格式与数据存取,同步,例外等)。
Composition合成描述构成该组件的子组件及其用途。
Uses/Interactions用户/接口
描述该组件与其它组件之间的关系,如该组件被什么组件所使用?该组件使用了什么其它组件?这关系到所使用的交互作用的方法。面向对象的设计务必描述那些已知的与预期的子类、超类与元类。
Resources资源
描述这个组件所管理的、影响的与使用的所有资源,如内存、处理器、打印机、数据库或者软件库,要描述可能存在的资源竞争、死锁等情况与相应的解决方案。
Processing过程
描述该组件的执行过程,包含所使用的算法、状态的变化、有关的时间或者空间的复杂性、并发、创建方法、初始化、清除与例外情况的处理。
Interface/Exports界面/出口
描述该组件所提供的服务,如资源、数据、类型、常量、子程序与例外等集合,明确定义每一个服务元素,即分类、定义、责任、约束、组合、使用、资源、处理与接口的描述。
.1DetailedSubsystemDesign全面子系统设计
在本章节内对该组件进行更全面描述,可使用一些复杂的图表来显示组件结构、行为、或者者信息/操纵流。
Glossary词汇表
列出在文档中所定义的术语与概念。
Bibliogr叩hy参考书目
一个参考书目与/或者有关出版物的列表。
Objectives目标
描述系统设计报告的内容与目的。
Scope范围
适用于指导包含设计阶段的项目编写系统设计报告。
References参考OutstandingIssues尚存要紧问题
Approvals批准
R&D单位负责人Responsibilities职责
开发部长对系统设计报告进行审核;
项目管理部门组织对系统设计报告进行评审;
设计人员提交符合本指南的系统设计报告。
设计人员对设计阶段的文档进行配置管理。
Template模板
Introduction绪论•项目概述;
•所设计的产品的概述。
SystemDescription系统描述
SupportforRequirements对需求的支持•设计满足需求的程度;
•设计未能完全满足的需求及其原因。
SystemPurpose系统目标
简述所开发的系统,假如本系统同其他系统有不论是手工还是计算机方面的关系,也要描述。可参考需求分析报告的内容。
InputsandOutputs输入与输出全面描述系统的所有输入与输出,包含界面设计、报表设计,参数格式。
Functions功能描述系统所提供的所有功能。
Storeddata数据存贮简述系统的数据文件。
Securityandbackup安全与备份系统在安全与备份方面的考虑与设计,包含回滚与恢复。
Exceptionhandling例外处理
系统产生的所有错误信息的列表,包含错误发生的条件与所采取的措施。所有例外情况的列表,与系统所采取的措施。
Impactassessment影响评估描述系统对现有环境的重要影响,如工序的变化,工作量的变化与硬件的变化。
能够参照需求分析报告的内容。
UserProcedures用户规程
Systemnavigation系统导航描述那些使用户能充分使用系统的规则;
Routine例程•描述在正常工作环境下,系统预期的使用方法;
•使用流程图来描述例程,流程图要带有辅助描述,描述那些使用每个功能的用户的类型。
Exception例外处理描述系统在特殊情况下所使用的处理方式,如网络失效时的数据恢复。
Installation安装描述系统的安装过程。
Systemarchitecture系统结构
Designprinciples设计原则描述系统设计所使用的策略,如用户界面的形式,所使用的标准产品等。
Designrationale设计原理•描述进行设计的根据,如数据库结构等;
•模块调用原理:是内部还是外部,是修改还是重建或者重用。
Softwarecomponentsandinterfaces软件组件与接口描述系统中的要紧组件,包含它们之间传递的包与数据流;
数据流图与功能分解图;描述所引用的外部模块。
Capacityrequirements系统资源需求估计系统容量等需求的临界值,如内存、磁盘空间与、传输速率等。
Systemstructure系统结构描述系统的各模块是如何连接在一起工作的。
Data数据
Definitions定义对系统中包含的所有数据项的描述。
Databasedesign数据库设计对逻辑数据库/文件设计的描述;
对物理数据库/文件设计的描述;数据校验规则。
Calculations算法•定义系统所使用的计算或者算法;
•确定实现这些算法的流程。
Datamanagementprocedures数据管理程序描述对系统数据的管理流程,如存档等。
Modulespecifications模块说明全面描述每个模块的逻辑、功能或者每个模块的所有状态、与其他模块的关联、状态的变迁、存在的条件及采取的动作;
使用简洁、标准的语言;说明每个模块的输入与输出。
Physicalenvironment物理环境描述建立与运行系统所需要的物理环境。
Appendices附录•数据流图
•数据模型
项目名称:项目编号:
序号
内容
Yes
No
不适用
1
整个系统组织很清晰,并包括一个良好的体系结构概述和verification
2
对模块进行明确定义,包括模块的功能说明和与其它模块的接口说明
3
包含需求分析报告中列出来的所有功能
4
主要的数据结构被调用函数隐藏起来了
5
描述数据库的组织结构和内容
6
描述并验证所有关键的算法
7
定义了用户接口的关键方面
8
包括一致的错误处理策略
9
将错误信息清晰、简洁地反映在用户界面上
10
体系结构的设计可以适应可能发生的变化
11
作为实现系统的程序员,你对这个体系结构感到满意
12
描述了处理用户输入的策略
13
清晰地阐述了系统的主要目标
14
所有主要的数据结构都有描述过并通过verification
15
描述并验证所有主要的对象
16
用户接口都被模块化以使其内部的变化不对程序的其它部分产生影响
17
对内存的使用事先作了估计并对内存管理策略进行了描述和verification
18
在体系结构中对每个模块的空间和速度作了预算
19
描述了字符串的处理策略,在其中包括了对字符-字符串存储的估计
20
描述并验证了对I/O处理的策略
21
描述了系统的健壮程度
22
包括必须购买的工具以及进行BUILD的决定
23
存在某一个部分不在体系结构描述之内
24
体系结构在概念上是一个整体
25
设计独立于机器和实现语言
26
所有重要决定都具有相应的动机
27
谁是这个特性的用户
28
用户如何使用这项特性?用户如何了解这项特性?方式直观明显吗?
29
用户使用这项特性的动机是什么?
30
用户对用户接口的看法如何?UI的逻辑流程是什么?用户期望的结果是什么?
31
如果用户在使用这项特性时没有成功地达到目标会发生什么?他(她)能做什
32
实现这个特性(或完成一个任务)之后,用户返回到合适的位置继续工作了吗?
33
特性或过程的出口明显吗?如果用户错误地激活了该项特性后能容易地退出和返
34
这个特性可以Undo吗?
35
还有其它的方法可以实现这个特性吗?如果有是什么?
36
用户要使用这个特性时需要了解哪些东西?是不是你不能奢望用户要掌握的?
37
有多少是用户必须去做但与关键任务(也可称为第一号工作)无关的任务?
38
两个类似过程间的对话框看起来是致的吗?
39
是否同一个对话框用于多个任务?对话框的名称和选项按钮的名称随着任务而变
40
用户愿意把这个特性与其它特性或过程结合起来吗?
41
这个特性或过程与本产品或相似产品中的其它特性或过程保持一致性?
42
有其它的开发队伍在进行相关的特性或过程的开发?两支开发队伍的工作协调一
43
要对该特性或过程进行修改以适应国外市场
44
对了不同语言环境,该特性需耍做相应的变化
45
在将来不同的版本以不同的方式来实现这个特性
总分:
注:1-11项,Yes(+6分),No(-6分);其他各项,Yes(+1分),No(-l分);不适用0分。
审核人/日期:批准人/日期: