管理学第三章 软件文档与配置管理.ppt课件

第三章第三章 软件项目的文档与配置管理软件项目的文档与配置管理谷瑞 东南大学软件学院u 曾经有一个很好的文档配置管理工具在我面前，我没有曾经有一个很好的文档配置管理工具在我面前，我没有理睬，直到版本混乱的时候才后悔莫及，工作中最大的理睬，直到版本混乱的时候才后悔莫及，工作中最大的痛苦莫过于此，如果上天再给我一次机会的话，我向对痛苦莫过于此，如果上天再给我一次机会的话，我向对它说三个字：我要你。如果非得加一个期限的话，我希它说三个字：我要你。如果非得加一个期限的话，我希望是一辈子。望是一辈子。3.1 软件项目文档管理概述u软件项目文档是软件项目文档是ITIT软件项目开发中的重要组成部分软件项目开发中的重要组成部分u项目文档作用项目文档作用能作为开发组员之间交流沟通的媒介能作为开发组员之间交流沟通的媒介能为软件项目的维护工程师提供有关信息系统的资料和知识库能为软件项目的维护工程师提供有关信息系统的资料和知识库能为项目管理者提供项目计划、预算、开发进度等各方面的信能为项目管理者提供项目计划、预算、开发进度等各方面的信息息能作为最终用户或管理员的用户手册，使用户知道如何使用、能作为最终用户或管理员的用户手册，使用户知道如何使用、维护及管理维护及管理系统系统3.1 软件项目文档管理概述按照文档的产生和使用范围，文档可分为三类：按照文档的产生和使用范围，文档可分为三类：u开发文档开发文档作为软件开发人员前一阶段的工作体现和后一阶段的工作依据作为软件开发人员前一阶段的工作体现和后一阶段的工作依据u管理文档管理文档由软件开发人员制定的需提交给相关人员的一些工作计划或工由软件开发人员制定的需提交给相关人员的一些工作计划或工作报告作报告u用户文档用户文档是软件开发人员为用户准备的有关该软件使用、操作、维护的是软件开发人员为用户准备的有关该软件使用、操作、维护的资料资料3.2 文档编制时间表可行性研究需求分析软件设计编码与单元测试集成与系统测试运行维护可行性分析报告项目开发计划软件需求说明书数据库要求说明书测试计划概要设计说明书详细设计说明书用户手册操作手册测试分析报告开发进度月报项目开发总结程序维护手册阶段文档文档编制时间表文档编制时间表3.2 文档编制时间表管理人员开发人员维护人员用户可行性分析报告项目开发计划软件需求说明书数据库要求说明书测试计划概要设计说明书详细设计说明书用户手册操作手册测试分析报告开发进度月报项目开发总结程序维护手册项目组人员与文档编制表项目组人员与文档编制表文档用户3.3 文档的管理与维护u在软件生存周期中，各种文档作为半成品或成品，会不在软件生存周期中，各种文档作为半成品或成品，会不断生成、修改或补充。一般的，文档的管理包括：断生成、修改或补充。一般的，文档的管理包括：应该编制哪些文档，其详尽程度如何应该编制哪些文档，其详尽程度如何审查和批准的负责人和时间进度安排审查和批准的负责人和时间进度安排在开发期间内各文档的维护、修改和管理负责人在开发期间内各文档的维护、修改和管理负责人3.4 配置管理的基本概念v 开发人员使用错误的版本修改开发人员使用错误的版本修改程序程序v 开发人员未经授权修改代码或开发人员未经授权修改代码或文档文档,或修改的结果不能及时反或修改的结果不能及时反映到各个相关部分；映到各个相关部分；v 人员流动，交接工作不彻底造人员流动，交接工作不彻底造成软件关键部件遗失；成软件关键部件遗失；v 已修复的已修复的BugBug在新版本中出现在新版本中出现v 找不到某个文件的历史版本找不到某个文件的历史版本v 无法重新编译某个历史版本，无法重新编译某个历史版本，使维护工作十分困难；使维护工作十分困难；v 因协同开发中，或者异地开发因协同开发中，或者异地开发，版本变更混乱导致整个项目，版本变更混乱导致整个项目失败；失败；v 软件项目进行中面临的一个主要问题是持续不断的变化；配置管理是有效管软件项目进行中面临的一个主要问题是持续不断的变化；配置管理是有效管理变更的手段，它贯穿着几乎软件的整个生命周期。理变更的手段，它贯穿着几乎软件的整个生命周期。3.4 配置管理的基本概念u软件配置管理软件配置管理(Software Configuration Management，SCM)是对产品进行标志、存储和控制，以维护其完整性、可追溯性以是对产品进行标志、存储和控制，以维护其完整性、可追溯性以及正确性，它为软件开发提供了一套管理办法和活动原则及正确性，它为软件开发提供了一套管理办法和活动原则。u配置管理作用配置管理作用记录软件产品的演化过程记录软件产品的演化过程确保软件开发者在软件生命周期中的各个阶段都能得到精确的产确保软件开发者在软件生命周期中的各个阶段都能得到精确的产品配置。品配置。最终保证软件产品的完整性、一致性、追朔性、可控性最终保证软件产品的完整性、一致性、追朔性、可控性3.4 配置管理的基本概念u软件配置项：软件配置项：凡是纳入配置管理范畴的工作成果统称为凡是纳入配置管理范畴的工作成果统称为配置项（配置项（Configuration ItemConfiguration Item，CICI）。配置项主要有两）。配置项主要有两大类：大类：属于产品组成部分的工作成果，例如源代码、需求文档、设计属于产品组成部分的工作成果，例如源代码、需求文档、设计文档、测试用例等等。文档、测试用例等等。在管理过程中产生的文档，例如各种计划、状态报告等等，这在管理过程中产生的文档，例如各种计划、状态报告等等，这些文档虽然不是产品的组成部分，但是值得保存。些文档虽然不是产品的组成部分，但是值得保存。每个配置项的主要属性有：名称、标识符、文件状态、版每个配置项的主要属性有：名称、标识符、文件状态、版本、作者、日期等。本、作者、日期等。3.4 配置管理的基本概念配置项刚建立时其状态为配置项刚建立时其状态为“草稿草稿”；配置项通过；配置项通过评审（或审批）后，其状态变为评审（或审批）后，其状态变为“正式发布正式发布”3.4 配置管理的基本概念基线是软件生存周期中的一个特定点，其作用是基线是软件生存周期中的一个特定点，其作用是把开发阶段的工作划更加明确化、使本来连续的工把开发阶段的工作划更加明确化、使本来连续的工作在这点断开，以便于检查和评价阶段成果作在这点断开，以便于检查和评价阶段成果图：软件开发中的基线图：软件开发中的基线3.4 软件配置管理概述软件配置是一个动态的概念，它一方面随着软件软件配置是一个动态的概念，它一方面随着软件生存周期向前推进，另一方面随时会有新的变种出生存周期向前推进，另一方面随时会有新的变种出现现V1.0V1.2V1.1V1.3V1.4V2.0V2.1V1.1.1V1.1.2图：版本演变与变种图：版本演变与变种3.4 配置管理的基本概念u软件的每一个版本都是源代码、文档及数据以及相关的软件的每一个版本都是源代码、文档及数据以及相关的系统环境的一个收集，且各个版本都可能由不同的变种系统环境的一个收集，且各个版本都可能由不同的变种组成。组成。u版本控制的目的是按照一定的规则保存配置项的所有版版本控制的目的是按照一定的规则保存配置项的所有版本，避免发生版本丢失或混淆等现象，并且可以快速准本，避免发生版本丢失或混淆等现象，并且可以快速准确地查找到配置项的任何版本。确地查找到配置项的任何版本。3.4 配置管理的基本概念u处于处于“草稿草稿”状态的配置项的版本号格式为：状态的配置项的版本号格式为：0.YZ YZYZ数字范围为数字范围为01-9901-99u处于处于“正式发布正式发布”状态的配置项的版本号格式为：状态的配置项的版本号格式为：X.Y X为主版本号，取值范围为为主版本号，取值范围为1-9。Y为次版本号，取值范围为为次版本号，取值范围为1-9u处于处于“正在修改正在修改”状态的配置项的版本号格式为：状态的配置项的版本号格式为：X.YZ配置项正在修改时，一般只增大配置项正在修改时，一般只增大Z值，值，X.Y值保持不变值保持不变3.4 配置管理的基本概念u配置管理委员会配置管理委员会(Software Configuration Control Board，SCCB)是实现有序、及时和正确处理软件配置是实现有序、及时和正确处理软件配置项的基本机制。项的基本机制。3.5 软件项目配置管理过程v配置管理基本活动配置管理基本活动u配置管理计划配置管理计划 u配置项标志配置项标志 u配置项控制配置项控制 u状态状况报告状态状况报告 u配置项审核配置项审核 v配置管理过程配置管理过程 u配置项标识、跟踪配置项标识、跟踪u配置管理环境建立配置管理环境建立u基线变更管理基线变更管理u基线审核基线审核u配置状态统计配置状态统计u配置管理计划配置管理计划 配置管理过程围绕配置管理的配置管理过程围绕配置管理的5 5项活动进行项活动进行 3.5 软件项目配置管理过程u配置管理计划配置管理计划就是确定软件配置管理的解决方案，一个关键任务是确定要控就是确定软件配置管理的解决方案，一个关键任务是确定要控制哪些文档。制哪些文档。u配置项标志、跟踪配置项标志、跟踪一个项目通常会生成很多的过程文件，并经历不同的阶段和版一个项目通常会生成很多的过程文件，并经历不同的阶段和版本本3.5 软件项目配置管理过程u配置管理环境建立配置管理环境建立 建立配置管理库，简称配置库建立配置管理库，简称配置库。软件配置管理库。软件配置管理库是用来存储所有基线配置项及相关文件的等内容的系统是用来存储所有基线配置项及相关文件的等内容的系统，是在软件产品的整个生存期中建立和维护软件产品完，是在软件产品的整个生存期中建立和维护软件产品完整性的主要手段。整性的主要手段。开发库开发库受控库受控库产品库产品库3.5 软件项目配置管理过程u配置管理环境建立配置管理环境建立 受控操作受控操作:从受控库导出的文件自动被锁定直到文件重从受控库导出的文件自动被锁定直到文件重新被导入，一个版本号自动与新版本文件相关联。配置新被导入，一个版本号自动与新版本文件相关联。配置库中文件不能更改，任何更改都被视为创建了一个新版库中文件不能更改，任何更改都被视为创建了一个新版本文件。本文件。3.5 软件项目配置管理过程u基线变更管理基线变更管理 项目基线（配置项）可能由于种种原因会发生变更项目基线（配置项）可能由于种种原因会发生变更，如：客户需求变化、进度变更、成本变更、产品环境，如：客户需求变化、进度变更、成本变更、产品环境变化等。变化等。配置控制配置控制变更请求变更请求变更评估变更评估批准批准/拒绝拒绝变更实现变更实现3.5 软件项目配置管理过程u基线变更管理基线变更管理项目名称项目名称变更申请人变更申请人提交时间提交时间变更题目变更题目紧急程度紧急程度变更的具体内容变更的具体内容变更影响分析变更影响分析变更确定变更确定处理结果处理结果签字签字3.5 软件项目配置管理过程u基线变更管理基线变更管理变更评估变更评估软件变更分类软件变更分类技术影响分析技术影响分析接口影响分析接口影响分析进度影响分析进度影响分析预算影响分析预算影响分析3.5 软件项目配置管理过程u基线变更管理基线变更管理批准批准/拒绝变更拒绝变更（若（若批准）批准）实施实施变更变更决策决策（若（若批准）批准）验证验证变更变更（若批若批准）发准）发布、安布、安装变更装变更（若（若批准）批准）版本版本更新更新3.5 软件项目配置管理过程u基线变更管理基线变更管理变更实现变更实现变更实现变更实现受控基线出库受控基线出库实现的测试和验实现的测试和验证证实现被承认实现被承认受控基线入库受控基线入库2.5 软件项目配置管理过程u配置审核配置审核3.5 软件项目配置管理过程u 状态报告状态报告3.6 配置管理组织与实施 组织机构责 任具体职责项目经理负责整个软件项目的研发活动，根据SCCB的建议，批准配置管理的各项活动并控制它们的进程制定和修改项目的组织结构和配置管理策略批准、发布配置管理计划决定项目起始基线和开发里程碑接收并审阅SCCB的报告软件配置控制 委员会（SCCB）管理软件基线，承担变更控制的所有责任授权建立软件基线和标志配置/配置单元代表项目经理和受到基线影响的质量保证组、配置管理组、工程组、系统测试组、合同管理组、文档支持组等小组的利益审查和审定对软件基线的更改审定由软件基线数据库中生产的产品和报告软件配置小组（SCM小组）负责协调和实施项目创建和管理项目的软件基线库制定、维护和发布SCM计划、标准和规程标志置于配置管理下的软件工作产品集合管理软件基线的库的使用更新软件基线生成基于软件基线的产品记录SCM活动生成和发布SCM报告开发人员负责开发任务根据组织内确定的软件配置管理计划和相关规定，按照软件配置管理工具的使用模型来完成开发任务3.6 配置管理组织与实施 确定初始基线确定初始基线由由SCCBSCCB确定研确定研发活动的初始基线；发活动的初始基线；配置库管理配置库管理配置人员根据软配置人员根据软件配置管理规划设立配置库和工件配置管理规划设立配置库和工作空间，为执行软件配置管理做作空间，为执行软件配置管理做好准备，并定期执行备份和清理好准备，并定期执行备份和清理工作；工作；授权开发授权开发开发人员按照统一开发人员按照统一的软件配置管理策略，根据获得的软件配置管理策略，根据获得授权的资源进行项目研发工作授权的资源进行项目研发工作 集成集成系统集成人员按照项目系统集成人员按照项目进度集成组内开发人员的工作成进度集成组内开发人员的工作成果，构建系统，推进版本演进；果，构建系统，推进版本演进；管理基线管理基线SCCBSCCB根据项目的进根据项目的进展情况，并适时地建立基线，批展情况，并适时地建立基线，批准基线变更，保证开发和维护工准基线变更，保证开发和维护工作有序地进行；作有序地进行；产品开发产品开发系统集成人员进行系统集成人员进行产品集成，由产品集成，由SCCBSCCB批准，进行发批准，进行发布。布。