版本管理规范(草案)研发部2009-2-4目录文档类别使用对象....................................................... 错误!未定义书签。
1.引言................................................................ 错误!未定义书签。
目的 .................................................................. 错误!未定义书签。
范围 .................................................................. 错误!未定义书签。
术语定义 .............................................................. 错误!未定义书签。
版序控制记录 .......................................................... 错误!未定义书签。
版本更新记录 .......................................................... 错误!未定义书签。
2.版本管理............................................................ 错误!未定义书签。
2.1版本标识方法...................................................... 错误!未定义书签。
2.1.1正式版本..................................................... 错误!未定义书签。
2.2目录结构.......................................................... 错误!未定义书签。
2.3文档的存放........................................................ 错误!未定义书签。
当前版本和历史版本的存放 ........................................... 错误!未定义书签。
开发文档的存放 ..................................................... 错误!未定义书签。
源代码的存放 ....................................................... 错误!未定义书签。
SQL语句的存放...................................................... 错误!未定义书签。
发行文档的存放 ...................................................... 错误!未定义书签。
2.4权限控制管理...................................................... 错误!未定义书签。
3.更新管理(版本升级) ................................................ 错误!未定义书签。
版本升级原则 ........................................................ 错误!未定义书签。
新版本的发布 ....................................................... 错误!未定义书签。
4.备份管理............................................................ 错误!未定义书签。
5.用户版本管理........................................................ 错误!未定义书签。
6.研发部统一管理阶段性版本............................................. 错误!未定义书签。
阶段性版本的提交到研发部............................................... 错误!未定义书签。
阶段性版本的发布到公司网站上........................................... 错误!未定义书签。
各项目组新版本内部及时备份。
........................................... 错误!未定义书签。
7.版本工具的使用...................................................... 错误!未定义书签。
研发部采用SVN配置管理工具............................................. 错误!未定义书签。
8.各项目组提交文档及源码以及规则....................................... 错误!未定义书签。
各项目组需要提交的文档................................................ 错误!未定义书签。
目前所管理的产品列表................................................... 错误!未定义书签。
9.周报管理制度........................................................ 错误!未定义书签。
10.风险管理制度....................................................... 错误!未定义书签。
文档类别使用对象文档类别该文档是为公司提供一个版本管理规范性文件。
使用对象该文档使用对象为公司研发本部各部门项目经理及版本管理人员,以及其他相关人员。
未经许可,该文档不得提供给上述规定对象以外的人员阅读或使用。
1.引言目的本文档是为规范公司研发版本管理而制定的。
范围本文档为各产品部、事业部版本管理员提供有关版本管理规范的相关内容,包括:版本标识方法软件系统数据的存放文档的修改控制文档的备份制度术语定义SVNSvn是一个开源的版本控制系统Subversion的简称文档一种数据媒体和其上所记录的数据。
配置管理标识和确定系统中配置项的过程,在系统整个生存周期内控制这些项的投放和更动,记录并报告配置的状态和更动要求,验证配置项的完整性和正确性。
软件配置软件的具体形态在某时刻的瞬时影像。
配置项软件配置管理的对象称为配置项,如:系统规格说明书,项目开发计划,用户手册,源码。
基线软件生存周期中各开发阶段末尾的标记,它的作用是把各阶段工作的划分更加明确化,使本来连续的工作在这些点上断开,使之便于检验和肯定阶段成果。
版序控制记录版本更新记录*A - 增加M - 修改D - 删除2.版本管理2.1版本标识方法为了使工作规范化、统一化,各项目组实行的版本标识管理方法分为:正式版本和特殊版本。
2.1.1正式版本公司在市场上发行的正规版本。
以“V”开头,版本号放后。
V前面增加项目名称,版本号分3节:主版本号,次版本号和内部版本号,每节之间以小数点(.)间隔。
如表示主版本号为2,次版本号为0,内部版本号为1。
研发部控制主版本号和次版本号,各项目组控制内部版本号。
例如:一体化平台-平阴版 , 一体化平台为产品名称,平阴版为版本名称(平阴为具体项目名称),为主版本号+次版本号+内部版本号。
2.2目录结构由于各项目组的实际情况不同,目录结构很难统一,但为了能更好地管理各项目组的文档,建议可将被管理的配置项分为三大类:文档类、源码类及安装盘类,这样存放比较清晰,有利于版本管理。
至于二级目录是以版本划分,并根据制定的目录结构给出文件级目录清单(先给出源程序及文档的文件级目录清单,安装盘的可以后再执行):。
现以农平台的目录结构举例如下:表示正式版本及特殊版本的目录按以下原则定义:(1)正始版本:以“V”开头,版本号放后,主版本号和次主版本号之间的“.”去掉,明细版本号之前加“-”。
举例如下:版本号目录名文档的存放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.3.5发行文档的存放发行文档是指产品交付用户使用所必须的文件。
包括:产品可执行文件,用户使用说明书,联机帮助(HLP);资源文件(BMP,ICO等),环境配置文件等。
以上文档作为制作发行盘的素材,放在RELEASE的REL_SRC目录之下,制作好的发行盘放在RELEASE的SETUP目录。
2.4权限控制管理为保障文档的安全性,一致性,以及防止意外修改,必须对不同的文档设置不同的访问权限。
文档权限类别:只读权限,读写权限。
文档类别:设计文档,源码,发行文档。
用户类别:开发人员、测试人员、分析设计人员、项目经理、配置管理员、安装盘制作人员、问题及需求管理人员、用户文档编写人员等。
为了控制不同的使用权限,根据要求在服务器上分别建立不同的用户,针对不同的配置项所在目录分配不同的权限。
为了便于管理,应以表格的形式列出人员与管理对象的访问关系(用户权限清单)。