《软件开发文档及概述（通用5篇）》

教案1-第01-02讲软件开发项目管理概述 篇1

第01章 软件开发项目管理概述

上课班级：信息系统09级01班、信息系统09级02班

上课目的：通过本章的学习，要求学生了解项目的定义和基本特征，软件项目的特点，项目管理的重要性，项目管理的发展史，了解项目管理知识体系。熟悉软件项目管理的研究方法。

上课节次：第01-02讲（1-2；3-6）教学目标（重点、难点）：  项目与软件项目

 项目管理与软件项目管理（重点） 项目管理知识体系（PMBOK） 软件项目管理中的若干原则（难点） 软件项目管理的工具

0引论

软件项目过程

顾客顾客需求输入产品输出实现产品满意 广义软件工程

项目管理软件开发过程改进 软件项目的成功和失败

软件开发的困惑

 为什么我们不能开发出高质量的软件？

 为什么人类无法定义它、解释它，深刻地了解它？

 为什么一些天才的科学家穷其一生的精力也不能把这些迷惑归纳成一种科学工程学科或行业标准？

 软件工程方法不堪一击，人们无法使用它们。

软件项目失败原因

       客户需求不确定

最终产品的设计和特色只有在过程中才能变得清晰，而不是开始时 很难制定准确的计划

估计不够，低估时间和成本 来自营销、客户和管理者的压力 沟通失败是项目失败的最大的威胁 软件过程不可见

软件开发的探索

 技术

CASE,UML OO  过程控制

ISO9001,ISO9000-3,ISO15504,ISO12207 CMM,TickIT 以上措施并没有真正解决软件危机，“质量是制造出来的，不是检验出来”，在制造业适用，在软件行业作用并不大（软件过程不可见），项目失败率还是很高。

软件项目失败深层次原因

 对软件的误解是问题的根源。

 现有的方法是由那些有良好愿望但忘记了软件中的“软”的那些聪明人所创建的。他们假定开发软件就象造桥。

 方法不正确。没有人打算失败，具有讽刺意味的是为使失败最小化而创建的方法是失败的。

 开发人员士气不高，没有创造性。 管理人员、开发人员能力不够。 只重过程，不重人。 没有良好的沟通。

1、项目与软件项目

哪些活动是项目？

上课；野餐活动；集体婚礼；社区保安；开发微软的操作系统；每天的卫生保洁；神州飞船计划。

项目定义

项目是为了创造一个唯一的产品或提供一个唯一的服务而进行的临时性的努力。

项目的外在特征

 有明确的目标

 整体性：项目之间的活动具有相关性  一次性：限定的周期，独特，不可复制  资源消耗性：资源成本的约束性

 不确定性

项目的内在属性

 唯一性

 组织的临时性和开放性  与其他工作的相互依赖性  多目标

项目与日常运作的区别

 项目是一次性的，日常运作是重复进行的， 项目是以目标为导向的，日常运作是通过效率和有效性体现的， 项目是通过项目经理及其团队工作完成的，而日常运作是职能式的线性管理；  项目存在大量的变更管理，而日常运作则基本保持连贯性的。

项目生命期和阶段划分

软件项目的特殊性

 逻辑实体(非物理实体）

 相互作用的系统（一招不慎满盘皆输） 变更（柔性，可走回头路）

 渐近明细（从概括、模糊到具体，逐步细化）

软件项目实例

 社保系统

 目标：实现社会保险管理的七大保险功能  时间：1年  资金：200万

 资源：10人、设备、资料等等

2、项目管理与软件项目管理

项目管理定义

项目管理是一系列的伴随着项目的进行而进行的、目的是为了确保项目能够达到期望的结果的一系列管理行为（活动）。

项目管理5个标准化过程

实现项目目标的制约因素

          工作范围 成本

时间（进度计划）质量（客户满意度）组织（项目干系人）

项目管理的5要素

技术（Technical)方法（Methodology）

团队建设（Team Building）信息（Information）

沟通（Communication：80% jobs)

软件项目管理定义

软件项目管理是为了使软件项目能够按照预定的成本、进度、质量顺利完成，而对成本、人员、进度、质量、风险等进行分析和管理的活动。

 软件项目管理的知识来源

 项目管理  软件工程  经验技巧

3、项目管理知识体系（PMBOK）

关于PMP      PMI在1984年提出项目管理认证计划(PMP)AT&T,Bell South,Bell Core,Bell Atlantic,Us West, Citibank,IBM,EDS，ABB等参与，是目前全球认可程度最高的项目管理专业认证 是项目管理资格最重要的标志之一 详细信息参看

项目管理的九大知识体系

 范围管理——确定项目的范围， 进度管理——进度是绝大多数项目都非常强调的因素，进度管理的目标是保证项目按时完成。

 成本管理——目标是保证项目不超出预算

 人力资源管理——目标在于充分发挥“人”的主动性、创造力和工作效率。它包括组织计划的编制、人员募集和团队建设三部分

 风险管理——风险存在于任何项目中，为了将风险对项目的不利影响降至最低，人们需要对风险加以管理，包括：风险识别、风险分析、风险应对、风险监控几个过程。 质量管理——围绕质量保证和质量控制两个过程展开的。 采购管理——对物料的采购进行有效的管理。

 沟通管理——良好的沟通才能获取足够的信息、发现潜在的问题、控制好项目的各个方面。沟通管理就是要在项目干系人之间建立起良好的沟通渠道和沟通平台，保证他们能够畅通无阻的交流信息。

 集成管理——也称综合管理，就是为了满足上述8方面要求进行协调，以达到项目的预期目标。它是一项综合性、全局性的工作，主要内容是在相互冲突的目标或可选择的目标中权衡得失、作出选择。

 项目管理的9个方面并不是割裂的，而是紧密联系的，最终统一在项目管理的框架之内。从理论上讲，项目管理包括以上9个部分，但实际项目中很难做到面面俱到，通常是根据项目的实际情况针对项目的几个关键因素进行管理。

4、软件项目管理中的若干原则

项目管理的若干原则

     计划原则 Brook原则 80-20原则 默认无效原则 等等

5、软件项目管理的工具

常见项目管理工具

    Microsoft Project CA-SuperProject Project Scheduler 等等

6、案例启发

你是一个项目的项目经理，计划了一个项目需要36个月完成，然后提交领导，由于领导的原因导致项目的开始日期推延2个月，但是领导要求你按照计划完成，作为项目经理，你应该如何做？

软件开发协议 篇2

8、禁止转委托开发

在本合同有效期内，乙方必须亲自履行甲方委托的开发项目，未征得甲方的书面同意，不得将其在本合同项下的受托项目部分或全部转让给任何其它方执行。违反本项规定的，乙方将承担全部可能产生的责任。

9、保密

9.1乙方应对本合同所述的技术资料和技术秘密采取保密措施，乙方未经甲方的书面同意，不得将本项目所涉及的技术秘密和资料向与本项目无关的人员或第三方透露，也不能就有关合同内容的任何部分进行新闻的发布、公开的宣称、否认或承认。

9.2乙方知道违反本条规定将给甲方造成难以弥补的损失，为此同意承担由此产生的经济上和法律上的责任。

9.3乙方承认本合同中的技术资料和技术秘密为甲方所专有，将其对乙方进行披露并不意味着任何所有权、专利权的转让。

9.4在本合同项目的研究开发结束并通过验收后，乙方应向甲方提供本合同项目的研究成果，包括技术规范、测试文件和质量标准等相关的技术资料，或者计算机软件、文档及源代码等。乙方应归还甲方提供的所有技术资料或文件等，并承诺不保留任何复印件。

9.5乙方在下列情况下没有为任何信息保守秘密的义务，即当乙方已事先知道它无需为其保守秘密时；当该信息已为公众所知且不是由乙方未经授权而提供时；当该信息是由乙方独自开发的；或者当乙方从某第三方合法地接受该信息且没有保密限制时。

9.6本条规定的义务和权利在本合同期满或终止后将持续年有效。

10、知识产权归属

10.1本合同项目技术成果的专利申请权、计算机软件的著作、技术秘密以及技术资料等知识产权归甲方所有。同时乙方放弃计算机软件著作权的署名权。

10.2乙方不得在向甲方交付研究开发成果之前，将研究开发成果及非专利技术泄露或转让给第三方。

10.3在履行本合同期间及以后，乙方不得就本合同的研究开发项目先后与任何第三方签订或接受委托开发合同。乙方如重复签订研究开发项目合同，应对以后签订合同的无效及其对侵犯甲方的知识产权承担所有经济和法律的责任。

11、第三方知识产权

11.1乙方承诺，其在受托开发本合同项目中，不会侵犯第三方的知识产权，同时，在交付本合同成果中也不会涉及或非法使用第三方的知识产权。

11.2任何因甲方使用本项目的成果而引起对第三方知识产权的侵权诉讼，乙方应积极协助甲方进行抗辩。如确因本项目成果引起的侵权，乙方应承担所有的赔偿责任，包括甲方因诉讼产生的一切费用。

12、风险责任的承担

12.1乙方在研究开发过程中，由于受现有的科学知识、技术水平或试验条件的限制，发生无法预见、无法防止或无法克服的技术困难，导致研究开发工作全部或部分失败，该风险责任的损失由双方共同承担，即根据损失的金额各自承担50%。

12.2确定上述风险必须同时具备以下三个条件：

（1）研究开发的项目本身在国际和国内现有技术水平下具有足够的难度；

（2）研究开发方在开发过程中已充分发挥了主观的努力；

（3）同领域的专家认为在技术上是属于合理的失败。

12.3乙方发现可能致使研究开发失败或部分失败的情形时，应当及时通知甲方并采取适当措施减少损失。没有及时通知并采取适当措施，致使损失扩大的，应当就扩大的损失承担责任。

13、报酬及支付方式

提示：付款方式是指分几次付款，每次支付条件和（或）日期等内容。甲方将根据本合同项目的开发

进程支付上述报酬。

合同总金额

乙方银行帐号

支付批次 金额 支付条件 估计时间

14、违约与赔偿

14.1甲方未按本合同规定支付第一期研究开发报酬，乙方有权解除合同。

14.2甲方逾期支付第二期或第三期开发研究报酬的，自逾期的第二天起，每逾期一天支付应付报酬额的0.05%违约金，违约金总额不超过应付款额的50%。逾期二个月仍不支付的，造成研发工作停滞、延误或失败的，乙方对此不承担责任。

14.3乙方未按计划或不实施研究开发工作，甲方有权要求乙方实施研究开发计划并采取补救措施。如乙方逾期一个月仍未按计划或不实施研究开发工作，甲方有权解除本合同，并且乙方应在二周内返还所有甲方提供的研究开发报酬，返还或销毁甲方提供的有关技术资料和文件，并承担本合同报酬总额20%的违约金。

14.4乙方应按本合同规定的研究开发进程完成开发项目。如乙方逾期完成开发项目，甲方将给予乙方一个月的宽限期，并且不追究乙方的违约责任。但宽限期满后，乙方仍未完成开发项目，其违约责任应追溯到本合同规定的违约的第一天起，每延期一天向甲方支付本合同开发研究报酬总额的0.05%违约金，违约金总额不超过本合同开发研究报酬总额的50%。

14.3除了本合同第7.2条规定的条件外，乙方未能完成甲方委托的开发项目或开发成果不符合本合同约定的要求，乙方承担本合同报酬总额20%的违约金，并返还研究开发费用。

14.4乙方将甲方支付的研发经费用于履行合同以外的目的，甲方有权制止并要求其纠正。如因此造成本合同研究开发项目停滞、延误或失败的，乙方应当承担给甲方造成的损失赔偿责任。

15、不可抗力

15.1不可抗力是指本合同生效后，发生不能预见并且对其发生和后果不能防止或避免的事件，如地震、台风、水灾、火灾、战争等，致使直接影响本合同的履行或不能按约定的条件履行。

15.2发生不可抗力的一方应立即通知对方，并在十五天内提供不可抗力的详情及将有关证明文件送交对方。

15.3发生不可抗力事件时，甲乙双方应协商以寻找一个合理的解决方法，并尽一切努力减轻不可抗力产生的后果。

15.4如不可抗力事件持续三十天时，甲乙双方应友好协商解决本合同是否继续履行或终止的问题。

16、解除合同

16.1如果满足以下条件，任一方在通知对方后，都可以解除本合同。

16.2一方严重违反本合同项下的义务，并且违约方在对方通知后三十天仍未纠正，非违约方向违约方发出解除合同的书面通知时。如果该违约无法在三十天内纠正，而违约方在此期限内已经开始着手，并将以努力诚恳继续纠正此违约行为，则守约方应为违约方合理地延长该时间的期限。

16.3当一方按正常程序停止经营业务、破产、处于付款拖欠、延期偿付、公司重组或倒闭状况，或全部转让利润与债权人、书面承认无力偿还到期债务、委派清算人清算其业务或财产，或参与或接受与破产或债权人权利有关的法律或行政诉讼程序时。

16.4当本合同以任何原因终止时，乙方应立即停止使用并销毁包含甲方机密信息的所有物件，并证

明该销毁情况；或者将这些物件归还对方。

17、争议解决

17.1本合同及其修订本的有效性、履行和与本合同及其修订本效力有关的所有事宜，将受中华人民共和国法律管辖，任何争议仅适用中华人民共和国法律。

17.2甲乙双方因合同的解释或履行发生争议时，首先应争取通过友好协商解决，该协商应在三十天内解决。

17.3如协商不能解决时，合同的任何一方可将争议提交本地仲裁委员会，并按该委员会的仲裁规则进行仲裁。仲裁决定对双方都有约束力。

17.4争议进行仲裁期间，除争议事项外，甲乙双方应继续履行各自本合同中规定的义务和行使权利。

18、一般条款

18.1除非本合同另有规定，任何一方对本合同提出的任何弃权、修改或更改须以书面形式提交给对方，并经对方签字认可，否则本合同的任何条款均不得视作已被弃权、修改或更改。本合同的修改或变更，须由双方友好协商并经授权代表签署书面文件方可生效。

18.2如本合同的一条或者一条以上的条款被适用法律视为无法实施，则（1）该无法实施的条款不会影响到本合同中其他任何条款；（2）本合同应被视为从未包含该无法实施的条款；（3）双方应本着诚信的原则商议，用一条意思最接近的条款替换该无法实施的条款。

18.3合同各方在此声明并保证：（1）代表各方签署本合同的人员拥有明确的授权，其签字对签约方具有约束力；（2）本合同的执行、递交与履行不会违反各方公司的章程、规定；以及（3）本合同的执行、递交与履行已经得到全部所需合作方或公司行为的正式授权；并且本合同已对上述方形成了有效的、具有约束力的同时能按其条款执行的义务。

18.4本合同文本的定稿应以文写成，附件以文写成。合同各方在本合同执行过程中进行的所有通信联络均应以文进行。本合同以文文本为准（或“两种文本有同等法律效力”）

18.5双方同意，本合同条款的上下文如果表示出该条款在本合同有效期后仍然有效，则该条款在本合同有效期后应继续保持有效。

18.6本合同与附件构成双方间的完整的合同，并将取代之前所有的书面或口头、执行或未执行的讨论、合同或声明。未经双方授权代表再签定正式合同，本合同将不作变化、增删和修改或其他活动。

19、开发过程中的变更声明

由于甲乙双方在签订合同之际，对项目需求的了解不够深入，因此本合同中的开发内容和计划可能与实际情况不符合。在实际开发过程中，双方可能变更开发内容和开发计划。

为了避免将来发生纠纷，特此声明：本项目的实际开发内容、开发计划、验收标准以双方签字确认的《需求规格说明书》为依据。如果需求发生变更，双方将重新协商开发计划和费用。

20、签字确认

本合同一式__份，甲乙双方各持__份，自合同各方授权代表签字之日起生效。

甲方签字 签字日期

乙方签字 签字日期

软件开发合同 篇3

计算机软件开发协议

甲方：________________________

乙方：

签定日期：年日交付日期：日

甲乙双方经友好协商，双方愿在公平、诚实、信用的基础上开发计算机软件系统，且双方达成以下协议：

一、双方的权利义务

甲方：

1、甲方所开发的软件保证不是违反国家法律规定的内容，否则乙方将不予开发。

2、甲方必须保证对乙方所开发的软件不作任何侵权行为。

3、甲方必须保证对乙方所开发的软件进行拷贝、复制、泄露给第三方使用，否则乙方将追究甲方的法律责任。

4、甲方开发软件时必须经书面形式提供给乙方各项技术指标及功能。

5、甲方开发软件如需改动，必须以书面形式呈交给乙方。乙方方做改动。

乙方：

1、乙方所开发的软件必须是自行开发的，保证不是侵权软件。

2、乙方将严格按照甲方提出的各项技术指标、要求进行开发设计。

3、乙方开发的软件必须是无毒、洁净的，如造成损失由乙方负责。

4、乙方所开发的软件不得有违反国家法律规定的内容，如造成损失由乙方负责。

5、乙方所开发的软件，所有权、版权归乙方所有，甲方只有使用权。

6、乙方只对甲方提出的书面要求进行开发。

7、乙方交付时将对甲方提供技术培训及售后服务。

二、验收标准

1、甲方验收时，不得对乙方所开发的软件提出附加条件。

2、乙方所开发的软件符合甲方呈乙方的书面要求及各项技术指标即为合格。

三、结算方式

1、该软件甲方付给乙方费用总金额（人民币

2、甲乙双方签订协议的当日，甲方将预付保证金%（人民币

3、乙方交货当日，甲方验收合格后付乙方开发软件总造价的%（人民币

元整）。

四、其它

1、本协议一式两份，甲乙双方各执一份，甲方提供技术指标必须双方签字或加盖公章。

2、本协议书未尽事宜，由双方协商解决或另订协议。

3、本协议书经双方加盖公章及负责人签字后方能生效，具有法律效力。

备注：

甲方：__________________乙方：

代表：__________________代表：

地址：__________________地址：

电话：__________________电话：

软件开发合同书 篇4

软件开发合同书

为进一步明确双方的的责任，确保合同的顺利履行，根据《中华人民共和国合同法》之规定，经甲乙双方充分协商，同意以下条款，特订立签署本合同，以便共同遵守。

第一章 定义

1． 甲方：希望物流公司。

2． 乙方：联想软甲工作室。

3． 项目：编写一个进、出货的软件。

4． 合同：是指甲乙双方签署的、合同格式中甲乙双方所达成的协议，包括所有的附件、附录和上述文件所提到的构成合同的所有文件。

5． 合同价：是指根据合同规定乙方在正确的完全履行合同义务后，甲方应支付乙方的价格。

6． 工作成果：即合同标的，合同规定项目开发的设计以及功能模块。

7． 项目试运行：乙方内部调试完成后，进行交接，甲方签署《项目交接单》，即进入

项目试运行阶段，甲方应当在规定的试运行期限内，安排相关人员对项目进行全面

测试。

8． 项目测试验收：由甲方组织的验收小组实施，甲方进行系统测试和验收。测试验收

标准遵从合同中的相应规定。验收合格后签署《项目验收单》。

第二章 合同目标

甲方同意：向乙方支付规定数目的开发款项。

乙方同意：①向甲方出售合同附件1所指向的应用软件； ②按合同附件2向甲方提供

软件实施和和维护服务； ③按技术服务合同向甲方提供实施质询服务。

第三章 双方的基本权利和基本义务

甲方的权利和义务：①配合乙方工作，提供系统建设所需的数据和材料； ②依合同约

定使用合同的工作成果； ③本合同的工作成果使用应当符合国家

法律规定和社会公共利益。

乙方的权利和义务：①按时完成项目的建设，乙方保证最终测试合格的每一类目的功能

都能达到合同中关于功能的描述； ②乙方工作成果不得侵犯第三

方的合法权利。

第四章 价格

本合同金额以人民币结算，总金额为800000元。其中，固定软件费为300000元，固定软件实施费为300000元，以上价格已含税费或相类似的费用。

第五章 支付条款

甲方应按下述方式和比例向乙方支付本合同第四章规定的合同贷款。

⑴ 本合同总金额中的30%应在合同签订后10个工作日内，由甲方以打款的方式支付给乙方。

⑵ 软件安装，并经甲方试运行确认后10个工作日内，合同总额中60%由甲方以打款的方式支付给乙方。

⑶ 验收合格后，甲方签署《项目验收单》后10个工作日内，甲方支付项目尾款，即100000元。

⑷ 在验收合格完成一年内，乙方完成了甲方的售后服务任务，支付乙方履约保证金100000元。

第六章 系统实施

乙方在收到甲方首付款5天内，向甲方交付“软件”。

乙方应按合同附件1有关条款向甲方提供“软件”，包括相关技术资料。如果上述“软件”有短缺、损伤或损坏，乙方应在收到甲方正式通知后10天内免费补足上述短缺、损伤或损坏的部分。如果影响进度，由此造成的直接损失由乙方承担。

乙方将协助甲方完成“软件”的安装。

第七章 系统测试与验收

乙方在安装完成后，在2天内通知甲方组织验收，系统测试课按照附件4的系统测试好验收标准实施，验收不合格的，乙方应负责重新提供达到本合同约定的质量要求的产品。甲、乙双方应严格履行合同有关条款，如果验收过程中发现乙方在没有征的双方同意的情况下，擅自变更合同标的物，将拒绝通过验收，由此引起的一切后果及损失由乙方承担。

第八章 技术支持和售后服务

乙方应提供完善周到的技术支持和售后服务，否则，视情节轻重，从乙方的履约保证金中进行扣除。

第九章 双方的违约责任

甲方中途解除合同，应向乙方偿付退货部分贷款30%的违约金。

甲方违反合同规定拒绝接货的，应当承担由此造成的损失。

乙方不能按时交付项目，应向甲方偿付不能交货部分合同款的30%作为赔偿金。

如果乙方没有按照规定时间交货、完成软件安装和提供服务，甲方将对其课以罚款，罚款应从合同款中扣除。

任何一方未经对方的同意而单方面终止合同，应向对方赔偿相当于本合同总价款100%违约金。

第十章 不可抗力

如果双方任何一方因不可抗力，致使影响合同履行时，履行合同的期限应予延长，延长的期限应相当于事故所影响的时间。本合同所称不可抗力是指不能预见、不能克服并且不能避免的客观事件，包括自然灾害如洪水、地震、火灾和风暴等以及社会事件如战争、**、政府行为等。

甲乙双方的任何一方由于不可抗力的原因不能履行合同时，应及时向对方通报不能履行或不能完全履行的理由，在取得有关主管机关的证明后，允许延期履行、部分履行或不履行合同，并根据情况可部分或全部免予承担违约责任。

第十一章 履约保证金

本项目履约保证金为人民币100000元，期限一年。

乙方未能履行期合同规定的任何义务，甲方有权从履行保证金中获取补偿。

第十二章 装让与分包

乙方承诺本合同有乙方履行，不存在转入和分包。

第十三章 合同纠纷的解决

本合同如发生纠纷，当事人双方应当及时协商解决。若协商、解调不成，根据《中华人民共和国仲裁法》的规定向当地的仲裁委员会申请仲裁。

第十四章 合同的知识产权、保密、生效

合同的知识产权：项目的实施成果归甲方所有，包括出现有“软件”之外的其他新的软件代码的开发、报表的开发等。

保密：⑴ 双方应严格保守在合作过程中所了解的对方的商业及技术机密，否则应对此

造成的损失承担赔偿；

⑵ 为确保甲方的所有客户（包括乙方）的数据安全，甲方人员在与乙方人员交

流时必须遵守以下约定：

① 不聊天、不谈论与技术无关的事情。

② 不询问也不透露任何公司或私人的任何联系信息。如：电话、E-mail、QQ号码、网址、住址、办公地址等。

③ 所有联系信息，只限于在合同双方的签字人（或受权联系人）之间传

递。

⑶ 双方应保证其所有雇员严格遵守。

合同生效：本合同自甲乙双方当事人签字盖章后生效。合同执行期内双方不得随意变更或解除合同。合同如有未尽事宜，须经双方共同协商，做出补充规定，补充规定与本合同具有相同等效力，也可按《中华人民共和国合同法》的规定执行。本合同一式4份，甲乙双方各执2份。

第十五章 其他

本合同所有附件为本合同不可分割的一部分，与合同正文具有相同等效力。

本合同受中华人民共和国法律保护。

对本合同条款的任何变更、修改或增减，均需双方协商同意后授权代表签署书面文件，以作为本合同的组成部分，并具有同等效力。

甲方：乙方：

地址：地址：

电话：电话：

传真：传真：

邮政编码：邮政编码：

甲方代表（签字）：乙方代表（签字）：

日期：日期：

合同编号：

签字地点：

附件1应用系统软件配置及价格。

附件2软件开发、实施、维护合同。

附件3软件系统售后服务合同。

附件4项目软件系统测试和验收标准。

姓名：左俊松

班级：软件1019班学号：2010180165

软件开发文档及概述 篇5

软件开发文档及概述

文档贯穿软件工程的始终，从前期的项目准备，中期的开发到后期的维护、培训，无不以文档作为工作的依据。那么在软件项目中，都包括哪些文档呢，它们的作用又是什么呢，下面我将我的经验分享给大家。

《可行性研究报告》：这是客户在进行项目调研阶段所编写的，具有两重意义，其一，指明项目的必要性和紧迫性，并从业务角度阐述大概的功能需求，注意，只是大概，可能与最后的结果有很大出入；其二，最重要的一点就是为了要钱，向财政部要钱，将最终实现的功能写得天花乱坠，包括决策支持、全文检索、商业智能、远程报表等，但最后开发的可能仅仅是融合简单业务流程的信息输入和输出而已，但这已无关紧要，最重要的是我要到了钱。但是严格来说，这不是项目组所需的文档，于软件开发也意义不大。

《建设方案》：或者是《实施方案》，当客户从财政部申请到资金后，就要着手进行详细的调研和分析了，这里有两种情况，其一，客户自己从各个产品厂家进行相关的调研，进行汇总后，编写方案，这样，聪明、细心的软件公司就会从方案的技术环节，挖掘出客户所选择的产品，最后和这个产品公司合作来中标；其二，让和其关系很好的一家或两家软件公司（不会超过三家）编写，客户进行审核，客户最后选择了谁的方案那么最后这个项目就是这家公司的，这样很多情况并不是公开招标。

《招标书》：将《建设方案》或《实施方案》进行摘取，并附带上技术问题以及招标时的细节、注意事项，构成《招标书》，这个文件也是由客户写得，软件公司在投标前需要购买《招标书》。

《投标书》：与《招标书》所呼应，对技术问题进行相应的技术应答，包括技术标和商务标两部分。

上面几份文档，是项目前期准备时需要的，是侧重于售前方面的；而下面的文档是软件开发过程中必不可少的，我们按开发工作的时间顺序一一介绍。

《需求分析说明书》：对于软件开发来说，《需求分析说明书》就好像是盖楼时所用的图纸，是最重要的文档，由项目经理对客户相关部门进行业务调研后编写，语言侧重于从业务的角度描述功能需求。内容涉及三大部分，其一，编写目的、背景、目标任务等公共性语言；其二，功能性需求，将业务梳理成几大功能模块，一级功能下细分二级功能，依次类推，将最终细化的功能按描述、输入、处理和输出进行详细描述；其三，非功能性需求，包括性能、处理能力、进度、界面设计和运行环境的规定。

《数据库设计说明书》：我是做数据库出身，因此这部分的工作也是由我这个项目经理来做，根据《需求分析说明书》在Erwin建模工具中设计好逻辑模型和物

理模型，然后将其整理到此文档中，文档还包含数据库所有的表结构和相关的字段说明。

《概要设计说明书》：说实话，在我做过的项目中，没有编写过此文档，因为我觉得《需求分析说明书》和《详细设计说明书》就足矣了。甚至如果项目简单或时间紧急，《详细设计说明书》都会省略：）。

《详细设计说明书》：主要包含两部分内容，其一，体系结构的设计，也就是项目所采用的几层架构，以及层与层之间的通信机制，还有就是基础框架所采用的技术；其二，是本文档的核心部分，包括每个细分模块的详细设计说明，包括程序描述、功能、性能、输入项、输出项、算法、流程逻辑、接口、存储分配、注释设计、限制条件、测试计划和尚未解决的问题等内容。本说明书对项目所采用的技术和接口都做了详细的规定，是指导程序员开发的直接工具。但需要说明的是，很多项目由于时间原因，都忽略了此说明书的编写，包括本人目前在做的项目也是如此，因此本文档并不是必须的。但如果作为给客户的交付物，需要在项目完成后补全。

《计划进度》：这个不用多说，由项目经理编写，实现对项目进度的严格把控，是项目必须的文档，可用project编写。

《测试用例》：测试用例（Test Case）目前没有经典的定义。比较通常的说法是：指对一项特定的软件产品进行测试任务的描述，体现测试方案、方法、技术和策略。内容包括测试目标、测试环境、输入数据、测试步骤、预期结果、测试脚本等，并形成文档。它是将软件测试的行为活动做一个科学化的组织归纳．目的是能够将软件测试的行为转化成可管理的模式；同时测试用例也是将测试具体量化的方法之一。由此可见，《测试用例》非常重要，是对项目或产品质量的严格保证，但由于测试人员和项目组的规范性、时间进度等限制，本文档在本地区的实际项目中也很少应用，至少我认识的很多测试人员中，只有极少数的项目中会编写此文档。

《测试结果》：在项目开发阶段使用，也就是交付客户之前。文档为Excel格式，并提供关键字段的数据筛选，内容包括描述、缺陷类型（Bug、需求）、开发人员、状态、关闭时间、所属模块、提交人、解决人、备注等。其中状态包含提交、解决和确认解决，测试人员将问题提交（红色），当程序员解决后就置为解决（黄色），测试人员再次确认无误后，就修改状态为确认解决（绿色），并且添写关闭时间。

《需求变更文档》：产品交付客户之后使用。任何一个好软件，不是在第一个版本就把这些标准全部实现，而是有步骤有重点地实现，逐步成为一个好软件。因此《需求变更文档》是不必可少的，同样作个Excel表格，量化解决。包括下列几项：客户名称、需求提出人、提出日期、需求关闭时间，功能模块名，客户现在版本号，需求描述，需求分类（需求、Bug）等。每次发布新版本都把从上一版本发布之日关闭的需求列表都单独摘成一个文件，附带到这次新发布的版本之后。

此举有两个好处，其一，能够清楚的列出客户以往所提的需求，因为有一些客户提出的改动总是反反复复，一个问题一会要改成A,然后觉得不好要改成B，之后觉得还不如A好，便又要求改回去，这样给公司的进度和安排带来很大的不便，如果因为这个耽误了其他的工作，便可以有此根据和客户进行沟通，防止客户赖账；其二，可以评判技术支持和相关程序员的工作量。此文档为EXCEL格式，但最好还有一个word类型的文档，每次客户提出修改意见时，将此文档打印出来交由客户签字，作为凭证，此方法实际中并不是次次可行，一些强权客户或不敢承担责任的就不签字，那也没辙。

《测试结果》和《需求变更文档》要定期（可一周或一个月）给老板一份。这表明了你的工作量，让他看看你确实一直很辛苦地在工作，另外，也能看出你的认真负责态度。

《用户使用手册》：按标准说，应该由文案写，但在大多数的软件公司中都不设这个职位，因此要么由项目经理写要么由测试人员写，关键看是谁给客户做培训。在目前我做的这个项目中，并没有专职测试，所以这个工作还是项目经理来做。《用户使用手册》可根据实际情况写成三种版本，其一，chm类型文件，适用于C/S的项目，就像微软的产品中，都会有此帮助手册；其二，做成网页形式的帮助文件，适用于B/S项目；其三，就是做成word文档，虽然可保存至本地，但使用起来没有前二者方便。

余者还有《开发任务书》、《项目总结报告》、《软件验收评审》等，并不是必须的，可根据客户需要和实际的项目来选择使用，再次并不一一赘述。

并且，以上所有文档，虽然有些是必须的，比如《需求分析说明书》、《测试结果》、《用户使用手册》等，但根据不同的行业、不同的地区以及不同的项目和团队规模，文档的具体内容都会有所不同，不必较真。只要能抓到老鼠，白猫黑猫都是好猫，况且，没必要的多余的文档会浪费时间和成本等资源。

转自：http:///bzgf/200905255.asp