1概要设计范本1
概要设计和详细设计怎么写知乎撰写的设计文档主要分为:总体概要设计文档+详细设计文档,后简称为“概设”+“详设”
总设和详设都应该包含的部分:(1)需求:一般以产品的语言描述,这一块可以拷贝产品需求文档中的storylist部分;(2)名词解释(可选):非相关领域内的同学需要看到文档需要提前了解的一些概念性质的东西;(3)设计目标:又分为功能目标和性能目标,功能目标一般是对产品需求的技术描述,性能目标是根据产品给出的数据对性能进行的评估一般来说,新服务必须要有性能目标一项,性能目标可能会影响设计除了都应该包含的部分,总体概要设计一般还包含:(1)系统架构:一般来说会有个简单的架构图,并配以文字对架构进行简要说明;(2)模块简介:架构图中如果有很多模块,需要对各个模块的功能进行简要介绍;(3)设计与折衷:设计与折衷是总体概要设计中最重要的部分;(4)潜在风险(可选);输出总体概要设计的时候,很多方案还是不确定的,需要在设计评审会议上确认
2总体概要设计重点在“方案折衷”,总体概要设计评审完毕之后,此时应该是所有方案都确认了,需要输出各模块的详细设计,详细设计重点在“详细”:(1)总体概要设计结论汇总(可选):达成一致的结论有个简要概述,说明详设是对这些结论的实现;(2)交互流程:简要的交互可用文字说明,复杂的交互建议使用流程图,交互图或其他图形进行说明;(3)数据库设计:这个是应该放在总设还是详设呢
(4)接口形式:有了数据库+接口+流程,别的同学拿到详设文档,基本也能够搞定了;(5)其他细节:例如公式等;理论上输出了详细设计之后,无论谁拿到了这个详设文档,都是能够完成该项目的
个人实践分享:一、大图(1)大系统或复杂流程,其架构图或者流程图会非常大,经常比A4纸或word的一页大很多,此时不宜在word中直接贴图形,贴了也看不清,建议将图放在wiki上,文档