软件工程各类开发文档的作用

内容提纲：（1）软件工程各类开发文档的目的与作用详解

              （2）操作手册与用户手册的区别。

一、《可行性研究报告》

可行性研究报告是在制定研发项目之前，以全面、系统的分析为主要方法，经济效益为核心，对本项目实施的可能性、有效性、技术方案及技术政策进行具体、深入、细致的技术论证和经济评价，以求确定一个在技术上合理、经济上合算的最优方案和最佳时机。分析项目是否具备开发的必要性与可行性。

可行性研究报告的预期读者为系统管理人员、开发与运维人员。

简而言之，就是分析可行性，确定最优方案。

二、《项目开发计划书》

项目开发计划的作用就是用文件的形式，根据可行性研究推荐的可行方案，落实各项工作的负责人、参加人员（系统分析员、系统设计员、程序员、资料员等）以及各种资源（计算机硬件、软件工具等）的需求，制定项目开发进度、验收标准和成本概算等，以文件形式记载下来，指导整个项目开发工作的顺利进行，并为开发的下一步做准备。

预期读者是系统分析员和开发人员。

通俗些讲，就是根据可行性研究出来的最优方案，把工作内容分配下去。

三、《软件需求说明书》

软件需求说明书是需求分析阶段的一个文档，是对软件目标及范围的求精和细化，深入描述软件的功能和性能以及软件的约束范围，使用户和软件开发者对该软件的初始规定有个大概了解，便于用户、开发人员进行理解和交流。明确了开发软件的方向,程序员要根椐需求规格说明书去开发软件, 作为确认测试和验收的依据，有利于对项目的回溯和指导后续的开发和维护。

    文档读者：开发人员与用户代表。

这个就是搞需求的，开发计划书里已经计划好了你搞测试，我搞开发，他弄管理，好，那咱们开工吧，开工之前先搞清需求是啥，弄一个物理模型出来，就是系统应该是怎么样的，这就是需求说明书。

四、《概要设计说明书》

概要设计说明书是在用户的需求分析阶段的基础上，对系统做概要设计，为在需求分析阶段得到的目标系统的物理模型确定一个合理的软件系统的体系结构。包括合理地划分组成系统的模块、模块间的调用关系及模块间的接口，并且为软件系统提供所用的数据结构或者数据库结构。从而为下一阶段的详细设计做参考，设计阶段将以本文档为核心文档。

本文档的读者是项目设计和项目编码人员。

概要设计说明书阶段已经规定了系统内、外部接口，并设计好数据库。

五、《详细设计说明书》

详细设计说明书是在概要设计的基础上进一步明确系统结构，表示出软件结构的图表，完成算法设计、数据结构设计、物理设计等，详细地描述的逐个模块，包括算法和逻辑流程的具体实现方法，设计系统的物理模型等，为下一步系统的实现和测试做准备。开发人员在完成概要设计说明书的基础上，在编码阶段可以把这个描述直接翻译成用某种程序设计语言书写的程序。详细设计的结果基本上决定了最终程序代码的质量。详细设计的目标不仅仅是在逻辑上正确的实现每个模块的功能，更重要的是设计出的处理过程应该尽可能简明易懂。

编写详细设计说明说的目的就是为程序员写出实际的程序代码提供依据。它是软件详细设计阶段所有任务和所有相关人员（包括项目管理人员、软件设计人员、软件测试人员、文档编制人员和质量审核人员），所需要的参考资料。

本文档的预期读者是程序开发人员、程序测试人员与客户。

详细设计说明书对系统描述的细致程度已经到了顶级了，所以有些人也形象的把详细设计说明书的作用比喻成”后期需求方和开发方打嘴仗时的一个凭证“。详细设计说明书一般是对大型系统准备的，如果是小系统的话，概要设计说明书就够用了，详细设计说明书可以省略。

六（1）、《数据库设计说明书》

数据库设计说明书描述了机房收费系统数据库的设计，提供了数据库设计的可视性以及软件支持所需的信息，应用于系统开发前期，为了让参与本项目的项目的人员了解本系统的数据库设计思路、数据库整体架构及各种详细信息，也为了以后的各个项目可以参与借鉴该项目的经验，将数据分析的结果进一步整理，对本系统数据库的所有标识、逻辑结构和物理结构作用作出具体的设计规定和分析说明，形成最终的计算机模型，以便开发人员建立物理数据库。  

预期读者为数据库设计师、数据库管理员。

这一阶段是确定数据库的逻辑结构和物理结构。

六（2）、《数据要求说明书》

编写数据库要求说明书的目的是明确系统中各项功能和非功能性需求实现时所需要的数据，根据此数据设计数据库。同时为概要设计和详细设计人员提供设计依据，其他本项目组的开发人员也可以参阅。定义总体要求，作为用户和软件开发人员之间相互了解的基础；提供性能要求、初步设计和对用户影响的信息，作为开发人员进行设计和实施的基础；作为总体验证和确认的依据。

本文档的阅读对象为：数据库设计人员、系统测试人员

这一阶段进一步确定了数据库中的数据要求。

七、《测试计划说明书》

制定该测试计划书主要为了能够对开发过程中的部分环节进行有序、高效地测试，最终可最大限度地发现软件中的错误，并减少软件中残留的错误。描述了需要测试的特性、测试的方法、测试环境的规划、测试用例的设计方法、明确测试策略、明确谁来完成每项任务以及需要制定应急方案的所有风险等。通过测试，验证该机房管理系统系统模型已经达到设计的标准，交由项目负责人审阅并总结测试活动的成功经验与不足，以便今后更好地开展测试工作。

本文档的预期读者是系统编程人员和系统测试人员。

这一阶段是确定如何对系统进行测试的。

八、《测试分析报告》

测试分析报告是在测试的基础上，对测试的结果以及测试的数据等写成文档，对发现的问题和缺陷加以记录和分析总结，为纠正软件的存在的质量问题提供依据，同时为软件验收和交付打下基础。另外，它还有利于今后软件开发者阅读源程序，根据测试提供的数据和结果，分析源代码，掌握各函数的功能和局限性，从而缩短软件开发者的在开发时间和所耗费的精力、资金。   

本文档的预期读者是软件开发人员。

九、《项目开发总结报告》

系统的开发工作已经基本完成。写此项目开发总结报告，以方便我们在以后的项目开发中来更好的实施项目的制定开发，让我们在今后的项目开发中有更多的资料来规范我们的开发过程和提高我们的开发效率，从而创造更多公司效益。

预期读者为相关软件的开发人员。

对项目开发的总结。

十、《操作手册》

操作手册的目的在于告诉系统的使用者，系统提供了那些功能，以及如何正确地、有效地来使用这些功能。

预期读者是系统用户。

十一、《用户手册》

编写此文档的主要目的是为了给使用者提供一个使用指南，以便为首次使用该系统的用户说明使用方法，以及给已经使用过或者正在使用的用户在使用过程中遇到问题时提供解决问题的方法。

预期读者为系统用户。

附：操作手册和用户手册的区别：

操作手册是系统级别的文档，而用户手册是需求级别的文档，一个针对操作，一个针对功能详解，操作手册是想得到什么界面，如何操作，而用户手册，你要介绍为什么要有这些操作，经过这些操作，得到的结果界面是干什么用的。如果说包含关系，用户手册是包括操作手册的。

十二、《开发进度月报》

开发进度月报的编制目的是及时向有关管理部门汇报项目开发的进展和情况，以便及时发现或处理开发过程中出现的问题。一般开发进度月报是以项目组为单位每月编写的。如果被开发的软件系统规模比较大，整个工程项目被划分给若干个分项目组承担，开发进度月报将以项目组为单位按月编写。

预期读者为项目管理员。

总结：软件开发文档都是有时间顺序、操作流程顺序联系的，编写文档前首先要了解各文档的作用，有备无患。

1