软件开发需要编写的那些文档

转自：http://zz563143188.iteye.com/blog/1835305

 

对于软件工程学科的同学都知道，软件工程是一门技术含量高设计极其复杂的学科。为了控制好软件产品质量和规范，就必须用大量的文档约束软件工程的进度和状态。浩大的软件工程对于缺少工作和项目经验的人来说，必然是摸不着头脑不知从何开始。为了让大家能够快速适应标准的软件开发过程，今天我为大家粗略的描述开发中需要的文档，本人将按照国家软件质量标准来说明介绍。

　　在项目开发过程中，应该按要求编写好十三种文档，文档编制要求具有针对性、精确性、清晰性、完整性、灵活性、可追溯性。 

      项目文档管理软件我推荐大家使用（Telelogic doors V8.0） ，此软件可以很好的管理好繁多的项目文档。

      Telelogic doors V8.0下载： http://pan.baidu.com/share/link?shareid=372668&uk=4076915866

      Telelogic doors V8.0 使用方法介绍：  http://zz563143188.iteye.com/blog/1830393

   项目开发流程及架构详解：        http://zz563143188.iteye.com/blog/1825168

    接下来将是十三种文档的介绍（文档模板请下载附件）

 

 

　　1.◇   可行性分析报告： 
　　　　说明该软件开发项目的实现在技术上、经济上和社会因素上的可行性，评述 
为了合理地达到开发目标可供选择的各种可能实施方案，说明并论证所选定实施方案 
的理由。 

　　2.◇   项目开发计划： 
　　　     为软件项目实施方案制订出具体计划，应该包括各部分工作的负责人员、开 
发的进度、开发经费的预算、所需的硬件及软件资源等。 

　　3.◇   软件需求说明书（软件规格说明书，系统测试需要的标准文档）： 
　　         对所开发软件的功能、性能、用户界面及运行环境等作出详细的说明。它是 
在用户与开发人员双方对软件需求取得共同理解并达成协议的条件下编写的，也是实 
施开发工作的基础。该说明书应给出数据逻辑和数据采集的各项要求，为生成和维护 
系统数据文件做好准备。   

　　4.◇   概要设计说明书： 
　　　　该说明书是概要实际阶段的工作成果，它应说明功能分配、模块划分、程序 
的总体结构、输入输出以及接口设计、运行设计、数据结构设计和出错处理设计等， 
为详细设计提供基础。 

　　5.◇   详细设计说明书： 
　　　　   着重描述每一模块是怎样实现的，包括实现算法、逻辑流程等。 

　　6.◇   用户操作手册： 
　　　　   本手册详细描述软件的功能、性能和用户界面，使用户对如何使用该软件 
得到具体的了解,为操作人员提供该软件各种运行情况的有关知识，特别是操作方法 
的具体细节。 

　　7.◇   测试计划： 
　　　　为做好集成测试和验收测试，需为如何组织测试制订实施计划。计划应包括 
测试的内容、进度、条件、人员、测试用例的选取原则、测试结果允许的偏差范围等。 

　　8.◇   测试分析报告： 
　　　　   测试工作完成以后，应提交测试计划执行情况的说明，对测试结果加以分 
析，并提出测试的结论意见。 

　　9.◇   开发进度月报： 
　　　　   该月报系软件人员按月向管理部门提交的项目进展情况报告，报告应包括 
进度计划与实际执行情况的比较、阶段成果、遇到的问题和解决的办法以及下个月 
的打算等。 

　　10.◇   项目开发总结报告： 
　　　　   软件项目开发完成以后，应与项目实施计划对照，总结实际执行的情况， 
如进度、成果、资源利用、成本和投入的人力，此外，还需对开发工作做出评价， 
总结出经验和教训。 

　　11.◇   软件维护手册： 
　　　　主要包括软件系统说明、程序模块说明、操作环境、支持软件的说明、维护 
过程的说明，便于软件的维护。 

　　12.◇   软件问题报告： 
　　　　   指出软件问题的登记情况，如日期、发现人、状态、问题所属模块等，为 
软件修改提供准备文档。 

　　13.◇   软件修改报告： 
　　　　   软件产品投入运行以后，发现了需对其进行修正、更改等问题，应将存在 
的问题、修改的考虑以及修改的影响作出详细的描述，提交审批。