《软件详细设计文档面》由会员分享，可在线阅读，更多相关《软件详细设计文档面（15页珍藏版）》请在金锄头文库上搜索。
1、研发生产中心文档编号版本A1密级商密A项目名称Xx系统项目来源Xxx系统详细设计说明书（内部资料请勿外传）编写：日期:检査：日期:审核：日期:批准：日期:XX公司版权所有不得复制文档变更记录序号变更（+/-）说明作者版本号日期批准12目录1. 引言31.1编写目的和范围31.2术语表31.3参考资料41.4使用的文字处理和绘图工具42. 全局数据结构说明62.1常量62.2变量62.3数据结构63. 模块设计83.1用例图83.2功能设计说明83.2.1 模块 183.2.2 模块 294. 接口设计104.1内部接口 104.2外部接口 104.2.1接口说明104.2.2调用方式115.
2、数据库设计116. 系统安全保密设计116.1说明116.2设计116.2.1数据传输部分116.2.2 IP过滤分部116.2.3身份验证部分117. 系统性能设计128. 系统出错处理121.引言1.1背景此文档的背景1.2编写目的和范围说明写这份详细设计说明书的目的。本详细设计说明书编写的目的是说明程序模块的设计考虑，舌程序描述、输入/输岀、 算法和流程逻辑等为软件编程和系统维护提供基础本说明书的预期读者为系统设计人员、 软件开发人员、软件测试人员和项目评审人员。1.3术语表定义系统或产品中涉及的重要术语，为读者在阅读文档时提供必要的参考信息。序号术语或缩略语说明性定义1PMProjec
3、t Manager,项目经理21.4参考资料列岀有关资料的名称、作者、文件编号或版本等。参考资料包括: a.需求说明书、架构设计说明书等；b本项目的其他已发表的文件；c引用文件、资料、软件开发标准等。资料名称作者文件编号、版本资料存放地点1.5使用的文字处理和绘图工具文字处理软件：编写设计文档使用的文字处理软件，如edOffice 绘图工具：使用的uML工具，如Rose、Jude、Visio2. 设计概述2.1任务和目标2.1.1需求概述2.1.2运行环境概述2.1.3条件与限制2.1.4详细设计方法和工具3. 系统详细需求分析主要对系统级的需求进行分析首先应对需求分析提岀的企业需求进一步确认
4、并对由 于情况变化而带来的需求变化进行较为详细的分析。3.1详细需求分析3.1.1详细功能需求分析3.1.2详细性能需求分析3.1.3详细资源需求分析3.1.4详细接口需求分析3.1.5详细系统运行环境及限制条件分析4. 总体方案确认着重解决系统总体结构确认及界面划分问题。4.1系统总体结构确认对系统组成、逻辑结构及层次进行确认，对应用系统、支撑系统及各自实现的功能进行 确认，细化集成设计及系统工作流程特别要注意因软件的引进造成的系统本身结构和公司 其他系统的结构变化。包括：4.1.1系统组成、逻辑结构及层次确认4.1.2应用系统结构确认4.1.3支撑系统结构确认4.1.4系统集成确认4.1.
5、5系统工作流程确认4.2系统详细界面划分4.2.1应用系统与支撑系统的详细界面划分应用系统与支撑系统之间的界面包括系统主服务器与其他服务器的服务范围及访问方 式，网络及数据库对应用系统的支撑方式，全局数据的管理与存取方式等。4.2.2系统内部详细界面划分系统各功能之间的界面包括覆盖范围模块间功能调用涉及到的系统模块及方法全局 数据格式，系统性能要求等。5. 全局数据结构说明本章说明本程序系统中使用的全局数据常量、变量和数据结构。5.1常量包括数据文件名称及其所在目录，功能说明，具体常量说明等。5.2变量本章说明本程序系统中使用的全局数据常量、变量和数据结构。5.3数据结构包括数据结构名称，功能
6、说明，具体数据结构说明（定义、注释、取值）等。6. 系统详细设计6.1功能结构图6.2系统结构设计及子系统划分对系统的组成及逻辑结构进行设计前确认。划分系统功能模块或子系统（如果有或者有必要，特别是大型的软件系统）6.3系统功能模块详细设计按结构化设计方法，在系统功能逐层分解的基础上对系统各功能模块或子系统进行设 计。此为详细设计的主要部分之一。用层次图描述系统的总体结构、功能分解及各个模块之间的相互调用关系和信息交互， 用IPO图或其他方法描述各模块完成的功能。以上建议采用P0图进行功能分解与模块描 述，更高的要求建议采用DEFO方法进行功能模型设计。详细设计应用系统的各个构成模块完成的功能
7、及其相互之间的关用IPO或结构图描 述各模块的组成结构、算法、模块间的接口关系，以及需求、功能和模块三者之间的交叉参 照关系。每个模块的描述说明可参照以下格式：模块编号：模块名称：输入：处理：算法描述：输岀：其中处理和算法描述部分主要采用伪码或具体的程序语言完成。对详细设计更高的要求建议用DEFO图进行各功能模块的设计。如果对软件需进行二次开发（包括功能扩展、功能改造、用户界面改造等则相应的 设计工作应该设立子课题完成。6.4系统界面详细设计系统界面说明应用系统软件的各种接口整个系统的其他接口 （如系统硬件接口、通讯 接口等）在相应的部分说明。6.4.1外部界面设计根据系统界面划分进行系统外部
8、界面设计对系统的所有外部接（包括功能和数据接 口）进行设计。6.4.2内部界面设计设计系统内部各功能模块间的调用关系和数据接口。6.4.3用户界面设计规定人机界面的内容、界面风格、调用方式等，包括所谓的表单设计、报表设计和用户 需要的打印输岀等设计。此部分内容可能比较多。7. 开发和测试生产环境说明7.1开发环境7.2测试及产品环境-Developme nt evn ir onment: programm ing lanu ague, databaseVs 2010 - svn - iss 6.1 + - mysql/sql server 2005/2008 - .net framwork 4
9、.0- Testi ng &producti on en vir onment: OS, database - .net framwork 4.0Wi ndwos 2003, iis 6.0, MySQL,&模块设计8.1用例图8.2功能设计说明8.2.1模块1模块1主要分为以下几个子模块：子模块、子模块2和子模块N。8211子模块18.2.1.1.1设计图821.1.2功能描述简要描述子模块1的业务功能。821.1.3输入数据详细描述用户输入的数据包括任何输入设备以及这些数据的有效性检验规则。详细描述从物理模型中的哪些表获取数据以及获取这些数据的条件。8.2.1.1.4输出数据详细描述子功能
10、1所产生的数据以及这些数据的表现形式。821.1.5业务算法和流程从业务角度详细描述根据输入数据产生输岀数据的业务算法和流程。8.2.1.1.6数据设计给岀本程序中的局部数据结构说明包括数据结构名称，功能说明，具体数据结构说明 （定义、注释设计、取值）等。相关数据库表，数据存储设计（具体说明需要以文件方式保 存的数据文件名、数据存储格式、数据项及属性等。8.2.1.1.7源程序文件说明给岀本程序的各源程序文件的说明包括源程序文件名称及其所在目录功能说明，包 含的前导文件及函数名称等。8.2.1.1.8函数说明具体说明本程序中的各个函数，包括函数名称及其所在文件，功能，格式，参数，全局 变量，局
11、部变量，返回值，算法说明，使用约束等。8.2.1.1.9限制条件8.2.1.1.10其他说明8.2.2模块2模块1主要分为以下几个子模块：子模块、子模块2和子模块N。8.2.21子模块18.2.2.1.1设计图8.221.2功能描述简要描述子模块1的业务功能。8.221.3输入数据详细描述用户输入的数据包括任何输入设备以及这些数据的有效性检验规则。详细描述从物理模型中的哪些表获取数据以及获取这些数据的条件。8.221.4输出数据详细描述子功能1所产生的数据以及这些数据的表现形式。8.221.5业务算法和流程从业务角度详细描述根据输入数据产生输岀数据的业务算法和流程。8.2.2.1.6数据设计给
12、岀本程序中的局部数据结构说明包括数据结构名称，功能说明，具体数据结构说明 （定义、注释设计、取值）等。相关数据库表，数据存储设计（具体说明需要以文件方式保 存的数据文件名、数据存储格式、数据项及属性等。8.2.2.1.7源程序文件说明给岀本程序的各源程序文件的说明包括源程序文件名称及其所在目录功能说明，包 含的前导文件及函数名称等。8.2.2.1.8函数说明具体说明本程序中的各个函数，包括函数名称及其所在文件，功能，格式，参数，全局 变量，局部变量，返回值，算法说明，使用约束等。8.2.2.1.9限制条件8.2.2.1.10其他说明9.接口设计9.1内部接口9.2外部接口9.2.1接口说明例如
13、：XX子系统通过XX从XX子系统取得XX等，相关标准，调用示例，可根据需要增 加章节描述接口。9.2.2调用方式例如：内部接口调用：例：/*通过用户服务号码取得该客户认证密码等信息，如果该客户存在返回为其他情况 参考错误编码*/public RUserlnfo getUserinfo (String userNo);10. 数据库设计详见xxx数据库设计说明书如果数据库设计内容比较少，则直接在此处描述。11. 系统安全保密设计11.1说明例如：由于存在与外部系统的接P所以需要考虑访问安全的问题11.2设计例如：分为数据传输部分ip过滤部分身份验证部分章节可补充11.2.1数据传输部分例如：在部
14、分数据传递的时候考虑以https协议,需要在部署的时候作相关处理11.2.2 IP过滤分部例如：可在系统前端通过?ilter实现该Filter实现对该地址访问的EP过滤作用可 信任IP地址通过xml文件进行配置11.2.3身份验证部分例如：对信任的用户颁发身份验证码通过该标识进行身份识别12. 系统性能设计13. 系统出错处理例如：为了在系统岀现异常情况下给用户以明确的提示，可采用两种方式予以提示:1. 使用Javascript的alert()函数直接提示，这主要在输入或修改的情况下使用；2. 使用统一的错误界面提示，该界面对应于Trorpage.jsp页面。错误界面样式如下 图所示：错误提示：“错误提示内容”返回14错误提示界面14.设计和开发规范【可以列表方式列出设计开发的参考文档的索引，内容较关键内容可以章节方式填写】14.1数据库设计规范【参见xxxx数据库设计规范14.2 .NET编码规范特别强调： 详细请参见ASP.Net文档规范 这里只做简单阐述，如有变动，会及时同事整个项目组相关人员。 不要给类名加
