文档介绍：第一章目的
本规范详细规定软件项目版本管理的对象、存储目录、分支、权限、维护等内容,使软件项目版本管理流程化并规范化,确保在系统开发和实施过程中项目的完整性和一致性。
第二章适用范围
所有系统开发及实施项目的软件项目都应进行版本管理。项目中所有正式文档和代码都应纳入配置库(可使用工具建立配置库,本文所述使用的是SVN)进行版本管理。
第三章职责
配置库管理员:负责配置库的日常维护和管理;监督开发及测试部门及时提交版本管理对象(即配置项)。
此岗位可由开发或测试人员兼任。
第四章内容
. 版本管理对象
包括但不限于:
ü 项目总体计划
ü 可行性研究报告
ü 开发计划
ü 需求说明书
ü 需求设计原型
ü 设计说明书
ü 系统开发变更申请单
ü 系统管理手册
ü 用户操作手册
ü 培训计划
ü 培训记录
ü 源程序
ü 支持系统运行的配置文件
ü 存储过程脚本
ü 测试计划
ü 测试用例
ü 测试脚本
ü 测试报告
ü 上线计划
ü 上线申请
ü 版本维护日志
. 配置库的目录结构
每个项目在配置库中应拥有唯一的项目名称。配置库目录结构与项目内部的目录结构建议按下列格式创建。
配置库目录结构规划:
┠tags(发布)
┃├
┃├
┃├
┃├
┃└
┠trunk(主版本)
┃└projectA
┃├src
┃├MY_MOOC
┃├doc
┃├tool
┃├。。。
┖branches(分支)
├SY_ABC
├TJ_ABC
├WH_MOOC
其中,项目内部的目录结构:
|–projectA
|–src (保存该项目的源程序)
|–doc (保存项目相关文档)
|–(保存项目过程管理相关文档)
|–(保存项目计划相关文档)
|–(保存项目需求相关文档)
|–(保存项目设计相关文档)
|–(保存项目代码测试相关文档)
|–(保存项目部署实施相关文档)
|–(保存项目运维文档,包括培训、用户手册等)
|–(保存项目技术文档,包括第三方技术资料等)
|–。。。(保存项目过程管理相关文档)
|–tool (包括该项目特定的开发、编译、测试等工具)
. 分支(branch)
建议使用分支来协同不同职能小组对同一个配置库的使用,可按照以下方式进行分支的管理。
解决方案建立三个分支,包括主版本开发(trunk)、分支版本开发(branches)和发布(tags)。
ü 主版本开发
是所有分支版本的基准版本,主版本的开发分支。开发部门开发使用。
ü 分版本开发
主版本的分支版本,供开发部门开发使用。开发工程师如果以主版本为基准,进行软件项目开发,要先将trunk目录下的代码分支到branches目录的一个子目录,在那里对代码进行开发。多个主版本的分版本可通过在branches顶级目录创建多个分支目录来区分。
ü 发布
测试和发布专用分支,该分支代码不允许任何形式的修改。每个经过测试后的不同版本的代码做快照放到此分支文件夹下。
. 权限管理
应对配置库的访问权限进行管理,确保软件系统的完整性和安全性。建议按如下方式进行管理。
. 开发工程师
仅拥有自己所属项目的add file、delete file、check out、check in权限,无目录创建和删除权限。开发工程师若想创建目录,需向配置库管理员申请。
. 测试工程师
拥有每个项目的测试分支的add file、delete file、check out、check in权限,无目录创建和删除权限,对于其他分支只有只读权限。
. 配置库管理员
拥有全部权限,但增删项目和增删目录需要有项目负责人批准。
. 其他人员
若需要配置库访问权限,需经技术总监或经技术总监授权的项目经理批准,由配置库管理员分配权限。
. 版本管理
应对软件系统的版本进行管理,确保版本的准确性和可追溯性。建议按如下方式进行管理。
. 版本维护
软件工程各阶段产生的各种文档和代码,应及时并统一上载到配置库由配置库管理员统一管理。对于要修改的配置项,应从配置库中检出(check out)后修改,修改完毕后