概要设计说明书模板

XXX项目概要设计描述书2020年12月修订记录版本*变化状态描述日期修订者*变化状态（A-添加，M-修改，D-删除）

目录TOC\o"1-2"\h\z\u1 引言 11.1目的 11.2参考文献 11.3术语描述 12 总体设计 12.1系统概述 12.2系统设计原则 12.3应用的关键技术 22.4系统结构图 22.5系统功能模块图 22.6模块构成 22.7数据流向图 22.8网络结构图 23 硬件设备 34 支持软件 35 数据库设计 35.1数据库环境描述 35.2数据库命名规则 35.3逻辑设计 35.4物理设计 35.5表汇总 45.6数据字典表 45.7安全性设计 46 接口设计 56.1接口设计原则 56.2设计方法 56.3用户接口 76.4外部接口 76.5内部接口 77 制作购买重用分析 77.1外购模块的设计 87.2复用模块的设计 88 界面设计 89 附录 8引言1.1目的[阐述本文档目的]范文：本设计描述书详细阐明了XXX系统基本设计思想、基本功能、模块划分以及模块间接口。以便于各模块开发人员能更好地了解该系统的基本情况及各模块详细功能。1.2参考文献列出编写本描述书需要参考的文档资料文档名称，文档版本范文：《立项描述书》《立项可行性分析报告》GB/T8567计算机软件文档编制规范GB/T9385计算机软件需求规格描述规范1.3术语描述缩写、术语解释总体设计2.1系统概述[描述本系统和模块的设计思想：模块划分原则、结构设计原则、模块主要功能等。]2.2系统设计原则[描述概要设计应遵循的原则]2.3应用的关键技术［描述本文件设计应用的关键技术，如大数据hadoop、JAVAspringboot、多级服务器组建技术、分级部署等］2.4系统结构图[描述系统的内部结构，子系统/模块间的联系等，必须以图示和文字描述相结合]2.5系统功能模块图[描述本系统的功能模块组成，及其各模块间的数据接口，各模块之间的控制与被控制关系，必须以图示和文字描述相结合]2.6模块构成系统划分模块：对系统(或模块)中每一个功能，用图示或文字详细描述：概述叙述功能名称、目标和作用；输入叙述该功能输入的消息；处理描述该功能做什么，如何对输入信息进行加工并转换成输出信息；输出详述该功能输出的信息；方式自主开发、复用、外包、采购方案详述该模块的设计方案，包括自主开发、复用、外包、采购的选项。模块名称概述输入输出处理方式自主开发、复用、外包、2.7数据流向图[描述系统和外界的数据交互流程，并注明数据类型或是模块和其它模块的数据交互流程，并注明模块间交互的数据类型]2.8网络结构图[描述本系统在整体网络中的地位，及其和外界网络的关系，必须以图示和文字描述相结合]硬件设备[列出运行该软件所需要的硬设备.描述其中的新型设备及其专门功能.]支持软件[列出支持软件,包括要用到的操作系统、编程语言、编译(或汇编)程序、测试支持软件等及各软件的版本。]数据库设计[客户化开发类、维护类项目可将数据库设计独立一份文档，见《数据库设计说明书》]5.1数据库环境描述[描述所采用的数据库系统，设计工具，编程工具等。]5.2数据库命名规则[提示：（1）完整并且清楚的描述本数据库的命名规则。数据库表的命名规则列的命名规则存储过程的命名规则触发器的命名规则（2）如果本数据库的命名规则与机构的标准不完全一致的话，请作出解释。

]5.3逻辑设计[数据库设计人员根据需求文档，创建与数据库相关的那部分实体关系图（ERD）。如果采用面向对象方法（OOAD），这里实体相当于类（class）。]5.4物理设计[主要是设计表结构。一般地，实体对应于表，实体的属性对应于表的列，实体之间的关系成为表的约束。逻辑设计中的实体大部分可以转换成物理设计中的表，但是它们并不一定是一一对应的。对表结构进行规范化处理（第三范式）。]5.5表汇总表名功能描述Sys_dict数据字典表…………5.6数据字典表表名：Sys_code索引：group_id+dict_id（key）字段名数据类型NULL中文描述code_idNumber(8)NN代码编号code_nameVarchar2(80)NN代码名称dict_idNumber(8)NN字典编码dict_nameVarchar2(80)NN字典名称Dict_valueVarchar2(255)NN字典值Dict_indexNumber(3)N字典顺序remarkVarchar2(255)N备注5.7安全性设计5.7.1防止用户直接操作数据库的方法[提示：用户只能用帐号登陆到应用软件，通过应用软件访问数据库，而没有其它途径操作数据库。]5.7.2用户帐号密码的加密方法[提示：对用户帐号的密码进行加密处理，确保在任何地方都不会出现密码的明文。]5.7.3角色与权限[提示：确定每个角色对数据库表的操作权限，如创建、检索、更新、删除等。每个角色拥有刚好能够完成任务的权限，不多也不少。在应用时再为用户分配角色，则每个用户的权限等于他所兼角色的权限之和。]角色可以访问的表与列操作权限角色A角色B接口设计6.1接口设计原则取得一致性类似的情况应该有让使用者有一致性的操作。在提示、选单与描述文件中，应该采用同样的名词。并且保持命令的一贯性。让重度使用者使用快捷方式当使用频率增加时，使用者会希望减少互动的次数、让每次的互动能够一次做更多的动作。缩写、功能键、隐藏功能与综观全局的功能，对专家来说非常有用。提供有意义的回馈当使用者做出一些动作时，系统应该提供回馈。越频繁的动作，其回馈的强度可以低一些。越重要或不寻常的动作，其回馈强度应该要显著一些。设计对话产生结束6.2设计方法接口是提供给其他模块或者系统使用的一种约定或者规范。因此接口必须要保证足够的稳定性和易用性。这是设计接口的基本要求。1.稳定性接口必须相对稳定，否则将导致接口的使用者和提供者为了适应新接口而不断修改接口的实现，可能重复进行无用功，严重时影响整个软件开发进度。那么如何保证设计的接口相对稳定呢？首先，接口的语义必须明确。包括接口调用方法、接口名称、参数的类型和名称。抽象的接口名称或者参数名称使人困惑或者理解错误。如下例：History::SetAttribute设置历史记录的属性，初看不知道该接口要做什么。除非History的属性很多否则没有必要设计这样的接口。ioctlC库中的ioctl，其实很难用原因是需要设置项太多，每个项的参数又不太一致，接口使用者的压力就较大了。但是接口设计者也是不得已而为之，由于IO的设置接口的应用情况较多，如果每个设置接口都单独提供一个接口则会导致非常多的接口，另外就是保证接口的相对稳定，采用抽象的数据的接口便于移植和稳定。因此，明确的接口语义例外情况就是对于辅助功能，如果需要较多接口，则可以合成一个接口，采用不同参数区分（如windows中的窗口处理过程类型的定义也是这种情况）。其次，采用版本定义来区分接口的差异。比如提供接口版本查询功能，接口实现着提供接口版本的查询功能。2.易用性接口是提供给第三方使用的，较难用的接口会导致接口使用者的抱怨。如：SetCookie(void*handle,constCookieParam¶m);GetCookie(void*handle,CookieParam¶m);此接口名称的意义还是比较明确的，但是参数CookieParam过于抽象，将导致接口的调用者在使用接口时，需要将基本数据类型的值组成一个CookieParam类型，然后才能调用接口。这是一种糟糕的接口设计。既不便于使用又不便于编译器优化（待确认）如果该为下面的接口则较容易使用SetCookie(void*handle,constURL&url,constString&cookie);GetCookie(void*handle,constURL&url,Stringcookie);除非接口的参数个数超过5个，否则最好采用基本数据类型作为参数。超过5个参数的函数一方面给调用者带来困难，参数排列组合的情况过多，另一方面就是不利于编译器优化时采用寄存器传递参数。6.3用户接口[描述提供给用户操作的用户界面采用的形式，如屏幕格式、报表格式、菜单格式等]6.4外部接口[描述本系统同外界的所有接口的安排包括软件与硬件之间的接口、本系统与各支持系统之间的接口关系。]，配置文件。6.5内部接口[描述本系统之内的各个系统元素之间的接口的安排。]，配置文件等。制作购买重用分析软件复用有三个基本原则：（1）必须有可以复用的对象；（2）所设计的可复用对象必须是有用的；（3）复用者需要知道如何使用被复用的对象。软件复用包括两个相关过程：即可复用软件（构件）或软件的可复用部分的开发(DevelopmentforReuse)和基于可复用软件（构件）或软件可复用的部分的应用系统构造（集成和组装）（DevelopmentwithReuse）。采用软件复用技术主要有以下优点：（1）提高软件生产率、减少开发时间；（2）提高软件质量，开发出来的软件可靠性高；（3）降低开发风险；（4）简化软件开发流程，使得软件开发易于管理；（5）降低维护难度、工作量和费用，提高了软件系统效益；（6）便于学习系统结构和建立好的系统，促进软件开发过程的标准化；（7）易于提供文档资料等。软件外购的原则（1）外购费用小于开发人力成本。（2）外购软件能大量缩短工期。（3）外购软件集成成本小于项目成本的1%。（4）外购软件技术是本