软工文档--机房收费系统文档总结

        窗外的绿树，风吹动，左右摇摆。

        操场边的树荫下，嬉笑的飞扬；远方的宿舍，电影在播放。

        北四楼的机房里，键盘还在喳喳唧唧敲个不停；没有等待下课的盼望，没有等待游戏童年的期待，享有此时此刻的音符。

        几天前，文档落下帷幕。汉语言的学子，在敲打键盘写下机房收费系统文档的时候，发现语言文字不是强项，呵呵。

         学习了软件工程，很重要的一部分就是给一个系统写文档。文档是管理人员、开发人员、维护和测试等人员、用户沟通的桥梁，避免产生各种误解；是一个系统得以出炉的文件性保障。一个系统的文档编制是非常重要的，它研究了系统的可行性与开发计划、需求，如何设计，如何实现，如何测试，如何使用等问题；还总结了开发经验、存在问题、成果与不足等，为今后系统的开发提供依据。

       加深文档的印象，按照自己的理解将软工文档分为系统开发前、中、后三个阶段，每个阶段都有每个阶段的指导性文档，如图：

        更具体的解析，总结为如下表格：

文档	编写目的	编写人员	完成阶段	预期读者
可行性分析报告	概况性说明该系统开发是否可行	开发人员	可行性研究	管理人员 开发人员
项目开发计划书	确定项目各个阶段的开发计划	管理人员	可行性研究 需求分析	管理人员 开发人员
软件需求说明书	明确需求，使相关人员达成共识	开发人员	需求分析	项目组织 开发人员
概要设计说明书	描述系统的整体结构和设计结构	开发人员	设计	管理、开发、维护人员
详细设计说明书	明确各个类、接口、设计结构	开发人员	实现	开发、验收、维护人员
数据库设计说明书	准确表达数据库之间的关系及设计	开发人员	设计	开发、测试人员
数据要求说明书		开发人员	需求分析	开发人员
测试计划	为测试人员对系统对系统测试提供基础性信息指导	开发人员	需求分析 设计	测试人员
测试分析报告	判定系统能否投入使用	测试人员	测试 运行维护	维护人员 开发人员
项目开发总结报告	总结开发经验，说明开发结果、对系统进行评价	开发人员	运行维护	管理人员
操作手册	软件运行过程，操作方法细节	开发人员	设计、实现 测试	用户
用户手册	指导用户快捷、正确使用该系统	开发人员	设计、实现 测试	用户
开发进度月报	回报项目进展情况，处理开发过程中出现的问题	开发人员	可行性研究、需求分析、设计、实现、 测试、运行维护	管理人员

        

       显然，这十几个文档贯穿了系统的可行性与计划研究、需求分析、设计、实现、编码、运行维护的整个过程。

       有一句关于如何学习流传的佳话：把薄书读厚，把厚书读薄。总结便是这个第二个阶段把厚书读薄。 在总结的时候对学习的东西形成宏观的把握，让自己明白学过什么。

       第一次的文档，做了简单的理解，不足的地方请大家多多指教。