系统详细设计说明书(模板).doc

XXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXX 项目名称项目名称 详细设计说明书详细设计说明书 XXXXXX 公司公司 二二 X XX X年年 X X月月 文档修改记录文档修改记录 版本号版本号版本描述版本描述责任人责任人日期日期备注备注 V1 0 初始编制 XXXX2012 8 31 版本号示例 V1 0 V2 0 V3 0 V4 0 V5 0 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 3 页 共 13 页 目目 录录 第一章引言 4 1 1目的 4 1 2背景 4 1 3术语定义 4 1 4参考资料 4 第二章系统概述 6 第三章程序 1 设计说明 7 3 1程序描述 7 3 1 1模块架构图 7 3 1 2功能 7 3 1 3类图 7 3 1 4增加功能 功能点 8 3 1 5程序流程 9 3 1 6测试和限制条件 9 3 1 7备注 9 第四章程序 2 设计说明 10 第五章公用接口程序说明 11 5 1全局变量 11 5 2公用界面或接口 11 5 3公用方法和过程 11 第六章附件 12 详细设计评审意见 13 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 4 页 共 13 页 第一章引言 1 1 目的 提示 简要说明编写这份详细设计说明书的目的 指出预期的读者 本详细设计说明书的适用读者为 软件开发者 测试人员 1 2 背景 1 3 术语定义 序号序号术语名称术语名称术语定义术语定义 1 2 3 4 1 4 参考资料 提示 列出所本文档所使用的参考资料 包括 A 本软件开发所经核准的合同或标书或可行性报告等文档 B 软件开发计划书 C 需求分析报告 D 测试方案 若存在初稿的话 E 概要设计说明书 F 与本项目有关的已发表的文件或资料 G 本文件中各处引用的文件 资料 所采用的软件开发标准和规范 注意 必须列出文件 资料的作者 标题 编号 发表日期和出版单位 以说明这 些文件资料的来源 若某些文档有保密要求的 则要说明其保密级别 序号序号文档名称文档名称作者作者版本版本 日期日期 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 5 页 共 13 页 1 2 3 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 6 页 共 13 页 第二章系统概述 画出系统的体系结构图 以说明系统体系结构的实现技术 所用到的数据库主体的 描述 如何实现访问数据库 如何划分程序的主体部分 可以采用 MVC 模式表述 也 可以采用 UML 中的 系统设计主要是基于 MVC 设计模式 M 代表模型 Model V 代表视图 View C 代表控制器 Controller MVC 模式将系统分为三层 层与层之间通过又一定的模式联 系 使数据实体与业务逻辑 业务逻辑与页面展现分离 MVC 模式图举例如下图 Web BrowseJSF BeanserviceDAOEntity BeanDataBase View层Controller层Model层 1 1 Request 3 3 return 4 2 2 call method 5 3 execute EntityDAO 9 7 return 6 4 operate Entity Bean 8 6 return 7 5 DB reflection 图二 1 MVC 模式图 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 7 页 共 13 页 第三章程序 1 设计说明 提示 从本章开始 逐步将各模块的功能和设计思想 内容等进行逐层解剖分析 3 1 程序描述 提示 给出对该程序的简要描述 主要说明安排设计本程序的目的意义 并且 还 要说明本程序的特点 3 1 1模块架构图 提示 给出模块的代码结构 如典型的三层结构 可以用 UML 的组件图表达 3 1 2功能 提示 简要进行功能描述 可采用 IPO 即输入 处理 输出图 表示 3 1 3类图 提示 用 UML 类图利用面向对象思想设计模块代码实现 用类图表达出完整的类 结构 包括类名 属性 主要方法名称 方法参数 关键的方法或算法可以用标注的 方法 用伪码表达出来 类图中要表示出类与类之间关系 从属关系 调用关系等 UML 类图举例如下 图三 1 类图 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 8 页 共 13 页 注意 重要的方法要做详细的说明 举例如下 说明 1 BaseAbsDao a getAll 返回所有信息的列表 b getById string id 根据 id 检索 并返回特定的对象 2 BaseBean 3 1 4增加功能 功能点 提示 简要进行功能描述 可采用 IPO 即输入 处理 输出图 表示 3 1 4 1功能描述 增加机构的管理信息 3 1 4 2输入和界面设计 提示 图 表方式清晰描述每一个输入项的特性 包括名称 标识 数据的类型 和格式 数据值的有效范围 输入的方式 数量和频度 输入媒体 输入数据的来源 和安全保密条件等 3 1 4 3类和接口设计 提示 列出本模块与其它模块的接口关系或要求列明所有接口 包括接口名称 调用方法 接口参数结构等 1 1 接口 接口 接口名称 接口方法 输入参数 返回信息 2 2 数据接口 数据接口 3 3 其他接口 其他接口 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 9 页 共 13 页 3 1 5程序流程 提示 以流程图或顺序图形式给出本程序模块流转关系 包括一下参数 输入参数 处理过程 涉及的数据结构 返回结果 其他参数 3 1 6测试和限制条件 提示 给出详细设计中考虑的测试程序测试点和状态 参数等 以及对系统在程序 运行 测试时需要做出的各种限制等 3 1 7备注 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 10 页 共 13 页 第四章程序 2 设计说明 提示 与上一章类似 若有 N 个 则需要分开 N 项描述 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 11 页 共 13 页 第五章公用接口程序说明 提示 给出各类公用接口的程序的设计考虑 如全局变量 数据字典 公用界面 公用方法和过程等 5 1 全局变量 提示 罗列各个全局变量的属性要求 包括全局变量名称 说明 数据类型 长度 取值范围等信息 名称名称说明说明数据类型数据类型长度长度取值范围取值范围 5 2 公用界面或接口 提示 要求描述清楚公用界面的界面布局情况 以及界面上所涉及到的各种数据 项的相关属性 与界面相关的详细处理说明 有逻辑算法和计算公式 则要详细说明 输入和输出数据要求等等 要求要附有界面的书面格式 可详细注明参见某个图表 或某个相关附件 5 3 公用方法和过程 提示 介绍公用方法和过程所实现的主要功能 说明公用方法和过程所需调用的 输入参数 输出参数以及逻辑处理和相关算法描述 并注明该公用方法和过程的适用 范围 可以使用表格形式表述 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 12 页 共 13 页 第六章附件 提示 罗列与本详细设计报告相关的文档资料 可包括以下内容 1 数据库设计的有关文档资料 如 数据字典 2 用户界面有关约定 相关报表或模板格式 各种常规底稿模板等 3 编程语言程序设计规范 4 其它相关资料 XXXXX 项目 系统详细设计说明书 XXXXXXXXXXXXXXXXX 公司 第 13 页 共 13 页 详