某软件有限公司文档版本管理规范
密级:内控 研发本部版本管理规范研发本部版本管理规范 V1.0V1.0 浪潮集团山东通用软件有限公司浪潮集团山东通用软件有限公司 目录 文档类别使用对象文档类别使用对象 2 2 1 1.引言.引言 3 3 1.1 目的 . 3 1.2 范围 . 3 1.3 术语定义 . 3 1.4 参考资料 . 4 1.5 版序控制记录 . 4 1.6 版本更新记录 . 4 2 2.版本管理.版本管理 5 5 2.1 版本标识方法 5 2.1.1 正式版本.5 2.1.2 特殊版本.5 2.2 目录结构 5 2.3 文档的存放 7 2.3.1 当前版本和历史版本的存放 . 7 2.3.2 开发文档的存放 7 2.3.3 源代码的存放 7 2.3.4 SQL语句的存放.7 2.3.5发行文档的存放.8 2.4 权限控制管理 8 3 3.更新管理.更新管理 8 8 3.1 源程序的修改 8 3.2 已发布版本的维护及修改 9 3.3 外出人员对产品的修改 9 3.4 版本升级 . 12 3.4.1 版本升级原则 .12 3.4.2 新版本的发布 .12 3.4.3 安装盘制作步骤 .13 4 4.备份管理.备份管理 1 13 3 5 5.用户版本管理.用户版本管理 1 14 4 文档类别使用对象文档类别使用对象 文档类别 该文档是为浪潮通软公司研发本部各产品部、 事业部提供一个版本管理规范性文件。 使用对象 该文档使用对象为浪潮通软公司研发本部各部门经理及版本管理人员,以及其他相 关人员。未经管理过程改善部书面许可,该文档不得提供给上述规定对象以外的人员阅 读或使用。 1 1.引言.引言 1.1 目的 本文档是为规范公司研发本部各产品部、事业部版本管理而制定的。 1.2 范围 本文档为各产品部、事业部版本管理员提供有关版本管理规范的相关内容,包括: 版本标识方法 软件系统数据的存放 文档的修改控制 文档的备份制度 1. 3 术语定义 SCM Softwere Configuration Management缩写 SVM Software Version Management缩写 文档 一种数据媒体和其上所记录的数据。 配置管理 标识和确定系统中配置项的过程, 在系统整个生存周期内控制这些项的投放和更动, 记录并报告配置的状态和更动要求,验证配置项的完整性和正确性。 软件配置 软件的具体形态在某时刻的瞬时影像。 配置项 软件配置管理的对象称为配置项,如:系统规格说明书,项目开发计划,用户手册, 源码。 基线 软件生存周期中各开发阶段末尾的标记,它的作用是把各阶段工作的划分更加明确 化,使本来连续的工作在这些点上断开,使之便于检验和肯定阶段成果。 1.4 参考资料 [1] 《事业部门版本管理工作标准》 SEPG V1.0 [2] 《国强财务V60配置管理》财务产品部 V1.0 [3] 《商业事业部版本管理规范》 V1.0 [4] 《酒店事业部版本管理规范》 V1.0 [5] 《财务产品部版本管理规范》 V1.0 [6] 《PACS事业部版本管理规范》 V1.0 [7] 《MRPII部版本管理规范》 V1.0 [8] 《金融事业部版本管理规范》 V1.0 [9] 《ERP部版本管理规范》 V1.0 1.5 版序控制记录 版序状 态 1.0 拟稿 管理过程改善部 审核批准发布日期 99/11/18任甲林 1.6 版本更新记录 *A A - 增加M M - 修改D D - 删除 版本/修订版 1.0 修改页码修改记录 初始版本 修改人日期 99/11 2 2.版本管理.版本管理 2.1 版本标识方法 为了使工作规范化、统一化,研发本部各部门实行的版本标识管理方法分为:正式 版本和特殊版本。 2.1.1 正式版本 公司在市场渠道上发行的正规版本。 以“V”开头,版本号放后。版本号分3 节:主版本号,次版本号和内部版本号,每 节之间以小数点(.)间隔。如V2.0.01 表示主版本号为 2,次版本号为 0,内部版本号 为 01。 2.1.2 特殊版本 特殊版本是在正式版本的基础上,针对某客户开发的版本。它与正式版本的不同之 处在于问题不具有通用性和适应性,只符合该用户的实际使用情况。 该版本标识分为常规部分和扩展部分,常规部分表示该特殊版本哪一个正式版本的 分支,命名方法同正式版本的命名方法。对于扩展部分,以“ S”开头,后加一唯一序 号。举例如下: V2.33.S01表示由 V2.33 分支出的第一个特殊版本 V2.33.S02表示由 V2.33 分支出的第二个特殊版本 事业部不鼓励产生特殊版本。只有在极特殊的情况下,才产生适当的特殊版本。并 在以后的版本演化中,尽量将其纳入到正式版本中。 2.2 目录结构 由于各部门的实际情况不同,目录结构很难统一,但为了能更好地管理各事业部的 文档,建议可将被管理的配置项分为三大类:文档类、源码类及安装盘类,这样存放比 较清晰,有利于版本管理。至于二级目录是以模块划分还是以版本划分,各产品部、事 业部可根据自己部门的情况,制定适合本部门的目录结构,并根据制定的目录结构给出 文件级目录清单(先给出源程序及文档的文件级目录清单,安装盘的可以后再执行) : 。 现以财务产品部 V6。0 的目录结构举例如下: 根目录根目录二级目录二级目录三级目录三级目录四级目录四级目录对应配置项对应配置项备注备注 源码(F:) Current 模块缩写 1V6.0 PBL SQL DOC HTML BMP 源码 存目录前正在修改 的内容 SQL 文件 详细设计、 数据 结构 帮助文件 图像文件 用户需求记录 总体设计文档 版本号在文件名上 标识 按版本号依次类推 与模块 1 相同 按版本号依次类推V6.0.01 … 模块缩写 2 。 。 。 。 。 。 文档(G:) Require Design Test V6.0 V6.0.1 …. Record CaseV6.0 V6.0.01 …. 模块缩写 n 测试记录 测试用例 用户使用手册 产品说明手册 版本号在文件名上 标识 User V6.0 V6.0.01 …. REL_SRC SETUP Plan 安 装 盘 (H:) V6.0 V6.0.01 … Project Month Release 项目计划 月度计划 产品盘或发布文档 表示正式版本及特殊版本的目录按以下原则定义: (1)正始版本:以“V”开头,版本号放后,主版本号和次主版本号之间的“.” 去掉,明细版本号之前加“-” 。举例如下: 版本号目录名 V6.0 V60 V6.1 V61 V6.0.01 V60-1 V6.1.02 V61-2 (2)特殊版本: 目录名分为常规名和扩展名两部分, 常规部分表示该特殊版本是 由哪一个正始版本分支而来,命名方法同正始版本的命名方法。对于扩展名, 以“S”开头,后加一唯一序号。举例如下: 目录名意义 V60.S01表示由 V6.0 分支出的第一个特殊版本 V60.S02表示由 V6.0 分支出的第二个特殊版本 V60-1.S01表示由 V6.0.01 分支出的第