概要设计、详细设计：概念、方法、实践步骤

3.1制定及修改项目计划

•   项目经理根据《项目计划规程》制定概要设计计划，明确设计(式样)管理组中参与概要设计人员的工作任务和完成时间，并通知各相关者进行确认。

•   项目进行中，根据给定需求的变更和概要设计的实际进度状况的跟踪结果，及时调整或重新制定概要设计的详细进度计划。

•   根据概要设计的进展状况，必要时修正计划并与客户达成一致。

注：与客户达成一致是外包的核心，计划以及核心内容和客户达成一致非常重要。

•   项目概要设计计划并入项目计划中。

3.2确定系统架构和概要设计准则

•   确定系统架构

a.  对于A、B类项目

  启动DAR（参见《决策分析规程》），分析风险、成本、进度的制约、技术、质量的要求，决定是否需要购买商业组件、是否复用已有构件。如果确认需要进行采购，请参见《供应商合同管理规程》。

  根据公司人员情况、项目业务特征、性能数据量要求、可靠性要求、成本、效率、风险等方面内容提出多种系统架构进行评定，最终选定适合项目的系统架构。

  输出参见《决策分析规程》的输出。

b.  对于非A、B类项目

  设计(式样)管理组根据公司人员情况、项目业务特征、性能数据量要求、可靠性要求、成本、效率、风险等方面内容对多种系统架构进行评定，最终选定适合项目的系统架构。

如果用户有不同于一般项目的要求或者采用了公司不熟悉的架构，开发技术(环境)组需制作项目原型，以验证技术架构方案并确保其正确性。

注：根据不同工作量、技术、质量、进度要求、团队规模等识别出项目分类，并对概要设计的关键控制点（体系结构）进行不同的管控。

•   确定概要设计准则

  设计(式样)管理组根据项目情况，确定项目的概要设计准则，准则通常包括：项目概要设计的方法、项目概要设计所使用的工具、概要设计成果物所使用的部分模板等。

  设计(式样)管理组定义各种方针，各单位机能模块设计时应遵循已定义的各类方针。

  通常需要定义的方针包括：操作、错误处理、日志、提示信息、异常处理、命名规约等方针。

  所定义的所有的处理方针均需形成文档，进行配置管理。

  对定义的所有内容形成《概要设计准则》。

3.3设计业务机能

•   设计(式样)管理组对《系统要件定义书》中定义的业务组件使用各种方法进行细化（包括拆分、合并、分组等），并将各需求分配到这些细分的业务组件或功能模块上。

•   设计(式样)管理组根据各类处理方针，对各单位机能组件和功能模块的外观、数据项目定义、功能概要、数据处理流程、操作方法、各机能组件或功能模块的接口和参数等进行设计。

•   定义各机能组件和功能模块的接口和参数，各设计人员需验证其接口衔接上的一致性。

•   将以上的内容加入对系统架构的描述，形成《概要设计书》。

•   设计(式样)管理组将概要设计的内容按照其和需求的对应关系填入《需求追踪矩阵》。

•   数据库逻辑设计。

3.4评审系统概要设计

•   项目经理组织项目评审专家组对概要设计的成果物进行评审（参见评审规程）。评审中发现的问题需体现于《概要设计评审报告》中。评审结束后，开发经理（PJL）跟踪这些问题，直到问题得到修正。

•   评审结束后，项目评审专家组需要根据评审的结论产生《概要设计评审报告》，并上报项目经理（PM）。

3.5确认概要设计

•   概要设计评审通过后，项目经理(PM)针对《概要设计书》取得客户的认可。

注：软件外包中的概要设计结果一般还需要客户的评审，这个也是项目屏蔽风险的主要方法，但是不同的客户技术水平并不相同，还要根据实际情况来判断。

3.6纳入基线管理

•   概要设计评审通过后，《概要设计准则》、《概要设计书》、《需求追踪矩阵》需纳入基线管理

•   本规程所产生的所有文档均需进行配置管理（参见配置管理规程）。产生的文档通常包括：

  《概要设计准则》

  《概要设计书》

  《概要设计评审报告》

3.1计划编制

产品研发经理根据《开发详细时间计划》细化设计工作，编制《系统设计计划》。经相关人员确认后，提交产品团队经理审核，审核通过后发布计划。

产品团队经理应将《系统设计计划》及时合并到《开发详细时间计划》中。

3.2设计准则确定

系统设计组根据项目情况，确定设计准则。准则通常包括：设计的方法、设计使用的工具、设计成果物所使用的模板等。

系统设计组制定各种设计方针，设计过程中需遵循已定义的方针。

3.2.1概要设计准则

概要设计方针通常包含：功能模块命名规约、功能模块操作、错误处理、异常处理、提示信息显示、日志记录等。

系统设计组汇总概要设计方针形成《概要设计准则》。

3.2.2详细设计准则

详细设计的方针通常包含：类和方法命名规约、方法输入参数的排列次序、方法输出参数的格式、提示信息输出格式、方法级日志输出格式等。

系统设计组汇总详细设计方针形成《详细设计准则》。

3.2.3设计准则评审

产品研发经理宜组织资源对《概要设计准则》、《详细设计准则》进行评审，评审通过后，由配置组进行配置管理。

3.3概要设计

3.3.1《概要设计书》编制

《概要设计书》应包含以下内容：

  系统架构设计

  根据产品的业务特征、性能要求、可靠性要求、成本等方面内容，针对产品使用的技术平台和软硬件架构，提出多种候选方案；

  方案的内容应包含：系统使用的软硬件技术平台及相关技术列表、系统的物理架构、物理器件类型、数据库管理系统类型、服务器类型、子系统划分及部署方式、系统的软件架构、第三方软件平台列表等；

  功能模块设计

  根据《产品规格说明书》的定义，结合产品的领域知识，通过拆分、合并、分组等方法，将产品的各项功能划分到子系统中，并细化到各机能组件和功能模块上；

  系统接口设计

  接口主要用于子系统/模块之间或内部系统与外部系统进行各种交互；

  接口设计应根据制定各种方针，结合业务特点，并使用相应的设计方法；

  接口设计的内容应包含：接口的名称、功能描述、接口的输入输出定义、接口的使用方法、接口的数据处理流程、输入输出的数据结构定义、异常处理机制、错误处理机制、日志记录方法及格式等；

  数据库设计

  根据业务的复杂程度和设计实现的需要，对核心和重要的数据生成数据字典，对于复杂的操作流程，进行适当的流程说明；

  完成核心和重要库表的逻辑设计；

3.3.2《概要设计书》评审

产品研发经理组织相关干系人对《概要设计书》进行评审。评审通过后，由配置组进行配置管理。

3.4视觉设计

  视觉设计的主要工作是根据交互设计的低保真原型进行高保真视觉效果设计；

  视觉设计主要内容为整体风格把握，包括页面颜色、元素外观、配图；

注：强调交互设计中的视觉设计，单独作为一项工作内容进行管理。

3.5详细设计

3.5.1《详细设计书》编制

《详细设计书》应包含以下内容：

  模块接口设计

  对用于持久化的文件进行设计，设计的内容应包含:文件的存放位置、文件名称、内容编码、内容结构、读写控制机制等；

  对持久化内存数据进行设计，设计的内容应包含数据的存储格式、数据的缓存刷新机制、数据的读写时机和方式等；

  对数据库进行物理设计。设计的内容应包含：表、视图、存储过程等；

  模块功能设计

  对模块/子模块的的命名空间进行设计。如对源代码的包结构进行设计；

  对模块/子模块的内部功能流程进行设计，将功能和职责细分到具体的类；

  对于核心的类进行属性和方法进行设计；

  对复杂的计算进行算法设计；

  共通功能设计

  对异常、错误、消息和日志进行详细的设计；

  对内存管理、线程管理等进行设计；

  对系统性能诸如：抗压性、吞吐量、响应速度、安全性等进行进行设计；

3.5.2《详细设计书》评审

产品研发经理组织相关干系人对《详细设计书》进行评审。评审通过后，由配置组进行配置管理。

3.6 前端设计

  前端设计是指根据视觉设计结果，进行CSS、HTML、JS进行编码；

  前端设计的主要工作为：超文本结构设计、样式设计、交互效果实现、浏览器兼容设计、页面性能优化；

注：强调交互设计中的视觉设计，单独作为一项工作内容进行管理。

例： 硬件架构

例： 软件架构：包括层次划分、子系统&模块划分

例： 软件技术平台

软件技术平台通常定义采用什么样的软件体系来实现具体的功能，比如采用SOA结构实现服务分散部署，用ESB解决数据通讯以及共享，采用MVC结构实现交互、业务分离，采用RIA技术支撑复杂、可视交互等等。

例： 子系统划分

例 层次、模块划分

例中对系统首先进行了平台的划分（省、市、终端）、各平台中的子系统（监控系统、分析系统）进行定义，同时对子系统中的各模块（服务）进行的明确的定义。

例 层次、模块划分

按业务功能进行划分，同时对一些共性模块进行抽象后归纳。

例 模块切分后，切分用例、流程。采用时序图的方式进行的模块间流程设计

例.  Web Service 调用的XML格式的接口设计

这个接口定义了数据的格式、含义、类型等方面的内容。

例.  API调用模式的接口设计

例 数据库设计（E-R图）

例 数据字典

补充

例 内存设计

补充

例 配置文件设计

补充

例， 画面一览

例，画面迁移

画面迁移主要描述画面间的动作关系、定义所有画面的出入口等内容。

例 数据模版

例，设定质量以及效率的目标