软件研发版本管理制度.doc

优秀的文档北京东大悦科技有限公司。软件开发版本管理规范1.0版(草案)研发部门2009-2-4目录文档类别使用对象3导言41.1目的41.2范围41.3术语定义41.4版本顺序控制记录5版本1.5更新记录52.版本管理5版本2.1识别方法52.1.1正式版本52.2目录结构62.3文件的存储72.3.1版本历史7的当前版本和存储2.3.2开发文件的存储72.3.3源代码存储72 . 3 . 4 SQL语句的存储72.3.5发布文件的存储72.4权利控制和管理83.更新管理(版本升级)83.1版本升级原则83.2新版本9的发布4.备份管理95.用户版本管理106.研发部门统一管理分阶段版本106.1分阶段版本提交给R&D部门106.2分阶段版本发布到公司网站106.3各项目组的新版本应及时备份。117.版本工具的使用117.1研发部门采用svn配置管理工具118.项目组提交的文档和源代码以及规则118.1每个项目组提交的文件118.2当前管理的产品列表129.周报管理系统1210.风险管理系统13文档类别使用对象文档类别本文件是东大悦公司的版本管理规范性文件。使用对象本文档面向东大越软件公司R&D部的项目经理和各个部门的版本经理以及其他相关人员。未经许可，本文件不得提供给上述人员以外的其他人阅读或使用。介绍1.1目的为规范东大越软件公司的开发版本管理，特制定本文件。1.2范围本文件为各产品部门和部门的版本管理员提供了版本管理规范的相关内容，包括：版本识别方法软件系统数据的存储文件修改控制文件备份系统1.3术语的定义SVNSvn是Subversion的缩写，是一个开源版本控制系统文档一种数据介质和记录在其上的数据。结构管理识别和确定系统中的配置项，在系统的整个生命周期中控制这些项的发布和更改，记录和报告配置状态和更改要求，以及验证配置项的完整性和正确性的过程。软件配置特定时刻特定形式软件的瞬时图像。配置项目软件配置管理的对象称为配置项，如系统规范、项目开发计划、用户手册和源代码。基线软件生命周期中每个开发阶段结束时的标记用于使每个阶段的工作划分更加明确，在这些点上打破最初的连续工作，并使检查和确认阶段结果变得容易。1.4版本顺序控制记录修订状态起草一份草案审计同意发布日期1.0研发部门张红星2018年11月9日版本1.5更新记录*增加-修改-删除版本/修订修改页码修改记录修饰语日期，1.0初始版本2009/02年度2.版本管理版本2.1识别方法为了规范和统一工作，各项目组实施的版本识别管理方法分为正式版本和特殊版本。2.1.1正式版本该公司在市场上发行的正式版本。以“V”开头，并在其后加上版本号。v前面是项目名称，版本号分为3部分：主要版本号、次要版本号和内部版本号，带小数点(。)每个部分之间的间隔。例如，版本2.0.1意味着主版本号是2，次版本号是0，内部版本号是1。研发部门控制主要版本号和次要版本号，每个项目团队控制内部版本号。例如，集成平台-平阴版本1.1.1，集成平台是产品名称，平阴版本是版本名称(平阴是具体项目名称)，1.1.1是主要版本号，次要版本号是内部版本号。2.2目录结构由于每个项目组的实际情况不同，很难统一目录结构。但是，为了更好地管理每个项目组的文档，建议以下是农业电力平台1.0的目录结构示例：根目录一级目录二级目录三级目录相应的配置项目评论产品名称集成平台版本号源代码(F:)核心源包冲突源代码保存目录前修改了什么类文件扩展源代码包源代码结构化查询语言SQL文件版本更改描述文件(G:)要求文件用户需求记录版本号在文件名上标识概要设计文件总体设计文件根据版本号等等数据库设计详细设计文件判例案件测试记录版本号在文件名上标识用户手册用户手册制品技术规格工程计划工程计划实施手册实施手册月计划月计划安装盘(H:)REL _斯普斯卡共和国产品托盘或者发布文档设置发布文档代表官方版本和特殊版本的目录根据以下原则定义：(1)原始版本：以“V”开头。版本号发布后，“”主版本号和次主版本号之间的内容被删除，在详细版本号之前添加“-”。例子如下：版本号目录名1.0 1.0版1.1 1.1版V1.0.1 V1.0.1V1.1.2 V1.1.22.3文件的存储2.3.1当前版本和版本历史的存储对于源代码文件，添加了一个当前目录来存储当前正在开发和维护的源代码文件。当前未发布版本的所有数据都存储在下.当前。一旦当前版本正式发布，当前目录将被修改为相应的历史目录。版本历史是指发布的版本，存储在相应的版本目录下，一般不允许修改。2.3.2开发文件的存储根据各项目部自身情况，摆放系统用户需求记录、总体设计文件、详细设计和数据结构文件、测试记录、用户手册等。到相应的目录中。2.3.3源代码存储源代码包括相关文件，如java、jsp、BMP、ICO等。它是一个尚未编译的产品文件，不能直接交付使用，也是编译产品所需的文件。在线帮助文件HLP生成之前的文档，文档格式和其他格式也被视为源代码。每个子系统的当前程序源文件被放入相应的目录。对于一个子系统被划分为多个分子系统的情况，应该在该目录下分别建立几个相应的目录。2.3.4存储SQL语句每个子系统的SQL文件被放入.SQL，并为不同的数据库建立不同的子目录，如oracle、sysbase、db2等。公共SQL文件可以直接放在. SQL和不同数据库的特殊SQL分别放在相应的子目录下。2.3.5发布文件的存储分发文件是指向用户交付产品所需的文件。包括：产品可执行文件、用户说明、在线帮助(HLP)；资源文件(BMP、ICO等。)，环境配置文件等。上述文件用作制作发行盘的材料，发行盘放在发行目录下，准备好的发行盘放在发行目录下。2.4权限控制和管理为了保证文档的安全性和一致性，防止意外修改，必须为不同的文档设置不同的访问权限。文档权限类别：只读权限、读写权限。文档类别：设计文档、源代码、分发文档。用户类别：开发人员、测试人员、分析设计人员、项目经理、配置管理员、安装盘制造商、问题和需求经理、用户文档作者等。为了控制不同的使用权限，根据需要在服务器上分别建立不同的用户，并为不同配置项所在的目录分配不同的权限。为了便于管理，人员和管理对象之间的访问关系(用户权限列表)应以表格的形式列出。3.更新管理(版本升级)3.1版本升级原则版本升级应受到版本管理的严格控制。应仔细控制版本的升级，以确保高版本的向下兼容性或提供严格定义的升级方法。版本演进和升级是按2)开发工具的迁移；3)制度结构的变化。2.当产品进行小的改进或修改时，小版本号可以增加1。3.对于微小的更改，如产品修改错误，可以增加内部版本号。版本号对用户不可见，只对项目部门的版本控制有用。4.记录版本升级过程。对于每次版本升级，必须填写版本升级记录表。样本记录表格如下：版本升级记录表版本号发布日期修改文件问题的简要描述出版负责人批准人评论描述：版本号：记录当前发布的版本。发布日期：此版本的发布被批准的日期。修改文件：版本修改记录文件，一般是版本修改日志。3.2新版本的发布新版本的发布包括主版本号和次版本号的升级，通常不包括内部版本号的升级。过程如下：1、根据项目的进度，或根据用户的需要准备发布。2.在指定的目录下，根据这次发布的版本号建立相应的子目录，并将当前目录下的所有内容复制到新的目录下。3.readme.txt可以在新目录下建立，并可以添加相应的内容。Txt文件用于记录这个版本和以前版本之间的差异以及所做的更改。格式示例如下：添加或修改功能涉及源文件变革的理由4.备份管理为了确保文档的最大可恢复性，应随时定期进行备份。1、随时备份：(1)开发人员必须每天在本地机器上备份他们修改过的源文件。(2)开发负责人应该每天备份本地机器上的所有源文件。(3)建议使用循环备份进行备份。2、定期备份(1)备份形式有硬盘备份和光盘备份。备份硬盘时，应该将其备份到单独的硬盘上。备份光盘时，请将光盘存放在可靠的地方。(2)备份周期取决于每个产品部门和部门的具体情况。如果处于开发阶段，所有源程序项目都应该每周备份，通常是每周五。如果是在其他阶段，则取决于具体情况，但期限不能超过两周。(3)版本管理员负责备份，备份原则是确保文件的最大可恢复性。(4)对于版本历史的特殊版本或某个用户，如因特殊原因未被修改，建议使用光盘进行备份，并应有备份磁盘描述文件BACKUP.TXT，该文件应记录以下内容：备份时间、备份内容和执行者。5.用户版本管理目前，它主要是根据客户需求开发的基于项目的程序。为了更好地管理源程序，应该为每个用户建立一个用户版本文件，该文件应该包括以下内容：用户号码：用户名：软件版本号：开始时间：联系人：联系号码：用户程序更改日志的示例如下：改变时间版本号修改模块名称变革的理由变化概述软件位置人事变动评论描述：1)用户在购买软件时，应建立包含上述内容的用户版本文件，并填写相关数据。2)更新版本时，要求用户填写文档的版本变更记录，以反映用户版本的变更。6.研发部门统一管理阶段版本6.1向R&D部门提交分阶段版本各项目组更新新版本后，如果子版本号发生变化，各项目组的配置经理应在项目经理批准后，将子版本的修改内容(提交的内容分为修改后的源代码、新文档和安装盘)提交给研发部门的版本经理。6.2分阶段版本发布到公司网站产品的新版本发布后，将在软件演示环境中及时更新。此外，新版本的特性和特点应在公司网站上公布。每个项目组应向项目部提供描述新版本特性的文件。被拯救后研发部门负责所有产品版本的管理，但每个项目团队都必须备份自己的版本。7.版本工具的使用7.1研发部门采用svn配置管理工具研发部门使用特殊的配置管理服务器，该服务器仅用于版本管理，通常不用于其他应用程序。配置管理软件使用svn1.5进行配置管理。8.每个项目团队提交文档、源代码和规则8.1每个项目组提交的文件名字结果描述项目设立申请写下项目的价值、所需的人力资源和成本、可行性分析、成本效益分析和风险分析。项目评估报告审查结论和建议软件需求规范目标客户、业务流程、系统中的角色、子功能模块的介绍、质量要求和接口要求系统设计规范系统约束、开发环境、数据流图、用例图、模块之间的关系图、命名规则(如类函数文件变量)、系统安全设计指令、性能分析数据库设计规范所有表名、表设计、表ER图、生成库的sql语句、存储过程等。表和字段命名规则。用户界面设计规范系统界面设计描述和原型图模块设计规范编程接口，主要数据结构，主要算法判例案件用例名称、用例描述