1、xxx项目概要设计说明书(xxx模块)拟制日期yyyy-mm-dd评审人日期批准日期签发日期文档修订记录版本完毕人修改内容审核批准时间V0.00创建文档目 录1. 简介51.1. 编写目的51.2. 合用范围51.2.1. 软件名称51.2.2. 软件功能51.2.3. 软件应用51.3. 定义及关键词51.4. 参考资料52. 第0层设计描述62.1. 软件系统上下文定义62.2. 设计思绪(可选)62.2.1. 设计可选方案62.2.2. 设计约束62.2.3. 其他62.3. 系统结构62.3.1. 系统结构描述62.3.2. XXX模块63. 第一层设计描述83.1. 模块的系统结构8
2、3.1.1. 模块内部结构83.1.2. 业务流程说明83.2. 分解描述83.2.1. XXX子模块83.2.2. 数据设计83.3. 依赖性描述83.4. 接口描述93.4.1. 子模块1的接口描述94. 第二层设计描述104.1. XXX子模块104.1.1. 子模块设计描述104.1.2. 功能实现说明105. 数据库设计115.1. 实体定义115.1.1. 分解描述115.1.2. 内部依赖性描述115.2. 行为定义115.2.1. 分解描述115.2.2. 外部依赖性描述115.2.3. 内部依赖性描述116. 组件视图126.1. 系统运营组件126.2. 文献组织形式127
3、. 进程视图12表目录表1.关键词5图目录图1软件架构图6图2软件体系结构图6图3基本包依赖关系图6图4与其它模块关系图7图5模块内部结构图8图6模块结构图10图7类XXX10图8时序图101. 简介1.1. 编写目的这部分要描述文档的目的,并指明文档的读者。1.2. 合用范围1.2.1. 软件名称1.2.2. 软件功能解释软件产品将完毕或不完毕的功能1.2.3. 软件应用描述软件的应用领域1.3. 定义及关键词表1. 关键词关键词英文全名中文解释1.4. 参考资料12. 第0层设计描述2.1. 软件系统上下文定义本节描述待开发软件系统与外部实体的关系,可以使用系统结构图来描述系统结构和交互关
4、系。外部实体属性描述只限于描述与本系统软件设计相关的属性。图1 软件架构图2.2. 设计思绪(可选)2.2.1. 设计可选方案对本软件系统的几种设计方案进行分析、比较,并拟定所采用的方案。图2 软件体系结构图2.2.2. 设计约束1. 遵循标准2. 硬件限制3. 技术限制2.2.3. 其他2.3. 系统结构2.3.1. 系统结构描述这里要描述软件系统的总体结构,可以使用结构图、层次分解图或包图来描述,并应说明系统结构划分的原则(例如,基于标准、协议所规定的体系结构,来自于分析模型的方案,或者基于原有体系结构的限制)。图3 基本包依赖关系图2.3.2. XXX模块1. 简介这里要描述本文档所设计
5、的模块,其功能简介,与其它模块的关系。图4 与其它模块关系图2. 接口描述本文档设计的模块与其它模块之间的接口。3. 第一层设计描述3.1. 模块的系统结构3.1.1. 模块内部结构这里要描述本文档所设计的模块的总体结构,可以使用结构图、层次分解图或包图来描述,并应说明结构划分的原则(例如,基于标准、协议所规定的体系结构,来自于分析模型的方案,或者基于原有体系结构的限制)。图5 模块内部结构图3.1.2. 业务流程说明描述该模块用例模型中的典型用例场景,以体现其功能是如何实现的。建议采用Sequence图、Collaboration图等来描述。3.2. 分解描述3.2.1. XXX子模块1.
6、简介 2. 功能列表3.2.2. 数据设计本节描述本文档所设计的模块中的数据结构,外部数据实体不必描述。1. 数据实体1描述1) 标记:2) 类型:3) 目的:3.3. 依赖性描述本节描述本文档所设计的模块的子系统,数据结构,模块,进程等设计实体间的关系。依赖关系描述可以使用文字,结构图,(交互)事务图。3.4. 接口描述3.4.1. 子模块1的接口描述该子模块与其它子模块之间的接口描述。名称:接口名称说明:对接口的简短说明定义:接口原型定义,说明接口类型及相关参数4. 第二层设计描述4.1. XXX子模块4.1.1. 子模块设计描述描述子模块的功能定义。定义出具体的设计类,用类图来描述其互相
7、关系,并说明所采用的设计模式。图6 模块结构图1. 类名XXX1) 标记说明该类的配置项标记(用于需求跟踪,配置项的命名方式在CMP中已定义)2) 简介简朴介绍该类的功能3) 类定义假如该类在前面没有定义,使用类图、伪代码描述该类的类定义,需说明该类的所有public属性和public方法。图7 类XXX4.1.2. 功能实现说明1. XXX功能图8 时序图5. 数据库设计本节列出所有的数据存储类的实体(表、存储过程、触发器等),具体描述实体的内容和并列出所有属性。对每个属性,具体描述其数据库、数据大小、特定约束。实体的所有约束及实体间的关系也要注明。5.1. 实体定义5.1.1. 分解描述阐
8、述设计思绪及约束规则。具体定义每个关键数据表、视图中的各个字段属性、存储规定、完整性约束、功能、注意事项,对静态数据表应考虑定义初始配置记录。5.1.2. 内部依赖性描述使用E-R图描述实体间的关联依赖关系,分析对存取空间、性能、完整性的规定。5.2. 行为定义5.2.1. 分解描述根据功能或其他方式对存储过程/触发器进行归类,便于进一步细化和分解,并说明每类存储过程/触发器重要功能。具体定义每个存储过程(触发器)的功能、输入输出参数、返回值、返回的记录集、依赖的数据表和存储过程,以及一些特殊规定(比如需要启用事务等)。5.2.2. 外部依赖性描述描述与其它模块之间的依赖关系。5.2.3. 内部依赖性描述描述存储过程间、存储过程和数据表/视图间依赖关系。6. 组件视图6.1. 系统运营组件使用Component图、deployment图来描述系统的运营组件(EXE文献、DLL等),及其网络部署情况。6.2. 文献组织形式描述源代码文献的目录结构(文献夹中各个目录下应存放什么文献)7. 进程视图本节描述将系统分解为轻量级进程(单个控制线程)和重量级进程(成组的轻量级进程)的过程。本节按照各个通信或交互的进程组来加以组织。说明进程之间的重要通信模式,例如消息传递、中断和会合。