软件需求，概要设计，详细设计（文档）怎么作，作什么？
写在前面
因为项目工做须要 ，须要提供《软件需求规格说明书》，《软件概要设计说明书》和《软件详细设计说明书》。因此这里整理学习一下相关文档须要的内容。文章并不设计对全部需求分析，概要设计和详细设计的详细描述。由于这其中的任何一点均可以单独提取出来成为软件工程学科中的一本书籍内容。程序员
1 软件设计的总体流程：
- 软件需求分析阶段：输出了《软件需求规格说明书》，不涉及具体实现方法。用户能看得明白，开发人员也可据此进行下面的工做，搞清楚“要解决什么问题”。
- 概要设计阶段：肯定软件系统的整体布局，各个子模块的功能和模块间的关系，与外部系统的关系，选择的技术路线。有一些研究与论证性的内容。并输出《软件概要设计说明书》。搞清楚“整体实现方案”
- 详细设计阶段：对概要设计的进一步细化，通常由各部分的担当人员依据概要设计分别完成，而后在集成，是具体的实现细节。是“程序”的蓝图，肯定每一个模块采用的算法、数据结构、接口的实现、属性、参数。并输出《软件详细设计说明书》。搞清楚“每一个模块怎么作”
2 需求分析
2.1 咱们为何须要《软件需求规格说明书》 ？
若是需求的编写只是为了解释说明软件实现的功能，那么良好的编码结构，代码注释就能够很好的实现软件的功能说明，程序员能够将编写需求的时间节约下来进行更多功能的实现； 但是，这样的状况可能更多适用于中小型项目，或者互联网项目，由于这样的项目需求不复杂，而且需求变化很快，因此研发的效率很是重要。然而，针对大型软件项目或者功能比较复杂的系统，软件研发多是多人协做的成果，因此在信息传递过程当中， 咱们只有提早考虑好软件需求的内容，才能正确评估开发软件所须要的时间，成本的要素，从而更好的管理项目。算法
2.2 《软件需求规格说明书》的通常结构
- 正文的第一章内容是1.概述，包含
- 1.1.编写目的；1.2.术语与定义；1.3.参考资料；三个部分
- 第二章要给出该项目的标准和规范，在文档的后续内容编写中以及项目开发过程当中必须遵守这个标准和规范进行。
- 第三章应该说明该项目的相关假设、限制和一些依赖条件，在后续系统部署的过程当中能够有参考意义。
- 第四章“功能规格”是重点，重点介绍这个系统的角色，界面设计思路，系统的功能视图和功能点清单，以及系统的需求用例。这个内容必须详细描述，这样才能对后续的开发和测试提供指导意义。
- 第五章“非功能规格”要对项目的性能、安全、数据的备份恢复等内容解释解释说明，一个项目除了功能完整以外，还要考虑性能、安全等相应的要求。
- 第六章“附录”，是对软件需求规格说明书的一些补充说明文档，其中的“软件需求跟踪矩阵”是重点，这份文档是对后续需求的完善程度进行了严格的控制。
3 概要设计
3.1 《概要设计说明书》的通常结构:
- 总述：需求或目标（讲一下事情的起源）、环境、局限；
- 整体设计：从全局的角度说一下 组织结构、功能、处理流程、有哪些模块、模块间的关系，运行环境等。（输出图：系统结构图，系统流程图，数据流程图，推荐在线画图工具https://www.processon.com/）
- 外部接口：整体说明外部用户、软、硬件接口(可用资源)；
- 模块设计：每一个模块“作什么”、简要说明“怎么作”（输入、输出、处理逻辑、与其它模块或系统的接口），处在什么逻辑位置、物理位置。
模块设计,能够写如下内容： 一、模块描述：说明哪些模块实现了哪些功能； 二、模块层次结构：可使用某个视角的软件框架图来表达； 三、模块间的关系：模块间依赖关系的描述，通讯机制描述； 四、模块的核心接口：说明模块传递的信息、信息的结构； 五、处理方式设计：说一些知足功能和性能的算法；
- 数据结构：逻辑结构、物理结构。
- 容灾设计：出错信息、出错处理。（可选）
- 监控设计：运行模块组合、控制、时间。（可选）
- 用户界面设计：（可选）。
- 安全设计：（可选）。
- 其它设计：（可选）。
- 制定规范（附录）： 设计原则,代码规范、接口规约、命名规则。
3.2 概要设计须要注意的地方
- 用来评价整体设计的可行性。
- 用来检查设计的模块是否完整，保证每个功能都有对应的模块来实现。
- 用来评估开发工做量、指导开发计划（在不写详细设计的状况下）。
- 概要设计阶段过于重视业务流程是个误区.
- 概要设计阶段过于重视细节实现是个误区.
4 详细设计
4.1 《详细设计说明书》的通常结构：
参考如何撰写软件详细设计内容？数据库
-
引言，包含：
编写目的，背景，参考资料，术语定义及说明安全 -
设计概述，包含：任务和目标，需求概述，运行环境概述， 条件与限制，详细设计方法和工具数据结构
-
系统详细需求分析，包含：详细需求分析，详细系统运行环境及限制条件分析接口需求分析框架
-
整体方案确认，包含： 系统整体结构确认， 系统详细界面划分工具
-
系统详细设计，包含： 系统结构设计及子系统划分，系统功能模块详细设计（采用HIPO图进行功能分解与模块描述，，用IPO或结构图描述各模块的组成结构、算法、模块间的接口关系，以及需求、功能和模块三者之间的交叉参照关系。）, 系统界面详细设计布局
每一个模块的描述说明可参照如下格式： **模块编号：** **模块名称：** **输入：** **处理：** **算法描述：** **输出：**
- 数据库系统设计
4.2 详细设计须要注意的地方
若是有或者有必要，特别是大型的软件系统，详细设计阶段划分系统功能模块或子系统。性能
5 概要设计和详细设计的区别
5.1 概要设计阶段：
在这个阶段，设计者会大体考虑并照顾模块的内部实现，但不过多纠缠于此。主要集中于划分模块、分配任务、定义调用关系。模块间的接口与传参在这个阶段要定得十分细致明确，应编写严谨的数据字典，避免后续设计产生不解或误解。概要设计通常不是一次就能作到位，而是反复地进行结构调整。典型的调整是合并功能重复的模块，或者进一步分解出能够复用的模块。在概要设计阶段，应最大限度地提取能够重用的模块，创建合理的结构体系，节省后续环节的工做量。
概要设计文档最重要的部分是分层数据流图、结构图、数据字典以及相应的文字说明等。以概要设计文档为依据，各个模块的详细设计就能够并行展开了。学习
5.2 详细设计阶段
在这个阶段，各个模块能够分给不一样的人去并行设计。在详细设计阶段，设计者的工做对象是一个模块，根据概要设计赋予的局部任务和对外接口，设计并表达出模块的算法、流程、状态转换等内容。这里要注意，若是发现有结构调整（如分解出子模块等）的必要，必须返回到概要设计阶段，将调整反应到概要设计文档中，而不能就地解决，不打招呼。 详细设计文档最重要的部分是模块的流程图、状态图、局部变量及相应的文字说明等