XX公司产品(项目)版本管理规范

迪科产品迪科产品 项目项目 版本管理规范版本管理规范 V1 0 0 杭州迪科信息技术有限公司杭州迪科信息技术有限公司 历史记录历史记录 撰写日期撰写日期文件状态文件状态版本版本作者作者发布日期发布日期更改请求号更改请求号 2012 05 07 初始版本 1 0 0 叶姬微 正式审批正式审批 角角 色色签签 名名日日 期期备备 注注 审审 核核 批批 准准 目录目录 1 概述 3 2 思路 3 2 1 产品结构 3 2 2基本思路 4 2 3版本格式 4 3 结构 5 3 1主结构原型 5 3 2子系统结构原型 5 3 3示例 7 4 操作 11 5 附录 11 Alter sql 11 changelog txt 编译版本 13 Changelog txt 汇总版本 13 Datainit sql 14 1 概述 公司目前 PB 与 JAVA 的交互主要通过数据库交互 只有极小一部分使用 Webservice 形式 所以版本管理涉及 PB 与 JAVA 以及 SQL 和存储过程的管理 本管理规范的宗旨是解决目前开发 测试 实施各环节中存在的诸多版本问题 本规 范的执行需要以上相关部门的参与 2 思路 2 1 产品结构 下图为迪科物流产品涉及的基本子产品 迪科物流产 品 PB DC POS Store JAVA B2C B2B 短信平台 淘宝接口 其他对外开 放API 2 2 基本思路 客户生产环境部署的几乎都由上图中的各子系统组成 所以以项目为单位 迪科产品作为一个特殊项目维护 各个子系统保持各自的版本号 通过人为的方式进行指定各子系统版本对应关系 各子系统对应的增量 SQL 保存在各自对应的目录下 以 JAVA 的系统对应物流的各子系统 2 3 版本格式 适用于迪科所有子系统 版本格式 X Y ZZZ X 主版本号 不限位数 Y 子版本号 不限位数 ZZZ 编译号 限 3 位 基本等同于编译次数 考虑到硬盘空间各子版本号下编译 号最多保持 5 个版本 5 个版本之前的进行删除 编译版本号从 1 开始 比如 001 所有主版本和子版本一律保留 主版本升级 子版本和编译版本归零 子版本升级 编译版本归零 如 V1 1 001 V19 30 139 v1 1 880 V1 11 870 v3 7 222 3 结构 3 1主结构原型 ProjectUpdateLog根目录 Xiaofeixiang产品 项目 名称 java开发语言 1 b2b子系统 1 名称 b2c子系统 2 名称 pb开发语言 2 dc子系统 1 名称 pos子系统 2 名称 store子系统 3 名称 所有项目的基本路径遵循以上目录结构 其中项目下所涉及的开发语言和各开发语言下的子系统可按需要添加 3 2子系统结构原型 以下各具体文件中对应各自的规范和格式 具体参考附录 b2b子系统名称 1 x主版本目录 格式 主版本 后缀 x readme txt描述文档 1 1 0 xx子版本目录 格式 主版本 子版本 后缀 x readme txt 描述文档 2 1 0 00 具体版本目录 编译版本 alter sql 数据结构增量修改 changelog txt当前版本更新的系统功能 datainit sql初始化数据 readme txt描述文档 3 procedure存储过程目录 splitPages sql存储过程示例 其他具体版本目录 编译版本 如 1 0 01 collect 子版本汇总 子版本下所有编译版本的增量修改 alter sql数据结构增量修改汇总 changelog txt 各编译版本更新的系统功能汇总 datainit sql初始化数据汇总 readme txt描述文档 4 procedure存储过程汇总目录 splitPages sql存储过程示例 其他子版本目录 格式 主版本 子版本 后缀 x 如 1 2 xx 其他主版本目录 格式 主版本 后缀 x 如 2 x 1 描述各子版本状态 如 各版本状态 状态可选值 测试通过 尚未测试 正在测试 1 0 xx 测试通过 1 1 xx 正在测试 其他描述可根据实际具体情况添加 以 需要添加的描述章节 格式添加 2 目录说明 各编译版本状态 目录说明 collect 文件中是当前大版本下各小版本的一个增量修改部分的汇总 便于更新到 当前最新版本 否则一个一个版本执行增量修改部分 各数字命名的文件夹名称表示各小版本 各版本状态 状态可选值 测试通过 尚未测试 正在测试 1 0 00 测试通过 1 0 01 正在测试 其他描述可根据实际具体情况添加 以 需要添加的描述章节 格式添加 3 在 JAVA 语言中添加 物流版本对应 store v8 8 33 dc v9 9 01 pos v1 1 99 PB 语言或其他描述可根据实际具体情况添加 以 需要添加的描述章节 格式 添加 4 可根据实际具体情况添加 以 需要添加的描述章节 格式添加 3 3示例 ProjectUpdateLog demo java b2b 1 x readme txt 1 0 xx readme txt 1 0 00 alter sql changelog txt datainit sql readme txt procedure splitPages sql 1 0 01 alter sql changelog txt datainit sql readme txt procedure splitPages sql collect alter sql changelog txt datainit sql readme txt procedure splitPages sql 1 1 xx 2 x b2c 1 x readme txt 1 0 xx readme txt 1 0 00 alter sql changelog txt datainit sql readme txt procedure splitPages sql 1 0 01 alter sql changelog txt datainit sql readme txt procedure splitPages sql collect alter sql changelog txt datainit sql readme txt procedure splitPages sql 1 1 xx 2 x pb dc 1 x readme txt 1 0 xx readme txt 1 0 00 alter sql changelog txt datainit sql readme txt procedure splitPages sql 1 0 01 alter sql changelog txt datainit sql readme txt procedure splitPages sql collect alter sql changelog txt datainit sql readme txt procedure splitPages sql 1 1 xx pos 1 x readme txt 1 0 xx readme txt 1 0 00 alter sql changelog txt datainit sql readme txt procedure splitPages sql 1 0 01 alter sql changelog txt datainit sql readme txt procedure splitPages sql collect alter sql changelog txt datainit sql readme txt procedure splitPages sql 1 1 xx store 1 x readme txt 1 0 xx readme txt 1 0 00 alter sql changelog txt datainit sql readme txt procedure splitPages sql 1 0 01 alter sql changelog txt datainit sql readme txt procedure splitPages sql collect alter sql changelog txt datainit sql readme txt procedure splitPages sql 1 1 xx 4 操作 流程图 1 准备 新项目 1 导出目录结构模板 svn 192 168 168 188 ProjectUpdateLog 结构模板 2 修改 结构模板 名称为对应的项目名称 3 导入至版本更新历史库 svn 192 168 168 188 ProjectUpdateLog 所有文件的修改严格遵循规范 具体写法可参考 svn 192 168 168 188 ProjectUpdateLog demo 其他说明 操作编译版本相关的文件时 需要手动汇总到汇总版本 collect 中 格式上唯一有区别的只有 changelog txt 文件 其异同参考附录 为了确保可以回滚最近一段时间内的版本 每添加一个编译版本时需要同时把源代 码添加一个与编译版本对应的分支 至少保存 5 个编译版本 SVN 分支合并 1 一个编译版本对应一个分支 2 某编译版本的 BUG 修改或者小改动的需求变动在对应的分支上修改 测试通过 后同步到主干 3 主干进入下一版本的