1、软件项目管理软件项目采购管理计划软件项目采购管理计划本章要点一、采购管理概述一、采购管理概述二、合同二、合同q合同基本概念合同基本概念q合同管理合同管理q外包管理外包管理q合同收尾合同收尾三、软件项目的文档管理三、软件项目的文档管理什么是采购管理？什么是采购管理？n项目采购管理包括从项目团队外部购买或获得项目采购管理包括从项目团队外部购买或获得为完成工作所需的产品、服务或成果的过程为完成工作所需的产品、服务或成果的过程。PMBOKn项目采购管理包括：项目采购管理包括：1.由项目团队授权人员签发的合同或采购订单所需的由项目团队授权人员签发的合同或采购订单所需的合同所涉及的合同所涉及的合同管理和变
2、更控制合同管理和变更控制过程。2.管理外部组织（买方）为从实施组织（卖方）获取管理外部组织（买方）为从实施组织（卖方）获取项目而签发的任何合同，以及管理合同规定的项目项目而签发的任何合同，以及管理合同规定的项目团队应承担的合同义务。团队应承担的合同义务。采购管理的过程采购管理的过程PMBOK2008定义的项目定义的项目采购管理过程包括以下采购管理过程包括以下几个过程：几个过程：n规划采购规划采购记录项目采购决策、明确采购方法、记录项目采购决策、明确采购方法、识别潜在卖方的过程识别潜在卖方的过程。n实施采购实施采购获取卖方应答、选择卖方并授予合同获取卖方应答、选择卖方并授予合同的过程。的过程。n
3、管理采购管理采购管理采购关系、监督合同绩效以及采管理采购关系、监督合同绩效以及采取必要的变更和纠正措施的过程。取必要的变更和纠正措施的过程。n结束采购结束采购完成单次项目采购的过程完成单次项目采购的过程。采购管理的过程采购管理的过程软件项目采购软件项目采购一般地，软件项目采购可以分为对市场流通的软市场流通的软件产品进行采购件产品进行采购和外包采购外包采购两大类。1.对市场流通的软件产品进行采购对市场流通的软件产品进行采购 2.外包采购外包采购 当在市场上没有出现现成的产品或者没有适合自己当在市场上没有出现现成的产品或者没有适合自己企业需求的产品的情况下，需要采用定制的方式把项目企业需求的产品的
4、情况下，需要采用定制的方式把项目（功能模块）承包给其他企业。（功能模块）承包给其他企业。本章要点一、一、采购管理概述采购管理概述二、合同二、合同n合同基本概念合同基本概念n合同管理合同管理n外包管理外包管理n合同收尾合同收尾三、三、软件项目的文档管理合同的基本概念合同的基本概念 n 中华人民共和国合同法中华人民共和国合同法规定合同是平等主体的自然人、规定合同是平等主体的自然人、法人、其他组织之间设立、变更、终止民事权利义务关系的协法人、其他组织之间设立、变更、终止民事权利义务关系的协议议.n合同类型在采购计划编制过程中选择，而谈判是主要的步骤合同类型在采购计划编制过程中选择，而谈判是主要的步骤
5、（或是供方选择中用到的最重要的工作与技术）。对（或是供方选择中用到的最重要的工作与技术）。对 合同的理合同的理解（解（Contract）：）：A.使卖方负有供应具体产品的责任，使买方负有为该使卖方负有供应具体产品的责任，使买方负有为该 产品付产品付款的责款的责 任的一种双方互相负有义务的协议。任的一种双方互相负有义务的协议。B.可以被称为协议、分包合同、采购单或可以被称为协议、分包合同、采购单或MOU (Memorandum Of Understanding，即谅解备忘录，即谅解备忘录)。合同的基本概念合同的基本概念 n 软件项目采购的根据采购类型的不同，需要对应的不同类型的合同。软件项目采购
6、的根据采购类型的不同，需要对应的不同类型的合同。合同分类也有很多种，可以按照承包的范围进行分类，也可以按照工合同分类也有很多种，可以按照承包的范围进行分类，也可以按照工作的内容进行分类，还可以按照成本的支持方式进行分类。作的内容进行分类，还可以按照成本的支持方式进行分类。n软件项目合同主要是技术合同软件项目合同主要是技术合同.技术合同是法人之间、法人和公民之间、公民之间以技术开发、技技术合同是法人之间、法人和公民之间、公民之间以技术开发、技术转让、技术咨询和技术服务为内容，明确相互权利义务关系所达成术转让、技术咨询和技术服务为内容，明确相互权利义务关系所达成的协议。的协议。合同的分类合同的分类
7、 n固定总价合同固定总价合同:fixed-price/lump-sum contracts 固定总价固定总价(Firm Fixed-Price)固定总价加奖励费固定总价加奖励费(Fixed-Price-Incentive-Fee)n成本补偿合同成本补偿合同:cost-reimbursable contracts 成本加奖励费成本加固定费成本加成本百分比n工料合同工料合同(单价合同单价合同):Time and Material(T&M)contractsq可能类似于成本补偿合同；q也可能是固定单价合同固定总价合同：（固定总价合同：（1）n固定总价合同固定总价合同（Firm Fixed Price
8、,FFP或或Lump Sum）p卖方承担最高的风险。卖方承担最高的风险。p获利可能性达到最大。获利可能性达到最大。p买方注重控制成本。买方注重控制成本。p适当规定的生产规范对买卖双方都是必要适当规定的生产规范对买卖双方都是必要的。的。固定总价合同：（固定总价合同：（2）固定总价加奖励费合同固定总价加奖励费合同（Fixed Price Plus Incentive Fee,FPIF）。在固定价合同的基础上，给一个奖励费。）。在固定价合同的基础上，给一个奖励费。固定总价加奖励合同（固定总价加奖励合同（Fixed Price Plus Incentive Fee,FPIF）合同合同实实 际际备注备注
9、第一种第一种情况情况第二种第二种情况情况目标成本目标成本100 00080 000130 000 最高价是买方能最高价是买方能够支付的最大金够支付的最大金额。额。在第二种情况下，在第二种情况下，卖方可能遭受损卖方可能遭受损失（负利润）。失（负利润）。目标利润目标利润10 00010 0000分担比率分担比率70：306 0000最高价最高价(价价格上限）格上限）120 000 120 000总价总价 96 000120 000利润利润 16 000-10 000成本补偿合同：（成本补偿合同：（1）n成本加成本百分比合同成本加成本百分比合同:(Cost Plus Percentage of Co
10、st,CPPC)：它它补偿服务的成本，再加上事先规定的成本百分补偿服务的成本，再加上事先规定的成本百分比作为利润。比作为利润。(美国联邦合同订立法规禁止这美国联邦合同订立法规禁止这类合同。类合同。)也被称为成本加费用百分比合同也被称为成本加费用百分比合同（Cost Plus Percentage Free,CPPF）成本补偿合同：（成本补偿合同：（1）成本加成本百分比合同（成本加成本百分比合同（Cost Plus Percentage of Cost,CPPC）合同合同实际实际备注备注估计成本估计成本100 000110 000 费用费用(10%)10 00011 000 假定事先规定的费用假
11、定事先规定的费用是实际成本的是实际成本的10%总价总价110 000(估计价估计价)121 000(实际价实际价)成本补偿合同：（成本补偿合同：（2）n成本加固定费合同（成本加固定费合同（Cost Plus Fixed Fee,CPFF）n这是成本报销合同最常见的一种形式。格式等这是成本报销合同最常见的一种形式。格式等同于上面的同于上面的CPPC，只不过无论实际成本如何，只不过无论实际成本如何，费用总是固定的。费用总是固定的。成本补偿合同：（成本补偿合同：（2）成本加固定费合同（成本加固定费合同（Cost Plus Fixed Fee,CPFF）合同合同实际实际备注备注估计成本估计成本100
12、000110 000 费用费用(10%)10 00010 000 实际费实际费 费用是以估计成本费用是以估计成本10%为基础的固定费。为基础的固定费。总价总价110 000(估计价估计价)120 000(实际价实际价)成本补偿合同：（成本补偿合同：（3）n成本加奖励合同（成本加奖励合同（Cost Plus Incentive Fee,CPIF）成本加奖励合同成本加奖励合同(Cost Plus Incentive Fee,CPIF)合同合同实际实际(Actual)备注备注第一种第一种情况情况第二种第二种情况情况估计成本估计成本100 00080 000120 000费用是以估计成本的费用是以估计
13、成本的10%为基础的固定费用。为基础的固定费用。在第二种情况下，实际在第二种情况下，实际成本高于估计值成本高于估计值20000。（风险）分担额是（风险）分担额是(-20000)的的15%或或(-3000)。费用费用(10%)10 00010 00010 000风险分担风险分担比率比率85：153 000-3 000总价总价 127 000你必须能够计算卖方的利润与买方的价格。你必须能够计算卖方的利润与买方的价格。93 000CPPCCPFFCPIFFPIFFFP合同类型与相应的风险合同类型与相应的风险（乙方）卖方风险（乙方）卖方风险（甲方）买方风险（甲方）买方风险高低低高 合同的基本条款合同的
14、基本条款 一般情况下，合同的具体条款由当事人各方自行约定。总的来说，一般情况下，合同的具体条款由当事人各方自行约定。总的来说，应包括以下各项。应包括以下各项。n当事人的名称（或姓名）和地址。当事人的名称（或姓名）和地址。n规定需要采购的产品、货物或服务，即标的。规定需要采购的产品、货物或服务，即标的。n数量。数量。n质量。质量。n价款（或报酬）。价款（或报酬）。n履行期限、地点和方式。履行期限、地点和方式。n违约责任。违约责任。n解决争议的方法。解决争议的方法。合同中除了上述的基本条款外，还可以包括合同中除了上述的基本条款外，还可以包括合同附件，合同附件，其其中可以包括与履行合同相关的文档资料
15、。中可以包括与履行合同相关的文档资料。合同的主要内容合同的主要内容 本章要点一、一、采购管理概述采购管理概述二、合同二、合同n合同基本概念合同基本概念n合同管理合同管理n外包管理外包管理n合同收尾合同收尾三、软件项目的文档管理合同管理合同管理n合同的签订管理、n合同的履行管理、n合同的变更管理、n合同的档案管理、（档案法、归档的要求）n合同管理的依据（合同管理计划，已经批准的变更）n合同管理的交付物合同管理合同管理合同变更合同变更q合同是双方当事人通过要约、承诺的方式，经协商合同是双方当事人通过要约、承诺的方式，经协商一致达成的。合同成立后，当事人应当按照合同的一致达成的。合同成立后，当事人应
16、当按照合同的约定履行合同。约定履行合同。q任何一方未经对方同意，都不得改变合同的内容任何一方未经对方同意，都不得改变合同的内容q合同法合同法第七十七条第七十七条 当事人协商一致，可以变当事人协商一致，可以变更合同。更合同。q合同的变更是指合同成立后，当事人在原合同的基合同的变更是指合同成立后，当事人在原合同的基础上对合同的内容进行修改或者补充。础上对合同的内容进行修改或者补充。合同管理合同管理合同变更合同变更n 合同变更及变更确立的原则合同变更及变更确立的原则:合同的变更是合同的变更是指合同成立后，当事人在原合同的基础上对合指合同成立后，当事人在原合同的基础上对合同的内容进行修改或者补充。同的
17、内容进行修改或者补充。n 合同变更指由于一定的法律事实而改变合同合同变更指由于一定的法律事实而改变合同的内容和的法律行为，一般特征包括：的内容和的法律行为，一般特征包括：q项目合同的双方当事人必须协商一致。项目合同的双方当事人必须协商一致。q改变了合同的内容。改变了合同的内容。q变更的法律后果是将产生新的债权和债务关系。变更的法律后果是将产生新的债权和债务关系。本章要点一、一、采购管理概述采购管理概述二、合同二、合同n合同基本概念合同基本概念n合同管理合同管理n外包管理外包管理n合同收尾合同收尾三、软件项目的文档管理外包管理外包管理n软件外包，是指软件企业利用外部的专业资源软件外包，是指软件企
18、业利用外部的专业资源来实施软件工程项目，从而达到降低软件开发来实施软件工程项目，从而达到降低软件开发和管理成本、提高软件项目效率一种管理模式。和管理成本、提高软件项目效率一种管理模式。外包管理外包管理外包管理的过程外包管理的过程n 软件外包管理实际上涵盖了软件生命周期中的各软件外包管理实际上涵盖了软件生命周期中的各个过程，任何一个软件外包过程都会涉及到需求管个过程，任何一个软件外包过程都会涉及到需求管理、软件计划、质量管理、项目追踪、配置管理等理、软件计划、质量管理、项目追踪、配置管理等内容。内容。n 当然如果当然如果从软件项目管理的角度从软件项目管理的角度来看外包管理，来看外包管理，整个外包
19、采购过程可以分为五个工作阶段。整个外包采购过程可以分为五个工作阶段。需求分析和设计需求分析和设计n包括了包括了总体项目需求分析和设计总体项目需求分析和设计、分包子项分包子项目的需求分析和设计。目的需求分析和设计。n对于业主来说，在开始外包采购之前，首先对于业主来说，在开始外包采购之前，首先要完成对整个软件项目的总体需求规格说明要完成对整个软件项目的总体需求规格说明书和外包项目的需求说明书。同时，业主要书和外包项目的需求说明书。同时，业主要考虑如何做好子项目的需求分析以及对子项考虑如何做好子项目的需求分析以及对子项目的管理。目的管理。n对于分承包商来说，业主对软件项目所提出对于分承包商来说，业主
20、对软件项目所提出的需求可统称为的需求可统称为“用户需求用户需求”。选择供应商选择供应商n选择供应商（软件分包商）分为两个部分，选择供应商（软件分包商）分为两个部分，评价供应商评价供应商和和选择供应商选择供应商。n对业主来说，建立一个选择供应商的标准非对业主来说，建立一个选择供应商的标准非常重要。可以从供应商的名气、市场份额、常重要。可以从供应商的名气、市场份额、服务、价格、经验、规模和历史等因素进行服务、价格、经验、规模和历史等因素进行全面考虑。全面考虑。选择供应商选择供应商 评价供应商评价供应商n软件项目的外包管理小组应制定软件项目的外包管理小组应制定“评估检查表评估检查表”，为，为有效评估
21、候选承包商的综合能力提供依据。有效评估候选承包商的综合能力提供依据。选择供应商选择供应商 选择供应商选择供应商n经过对软件分包商的综合评估后，软件项目外经过对软件分包商的综合评估后，软件项目外包管理小组就分包商的技术能力、资源、资格包管理小组就分包商的技术能力、资源、资格和信誉、过去的合作关系、价格、服务等进行和信誉、过去的合作关系、价格、服务等进行了全面评估，列出分包商商的优劣次序，择其了全面评估，列出分包商商的优劣次序，择其优者为该项目的分包商。优者为该项目的分包商。过程监控过程监控n软件项目外包的成功取决于对以上整个外包管理过程的指导和软件项目外包的成功取决于对以上整个外包管理过程的指导
22、和监督。监督。n 对业主来说，外包合同对软件项目外包的成败起着关键性作用，对业主来说，外包合同对软件项目外包的成败起着关键性作用，但是由于存在不确定因素，同时也难以了解和度量外包商的具但是由于存在不确定因素，同时也难以了解和度量外包商的具体运作，因而体运作，因而合同并不能确保对外包商的完全控制合同并不能确保对外包商的完全控制。因此，与因此，与外包商的关系不仅仅是一份合同那么简单。这就需要业主对整外包商的关系不仅仅是一份合同那么简单。这就需要业主对整个外包的过程进行监控。个外包的过程进行监控。n由于在实际的操作过程中，业主不可能时刻监督项目的开发过由于在实际的操作过程中，业主不可能时刻监督项目的
23、开发过程。虽然理论上可以把分包商纳入自己的进度控制和质量控制程。虽然理论上可以把分包商纳入自己的进度控制和质量控制体系，把其作为自己的一个项目部门来对待，但是客观上由于体系，把其作为自己的一个项目部门来对待，但是客观上由于分包商与业主距离较远，人员不熟悉，各自有自己的企业文化分包商与业主距离较远，人员不熟悉，各自有自己的企业文化和管理体制，双方之间的信息沟通不畅，业主难以实时监督分和管理体制，双方之间的信息沟通不畅，业主难以实时监督分包商的开发进程和质量。包商的开发进程和质量。n最好的办法就是在软件项目的各个里程碑处进行检查和评估。最好的办法就是在软件项目的各个里程碑处进行检查和评估。外包交付
24、外包交付n当软件项目完成后，软件外包管理小组启动外包当软件项目完成后，软件外包管理小组启动外包交付工作。交付工作。n外包交付的包括了评估、交验测试、安装、培训、外包交付的包括了评估、交验测试、安装、培训、问题处理等工作。验收时承包商准备好待验收的问题处理等工作。验收时承包商准备好待验收的工作成果，并将必要材料提前交给外包管理小组。工作成果，并将必要材料提前交给外包管理小组。双方确定验收的时间、地点、参加人员等。验收双方确定验收的时间、地点、参加人员等。验收人员审查承包商应交付的成果，如代码、文档等，人员审查承包商应交付的成果，如代码、文档等，确保这些成果是完整并正确的。确保这些成果是完整并正确
25、的。本章要点一、一、采购管理概述采购管理概述二、合同二、合同n合同基本概念合同基本概念n合同管理合同管理n外包管理外包管理n合同收尾合同收尾合同收尾合同收尾n软件项目的合同收尾也即通常所说的项目验收。软件项目的合同收尾也即通常所说的项目验收。根据合同中的需求一项项的核对，是否完成了合根据合同中的需求一项项的核对，是否完成了合同所有的要求。同所有的要求。n合同收尾过程涉及评估软件项目产品是否具备了合同收尾过程涉及评估软件项目产品是否具备了可交付功能。包括诸如对开发记录进行更新以反可交付功能。包括诸如对开发记录进行更新以反映最终结果，将更新后的记录进行归档供将来项映最终结果，将更新后的记录进行归档
26、供将来项目使用的管理活动。目使用的管理活动。n合同收尾考虑了项目或项目阶段适用的每项合同。合同收尾考虑了项目或项目阶段适用的每项合同。在多阶段项目中，合同条款可能仅适用于项目的在多阶段项目中，合同条款可能仅适用于项目的某个特定阶段。在这些情况下，合同收尾过程只某个特定阶段。在这些情况下，合同收尾过程只对该项目阶段适用的合同进行收尾。对该项目阶段适用的合同进行收尾。n在合同收尾后，未解决的争议可能需进入诉讼程在合同收尾后，未解决的争议可能需进入诉讼程序。合同条款和条件可规定合同收尾的具体程序。序。合同条款和条件可规定合同收尾的具体程序。合同收尾合同收尾n合同收尾指买方通过其授权的合同管理员向卖方
27、合同收尾指买方通过其授权的合同管理员向卖方发出合同已经完成的正式书面通知。合同收尾过发出合同已经完成的正式书面通知。合同收尾过程支持项目收尾过程程支持项目收尾过程,因为两者都要验证所有的工因为两者都要验证所有的工作和交付的成果是否可以接受作和交付的成果是否可以接受.n合同收尾包含了合同收尾包含了产品核实产品核实和和行政收尾行政收尾两方面的内两方面的内容，产品核实是核实已经完成的工作，行政收尾容，产品核实是核实已经完成的工作，行政收尾是对合同记录进行更新。是对合同记录进行更新。n 有三种方式都可以结束合同：有三种方式都可以结束合同：成功完成；成功完成；相互协商同意结束相互协商同意结束,但没有成本
28、结算；但没有成本结算；实质性违约。实质性违约。软件项目管理软件项目文档管理软件项目文档管理本章要点一、软件项目文档概述一、软件项目文档概述q项目文档管理的概念项目文档管理的概念q项目文档的分类项目文档的分类二、项目文档的质量二、项目文档的质量q项目文档结构项目文档结构 q文档标准文档标准三、项目文档准备三、项目文档准备四、主要项目文档四、主要项目文档软件项目文档管理概述软件项目文档管理概述n能作为开发组员之间交流沟通的媒介。能作为开发组员之间交流沟通的媒介。n能为软件项目的维护工程师提供有关信息系统能为软件项目的维护工程师提供有关信息系统的资料和知识库。的资料和知识库。n能为项目管理者提供项目
29、计划、预算、开发进能为项目管理者提供项目计划、预算、开发进度等各方面的信息。度等各方面的信息。n能作为最终用户或管理员的用户手册，使用户能作为最终用户或管理员的用户手册，使用户知道如何使用、维护及管理系统。知道如何使用、维护及管理系统。本章要点一、软件项目文档概述一、软件项目文档概述q项目文档管理的概念项目文档管理的概念q项目文档的分类项目文档的分类二、项目文档的质量二、项目文档的质量q项目文档结构项目文档结构 q文档标准文档标准三、项目文档准备三、项目文档准备四、主要项目文档四、主要项目文档软件项目文档管理概述软件项目文档管理概述n项目文档的分类项目文档的分类q过程文档过程文档，是指那些记录
30、软件项目开发和维护过程，是指那些记录软件项目开发和维护过程的文档资料，项目的计划、进度、过程质量、组织的文档资料，项目的计划、进度、过程质量、组织及项目标准等都是过程文档。及项目标准等都是过程文档。q产品文档产品文档，是那些描述正在开发的产品的资料。这是那些描述正在开发的产品的资料。这类文档又可以分为从软件工程师开发和维护系统的类文档又可以分为从软件工程师开发和维护系统的角度描述产品的角度描述产品的系统文档系统文档，以及主要以客户为对象，以及主要以客户为对象描述产品的描述产品的用户文档用户文档。过程文档过程文档n软件项目计划、预测和进度安排文档：软件项目计划、预测和进度安排文档：这些文档由项目
31、这些文档由项目经理负责产生，以便预测和控制软件的开发过程。经理负责产生，以便预测和控制软件的开发过程。n相关报告：相关报告：这些文档用来报告在软件开发过程中，资源这些文档用来报告在软件开发过程中，资源是如何分配和利用的。是如何分配和利用的。n标准报告：标准报告：这些文档规定了软件过程应该如何实现，这这些文档规定了软件过程应该如何实现，这些可以是国际标准、国家标准、行业标准等。些可以是国际标准、国家标准、行业标准等。n工作文档工作文档：这些文档是在项目开发中最主要的交流沟通：这些文档是在项目开发中最主要的交流沟通工具，记录了软件项目开发中软件工程师的想法等。工具，记录了软件项目开发中软件工程师的
32、想法等。n备忘录及电子信息备忘录及电子信息：主要记录了每天项目经理和开发人：主要记录了每天项目经理和开发人员之间的详细交流信息。员之间的详细交流信息。过程文档可以分为如下几类：过程文档可以分为如下几类：产品文档产品文档n产品文档可以分为产品文档可以分为用户文档用户文档和和系统文档系统文档n用户文档包括：用户文档包括：(1)系统功能描述系统功能描述(2)初级使用手册初级使用手册(3)系统参考手册系统参考手册(4)系统安装文档系统安装文档(5)系统管理员手册系统管理员手册用户文档用户文档系统管理员向导系统评估员功能性描述描述提供的服务系统管理员安装描述怎样安装系统新用户初级使用手册如何开始使用系统
33、老用户参考手册所有系统功能的详细描述系统管理员如何操作和维护系统图:需要随软件系统发布而产生的部分用户文档产品文档产品文档系统文档包括：系统文档包括：n需求文档及相关的基本原理说明。需求文档及相关的基本原理说明。n系统体系结构文档。系统体系结构文档。n对系统的每一个程序，都有相应的程序体系结构文档。对系统的每一个程序，都有相应的程序体系结构文档。n每个子系统的规范和设计说明书。每个子系统的规范和设计说明书。n程序代码列表。这些列表包括程序注释、用来解释代程序代码列表。这些列表包括程序注释、用来解释代码中复杂代码段和采用的编码方法等。码中复杂代码段和采用的编码方法等。n描述每个程序怎样验证和验证
34、信息与需求之间关系的描述每个程序怎样验证和验证信息与需求之间关系的验证文档。验证文档。n维护指导文档，主要描述系统已知的问题、软件支持、维护指导文档，主要描述系统已知的问题、软件支持、硬件支持等信息，以便维护时使用。硬件支持等信息，以便维护时使用。本章要点一、软件项目文档概述一、软件项目文档概述q项目文档管理的概念项目文档管理的概念q项目文档的分类项目文档的分类二、项目文档的质量二、项目文档的质量q项目文档结构项目文档结构 q文档标准文档标准三、项目文档准备三、项目文档准备四、主要项目文档四、主要项目文档项目文档结构项目文档结构n项目文档结构项目文档结构 n文档标准文档标准n文档书写风格文档书
35、写风格 项目文档结构项目文档结构主要信息：标题：项目：文档ID：文档类型：版本：日期：作者：是否被检查：是/否 是否被同意：N/A提交给CM：CM _ID：发布：密级：关键词：图:项目文档封面的主要信息p文档应分章节描述。文档应分章节描述。p如果文档包括许多细节性参考信息，应该有附录。如果文档包括许多细节性参考信息，应该有附录。p文档应该有难点注释和详细说明。文档应该有难点注释和详细说明。p文档的结构通常应当是严整的，并且有一定的标准文档的结构通常应当是严整的，并且有一定的标准。本章要点一、软件项目文档概述一、软件项目文档概述q项目文档管理的概念项目文档管理的概念q项目文档的分类项目文档的分类
36、二、项目文档的质量二、项目文档的质量q项目文档结构项目文档结构 q文档标准文档标准三、项目文档准备三、项目文档准备四、主要项目文档四、主要项目文档文档标准文档标准 文档标准是保证文档质量的基础，根据一定的文档标准是保证文档质量的基础，根据一定的标准编写文档，可以有一致的外观、结构和质标准编写文档，可以有一致的外观、结构和质量等。量等。n过程标准：过程标准：这种标准定义了高质量文档应该遵守的过程。这种标准定义了高质量文档应该遵守的过程。n产品标准：产品标准：这种标准操纵文档本身。这种标准操纵文档本身。n交互标准：交互标准：通过电子邮件和文档数据库交换文档变得越通过电子邮件和文档数据库交换文档变得
37、越来越重要，交互标准使得所有的文档都存在可比性。来越重要，交互标准使得所有的文档都存在可比性。文档标准文档标准阶段阶段2：修改：修改阶段阶段1：编制：编制编写最初文档编写最初文档评审文档评审文档整理评审意见整理评审意见修改文档修改文档校对文字校对文字最终文档最终文档确认最终文档确认最终文档设计文档设计文档复审文档复审文档打印文档打印文档打印备份文档打印备份文档阶段阶段3：发布：发布图:文档编制过程文档标准n文档编制中涉及到的一些产品标准有：文档编制中涉及到的一些产品标准有：l文档识别标准：文档识别标准：项目都要产生许多文档，每一个文档都要求有一个项目都要产生许多文档，每一个文档都要求有一个独特
38、的识别标准。对于正式的文档，它的识别标准可以是由配置管独特的识别标准。对于正式的文档，它的识别标准可以是由配置管理人员专门定义的；对于非正式的文档，其识别标准可以由项目经理人员专门定义的；对于非正式的文档，其识别标准可以由项目经理来定义。理来定义。l文档结构标准文档结构标准：在软件项目中每一种类型的文档都有一种合适的结：在软件项目中每一种类型的文档都有一种合适的结构，结构标准就用来定义这种结构，可以采用传统的页码、页眉、构，结构标准就用来定义这种结构，可以采用传统的页码、页眉、页脚和章节等。页脚和章节等。l文档解释标准：文档解释标准：文档解释标准定义了文档的总体文档解释标准定义了文档的总体“建
39、筑风格建筑风格”，包，包括文档中字体的大小、颜色及风格的定义等。括文档中字体的大小、颜色及风格的定义等。l文档更新标准：文档更新标准：系统的变更应在文档中反映，因此应该采用一种连系统的变更应在文档中反映，因此应该采用一种连续的方法来表示系统变更，即在文档中确定更新的标准。续的方法来表示系统变更，即在文档中确定更新的标准。n文档标准要适用于所有项目文档及用户文档的最初版本。文档标准要适用于所有项目文档及用户文档的最初版本。文档书写风格文档书写风格编写文档时，也应该注意以下问题：编写文档时，也应该注意以下问题：n运用主动的而不是被动的语气。n运用正确的术语和语法结构。n句子不宜过长，尽量用短句。n
40、段落简短。n用词简洁，不要长篇累犊，质量比数量更重要。n简明定义用到的专业术语。n应用标题和子标题。n尽可能地逐条列举事实。n不要单纯地参考数字、图、表来理解信息，应当有一定的说明和注释。本章要点一、软件项目文档概述一、软件项目文档概述q项目文档管理的概念项目文档管理的概念q项目文档的分类项目文档的分类二、项目文档的质量二、项目文档的质量q项目文档结构项目文档结构 q文档标准文档标准三、项目文档准备三、项目文档准备四、主要项目文档四、主要项目文档项目文档准备项目文档准备 文档的准备分文档的准备分3个阶段个阶段：n文档制作：文档制作：文字处理器、文本格式器、表格和文字处理器、文本格式器、表格和公
41、式编辑器、绘图工具包等。公式编辑器、绘图工具包等。n文档修改文档修改：拼写检查器和风格检查器。：拼写检查器和风格检查器。n文档产品发布：文档产品发布：桌面发布包、技术工作包等。桌面发布包、技术工作包等。项目文档准备项目文档准备 文档管理系统文档管理系统：文档索引文档管理系统配置管理系统文档参考用户请求图 文档管理文档数据库本章要点一、软件项目文档概述一、软件项目文档概述q项目文档管理的概念项目文档管理的概念q项目文档的分类项目文档的分类二、项目文档的质量二、项目文档的质量q项目文档结构项目文档结构 q文档标准文档标准三、项目文档准备三、项目文档准备四、主要项目文档四、主要项目文档主要项目文档主
42、要项目文档 n项目开发立项报告n可行性研究报告n项目开发计划报告n项目分析报告n项目设计报告n程序设计报告n项目测试报告n项目使用与维护手册n项目评价报告n项目开发总结报告 项目开发立项报告项目开发立项报告 n项目开发立项报告是在项目正式开发前，由开发单位提出或委托项目开发立项报告是在项目正式开发前，由开发单位提出或委托开发单位提出要开发的新系统的目标、功能、费用、时间、对组开发单位提出要开发的新系统的目标、功能、费用、时间、对组织机构的影响等内容的申请项目立项文档。织机构的影响等内容的申请项目立项文档。n项目开发立项报告主要包括以下内容项目开发立项报告主要包括以下内容:(1)概述：概述现行系
43、统的组织结构、功能、业务流程以及存在的主要问题。(2)新系统的目标：开发新系统的意义和新系统实现后的功能、技术指标、安全和保密性、新系统运行环境等。(3)经费预测和经费来源。(4)项目进度和完成期限。(5)验收标准和方法。(6)移交的文档资料。(7)开始可行性研究的组织队伍、机构与预算。(8)其他需要说明的有关问题。可行性研究报告可行性研究报告 可行性研究阶段的文档是可行性研究报告。可行性研究可行性研究阶段的文档是可行性研究报告。可行性研究报告是根据对现行系统的调查、分析和研究，提出若干报告是根据对现行系统的调查、分析和研究，提出若干个系统的开发方案及其评价，供领导进行决策。个系统的开发方案及
44、其评价，供领导进行决策。(1)可行性研究报告主要包括以下内容:n系统概述。n新系统的目标、要求和约束。n可行性研究的基本准则。n现行系统描述及现行系统存在的主要问题。n新系统对现行系统的影响。n投资与效益分析。n其他可选方案及国内外同类方案的比较。n有关建议。项目开发计划报告项目开发计划报告 项目开发计划报告主要包括以下内容项目开发计划报告主要包括以下内容:(1)概述：概述：主要包括系统开发的主要目标、基本方针、参加人员、工主要包括系统开发的主要目标、基本方针、参加人员、工作阶段和内容等。作阶段和内容等。(2)开发计划：开发计划：系统开发各个工作阶段或者子项目的划分、任务、分系统开发各个工作阶
45、段或者子项目的划分、任务、分工、负责人、计划时间工、负责人、计划时间(开始及结束时间开始及结束时间)、人力资源需求、资金及、人力资源需求、资金及设备消耗、实际执行情况等。可以用工作进度表、甘特图、网络设备消耗、实际执行情况等。可以用工作进度表、甘特图、网络图及关键路径法等工具辅助管理。图及关键路径法等工具辅助管理。(3)验收标准：验收标准：每项工作完成后验收的标准，包括时间、资金、质量每项工作完成后验收的标准，包括时间、资金、质量等。等。(4)协调方法：协调方法：项目开发中各个单位、阶段之间的衔接、协调方法、项目开发中各个单位、阶段之间的衔接、协调方法、负责人、权限等。负责人、权限等。项目分析
46、报告项目分析报告 项目分析报告主要包括以下内容项目分析报告主要包括以下内容:(1)概述(2)系统需求(3)新系统的目标与新系统的功能(4)新系统的逻辑模型(5)新系统的运行环境(6)新系统的验收标准与培训计划项目设计报告项目设计报告 包括以下内容包括以下内容:(1)系统概述(2)系统总体结构(3)计算机系统配置方案(4)代码设计(5)文件/数据库设计(6)输入输出设计(7)计算机处理过程设计(8)接口及通信环境设计(9)安全保密设计(10)数据准备(11)系统测试计划(12)培训计划项目测试报告项目测试报告 包括以下内容包括以下内容:(1)概述：概述：说明项目测试的目的。说明项目测试的目的。(
47、2)测试环境：测试环境：有关软、硬件、通信、数据库、人员等情有关软、硬件、通信、数据库、人员等情况。况。(3)测试内容测试内容：系统、子系统、模块的名称、性能技术指系统、子系统、模块的名称、性能技术指标等。标等。(4)测试方案：测试方案：测试的方法、测试数据、测试步骤、测试测试的方法、测试数据、测试步骤、测试中故障的解决方案等。中故障的解决方案等。(5)测试结果测试结果：测试的实际情况。测试的实际情况。(6)结论结论：项目功能评价、性能技术指标评价、结论。项目功能评价、性能技术指标评价、结论。项目使用与维护手册项目使用与维护手册 包括以下内容包括以下内容:(1)概述：概述：主要包括系统功能、系
48、统运行环境主要包括系统功能、系统运行环境(软硬件环境软硬件环境)、系统安装等内容。系统安装等内容。(2)使用说明：使用说明：系统操作使用说明较为详细地说明了操作系统操作使用说明较为详细地说明了操作的目的、过程、方式、输入输出的数据等。最好将系统的目的、过程、方式、输入输出的数据等。最好将系统操作的界面图放入说明书中，便于使用者学习与操作。操作的界面图放入说明书中，便于使用者学习与操作。(3)问题解释：问题解释：解释了系统使用中可能出现的问题及解决解释了系统使用中可能出现的问题及解决办法，如非常规操作命令、系统恢复过程及意外情况、办法，如非常规操作命令、系统恢复过程及意外情况、与开发单位的联系方
49、式等。与开发单位的联系方式等。项目评价报告项目评价报告 n项目评价报告主要根据项目可行性分析报告、项目分析项目评价报告主要根据项目可行性分析报告、项目分析报告、项目设计报告所确定的新系统的目标、功能、性报告、项目设计报告所确定的新系统的目标、功能、性能、计划执行情况、新系统实现后的经济效益和社会效能、计划执行情况、新系统实现后的经济效益和社会效益等方面进行评价。益等方面进行评价。项目评价报告主要包括以下内容项目评价报告主要包括以下内容:(1)概述概述(2)系统构成系统构成(3)系统达到设计目标的情况系统达到设计目标的情况(4)系统的可靠性、安全性、保密性、可维护性等状况系统的可靠性、安全性、保
50、密性、可维护性等状况(5)系统的经济效益与社会效益的评价系统的经济效益与社会效益的评价(6)总结性评价总结性评价项目开发总结报告项目开发总结报告 n项目开发总结报告中在项目正式运行一段时间后，项目开发总结报告中在项目正式运行一段时间后，开发人员所做的工作总结，目的是总结经验，找开发人员所做的工作总结，目的是总结经验，找出不足，为今后的开发工作提供借鉴。出不足，为今后的开发工作提供借鉴。项目发总结报告主要包括以下内容项目发总结报告主要包括以下内容:(1)概述概述：包括项目的提供者、开发者、用户；项目开发的主要依据；项包括项目的提供者、开发者、用户；项目开发的主要依据；项目开发的目的；项目开发的可
