详细设计说明书(模板)
- 格式:doc
- 大小:155.00 KB
- 文档页数:12
XX Low Level Design SpecificationXX 详细设计说明书Prepared by拟制Date日期yyyy-mm-ddReviewed by 评审人Date日期yyyy-mm-ddApproved by批准Date日期yyyy-mm-ddAuthorized by签发Date日期yyyy-mm-ddKonka Research Institute康佳研究院All rights reserved版权所有侵权必究Revision record 修订记录Distribution LIST 分发记录Catalog 目录1 I ntroduction 简介 (6)1.1 P urpose 目的 (6)1.2 S cope 范围 (6)2 D etailed Design 详细设计 (6)2.1 M odule 1 Detail Design 模块1详细设计 (6)2.1.1 Data Description 数据描述 (6)2.1.1.1 Simple Data Description 简单数据描述; (6)2.1.1.2 Structure 1 or Class 1 结构1或类1 (7)2.1.1.3 Structure 2 or Class 2 结构2或类2 (7)2.1.2 Function Description 函数描述 (8)2.1.2.1 Function 1 函数1 (8)2.1.2.2 Function 2 函数2 (9)Table of contents for the table表目录Table 1 XX 表1 XX 6 Table of contents for the figure图目录Figure 1 XX 图 1 XX 7XX Low Level Design SpecificationXX 详细设计说明书Keywords 关键词:能够体现文档描述内容主要方面的词汇。
目录1.引言 (2)1.1.模板说明 (2)1.2.编写目的 (2)1.3.背景 (2)1.4.参考资料 (2)1.5.术语定义及说明 (2)2.设计概述 (3)2.1.运行环境概述 (3)2.2.条件与限制 (3)2.3.详细设计方法和工具 (3)3.系统详细设计 (3)3.1.系统结构设计及子系统划分 (3)3.2.系统功能模块详细设计 (3)3.3.接口详细设计 (4)3.3.1.外部接口设计 (4)3.3.2.内部接口设计 (4)3.4.用户界面设计 (4)4.数据库系统设计 (4)4.1.设计依据 (4)4.2.数据库逻辑结构 (5)4.3.物理结构设计 (5)4.4.数据库安全 (5)4.5.数据字典 (5)5.系统配置 (5)5.1.配置原则 (5)5.2.硬件配置 (5)5.3.软件配置 (6)6.测试与文档建议 (6)6.1.测试重点 (6)6.2.文档建议 (6)7.关键技术 (6)7.1.关键技术的提出 (6)7.2.关键技术的一般说明 (6)7.3.关键技术的实现方案 (6)1. 引言1.1. 模板说明[该模板主要目的是引导组员如何进行概要设计:一般概要设计应该包括什么方面的内容,并对这些内容起到的作用进行详细说明。
组员在进行实际的应用中,可以根据情况进行裁减,不应被该模板束缚,建议至少保留第1、2、3、6章节内容。
在该文档编写完成后记得删除1.1内容。
]1.2. 编写目的[说明编写详细设计方案的主要目的。
详细设计的主要任务是对概要设计方案做完善和细化。
说明书编制的目的是说明一个软件系统各个层次中的每个程序(每个模块或子程序)和数据库系统的设计考虑,为程序员编码提供依据。
如果一个软件系统比较简单,层次很少,本文件可以不单独编写,和概要设计说明书中不重复部分合并编写。
方案重点是模块的执行流程和数据库系统详细设计的描述。
]1.3. 背景[应包含以下几个方面的内容:待开发软件系统名称;该系统基本概念,如该系统的类型、从属地位等;开发项目组名称;项目代号(项目规划所采用的代号);说明遵从的IT标准和原则,符合公司的IT ABBs。
标准文件修改页文件编号修改条款 修改内容修改人/日期生效日期全文首次发行分发部门会签详细设计说明书模板文件编号版木 A0 贞数第1页共6贞編制部门 XX 部生效日期2019年10月15日编制审核批准□业务部 □研发部 □采购部 □生产部 □质量部 □行政部标准文件修订历史记录曽加•修订删除【模板使用必读:模板内容和页眉中【】包含内容为指导性的待替换文字,请在使用中替换为具体内容, 或删除。
文件提交时不得再含有这些内容J详细设计说明书模板引言L2 L3 L4编写目的 ..... 背景 ......... 术语打缩写解释参考资料 .....模块命名规则程序系统的组织结构3. 13.2 3.3程序1 4. 1 4.2 4.3 4.4 4.5 4.6 4.7 4.8 4.94. 104. 114. 12子系统划分 ...................... 模块划分.........................程序与功能需求、系统模块间的关系(标识符)设计说明................ 程序描述 .....功能 .........性能 .........输人项 .......输出项 .......算法 .........流程逻辑 .....接口 .........存储分配 .....注释设讣 .....限制条件 .....尚未解决的问题程序2 (标识符)设计说明4 4 4 45 5 5 5 56 6 6 6 6 6 67 7 7 7 7引言编写目的【给出项U详细设il•说明书的编写U的,同时指明读者对象。
】背景【说明:a.待开发软件系统的名称: b•本项U的任务提出者、开发者、用户和运行该程序系统的计算中心。
】术语与缩写解释【列出本文件中用到的专门术语的定义和外文首字母缩写的原词组J参考资料【提示:可包括:<1)本项11经核准的计划任务书、需求规格说明书、合同、项U设计概要说明书或上级机关的批文;(2)本文档所引用的资料、规范等,列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源。
信息发布系统(详细设计说明书)编写单位:JAVA实践小学期第22组设计人员:版本: 1.0编写日期:2010/9/5目录第一部分、引言 (2)1.1编写目的 (2)1.2背景 (3)1.3定义 (3)3.1程序描述 (5)3.2整体结构 (5)3.3性能 (5)3.4输入输出项 (5)3.5算法 (5)3.6主要类的设计 (5)3.7存储分配 (7)3.8注释 (7)3.9限制条件 (7)3.10测试计划 (7)3.11尚未解决的问题 (7)4.1程序描述 (7)4.2功能 (7)4.3性能 (8)4.4输入输出项 (8)4.5限制条件 (8)5设计特点 (8)5.1 通信便捷 (8)5.2 开发速度快 (8)第六部分、项目分工 (8)附录: (9)第一部分、引言1.1编写目的本说明书在概要设计的基础上,对信息发布系统的各模块、程序分别进行了实现层面上的要求和说明。
软件开发小组的产品实现成员应该阅读和参考本说明进行代码的编写、测试。
1.2背景说明:A、软件系统的名称:信息发布系统B、任务提出者:JA V A实践小学期开发者:第22组成员C、实现完成的系统将可用在所有JA V A虚拟机的个人PC上.为使用者提供信息发布,浏览,评论的方式,沟通各个用户.1.3定义服务器端API :服务器端设计者通过规范的API文档,提供给客户端,以方便客户端的开发,使得同时进行,提高效率,节约时间。
两端通过protocol(协议类)进行通信。
Gson:Google提供的一个类库。
通过使用这个类库,可以把把对象转换成json格式的字符串,以方便在网络中的传输。
也可反向将字符串转换成对象,这样带有方法地操作对象,可以有效,方便地保证信息的沟通。
Json:JavaScript Object Notation,是一种轻量级的数据交换格式。
易于人阅读和编写,同时也易于机器解析和生成。
它基于JavaScript的一个子集,JSON采用完全独立于语言的文本格式,这些特性使得JSON成为理想的数据交换语言。
<XX系统>详细设计说明书广东创我科技发展有限公司修订记录目录第一章概述 (5)1.1.应用模块的目的 (5)1.2.应用模块总体描述 (5)1.3.应用模块接口描述 (5)1.4.假设条件 (5)第二章设计模式(Design pattern) (6)第三章类设计 (7)3.1.分块类图 (8)3.1.1.<类图1> (8)3.1.2.<类图n> (8)3.2.整体继承关系 (8)3.3.类描述 (9)3.3.1.<类名1> Class Description (9)3.3.2.<类名n> Class Description (10)第四章交互图 (12)4.1.<情景编号1: 情景名称> (12)4.1.1.交互图 (12)4.1.2.例外情况及条件 (13)4.2.<情景编号n: 情景名称> (13)第五章状态图 (14)5.1.<状态图编号1:状态图名称> (14)5.2.<状态图编号n:状态图名称> (15)第六章时序流程图 (16)第七章用户界面设计说明 (18)7.1.用户界面关系 (18)7.2.用户界面具体描述 (18)7.2.1.<界面编号1:界面名称〉 (18)7.2.2.<界面编号N:界面名称〉 (19)第八章测试考虑 (20)第九章附录 (21)9.1.附录A 代码举例 (21)9.2.附录B 设计问题 (21)9.2.1.<设计问题1> (21)9.2.2.<设计问题n> (21)第一章概述1.1.应用模块的目的请明确客户建立应用模块的目的。
1.2.应用模块总体描述描述应用模块的总体功能。
1.3.应用模块接口描述简要描述本应用模块的公共接口,具体接口会在相应的类中进行具体描述。
建议采用列表的方式。
1.4.假设条件列出在问题领域,项目方案及其它影响系统设计的可能方面内,应当成立的假设条件。
付高钢村医药管理系统项目详细设计说明书1引言1.1编写目的本说明书是医药管理系统的详细设计。
其编写目的是在概要设计的基础上,针对该项目的每个模块,每个功能的实现方法进行详细的设计和划分,按照详细设计说明书的要求,进一步明确系统结构,为项目开发人员后期的编码工作做准备。
本文档的预期的读者是:项目开发人员项目经理项目测试人员1.2背景在前一阶段的概要设计文档中,已经通过顺序图解决了该系统功能的实现流程,包括系统的各模块间的关系设计等。
本文档就是在前一阶段成果的基础上,继续对系统的各模块进行详细的划分和说明。
2概述本项目的任务提出者:见概要设计文档单位:见概要设计文档开发者:见概要设计文档用户:见概要设计文档实现该软件的计算中心或计算机网络:见概要设计文档2.1基线以需求分析和概要设计为基准。
2.2范围本概要设计文档提供给系统设计开发人员,包括详细设计人员和项目组成员。
2.3定义2.4参考资料2.5术语与缩写解释3模块命名规则驼峰标识,由单词的全拼组成,除首单词外每个单词的首字母大写,例如:medcineManager4模块汇总4.1模块汇总表5子系统模块设计5.1类别管理模块5.1.1功能描述用户登录进入类别管理页面,能进行药品类别的管理,主要包括类别的添加,修改,查看和统计。
5.1.2相关模块5.1.3类图5.1.4类别管理类5.1.4.1方法5.1.4.1.1方法—药品信息的添加:public String add()5.1.4.1.1.1功能对药品的类别信息进行添加,类别编码是类别对象的一个标示,当添加一个类别信息时,需要判断此类别是否已经在数据库中,如果存在,则提示已存在该类别。
5.1.4.1.1.2参数无5.1.4.1.1.3算法无5.1.4.1.2方法—类别信息的模糊查询:public String queryallcategory()5.1.4.1.2.1功能为了方便用户查询已有类别,类别信息管理模块提供了类别模糊查询。
软件项目详细设计说明书模板目录第一章编写目的 (4)1.1作用 (4)1.1.1 预期读者 (4)1.2背景 (4)1.2.1 系统名称及版本号 (4)1.2.2 使用者 (4)1.2.3 与其它系统的关系 (4)1.3术语和缩写 (4)1.4参考资料 (5)第二章总体架构 (5)2.1系统说明 (5)2.2运行环境 (5)2.3基本设计概念以及处理流程 (5)2.4总体功能结构图 (5)2.5子系统清单 (5)2.6可测试性、维护/升级设计 (5)2.7可配置设计 (5)2.8尚未解决的问题 (6)第三章系统功能模块 (6)3.1模块名称 (6)3.1.1模块功能描述 (6)3.1.2模块框架设计以及处理流程 (6)3.1.3子模块划分列表 (6)3.1.4子模块设计说明 (6)3.2模块名称 (6)3.2.1模块功能描述 (6)3.2.2模块框架设计以及处理流程 (6)3.2.3子模块划分列表 (6)3.2.4子模块设计说明 (7)第四章接口说明 (7)4.1用户接口 (7)4.2外部接口 (7)4.3内部接口 (7)第五章数据结构设计 (7)5.1数据库环境说明 (7)5.1.1应用环境 (7)5.1.2参数配置 (7)5.2数据库设计 (7)5.2.1逻辑设计 (8)5.2.2物理设计 (8)5.2.2.1数据表汇总 (8)5.2.2.2表结构设计 (8)5.2.3安全性设计 (8)5.2.4备份恢复设计 (9)5.3数据库管理维护 (9)5.3.1数据库安装配置 (9)5.3.2数据库日常维护 (9)第六章系统出错处理设计 (9)6.1出错信息 (9)6.2出错处理 (9)第一章编写目的1.1作用【说明】《软件概要设计说明书》是在《软件需求规格说明书》的基础上,通过我方与用户方反复沟通形成的。
它必须充分反映《软件需求规格说明书》中的用户需求,如有改动必须征得用户的认可。
它将作为项目验收时重要的的标准和依据。
附件6[XXX项目]详细设计说明书●文档属性是否●文档版本记录目录目录 (I)一、参考文档 (1)(一)相关项目文档 (1)(二)参考资料 (1)二、数据库详细设计 (1)三、接口详细设计 (3)四、公用模块(部件)详细设计 (3)五、特殊算法详细设计 (4)蓝色{}和红色{}内的内容为填写说明,请自行删除;本模板仅供参考,除必填项外,可根据项目实际情况调整。
一、参考文档(一)相关项目文档本项目交付物中其它相关文档。
例如:需求规格说明书、源程序清单、用户使用手册(二)参考资料{以如下格式提供本文档撰写过程中所参考的所有文档。
例如:科技项目相关管理办法、行内制度等。
}二、数据库详细设计(可单列成独立的文档)(一)表结构{表名(表功能说明);字段名,字段数据类型,字段宽度,精度,非空标志,缺省值,字段中文备注;主键;外键}1.CD_CARD_ARCH 卡档案表{示例表}索引: ind_cd_card_arch1(substr(“card_no”,1,length(“card_no”)-1);(二)索引(三)视图(四)存储过程(五)序列……三、接口详细设计{对通讯方式、报文结构、接口清单、详细接口字段、字段数据类型、字段长度等进行说明。
可以通过添加附件的方式进行说明。
}四、公用模块(部件)详细设计对公用模块进行详细说明。
包括模块的编号、模块名称、模块说明、详细功能分配、接口标准、输入输出、对应数据库设计等信息。
可以通过添加附件的方式进行说明。
五、特殊算法详细设计对系统主要的特殊算法进行详细设计。
可以通过添加附件的方式进行说明。
详细设计说明书模板一、引言。
详细设计说明书是软件开发过程中的重要文档,它描述了软件系统的详细设计方案,是软件开发人员在编码和测试阶段的重要参考依据。
本文档旨在为软件开发人员提供一个详细设计说明书的模板,以便他们能够按照统一的标准和格式编写详细设计说明书。
二、项目概述。
在本部分,应对项目的背景、目标、范围、功能和性能需求进行详细描述。
这部分内容应该包括对项目的整体理解,以及项目的基本需求和目标。
三、设计约束。
在本部分,应对项目的设计约束进行详细说明。
设计约束可能包括技术约束、硬件约束、软件约束、接口约束等内容。
这部分内容应该对设计过程中的各种约束进行全面、系统的描述。
四、系统架构。
在本部分,应对系统的整体架构进行详细描述。
系统架构包括系统的组成部分、模块划分、模块之间的关系等内容。
这部分内容应该对系统的整体结构进行清晰、完整的描述。
五、模块设计。
在本部分,应对系统的各个模块进行详细设计。
模块设计包括模块的功能、接口、数据结构、算法等内容。
这部分内容应该对系统的各个模块进行全面、细致的设计。
六、数据设计。
在本部分,应对系统的数据结构进行详细设计。
数据设计包括数据的组织结构、存储方式、访问方式等内容。
这部分内容应该对系统的数据进行全面、合理的设计。
七、界面设计。
在本部分,应对系统的用户界面进行详细设计。
界面设计包括界面的布局、样式、交互方式等内容。
这部分内容应该对系统的用户界面进行美观、易用的设计。
八、安全设计。
在本部分,应对系统的安全性进行详细设计。
安全设计包括系统的安全需求、安全策略、安全机制等内容。
这部分内容应该对系统的安全性进行全面、可靠的设计。
九、性能设计。
在本部分,应对系统的性能进行详细设计。
性能设计包括系统的性能需求、性能测试、性能优化等内容。
这部分内容应该对系统的性能进行全面、有效的设计。
十、测试设计。
在本部分,应对系统的测试进行详细设计。
测试设计包括测试计划、测试用例、测试环境等内容。
福建电信科学技术研究院有限公司号码百事通综合查询台详细设计说明书智能网技术支援中心版本号:V1.0文档类型:☑需求文档☐计划文档☐设计文档☐测试文档☐用户文档☐工程文档☐维护文档密级:☐公开资料☑内部资料☐保密资料☐机密资料状态:☐初稿☐讨论稿☑发布版权声明福建电信科学技术研究院有限公司版权所有,保留一切权利。
未经本公司书面许可,任何单位和个人不得擅自摘抄、复制本文档的部分或全部,并以任何形式传播。
产品支持服务我们将不断改进我们的产品和用户手册,使其更完善、更便于使用,您的意见和建议对我们的工作非常重要,您可以用您喜欢的任何方式与我们联系。
我们的联系地址和电话是:公司地址:福建省福州市五一中路57号7层邮编:350005电话:+86-591-3329115转101/120分机+86-591-3329117转101/120分机传真:+86-591-3329116网址:E-Mail: ZN@文档修改/审批记录福建电信科学技术研究院 - 1 -目录1 简介错误!未定义书签。
1.1目的91.2范围91.3参考资料91.4术语定义及说明92 模块详细设计102.1客户信息显示区模块102.1.1 功能概述102.1.2 界面概述112.1.3 类设计122.1.4 关键逻辑与算法说明142.1.5 访问的表或其他数据库实体142.1.6 调用外部接口说明142.1.7 提供调用接口说明142.1.8 模块内部使用的公用函数/包等的说明14 2.2公告显示区模块142.2.1 功能概述142.2.2 界面概述142.2.3 类设计142.2.4 关键逻辑与算法说明142.2.5 访问的表或其他数据库实体142.2.6 调用外部接口说明152.2.7 提供调用接口说明152.2.8 模块内部使用的公用函数/包等的说明15 福建电信科学技术研究院 - 2 -2.3信息查询显示区模块152.3.1 功能概述152.3.2 界面概述162.3.3 类设计162.3.4 关键逻辑与算法说明172.3.5 访问的表或其他数据库实体172.3.6 调用外部接口说明172.3.7 提供调用接口说明172.3.8 模块内部使用的公用函数/包等的说明17 2.4号码反查显示区模块182.4.1 功能概述182.4.2 界面概述192.4.3 类设计202.4.4 关键逻辑与算法说明202.4.5 访问的表或其他数据库实体202.4.6 调用外部接口说明202.4.7 提供调用接口说明202.4.8 模块内部使用的公用函数/包等的说明20 2.5以旧查新显示区模块202.5.1 功能概述202.5.2 界面概述212.5.3 类设计212.5.4 关键逻辑与算法说明212.5.5 访问的表或其他数据库实体212.5.6 调用外部接口说明212.5.7 提供调用接口说明21福建电信科学技术研究院 - 3 -2.5.8 模块内部使用的公用函数/包等的说明21 2.6区码查询显示区模块212.6.1 功能概述212.6.2 界面概述222.6.3 类设计232.6.4 关键逻辑与算法说明232.6.5 访问的表或其他数据库实体232.6.6 调用外部接口说明232.6.7 提供调用接口说明232.6.8 模块内部使用的公用函数/包等的说明23 2.7邮编查询显示区模块232.7.1 功能概述232.7.2 界面概述242.7.3 类设计242.7.4 关键逻辑与算法说明242.7.5 访问的表或其他数据库实体242.7.6 调用外部接口说明242.7.7 提供调用接口说明242.7.8 模块内部使用的公用函数/包等的说明24 2.8国家编码查询显示区模块252.8.1 功能概述252.8.2 界面概述252.8.3 类设计262.8.4 关键逻辑与算法说明262.8.5 访问的表或其他数据库实体262.8.6 调用外部接口说明26福建电信科学技术研究院 - 4 -2.8.7 提供调用接口说明262.8.8 模块内部使用的公用函数/包等的说明26 2.9私人号码查询显示区模块262.9.1 功能概述262.9.2 界面概述272.9.3 类设计272.9.4 关键逻辑与算法说明272.9.5 访问的表或其他数据库实体272.9.6 调用外部接口说明282.9.7 提供调用接口说明282.9.8 模块内部使用的公用函数/包等的说明28 2.10高级搜索显示区模块282.10.1 功能概述282.10.2 界面概述292.10.3 类设计292.10.4 关键逻辑与算法说明292.10.5 访问的表或其他数据库实体292.10.6 调用外部接口说明292.10.7 提供调用接口说明292.10.8 模块内部使用的公用函数/包等的说明29 2.11详细信息显示区模块292.11.1 功能概述292.11.2 界面概述302.11.3 类设计302.11.4 关键逻辑与算法说明302.11.5 访问的表或其他数据库实体30福建电信科学技术研究院 - 5 -2.11.6 调用外部接口说明302.11.7 提供调用接口说明302.11.8 模块内部使用的公用函数/包等的说明30 2.12与座席接口模块312.12.1 功能概述312.12.2 界面概述312.12.3 类设计312.12.4 关键逻辑与算法说明312.12.5 访问的表或其他数据库实体312.12.6 调用外部接口说明312.12.7 提供调用接口说明352.12.8 模块内部使用的公用函数/包等的说明35 2.13日志模块352.13.1 功能概述352.13.2 界面概述352.13.3 类设计352.13.4 关键逻辑与算法说明382.13.5 访问的表或其他数据库实体382.13.6 调用外部接口说明382.13.7 提供调用接口说明382.13.8 模块内部使用的公用函数/包等的说明38 2.14搜索引擎信息提取接口模块392.14.1 功能概述392.14.2 界面概述392.14.3 类设计392.14.4 关键逻辑与算法说明41福建电信科学技术研究院 - 6 -2.14.5 访问的表或其他数据库实体412.14.6 调用外部接口说明412.14.7 提供调用接口说明412.14.8 模块内部使用的公用函数/包等的说明41 2.15个人通讯助理模块422.15.1 功能概述422.15.2 界面概述422.15.3 类设计432.15.4 关键逻辑与算法说明462.15.5 访问的表或其他数据库实体462.15.6 调用外部接口说明472.15.7 提供调用接口说明472.15.8 模块内部使用的公用函数/包等的说明47 2.16家庭总机模块472.16.1 功能概述472.16.2 界面概述472.16.3 类设计482.16.4 关键逻辑与算法说明512.16.5 访问的表或其他数据库实体512.16.6 调用外部接口说明522.16.7 提供调用接口说明522.16.8 模块内部使用的公用函数/包等的说明52 2.17企业总机模块522.17.1 功能概述522.17.2 界面概述522.17.3 类设计53福建电信科学技术研究院 - 7 -2.17.4 关键逻辑与算法说明562.17.5 访问的表或其他数据库实体562.17.6 调用外部接口说明572.17.7 提供调用接口说明572.17.8 模块内部使用的公用函数/包等的说明573 性能说明574 其他错误!未定义书签。
XXX项目
系统详细设计说明书
XX有限公司
二〇X X年X月
文档修改记录
目录
第一章引言 (2)
1.1 目的 (2)
1.2 背景 (2)
1.3 术语定义 (2)
1.4 参考资料 (2)
1.5 文档编写格式 (3)
第二章系统概述 (4)
第三章程序1设计说明 (5)
3.1 程序描述 (5)
3.1.1 模块架构图 (5)
3.1.2 功能 (5)
3.1.3 类图 (5)
3.1.4 增加功能(功能点) (6)
3.1.5 程序流程 (7)
3.1.6 测试和限制条件 (7)
3.1.7 备注 (7)
第四章程序2设计说明 (8)
第五章公用接口程序设计说明 (9)
5.1 全局变量 (9)
5.2 公用界面或接口 (9)
5.3 公用方法和过程 (9)
第六章附件.................................................................................................. 错误!未定义书签。
第一章引言
1.1目的
提示:简要说明编写这份详细设计说明书的目的,指出预期的读者。
本详细设计说明书的适用读者为:软件开发者、测试人员
1.2背景
1.3术语定义
1.4参考资料
提示:列出所本文档所使用的参考资料,包括:
A 本软件开发所经核准的合同或标书或可行性报告等文档
B 软件开发计划书
C 需求分析报告
D 测试方案(若存在初稿的话)
E 概要设计说明书
F 与本项目有关的已发表的文件或资料
G 本文件中各处引用的文件、资料,所采用的软件开发标准和规范
注意:必须列出文件、资料的作者、标题、编号、发表日期和出版单位,以说明这些文件资料的来源。
若某些文档有保密要求的,则要说明其保密级别。
1.5文档编写格式
一级标题:三号字体,黑体,加粗,1.5倍行距,居中。
二级标题,小三号字体,黑体,加粗,1.5倍行距,段前18磅段后6磅。
三级标题,小四号字体,黑体,加粗,1.5倍行距,段前18磅段后6磅。
三级以上标题、项:小四号字体,宋体,常规,1.5倍行距,段前18磅段后6磅。
正文:小四字体,宋体,常规,段前段后0行,1.5倍行距,缩进左右0个字符,首行缩进2个字符。
表格:五号字体,宋体,1.25倍行距,段前留0.5行,段后留0行。
表头加粗。
页眉:小5号字体,填写项目名称,单划线,居中
页脚:小5号字体,页数(注意页数不包括封面),居中
第二章 系统概述
画出系统的体系结构图,以说明系统体系结构的实现技术,所用到的数据库主体的描述、如何实现访问数据库、如何划分程序的主体部分。
可以采用MVC 模式表述、也可以采用UML 中的
系统设计主要是基于MVC 设计模式,M 代表模型Model ,V 代表视图 View , C 代表控制器Controller 。
MVC 模式将系统分为三层,层与层之间通过又一定的模式联系,使数据实体与业务逻辑、业务逻辑与页面展现分离。
MVC 模式图举例如下图:
图二-1 MVC 模式图
第三章程序1设计说明
提示:从本章开始,逐步将各模块的功能和设计思想、内容等进行逐层解剖分析。
3.1程序描述
提示:给出对该程序的简要描述,主要说明安排设计本程序的目的意义,并且,还要说明本程序的特点。
3.1.1模块架构图
提示:给出模块的代码结构,如典型的三层结构,可以用UML的组件图表达。
3.1.2功能
提示:简要进行功能描述,可采用IPO(即输入-处理-输出图)表示。
3.1.3类图
提示:用UML类图利用面向对象思想设计模块代码实现,用类图表达出完整的类结构,包括类名,属性,主要方法名称,方法参数,关键的方法或算法可以用标注的方法,用伪码表达出来。
类图中要表示出类与类之间关系,从属关系、调用关系等。
UML类图举例如下:
图三-1 类图
注意,重要的方法要做详细的说明,举例如下:
说明:
1. BaseAbsDao:
a) getAll():返回所有信息的列表。
b) getById(string id):根据id检索,并返回特定的对象。
2. BaseBean:……
3.1.4增加功能(功能点)
3.1.
4.1功能描述
增加机构的管理信息。
3.1.
4.2输入或界面设计
提示:图、表方式清晰描述每一个输入项的特性,包括名称、标识、数据的类型和格式、数据值的有效范围、输入的方式。
数量和频度、输入媒体、输入数据的来源和安全保密条件等
3.1.
4.3类和接口设计
提示:列出本模块与其它模块的接口关系或要求列明所有接口,包括接口名称,调用方法,接口参数结构等。
1.接口:
接口名称:
接口方法:
输入参数:
返回信息:
2.数据接口:
3.其他接口:
3.1.5程序流程
提示:以流程图或顺序图形式给出本程序模块流转关系。
包括以下参数:
输入参数:
处理过程:
涉及的数据结构:
返回结果:
其他参数:
3.1.6测试和限制条件
提示:给出详细设计中考虑的测试程序测试点和状态、参数等,以及对系统在程序运行、测试时需要做出的各种限制等。
3.1.7备注
第四章程序2设计说明提示:与上一章类似,若有N个,则需要分开N项描述。
第五章公用接口程序设计说明
提示:给出各类公用接口的程序的设计考虑,如全局变量、数据字典、公用界面、公用方法和过程等。
5.1全局变量
提示:罗列各个全局变量的属性要求,包括全局变量名称、说明、数据类型、长度、取值范围等信息
5.2公用界面或接口
提示:要求描述清楚公用界面的界面布局情况,以及界面上所涉及到的各种数据项的相关属性,与界面相关的详细处理说明(有逻辑算法和计算公式,则要详细说明)、输入和输出数据要求等等,要求要附有界面的书面格式,可详细注明参见某个图表或某个相关附件
5.3公用方法和过程
提示:介绍公用方法和过程所实现的主要功能,说明公用方法和过程所需调用的输入参数、输出参数以及逻辑处理和相关算法描述,并注明该公用方法和过程的适用范围。
可以使用表格形式表述。
第六章附件
提示:罗列与本详细设计报告相关的文档资料,可包括以下内容:
1. 数据库设计的有关文档资料,如:数据字典
2. 用户界面有关约定、相关报表或模板格式、各种常规底稿模板等
3. 编程语言程序设计规范
4. 其它相关资料。