详细设计说明书模板.docx
- 文档编号:10145810
- 上传时间:2023-02-08
- 格式:DOCX
- 页数:23
- 大小:172.81KB
详细设计说明书模板.docx
《详细设计说明书模板.docx》由会员分享,可在线阅读,更多相关《详细设计说明书模板.docx(23页珍藏版)》请在冰豆网上搜索。
详细设计说明书模板
项目名称
详细设计说明书
文档编号:
CRB_QA_DDD_TMP
文档信息:
详细设计说明书模板
文档名称:
文档类别:
质量管理模板
密级:
机密
版本信息:
1.0
创建人:
侯智勇
审核者:
批准人:
批准日期:
保管人:
存放位置:
编辑软件:
MicrosoftOffice2007中文版
CONFIDENTIAL
文档修订记录
版本编号或者更改记录编号
*变化
状态
简要说明(变更内容和变更范围)
日期
变更人
批准日期
批准人
V1.0
A
新增
2010-12-7
侯智勇
*变化状态:
A——增加,M——修改,D——删除
文档审批信息
序号
审批人
角色
审批日期
签字
备注
目录
第1章引言1
1.1文档用途1
1.2阅读对象1
1.3名词术语1
1.4参考资料1
第2章概述2
2.1系统概述2
2.2系统功能定义2
2.3设计约束2
第3章总体结构说明3
3.1子系统结构3
3.2模块程序构件结构图4
第4章数据模型(DataModel)设计6
4.1逻辑实体模型6
4.2表结构(物理设计)7
4.3视图列表9
第5章功能实现说明10
5.1业务处理类模块10
5.2数据流类模块14
第6章面实现说明17
6.1模块117
6.2模块217
第1章引言
1.1文档用途
【内容】
说明此文档的主要用途。
【裁剪原则】
此部分内容不允许裁剪。
1.2阅读对象
【内容】
此文档将适合哪些人员阅读。
如:
●产品设计工程师
●产品开发工程师
●产品测试工程师
●其他相关人员
【裁剪原则】
此部分内容不允许裁剪。
1.3名词术语
【内容】
在该份文档中,为使阅读者对使用到的名词术语有一个概念性的理解,需要对一些名词进行解释。
【裁剪原则】
如果没有特别生疏的术语,此部分内容允许裁剪掉。
1.4参考资料
【内容】
列出该文档编写时的主要参考资料。
主要包括:
规范、《客户需求规格说明书》、老产品设计文档、其他子系统的设计文档等。
【裁剪原则】
如果没有参考其他资料,此部分内容允许裁剪掉。
第2章概述
2.1系统概述
【内容】
说明此子系统“是什么”。
【裁剪原则】
此部分内容不允许裁剪。
2.2系统功能定义
【内容】
说明此子系统实现的主要功能,可逐条说明。
【裁剪原则】
此部分内容不允许裁剪。
2.3设计约束
【内容】
从《产品需求规格说明书》中提取需求约束。
例如:
●系统应当遵循的标准或规范
●客户实际的软件、硬件环境条件的约束
●接口/协议的约束
●软件质量的约束:
稳定性、可靠性、性能等。
【裁剪原则】
此部分内容不允许裁剪。
第3章总体结构说明
3.1子系统结构
3.1.1系统内外部关系图
【内容】
采用如下图所示的模式表述下面两层关系:
●内部功能模块构成
●与外部模块的接口关系
【裁剪原则】
此部分内容不允许裁剪。
注:
此图为举例:
3.1.2功能模块简要说明
【内容】
对诸功能模块完成的功能做简要说明。
【裁剪原则】
此部分内容不允许裁剪。
3.1.3依赖的外部接口
【内容】
说明各模块依赖的外部接口是什么,输入参数、输出参数、返回值等。
【裁剪原则】
此部分内容不允许裁剪。
3.1.4对外提供的接口
【内容】
说明各模块对外提供的外部接口是什么,输入参数、输出参数、返回值等。
【裁剪原则】
此部分内容不允许裁剪。
3.2模块程序构件结构图
【内容】
详细描述程序构件结构图,并做文字说明。
一般是有如下两种情况需做此描述:
●非中间件服务结构的后台处理进程模块(一般是异步操作等)
●在前台交互式操作的模块中,引入了非中间件服务结构的部件;
【裁剪原则】
若不存在上述情况,此部分内容允许裁剪掉。
注:
此图为举例:
第4章数据模型(DataModel)设计
4.1逻辑实体模型
【说明】
该部分的设计和开发,对于数据库环境、数据库表、字段命名规则等,应遵循《数据库设计规范》进行。
对规范有例外应用的情况,需在此说明。
4.1.1实体模型1
【内容】
描述本子系统核心的实体关系模型。
如下图所示。
要求做到:
●描述每一个实体的作用,指定实体标识(ID)
●对每一个relationship都要有说明,同时严格注意Mandatory(是否必须),Cardinality(几对几关系)
●ER图中的每个表中应有表名、主键字段名、重要字段名等信息。
重要字段虽然不是ER图本身必须的,但可以更利于理解表的属性和关系。
【裁剪原则】
此部分内容不允许裁剪。
注:
此图为举例:
4.1.2实体模型2
【内容】
如果有多个实体模型,需要按照上述的方式,诸一说明。
4.2表结构(物理设计)
【内容】
此部分主要设计表结构。
一般地,实体对应于表,实体的属性对应于表的列,实体之间的关系成为表的约束。
逻辑设计中的实体大部分可以转换成为物理设计中的表,但是他们并不一定是一一对应的。
【裁剪原则】
此部分内容不允许裁剪。
可以单独提供一份该子系统的表结构设计说明文档。
按照如下内容组织。
4.2.1表汇总
序
号
子系统
表名
中文名称和简单描述
使用
方式
1
OBS-CS
OB_CM_CUSTOMER
客户信息表
公用
2
……
……
……
3
……
……
……
……
4
5
6
注:
使用方式分为:
公用(所有子系统均可访问)、自用(仅本子系统可访问)、临时。
4.2.2OB_CM_CUSTOMER
表名客户基本信息
中文名
所属子系统
日期
建表人
字段名称
中文说明
字段属性
字段长度
空值标志
备注
索引
【说明】
表的字段的来源包括:
●ER图中的关系(参考逻辑实体模型);
●ObjectModel设计(参考ObjectModel设计);
建议在简单描述前书写“--”,这样整体表格可以被拷贝用作创建表的脚本,包括注释。
使用PowerDesigner等自动设计工具的用户,可使用抓图等功能将表结构粘贴于此。
【说明】
“外部引用”指引用其他表的数据,但为设为主键的字段。
主键、外键、外部引用、索引、触发器等的来源包括:
●ER图中的关系(参考逻辑实体模型);
●ObjectModel设计(参考ObjectModel设计);
约束来源包括:
●字段描述。
4.3视图列表
序
号
子系统
视图名
相关表
使用
方式
描述
1
OBS-CS
V_Order
OB_CM_CUSTOMER,
OB_CM_ODER
自用
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
注:
使用方式分为:
公用(其他子系统可访问)、自用(仅本子系统可访问)、临时。
第5章功能实现说明
【说明】
本章对每个功能模块中的每一个功能点做实现说明。
有两类主要的应用:
以数据流为核心的,处理流程是重点;以业务操作为核心的,后台业务模型、前台展现模型是重点(强调用对象模型设计)。
下面用不同的章节分别给出这两类应用的设计文档模板。
5.1业务处理类模块
【说明】
该类模块的特点是:
需要提供对象接口(ObjectInterface),对象模型是重点。
5.1.1ObjectModel设计
5.1.1.1功能点1实现说明
5.1.1.1.1SequenceDiagram
【内容】
所需功能的序列图。
如果包含多个业务操作,应绘制多幅序列图,原则是:
●尽量覆盖到对象参与此功能的所有方法;
●如果某个业务操作非常简单(例如两个对象、三次调用),可以用文字简单描述;
5.1.1.1.2实现说明
【内容】
功能点实现说明包括以下一些内容:
●主要实现方法说明
●操作了哪些数据库表的哪些字段
如:
Object1.GetData():
DB_customer.name,ID,DB_ADSL.*.
【裁剪原则】
此部分内容不允许裁剪。
5.1.1.2功能点2实现说明
【内容】
如果有多个功能点,需要按照上述的方式,逐一说明。
5.1.2程序设计
5.1.2.1交易功能1名称
5.1.2.1.1功能说明
处理贷记卡存款及取消
5.1.2.1.2交易限制
使用者:
不限
能否可以做反交易:
可以
5.1.2.1.3输入要素
贷记卡特约商户手工押单录入2429
流水号
卡号
商户号
终端号
授权码
营业网点号(手工单录入时的网点号)
录入操作员(手工单录入时的操作员)
币别
金额
5.1.2.1.4数据检查
字段
中文名称
数据长度
数据类型
缺省值
检查逻辑
Icurcd
币别
3
X
012
必须输入
itxamt
交易金额
10.2
N
输入值大于1.00小于99999999.99
5.1.2.1.5CLIENTSERVER数据界面
字段
名称
长度
取值
TITABASICLABEL
HTRMSEQ
取消终端机号
2
HEJFNO
取消日志序号
6
取消时原始交易流水号
OPNBR
开户行
5
本行行号
KINBR
交易行
5
本行行号
TRMSEQ
终端机号
2
EJFNO
日志序号
6
TASKID
程序类别
2
UT
TMTYPE
终端类型
1
0
APTYPE
交易类型
1
T
TXNO
交易代码
4
2429
PTYPE
处理形态
1
0
DSCPT
科目摘要
3
输入值
HCODE
取消标志
1
取消时为1
ACTNO
帐号
15
“”
SEQNO
帐户序号
TXTYPE
帐务类别
2
00
MULTTX
连动标志
1
系统变数
CRDB
借贷标志
1
2
SUPINIT1
主管标志1
2
系统变数
SUPINIT2
主管标志2
2
系统变数
REASON
主管许可理由
6
000
TLRNO
操作员号
2
系统变数
CASHIER
出纳号码
NBCD
无折交易标志
1
0
TRNMOD
训练模式标志
1
SBTMOD
代登模式标志
1
CURCD
币别
3
012
XCRT
汇率
8
VOCNO
存单号
7
“0000000”
TXAMT
交易金额
12
SUPCODE
主管代码
6
SUPPASSWD
主管密码
6
TITATEXT
custid
商户编号
5
custmno
商户手工押单机号
6
cutlrcd
商户操作员号
6
cardno
卡号
16
idtype
证件种类
1
idno
证件号码
20
Icurcd
币别
3
itxamt
交易金额
10.2
5.1.2.1.6处理流程
初始化程序变量-ict2429_Initial()
初始化表结构:
CDTABHTR(手工押单表)
初始化开关:
卡流水、帐务流水、总帐、柜员帐
●ict2429_Verify()
检查流水号、卡号、金额、商户号、终端号、授权日期、营业网点、操作员、授权操作员、授权号
取消交易检查:
本笔交易日必须为当前系统交易日。
●ict2429_Process()
1.更新手工押单文件CDTABHTR
●帐务处理(分录):
取款金额(A)=X,备用金户可用余额=Y,T=X-Y
发生贷款时的分录
借:
中间科目
贷:
特约商户
准备交易日志文件记录
记帐务流水:
actno、addr、name、curcd、avbal、text_len
记卡流水:
cardno、actno、accnum、listnu、cdseq、txamt、dscpt、txtype、tmtype、fee、ctlflag、tmtype、goldtype、diffplac、txtype
准备输出数据-ict2429_PutMsg()
输出TOTA开户信息
流水号
卡号
商户号
终端号
币别
金额
5.1.2.1.7SERVERCLIENT数据界面
TOTATEXT
字段
中文名称
长度
说明
F2429
Name
持卡人姓名
30
idtypew
申请人证件种类的文字形式
6
gtlsrno
帐务交易流水号
6
Gtlrcd
授权柜员号
6
txdate
授权日期
8
kinbr
授权机构码
5
autnum
授权号
8
5.1.2.1.8输出要素
●显示
卡号
金额
商户号
终端号
申权日期
申权时间
营业网点号
营业人员号
授权码
5.1.2.1.9本交易所涉及到的库表
●贷记卡管理档(卡登记簿)cdm
●贷款分户文件cccmr
●备用金分户文件ccsmr
5.2数据流类模块
【说明】
该类模块的特点是:
接口通常是数据文件或XML的形式,接口文件内容比较稳定。
5.2.1数据流程图
【内容】
用数据流图(DataFlowDiagram-DFD)描述该功能模块总的数据流图。
并给出文字说明。
例如缴费管理模块总体数据流图:
【裁剪原则】
此部分内容不允许裁剪。
注:
此图为举例:
5.2.2实现说明
5.2.2.1功能点1实现说明
【内容】
功能点实现说明包括以下一些内容:
●功能定义
●处理流程
●业务规则(什么条件下能做什么事情,什么条件下不能做什么事情)
●其他说明
对“处理流程”,有两种图示方式:
1)流程图方式(FlowChart);2)UMLSequenceDiagram方式。
下图是一个缴费退费处理流程图方式示例。
【裁剪原则】
此部分内容不允许裁剪。
注:
此图为举例:
5.2.2.2功能点2实现说明
【内容】
如果有多个功能点,需要按照上述的方式,诸一说明。
5.2.3程序设计
5.2.3.1类定义
【内容】
说明类的定义,包括属性、接口函数等。
【裁剪原则】
此部分内容不允许裁剪。
5.2.3.2数据结构定义
【内容】
给出数据结构或数据元素(变量)的特性,包括名称、标识符、数据类型和格式、值的有效范围,并给出定义性描述,最好能用类C语言给出类型说明。
【裁剪原则】
此部分内容不允许裁剪。
5.2.3.3目标文件定义
【内容】
说明该模块将提供哪些包(.So,.jar等)。
【裁剪原则】
此部分内容不允许裁剪。
5.2.3.4接口定义
【内容】
重点描述接口文件格式、接口方式(批处理、逐条;本地、远程;远程提供传输方式等)。
【说明】
该部分内容参见《OpenBoss概要设计说明书-××子系统接口定义(模板)》。
【裁剪原则】
此部分内容不允许裁剪
第6章面实现说明
6.1模块1
【说明】
界面的设计和开发需参考《用户界面设计规范》进行。
6.1.1总体界面结构(业务操作区)说明
【内容】
可以用图示辅助说明,可以用网页、C++BuilderForm等说明如下内容:
●有哪些界面
●界面的主要风格,构成元素
●界面流转
【裁剪原则】
此部分内容不允许裁剪。
6.1.2功能点1界面结构说明
【内容】
从本节开始,对一些关键的、重要的、关系复杂的功能点界面予以特殊说明。
对那些单一Form即可完成功能的就不用单独描述。
定义清楚View/Form、ViewFlow、Drilldown等。
6.1.3功能点2界面结构说明
【内容】
内容同上。
6.2模块2
同模块1
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 详细 设计 说明书 模板