软工第一次文档总结

看完视频开始写文档，但是不知道文档到底是什么，总觉得是高大上的，难度很大的，本来我就很愁文字性的东西，看着模板，知道已经给了提示，我们只需根据要求回答问题就可以，正如我们考试的简答题一样。但我还是丈二的和尚——摸不着头脑，于是参考了很多师哥师姐的博客，看着他们的博客，感受最深的就是，当时的他们就如此厉害，竟可以写出这么有水平的文档，简直就是佩服！

参考着参考着……摸索着摸索着……慢慢觉得文档形式很相似，基本都包括编写目的，文档的读者，文档的内容、作用等，现在终于写完了，对文档有了一些认识，一共有13个文档，分别分布在不同的时期编写，各有各的作用，缺一不可，贯穿着软件开发的整个过程，指导软件的开发。下面是我的理解，有不对的地方请大家指正！

软件工程分为三个大阶段，分别为定义需求阶段、设计阶段和维护阶段，文档也就贯穿于这三个阶段之中。

【定义分析阶段】

1、可行性分析报告：判断项目是否具有开发的必要！

【目的】一个软件从开始提出，就应该分析此软件是否具有开发的必要性；在经济上、技术上、操作上、法律上、时间上等方面是否能开发，比如说要调查现在市场上是不是已经存在与待开发软件相似的软件，如果已经存在将不能再次开发此软件了，否则就会出现盗版现象，严重还可能追究法律责任。只有各个方面分析之后，确定软件可以开发，将进行下一步。

【读者】项目管理员、开发人员、系统维护人员（项目管理员看过之后确定系统可以开发时，文档讲交给开发人员和维护人员参考）

2、需求分析说明书：了解用户需求，明确系统做什么

【目的】分析人员到现场了解用户的需求，确定系统是做什么的，写出系统的功能性能等。

【读者】用户、开发人员、维护人员（完成的需求分析说明书需要给用户看，确定分析人员写的说明书是否和用户的要求一致，然后让开发人员了解软件需求开发软件，维护人员也要根据用户的要求进行系统的维护）

3、数据要求说明书：明确系统功能实现需要的数据类型等

【目的】提出对数据的要求从而数据库设计人员设计出符合要求的数据库，而且也为概要设计和详细设计提供参考，测试人员进行系统测试前也应该了解系统的数据要求，不能胡乱测试而浪费时间和精力，维护人员也是根据数据要求进一步完善系统的。

【读者】数据库设计人员、开发人员、系统测试人员、维护人员

4、初步的用户手册：提供给用户使用软件的方法

【目的】在软件真正的设计之前，系统的整个蓝图应该是确定的，当然系统的主要功能也是在需求分析说明书中明确了，那么也就应该完成用户的初步使用手册。

【读者】所以用户、测试人员（除了用户测试人员也需要先了解软件的使用方法）

5、软件开发计划：项目开发总的计划

【目的】初步设计出软件的开发计划，就是开发系统的费用、时间、人员安排、软件和硬件的配置、开发环境和运行环境进行分析和说明，定下初步的计划，在以后的开发阶段遇见问题可以随之做出相应的修改。

【读者】项目经理、开发人员、用户（项目经理决定这样的计划是否可行，如果可行将按照计划进行，文档将交由开发人员进行任务分配开发，用户也有了解开发计划的权利，知道项目完成的时间）

数据流图、数据字典需要在项目开发计划中写出

【设计阶段】

6、数据库设计说明书：得到记录查询信息的数据库

【目的】根据数据要求说明书，数据库设计人员设计相应的数据库。

【读者】数据库设计者、开发人员

修改完善确定项目开发计划：根据前期定下的项目开发计划，进一步修改完善。

7、概要设计说明书：确定软件的结果，模块的功能

【目的】在需求分析基础上得到的物理模型确定一个合理的软件系统的体系结构。包括合理地划分组成系统的模块、模块间的调用关系及其模块间的接口，并且为软件系统提供所用的数据结构或者数据库结构。

【读者】开发人员、系统维护人员

8、详细设计说明书：细化各个模块的功能、性能、输入输出等

【目的】在概要设计说明书的基础上完成的，它更加仔细地清楚地描述模块中的内容，功能实现写的更加仔细。

【读者】软件开发人员、软件测试人员、软件维护人员

用户手册：在软件逐渐完成的过程中不断完善用户手册。

9、操作手册：提供使用方法

【目的】提供软件操作的步骤方法。

【读者】用户、软件培训人员、测试人员

10、测试计划：描述测试活动

【目的】测试的目的是为了尽可能多的暴露系统中存在的问题，然后进行改进，使得系统真正交给用户使用的时候少出现问题，达到用户的要求，得到用户的好评。

【读者】测试人员

11、开发进度月报：分析汇报开发进度

【目的】是软件开发了一段时间之后，对进度的总结，及时发现在开发过程中存在的问题，为以后的开发提供经验教训，提高接下来项目的开发进度。

【读者】项目经理、开发人员

12、测试分析报告：汇总系统中存在的问题，解决问题，完善系统

【目的】测试分析报告是在测试完成之后，即测试计划的基础上进行的，是对测试结果的分析和综合，是软件开发阶段中的测试过程的重要环节，对现在已经开发出的软件的功能完善和优化的重要依据，有利于今后软件开发人员进一步完善功能，做出用户满意的软件，根据测试的记录，分析原来的代码，了解现存软件的局限性，然后进一步完善，减少开发的时间和精力。

【读者】开发人员、维护人员

【维护阶段】

13、项目开发总结报告：总结经验，规范开发，提高效率

【目的】项目开发总结报告的完成就预示着项目开发已经接近尾声了，是项目已经完成，对项目的各方面的总结，对开发经验的总结，这是非常重要的，为以后项目的开发提供宝贵的经验，避免今后的项目中出现类似的问题，从而大大提高开发的效率。

【读者】项目经理、开发人员

文档正如我们学习中的计划一样，使得学习有条不紊的进行，文档也指导着项目软件开发的过程，贯穿于软件的整个生命周期。文档总结肯定有很多问题，欢迎大家指正，共同进步！