软件文档写作11-管理文档.pptVIP

* 第七章 软件管理文档 7.1 管理文档概述 工程化的软件生产方式是软件业界始终在不懈追求的目标。软件项目管理方法适用与否，对软件项目的成败有着举足轻重的作用。二软件项目管理方法改进的途径之一，就是建立行之有效、可操作性强的软件管理文档。 软件管理文档 项目开发计划 测试计划 测试分析报告 开发进度报告 开发总结报告 管理文档的组成： 管理文档有以下几个方面的作用： 维护人员 软件开发管理人员 软件开发人员 软件操作人员 用户 软件管理文档 管理文档的作用主要体现在3个方面： ① 是软件开发各阶段工作成果的体现； ② 把软件开发过程中的一些“不可见”的事物转换成“可见”的文字资料； ③ 提供了管理人员、开发人员、操作人员和用户之间相互沟通、协调的窗口。 7.2 项目开发计划 项目开发计划又称软件定义文档，是和软件本身一样重要的知识资产，是项目启动后第一件最重要的工作。 项目开发计划一般包括资源需求、工作分解、工作目标、开发团队及人员安排、进度安排、内外接口约定、风险分析以及软件质量控制机制等。 1. 项目开发计划书 项目开发计划书的具体内容随着项目和开发机构类型的不同而不同，一般都会包括以下几个部分： ① 项目目标。简述项目目标，并列出影响管理的约束条件，如预算、时间… ② 开发团队及人员安排。阐述团队组织方式、人员构成及分工 ③ 软硬件资源需求。分析和列出所需资源，注明估算的资源需要时间及价格 ④ 工作分解。分解项目为一系列活动，确定项目里程碑及可交付文档 ⑤ 项目进度。描述项目各活动之间的依赖关系、到达里程碑的时间等 ⑥ 风险分析。分析项目可能存在的风险、发生的可能性及应对风险的策略 ⑦ 监控机制。制定详细、可操作的项目监控机制，明确管理报告的递交时间 ⑧ 开发估算。包括规模、工作量、成本等的估算，要求依据并积累历史数据 制定项目开发计划的过程被称为项目策划。 由于计划所具有的在时间上的提前性，项目开发计划通常会经常性的修正，有些部分甚至会频繁的改变！ 而部分内容的变化，会影响开发计划的正确性和符合性，使其越来越偏离项目实际，最后变得没有价值。如随着项目需求的逐渐明确引起的项目计划细化、项目可提供资源变化引起的项目计划的变化等。 所以，在实际工作中，需要有明确的责任人和操作原则，来对项目计划实施维护，并对项目计划的变更实施必要的控制。 另一个重要的方面是，在组织文档时，就要考虑到这种频繁变更的需要，使得当变更发生时，文档的相应部分能够容易替换。 2. 工作分解结构 工作分解结构(work breakdown structure, WBS)是对整个项目工作的分级描述，是项目计划开发的第一步。分解示意如下图所示。 目标 活动 活动 活动 活动 活动 活动 1级 2级 … … m级 工作包 任务1 任务2 任务3 … 任务n 活动 工作分解结构设计一般可以采用2种方法： - 自上而下的方法。从项目的目标开始，逐步分解，直到具体任务； - 自下而上的方法。也称集思广益法。即从底层开始，逐层集成，最后汇合后完成目标。 工作分解结构主要有4个用途： 思路工具：可以描述项目的整体思路，是一个计划和设计的工具； 结构设计工具：是项目工作的结构图，可以清晰表达项目各项工作间的相互关系； 计划工具：能够展示项目全貌，说明为完成项目所需完成的各项活动； 项目状态报告工具：可以作为项目状态报告的框架。随着低一级项目活动的完成，项目由下而上不断整合，某一项工作的完成将成为里程碑，所以，工作分解结构就定义了里程碑事件。 3. 项目里程碑与阶段性文档 由于软件产品是无形的，因此，管理者需要通过文档的形式获得信息，了解软件的开发状况，以作出管理的决定。 里程碑的建立，可以描述软件开发活动一个过程的终结。在每个里程碑，都有一个正式的可以提交给管理层的阶段性结果。比如，一份报告。 里程碑报告的内容不拘，以能清楚说明阶段性结果为标准，应能代表项目中一个特定逻辑意义上的阶段的终结。 要建立里程碑，软件过程就一定要分解成一系列相关的基本活动，e而每个基本活动都要有相应的输出结果。如下图，是一个需求描述中的活动，其中每个活动都有主要输出。 可行性研究 可行性研究 可行性研究 可行性研究 可行性研究 可行性报告 用户需求 估算报告 体系结果设计 系统需求 4. 项目进度 项目管理者要求估算完成各项活动所需的时间和资源，并将它们严密的组织起来，以安排项目进度。不同的项目，具有不同的项目开发进度。 初始的项目进度安排往往是不精确的，但随着项目进展信息的不断增多，进度安排也会越来越接近项目实际进度，因此，必须不断更新项目进度。