软件源码版本管理规范.docVIP

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