软件研发本管理制度

泰豪软件研发版本管理规范v1.0(草案)研发部2023-2-4目录TOC\o"1-3"面文档类别使斜用对象蹦绒3烤1摸．引言曾父4换1.1惕目的清佩4疮1.2愿范围霞素4顷1.3矿术语定义叠浇4蝇1.4桌版序控制记拍录桂想5历1.5版版本更新记时录别鼠5向2薪．版本管理妈例5秒2颜．皮1扁版本标识方甘法鞭蒸5妖2都．路1金．钳1妹正式版本疾喝5尺2宰．凯2捞目录结构轨剑6恭2休．宣3芒文档的存放展赞7郑唉退当前版本和和历史版本的轰存放迎特7货掌蹈开发文档的巷存放魄扬7宫糟痰源代码的存骡放双摆7愈碎SQL歉语句的存放绢勺7稠礼发行文档的纱存放愤铸7送2锦．朋4踢权限控制管下理蜜拐8甚3畏．更新管理惹（版本升级引）尺宏8穗3.1握版本升级原则则订迫8列3.2葬新版本的发切布爆锋9陷4滚．备份管理吃蠢9初5圈．用户版本珠管理相油10慌6壁．研发部统胞一管理阶段钻性版本坚良10敲6.1滋阶段性版本消的提交到研济发部薄繁10旋6.2程阶段性版本绒的发布到公芳司网站上活替10穿6.3肆各项目组新辽版本内部及信时备份。缎车11丝7戒．版本工具贱的使用锐丈1铸1博7.1进研发部采用问svn哗配置管理工欧具适温11彼8树．各项目组渡提交文档及露源码以及规歉则合误11发8.1陵各项目组需秩要提交的文杨档纪赛11暑8.2想目前所管理洽的产品列表偶致12雕9晨．周报管理未制度胁妄12傍10诚．风险管理绸制度侵友13核文档类别使奔用对象文档类别缓该文档是为乎泰豪振公司皂提供一个版裂本管理规范丰性些文件间。使用对象奥该文档使用于对象为探泰豪软件哈公司研发本踩部各部门边项目帝经理及版本丛管理人员，等以及其他那相关人员。插未经许可，晒该文档不得蚊提供给上述是规定对象以酒外的人员阅扇读或使用。1．引言1.1目的厉本文档是为贷规范嫌泰豪软件公字司研发裙版本管理而眯制定的。1.2范围拉本文档为各消产品部、事你业部版本管槽理员提供俱有关版本管柴理规范的相给关内容，包仍括：岁版本标识方英法门软件系统数挠据的存放烂文档的修改权控制厘文档的备份榜制度滑1.形3汉术语定义SVN半Svn是一胀个开源的版晨本控制系统意Subve谅rsion勒的简称文档建兄一种数据媒妈体和其上所肯记录的数据致。配置管理德标识和确定宅系统中配置堤项的过程，件在系统整个敲生存周期内街控制这些项辨的投放和更与动，记录并撇报告配置的铅状态和更动逐要求，验证虎配置项的完江整性和正确彼性。软件配置省软件的具体柔形态在某时点刻的瞬时影奖像。配置项摊吊软件配置管炊理的对象称锈为配置项，左如：系统规澡格说明书，望项目开发计盯划，用户手滨册，源码。基线地柏软件生存周小期中各开发弊阶段末尾的洋标记，它的宾作用是把各钉阶段工作的喜划分更加明嘉确化，使本步来连续的工茧作在这些点摧上断开，使具之便于检验奖和肯定阶段运成果。滥1.炸4粱版序控制记肥录光版序状态辫拟稿掏审核誓批准危发布日期碑1.0低研发部园桥张洪鞋兴浸0迈9/11/鼠18饿1.督5盖版本更新记悬录最*火A歪-字增加冠发M郊-排修改裙灵D罪-手删除牺版本/修订案版徒修改页码宵修改记录耗修改人穿日期衫1.0限初始版本蜡20笨0奴9/惭02耐2砌．版本管理略2．1版本丰标识方法秩为了使工作椒规范化、统数一化，屋各开项目组锈实行的版本低标识管理方寻法分为：正床式版本和特炼殊版本。企2．1．1烈正式版本纠政公司在市场追上发行的正况规版本。醋以寺“凳V们”娘开头，版本黄号放后。托V艇前面增加项欠目名称，厌版本号分3架节：主版本辫号，次版本吸号和内部版晋本号，每节枯之间以小数歉点（乡.控）间隔。如役V撕2.0.黑1甘表示主版本办号为2，次单版本号为0苦，内部版本子号为1。馋研发部控制铅主版本号和袄次版本号，妹各项目组控佳制内部版本御号。锦例如：一体蝇化平台-平宴阴版v1.宰1.1飘,柱垄一体化平台纠为产品名称划，平阴版为使版本名称（芳平阴为具体底项目名称）网，v1.1屯.1为主版规本号+次版锦本号+内部枕版本号。沃2．2目录谊结构悄由于各项目存组台的实际情况演不同，目录柳结构很难统来一，但为了刺能更好地管夺理各骨项目组盒的文档，建迫议可将被管歼理的配置项佛分为三大类酱：文档类、揉源码目类及安装盘弄类，这样存己放比较清晰持，有利于版害本管理。至魂于二级目录那是捞以版本划分延，并根据制松定的目录结悼构给出文件辆级目录清单尿（先给出源户程序及文档猫的文件级目捎录清单，安之装盘的可以压后再执行）查：。欲现以农电平贩台上1.0娇的目录结构锐举例如下：臭根目录查一级目录哑二级目录浸三级目录命对应配置项骡备注绳产品名称询一体化平台膜版本号独源码苦(F:)热核心源码包舱jar添源码嘉存目录前正阴在修改的内听容尿C僚lass文凶件裳扩展源码包答源码估sql礼SQL文件溜版本变动说月明锤文档移(G:)秒需求文档变用户需求记决录慰版本号在文跨件名上标识昼概要设计文赢档厦总体设计文沿档观按版本号依穷次类推尾数据库设计您详细设计文地档脸测试用例直测试记录乏版本号在文鸟件名上标识内用户手册良用户使用手艇册投产品说明书弯项目计划常项目计划州实施手册学实施手册亏月度计划锈月度计划制安装盘奸(H:)虽REL铁_SRC严产品盘罪或发布文档管SETUP渗发布文档最表示正式版销本及特殊版泛本的目录按嫂以下原则定姜义：郊正始版本：宋以研“嘱V愿”县开头，版本隙号放后，主座版本号和次触主版本号之讽间的饲“意.睬”摔去掉，明细魄版本号之前酒加弓“愉-鼻”帐。举例如下遥：终版本号汉仍洋经仅目录名绑V削1钞.0拴柱贼箩V姨1骂.涛0容V笑1近.1否县木剃V哥1拌.诉1喷V狗1傍.0.疏1剂饺猾V愈1罢.哗0亮.刮1教V货1帆.1.挪2痒厨潮V拔1驶.状1孝.撇2逢2．3文档躬的存放异蛙使当前版本和绪历史版本的歇存放界对于源码文岔件，特别增稳加了一个逐Curre财nt乖目录，存放宝当前正在开信发与维护的全源码文件，消当前未发布离版本的所有分数据都存放缩在辜见\CURR鞋ENT\霸下。一旦当有前版本正式示发行，则当赴前目录被修妹改为相应的龟历史目录。私历史版本是澡指已经发行遇的版本，存贞放在相应的均版本目录之址下，一般不锤允许改动。射2.3.分2艺密开发文档的横存放度根据各项目船部勉自己的情况券，将系统用殖户需求记录口、总体设计敲文档物、详细设计终及数据结构当文件、测试竹记录、用户战手册等放入乖相应的目录吉下。叙折源代码的老存放勇源代码包括件如：讯java批，撑jsp厌，BMP，今ICO车等相关文件烈，是未经编开译处理的、安不能直接交普付使用的产葱品文件以及糊编译产品所观需的文件；鞭联机帮助文属件HLP在芬未生成HL袄P文件之前赏的DOC，算RTF等格盟式的文档也敬视为源代码盆。呀各子系统当吨前的程序源挑文件放入相仁应的目录下幕。对于一个库子系统又分衬多个分子系唱统的情况，筐应在该目录他下分别建立省几个相应的构目录。禽2.3.坡4梳SQL语旬句的存放骡各子系统肤SQL盖文件放入必…..\.蜘捐.\SQL匠下，对于不学同的数据库茫，分别建立拆不同的子目逗录，如规oracl倒e废、牢sysba肚se、db糠2尝等。公共菠SQL模文件直接放彼入党…\SQL冲下即可，不肉同数据库的闸特殊克SQL网分别放入对驳应的子目录坚下。偿2.3.茎5该发行文档的期存放揭发行文档是雾指产品交付锅用户使用所鸽必须的文件赏。包括：产织品可执行文种件，用户使启用说明书，州联机帮助（传HLP）；鲜资源文件（踏BMP，I慎CO等），野环境配置文纱件等。辈以上文档作治为制作发行牢盘的素材，妨放在REL耽EASE的多REL猴_SRC季目录之下，丈制作好的发训行盘放在R摇ELEAS爱E的嫂SETUP网目录。啊2．4权限浮控制管理件为保障文档掘的安全性，政一致性，以服及防止意外耗修改，必须域对不同的文寄档设置不同忠的访问权限段。激文档权限类墨别：只读权区限，读写权炒限。歼文档类别：台设计文档，登源码，发行枣文档。概用户类别：徒开发人员、质测试人员、够分析设计人罩员、项目滴经理、配置梨管理员、安劫装盘制作人耗员、问题及因需求管理人印员、用户文村档编写人员额等。沾为了控制不琴同的使用权驰限，根据要兴求在服务器斗上分别建立贩不同的用户诊，针对不同童的配置项所愉在目录分配俊不同的权限搁。猫为了便于湖管理，应以裤表格的形式沸列出人员与赞管理对象的眯访问关系（检用户权限清演单）。垒3．更新管挡理六（版本升级字）百3.裹1枯版本升级原绒则反版本升级应先严格纳入版寺本管理的控美制之下。应胳当谨慎地控初制版本的升示级，保障高示版本的向下宽兼容性，或掀提供严格定兽义的升级方毛法。琴在下面几种丹情况下，进劝行版本演化咬和升级：首1、当产品族发生重大修音改和改进时雷，主版本号远加1。重大基修改和改进背包括：平台迁移；粮开发工具的午迁移；绍体系结构的兼变迁。图2、当产品使发生较小的应改进或修改缩时，次版本苦号可以加1程。硬3、对基于改动量比完较少的，如茧修改产品的平错误，可增育加内部版本暗号。内部版矿本号对用户头来说是不可帝见的，只对挣项目子部内部版本杜控制有用。玉4、记录版足本升级过程输。每次版本仙升级，都要继填写版本升工级记录表，朴记录表样例足如下：尾版本升级记秤录表歉版本号衰发布日期贿修改文件讽问题简要描高述窜发布责任人沸批准人倾备注说明：胳定版本号：琴记录当前料发布的版本走。棒窜发布日期：荷该版本批准尿发布的日期哪。凯时修改文件：罢版本修改记介录文件，一吼般为版本修继改日志。沙3.拼2背茎新版本的发欧布鼓新版本的发浙布包括主版智本号和次版妖本号的升级闹，一般不包礼括内部版本转号的升级。医流程如下：笛根据项目进倡展情况，或际者根据用户场需要进行发注布准备。记在指定目录嫁中，根据本荐次发布的版鉴本号建立相揉应的子目录蔑，将园curre箩nt或下的所有内暗容拷贝至新杠建目录下。养可在新建目彩录下建立珍readm郊e.txt史，并加入相瓣应的内容。抱readm己e.txt浸文件是记录君该版本与上邀一版本的不之同，作过哪向些改动。格轿式样例如下境：拿增加或修改谣功能多涉及源文件妈改动原因烦4．备份管娘理抬为了保证文狸档的最大可货恢复性，要润随时及定期组地进行备份领工作。随时备份：除开发人员每丘天都要将自话已当日修改云的源文件在知本地机器上版进行备份。籍开发负责人挎每天要将所厨有源文件在怪本地机备份屑。波建议备份采抖用循环备份法。定期备份撇备份形式为推硬盘备份和挽光盘备份。针硬盘备份时虚，要备份在南独立的硬盘跃上；光盘备拒份时，要将愁光盘存放在朽可靠的地方走。眠备份周期视秒各产品部、仇事业部的具腔体情况而定宁。如果处于辆开发阶段，世每周应对所云有的源程序谎项进行备份帜，一般为每麻周周五；如别果处于其它刃阶段，根据吓具体情况而场定，但周期坚不能超过两需周。身备份要由版闪本管理员负特责，备份原悟则应是保证鹊文档的最大安可恢复性。仇对于历史版佛本或某用户兴的特殊版本堤，如果无特岔殊原因不再祝进行修改的纹话，建议用合光盘进行备胞份，而且应卧有备份盘说雅明文件BA刑CKUP.爹TXT。该冰文件应该记课录以下内容挺：本次备份祝时间，备份监内容，执行驼人。胀5．用户版鸦本管理菜篮目前主要焦以做项目为迟主，是根据木客户要求开袋发的程序。刊为了更好地闪管理源程序箱，应为每一袖用户建立一服个用户版本葱文件，该文限件应包含以虫下内容：用户编号：用户名称：是软件版本号诱：打开始使用时短间：联系人：联系：福用户程序更芝改日志样例江如下：四更改时间舞版本号干修改模块名千称感变更原因痰变更概述速软件位置角变更人员扇备注说明：肃用户购买软苦件时要为该趣用户建立一猎个包含上述润内容的一个柴用户版本文鸣件，并填写床有关数据。越用户进行版创本更新时要没求填写该文跪件的版本变浆更记录，用匪以反映用户饲版本的变更谈情况。厉6计．美研发部走统一管理阶士段性斗版本得摆6枝.1非阶段性麦版本的提交责到研发部示当各项目组密更新了新版眯本以后，如依果次版本号炕发生改变，包各项目组配羊置管理员经毫项目经理批狼准后月要把次版本站修改的内容援（已提交的内容精分为毫修改的闯源码、巧新的碰文档和安装咱盘丧）搬提交给研发奸部版本管理彼人员诉。妖胁6父.2驰阶段性缎版本的发布哭到公司网站薪上般产品新版本原发布以后，欧及时草在软件演示求环境中进行行更新。并且映新版本的特推色和特点要云在公司网站怜上进行寄发布，阴描述新版本打特色的文档顶要由各项目桐组进行提供宁给项目部，详经项目部保京存后，文档补提交给公司圈网站管理人寻员进行发布快，扫以便供其他钻项目组和公仪司营销人员店进行了解。宾皱6.3各项章目组新版本辞内部及时备夸份。蛋亭研发部负自责进行所有锻产品版本的宣管理，但各限个项目组也掌要自己进行王备份。丰7．版本工型具的使用免7.1懒研发部采用悬svn配置傻管理工具巴研发部采用诸专门的配置浊管低理服离务器，此服件务器只是专邪门用于版本蔽的管理，一岸般不用于其充他的应用，经配置管理软骗件搂采用svn籍1.5驶进行配置管吉理。央8．各项目婚组提交文档续及源码绑以及童规则速8.1各条项目养组意需要提交的雄文档萝名称萌成果描述姻立项申请书园写名此项目可的价值、所得需人力资源教及费用、可建行性分析、远成本-效益添分析、风险螺分析磨立项评审报敞告砍评审结论、府评审建议育软件城需求说明书您目标客户、蛛业务流程、连系统中的角绑色、蓝子慈功能模块介智绍、茫质量要求、脆界面要求典系统设计说卵明书狸系统约束、革开发环境、烘数据流程图凤、用例图、慧模块之间的围关系图、由类函数文件浴变量等命名牢规则杯、系统安全称设计说明钱、性能分析腐数据库设计糟说明书骄所有表名、客表设计、表炼ER图、生必成库的sq泊l语句、存膀储过程等。娇表及字段命考名规则。佛用户界面设牵计说明