详细设计说明书

1、1 / 21 文档可自由编辑打印详详 细细 设设 计计 说说 明明 书书做做 您您 最最 擅擅 长长 的的 其其 余余 的的 外外 包包Do what you do best and outsource the rest2 / 21 文档可自由编辑打印文档文档编编号：号： 文档信息：文档信息： 文档名称：文档名称： 文档文档类别类别： ：CMMI 模板 密密 级级： ： 机密 版本信息：版本信息： 建立日期：建立日期： 2005-12-21 创创 建建 人：人：高华 审审 核核 者：者：EPG 批批 准准 人：人： Sunny 批准日期：批准日期： 保保 管管 人：人： 存放位置：存放位置：

2、编辑软编辑软件：件：Microsoft Office 2003 中文版3 / 21 文档可自由编辑打印目目 录录第一章第一章 导导言言 .21.1 目的.21.2 范围.21.3 术语定义.21.4 相关文档.21.5 参考资料.3第二章第二章 功能模功能模块实现设计块实现设计 .42.1 公用模块实现设计.42.2 专用模块实现设计.52.3 存储过程实现设计.62.4 触发器实现设计.6第三章第三章 外部接口外部接口实现设计实现设计 .83.1 外部接口 1 实现设计.83.2 外部接口 2 实现设计.8第四章第四章 其它其它实现设计实现设计 .104.1 部门角色授权设计.104.2 其

3、它详细设计.10第五章第五章 程序文件清程序文件清单单 .10文档文档类别类别使用使用对对象象文档文档类别类别本文档是软件系统详细设计说明书的模板，是详细设计说明书的书写标准及规范，是技术文档。使用使用对对象象该文档使用人员包括：系统分析人员系统设计人员系统编码人员系统测试人员系统维护人员4 / 21 文档可自由编辑打印第第一一章章 导导言言本章对该文档的目的、功能范围、术语、相关文档、参考资料、版本更新进行说明。1.11.1 目目的的本文档的目的旨在推动软件工程的规范化，使设计人员遵循统一的详细设计书写规范，节省制作文档的时间，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统

4、的实现、测试、维护、版本升级等。详细设计的详细程度，应达到可以编写程序的水平。1.21.2 范范围围本文档用于软件设计阶段的详细设计，它的上游（依据的基线）是概要设计说明书，它的下游是源程序清单及单元测试计划，并为单元测试报告提供测试依据。软件详细设计的范围是：各子系统的公用模块实现设计、专用模块实现设计、存储过程实现设计、触发器实现设计、外部接口实现设计、部门角色授权设计、其它详细设计等。按照三层结构（B/A/S）的布局，详细设计应从下面三个方面进行：数据库服务器上的面向数据的设计：数据字典物理设计、基本表物理设计、中间表物理设计（报表设计）、临时表物理设计、视图物理设计、存储过程物理设计、

5、触发器物理设计；应用服务器上的面向业务逻辑的设计：接口数据设计、中间件设计、数据通讯传输设计、可视组件设计、非可视组件设计、角色授权设计、功能点设计（功能列表设计）；浏览器上的面向对象的设计：录入修改界面设计、浏览查询界面设计、登录注册界面设计。1.31.3 术术语语定定义义序号序号术语术语名称名称术语术语定定义义1详细设计在概要设计的基础上，对其功能模块或部件进行实现设计，使编程人员据此能顺利书写出程序代码。2存储过程存放在数据库服务器上的一段程序，它能被其它程序调用，以完成对数据库表的某些规定操作。3触发器存放在数据库服务器上的一段程序，当触发条件满足时它就被执行，以完成对数据库表的某些规

6、定操作。4算法详细设计中实现某项功能的数据处理方法及处理流程。1.41.4 相相关关文文档档5 / 21 文档可自由编辑打印1.源程序清单2.单元测试计划及报告3.用户使用手册1.51.5 参参考考资资料料1.软件需求规格说明书2.概要设计说明书3.软件合同4.命名规范第第二二章章 功功能能模模块块实实现现设设计计详细设计是面向模块的，或者说是面向部件（组件或构件）的，不是面向组织结构或部门单位的。一个组织或单位，根据角色的授权，可以挂上某些功能模块。若为 C/S 或 B/A/S 结构，则要说明该模块运行在哪一层上。2.12.1 公公用用模模块块实实现现设设计计2.1.1 登录系统登录系统公用

7、模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能6 / 21 文档可自由编辑打印3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入

8、参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作操作对对象的描述：象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特特别别引用的描述：引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事注意事项项： ：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.

9、模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利13. 模块测试日期：2006/8/3014. 相关表结构设计：7 / 21 文档可自由编辑打印 2.1.2 系统快捷操作系统快捷操作公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功

10、能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作操作对对象的描述：象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特特别别引用的描述：引用

11、的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事注意事项项： ：实现该功能项需注意的问题。8 / 21 文档可自由编辑打印7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利13. 模块测试日期：2006/8/3014. 相关表结构设计：2.1.3 系统管理系统管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如

12、下内容：15. 模块编号：G-00116. 模块名称：系统登录17. 模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。18. 模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。19. 模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作20. 调用参数的描述：调用参数的描述：1)输入用户名9

13、 / 21 文档可自由编辑打印2)输入密码操作操作对对象的描述：象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特特别别引用的描述：引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事注意事项项： ：实现该功能项需注意的问题。21. 模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。22. 模块编写者：曾利23. 模块编写日期：2006/8/2724. 模块修订者：曾利25. 模块修订日期：写

14、2006/8/2826. 模块测试者：曾利27. 模块测试日期：2006/8/3028. 相关表结构设计：2.1.4 用户管理用户管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。4.模块背景描述：10 / 21 文档可自由编辑打印1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的

15、身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作操作对对象的描述：象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特特别别引用的描述：引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事

16、注意事项项： ：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利13. 模块测试日期：2006/8/3011 / 21 文档可自由编辑打印14相关表结构设计：2.1.3 部门管理部门管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。

17、2)根据用户权限进行页面控制访问。4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作操作对对象的描述：象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到

18、系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特特别别引用的描述：引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 12 / 21 文档可自由编辑打印注意事注意事项项： ：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利13. 模块测试日期：2006/8/30相关表结构设计：2.1.3 职位管理职位管理

19、公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：14. 模块编号：G-00115. 模块名称：系统登录16. 模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。17. 模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。18. 模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：s

20、ession 对象中记录的用户 ID 出口说明：系统完成相应的操作19. 调用参数的描述：调用参数的描述：13 / 21 文档可自由编辑打印1)输入用户名2)输入密码操作操作对对象的描述：象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特特别别引用的描述：引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事注意事项项： ：实现该功能项需注意的问题。20. 模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、

21、异常处理。21. 模块编写者：曾利22. 模块编写日期：2006/8/2723. 模块修订者：曾利24. 模块修订日期：写 2006/8/2825. 模块测试者：曾利26. 模块测试日期：2006/8/30相关表结构设计：2.1.3 角色管理角色管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2）根据用户权限进行页面控制访问。14 / 21 文档可自由编辑打印4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实

22、现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作操作对对象的描述：象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用

23、。特特别别引用的描述：引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事注意事项项： ：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利15 / 21 文档可自由编辑打印13. 模块测试日期：2006/8/30相关表结构设计：2.1.3 日志管理日志管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量

24、。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输

25、入密码操作操作对对象的描述：象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特特别别引用的描述：引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述：16 / 21 文档可自由编辑打印注意事注意事项项： ：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2

26、812. 模块测试者：曾利13. 模块测试日期：2006/8/30相关表结构设计：二、专用模块实现设计二、专用模块实现设计非公用模块是为了处理一些特殊需求，它不可复用，设计包括如下内容：1.块编号：按照命名规则，如：M1-XXX，将此公用模板编号写上。2.模块名称：写上此模块的中文名。3.模块功能：详细列出此模块的所有功能。4.模块背景描述：对背景进行简单的描述。为什么需要此模块功能，其上下文环境。涉及业务背景内容，与需求相结合。5.模块算法设计：用伪语言（例如：ifendif;caseendcase;doenddo;）详细描述出此公用模块的算法，标准是使程序人员据此能顺利地书写程序。在算法设

27、计时，需要考虑下列问题：输输入入输输出的描述：出的描述：表述模块的输入和输出。操作操作对对象的描述：象的描述：该功能对哪些数据对象（档案）进行写操作，对哪些对象进行读操作，写操作的对象列在哪些功能里用到。特特别别引用的描述：引用的描述：对引用的公共资源、特殊引用的函数进行说明。操作流程的描述：操作流程的描述：具体的操作步骤。描述操作步骤，简单的说明书内容。可用做黑盒测试的依据。可以采用图形交互。注意事注意事项项： ：实现该功能项需注意的问题。17 / 21 文档可自由编辑打印6.模块编写者： 写上编写者姓名。7.模块编写日期： 写上编写日期：yyyy/mm/dd。8.模块修订者：写上修订者姓名

28、。9.模块修订日期：写上修订日期：yyyy/mm/dd。10. 模块测试者：写上测试者姓名。11. 块测试日期：写上测试日期：yyyy/mm/dd。12. 相关表结构设计：详细列出每个表的字段及其含义，并说明栏位的赋值及取值用途。2.22.2 存存储储过过程程实实现现设设计计存储过程是一种特殊的公用模块，它在数据库服务器上执行，这里将它单独列出来，规定其详细设计模板为：13. 存储过程中文名 14. 存储过程英文名（或拼音名）：15. 存储过程功能: 详细描述其功能。16. 存储过程算法: 用形式语言详细描述其算法分析，使编程人员据此能顺利书写程序。17. 存储过程调用方式：18. 存储过程入

29、口参数：19. 存储过程出口参数20. 模块编写者： 写上编写者姓名。21. 模块编写日期： 写上编写日期：yyyy/mm/dd。22. 模块修订者：写上修订者姓名。23. 模块修订日期：写上修订日期：yyyy/mm/dd。24. 模块测试者：写上测试者姓名。18 / 21 文档可自由编辑打印25. 模块测试日期：写上测试日期：yyyy/mm/dd。2.32.3 触触发发器器实实现现设设计计触发器也是一种公用的模块，不过它是隐式执行，这里将它单独列出来，规定其详细设计模板为： 1.触发器中文名: 2.触发器英文名（或拼音名）：3.触发器功能: 详细描述其功能。4.触发器算法: 用形式语言详细描

30、述其算法分析，使编程人员据此能顺利书写程序。5.触发器激活条件：6.触发器编写者： 写上编写者姓名。7.触发器编写日期： 写上编写日期：yyyy/mm/dd。8.触发器修订者：写上修订者姓名。9.触发器修订日期：写上修订日期：yyyy/mm/dd。10. 触发器测试者：写上测试者姓名。11. 触发器测试日期：写上测试日期：yyyy/mm/dd。注意：过多地使用触发器反而会使系统的效率降低。因此，凡是能用存储过程代替触发器功能的地方，一律用存储过程来实现。19 / 21 文档可自由编辑打印第第三三章章 外外部部接接口口实实现现设设计计3.13.1 外外部部接接口口 1 实实现现设设计计1.接口中文名称：2.接