详细设计说明书模板.docx

详细设计说明书模板.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