软件文档写作管理文档.pptx
《软件文档写作管理文档.pptx》由会员分享,可在线阅读,更多相关《软件文档写作管理文档.pptx(40页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、17.1 7.1 管理文档概述管理文档概述 工工程程化化的的软软件件生生产产方方式式是是软软件件业业界界始始终终在在不不懈懈追追求求的的目目标标。软软件件项项目目管管理理方方法法适适用用与与否否,对对软软件件项项目目的的成成败败有有着着举举足足轻轻重重的的作作用用。而而软软件件项项目目管管理理方方法法改改进进的的途途径径之之一一,就就是是建建立立行行之之有有效效、可操作性强的软件管理文档。可操作性强的软件管理文档。软件管理文档软件管理文档项目开发计划项目开发计划测试计划测试计划测试分析报告测试分析报告开发进度报告开发进度报告开发总结报告开发总结报告管理文档的组成:管理文档的组成:管理文档有以下
2、几个方面的作用:管理文档有以下几个方面的作用:维护人员维护人员软件开发软件开发管理人员管理人员软件开发人员软件开发人员软件操作软件操作人员人员用户用户软件管软件管理文档理文档第1页/共40页管理文档的作用主要体现在三个方面是软件开发各阶段工作成果的体现把软件开发过程中的一些“不可见”的事物转换成“可见”的文字资料提供了管理人员、开发人员、操作人员和用户之间相互沟通、协调的窗口2第2页/共40页37.2 7.2 项目开发计划项目开发计划 项项目目开开发发计计划划又又称称软软件件定定义义文文档档,是是和和软软件件本本身身一一样样重重要要的的知识资产,是项目启动后第一件最重要的工作。知识资产,是项目
3、启动后第一件最重要的工作。项项目目开开发发计计划划一一般般包包括括资资源源需需求求、工工作作分分解解、工工作作目目标标、开开发发团团队队及及人人员员安安排排、进进度度安安排排、内内外外接接口口约约定定、风风险险分分析析以以及及软软件质量控制机制等。件质量控制机制等。1.1.项目开发计划书项目开发计划书 项项目目开开发发计计划划书书的的具具体体内内容容随随着着项项目目和和开开发发机机构构类类型型的的不不同同而而不不同同,一一般般都会包括以下几个部分:都会包括以下几个部分:项目目标项目目标。简述项目目标,并列出影响管理的约束条件,如预算、时间。简述项目目标,并列出影响管理的约束条件,如预算、时间
4、开发团队及人员安排开发团队及人员安排。阐述团队组织方式、人员构成及分工。阐述团队组织方式、人员构成及分工 软硬件资源需求软硬件资源需求。分析和列出所需资源,注明估算的资源需要时间及价格。分析和列出所需资源,注明估算的资源需要时间及价格 工作分解工作分解。分解项目为一系列活动,确定项目里程碑及可交付文档。分解项目为一系列活动,确定项目里程碑及可交付文档 项目进度项目进度。描述项目各活动之间的依赖关系、到达里程碑的时间等。描述项目各活动之间的依赖关系、到达里程碑的时间等 风险分析风险分析。分析项目可能存在的风险、发生的可能性及应对风险的策略。分析项目可能存在的风险、发生的可能性及应对风险的策略 监
5、控机制监控机制。制定详细、可操作的项目监控机制,明确管理报告的递交时间。制定详细、可操作的项目监控机制,明确管理报告的递交时间 开发估算开发估算。包括规模、工作量、成本等的估算,要求依据并积累历史数据。包括规模、工作量、成本等的估算,要求依据并积累历史数据第3页/共40页4 制定项目开发计划的过程被称为项目策划。制定项目开发计划的过程被称为项目策划。由由于于计计划划所所具具有有的的在在时时间间上上的的提提前前性性,项项目目开开发发计计划划通通常常会会经经常常性性的的修修正正,有有些些部部分分甚甚至至会会频频繁繁的的改改变!变!而而部部分分内内容容的的变变化化,会会影影响响开开发发计计划划的的正
6、正确确性性和和符符合合性性,使使其其越越来来越越偏偏离离项项目目实实际际,最最后后变变得得没没有有价价值值。如如随随着着项项目目需需求求的的逐逐渐渐明明确确引引起起的的项项目目计计划划细细化化、项目可提供资源变化引起的项目计划的变化等。项目可提供资源变化引起的项目计划的变化等。所所以以,在在实实际际工工作作中中,需需要要有有明明确确的的责责任任人人和和操操作作原原则则,来来对对项项目目计计划划实实施施维维护护,并并对对项项目目计计划划的的变变更实施必要的控制。更实施必要的控制。另另一一个个重重要要的的方方面面是是,在在组组织织文文档档时时,就就要要考考虑虑到到这这种种频频繁繁变变更更的的需需要
7、要,使使得得当当变变更更发发生生时时,文文档档的的相应部分能够容易替换。相应部分能够容易替换。第4页/共40页52.2.工作分解结构工作分解结构 工工作作分分解解结结构构(work(work breakdown breakdown structure,structure,WBS)WBS)是是对对整整个个项项目目工工作作的的分分级级描描述述,是是项项目目计计划划开开发发的的第第一一步步。分分解解示示意意如如下图所示。下图所示。目标目标活动活动活动活动活动活动活动活动活动活动活动活动1 1级级2 2级级m m级级工作包工作包任务任务1 1任务任务2 2任务任务3 3 任务任务n n活动活动工工作作
8、分分解解结结构构设设计计一一般可以采用般可以采用2 2种方法:种方法:-自自上上而而下下的的方方法法。从从项项目目的的目目标标开开始始,逐逐步步分分解解,直直到到具具体任务体任务-自自下下而而上上的的方方法法。也也称称集集思思广广益益法法。即即从从底底层层开开始始,逐逐层层集集成成,最最后后汇汇合合后后完成目标完成目标第5页/共40页6工作分解工作分解结构主要有结构主要有4 4个用途个用途:1.1.思路工具思路工具:可以描述项目的整体思路,是一个计划和设:可以描述项目的整体思路,是一个计划和设计的工具;计的工具;2.2.结构设计工具结构设计工具:是项目工作的结构图,可以清晰表达项:是项目工作的
9、结构图,可以清晰表达项目各项工作间的相互关系;目各项工作间的相互关系;3.3.计划工具计划工具:能够展示项目全貌,说明为完成项目所需完:能够展示项目全貌,说明为完成项目所需完成的各项活动;成的各项活动;4.4.项目状态报告工具项目状态报告工具:可以作为项目状态报告的框架。随:可以作为项目状态报告的框架。随着低一级项目活动的完成,项目由下而上不断整合,某着低一级项目活动的完成,项目由下而上不断整合,某一项工作的完成将成为里程碑,所以,工作分解结构就一项工作的完成将成为里程碑,所以,工作分解结构就定义了里程碑事件。定义了里程碑事件。第6页/共40页73.3.项目里程碑与阶段性文档项目里程碑与阶段性
10、文档 由由于于软软件件产产品品是是无无形形的的,因因此此,管管理理者者需需要要通通过过文文档档的的形形式式获获得信息,了解软件的开发状况,以作出管理的决定。得信息,了解软件的开发状况,以作出管理的决定。里里程程碑碑的的建建立立,可可以以描描述述软软件件开开发发活活动动一一个个过过程程的的终终结结。在在每每个个里里程程碑碑,都都有有一一个个正正式式的的可可以以提提交交给给管管理理层层的的阶阶段段性性结结果果。比比如如,一份报告。一份报告。里里程程碑碑报报告告的的内内容容不不拘拘,以以能能清清楚楚说说明明阶阶段段性性结结果果为为标标准准,应应能代表项目中一个特定逻辑意义上的阶段的终结。能代表项目中
11、一个特定逻辑意义上的阶段的终结。要要建建立立里里程程碑碑,软软件件过过程程就就一一定定要要分分解解成成一一系系列列相相关关的的基基本本活活动动,而而每每个个基基本本活活动动都都要要有有相相应应的的输输出出结结果果。如如下下图图,是是一一个个需需求求描述中的活动,其中每个活动都有主要输出。描述中的活动,其中每个活动都有主要输出。可行性研究可行性研究需求分析需求分析原型开发原型开发设计研究设计研究需求描述需求描述可行性报告可行性报告用户需求用户需求估算报告估算报告体系结构设计体系结构设计系统需求系统需求第7页/共40页84.4.项目进度项目进度 项目管理者要求估算完成各项活动所需的时间和资源,并将
12、它们严密的组织起来,以安排项目进度。不同的项目,具有不同的项目开发进度。初始的项目进度安排往往是不精确的,但随着项目进展信息的不断增多,进度安排也会越来越接近项目实际进度,因此,必须不断更新项目进度。项目进度包括将一个项目分解为若干独立的活动,以及判断完成这些活动所需的时间。通常,有些活动是可以并行的,项目管理者应组织并协调这些并行的工作。项目进度过程见下图:识别活动识别活动识别活动识别活动依赖关系依赖关系估算活动估算活动的资源的资源为活动分为活动分配资源配资源创建项目创建项目图表图表软件需求软件需求活动图表及条形图活动图表及条形图第8页/共40页9 在进度估算时,管理者需要有一定的余量。在进
13、度估算时,管理者需要有一定的余量。如如项项目目难难度度大大,则则花花费费的的时时间间也也会会较较多多。又又如如,项项目目个个别别开开发发人人员员可可能能发发生生的的变变动动,硬硬件件环环境境的的变变化化等等,都都是是在在估估算算项目进度时必须考虑的因素。项目进度时必须考虑的因素。除除了了时时间间和和人人员员、环环境境的的变变化化,资资源源和和预预算算也也需需要要考考虑虑适适当的余量。当的余量。恰恰当当的的估估算算方方法法是是采采用用“理理想想实实际际”方方式式。即即先先估估算算理理想想值值,然然后后逐逐步步加加入入预预计计出出现现的的状状况况、偶偶然然因因素素致致成成的的状状况况、项目开发人员
14、的素质和经验项目开发人员的素质和经验 作作为为经经验验数数据据,一一般般在在最最初初估估算算的的基基础础上上增增加加30%30%作作为为实实际际可可能能发发生生的的状状况况值值,再再预预留留20%20%的的估估算算值值给给所所谓谓不不可可预预见见的其它问题,则进度估算的结果会较符合实际。的其它问题,则进度估算的结果会较符合实际。第9页/共40页任任 务务持续时间持续时间(天数天数)依依 赖赖 关关 系系T1T18 8T2T21515T3T31515T1(M1)T1(M1)T4T41010T5T51010T2T2,T4(M2)T4(M2)T6T65 5T1T1,T2(M3)T2(M3)T7T72
15、020T1(M1)T1(M1)T8T82525T4(M5)T4(M5)T9T91515T3T3,T6(M4)T6(M4)T10T101515T5T5,T7(M7)T7(M7)T11T117 7T9(M6)T9(M6)T12T121010T11(M8)T11(M8)105.5.运用图和表描述项目进度运用图和表描述项目进度 项目进度可以采用图表工具更直观的表示任务分解、活动依赖关系和人员分配情况等。下表是一个“任务的持续时间及其依赖关系”的例子。第10页/共40页11甘特图法(Gantt Chart)的例子tw12345678ABCD当前进度当前进度优点:简单,能动态地反映优点:简单,能动态地反映
16、开发进程开发进程缺点:难以反映多个任务间的缺点:难以反映多个任务间的逻辑关系逻辑关系条形图和活动网络图是表示项目进度的两种图形表示法。(1)条形图。又称甘特图法(Gantt Chart),可以表示面向活动的负责人是谁,以及活动的开始和结束时间。如下图所示的例子。第11页/共40页12012345678 codingA testingA debuggingAB coding understandingC modifyingC testingB testingC debuggingB debuggingC testingABC012356789 codingA testingA debugging
17、A understandingC modifyingC testingB testingC debuggingB debuggingC testingABC4 debuggingAB coding 例:开发三个模块A、B、C。A为公用模块,B、C的测试须等A的调试完成后进行。A的编码需6天,测试8天,调试6天。B的编码需7天,测试8天,调试6天。C利用已有的模块,须先理解原模块8天,再修改8天,测试9天,调试7天。最后三模块集成测试需5天完成。(2)活动网络图。又称网络计划法 表示构成一个项目的不同活动之间的依赖关系。是用网状图表安排与控制各项活动的方法。最适合反映多个工作之间的逻辑关系。第1
18、2页/共40页13持续时间持续时间Lasting Time机动时间机动时间Slack Time编编号号EarliestStart TimeLatestStart Time012345678941363029222014126006142082028293641(0)(0)(15)(4)(2)(4)(0)(2)(0)(2)(0)(0)686678886975(1)标出标出 Lasting Time(2)标出标出 EST:=从起点始,所有进从起点始,所有进入事件的入事件的 EST+LT 中最大的中最大的(3)标出标出 LST:=从终点从终点(EST=LST)始,所有离开事件的始,所有离开事件的 L
19、ST LT 中最小的中最小的(4)标出标出 ST:=终点终点LST 起点起点EST LT(5)标出标出Key Path:即即EST=LST的的所有事件组成的路径所有事件组成的路径通常,甘特图适合按开发阶段安排,以作项目总体进度控制。网络计划法便于在细节上安排人力,适合按开发阶段或子项目的工作步骤安排。第13页/共40页风风 险险风险类型风险类型风风 险险 描描 述述职员跳槽职员跳槽项目项目有经验的职员未完成项目就跳槽有经验的职员未完成项目就跳槽管理层变更管理层变更项目项目不同的管理层考虑、关注的事情会不同不同的管理层考虑、关注的事情会不同硬件缺乏硬件缺乏项目项目项目所需的基础硬件没有按期交付项
20、目所需的基础硬件没有按期交付需求变更需求变更项目和产品项目和产品软件需求与预期的相比,将会有较大变化软件需求与预期的相比,将会有较大变化描述延迟描述延迟项目和产品项目和产品有关主要接口的描述未按期完成有关主要接口的描述未按期完成低估了系统规模低估了系统规模项目和产品项目和产品过低估计了系统的规模过低估计了系统的规模CASECASE工具性能较差工具性能较差产品产品支持项目的支持项目的CASECASE工具达不到要求工具达不到要求技术变更技术变更业务业务系统的基础技术被新技术取代系统的基础技术被新技术取代产品竞争产品竞争业务业务系统还未完成,其它有竞争力的产品就已经上市了系统还未完成,其它有竞争力的
21、产品就已经上市了146.6.风险管理风险管理 由于绝大多数软件项目都存在不确定性,因此,风险管理对软件项目而言就尤为重要。根据产生的影响不同,一般将风险分为三类:项目风险、产品风险和业务风险。下表给出了一些典型风险:第14页/共40页风险类型风险类型可可 能能 的的 风风 险险技术技术系统使用的数据库的处理速度不够快系统使用的数据库的处理速度不够快要复用的软件组件有缺陷,限制了项目的性能要复用的软件组件有缺陷,限制了项目的性能人员人员招聘不到符合项目技术要求的职员招聘不到符合项目技术要求的职员在项目的非常时刻,关键职员生病,无法发挥作用在项目的非常时刻,关键职员生病,无法发挥作用职员所需的培训
22、跟不上职员所需的培训跟不上机构机构重新进行机构调整,由不同的管理层负责这个项目重新进行机构调整,由不同的管理层负责这个项目开发机构的财务出现问题,必须削减项目预算开发机构的财务出现问题,必须削减项目预算工具工具CASE工具产生的编码效率低工具产生的编码效率低CASE工具不能被集成工具不能被集成需求需求需求发生变化,主体设计要返工需求发生变化,主体设计要返工客户不了解需求变更对项目造成的影响客户不了解需求变更对项目造成的影响估算估算低估了软件开发所需要的时间低估了软件开发所需要的时间低估了缺陷的修补率低估了缺陷的修补率低估了软件的规模低估了软件的规模15下图是风险管理过程示意图风险识别风险识别风
23、险分析风险分析风险规划风险规划风险监控风险监控潜在的风险潜在的风险列表列表优先级高的优先级高的风险列表风险列表风险规避和风险规避和应急计划应急计划风险评估风险评估(1)(1)风险识别风险识别 风风险险识识别别是是风风险险管管理理的的第第一一阶阶段段,其其目目的的是是发发现现可可能能的的风风险险。右右表表给给出出了了可可能能的的风风险及风险类型的实例。险及风险类型的实例。这这些些风风险险将将可可能能影影响响到到软软件件产产品品、过过程程或业务。或业务。第15页/共40页16(2)风险分析 风险分析就是对每一个已经识别的风险,对其出现的可能性和影响的严重性作出判断。风险出现可能性的评估大致可以有:
24、非常小(75%)。风风 险险出现的可能性出现的可能性后果后果开发机构的财务出现问题,必须削减项目预算开发机构的财务出现问题,必须削减项目预算小小灾难性灾难性招聘不到符合项目技术要求的职员招聘不到符合项目技术要求的职员大大灾难性灾难性在项目的非常时刻,关键职员生病在项目的非常时刻,关键职员生病中等中等严重严重要复用的软件组件有缺陷,限制了项目的性能要复用的软件组件有缺陷,限制了项目的性能中等中等严重严重需求发生变化,主体设计要返工需求发生变化,主体设计要返工中等中等严重严重开发机构调整,由不同的管理层负责这个项目开发机构调整,由不同的管理层负责这个项目大大严重严重系统使用的数据库的处理速度不够快
25、系统使用的数据库的处理速度不够快中等中等严重严重低估了软件开发所需要的时间低估了软件开发所需要的时间大大严重严重CASE工具不能被集成工具不能被集成大大可容忍可容忍客户不了解需求变更对项目造成的影响客户不了解需求变更对项目造成的影响中等中等可容忍可容忍职员所需的培训跟不上职员所需的培训跟不上中等中等可容忍可容忍低估了缺陷的修补率低估了缺陷的修补率中等中等可容忍可容忍低估了软件的规模低估了软件的规模大大可容忍可容忍CASE工具产生的编码效率低工具产生的编码效率低中等中等可忽略可忽略 风险影响大小的评估,可能的结果有:灾难性的、严重的、可以容忍的和可以忽略的。右表是对上表已识别风险分析后得出的结果
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 软件 文档 写作 管理
限制150内