详细设计说明书.docx

1、详细设计说明书文档作者:文档呈送:文档抄送：项目详细设计说明书编 写： 审 核: 批 准: 参及评审： 变更记录版本号变化状态修改点说明变更人存放位置审批人审批日期*变化状态:C创建，A增加,修改，D删除修改点说明：对变化状态进行简单解释，如增加了某项功能，修改了某个模块等信息。不允许出现“根据评审意见修改等字样”注:当文档未评审通过前版本号标识规则为V0 ,第一次评审通过后,版本号直接升级为V1.,之后变更按照V1升级。 前提和约束4编写目的4预期读者和阅读建议定义、缩写词、略语4参考资料 5前提和约束前提条件6限制和约束3综合描述31 系统目标63. 系统需求 .3系统概述7.程序结构说明

2、 73.5源程序及编译链接组装说明 74系统详细设计4.1子系统名称8.1.包名称942 子系统名称2 105 用户界面详细设计（可裁剪)105 界面结构11.1.1 界面结构或菜单结构 151.用户界面图（如无此需要，可省略) 15.界面处理流程及界面约束描述(如无此需要,可省略) 115.21 界面或模块名1 115.2. 处理流程 1.2.3 界面约束及事件约束115.2.4 触发方式 11.2.5界面或模块名2116尚未解决的问题7 资源对象说明 121文档简介说明本部分要描述文档的目的,帮助读者对本文档建立基本印象，并为阅读后续内容扫清障。蓝色字体部分是文档的说明,请各位同事在完成文

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

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

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

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

7、4节程序结构说明节内容为索引，而不是3.节源程序及编译链接组装说明，换句话说，应当以最终的物理功能实现（逻辑视图）为主线索,源程序的结构(物理视图)作为辅线索，结合数据结构（数据视图)进行存储设计，结合模块间交互（运行视图)。编写原则为公用的,重要的,接口类的程序段,应当尽量组织在文档前部,以示声明。功能性的可以放在文档偏后的位置,如果使用公共模块应当标明引用章节位置。建议在设计时做好公共模块的封装和组织。如:在说明公共函数所在的动态链接库时，如果动态链接库只有一个,而会被三个其他程序调用,应当先描述本动态链接库，说明动态链接库的详细设计，其他程序调用时说明引用地址，并列出源程序及函数的对照表

8、。如果遇到概要设计中没有写明的逻辑问题,则应通知概要设计人员及时讨论并变更概要设计。本章描述重点是程序段（面向对象中称作类中的方法或在面向过程中称为函数)。在描述程序段过程中兼顾数据，流程,结构等内容。菜单级别组织:参考上游文档中五视图的划分,建议如下划分详细设计内容对系统模块的划分可按以下两种方式进行：方式一按系统的层级进行分解，每个层机中分别描述模块的功能及交互数据等内容，如：41系统第一层分解描述4.1,系统第二层分解4.1系统第三层分解4.1.1.1函数名称1方式二先划分子系统再划分包,再划分类,最后至方法:.1子系统4.1.1包定义4.1.1类定义.1.1方法名称以下以方式二为例说明

9、:菜单层级可以根据项目大小变化,方法或函数内的内容框架应当按照模板进行描述。本处无文字。4.1子系统名称说明子系统描述,参考上游文件进行描述。说明子系统的功能。建议使用包图描述并附加说明。需概括说明可以被其他系统调用接口,及需要调用其他接口情况。如果较多可以使用列表说明。4.1.1包名称说明说明本包的功能，作用,划分依据，包内类的相互关系及其他包相关内容。建议使用类图并并附加说明。需概括说明可以被其他包调用接口,及需要调用其他包的情况。如果较多可以使用列表说明。4.1.1.1类名称说明说明本类的功能，作用,划分依据，类内各个函数的相互关系及其他包相关内容。需说明可以被其他类调用接口,及需要调用

10、其他类的情况。如果较多可以使用列表说明。4.1.1.1.1函数或方法名称1a)方法特征描述说明b)功能性能描述说明方法所完成的功能,如果有明确的性能指标分配，应当也在此注明。该章节将作为单元测试的输入c)输入/输出项说明d)数据结构说明说明e)调用关系说明g)程序逻辑流程图说明4.2子系统名称2说明。5用户界面详细设计因为用户界面虽然也属于程序功能的一部分,但是多数系统的用户界面较为复杂和琐碎,需要将其及后台处理分开设计，包括数据库表设计。用户界面是作为外部接口的一部分体现在概要设计中的。本章着重设计用户界面的外观要素和界面处理流程,以及主要的界面级和界面事件级的约束。控制台程序可以以文字说明

11、，或窗口程序建议以图片说明。本处无文字。5.1界面结构5.1.1界面结构或菜单结构5.1.1.1 基本框架5.1.1.2框架结构描述“ 就是将页面中的所有元素包在一起的部分，这部分还可以命名为: “， “, “”是页面的头部区域，一般来讲，它包含网站的和一些其他元素。这部分还可以命名为:“”(或).“等同于横向的导航栏,是最典型的网页元素。这部分还可以命名为:“”, “”, “”“”区域包含一般的链接和菜单,这部分还可以命名为:“, “，“”.Main“”是网页的主要区域，所有业务的处理区域。这部分还可以命名为： “，“” (或“”)。“”包含附加信息如软件的开发商信息或软件版本发布信息,这部

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

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

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

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