1、技术公司产品开发部配置管理制度附发布申请验收表编 制： 审 核： 批 准： 版 本 号: ESZAQDGF001 编 制： 审 核： 批 准： 版 本 号: 目 录第一章 概述51.目的52.范围53.术语54.角色与职责65. VSS配置库目录结构76. 配置项命名规则77. 配置项编号规则78. 配置项状态变迁规则109. 配置项版本号规则10第二章 配置管理范围11第三章 配置库建立11第四章 配置管理流程121. 配置管理流程122. 基线建立流程143. 变更控制流程154. 产品发布流程16第五章 配置库权限变更管理17第六章 配置库备份17第七章 配置库使用规范17第八章 附录12、8附录1 附录清单18附录2 配置库目录结构19附录3 配置申请单20附录4 受控库产品清单21附录5 变更申请单22附录6 发布产品配置表23附录7 产品发布申请及验收表24附录8 产品发布检查表26附录9 产品发布清单27第一章 概述1. 目的为了保证产品开发部研发项目文件的安全性、机密性；为了保证软件产品的完整性、有效性及可追溯性，特根据部门实际情况制订本制度。2. 范围适用于产品开发部所有项目。3. 术语 概念描述软件配置管理(Software Configuration Management, SCM）是指通过执行版本控制、变更控制等规程，以及使用合适的配置管理软件，来保证所有配置项3、的完整性和可跟踪性。配置管理是对工作成果的一种有效保护。配置项（CI,Configuration Items）产品配置是指一个产品在其生命周期各个阶段所产生的各种形式和各种版本的文档、计算机程序、部件及数据的集合。该集合中的每一个元素称为该产品配置中的一个配置项.基线(BaseLine)基线就是一个CI或一组CI在其生命周期的不同时间点上通过正式评审而进入正式受控的一种状态，而这个过程被称为“基线化”。每一个基线都是其下一步开发的出发点和参考点。每个基线都将接受配置管理的严格控制，对其的修改将严格按照变更控制要求的过程进行，在一个软件开发阶段结束时，上一基线加上增加和修改的基线内容形成下一个基4、线，这就是基线管理的过程。(基线：是指在软件开发过程中的里程碑，这些里程碑的标志是一项或多项经过正式的技术评审并一致认同的CI的提交)4. 角色与职责角色职责项目经理确定配置项、确定配置库目录权限；审查配置库变更；项目开发过程中，监督配置库使用情况；员工离职时，配置库归档完整性审核。开发小组根据配置管理制度，进行配置库的日常使用测试小组从开发库中取出版本进行整合测试；负责验证代码变更及修改是否正确执行。测试小组测试通过的版本方可放入受控库。配置管理员负责配置库的建立、权限设置、负责培训开发人员使用配置管理工具、对配置库使用情况进行管理和监督、建立配置库基线；定期备份配置库；建立和完善配置管理制5、度。评审小组对项目中的变更进行评审、监控；协调开发小组、测试小组、配置管理员进行配置库的优化和管理。5. VSS配置库目录结构 配置库（vss_PDMIS）开发库（1work）受控库（2confirmed）发布库（3release）存放基线产品存放发布产品存放配置项l 开发库：主要用来保存开发过程中不稳定的配置项（源码和相关文档），主要由开发人员支配。l 受控库：用来保存基线产品（阶段性提交的通过评审且相对稳定的配置项），主要由配置管理员支配。l 发布库：用来保存发布的产品，即交付给用户的产品、升级包、文档等，主要由测试人员支配。（这里的用户特指总工办，这里的发布属于公司内部发布。）6. 配置6、项命名规则配置项的命名规则分两种：1) 在开发库和受控库中，命名规则为：项目编号_子模块名称_类型名称l 类型名称：为用户需求说明书、源代码、可执行文件、测试报告等 。l 例子：CDDT-1_地铁维护单元_源代码，CDDT-1_用户需求说明书。2) 在发布库中，命名规则为：项目编号_子模块名称_类型名称_版本号（日期_序号）l 例子1：CDDT-1_ CDDT-1_地铁维护单元_源代码_Vl 例子2：CDDT-1_受控库产品清单_200907147. 配置项编号规则1) 配置项编号规则：固定字段 / 项目编号_子模块编号 / 版本号（日期_序号）l 示例1：以下表可行性分析报告为例：QR7047、/01/KFB/GM2000-MN/Vl 示例2：以下表质量月报为例：QR701/01/KFB/GM2000-MN/2009072) 表1说明l 红色部分为公司内/外审时，必须提交的文档。其余为部门内部文档。l 编号第二字段为01-50，表示是公司内/外审必须文档，51以后的数字代表部门内部文档。l 改表预留了号码，以后可以根据实际需要添加删除文档。阶段文档类型文档编号备注定义需求调研计划QR704/51/KFB需求调研记录QR704/52/KFB可行性分析报告QR704/01/KFB用户需求说明书QR704/02/KFB软件/系统需求规格说明书QR704/53/KFB需求确认表QR704/58、4/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/ KFB变更申请9、单QR706/52/ KFB受控库产品清单QR706/53/ KFB配置状态报告QR706/54/ 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工作任10、务单QR704/12/KFB8. 配置项状态变迁规则1) 配置项的状态有三种：“草稿”（Draft）、“正式发布”（Released）和“正在修改”（Changing）。2) .配置项状态变迁如下图所示。配置项刚建立时其状态为“草稿”。配置项通过评审（或审批）后，其状态变为“正式发布”。当配置项的状态成为“正式发布”时任何人都不能随意修改，必须依据“申请审批执行变更再评审结束”的“变更控制流程“执行。当配置项修改完毕并重新通过评审（或审批）时，其状态又变为“正式发布”，如此循环。通过变更控制正式发布否决评审或审批自由修改正在修改草稿 9. 配置项版本号规则配置项的版本号与配置项的状态紧密相关：11、（1）处于“草稿”l “V“Version的首字母，代表后面的数字为版本号。l Z数字范围为001-999l 随着草稿的不断完善，“Z”的取值应递增。l “Z”的初值为001，增幅为001.l 例子：V （2）处于“正式发布”状态的配置项的版本号格式为：V X.Y.000l X为主版本号，取值范围为1-9。Y为次版本号，取值范围为00-99。l 配置项第一次“正式发布”时，版本号为V 。l 如果配置项的版本升级幅度比较小，一般只增大Y值，X值保持不变。只有当配置项版本升级幅度比较大时，才允许增大X值。l 例子：V （3）处于“正在修改”状态的配置项的版本号格式为：V X.Y.Zl Z数字范围为12、001-999l 配置项正在修改时，一般只增大Z值，X.Y值保持不变。l 当配置项修改完毕，状态重新成为“正式发布”时，将Z值设置为0，增加X.Y值。参见规则（2）。l 例子：V 第二章 配置管理范围配置管理包括：所有研发项目文档、源代码、可执行程序，特殊工具及相关资料等。项目文档主要指：立项建议书、项目计划、需求说明书、软件规格说明书、概要/详细设计说明书、数据库表结构、测试文档、用户使用说明书以及项目过程中管理类文档等。特殊工具及其相关资料指开发或测试过程中比较特殊的工具，以及其使用文档等，如觉得有必要也纳入配置库的管理。第三章 配置库建立1. 项目立项时，由项目经理申请建立项目配置库，配13、置管理员与项目经理确定配置项，并参考附录2：配置库目录结构，建立配置库以及配置库目录结构；项目经理提供配置库权限清单（内容应包括员工姓名、项目名称、目录权限等），由配置管理员为相关人员的设置配置权限。2. 配置库权限设置完成之后，由配置管理员将配置库名称、访问路径、访问权限等信息以邮件方式通知各相关人员；配置库使用人员以各自的用户名和密码进行访问配置库。3. 配置库密码只能在服务器上设置，但使用人员可以在客户端修改自己的秘密，如配置库使用人员密码遗忘，可以与配置管理员取得联系，进行修改密码。第四章 配置管理流程1. 配置管理流程定义阶段项目经理编写项目计划并通过评审。配置管理员依据项目计划编写14、配置管理计划项目经理审批配置管理计划项目经理依据配置管理计划在规定时间申请建立定义基线.申请建立基线的流程见基线建立流程项目经理依据配置管理计划在规定时间申请建立定义基线.设计阶段实现阶段项目经理依据配置管理计划在规定时间申请建立实现基线测试阶段项目经理依据配置管理计划在规定时间申请建立测试基线发布阶段项目经理依据配置管理计划在规定时间申请建立发布基线.项目经理依照产品发布流程，发布产品。产品发布流程见 产品发布流程开发人员按照配置管理相关规则（见本制度第六章）在开发库中创建、命名、标记、变更（按照变更控制流程）配置项。配置管理员按照配置管理计划和本制度管理配置库的变更、备份、基线建立、等工作15、。项目经理和评审小组负责变更、基线建立等工作的审批和对配置管理工作的检查、指导、监督工作。测试人员负责测试和产品的发布等工作。整个阶段变更控制流程见变更控制流程 2. 基线建立流程项目经理按照配置管理计划在规定时间填写配置申请单，申请建立相应的基线。评审小组对所申请建立的基线进行审批？通过项目经理将配置申请单(纸质和电子版)送交配置管理员，配置管理员依照配置申请单建立基线并填写受控库产品清单。流程结束未通过评审组长将配置申请单送还项目经理，并向其说明原因。配置申请单见附录3受控库产品清单见附录43. 变更控制流程配置项或基线需要变更时，申请人填写变更申请单评审小组对所申请变更进行审批？通过执行16、人进行相应的变更操作.评审组长将变更申请单送还申请人，并向其说明原因。 未通过评审小组对变更后配置项再进行审批？通过申请人将变更申请单(纸质和电子版)送交配置管理员，配置管理员获取变更后的版本的配置项到受控库并填写受控库产品清单。未通过 变更申请单见附录5流程结束4. 产品发布流程项目经理填写发布产品配置表（仅第一次发布时填写）和产品发布申请及验收表项目经理送交相关人员对发布产品进行审批？通过项目经理将发布产品配置表和产品发布申请及验收表（纸质和电子版）送交配置管理员配置管理员依照发布产品配置表和产品发布申请及验收表将发布产品打包，放入发布库，同时填写产品发布检查表和产品发布清单，并办理和总工17、办的发布产品交接手续。未通过部门经理将发布产品配置表产品发布申请及验收表.送还项目经理，并向其说明原因。流程结束发布产品配置表见附录6产品发布申请及验收表见附录7产品发布检查表见附录8产品发布清单见附录9第五章 配置库权限变更管理若在使用配置库的过程中需要变更配置库管理权限，可以由项目管理员或项目经理以邮件或口头方式通知配置管理员，配置管理员变更之后，将变更结果以电子邮件方式通知受影响的人员、项目经理、项目管理员及其相关人员。配置管理员根据配置库权限变更频率，决定每隔一段时间将配置库权限清单与各项目经理进行审核确认，各项目经理审核后，若有权限需要进行变更，应及时通知配置管理员。第六章 配置库备18、份配置管理员应定期做好配置库的备份，以防意外引起的服务器上资料的丢失，避免给公司带来严重的损失。具体实施规范如下：1. 配置管理员自创建项目配置库起，每月15号、28号对配置库进行硬盘备份一次（完全备份），为了节约硬盘空间，只保留最近的两次备份文件，之前的备份文件将被删除。2. 配置管理员每遇到有基线产生时，对基线单独硬盘备份一次。3. 当项目结项时，对该项目成果进行硬盘和光盘双重备份，备份后的光盘标记上备份日期并附上内容清单，移交部门行政秘书保管。4. 如遇特殊情况需要特殊备份时，需项目经理和部门经理协商后，通知配置管理员做特殊备份。第七章 配置库使用规范1. 所有立项的项目，都必须申请建立19、配置库。开发过程中所有文档和代码必须纳入配置库管理，若因未纳入配置库管理造成的资料丢失或版本差异，其责任皆由开发人员及项目经理承担。2. 配置库服务器密码只有配置管理员和产品开发部经理掌握，其他人如因特殊原因需要该密码，必须经过产品开发部经理的批准后方能获取；并在使用完密码之后，通知产品开发部经理和配置管理员，配置管理员及时设置新的密码，以保证服务器资料的安全性和机密性。3. 各配置库的使用人员必须使用各自的用户名和密码进入配置库，访问授权的配置库。各使用人员不得将自己的用户名和密码泄漏给其他人员，若因泄露密码而引起的后果将由泄漏密码者本人承担。4. 各项目的配置库用于项目组正式开发使用，项目20、组成员不得恶意对其进行修改、删除、增加等操作；若因对VSS工具不熟悉，需要学习，可以向配置管理员提出需求，由配置管理员为其提供可以练习的配置库。5. 各项目经理负责定期检查配置库的使用情况，查看是否有员工进行无故删除或恶意修改文件的行为;并对开发人员提交的文档和代码的及时性、准确性和完整性进行检查。6. 在研发人员离职时，由其项目经理负责检查配置库，检查该人员提交的代码或文档是否完全放入配置库管理，确认版本和相应文件完整无误后，项目经理在“员工离职申请单”中签字，该员工方可离职。同时项目经理应及时通知配置管理员，取消该人员的所有权限。若因项目经理审核不细致造成的代码或文档移交不完整，或项目经理21、未及时通知配置管理员取消权限，而造成的损失，该责任完全由项目经理承担。7. 在配置库使用时，为了避免配置库checkin或checkout时引起冲突，需注意：项目经理在划分模块时注意每个人的模块之间尽量不要重叠。开发人员在修改文件之前，养成事先checkout的习惯。开发人员注意checkin的频率，尽量及时checkin，最好每天提交一次。第八章 附录附录1 附录清单序号名称存储路径附件2配置库目录结构Vss_Assets /3.软件开发/1.开发过程/6.配置管理附件3配置申请单附件4受控库产品清单附件5变更申请单附件6发布产品配置表附件7产品发布申请及验收表Vss_Assets/3.软件22、开发/1.开发过程/5.发布附件8产品发布检查表附件9产品发布清单附录2 配置库目录结构 配置库目录结构每一个项目的配置库可分为1work（开发库）、2confirmed（受控库）和3release（发布库），如下为配置库目录结构模板，可以根据实际情况增减：一级目录二级目录三级目录四级目录说明Vss_项目编号1work1doc（文档目录）1project项目启动、定义阶段产生的相关文档（如：项目计划、配置管理计划等）2management与该项目相关的管理文档（如：质量月报、配置状态报告等）3requirement需求阶段产生的文档(用户需求说明书,软件规格说明书等)4design项目设计阶段23、产生的相关文档（如：概要设计文档、详细设计文档等）5test项目测试阶段产生的文档（如：测试报告、测试大纲等）6review评审文档7meeting会议文档8workreport每周工作报告（项目周报、工作日志等）9training培训文档2src（源码目录）1code项目代码(可以根据项目需求自定义子目录)2html系统原型3install安装包3temp（项目临时文件）用于存放项目开发工程中产生的临时文件2confirmed配置管理员可根据配置管理计划建立基线目录3release发布库附录3 配置申请单配置申请单说明： 1. 该表格适用于配置项提交、基线建立申请。2. 配置项或基线入受控库24、时填写该表。编号：QR706/51/ FKB/ 项目编号/日期（格式：20090717）申请部分(由申请人填写)项目名称成都地铁一号线项目编号申请类型 配置项提交 基线建立申请人申请日期2009-05-19配置项所属基线配置项名称编号版本号存储路径（开发库）提交时间备注 2009-05-19申请说明评审部分（由评审组长填写）评审时间评审组长评审组成员审批结果 批准 拒绝评审组长签字： 日期：附录4 受控库产品清单受控库产品清单序号项目名称(编号)入库类型所属基线配置项名称存放位置（受控库）版本号存放位置（开发库）入库时间申请人活动依据备注004005006007008009010011012025、13014015016017018019附录5 变更申请单变更申请单填表说明：1. 该表适用于配置项变更和基线变更时填写。2. 评审组长一般为项目经理。项目名称项目编号申请类型配置项变更 基线变更申请人申请日期1. 变更申请（由变更申请人填写）申请变更的配置项所属基线配置项名称编号版本号配置项对应开发库路径V变更的内容及其理由估计配置项变更将对项目造成的影响变更申请人签字2. 审批变更申请(由评审组长填写)审批结果审批结果 批准 拒绝评审组长签字： 日期：批准变更的配置项变更执行人时间限制备注3. 变更配置项（由变更执行人填写）变更后的配置项名称变更后的版本号变更完成日期备注2009-05-226、34. 结束变更（由评审组长填写）重新审批结果重新审批结果 批准 拒绝评审组长签字： 日期：编号：QR706/52/ FKB/项目编号/日期（格式：20080717）附录6 发布产品配置表说明：1. 此表由项目经理填写。2. 此表中的模块必须填写完整，所列模块必须是组成该项目的所有模块。3. 项目名称（项目编号）： 编号：QR706/04/ KFB/项目编号/发布版本号序号模块名称数据库名称及版本数据库文件名称操作系统名称及版本开发工具及版本配置/安装文件有无可执行文件支持软件模块负责人备注1调度员工作站Sybase 12.5Windows 2000 professionalVC+6.0MFC27、见配置文件OGW-Config.xml分析员工作站Sybase 12.5Windows 2000 professionalVC+6.0MFC见配置文件/conf/ systemconfig.xml3通信前置机Sybase 12.5Windows 2000 professionalVC+ 6.0MFC见配置文件SCADACONFIG.xml4服务器后台Sybase 12.5Solaris 10.0Solaris Solaris SolarisGCC 无5Web复视Sybase 12.5Windows 2003Advanced ServerVisual Studio.Net 2005 (C#)DS28、N:scadaUID:saPWD:sqlsql6维护员工作站SQL Server2000Windows 2000 professionalVC+ 6.0MFC请查看：使用注意问题.txt提交人（签字，包含日期）： 接收人（签字，包含日期）：附录7 产品发布申请及验收表产品发布申请及验收表填表说明：1. 产品在发布前，必须填写本表。本表所有需要签名的栏目必须手签。2. 经过测试的产品发布，由测试人员填写本表的主要栏目。通过了系统测试、升级包测试的，发布类型判定为“定版发布”。通过或部分通过紧急发布测试的，部分通过系统测试、升级包测试的，都只能判定为“让步发布”。3. 未经过测试的产品发布，由项目29、经理或指定的开发人员填写本表。发布类型只能是“特例发布”。表单编号：QR706/03/ KFB/项目编号/日期（格式：20090717） 1.申请部分(除特别说明外均由申请人填写)产品名称项目名称_子模块名称发布日期2009-07-07发布版本号V产品形态完整产品 模块产品 升级包 其它 _发布类型定版发布 让步发布 特例发布 其它 _适用用户（版本）洛张线申请人附件名称发布包名称 项目名称_子模块名称_版本号.rar发布包存储路径VSS_GM2000-MN/3release/洛张线/洛张线_LZ_V发布包文件清单序号文档/模块名称编号对应开发库存储路径备注1项目编号_子模块名称_类型名称_版30、本号（日期_序号）VSS_GM2000-MN/1work/2src/1code/洛张项目基础版本：石怀线调度员工作站，未修改。2CDDT-1_地铁维护单元_源代码_V无VSS_GM2000-MN/1work/2src/1code/洛张项目基础版本：石怀线分析员工作站，未修改。3CDDT-1_项目计划_VQR704/03/ KFB/CDDT-1/VVSS_GM2000-MN/1work/2src/1code/洛张项目4CDDT-1_地铁维护单元_可执行文件_V无VSS_GM2000-MN/1work/2src/1code/洛张项目5VSS_GM2000-MN/1work/2src/1code/洛31、张项目6VSS_GM2000-MN/1work/2src/1code/洛张项目7VSS_GM2000-MN/1work/1doc/4design/洛张项目8/VSS_GM2000-MN/1work/2src/3install/洛张项目9/VSS_GM2000-MN/1work/2src/3install/洛张项目发布产品简介及安装说明1.产品简介l 本产品对洛张线所管辖的牵引变电所、分区所、开闭所以及接触网开关等牵引供电设施进行实时数据采集和集中监控管理。l 本产品包括WEB复视系统、调度员工作站、分析员工作站、后台、通讯前置机、维护员工作站6个模块。l 本版本是该软件的初始版本。l 基础版本32、：石怀线 GM2000 系统新增/修改功能序号新增/修改功能修改后对应发布包文件名对应BugFree缺陷号备注122.审批部分（由相关负责人填写）职位同意发布拒绝发布签字（必需手写）签字日期备注测试人员项目经理配置管理员最终审批结果： 同意发布 拒绝发布 部门经理签字： 签字日期：3.验收部分（由总工办及质量管理办公室填写）接收产品拒绝接收产品拒绝理由验收时间验收人签字备注负责人确认签字： 签字日期 ：附录8 产品发布检查表产品发布检查表 编号产品发布检查表编号检查目标项目编号(产品编号)_版本号检查人配置管理员(手签)检查日期检查项序号检查项（产品发布申请及验收表）检查项状态检查记录备注1产33、品名称填写是否正确(若为子模块产品，名称是否和发布产品配置表所列一致)？通过2产品形态选择是否正确？3发布类型选择是否正确？4附件名称填写是否正确？5发布包名称填写是否符合规范？6发布包存储路径填写是否正确？7发布包清单所列文件名称是否正确？8发布产品是否有帮助菜单项？9发布包清单所列版本号是否和产品帮助-关于菜单所示版本号一致（若为文档，文件版本号是否和内部所示版本号一致）？10发布清单对应开发库存储路径是否正确？11发布清单对应开发库标签号是否正确？12新增/修改功能对应发布包的文件名是否正确？13新增/修改功能对应BugFree缺陷号是否正确？14发布产品是否含有源码的可执行文件？15发布产品是否含有产品配置表？16发布产品是否含有用户使用说明书？17发布产品配置表是否涵盖了产品运行必须的组件？填表说明：1.本表由配置管理员进行填写，需根据产品发布检查项进行检查，并填写检查结果。 也可作为项目经理、部门经理、QA检查产品发布工作的依据。 2. 进行QA检查时，可以用以下字符替代“检查项状态”的文字说明。 通过：Y 不通过：X 部分通过：P 待定：TBD（To Be Defined）附录9 产品发布清单序号项目名称（编号）发布包名称产品形态发布包存储路径申请人申请日期活动依据备注001002003004005006007008009010