产品开发部配置管理制度

文件编号： gm/kfb/cms/20090720版本号： v1.00.000产品开发部配置管理制度部门：产品开发部编写：*审批日核： 准：期：2009-07-20* 有限公司修 改 历 史目录第一章概述61.目的 .62.范围 .63.术语 .64.角色与职责 .75. vss 配置库目录结构.86. 配置项命名规则.87. 配置项编号规则.98. 配置项状态变迁规则.119. 配置项版本号规则.12第二章配置管理范围13第三章配置库建立13第四章配置管理流程141. 配置管理流程.错误！未定义书签。2. 基线建立流程.163. 变更控制流程.184. 产品发布流程.19第五章配置库权限变更管理20第六章配置库备份20第七章配置库使用规范20第八章附录21附录1附录清单.21附录2配置库目录结构.22附录3配置申请单.24附录4受控库产品清单.25附录5变更申请单.27附录6发布产品配置表.29附录7产品发布申请及验收表.31附录8产品发布检查表.34附录9产品发布清单.36第一章概述1. 目的为了保证产品开发部研发项目文件的安全性、机密性； 为了保证软件产品的完整性、有效性及可追溯性， 特根据部门实际情况制订本制度。2. 范围适用于产品开发部所有项目。3. 术语基线 (baseline)基线就是一个ci 或一组 ci 在其生命周期的不同时间点上通过正式评审而进入正式受控的一种状态，而这个过程被称为“基线化”。每一个基线都是其下一步开发的出发点和参考点。每个基线都将接受配置管理的严格控制，对其的修改将严格按照变更控制要求的过程进行，在一个软件开发阶段结束时，上一基线加上增加和修改的基线内容形成下一个基线，这就是基线管理的过程。(基线：是指在软件开发过程中的里程碑，这些里程碑的标志是一项或多项经过正式的技术评审并一致认同的ci 的提交 )4. 角色与职责角色职责项目经理确定配置项、确定配置库目录权限；审查配置库变更；项目开发过程中， 监督配置库使用情况；员工离职时，配置库归档完整性审核。开发小组根据配置管理制度，进行配置库的日常使用测试小组从开发库中取出版本进行整合测试； 负责验证代码变更及修改是否正确执行。测试小组测试通过的版本方可放入受控库。配置管理员 负责配置库的建立、 权限设置、 负责培训开发人员使用配置管理工具、 对配置库使用情况进行管理和监督、 建立配置库基线； 定期备份配置库； 建立和完善配置管理制度。5. vss开发库：主要用来保存开发过程中不稳定的配置项（源码和相关文档），主要由开发人员支配。受控库：用来保存基线产品（阶段性提交的通过评审且相对稳定的配置项），主要由配置管理员支配。发布库：用来保存发布的产品，即交付给用户的产品、升级包、文档等，主要由测试人员支配。（这里的用户特指总工办，这里的发布属于公司内部发布。）6. 配置项命名规则配置项的命名规则分两种：1) 在开发库和受控库中，命名规则为：项目编号_子模块名称 _类型名称类型名称：为用户需求说明书、源代码、可执行文件、测试报告等。例子： cddt-1_ 地铁维护单元_源代码， cddt-1_ 用户需求说明书。2) 在发布库中，命名规则为：项目编号_子模块名称 _类型名称 _版本号（日期 _序号 ）例子 1： cddt-1_ cddt-1_地铁维护单元 _源代码 _v1.00.000例子 2： cddt-1_ 受控库产品清单_200907147. 配置项编号规则1) 配置项编号规则：固定字段/ 项目编号 _子模块编号 / 版本号（日期 _ 序号） 示例 1：以下表可行性分析报告为例：qr704/01/kfb/gm2000-mn/v1.00.000 示例 2：以下表质量月报为例：qr701/01/kfb/gm2000-mn/2009072) 表 1 说明红色部分为公司内/外审时，必须提交的文档。其余为部门内部文档。编号第二字段为01-50 ，表示是公司内/外审必须文档，51 以后的数字代表部门内部文档。改表预留了号码，以后可以根据实际需要添加删除文档。阶段文档类型文档编号备注需求调研计划qr704/51/kfb定义需求调研记录可行性分析报告用户需求说明书qr704/52/kfbqr704/01/kfbqr704/02/kfb软件 /系统需求规格说明书qr704/53/kfb阶段文档类型文档编号备注需求确认表qr704/54/kfb项目计划（包含附件 :进度project文档）qr704/03/ kfb配置管理计划qr706/01/ kfb质量保证计划qr701/51/kfb概要设计说明书qr704/04/ kfb设计详细设计说明书qr704/55/kfb实现测试计划qr704/05/ kfb测试测试报告qr704/06/kfb未关闭缺陷原因说明表qr704/56/kfb硬件 /软件设计更改说明qr704/07/ kfb改造项目需提交发布项目总结报告qr704/08/ kfb用户手册qr704/09/ kfb配置管理报告qr706/02/ kfb日常支持文档配置管理类：配置申请单变更申请单qr706/51/ kfbqr706/52/ kfb受控库产品清单qr706/53/ kfb阶段文档类型文档编号备注配置状态报告qr706/54/ kfbqr706/03/产品发布申请及验收表kfb发布产品配置表qr706/04/ kfb质量保证报告qr701/51/kfb日常支持文档质量保证检查表qr701/52/kfb质量保障类：质量月报qr701/01/kfb代码检查表qr701/53/kfbqr704/10/k评审通知fb预读记录qr704/57/kfb日常支持文档管理评审类：评审意见汇总表qr704/11/kfb评审问题跟踪表qr704/58/kfb评审会议纪要qr704/59/kfb设计开发任务书qr704/60/kfb工作任务单qr704/12/kfb8. 配置项状态变迁规则1) 配置项的状态有三种： “草稿（”draft ）、“正式发布（”released ）和“正在修改”（ changing ）。2) .配置项状态变迁如下图所示。配置项刚建立时其状态为“草稿”。配置项通过评审（或审批）后，其状态变为“正式发布”。当配置项的状态成为“正式发布”时任何人都不能随意修改，必须依据“申请审批执行变更再评审结束”的“变更控制流程“执行。当配置项修改完毕并重新通过评审（或审批）时，其状态又变为“正式发布”， 如此循环。9. 配置项版本号规则配置项的版本号与配置项的状态紧密相关：（ 1 ）处于“草稿”状态的配置项的版本号格式为：v 0.00.z “v “version的首字母，代表后面的数字为版本号。 z 数字范围为001-999随着草稿的不断完善， “z”的取值应递增。“z”的初值为 001 ，增幅为 001.例子： v 0.00.001（ 2 ）处于“正式发布”状态的配置项的版本号格式为：v x.y.000x 为主版本号，取值范围为1-9 。 y 为次版本号，取值范围为00-99 。配置项第一次“正式发布”时，版本号为v 1.00.000 。如果配置项的版本升级幅度比较小，一般只增大y 值， x 值保持不变。只有当配置项版本升级幅度比较大时，才允许增大x 值。例子： v 1.01.000（ 3 ）处于“正在修改”状态的配置项的版本号格式为：v x.y.z z 数字范围为001-999配置项正在修改时，一般只增大z 值， x.y 值保持不变。当配置项修改完毕，状态重新成为“正式发布”时，将z 值设置为0 ，增加 x.y 值。参见规则（2）。例子： v 1.01.001第二章配置管理范围配置管理包括：所有研发项目文档、源代码、可执行程序，特殊工具及相关资料等。项目文档主要指：立项建议书、项目计划、需求说明书、软件规格说明书、概要/ 详细设计说明书、数据库表结构、测试文档、用户使用说明书以及项目过程中管理类文档等。特殊工具及其相关资料指开发或测试过程中比较特殊的工具，以及其使用文档等，如觉得有必要也纳入配置库的管理。第三章配置库建立1. 项目立项时，由项目经理申请建立项目配置库，配置管理员与项目经理确定配置项，并参考附录2 ：配置库目录结构， 建立配置库以及配置库目录结构；项目经理提供配置库权限清单（内容应包括员工姓名、项目名称、目录权限等），由配置管理员为相关人员的设置配置权限。2. 配置库权限设置完成之后，由配置管理员将配置库名称、访问路径、访问权限等信息以邮件方式通知各相关人员；配置库使用人员以各自的用户名和密码进行访问配置库。3. 配置库密码只能在服务器上设置，但使用人员可以在客户端修改自己的秘密，如配置库使用人员密码遗忘，可以与配置管理员取得联系，进行修改密码。第四章配置管理流程1. 配置管理流程定义阶段项目经理 编写项目计划并通过评审。配置管理员 依据项目计划 编写配置管理计划项 目 经 理 审 批 配 置 管 理 计划变更控制流程见变更控制流程整个阶段申请建立基线的流程见基线建立流程设计阶段项目经理 依据配置管理计划在规定时间申请建立定义基线 .实现阶段项目经理 依据配置管理计划在规定时间申请建立实现基线测试阶段项目经理 依据配置管理计划在规定时间申请建立测试基线项目经理 依据配置管理计划在规定时间申请建立 定义基线 .开 发 人 员 按照 配 置 管 理相关规则 （见本 制 度 第 六章）在开发库中 创 建 、 命名、标记、变更（按照变更控制流程） 配置项。配置管理员按照配置管理计划 和本制度管理配置库的变更、备份、基线建立、等 工作。测试人员负责测试和产品的发布等工作。项目经理 依据配置管理计划在规 定时间申请建立发布基线 .发布阶段项 目 经 理 依 照产品发布流程 ， 发布产品。产品发布流程见 产品发布流程项目经理和评审小组 负责变更、基线建立 等工作的审批 和对配置管理 工作的检查、 指导、监督工 作。2. 基线建立流程3. 变更控制流程4. 产品发布流程第五章配置库权限变更管理若在使用配置库的过程中需要变更配置库管理权限，可以由项目管理员或项目经理以邮件或口头方式通知配置管理员，配置管理员变更之后，将变更结果以电子邮件方式通知受影响的人员、项目经理、项目管理员及其相关人员。配置管理员根据配置库权限变更频率，决定每隔一段时间将配置库权限清单与各项目经理进行审核确认，各项目经理审核后，若有权限需要进行变更，应及时通知配置管理员。第六章配置库备份配置管理员应定期做好配置库的备份，以防意外引起的服务器上资料的丢失，避免给公司带来严重的损失。具体实施规范如下：1. 配置管理员自创建项目配置库起，每月15 号、28 号对配置库进行硬盘备份一次（完全备份），为了节约硬盘空间，只保留最近的两次备份文件，之前的备份文件将被删除。2. 配置管理员每遇到有基线产生时，对基线单独硬盘备份一次。3. 当项目结项时，对该项目成果进行硬盘和光盘双重备份，备份后的光盘标记上备份日期并附上内容清单，移交部门行政秘书保管。4. 如遇特殊情况需要特殊备份时，需项目经理和部门经理协商后，通知配置管理员做特殊备份。第七章配置库使用规范1. 所有立项的项目，都必须申请建立配置库。开发过程中所有文档和代码必须纳入配置库管理，若因未纳入配置库管理造成的资料丢失或版本差异，其责任皆由开发人员及项目经理承担。2. 配置库服务器密码只有配置管理员和产品开发部经理掌握，其他人如因特殊原因需要该密码，必须经过产品开发部经理的批准后方能获取； 并在使用完密码之后，通知产品开发部经理和配置管理员， 配置管理员及时设置新的密码，以保证服务器资料的安全性和机密性。3. 各配置库的使用人员必须使用各自的用户名和密码进入配置库， 访问授权的配置库。 各使用人员不得将自己的用户名和密码泄漏给其他人员，若因泄露密码而引起的后果将由泄漏密码者本人承担。4. 各项目的配置库用于项目组正式开发使用，项目组成员不得恶意对其进行修改、删除、增加等操作；若因对 vss 工具不熟悉，需要学习，可以向配置管理员提出需求，由配置管理员为其提供可以练习的配置库。5. 各项目经理负责定期检查配置库的使用情况，查看是否有员工进行无故删除或恶意修改文件的行为;并对开发人员提交的文档和代码的及时性、准确性和完整性进行检查。6. 在研发人员离职时，由其项目经理负责检查配置库，检查该人员提交的代码或文档是否完全放入配置库管理，确认版本和相应文件完整无误后，项目经理在“员工离职申请单”中签字，该员工方可离职。同时 项目经理应及时通知配置管理员，取消该人员的所有权限。若因项目经理审核不细致造成的代码或文档移交不完整， 或项目经理未及时通知配置管理员取消权限， 而造成的损失， 该责任完全由项目经理承担。7. 在配置库使用时，为了避免配置库checkin或 checkout时引起冲突，需注意：项目经理在划分模块时注意每个人的模块之间尽量不要重叠。开发人员在修改文件之前，养成事先checkout的习惯。开发人员注意checkin的频率，尽量及时checkin ，最好每天提交一次。第八章附录附录 1 附录清单附件 2配置库目录结构附件 3配置申请单附件 4受控库产品清单vss_assets /3.软件开发 /1. 开发过程 /6. 配置管理附件 5变更申请单附件 6发布产品配置表附件 7附件 8产品发布申请及验收表产品发布检查表vss_assets/3.软件开发 /1. 开发过程 /5. 发布附件 9产品发布清单附录 2 配置库目录结构配置库目录结构每一个项目的配置库可分为1work （开发库）、2confirmed （受控库）和3release （发布库），如下为配置库目录结构模板，可以根据实际情况增减：一级目录二级目录三级目录四级目录说明1project项目启动、定义阶段产生的相关文档（如：项目计划、配置管理计划vss_ 项目编号1work1doc （文档目录）等）2management与该项目相关的管理文档（如：质量月报、配置状态报告等）3requirement需求阶段产生的文档(用户需求说明书 ,软件规格说明书等)4design项目设计阶段产生的相关文档（如：概要设计文档、详细设计文档等）5test项目测试阶段产生的文档（如：测试报告、测试大纲等）6review评审文档7meeting会议文档8workreport每周工作报告（项目周报、工作日志等）9training培训文档1code项目代码(可以根据项目需求自定2src （源码目录）义子目录 )2html系统原型3install安装包3temp（项目临时文件）用于存放项目开发工程中产生的临时文件2confirmed配置管理员可根据配置管理计划建立基线目录3release发布库附录 3 配置申请单配置申请单说明：1. 该表格适用于配置项提交、基线建立申请。2. 配置项或基线入受控库时填写该表。编号： qr706/51/ fkb/项目编号 /日期（格式： 20090717 ）项目名称申请类型成都地铁一号线 配置项提交项目编号 基线建立申请人申请日期2009-05-19评审部分（由评审组长填写）评审时间评审组长评审组成员审批结果 批准 拒绝评审组长签字：日期：附录 4 受控库产品清单受控库产品清单项目名序称( 编号号)入库所属基类型线配置项名称存放位置（受控库）版本存放位号置（开发库）入库时间活动申请人备注依据004005006007008009010011012013014015016017附录 5 变更申请单变更申请单填表说明：1. 该表适用于配置项变更和基线变更时填写。2. 评审组长一般为项目经理。项目名称项目编号申请类型配置项变更基线变更申请人申请日期1. 变更申请（由变更申请人填写）申请变更的配置项所属基线配置项名称编号版本号配置项对应开发库路径v1.00.000变更的内容及其理由估计配置项变更将对项目造成的影响变更申请人签字2. 审批变更申请 (由评审组长填写)审批结果审批结果 批准 拒绝评审组长签字：日期：批准变更的配置项变更执行人时间限制备注3. 变更配置项（由变更执行人填写）变更后的配置项名称变更后的版本号变更完成日期备注2009-05-234. 结束变更（由评审组长填写）重新审批结果-可编辑修改 - 批准 拒绝编号： qr706/52/ fkb/项目编号 /日期（格式：20080717 ）附录 6 发布产品配置表说明：1. 此表由项目经理填写。2. 此表中的模块必须填写完整，所列模块必须是组成该项目的所有模块。3. 项目名称（项目编号） ：编号： qr706/04/ kfb/项目编号 /发布版本号提交人（签字，包含日期）：接收人（签字，包含日期）：附录 7 产品发布申请及验收表产品发布申请及验收表填表说明：1. 产品在发布前，必须填写本表。本表所有需要签名的栏目必须手签。2. 经过测试的产品发布，由测试人员填写本表的主要栏目。通过了系统测试、升级包测试的，发布类型判定为“定版发布”。通过或部分通过紧急发布测试的，部分通过系统测试、升级包测试的，都只能判定为“让步发布”。3. 未经过测试的产品发布，由项目经理或指定的开发人员填写本表。发布类型只能是“特例发布”。表单编号： qr706/03/ kfb/项目编号 /日期（格式： 20090717 ）号1项目编号 _子模块名称_类型名vss_gm2000-mn/1work/2src/1code/洛张基础版本： 石怀线调称_版本号（日期 _序号 ）项目度员工作站，未修改。2cddt-1_ 地铁维护单元 _源代码无vss_gm2000-mn/1work/2src/1code/洛张基础版本： 石怀线分_v1.00.000项目析员工作站，未修改。3cddt-1_ 项目计划 _v1.00.000qr704/03/kfb/cddt-1/v1.00.000vss_gm2000-mn/1work/2src/1code/项目洛张4cddt-1_ 地铁维护单元 _可执行无vss_gm2000-mn/1work/2src/1code/洛张文件 _v1.00.000项目5 vss_gm2000-mn/1work/2src/1code/洛张项目6 vss_gm2000-mn/1work/2src/1code/洛张项目7 vss_gm2000-mn/1work/1doc/4design/洛张项目8 /vss_gm2000-mn/1work/2src/3install/洛张项目9 /vss_gm2000-mn/1work/2src/3install/洛张项目发布产品简介及安装说明1. 产品简介本产品对洛张线所管辖的牵引变电所、分区所、开闭所以及接触网开关等牵引供电设施进行实时数据采集和集中监控管理。本产品包括web 复视系统、调度员工作站、分析员工作站、后台、通讯前置机、维护员工作站6 个模块。本版本是该软件的初始版本。基础版本：石怀线gm2000系统新增/修改功能序号新增/修改功能修改后对应发布包文件名对应 bugfree缺陷号备注1