完整软件详细设计文档模板最全面.docx

1、完整软件详细设计文档模板最全面研发生产中心文档编号版本A1密级商密A项目名称Xx系统项目来源Xxx系统详细设计说明书 （内部资料 请勿外传）编 写: 刘玉龙日 期：2018210检 查：日 期：审 核：日 期：批 准：日 期：XX公司版权所有 不得复制文档变更记录序号变更（+/）说明作者版本号日期批准121. 引言1.1 背景在日常教学活动中，为了检验教学质量，考察学生对于理论与实践的掌握情况以及教学质。根据学生所学学科生成考核试题检测其学习效果和教师的教学质量进行量化考核而提出的综合性的、全学科的、覆盖大多数学科基础教学内容的课程管理系统。项目背景规划如表1。1所示。项目名称项目委托单位任务

2、提出者项目承担单位课程管理系统黄振华黄振华闫亮、刘玉龙、凌文表1.1 项目背景规划课程管理系统是教学过程阶段性测评的一个重要组成部分，它需要学生信息系统提供学生的基本资料，包括姓名，学号，专业，班级等基础信息；另外，它还需要题库系统提供考核试题。1.2 编写目的和范围为了保证项目团队按时保质地完成项目目标，便于项目团队成员更好地了解项目情况，明确项目需求,使项目工作开展的各个过程合理有序，有必要以文件化的形式，把对于在需求分析的内容以书面的方式描述出来，作为项目团队成员以及项目干系人之间的共识与约定，项目生命周期内的所有项目活动的行动基础，项目团队开展和检查项目工作的依据。本项目需求规格说明书

3、用于从总体上指导课程管理系统项目各个功能模块开发顺利进行并最终得到通过评审的项目产品.本项目需求规格说明书面向项目组全体成员.1.3 术语表定义系统或产品中涉及的重要术语,为读者在阅读文档时提供必要的参考信息。序号术语或缩略语说明性定义1PMProject Manager,项目经理21.4 参考资料文档格式要求按照我国GB/T85671988国家标准和IEEE/ANSI830-1993标准规范要求进行.包括以下文件：课程管理系统需求说明书软件工程项目开发文档范例软件工程国家标准文档软件需求说明书编写规范书籍包括：软件项目管理 朱少民，韩莹 编著人民邮电出版社软件项目管理 Rajeev T Sh

4、andilya 编著 科学出版社1.5 使用的文字处理和绘图工具文字处理软件:编写设计文档使用的文字处理软件，如RedOffice 绘图工具：使用的UML工具，如Rose、Jude、Visio2. 设计概述2.1 任务和目标2.1.1 需求概述2.1.2 运行环境概述2.1.3 条件与限制2.1.4 详细设计方法和工具3. 系统详细需求分析主要对系统级的需求进行分析.首先应对需求分析提出的企业需求进一步确认，并对由于情况变化而带来的需求变化进行较为详细的分析。3.1 详细需求分析3.1.1 详细功能需求分析3.1.2 详细性能需求分析3.1.3 详细资源需求分析3.1.4 详细接口需求分析3.

5、1.5 详细系统运行环境及限制条件分析4. 总体方案确认着重解决系统总体结构确认及界面划分问题。4.1 系统总体结构确认对系统组成、逻辑结构及层次进行确认，对应用系统、支撑系统及各自实现的功能进行确认，细化集成设计及系统工作流程，特别要注意因软件的引进造成的系统本身结构和公司其他系统的结构变化。包括：4.1.1 系统组成、逻辑结构及层次确认4.1.2 应用系统结构确认4.1.3 支撑系统结构确认4.1.4 系统集成确认4.1.5 系统工作流程确认4.2 系统详细界面划分4.2.1 应用系统与支撑系统的详细界面划分应用系统与支撑系统之间的界面包括系统主服务器与其他服务器的服务范围及访问方式,网络

6、及数据库对应用系统的支撑方式，全局数据的管理与存取方式等。4.2.2 系统内部详细界面划分系统各功能之间的界面包括覆盖范围,模块间功能调用涉及到的系统模块及方法,全局数据格式，系统性能要求等。5. 全局数据结构说明本章说明本程序系统中使用的全局数据常量、变量和数据结构。5.1 常量包括数据文件名称及其所在目录，功能说明，具体常量说明等。5.2 变量本章说明本程序系统中使用的全局数据常量、变量和数据结构。5.3 数据结构包括数据结构名称，功能说明，具体数据结构说明(定义、注释、取值）等。6. 系统详细设计6.1 功能结构图6.2 系统结构设计及子系统划分对系统的组成及逻辑结构进行设计前确认。划分

7、系统功能模块或子系统（如果有或者有必要，特别是大型的软件系统）.6.3 系统功能模块详细设计按结构化设计方法，在系统功能逐层分解的基础上,对系统各功能模块或子系统进行设计。此为详细设计的主要部分之一。用层次图描述系统的总体结构、功能分解及各个模块之间的相互调用关系和信息交互，用IPO图或其他方法描述各模块完成的功能。 以上建议采用HIPO图进行功能分解与模块描述,更高的要求建议采用IDEF0方法进行功能模型设计.详细设计应用系统的各个构成模块完成的功能及其相互之间的关系，用IPO或结构图描述各模块的组成结构、算法、模块间的接口关系，以及需求、功能和模块三者之间的交叉参照关系。每个模块的描述说明

8、可参照以下格式：模块编号:模块名称:输入:处理:算法描述：输出：其中处理和算法描述部分主要采用伪码或具体的程序语言完成。对详细设计更高的要求建议用IDEF0图进行各功能模块的设计.如果对软件需进行二次开发（包括功能扩展、功能改造、用户界面改造等），则相应的设计工作应该设立子课题完成.6.4 系统界面详细设计系统界面说明应用系统软件的各种接口.整个系统的其他接口(如系统硬件接口、通讯接口等)在相应的部分说明。6.4.1 外部界面设计根据系统界面划分进行系统外部界面设计,对系统的所有外部接口（包括功能和数据接口）进行设计。6.4.2 内部界面设计设计系统内部各功能模块间的调用关系和数据接口。6.4

9、.3 用户界面设计规定人机界面的内容、界面风格、调用方式等,包括所谓的表单设计、报表设计和用户需要的打印输出等设计。此部分内容可能比较多.7. 开发和测试生产环境说明7.1 开发环境7.2 测试及产品环境- Development evnironment： programming lanuague， databaseVs 2010 svn iss 6.1 + mysql/sql server 2005/2008 .net framwork 4。0- Testing & production environment： OS， database 。net framwork 4.0Windwos 2

10、003， iis 6。0， MySQL, 8. 模块设计8.1 用例图8.2 功能设计说明8.2.1 模块1模块1主要分为以下几个子模块：子模块1、子模块2和子模块N。8.2.1.1 子模块18.2.1.1.1 设计图8.2.1.1.2 功能描述简要描述子模块1的业务功能。8.2.1.1.3 输入数据详细描述用户输入的数据(包括任何输入设备)以及这些数据的有效性检验规则。详细描述从物理模型中的哪些表获取数据以及获取这些数据的条件。8.2.1.1.4 输出数据详细描述子功能1所产生的数据以及这些数据的表现形式。8.2.1.1.5 业务算法和流程从业务角度详细描述根据输入数据产生输出数据的业务算法

11、和流程.8.2.1.1.6 数据设计给出本程序中的局部数据结构说明，包括数据结构名称，功能说明，具体数据结构说明（定义、注释设计、取值)等。相关数据库表，数据存储设计（具体说明需要以文件方式保存的数据文件名、数据存储格式、数据项及属性等。）8.2.1.1.7 源程序文件说明给出本程序的各源程序文件的说明,包括源程序文件名称及其所在目录，功能说明,包含的前导文件及函数名称等。8.2.1.1.8 函数说明具体说明本程序中的各个函数，包括函数名称及其所在文件,功能，格式，参数，全局变量，局部变量，返回值，算法说明,使用约束等。8.2.1.1.9 限制条件8.2.1.1.10 其他说明8.2.2 模块

12、2模块1主要分为以下几个子模块：子模块1、子模块2和子模块N。8.2.2.1 子模块18.2.2.1.1 设计图8.2.2.1.2 功能描述简要描述子模块1的业务功能。8.2.2.1.3 输入数据详细描述用户输入的数据（包括任何输入设备）以及这些数据的有效性检验规则。详细描述从物理模型中的哪些表获取数据以及获取这些数据的条件。8.2.2.1.4 输出数据详细描述子功能1所产生的数据以及这些数据的表现形式。8.2.2.1.5 业务算法和流程从业务角度详细描述根据输入数据产生输出数据的业务算法和流程。8.2.2.1.6 数据设计给出本程序中的局部数据结构说明，包括数据结构名称，功能说明，具体数据结

13、构说明（定义、注释设计、取值）等。相关数据库表，数据存储设计（具体说明需要以文件方式保存的数据文件名、数据存储格式、数据项及属性等。）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 接口说明例如：xx子系统通过xx从xx子系统取得xx等，相关标准

14、，调用示例，可根据需要增加章节描述接口。9.2.2 调用方式例如：内部接口调用：例： /*通过用户服务号码取得该客户认证密码等信息，如果该客户存在返回为0,其他情况参考错误编码/public RUserInfo getUserInfo （String userNo）;10. 数据库设计详见xxx数据库设计说明书如果数据库设计内容比较少，则直接在此处描述。11. 系统安全保密设计11.1 说明例如：由于存在与外部系统的接口,所以需要考虑访问安全的问题。11.2 设计例如:分为数据传输部分，IP过滤部分,身份验证部分.章节可补充11.2.1 数据传输部分例如：在部分数据传递的时候，考虑以https

15、协议，需要在部署的时候作相关处理。11.2.2 IP过滤分部例如：可在系统前端通过Filter实现，该Filter实现对该地址访问的IP过滤作用。可信任IP地址通过xml文件进行配置。11.2.3 身份验证部分例如：对信任的用户，颁发身份验证码，通过该标识进行身份识别.12. 系统性能设计13. 系统出错处理例如：为了在系统出现异常情况下给用户以明确的提示，可采用两种方式予以提示：1使用Javascript的alert()函数直接提示，这主要在输入或修改的情况下使用；2使用统一的错误界面提示，该界面对应于errorpage。jsp页面。错误界面样式如下图所示:错误提示界面14. 设计和开发规范

16、【可以列表方式列出设计开发的参考文档的索引，内容较少/关键内容可以章节方式填写】14.1 数据库设计规范【参见XXXX数据库设计规范】14.2 .NET编码规范特别强调：详细请参见ASP.Net文档规范这里只做简单阐述，如有变动，会及时同事整个项目组相关人员。（1) 不要给类名加前缀.使用PascalCasing风格，不使用匈牙利命名法 。 (2） 要用名词词组来给类型命名.使用PascalCasing风格 . （3） 类名少用缩写,不要使用下划线字符 (_）。 (4) 基类CBase的文件名为:FileBase.cs；（5） 泛型类命名：考虑用T来命名参数类型 ，类如：public clas

17、s ListT。(6） 接口（Interface）命名规范和类命名规范相同,唯一区别是 接口在名字前加上“I前缀。(7) 枚举命名:以复数结尾，表明这是一个枚举，例如：Enum ColorButtons （8） 结构命名：表明这是一个结构体，例如：Structure CustomerInfoRecord 以Record结尾除使用工具直接生成的类外,其它所有类的功能要有注释，即使只是一个数据对象；非常见功能的API必须要有功能描述的注释。独立的要被应用其他功能所调用的模块的接口和公共API的注释要完备,即包括功能说明、参数和返回值说明。其它情况的API的注释尽量完备，但不强制要求。一次性的流打开

18、后必须关闭和释放.一般地，在流打开后，都有一个try catch语句，务必加上finally块释放流资源。即使IF，While是单语句，也要使用“ ”来划分程序块。不要有完全为调试使用的日志信息，如xxxx。info（“1”)；如要使用，在调试完成后请及时删除。一些常识性代码，不需要写没必要的注释。不要用工具生成没用的注释。14.3 代码目录结构系统架构目录结构设计图,如下:结构说明：作用范围包名描述整个程序ContentImages存放图片ScriptsJquery以及样式表等Scripts/jquery-easyui1.2.6jqueryeasyui包数字为版本Scripts/jqueryui1.8。20jqueryui 包数字为版本Scripts/jthok-ui自定义的js格式文件Scripts/themesIcon格式图片以及样式Controllers./Controller控制器处理来自浏览器的输入,并返回相应页面给用户。 Data./Data放自定义的json文件Models.。/Models存放模型Scripts。./Scripts引入的各种外部js文件Views./Views存放各种类型的试图Global.asax./Global.asax注意定义路由规则等Web。config./Web.config配置文件