产品开发部配置管理制度

产品开发部配置管理制度

部 门： 产品开发部

编 写： ********

审 核：

批 准：

日 期：

2009-07-20

********有限公司

修 改 历 史

序号 版本 更改处·更改内容 更改人/日期 1 V1.00.000 创建文件 ******/2009-07-20 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

目 录

第一章 概述 ............................................... 错误!未定义书签。 1. 目的 .................................................. 错误!未定义书签。 2. 范围 .................................................. 错误!未定义书签。 3. 术语 .................................................. 错误!未定义书签。 4. 角色与职责 ............................................ 错误!未定义书签。 5. VSS配置库目录结构 ..................................... 错误!未定义书签。 6. 配置项命名规则 ........................................ 错误!未定义书签。 7. 配置项编号规则 ........................................ 错误!未定义书签。 8. 配置项状态变迁规则 .................................... 错误!未定义书签。 9. 配置项版本号规则 ...................................... 错误!未定义书签。 第二章 配置管理范围 ....................................... 错误!未定义书签。 第三章 配置库建立 ......................................... 错误!未定义书签。 第四章 配置管理流程 ....................................... 错误!未定义书签。

1. 配置管理流程 .......................................... 错误!未定义书签。 2. 基线建立流程 .......................................... 错误!未定义书签。 3. 变更控制流程 .......................................... 错误!未定义书签。 4. 产品发布流程 .......................................... 错误!未定义书签。 第五章 配置库权限变更管理 ................................. 错误!未定义书签。 第六章 配置库备份 ......................................... 错误!未定义书签。 第七章 配置库使用规范 ..................................... 错误!未定义书签。 第八章 附录 ............................................... 错误!未定义书签。 附录1 《附录清单》 ....................................... 错误!未定义书签。 附录2 《配置库目录结构》 ................................. 错误!未定义书签。 附录3 《配置申请单》 ..................................... 错误!未定义书签。 附录4 《受控库产品清单》 ................................. 错误!未定义书签。 附录5 《变更申请单》 ..................................... 错误!未定义书签。 附录6 《发布产品配置表》 ................................. 错误!未定义书签。 附录7 《产品发布申请及验收表》 ........................... 错误!未定义书签。

附录8 《产品发布检查表》 ................................. 错误!未定义书签。 附录9 《产品发布清单》 ................................... 错误!未定义书签。

第一章 概述

1. 目的

为了保证产品开发部研发项目文件的安全性、机密性；为了保证软件产品的完整性、有效性及可追溯性，特根据部门实际情况制订本制度。

2. 范围

适用于产品开发部所有项目。

3. 术语

概念 描述 软件配置管理是指通过执行版本控制、变更控制等规程，以及使(Software Configuration Management, SCM ） 用合适的配置管理软件，来保证所有配置项的完整性和可跟踪性。配置管理是对工作成果的一种有效保护。 配置项产品配置是指一个产品在其生命周期各个阶段所产（CI,Configuration 生的各种形式和各种版本的文档、计算机程序、部Items） 件及数据的集合。该集合中的每一个元素称为该产品配置中的一个配置项. 基线(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_受控库产品清单_

7. 配置项编号规则

1)

配置项编号规则：固定字段 / 项目编号_[子模块编号] / 版本号（日期_[序号]）

示例1：以下表《可行性分析报告》为例：QR704/01/KFB/GM2000-MN/V1.00.000 示例2：以下表《质量月报》为例：QR701/01/KFB/GM2000-MN/200907 表1说明

2)

红色部分为公司内/外审时，必须提交的文档。其余为部门内部文档。 编号第二字段为01-50，表示是公司内/外审必须文档，51以后的数字代表部门内部文档。

改表预留了号码，以后可以根据实际需要添加删除文档。

阶段 文档类型 文档编号 备注 《需求调研计划》 QR704/51/KFB 《需求调研记录》 QR704/52/KFB 《可行性分析报告》 QR704/01/KFB 《用户需求说明书》 QR704/02/KFB 《软件/系统需求规格说定义 明书》 QR704/53/KFB 《需求确认表》 QR704//KFB 《项目计划》（包含附件:QR704/03/ 进度Project文档） 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/ 《配置申请单》 KFB QR706/52/ 《变更申请单》 KFB QR706/53/ 《受控库产品清单》 KFB 阶段 文档类型 文档编号 备注 QR706// 《配置状态报告》 KFB 《产品发布申请及验收表》 QR706/03 / KFB QR706/04/ 《发布产品配置表》 KFB 《质量保证报告》 日常支持文档 质量保障类： QR701/51/KFB 《质量保证检查表》 QR701/52/KFB 《质量月报》 QR701/01/KFB 《代码检查表》 QR701/53/KFB QR704/10《评审通知》 日常支持/KFB 阶段 文档 管理评审类： 文档类型 文档编号 备注 《预读记录》 QR704/57/KFB 《评审意见汇总表》 QR704/11/KFB 《评审问题跟踪表》 QR704/58/KFB 《评审会议纪要》 QR704/59/KFB 《设计开发任务书》 QR704/60/KFB 《工作任务单》

QR704/12/KFB 8. 配置项状态变迁规则

1)

配置项的状态有三种：“草稿”（Draft）、“正式发布”（Released）和“正在修改”（Changing）。

2)

.配置项状态变迁如下图所示。配置项刚建立时其状态为“草稿”。配置项通过评审（或审批）后，其状态变为“正式发布”。当配置项的状态成为“正式发布”时任何人都不能随意修改，必须依据“申请－审批－执行变更－再评审－结束”的“变更控制流程“执行。当配置项修改完毕并重新通过评审（或

审批）时，其状态又变为“正式发布”，如此循环。

变更控制 评审

9. 配置项版本号规则

配置项的版本号与配置项的状态紧密相关：

（1）处于“草稿”状态的配置项的版本号格式为：V 的首字母，代表后面的数字为版本号。

Z数字范围为001-999

随着草稿的不断完善，“Z”的取值应递增。 “Z”的初值为001，增幅为001. 例子：V 0.00.001

（2）处于“正式发布”状态的配置项的版本号格式为：V 为主版本号，取值范围为1-9。Y为次版本号，取值范围为00-99。

配置项第一次“正式发布”时，版本号为V 1.00.000。

如果配置项的版本升级幅度比较小，一般只增大Y值，X值保持不变。只有当

配置项版本升级幅度比较大时，才允许增大X值。

例子：V 1.01.000

（3）处于“正在修改”状态的配置项的版本号格式为：V 数字范围为001-999 配置项正在修改时，一般只增大Z值，值保持不变。

当配置项修改完毕，状态重新成为“正式发布”时，将Z值设置为0，增加值。参见规则（2）。

例子：V 1.01.001

第二章 配置管理范围

配置管理包括：所有研发项目文档、源代码、可执行程序，特殊工具及相关资料等。

项目文档主要指：立项建议书、项目计划、需求说明书、软件规格说明书、概要/详细设计说明书、数据库表结构、测试文档、用户使用说明书以及项目过程中管理类文档等。

特殊工具及其相关资料指开发或测试过程中比较特殊的工具，以及其使用文档等，如觉得有必要也纳入配置库的管理。

第三章 配置库建立

1.

项目立项时，由项目经理申请建立项目配置库，配置管理员与项目经理确定配置项，并参考附录2：配置库目录结构，建立配置库以及配置库目录结构；项目经理提供配置库权限清单（内容应包括员工姓名、项目名称、目录权限等），由配置管理员为相关人员的设置配置权限。

2.

配置库权限设置完成之后，由配置管理员将配置库名称、访问路径、访问权限等信息以邮件方式通知各相关人员；配置库使用人员以各自的用户名和密码进行访问配置库。

3.

配置库密码只能在服务器上设置，但使用人员可以在客户端修改自己的秘密，如配置库使用人员密码遗忘，可以与配置管理员取得联系，进行修改密码。

第四章 配置管理流程

1. 配置管理流程

项目经理配置管理员依项目经理审变更控制流 开发人员申请建立基线的项目经理依据按照配置管理相关 规则（见项目经理依据《配置管本制度第配置管理 员按照《配项目经理依据《配置管理置管理计 测试人项目经理依据《配置管理员负责测项目经理 和评审小项目经理依据《配置管理计项目经理依照产品发布产品发布组负责变更、基线建

2. 基线建立流程

项目经理按照《配置管理计划》在规定时间填《配置申评审小组对评审组长将《配通项目经理将《配置申请单》(纸质和电子版)送 《受控库

3. 变更控制流程

配置项或基线《变更申请评审小组对评审组长将《变通过执行人进行相未通评审小组对通过申请人将《变更申请单》(纸质和电子版)送交配置管理

4. 产品发布流程

项目经理填写《发布产品配置《发布产品配置表》见附录项目经理送交相关人员部门经理将《发布产品配置表》通过项目经理将《发布产品配置表》和《产配置管理员依照《发布产品配置表》和《产品发布申请及验收表》将《产品发布检查表》见附录8

第五章 配置库权限变更管理

若在使用配置库的过程中需要变更配置库管理权限，可以由项目管理员或项目经理以邮件或口头方式通知配置管理员，配置管理员变更之后，将变更结果以电子邮件方式通知受影响的人员、项目经理、项目管理员及其相关人员。

配置管理员根据配置库权限变更频率，决定每隔一段时间将配置库权限清单与各项目经理进行审核确认，各项目经理审核后，若有权限需要进行变更，应及时通知配置管理员。 第六章 配置库备份

配置管理员应定期做好配置库的备份，以防意外引起的服务器上资料的丢失，避免给公司带来严重的损失。具体实施规范如下：

1.

配置管理员自创建项目配置库起，每月15号、28号对配置库进行硬盘备份一次（完全备份），为了节约硬盘空间，只保留最近的两次备份文件，之前的备份文件将被删除。

2.

配置管理员每遇到有基线产生时，对基线单独硬盘备份一次。

当项目结项时，对该项目成果进行硬盘和光盘双重备份，备份后的光盘标记上备份日期并附上内容清单，移交部门行政秘书保管。

3.

4.

如遇特殊情况需要特殊备份时，需项目经理和部门经理协商后，通知配置管理员做特殊备份。

第七章 配置库使用规范

1.

所有立项的项目，都必须申请建立配置库。开发过程中所有文档和代码必须纳入配置库管理，若因未纳入配置库管理造成的资料丢失或版本差异，其责任皆由开发人员及项目经理承担。

2.

配置库服务器密码只有配置管理员和产品开发部经理掌握，其他人如因特殊原因需要该密码，必须经过产品开发部经理的批准后方能获取；并在使用完密码之后，通知产品开发部经理和配置管理员，配置管理员及时设置新的密码，以保证服务器资料的安全性和机密性。

3.

各配置库的使用人员必须使用各自的用户名和密码进入配置库，访问授权的配置库。各使用人员不得将自己的用户名和密码泄漏给其他人员，若因泄露密码而引起的后果将由泄漏密码者本人承担。

4.

各项目的配置库用于项目组正式开发使用，项目组成员不得恶意对其进行修改、删除、增加等操作；若因对VSS工具不熟悉，需要学习，可以向配置管理员提出需求，由配置管理员为其提供可以练习的配置库。

5.

各项目经理负责定期检查配置库的使用情况，查看是否有员工进行无故删除或恶意修改文件的行为;并对开发人员提交的文档和代码的及时性、准确性和完整性进行检查。

6.

在研发人员离职时，由其项目经理负责检查配置库，检查该人员提交的代码或文档是否完全放入配置库管理，确认版本和相应文件完整无误后，项目经

理在“员工离职申请单”中签字，该员工方可离职。同时项目经理应及时通知配置管理员，取消该人员的所有权限。若因项目经理审核不细致造成的代码或文档移交不完整，或项目经理未及时通知配置管理员取消权限，而造成的损失，该责任完全由项目经理承担。

7.

在配置库使用时，为了避免配置库checkin或checkout时引起冲突，需注意： 项目经理在划分模块时注意每个人的模块之间尽量不要重叠。 开发人员在修改文件之前，养成事先checkout的习惯。

开发人员注意checkin的频率，尽量及时checkin，最好每天提交一次。

第八章 附录 附录1 《附录清单》

序号 名称 存储路径 附件2 《配置库目录结构》 Vss_Assets /3.软件开发/1.开发过附件3 《配置申请单》 程/6.配置管理 附件4 《受控库产品清单》 附件5 《变更申请单》 附件6 《发布产品配置表》 《产品发布申请及验附件7 收表》 Vss_Assets/3.软件开发/1.开发过附件8 《产品发布检查表》 程/5.发布 附件9 《产品发布清单》 附录2 《配置库目录结构》 配置库目录结构

每一个项目的配置库可分为1work（开发库）、2confirmed（受控库）和3release（发布库），如下为配置库目录结构模板，可以根据实际情况增减：

一级目录 二级目录 三级目录 四级目录 说明 Vss_项目1work 编号 1doc（文档目录） 1project 项目启动、定义阶段产生的相关文档（如：项目计划、配置管理计划等） 2management 与该项目相关的管理文档（如：质量月报、配置状态报告等） 3requirement 需求阶段产生的文档(用户需求说明书,软件规格说明书等) 4design 项目设计阶段产生的相关文档（如：概要设计文档、详细设计文档等） 5test 项目测试阶段产生的文档（如：测试报告、测试大纲等） 6review 评审文档 7meeting 会议文档 8workreport 每周工作报告（项目周报、工作日志等） 9training 培训文档 1code 项目代码(可以根据项目需求自定义子目录) 2src（源码目录） 2html 系统原型 3install 安装包 3temp （项目临时文件） 用于存放项目开发工程中产生的临时文件 配置管理员可根据配置管理计划建立基线目录 2confirmed 3release 发布库 附录3 《配置申请单》 配置申请单 说明：

该表格适用于配置项提交、基线建立申请。 配置项或基线入受控库时填写该表。

1.

2.

编号：QR706/51/ FKB/ 项目编号/日期（格式：）

申请部分(由申请人填写) 项目名成都地铁一号线 称 项目编号 申请类型 ■ 配置项提交 □ 基线建立 申请人 申请日2009-05-19 期 配置项 所属基配置项编号 线 名称 版本号 存储路径（开提交时备注 发库） 间 2009-05-19 申请说明 评审部分（由评审组长填写） 评审时间 评审组长 评审组成员 审批结果 □ 批准 □ 拒绝 评日期：

审组长签字： 附录4 《受控库产品清单》

受控库产品清单 项目入序名称库 所属基线 配置项 名称 存放位置版本（受控库） 号 存放位置（开发库） 入库申请人 时间 依据 活动备注 号 (编类号) 型 00 4 005 006 007 008 009 010 011 012 013 014 01 5 016 017 018 019

附录5 《变更申请单》 变更申请单 填表说明：

1. 该表适用于配置项变更和基线变更时填写。

2. 评审组长一般为项目经理。

项目名称 项目编号 申请类型 □配置项变更 □基线变更 申请人 申请日期 1. 变更申请（由变更申请人填写） 申请变所属基配置项编号 更的 配置项 线 名称 版本号 配置项对应开发库路径 V1.00.000 变更的内容 及其理由 估计配置项变更将对 项目造成的影响 变更申请人签字 编号：QR706/52/ FKB/项目编号/日期（格式：） 附录6 《发布产品配置表》 说明：

1.

此表由项目经理填写。

此表中的模块必须填写完整，所列模块必须是组成该项目的所有模块。 项目名称（项目编号）： 编号：QR706/04/ KFB/项目编号/发布版本号

2.

3.

数据库数据库操作系开发工序模块号 名称 版本 名称及文件名统名称具 称 及版本 及版本 配置/安装文件 有无可执 行文件 支持软件 模块负 责人 备注 Windows 2000 VC++ 见配置文件 profesMFC sional 调度员1 工作站 Sybase √ Windows 2000 VC++ 见配置文√ profesMFC sional 件/conf/ 分析员 Sybase 工作站 Windows 2000 VC++ 见配置文件 profesMFC sional 通信前3 置机 Sybase √ 服务器4 后台 Sybase SolariGCC 无 s 3.4.6 Windows 2003 DSN:scada Visual UID:sa 2005 (C#) PWD:sqlsql Web复5 视 Sybase Advanced Server √ 请Window查 看：《使用注意 SQL 维护员6 工作站 000 Server2s 2000 VC++ √ profesMFC sional 问题.txt》

提交人（签字，包含日期）： 接收人（签字，包含日期）：

附录7 《产品发布申请及验收表》 产品发布申请及验收表 填表说明：

1. 产品在发布前，必须填写本表。本表所有需要签名的栏目必须手签。

2. 经过测试的产品发布，由测试人员填写本表的主要栏目。通过了系统测试、升级包测试的，发布类型判定为“定版发布”。通过或部分通过紧急发布测试的，部分通过系统测试、升级包测试的，都只能判定为“让步发布”。

3. 未经过测试的产品发布，由项目经理或指定的开发人员填写本表。发布类型只能是“特例发布”。

表单编号：QR706/03/ KFB/项目编号/日期（格式：）

1.申请部分(除特别说明外均由申请人填写) 项目名称_[子发布产品名称 模块名称] 日期 2009-07-07 发布版本号 V1.00.000 产品□完整产品 □模块产品 □升级包 □其它 形态 _______________________ 发布□定版发布 □让步发布 □特例发布 □其它 类型 ______________________ 适用用户洛张线 （版本） 申请 附件名称 人 项目名称_[子发布模块名称]_版发布包存储路径 包名称 本号.rar VSS_GM2000-MN/3release/洛张线/洛张线_LZ_V1.00.000 发布包文件清单 序文档/模块编号 号 名称 对应开发库存储路径 备注 1 项目编号_子模块名称_类型名称_版本号（日期_[序号]） VSS_GM2000-MN/1work/2src/1code/洛张基础项目 版本：石怀线调度员工作站，未修改。 2 CDDT-1_地无 VSS_GM2000-MN/1work/2src/1code/洛张基础铁维护单元_源代码_V1.00.000 项目 版本：石怀线分析员工作站，未修改。 3 CDDT-1_项QR704/03/ 目计VSS_GM2000-MN/1work/2src/1code/洛张 划KFB/CDDT-1/V1.00.000 项目 _V1.00.000 4 CDDT-1_地无 铁维护单元_可执行文件_V1.00.000 VSS_GM2000-MN/1work/2src/1code/洛张项目 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 2 2.审批部分（由相关负责人填写） 职位 同意发拒绝发签字（必需手写） 签字日期 布 布 备注 测试人员 项目经理 配置管理员 最终审批结果： □ 同意发布 □ 拒绝发布 部门经理签字： 签字日期： 3.验收部分（由总工办及质量管理办公室填写） 接收产品 拒绝接收拒绝理由 产品 验收时间 验收人签字 备注 负责人确认签字： 签字日期 ：

附录8 《产品发布检查表》

产品发布检查表 编号 产品发布检查表编号 检查目标 项目编号(产品编号)_版本号 检查人 配置管理员(手签) 检查日期 检查项 检查项（《产品发布申请及验检查项状序号 收表》） 态 检查记录 备注 产品名称填写是否正确(若为1 子模块产品，名称是否和发布通过 产品配置表所列一致) 2 产品形态选择是否正确 3 发布类型选择是否正确 4 附件名称填写是否正确 发布包名称填写是否符合规5 范 发布包存储路径填写是否正6 确 发布包清单所列文件名称是7 否正确 8 发布产品是否有帮助菜单项 发布包清单所列版本号是否和产品帮助->关于菜单所示9 版本号一致（若为文档，文件 版本号是否和内部所示版本号一致） 发布清单对应开发库存储路10 径是否正确 发布清单对应开发库标签号11 是否正确 新增/修改功能对应发布包的12 文件名是否正确 新增/修改功能对应BugFree13 缺陷号是否正确 发布产品是否含有源码的可14 执行文件 发布产品是否含有《产品配置15 表》 发布产品是否含有《用户使用16 说明书》 发布产品配置表是否涵盖了17 产品运行必须的组件 填表说明：1.本表由配置管理员进行填写，需根据产品发布检查项进行检查，并填写

检查结果。 也可作为项目经理、部门经理、QA检查产品发布工作的依据。

2. 进行QA检查时，可以用以下字符替代“检查项状态”的文字说明。 通过：Y 不通过：X 部分通过：P 待定：TBD（To Be Defined）

附录9 《产品发布清单》

申项目名序称（编号 号） 名称 径 期 发布包产品形态 存储路申请人 日据 发布包请活动依备注 001 002 003 004 005 006 007 008 009 010