详细设计说明书

详详 细细 设设 计计 说说 明明 书书做做 您您 最最 擅擅 长长 的的 其其 余余 的的 外外 包包Do what you do best and outsource the rest文档编号：文档编号： 文档信息：文档信息： 文档名称：文档名称： 文档类别：文档类别：CMMI 模板 密密 级：级： 机密 版本信息：版本信息： 建立日期：建立日期： 2005-12-21 创创 建建 人：人：高华 审审 核核 者：者：EPG 批批 准准 人：人： Sunny 批准日期：批准日期： 保保 管管 人：人： 存放位置：存放位置： 编辑软件：编辑软件：Microsoft Office 2003 中文版目目 录录第一章第一章 导言导言 .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 其它详细设计.10第五章第五章 程序文件清单程序文件清单 .10文档类别使用对象文档类别使用对象文档类别文档类别本文档是软件系统详细设计说明书的模板，是详细设计说明书的书写标准及规范，是技术文档。使用对象使用对象该文档使用人员包括：系统分析人员系统设计人员系统编码人员系统测试人员系统维护人员导导言言本章对该文档的目的、功能范围、术语、相关文档、参考资料、版本更新进行说明。1.11.1 目目的的本文档的目的旨在推动软件工程的规范化，使设计人员遵循统一的详细设计书写规范，节省制作文档的时间，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。详细设计的详细程度，应达到可以编写程序的水平。1.21.2 范范围围本文档用于软件设计阶段的详细设计，它的上游（依据的基线）是概要设计说明书，它的下游是源程序清单及单元测试计划，并为单元测试报告提供测试依据。软件详细设计的范围是：各子系统的公用模块实现设计、专用模块实现设计、存储过程实现设计、触发器实现设计、外部接口实现设计、部门角色授权设计、其它详细设计等。按照三层结构（B/A/S）的布局，详细设计应从下面三个方面进行：数据库服务器上的面向数据的设计：数据字典物理设计、基本表物理设计、中间表物理设计（报表设计） 、临时表物理设计、视图物理设计、存储过程物理设计、触发器物理设计；应用服务器上的面向业务逻辑的设计：接口数据设计、中间件设计、数据通讯传输设计、可视组件设计、非可视组件设计、角色授权设计、功能点设计（功能列表设计） ；浏览器上的面向对象的设计：录入修改界面设计、浏览查询界面设计、登录注册界面设计。1.31.3 术术语语定定义义序号序号术语名称术语名称术语定义术语定义1详细设计在概要设计的基础上，对其功能模块或部件进行实现设计，使编程人员据此能顺利书写出程序代码。2存储过程存放在数据库服务器上的一段程序，它能被其它程序调用，以完成对数据库表的某些规定操作。3触发器存放在数据库服务器上的一段程序，当触发条件满足时它就被执行，以完成对数据库表的某些规定操作。4算法详细设计中实现某项功能的数据处理方法及处理流程。1.41.4 相相关关文文档档1.源程序清单2.单元测试计划及报告3.用户使用手册1.51.5 参参考考资资料料1.软件需求规格说明书2.概要设计说明书3.软件合同4.命名规范第第二二章章 功功能能模模块块实实现现设设计计详细设计是面向模块的，或者说是面向部件（组件或构件）的，不是面向组织结构或部门单位的。一个组织或单位，根据角色的授权，可以挂上某些功能模块。若为 C/S 或 B/A/S 结构，则要说明该模块运行在哪一层上。2.12.1 公公用用模模块块实实现现设设计计2.1.1 登录系统登录系统公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作对象的描述：操作对象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特别引用的描述：特别引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事项：注意事项：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利13. 模块测试日期：2006/8/3014. 相关表结构设计： 2.1.2 系统快捷操作系统快捷操作公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作对象的描述：操作对象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特别引用的描述：特别引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事项：注意事项：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利13. 模块测试日期：2006/8/3014. 相关表结构设计：2.1.3 系统管理系统管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：15. 模块编号：G-00116. 模块名称：系统登录17. 模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。18. 模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。19. 模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作20. 调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作对象的描述：操作对象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特别引用的描述：特别引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事项：注意事项：实现该功能项需注意的问题。21. 模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。22. 模块编写者：曾利23. 模块编写日期：2006/8/2724. 模块修订者：曾利25. 模块修订日期：写 2006/8/2826. 模块测试者：曾利27. 模块测试日期：2006/8/3028. 相关表结构设计：2.1.4 用户管理用户管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作对象的描述：操作对象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特别引用的描述：特别引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事项：注意事项：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利13. 模块测试日期：2006/8/3014相关表结构设计：2.1.3 部门管理部门管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作对象的描述：操作对象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特别引用的描述：特别引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事项：注意事项：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利13. 模块测试日期：2006/8/30相关表结构设计：2.1.3 职位管理职位管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：14. 模块编号：G-00115. 模块名称：系统登录16. 模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。17. 模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。18. 模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作19. 调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作对象的描述：操作对象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特别引用的描述：特别引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事项：注意事项：实现该功能项需注意的问题。20. 模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。21. 模块编写者：曾利22. 模块编写日期：2006/8/2723. 模块修订者：曾利24. 模块修订日期：写 2006/8/2825. 模块测试者：曾利26. 模块测试日期：2006/8/30相关表结构设计：2.1.3 角色管理角色管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2）根据用户权限进行页面控制访问。4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作对象的描述：操作对象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特别引用的描述：特别引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述： 注意事项：注意事项：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利13. 模块测试日期：2006/8/30相关表结构设计：2.1.3 日志管理日志管理公用模块的提取与设计特别重要，设计它的目的是为了复用，因此它直接影响到系统的详细设计、编程、运行的质量。公用模块设计包括如下内容：1.模块编号：G-0012.模块名称：系统登录3.模块功能：1)对用户身份进行验证。2)根据用户权限进行页面控制访问。4.模块背景描述：1)用户使用系统时需要在页面之间导航2)系统需要实现对用户的重要工作的提示功能3)为了保证系统用户的安全性，提供密码修改功能4)用户可能会在系统使用过程中需要以另外的身份登录重新进入系统5)完成相应的任务，退出系统，保证用户帐号的安全性。5.模块算法设计： 入口说明：用户通过用户界面点击相应的链接。 输入参数：session 对象中记录的用户 ID 出口说明：系统完成相应的操作6.调用参数的描述：调用参数的描述：1)输入用户名2)输入密码操作对象的描述：操作对象的描述：1)本功能要读取用户信息，用户对应角色权限信息管理。2)将用户操作情况写到系统日志中，将职位信息写到职位信息列表中。3)系统日志将在 G-003 G-005 系统日志模块中作用。特别引用的描述：特别引用的描述： 要使用到 G-001 系统登录模块的功能操作流程的描述：操作流程的描述：注意事项：注意事项：实现该功能项需注意的问题。7.模块调用方法：详细列出不同的调用的方式、入口参数、出口参数、异常处理。8.模块编写者：曾利9.模块编写日期：2006/8/2710. 模块修订者：曾利11. 模块修订日期：写 2006/8/2812. 模块测试者：曾利13. 模块测试日期：2006/8/30相关表结构设计：二、专用模块实现设计二、专用模块实现设计非公用模块是为了处理一些特殊需求，它不可复用，设计包括如下内容：1.块编号：按照命名规则，如：M1-XXX，将此公用模板编号写上。2.模块名称：写上此模块的中文名。3.模块功能：详细列出此模块的所有功能。4.模块背景描述：对背景进行简单的描述。为什么需要此模块功能，其上下文环境。涉及业务背景内容，与需求相结合。5.模块算法设计：用伪语言（例如：ifendif;caseendcase;doenddo;）详细描述出此公用模块的算法，标准是使程序人员据此能顺利地书写程序。在算法设计时，需要考虑下列问题：输入输出的描述：输入输出的描述：表述模块的输入和输出。操作对象的描述：操作对象的描述：该功能对哪些数据对象（档案）进行写操作，对哪些对象进行读操作，写操作的对象列在哪些功能里用到。特别引用的描述：特别引用的描述：对引用的公共资源、特殊引用的函数进行说明。操作流程的描述：操作流程的描述：具体的操作步骤。描述操作步骤，简单的说明书内容。可用做黑盒测试的依据。可以采用图形交互。注意事项：注意事项：实现该功能项需注意的问题。6.模块编写者： 写上编写者姓名。7.模块编写日期： 写上编写日期：yyyy/mm/dd。8.模块修订者：写上修订者姓名。9.模块修订日期：写上修订日期：yyyy/mm/dd。10. 模块测试者：写上测试者姓名。11. 块测试日期：写上测试日期：yyyy/mm/dd。12. 相关表结构设计：详细列出每个表的字段及其含义，并说明栏位的赋值及取值用途。2.22.2 存存储储过过程程实实现现设设计计存储过程是一种特殊的公用模块，它在数据库服务器上执行，这里将它单独列出来，规定其详细设计模板为：13. 存储过程中文名 14. 存储过程英文名（或拼音名）：15. 存储过程功能: 详细描述其功能。16. 存储过程算法: 用形式语言详细描述其算法分析，使编程人员据此能顺利书写程序。17. 存储过程调用方式：18. 存储过程入口参数：19. 存储过程出口参数20. 模块编写者： 写上编写者姓名。21. 模块编写日期： 写上编写日期：yyyy/mm/dd。22. 模块修订者：写上修订者姓名。23. 模块修订日期：写上修订日期：yyyy/mm/dd。24. 模块测试者：写上测试者姓名。25. 模块测试日期：写上测试日期：yyyy/mm/dd。2.32.3 触触发发器器实实现现设设计计触发器也是一种公用的模块，不过它是隐式执行，这里将它单独列出来，规定其详细设计模板为： 1.触发器中文名: 2.触发器英文名（或拼音名）：3.触发器功能: 详细描述其功能。4.触发器算法: 用形式语言详细描述其算法分析，使编程人员据此能顺利书写程序。5.触发器激活条件：6.触发器编写者： 写上编写者姓名。7.触发器编写日期： 写上编写日期：yyyy/mm/dd。8.触发器修订者：写上修订者姓名。9.触发器修订日期：写上修订日期：yyyy/mm/dd。10. 触发器测试者：写上测试者姓名。11. 触发器测试日期：写上测试日期：yyyy/mm/dd。注意：过多地使用触发器反而会使系统的效率降低。因此，凡是能用存储过程代替触发器功能的地方，一律用存储过程来实现。外外部部接接口口实实现现设设计计2.42.4 外外部部接接口口 1 实实现现设设计计1.接口中文名称：2.接口英文名称：3.接口内容与功能：详细描述接口的内容与功能，如实现数据传输或数据交换。4.接口硬件设施：详细描述接口的硬件设施，如交换机、传感器或输出设备。5.接口软件或中间件：详细描述接口软件或中间件的名称、功能、使用方法、生产厂商。6.接口的数据结构：详细描述接口的数据结构，如文件结构、数据库表结构。这是描述的重点之一。7.接口的传输频率（兆/秒）：定量说明每秒最大流量。8.接口带宽：定量说明带宽，如多少兆。9.接口协议：说明具体协议。10. 接口程序的算法分析：这是重点之二，要求用形式语言描述具体算法，使编码人员据此能顺利书写程序。2.52.5 外外部部接接口口 2 实实现现设设计计1.接口中文名称：2.接口英文名称：3.接口内容与功能：详细描述接口的内容与功能，如实现数据传输或数据交换。4.接口硬件设施：详细描述接口的硬件设施，如交换机、传感器或输出设备。5.接口软件或中间件：详细描述接口软件或中间件的名称、功能、使用方法、生产厂商。6.接口的数据结构：详细描述接口的数据结构，如文件结构、数据库表结构。这是描述的重点之一。7.接口的传输频率（兆/秒）：定量说明每秒最大流量。8.接口带宽：定量说明带宽，如多少兆。9.接口协议：说明具体协议。10. 接口程序的算法分析：这是重点之二，要求用形式语言描述具体算法，使编码人员据此能顺利书写程序。第第三三章章 其其它它实实现现设设计计本章描述前面没有说明的设计。如部门角色授权设计、界面设计、包装设计、维护设计、数据仓库设计等等。3.13.1 部部门门角角色色授授权权设设计计授权表的横坐标表示角色(部件、单位或岗位)，纵坐标表示功能模块， “”表示授权。该授权表是工作站上菜单设计的依据。部门部门模块模块角色角色 1角色角色 2角色角色 3角色角色 4角色角色 5模块中文名 1模块英文名 1模块中文名 2模块英文名 2模块中文名 3模块英文名 3模块中文名 4模块英文名 4模块中文名 5模块英文名 5模块中文名 6模块英文名 6模块中文名 7模块英文名 7模块中文名 8模块英文名 8模块中文名 9模块英文名 93.23.2 其其它它详详细细设设计计根据需要进行设计。第第四四章章 程程序序文文件件清清单单主要描述的内容：子系统名、程序文件名、运行平台、简要描述 （注：文档可能无法思考全面，请浏览后下载，供参考。可复制、编制，期待你的好评与关注）