详细设计说明书模板.docx

1、详细设计说明书模板文档 文档呈送：文档抄送：XX工程详细设计说明书编 写： 参与评审：变更记录版本号变化状态修改点说明变更人存放位置审批人审批日期*变化状态：C创立，A增加，M修改，D删除修改点说明：对变化状态进展简单解释，如增加了某项功能，修改了某个模块等信息。不允许出现“根据评审意见修改等字样注：当文档未评审通过前版本号标识规那么为V0.X ,第一次评审通过后，版本号直接升级为V1.0，之后变更按照V1.X升级。1文档简介说明本局部要描述文档的目的，帮助读者对本文档建立根本印象，并为阅读后续内容扫清障。蓝色字体局部是文档的说明，请各位同事在完成文档撰写后删除该局部。编写目的说明本局部主要阐

2、述文档目的，而非工程目的。否那么造成同一工程多个文档之间的内容重复，不利于文档维护。预期读者和阅读建议说明指定需要认真阅读此文档的人员。本小节应指明文档针对的读者对象，最好列出各种读者角色，并说明每种读者角色应该重点阅读的章节。指明文档组织方式，简要描述各文档各局部关注的内容和解决的问题。定义、缩写词、略语说明按字母或拼音顺序列出所有的定义和缩略语，以便读者可以正确地理解?架构设计说明书?，包括词头和缩写。注意：只需要列出对理解本文有用的术语。序号术语/缩略语说明/定义英文全称中文译名123.参考资料说明列举编写?架构设计说明书?时所参考的资料或其它来源。包括但不限于：用户界面风格指导、合同、

3、标准、系统需求规格说明书、用户需求、相关产品的产品需求规格说明书等。可根据工程的实际情况选择参考资料的范围，但至少应包括用户需求说明书和需求分析说明书。作者文献名称出版单位或归属单位版本或日期2前提和约束前提条件说明对详细设计工作依赖的上游文档做说明。可使用表格或文字进展简要说明，没有的工程写无。类别文件名称主要依据章节及内容是否完全依据需求是架构是概要设计是其他前提条件是特殊情况说明：限制和约束说明阐述应遵循的重要限制和约束，包括技术条件、软硬件条件、功能、性能目标约束等。3综合描述3.1系统目标说明系统最终要解决的实际问题或要到达的用户要求，系统如何能够做到客户满意。3.2系统需求说明系统

4、由上游文档规定的需求的简要说明。说明本系统，本文档涵盖的需求及功能实现局部。3.3系统概述说明简述系统功能，映射详细设计的根底轮廓。用系统构造图表示系统内的包和主要类的名称、标识符和它们之间的层次构造关系，可以以系统体系构造划分，也可以由类类别划分(边界类、控制类、助手类、实体类、数据类)，甚至可以由功能构造划分。3.4程序构造说明说明结合上游文件中的逻辑视图，描述最终的程序划分、构造图及功能与调用关系简要说明、程序种类说明。本节为以下详细设计的简要索引，为系统程序的上层构造体系描述。详细设计时可能得不到准确的最终程序文件名列表，但是应当尽量完整说明其种类和主要文件内容。建议使用UML图配合文

5、字说明。3.5源程序及编译组装说明说明结合上游文件中的物理视图，本处为源程序和前一节的最终程序如函数库、可执行程序、资源文件等的对照表，以及从源程序文件转化成这些最终文件的具体过程编译、组装描述。在详细设计时可能得不到准确的源程序文件名，但是应当尽量完整说明其种类和主要文件内容。如果不同的文件具有不同的编译组装方式，那么应在此处分别描述清楚。在此处应明确分出各级编译单元，即哪些文件需要一起编译生成一个或一组编译后的文件。编译单元文件可以是最终文件也可以是源程序和最终文件之间的中间文件。建议使用UML图配合文字说明。4系统详细设计说明系统详细设计应当以3.4节程序构造说明节内容为索引，而不是3.

6、5节源程序及编译组装说明，换句话说，应当以最终的物理功能实现逻辑视图为主线索，源程序的构造物理视图作为辅线索，结合数据构造数据视图进展存储设计，结合模块间交互运行视图。编写原那么为公用的，重要的，接口类的程序段，应当尽量组织在文档前部，以示声明。功能性的可以放在文档偏后的位置，如果使用公共模块应当标明引用章节位置。建议在设计时做好公共模块的封装和组织。如：在说明公共函数所在的动态库时，如果动态库只有一个，而会被三个其他程序调用，应领先描述本动态库，说明动态库的详细设计，其他程序调用时说明引用地址，并列出源程序与函数的对照表。如果遇到概要设计中没有写明的逻辑问题，那么应通知概要设计人员及时讨论并

7、变更概要设计。本章描述重点是程序段面向对象中称作类中的方法或在面向过程中称为函数。在描述程序段过程中兼顾数据，流程，构造等内容。菜单级别组织：参考上游文档中五视图的划分，建议如下划分详细设计内容对系统模块的划分可按以下两种方式进展：方式一按系统的层级进展分解，每个层机中分别描述模块的功能及交互数据等内容，如：4.1系统第一层分解描述4.1,1系统第二层分解4.1.1.1系统第三层分解4.1.1.1.1函数名称1方式二先划分子系统再划分包，再划分类，最后至方法：4.1子系统4.1.1包定义4.1.1.1类定义4.1.1.1.1方法名称1以下以方式二为例说明：菜单层级可以根据工程大小变化，方法或函

8、数内的内容框架应当按照模板进展描述。本处无文字。4.1XXX子系统名称说明子系统描述，参考上游文件进展描述。说明子系统的功能。建议使用UML包图描述并附加说明。需概括说明可以被其他系统调用接口，及需要调用其他接口情况。如果较多可以使用列表说明。4.1.1XXX包名称说明说明本包的功能，作用，划分依据，包内类的相互关系及其他包相关内容。建议使用UML类图并并附加说明。需概括说明可以被其他包调用接口，及需要调用其他包的情况。如果较多可以使用列表说明。4.1.1.1XXX类名称说明说明本类的功能，作用，划分依据，类内各个函数的相互关系及其他包相关内容。需说明可以被其他类调用接口，及需要调用其他类的情

9、况。如果较多可以使用列表说明。4.1.1.1.1XXXXX函数或方法名称1a)方法特征描述说明b)功能性能描述说明c)输入/输出项说明d)数据构造说明说明e)调用关系说明f)算法说明g)程序逻辑流程图说明4.2XXX子系统名称2说明。5用户界面详细设计5.1界面构造5.1.1界面构造或菜单构造5.1.1.1 根本框架5.1.1.2框架构造描述Container“container“ 就是将页面中的所有元素包在一起的局部，这局部还可以命名为: “wrapper“, “wrap“, “page“.Header“header 是页面的头部区域，一般来讲，它包含的logo和一些其他元素。这局部还可以命

10、名为:“page-header (或 pageHeader).Navbar“navbar“等同于横向的导航栏，是最典型的网页元素。这局部还可以命名为:“nav, “navigation, “nav-wrapper.Menu“Menu区域包含一般的和菜单，这局部还可以命名为: “subNav “, “links“，“sidebar-main.Main“Main是网页的主要区域，所有业务的处理区域。这局部还可以命名为: “content“, “main-content (或“mainContent)。Footer“Footer包含附加信息如软件的开发商信息或软件版本发布信息，这局部还可以命名为:

11、“copyright“5.2界面设计及模块分析5.2.1界面设计1、采用CSS+DIV重构界面。将界面数据表现和样式别离，提高页面浏览速度，不使用TABLE。2、提供页面信息交互。提供操作结果确认在提交数据，或是载有数据的页面关闭，或其他需要和用户进展确认交互的场景，需要软件能够提供一个以弹出页面形式，要求用户确认执行结果的对话框，例如：提示确认输入信息正确：弹出对话框，并将已填写的内容列出，要求用户确认内容的正确性，给出“确定和“取消的选择按钮；a)与正在进展的操作无关的按钮应该加以屏蔽，例如：按钮背景为灰色显示；b)对可能造成数据无法恢复的操作必须提供确认信息，给用户放弃选择的时机；c)非

12、法的输入或操作应有足够的提示说明；d)对运行过程中出现问题而引起错误的地方要有提示，让用户明白错误出处，防止形成无限期的等待；页面信息提示在web页面提供的功能中，很多情况需要系统发送一些必要的提示信息到页面显示给用户，这些信息的分类有：警告信息、制止信息、操作执行成功信息、操作执行失败信息、错误信息、提示信息。这些信息在当前页面或弹出页面上显示。如果采用弹出对话框的形式，对话框的页面构造如下列图：标题区：简要给出此次提示信息的性质，例如：提示：确认提交！图标区：给出和此次提示信息性质匹配的图标；提示信息区：给出此次提示信息的具体内容；按钮区：给出供用户进展选择的按钮，例如：确认，取消；对于对

13、话框的背景颜色，要求和系统的整体风格选取的颜色一致，而右上角的操作区只保存关闭一个可操作功能，最小化和最大化的功能将不显示。5.2.2触发方式界面通过点击左侧导航菜单，在右侧main参照5.1.1.2展示主要页面，显示数据，图表等内容等；按钮触发，通过点击页面上的按钮触发事件，如点击按钮显示页面等。除了这两个主要的触发方式，系统还包含鼠标点击触发事件，悬浮鼠标等触发方式；5.2.3系统模块设计分析系统主要包块用户管理，数据管理，受众分析，受众查询，受众查询，数据输出，报表导出，系统管理等模块；用户管理主要用来添加，修改，删除用户，设置登陆用户；数据管理对数据源进展增删，新接入数据源那么增加，去

14、掉数据源那么删除；对标签体系进展管理，包括标签和关键字的增删查改；对地区编码进展管理；受众分析主要以动态折线图的形式展示当前受众的数量变化趋势和以折线图和柱状图的形式展示受众在地域、行业上的分布态势；受众查询那么主要选择人群维度标签，根据已选项输出受众分布图和选择地区维度标签，根据已选条件输出受众分布图；数据输出主要根据查询条件，输出受众，手机输出IMEI或MAC，固网输出cookie；报表导出根据历史数据，生成受众分析和受众查询的报表供下载；系统管理提供系统设置和对系统的操作日志进展查询6尚未解决的问题7资源对象说明说明使用文字内容说明使用绘图工具的信息，版本。需要将设计时使用的图的原始文件以对象方式插入文档，文件名中后缀版本与本文档版本一致。其他较小资源也可以插入，较大资源可以给出svn。