软件研发版本管理系统规章制度
实用文案 北京东达悦科技有限公司北京东达悦科技有限公司 软件研发版本管理规范软件研发版本管理规范 v1.0(v1.0(草案草案) ) 研发部研发部 2009-2-42009-2-4 目录 文档类别使用对象文档类别使用对象 2 2 1 1.引言.引言 3 3 1.1 目的 3 1.2 范围 3 1.3 术语定义 3 1.4 版序控制记录 4 1.5 版本更新记录 4 2 2.版本管理.版本管理 5 5 文案大全 实用文案 2.1 版本标识方法 . 5 2.1.1 正式版本 5 2.2 目录结构 . 5 2.3 文档的存放 . 6 2.3.1 当前版本和历史版本的存放 6 2.3.2 开发文档的存放 . 6 2.3.3 源代码的存放 . 7 2.3.4 SQL语句的存放 7 2.3.5发行文档的存放 7 2.4 权限控制管理 . 7 3 3.更新管理(版本升级).更新管理(版本升级) . .8 8 3.1版本升级原则 8 3.2 新版本的发布 . 8 4 4.备份管理.备份管理 9 9 5 5.用户版本管理.用户版本管理 9 9 6 6.研发部统一管理阶段性版本.研发部统一管理阶段性版本1010 6.1 阶段性版本的提交到研发部 . 10 6.2 阶段性版本的发布到公司网站上 . 10 6.3 各项目组新版本内部及时备份。 . 10 7 7.版本工具的使用.版本工具的使用 1010 7.1 研发部采用SVN配置管理工具 10 8 8.各项目组提交文档及源码以及规则.各项目组提交文档及源码以及规则 . .1111 8.1 各项目组需要提交的文档. 11 8.2 目前所管理的产品列表 . 11 9 9.周报管理制度.周报管理制度 1212 1010.风险管理制度.风险管理制度 1212 文档类别使用对象文档类别使用对象 文档类别 该文档是为东达悦公司提供一个版本管理规范性文件。 使用对象 该文档使用对象为东达悦软件公司研发本部各部门项目经理及版本管理人员,以及 文案大全 实用文案 其他相关人员。未经许可,该文档不得提供给上述规定对象以外的人员阅读或使用。 1 1.引言.引言 1.1 目的 本文档是为规范东达悦软件公司研发版本管理而制定的。 1.2 范围 本文档为各产品部、事业部版本管理员提供有关版本管理规范的相关内容,包括: 版本标识方法 软件系统数据的存放 文档的修改控制 文档的备份制度 1.3 术语定义 SVN Svn是一个开源的版本控制系统Subversion的简称 文案大全 实用文案 文档 一种数据媒体和其上所记录的数据。 配置管理 标识和确定系统中配置项的过程, 在系统整个生存周期内控制这些项的投放和更动, 记录并报告配置的状态和更动要求,验证配置项的完整性和正确性。 软件配置 软件的具体形态在某时刻的瞬时影像。 配置项 软件配置管理的对象称为配置项,如:系统规格说明书,项目开发计划,用户手册, 源码。 基线 软件生存周期中各开发阶段末尾的标记,它的作用是把各阶段工作的划分更加明确 化,使本来连续的工作在这些点上断开,使之便于检验和肯定阶段成果。 1.4 版序控制记录 版序状 态 1.0 拟稿 研发部 审核批准发布日期 09/11/18张洪兴 1.5 版本更新记录 *A A - 增加M M - 修改D D - 删除 版本/修订版 1.0 修改页码修改记录 初始版本 修改人日期 2009/02 文案大全 实用文案 2 2.版本管理.版本管理 2.1 版本标识方法 为了使工作规范化、统一化,各项目组实行的版本标识管理方法分为:正式版本和 特殊版本。 2.1.1 正式版本 公司在市场上发行的正规版本。 以“V”开头,版本号放后。V 前面增加项目名称,版本号分 3 节:主版本号,次版 本号和内部版本号,每节之间以小数点(.)间隔。如 V2.0.1 表示主版本号为 2,次版 本号为 0,内部版本号为 1。研发部控制主版本号和次版本号,各项目组控制内部版本 号。例如:一体化平台-平阴版 v1.1.1 , 一体化平台为产品名称,平阴版为版本名称 (平阴为具体项目名称) ,v1.1.1 为主版本号+次版本号+内部版本号。 2.2 目录结构 由于各项目组的实际情况不同,目录结构很难统一,但为了能更好地管理各项目组 的文档,建议可将被管理的配置项分为三大类:文档类、源码类及安装盘类,这样存放 比较清晰,有利于版本管理。至于二级目录是以版本划分,并根据制定的目录结构给出 文件级目录清单(先给出源程序及文档的文件级目录清单,安装盘的可以后再执行) : 。 现以农电平台 1.0 的目录结构举例如下: 根目录根目录一级目录一级目录二级目录二级目录 源码(F:) 三级目录三级目录 核心 源码 包 sql 版本变动说明 jar Class 文件 源码 SQL 文件 对应配置项对应配置项 源码 备注备注 存目录前正在修改 的内容 产品名称版本号 一体化平 台 扩展源码包 文案大全 实用文案 文档(G:) 需求文档 概要设计文档 数据库设计 详细设计文档 测试用例 用户手册 产品说明书 项目计划 实施手册 月度计划 用户需求记 录 总体设计文 档 测试记录 用户使用手 册 项目计划 实施手册 月度计划 产品盘 版本号在文件名上 标识 按版本号依次类推 版本号在文件名上 标识 安 装 盘 (H:) REL_SRC SETUP 发布文档 或发布文档 表示正式版本及特殊版本的目录按以下原则定义: (1)正始版本:以“V”开头,版本号放后,主版本号和次主版本号之间的“.” 去掉,明细版本号之前加“-” 。举例如下: 版本号目录名 V1.0 V1.0 V1.1 V1.1 V1.0.1 V1.0.1 V1.1.2 V1.1.2 2.3 文档的存放 2.3.1 当前版本和历史版本的存放 对于源码文件,特别增加了一个 Current 目录,存放当前正在开发与维护的源码文 件,当前未发布版本的所有数据都存放在.\CURRENT\下。一旦当前版本正式发行, 则当前目录被修改为相应的历史目录。 历史版本是指已经发行的版本,存放在相应的版本目录之下,一般不允许改动。 2.3.2 开发文档的存放 根据各项目部自己的情况,将系统用户需求记录、总体设计文档、详细设计及数据 结构文件、测试记录、用户手册等放入相应的目录下。 文案大全 实用文案 2.3.3 源代码的存放 源代码包括如:java,jsp,BMP,ICO 等相关文件,是未经编译处理的、不能直接 交付使用的产品文件以及编译产品所需的文件; 联机帮助文件 HLP 在未生成 HLP 文件之 前的 DOC,RTF 等格式的文档也视为源代码。 各子系统当前的程序源文件放入相应的目录下。对于一个子系统又分多个分子系统 的情况,应在该目录下分别建立几个相应的目录。 2.3.4 SQL 语句的存放 各子系统 SQL 文件放入…\.\SQL 下,对于不同的数据库,分别建立不同的 子目录,如 oracle、sysbase、db2 等。公共 SQL 文件直接放入…\SQL 下即可,不同数 据库的特殊 SQL 分别放入对应的子目录下。 2.