研发本部版本管理规范

1、密级：內扌空研发本部版本管理规范v1.01999年11月18日浪潮集团山东通用软件有限公司目录文档类别使用对象31. 引言41. 1目的41.2范围41.3术语定义41.4参考资料51.5版序控制记录51.6版木更新记录52. 版本管理62. 1版本标识方法62. 1. 1止式版本62. 1. 2特殊版本62. 2目录结构62. 3文档的存放82. 3. 1当前版本和历史版本的存放.82. 3. 2开发文档的存放82.3. 3源代码的存放83. 4 sql语句的存放85发行-文档的存放94权限控制管理9更新管理91源程序的修改93. 2己发布版本的维护及修改103. 3外出人员对产品的修改10

2、3. 4版木升级133. 4. 1版本升级原则133. 4. 2新版本的发布133. 4.3安装盘制作步骤144. 备份管理145. 用户版本管理15文档类别使用对象文档类别该文档是为浪潮通软公司研发本部各产品部、事业部捉供一个版本管理规范性文件。使用对象该文档使用对象为浪潮通软公司研发木部齐部门经理及版本管理人员，以及其他相 关人员。未经管理过程改善部书而许可，该文档不得捉供给上述规定对象以外的人员阅 读或使用。1.引言1.1目的本文档是为规范公司研发本部各产品部、事业部版本管理而制定的。12范围本文档为各产品部、事业部版本管理员提供有关版本管理规范的相关内容，包括:版本标识方法软件系统数据

3、的存放文档的修改控制文档的备份制度1. 3术语定义scmsoftwere configuration management 缩写svmsoftware version management 缩写文档 一种数据媒体和其上所记录的数据。配置管理标识和确定系统中配置项的过程，在系统整个生存周期内控制这些项的投放和更动, 记录并报告配置的状态和更动要求，验证配置项的完整性和正确性。软彳i：酉己置软件的具体形态在某时刻的瞬时影像。配置项软件配置管理的对象称为配置项，女口：系统规格说明书，项目开发计划，用户手册， 源码。基线软件生存周期屮各开发阶段末尾的标记，它的作用是把各阶段工作的划分更加明确化，使本來

4、连续的工作在这些点上断开，使z便于检验和肯定阶段成杲。1.4参考资料tj 1j 1j tj 12345678 9- -rl rl rl rl rl rl rl事业部门版木管理工作标准sepgv1.0国强财务v60配置管理商业事业部版本管理规范 酒店事业部版本管理规范 财务产品部版木管理规范 pacs事业部版木管理规范 mrpii部版本管理规范金融事业部版本管理规范 erp部版本管理规范财务产品部v1.0v1.0v1.0v1.0v1.0v1.0v1.0v1.01. 5版序控制记录版序状 态拟稿审核批准发布口期1.0管理过程改善部任甲林99/h/181.6版本更新记录*a增加m修改d删除版本/修订

5、版修改页码修改记录修改人日期l.o初始版本99/ii版本管理2. 1版木标识方法为了使工作规范化、统一化，研发本部各部门实行的版本标识管理方法分为：正式 版木和特殊版木。2. 1. 1止式版本公司在市场渠道上发行的止规版木。以“v”开头，版本号放后。版本号分3节：主版本号，次版本号和内部版本号， 毎节之间以小数点（.）间隔。如v2.0.01表示主版本号为2,次版本号为0,内部版本 号为0l2. 1. 2特殊版本特殊版本是在正式版本的基础上，针对某客户开发的版本。它与正式版本的不同之 处在于问题不具有通用性和适应性，只符合该用户的实际使用情况。该版本标识分为常规部分和扩展部分，常规部分表示该特姝

6、版本哪一个正式版木的 分支，命名方法同正式版本的命名方法。对于扩展部分，以开头，后加一唯一序 号。举例如下：v2.33.s01表示由v2.33分支出的第一个特殊版本v2.33.s02表示由v2.33分支出的第二个特殊版木事业部不鼓励产生特殊版本。只有在极特姝的情况下，才产生适当的特殊版木。并 在以后的版本演化中，尽量将其纳入到正式版本中。2. 2目录结构出于各部门的实际情况不同，目录结构很难统一，但为了能更好地管理各事业部的 文档，建议可将被管理的配置项分为三大类：文档类、源码类及安装盘类，这样存放比 较清晰，有利于版木管理。至于二级口录是以模块划分还是以版木划分，各产品部、事 业部可根据自己

7、部门的情况，制定适合本部门的口录结构，并根据制定的口录结构给岀 文件级目录清单（先给出源程序及文档的文件级目录清单，安装盘的可以后再执行）：。现以财务产品部v6。0的目录结构举例如2根目录二级目录二级目录四级目录对应配置项备注源码(f:)模块缩写1current存11录前正在修改 的内容v6.0pbl源码sqlsql文件doc详细设计、数据 结构html帮助文件bmp图像文件v6.0.01按版本号依次类推 模块缩写2与模块1相同o o oo o o模块缩写n文档(g:)require用户需求记录版木号在文件名上 标识designv6.0总体设计文档按版本号依次类推v6.0.1 testreco

8、rd测试记录版本号在文件名上 标识casev6.0测试用例v6.0.01 userv6.0用户使用手册 产品说明手册v6.0.01 planproject项目计划month刀度计划安装盘(h:)v6.0releaserel src产品盘或发布文档setupv6.0.01表示止式版本及特殊版本的目录按以卜原则定义：正始版本：以“v”开头，版本号放后，主版本号和次主版本号z间的去掉，明细版本号之前加举例如下:版木号口录名v6.0v60v6.1v61v6.0.01v60-1v6.1.02v61-2（2） 特殊版本：目录名分为常规名和扩展名两部分，常规部分表示该特殊版木是 由哪一个正始版本分支而来，命

9、名方法同正始版本的命名方法。对于扩展名，以“s”开头, 口录名v60.s01v60.s02v60-1.s01后加一唯一序号。举例如下：意义表示曲v6.0分支出的第一个特殊版本表示由v6.0分支出的第二个特殊版本表示由v6.0.01分支出的第一个特殊版本（3） 对于有些事业部是针对某个具体用户开发的特殊版本,在表示特殊版本的目 录时，常规部分表示该特殊版木是哪-个正始版木的分支，对于扩展部分，可 以把项目名称作为扩展名。举例如下：v60冲信表示由v6.0分支出的中信版本2. 3文档的存放2. 3. 1当前版本和历史版本的存放对于源码文件，特别增加了一个current目录，存放当前正在开发与维护的

10、源码文 件，当前未发布版本的所冇数据都存放在.currentfo 一旦当前版本正式发行， 则当前目录被修改为相应的历史目录。历史版木是指已经发行的版木，存放在相应的版木口录之下，一般不允许改动。2. 3.2开发文档的存放根据各部门自己的情况，将系统用户需求记录、总休设计文档、详细设计及数据结 构文件、测试记录、用户手册等放入和应的目录下，也可将不同模块的开发文档存放于 不同的模块中。2. 3. 3源代码的存放源代码包括如：pbl, pbr, bmp, ico, cpp, hpp, mak, prj, ini 等相关文 件，是未经编译处理的、不能直接交付使用的产品文件以及编译产品所需的文件；联机

11、 帮助文件hlp在未生成hlp文件之前的doc, rtf等格式的文档也视为源代码。各子系统当前的程序源文件放入相应的目录下。对于一个子系统又分多个分子系统 的情况，应在该目录卜分别建立几个相应的目录。2. 3.4 sql语句的存放各子系统sql文件放入.sql下，对于不同的数据库，分别建立不同的子口 录，如wat、syb、mss、orc、db2等。公共sql文件直接放入sql下即可，不 同数据库的特殊sql分别放入对应的了目录下。2. 3. 5发行文档的存放发行文档是指产品交付用户使用所必须的文件。包括：产品可执行文件，用户使用 说明书，联机帮助（hlp）；资源文件（bmp, ico等），坏境

12、配置文件等。以上文档作为制作发行盘的素材，放在release的rel_src 口录z下，制作好 的发行盘放在release的setup目录。2. 4权限控制管理为保障文档的安全性，一致性，以及防止意外修改，必须对不同的文档设置不同的 访问权限。文档权限类别：只读权限，读写权限。文档类别：设计文档，源码，发行文档。用户类别：开发人员、测试人员、分析设计人员、部门经理、配置管理员、安装盘 制作人员、问题及需求管理人员、用户文档编写人员等。为了控制不同的使用权限，根据要求在服务器上分别建立不同的用户，针对不同的 配置项所在目录分配不同的权限。为了便于各产品部、事业部的管理，应以表格的形式列出人员与管

13、理对象的访问关 系（用户权限清单）。更新管理3. 1源程序的修改当开发小组在开发同一产品时，应能保障：各成员间的修改不会互相覆盖；程序员 的修改能及时反映到产品的最新版本中。建议首先在相应子系统的下一级建一目录，如checkout,存放正在修改的文档及修 改登记表。当某个程序员要修改某一文档时，遵循以下程序：1、接收维护任务；2、查看需要修改的文件（如pbl及sql等）是否止在被其它人员修改（检 查checkout目录下是否存在要修改的文件或后缀已改为该程序员姓名简写）；3、如果有人在修改该文件，等待或与相应的开发员联系，重复2。否则继续;4、将该文件复制到checkout b录下，在修改登记

14、表中登记；或将该文件的后 缀改为木人姓名简'弓；5、将该文件考至自己的私有目录；6、根据要求修改源文件；7、根据要求测试，并进行相关项的回归测试；8、交测试人员测试，如未通过，重复6。如通过则继续；9在checkout fl录中删除该文件，并在修改登记表中标注修改完成；10、将修改完毕的文件通过电子邮件或其它手段送交版本管理员，版本管理 员将文件复制到相应的路径；如遇特殊情况（版本管理员出差），程序员 可将修改完毕的文件复制到和应的路径下，或将后缀改冋止式。11、冋复下达者，报告维护任务完成。驻外开发时，也采用以上程序进行控制。3. 2已发布版本的维护及修改在正式版本发布后，由于软件错

15、误或其它问题（如用户提岀增加小功能）需要对程 序进行修改时，应及时作出修补盘（可以软盘或其它的形式），。（1）在该发布版木口录下建立一该版木的修补口录，该口录由版木管理员负责。（2）各系统如杲修改了部分错误或增强了部分功能，应将修改或增加的编译后程 序文件交由版本管理员，由管理员将该程序文件加入到该目录下，并更及时 更新到安装盘中去。（3）维护人员在更改产品的程序错误，如增加小的模块，或做小的改进时，应将 程序文件及时通知版本管理员，由版本管理员负责更新源程序。维护人员应 详细记录修改内容。举例如下：修改时间产品代号 或名称以 及版本号修改原因修改的模块；受影响的模块是否修改了表结构， 修改了

16、哪些表结构对应的修改川请表单号修改负责人该表存放在相应版木的根口录下。（4）修改过的源程序要经过测试人员的测试。事业部如没有专人测试，可由程序 员自己测试。（5）对于涉级数据结构的程序变动，原则上不作为修补的内容，它只对某些用户 有用，将可能在下一版本中体现，具体情况要具体处理。3. 3外出人员对产品的修改外出人员对产品的修改，是指以下几种情况:（1）外出维护时，需要对产品进行修改；（2）实施工程时，针对客户要求，对产品进行用户个性化修改（在这种情况下， 一般需要衍生出特殊版本）。执行程序：（1）维护人员每当接到实施或维护任务时，若需修改源代码，应在启程前认真填写 源程序修改屮请表,交部门负责

17、人认定后，维护人员可携带源程序到用户现场。（2）在维护期间，确实由于维护需耍而必须在用户设备上拷入源程序时，应确保源 程序的安全性，并及时予以删除。（3）在维护期间若修改了源程序或用户提出了新的问题，维护人员必须认真填写源 程序更新登记表。（4）回公司后，版本管理员应负责和监督相关人员将所有文档复制到规定h录z f,并完善相关的所有文档，相关的文档包括：源程序更新登记表、用户程序 更改f!志和修改申请表。将更新登记表及所更新的源程序数据交由部门版本管 理人员确认并审定。如果是已发布版本的源程序，必须由版本管理员负责更新； 非对外发布的版本如特殊版本可由程序员h己更新，但版本管理员应及时进行 备

18、份，保证源程序为最新。（5）修改过的源程序要经过测试人员的测试。事业部如没有专人测试，可由其他程 序员或木人口己测试。（6）将更新登记表交由部门负责人签字确认。（7）将更新登记表交由部门版木管理人员存档。（8）部门配置管理员及时通知相关程序员。修改申请表样例:申请时间用户名称版本v问题简单描述申请人签字负责人签字源程序更新登记表样例：源程序更新登记表编号:年 月fi 填表人版木情况问 题 描 述编号描述内容（包括:模块问题现彖问题原因）实际修改编号修改时间修改内容遗留 问题*单位名称地址更 新编号是否更新更新时间版木管理 员签字备注：部门经理 签字注:更新栏由部门版本管理坊;3. 4版本升级

19、3. 4. 1版本升级原则版本升级应严格纳入版本管理的控制之下。应当谨慎地控制版本的升级，保障高版 本的向下兼容性，或提供严格定义的升级方法。在下面儿种情况下，进行版本演化和升级：1、当产品发生重大修改和改进时，主版木号加1。重大修改和改进包括：1）平台迁移；2）开发工具的迁移；3）体系结构的变迁。2、当产品发生较小的改进或修改时，次版本号可以加1。3、对于改动量比较少的，如修改产品的错误，可增加内部版木号。内部版木号对 用户来说是不可见的，只对事业部内部版木控制有用。4、记录版本升级过程。每次版本升级，都要填写版本升级记录表，记录表样例如下:版本升级记录表版本号发布fi期修改文件问题简要描述

20、发布责任人批准人备注说明：版本号：记录当前发布的版本。发布h期：该版本批准发布的h期。修改文件：版本修改记录文件，一般为版本修改h志。3. 4. 2新版本的发布新版本的发布包括主版本号和次版本号的升级，一般不包括内部版本号的升级。流 程如下：1、接收新版本发布任务，接收本次发布的版本代号。2、在指定目录中，根据本次发布的版本号建立相应的子目录，将current下的所 有内容拷贝至新建口录下。3、可在新建口录下建立readme.txt,并加入相应的内容。4、卜达安装盘制作指令。readme.txt文件是记录该版本与上一版本的不同，作过哪些改动。格式样例如下:增加或修改功能涉及源文件改动原因3. 4. 3安装盘制作步骤接收安装盘制作指令。编译源程序。制作升级sqlo测试升级程序。根据版木号在安装盘口录下建立新版安装盘口录。在新建