软件开发技术文档编写规范Read.docx
- 文档编号:29534394
- 上传时间:2023-07-24
- 格式:DOCX
- 页数:19
- 大小:61.69KB
软件开发技术文档编写规范Read.docx
《软件开发技术文档编写规范Read.docx》由会员分享,可在线阅读,更多相关《软件开发技术文档编写规范Read.docx(19页珍藏版)》请在冰豆网上搜索。
软件开发技术文档编写规范Read
神州数码(中国)有限公司
秘级:
内部保密文件仅限内部使用
概要设计说明书模板
(V1.2)
文档编号:
DC-QG-23-01
文档名称:
概要设计说明书
编写:
沙存孝
编写日期:
1999.7.16
审核:
钱增祺
审核日期:
1999.7.16
神州数码(中国)有限公司
用户名称
神州数码(中国)有限公司
秘级:
项目名称
概要设计说明书
(版本号)
文档编号:
项目名称:
编写:
编写日期:
审核:
审核日期:
神州数码(中国)有限公司[项目名称]项目组
文档修订记录
序号
修改时间
修改人
审核人
备注
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
第一章引言
第一节编写目的
1.1.1作用
【说明】《概要设计说明书》是在《需求规格说明书》的基础上,通过我方与用户方反复沟通形成的。
它必须充分反映《需求规格说明书》中的用户需求,如有改动必须征得用户的认可。
它将作为项目验收时重要的的标准和依据。
从另一方面讲,它又是开发人员在下一阶段进行系统详细设计的纲领性文件,也是考核系统总体质量的重要技术文档。
1.1.2预期读者
【说明】本文档的阅读对象是软件开发人员、业务规范设计人员、软件测试人员、系统安装人员及用户代表。
第二节编写背景
1.2.1系统名称及版本号
【说明】形如“北京市地方税务局管理信息系统V3.0”。
其中,版本号的格式为“XX.XX”,X为阿拉伯数字,左“0”可省略。
1.2.2任务提出者
【说明】指《质量保证计划》中规定的我方领导机构或项目负责人。
1.2.3任务承接者及实施者
【说明】指承担概要设计的负责人及工作人员名单。
1.2.4使用者
【说明】适应对象和范围。
主要指预期读者,也供有关领导审阅。
1.2.5与其它系统的关系
【说明】在用户现有的及预期的整个应用系统中,给本系统准确定位。
用示意图及相应的文字予以说明。
第三节文档结构
【说明】章节划分原则、内容的取舍、重点的确定等。
第四节电子文档编写工具
【说明】工具名、版本号、操作系统平台。
使用多种工具时,应分别说明。
形如:
MicrosoftWord97forWindows95
Power-Designor6.0forWindows95
PhotoShop4.0forWindows95
Visio或PowerPoint
第五节定义说明与符号规定
【说明】包括对专用术语及缩略语的解释、所用到的图(E-R图/功能层次图)中图符的表示与解释、屏幕界面中图标与按钮的表示与含义等。
如在E-R图中,表示两个实体之间的关系时,我们定义了以下图符(部分举例):
终结符基数(自左至右)
1
多
终结符基数存在性说明(自左至右)
1强制必须存在且只能存在1个
多强制必须存在1个或多个
1任选可能存在1个,或没有
多任选可能存在1个或多个,或没有
第六节参考资料
【说明】格式:
作者,[版本号,]资料来源,日期[,起止页号]。
其中,《质量保证计划》与《需求规格说明书》是必选的参考资料。
第二章系统概述
第一节系统目标
【说明】开发意图、应用目标(总目标、分期目标)、作用范围、预期效益等。
第二节设计原则
【说明】设计原则应包括:
※遵照ISO9000的精神,按《联想集成系统有限公司软件开发规程文件》的要求办事。
※质量管理应贯穿于整个设计之全过程。
※对质量保证的承诺应落实到全体人员。
※实际执行的过程中,必须符合项目自身的特点,体现个性差异,切实做到有的放矢。
第三节运行环境
2.3.1硬件平台
【说明】指出本系统对硬件设备的需求、我们选型的原则和依据、推荐的型号与配置、性能综述、技术优势、特殊约定等。
2.3.2软件平台
【说明】使用操作系统的名称、生产厂家、版本号等。
使用数据库的名称、生产厂家、版本号等。
如使用了多种数据库,则要说明如何
实现互连。
其它支撑软件:
指出开发与运行时需要的工具软件的情况,如4GL等。
对于选用的各类软件,均应着重说清其技术特点、与国内外同类产品的比较,明
确阐述我方选择的理由。
2.3.3网络体系结构
【说明】写明网络设计原则、技术要求、产品选型、拓扑结构、基本部件与配件、传输介质、接口情况、通信协议、约束条件、结构化综合布线方案等。
画出网络结构图。
图中应标出各类服务器与客户机、网管机、路由器、网关等的数量与分布;应反映出局域网、广域网及其互连的情况;如使用国内的公用数据网或Internet,也须具体标出。
用文字说明各个服务器/客户机的作用、配置与具体位置。
例如:
Oracle数据库服务
器1台,位于局信息中心,用于支撑征管业务信息处理、领导决策辅助支持、各征管业务科室的信息采集、查询及统计工作。
它安装在IBMRS6000小型机上,操作系统是AIX3.2。
说明拟采取的网络保护技术,如防火墙等。
第四节应用软件整体结构概述
【说明】说明本系统的各层模块、公用模块的划分原则。
如果系统复杂而开发者又有比较多的技术积累,应说明其分层构造(如组件层、构件层与应用子系统层)。
对于大的系统,应画出体系结构图并予以说明。
第五节关键技术
【说明】本系统采用了哪些关键技术,如算法、中间件、构件等。
指出使用了那些主要工具。
解释作出上述选择的理由。
说明这些关键技术在整体结构中的位置及内外接口。
第三章数据库设计
第一节数据组织
3.1.1数据分布方式
【说明】如集中式、分布式、混合式(集中+分布)。
用图表予以描述。
3.1.2数据传输与通讯
3.1.3历史数据管理
第二节实体集列表
【说明】分系统公用实体列表与各个子系统专用实体列表两类。
形如:
系统公用实体列表
实体名称
中文注释
子系统专用实体列表
实体名称
中文注释
第三节概念数据模型图
【说明】E-R图全称为“EntityRelationshipDiagram”,即实体关系图。
本规范涉及到的主要是概念数据模型图和物理数据模型图两种。
概念数据模型(CDM,ConceptualDataModel)用于从概念层开始设计过程。
因
为在概念层,无须考虑实际物理实现的细节。
CDM描述数据库的整体逻辑结构。
它独立于任何软件或具体的数据存取结构,能
够对《需求规格说明书》中的业务需求进行形式化描述。
它的主要作用是:
①用图形方式描述数据的组织结构;
②验证数据结构的有效性;
③生成物理数据模型(PDM,PhysicalDataModel),用于详细设计阶段数据库的
物理实现。
建议使用Power-Designor6.0(或更高版本)绘制。
要求:
实体布局疏朗合理、
关系线的交叉尽量少。
属性(attribute)是实体的基本信息单位。
一个实体可以
包含许多个属性。
为使图中能表示更多的实体,容许实体只显示特性为
“Identifier”的属性。
定义实体间的关系时应包括以下特性。
基数:
一个实体连接另一个实体的数量关系(“一对一”或“一对多”,
可以从关系的两个方向分别定义)。
存在性:
指明关系是“任选的”,还是“强制的”(可以从关系的两个方
向分别定义)。
依赖性:
指明一个实体是否依赖于其它实体。
继承性:
指明“父类”与“子类”的关系。
下面的“项目管理实体关系图”是CDM图的一个例子,仅供参考。
本例中,表示依赖关系时,终结符使用了三角符号。
三角符号由依赖实体指向被
依赖实体。
实体“雇员”自身存在自反关系:
即一个雇员可能管理其他雇员或被其
他雇员所管理。
实体“资料”也有类似的情况,不再赘述。
可以把上述图形作为附录列于最后,这里仅作出概述。
第四节数据量估计
【说明】使用表格+文字的方式,对每个子系统进行估计。
形如:
子系统名:
实体名
数据总量(KB)
…
…
本子系统数据总量=
占空系数=
预计数据量=
这里,预计数据量=本子系统数据总量×占空系数
其中,占空系数表示实际开销与理论开销之比值。
其值可根据具体项目及运行环境而定,如可取1.5至2.5。
第五节数据分布方案
【说明】采用表格方式,应与数据量分布表对应。
形如:
子系统名:
实体名
保存期限(天)
存放位置
本站点
局域网服务器
广域网服务器
第六节实体与基本表的对应关系
【说明】概念对象实体(Entity)对应的物理对象为表(Table)。
在概要设计阶段,可以只产生实体,也可能产生一部分表。
这些设计中必须的、最基本的表,我们称之为“基本表”。
二者之间的对应关系,用表格简述如下:
实体名称
基本表名称
说明
第七节物理数据模型图
【说明】当概要设计已产生了某些基本表时,可产生相应的物理数据模型图,也可以在详细设计时一并产生。
产生物理数据模型图使用的工具应与产生概念数据模型图的一致。
可以把上述图形作为附录列于概要设计的最后,这里仅作出概述。
第八节数据库系统介绍
【说明】目前国际流行的大型数据库有:
Oracle、Sybase、Informix、DB2…
在本系统中,我们选用的是;
数据库厂家的名称与背景:
技术特点:
对该数据库能满足本系统需求的论证:
第四章代码设计
【说明】对某一类信息赋予代码的过程叫编码(Coding)。
信息编码(information
coding)的过程是:
□把表示信息的某种符号体系转换成便于计算机或人识别和处理的另一种符号体系。
或者
□在同一体系中由一种信息表示形式转换成另一种信息表示形式。
信息分类编码标准的产生:
参照国际标准/国家标准/行业标准,按照科学的原则对信息进行分类和编码,经有关方面协商一致,由标准化主管机构批准、发布,作为有关单位在一定范围内进行信息处理和传递时共同遵守的准则。
代码设计时应注意的几个原则:
□唯一性
□可扩展性
□简单性
□格式一致性
□适应性
□含义性
□稳定性
□识别性
□可操作性
典型的公共代码表如:
国籍代码表、行政区划代码表、邮编代码表、性别代码表、
各国货币名称代码表、税种代码表等。
各个行业与单位也可以根据自身的实际需要,设计内部使用的代码表。
出于习惯,一些人在论及“代码表”时使用了“数据字典”的提法。
第一节背景介绍
【说明】介绍有关的国际标准、国家标准、行业规范及其贯彻情况。
第二节编制说明
【说明】制定代码表的依据、格式约定、注意事项等。
第三节代码表列表
【说明】本系统使用的代码表的列表。
形如:
代码表名称
中文注释
引用本表的子系统名称
代码表1
1.…
2.…
3.…
4.…
5.…
代码表2
1.…
2.…
…
…
…
代码表N
…
此外,还应指出描述代码数据的文档名与文档编号。
第五章功能概述
第一节功能模块命名原则
【说明】指出本系统的各层模块/公用模块的划分原则、命名原则、编号原则。
第二节功能层次图
【说明】指明在输入信息转变为输出信息的过程中,为了满足用户的业务需求,应用软件必须完成的基本动作。
采用自然语言叙述+树状功能图描绘的方式。
由此确定系统最终的菜单结构。
图形的格式可参看《详细设计说明书》中的功能模块图。
第三节功能简介
【说明】用一览表或框图的形式扼要说明每个模块的编号、名称和基本功能。
用矩阵形式标明《需求规格说明书》中列出的各项功能需求与模块之间的对应关系。
形如:
模块1
模块2
模块
…
模块N
功能1
功能2
功能3
…
功能M
第四节外部接口
第六章用户界面设计
第一节基本原则
【说明】指出基本风格、屏幕总体布局和输入/输出的常规手段。
第二节设计概述
【说明】本节的内容也可以归入附录“设计与编程规范、惯例及约定”中,而不在这里
叙述。
一般地讲,界面设计应包括以下几项:
□屏幕环境设置
□字型与字体
□颜色
□提示
□菜单(Menu)
□按钮(CommandButton)
□图标
□列表框
□常用键
□DataWindows生成标准
□窗口定义
□日期类型(特别要注意解决“千年虫”问题)
□界面语言
□其它
第七章出错处理
第一节出错信息设计
【说明】扑捉出错信息、分析定位、提示信息。
第二节异常情况处理
【说明】错误处理方案与帮助手段。
第八章系统性能保障措施
【说明】依据ISO9000标准及我们的理解,下面列出了软件的6组性能,共涵盖21个子特性。
这些性能/子特性的相对重要性并不是等同的。
编写时,可以基于具体项目的实际需求,对下述标题或内容进行取舍/侧重。
与《需求规格说明书》不同,这里应着重说明:
为使系统能够达到下述性能,准备采取哪些具体措施。
参看《需求规格说明书》的相应章节。
第一节功能性
第二节可靠性
第三节易使用性
第四节高效性
第五节可维护性
第六节可移植性
附录
附录1概念数据模型图
附录2物理数据模型图
附录3代码表手册
附录4设计与编程规范、惯例及约定
【说明】这部分内容,既可以作为概要设计的一部分,也可以生成另册,还有人习惯地把它作为《详细设计说明书》的附录。
下面是一个例子,仅供参考。
第一节数据库设计规范
□原则:
做出规范的出发点、基本规律、适用范围、解释权的归属等。
□标准词汇(对表、表名、表汉字名、字段、列名、列汉字名、代码和名称、序号、数据类型、行、标志、行数、列数等词汇给予统一的解释)
□表
□视图
□序列
□存储过程
□函数
□触发器
□索引
□约束
□其它
第二节PowerBuilder编程规范
□原则
□对象命名规律
□注册机制
□Object基本原则
□控件命名规范
□变量命名规范
□函数命名规范
□注意事项
第三节用户界面规范
【说明】参见第六章。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 软件 开发 技术 文档 编写 规范 Read