《软件设计3个模板之2详细设计说明书模板.docx》由会员分享，可在线阅读，更多相关《软件设计3个模板之2详细设计说明书模板.docx（18页珍藏版）》请在三一办公上搜索。
1、软件设计3个模板之2详细设计说明书模板XXX产品XXX子系统 详细设计说明书 文件编号： 版 本 号：A 总 页 数： 编制： 修改状态：0 附 录：0 审核： 年 月 日 生效日期： 年 月 日 受控状态： 受控 非受控 密 级：机 密 批准： 年 月 日 文档修订摘要 详细设计说明书 日期 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 版本号/状态 描述 著者 审阅者 批准人/日期 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 年 月 日 详细
2、设计说明书 目 录 1. 简介. 5 目的 . 5 范围 . 5 定义、首字母缩写词和缩略语 . 5 参考资料 . 5 概述 . 5 1.1 1.2 1.3 1.4 1.5 2. 整体说明 . 6 子系统名称. 6 子系统简要说明 . 6 子系统依赖关系 . 6 子系统职责. 6 子系统设计约束 . 6 2.1 2.2 2.3 2.4 2.5 3. 用例实现 . 7 3.1 用例实现列表 . 7 3.2 用例实现 . 7 3.2.1 用例实现一. 7 4. 接口实现 . 8 4.1 接口列表 . 8 4.2 接口实现 . 8 4.2.1 接口实现一. 8 5. 子系统逻辑视图. 8 5.1 逻
3、辑视图 . 9 5.2 子系统分层一 . 9 5.2.1 类列表. 9 5.2.2 类图 . 9 5.2.3 类描述. 9 5.3 子系统设计包一 .10 5.3.1 类列表.10 5.3.2 类图 .10 5.3.3 类描述.10 6. 子系统实施视图.11 实施视图 .11 实施子系统一 .11 6.1 6.2 7. 其它设计 .11 子系统集成设计 .11 集成子系统设计 .11 架构约定设计 .12 其它设计 .12 7.1 7.2 7.3 7.4 8. 9. 补充说明 .12 附录A 约定 .12 详细设计说明书 10. 附录B 附件 .12 详细设计说明书 1. 简介 子系统设计文
4、档的简介应提供整个子系统设计文档的概述。它应包括此子系统设计文档的目的、范围、定义、首字母缩写词、缩略语、参考资料和概述。 1.1 目的 本节确定此子系统设计文档在整个项目文档中的作用或目的，并对此文档的结构进行简要说明。应确定此文档的特定读者，并指出他们应该如何使用此文档。 1.2 范围 简要说明此子系统设计文档适用的范围和影响的范围。 1.3 定义、首字母缩写词和缩略语 本小节应提供正确理解此子系统设计文档所需的全部术语的定义、首字母缩写词和缩略语。 这些信息可以通过引用项目词汇表来提供。 1.4 参考资料 本小节应完整地列出此子系统设计文档中其他部分所引用的所有文档。每个文档应标有标题、
5、报告号、日期和出版单位。列出可从中获取这些参考资料的来源。这些信息可以通过引用附录或其他文档来提供。要求必须提供子系统的ROSE模型。 1.5 概述 本小节应说明此子系统设计文档中其他部分所包含的内容，并解释此子系统设计文档的组织方详细设计说明书 式。 2. 整体说明 2.1 子系统名称 在此说明此子系统的名称及编号。 2.2 子系统简要说明 在此简要说明此子系统的主角、目的或者内容。 2.3 子系统依赖关系 在此说明此子系统和其它子系统及包的依赖关系，要求说明依赖于其它子系统的接口以及提供给其它子系统的接口。要求有附图。 2.4 子系统职责 在此说明此子系统要完成的职责，以用例图的形式表达。
6、对每个用例，要求有简短的描述。除了用例之外，还要说明此子系统提供的接口。 2.5 子系统设计约束 在此说明设计此子系统要考虑的问题、遵循的约束。比如要遵循软件架构设计的要求，要遵循需求中分配到此子系统的特殊要求，要遵循统一的界面约束，要使用架构统一设置的数据库源，要使用架构统一设置的JAVA MAIL等。 详细设计说明书 3. 用例实现 3.1 用例实现列表 用例实现 编码 名称 编码 用例 名称 备注 注：对于每一个用例，可能有多个用例实现 如果不是很正式的话，那么编码这列可以省略不写。 3.2 用例实现 3.2.1 3.2.1.1 用例实现一 简介 在此对用例实现的简短说明。 3.2.1.
7、2 用例实现描述 在此详细的说明此用例实现的描述。 3.2.1.3 顺序图 在此引用此用例实现的顺序图或者交互图。 3.2.1.4 类图 在此引用此用例实现的类图。 详细设计说明书 4. 接口实现 4.1 接口列表 接口描述 编码 名称 类 接口 方法 备注 使用者 如果不是很正式的话，那么编码、使用者这2列可以省略不写。 4.2 接口实现 4.2.1 4.2.1.1 接口实现一 实现类 在此说明实现接口一的类及方法。最好用类图的形式来描述。 4.2.1.2 简介 方法实现一 对此方法的简短描述。 顺序图 在此引用此接口实现的顺序图或者交互图。 类图 在此引用此接口实现的类图。 5. 子系统逻
8、辑视图 即逻辑架构，为了容易理解，在此用逻辑分层来代替。在此说明此子系统的逻辑划分，现在一般详细设计说明书 来说，对于子系统只进行分层，不再进一步的划分子系统。但是，如果需要进一步的划分子系统的话，那么对于在其中划分出来的每一个子系统或者包，均需要此文档对其进行描述。 子系统分层中如果包括界面层，那么在界面层应该加入界面设计，最好有一些图片或者是WORD画的示意图来表示界面，同时要求加入界面之间的导航关系，要求详细的说明界面的校验。根据实际使用的结果，界面的导航关系、界面示意图、界面的校验是必须要求加入的。 子系统分层中如果包括数据层，那么在数据层应该加入数据库设计，最好有图形来表示数据库的设
9、计，同时要求有数据库的DDL语句，如果数据库需要初始化值的话，要求在DDL中包括初始化语句。 5.1 逻辑视图 在此用图形的方式显示此子系统的分层、包之间的关系。 5.2 子系统分层一 5.2.1 编码 类列表 名称 类 备注 如果不是很正式的话，那么编码这1列可以省略不写。 5.2.2 类图 在此可以引用ROSE模型中类图，类之间的关系、类的方法、类的属性也可以从此类图反映出来。如果不是很正式的话，那么在类图中如果有类之间的关系、类的方法、类的属性的话，那么5.2.3可以省略。 5.2.3 类描述 此小节可以根据项目实际限制条件进行取舍。 详细设计说明书 5.2.3.1 类一 在此可以引用此
10、类的源文件，如果引用源文件的话，那么以下的3项可以省略。 简介 在此包括类的名称、类的描述。 属性 名称 方法 名称 类型 访问限制 初始化值 描述 访问限制 输入参数 返回值 描述 5.3 子系统设计包一 5.3.1 编码 类列表 名称 类 备注 如果不是很正式的话，那么编码这1列可以省略不写。 5.3.2 类图 在此可以引用ROSE模型中类图，类之间的关系、类的方法、类的属性也可以从此类图反映出来。如果不是很正式的话，那么在类图中如果有类之间的关系、类的方法、类的属性的话，那么5.3.3可以省略。 5.3.3 类描述 此小节可以根据项目实际限制条件进行取舍。 5.3.3.1 类一 在此可以
11、引用此类的源文件，如果引用源文件的话，那么以下的3项可以省略。 详细设计说明书 简介 在此包括类的名称、类的描述。 属性 名称 方法 名称 类型 访问限制 初始化值 描述 访问限制 输入参数 返回值 描述 6. 子系统实施视图 6.1 实施视图 在此用图形的方式显示此子系统的分层、包之间的关系。 6.2 实施子系统一 构件 对应的设计类 在JAVA开发的系统中，实施子系统通常以目录的形式出现。 7. 其它设计 7.1 子系统集成设计 在此说明此子系统集成时的考虑，即将子系统集成成为那些包，各个包中包含那些构件。另外，在集成时，还要考虑到软件架构的影响。 7.2 集成子系统设计 在此说明将此子系
12、统集成进安装时的考虑，即子系统安装时依赖其它那些子系统，在安装时要建立的数据库的表、预先设置的数据、需要注册的值等。比如J2EE应用，要求在WEB.XML等配置文件中注册Servlet、在J2EE服务器上预先建立数据库连接、在J2EE服务器上预先配置JAVA MAIL等。另外，在安装时，还要考虑到软件架构的统一规定和约束。 详细设计说明书 7.3 架构约定设计 在此说明子系统按照架构规定的设计约束进行设计的部分。比如架构规定每个子系统必须提供的内容等。 7.4 其它设计 在此说明不包含在以上的其它设计内容。 8. 补充说明 在此说明其它需要说明的设计内容。比如说安装、发布、升级等。 9. 附录A 约定 在此包括各种设计上的约定，比如命名约定等。 10. 附录B 附件 在此附上各种需要的文档。比如子系统的建表语句、预先设置的数据的SQL语句、注册的SQL语句、注册到web.xml的语句、Servlet的注册语句、预先建立的此子系统的代码框架等。
