概要设计与详细设计如何编写

- 日理万妓 2022-07-13 03:00 485阅读 0赞

撰写的设计文档主要分为：总体概要设计文档 + 详细设计文档，后简称为“**概设**”+“**详设**”。

总设和详设都应该包含的部分：

**（1） 需求**：一般以产品的语言描述，这一块可以拷贝产品需求文档中的story list部分；

**（2） 名词解释（可选）**：非相关领域内的同学需要看到文档需要提前了解的一些概念性质的东西；

**（3） 设计目标**：又分为功能目标和性能目标，功能目标一般是对产品需求的技术描述，性能目标是根据产品给出的数据对性能进行的评估。一般来说，新服务必须要有性能目标一项，性能目标可能会影响设计方案。

除了都应该包含的部分，总体概要设计一般还包含：

**（1） 系统架构**：一般来说会有个简单的架构图，并配以文字对架构进行简要说明；

**（2） 模块简介**：架构图中如果有很多模块，需要对各个模块的功能进行简要介绍；

**（3） 设计与折衷**：设计与折衷是总体概要设计中最重要的部分；

**（4） 潜在风险（可选）**；

输出总体概要设计的时候，很多方案还是不确定的，需要在设计评审会议上确认。

总体概要设计重点在“方案折衷”，总体概要设计评审完毕之后，此时应该是所有方案都确认了，需要输出各模块的详细设计，详细设计重点在“详细”：

**（1）总体概要设计结论汇总（可选）**：达成一致的结论有个简要概述，说明详设是对这些结论的实现；

**（2）交互流程**：简要的交互可用文字说明，复杂的交互建议使用流程图，交互图或其他图形进行说明；

**（3）数据库设计**：这个是应该放在总设还是详设呢？

**（4）接口形式**：有了数据库+接口+流程，别的同学拿到详设文档，基本也能够搞定了；

**（5）其他细节**：例如公式等；

理论上输出了详细设计之后，无论谁拿到了这个详设文档，都是能够完成该项目的。

个人实践分享：

**一、 大图**

（1） 大系统或复杂流程，其架构图或者流程图会非常大，经常比A4纸或word的一页大很多，此时不宜在word中直接贴图形，贴了也看不清，建议将图放在wiki上，文档中直接贴链接；

（2） 一定要保存viso或者其他图形的源文件，否则今后改动起来要重画，代价可想而知；

**二、 设计与折衷**

（1） 设计与折衷是总设中最重要的内容，总设评审中，主要就是讨论这些折衷的优劣；

（2） 评审过后，不但要邮件周知结论，还要在总设中进行更新，说明最终决定使用了哪种方案，为什么使用这种方案；根据自己的经验，接手别人的模块、项目，拿到代码和文档，设计方案对我来说完全是个谜！！！

（3） 有时候因为排期或者其他原因，不一定采用了最优的设计方案，此时更应该在总设中记录决策的过程与原因；

（4） 最后，设计折衷是一个很好的自我辩解的机会：因为项目进度，或者历史遗留问题，我不得不采取了一个这样的设计，不要再骂我了。

**三、 性能目标**

性能目标是新模块文档必不可少的一部分，很多项目对性能影响较大的话，也必须撰写性能目标，性能一般来说可能包含以下部分：

（1） 日平均请求：一般来自产品人员的评估；

（2） 平均QPS：日平均请求 除以 4w秒得出，为什么是4w秒呢，24小时化为86400秒，取用户活跃时间为白天算，除2得4w秒；

（3） 峰值QPS：一般可以以QPS的2~4倍计算；

互联网公司，产品迭代块，项目周期长，基本没有“文档”一说，但其实写好文档，对系统和项目未来的维护是非常有帮助的。![89500447][]

[89500447]: /images/20220713/de3065d3c92e40f49bbbcb5f1fec427a.png

发表评论取消回复

表情：

评论列表（有 0 条评论，485人围观）

还没有评论，来说两句吧...

相关阅读

相关软件概要设计与详细设计的区别

概要设计与详细设计的区别概要设计就是设计软件的结构，包括组成模块，模块的层次结构，模块的调用关系，每个模块的功能等等。同时，还要设计该项目的应用系统的总体数据结构和数据库结

男娘i/ 2023年10月01日 20:52/ 0 赞/ 12 阅读

相关概要设计文档编写规范

原文链接：https://blog.csdn.net/nengyu/article/details/3758312 做软件到一定层次了，就要考虑到设计了，设计了很久，就是不系

ゞ浴缸里的玫瑰/ 2022年09月09日 14:58/ 0 赞/ 202 阅读

相关软件概要设计与详细设计的区别

[原文地址点击此处][Link 1] 概要设计与详细设计的区别概要设计就是设计软件的结构，包括组成模块，模块的层次结构，模块的调用关系，每个模块的

谁践踏了优雅/ 2022年07月13日 12:46/ 0 赞/ 410 阅读

相关概要设计与详细设计如何编写

撰写的设计文档主要分为：总体概要设计文档 + 详细设计文档，后简称为“概设”+“详设”。总设和详设都应该包含的部分：（1）需求：一般以产品的语言描述，这一块可以拷贝产

- 日理万妓/ 2022年07月13日 03:00/ 0 赞/ 486 阅读

相关概要设计与详细设计的区别

概要设计与详细设计的区别概要设计就是设计软件的结构，包括组成模块，模块的层次结构，模块的调用关系，每个模块的功能等等。同时，还要设计该项目的应用系统的总体数据结构和

Love The Way You Lie/ 2022年04月06日 06:09/ 0 赞/ 311 阅读

相关概要设计与详细设计

概要设计就是设计软件的结构，包括组成模块，模块的层次结构，模块的调用关系，每个模块的功能等等。同时，还要设计该项目的应用系统的总体数据结构和数据库结构，即应用系统要存

﹏ヽ暗。殇╰゛Y/ 2022年03月26日 18:30/ 0 赞/ 339 阅读

相关概要设计说明书

1引言 1.1编写目的为了使开发人员跟好的了解软件的设计以及让用户清楚地认识软件。 1.2背景为方便学习和工作比较忙碌的上班族和学生记录信息，避免遗忘而

超、凢脫俗/ 2022年01月10日 20:49/ 0 赞/ 473 阅读

相关概要设计模板

XXX项目概要设计说明书 XXXXXXXXXX股份有限公司 <table style="width:444.85pt;"> <tbody> <tr>

谁践踏了优雅/ 2021年11月17日 09:22/ 0 赞/ 515 阅读

相关系统设计：概要设计

一、博客网站的整体模块划分 ![2789632-65af4022a3b3bdc0.png][] 二、各个模块设计 2.1 [2789632-65af402

男娘i/ 2021年06月24日 16:11/ 0 赞/ 562 阅读

相关说说概要设计

概要设计是一个设计师根据用户交互过程和用户需求来形成交互框架和视觉框架的过程，其结果往往以反映交互控件布置、界面元素分组以及界面整体板式的页面框架图的形式来呈现。

小灰灰/ 2020年05月02日 17:52/ 0 赞/ 1040 阅读