軟件研發(fā)本管理制度

泰豪軟件研發(fā)版本管理規(guī)范v1.0(草案)研發(fā)部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貨掌蹈開發(fā)文檔的巷存放魄揚7宮糟痰源代碼的存騾放雙擺7愈碎SQL歉語句的存放絹勺7稠禮發(fā)行文檔的紗存放憤鑄7送2錦．朋4踢權限控制管下理蜜拐8甚3畏．更新管理惹（版本升級引）尺宏8穗3.1握版本升級原則則訂迫8列3.2葬新版本的發(fā)切布爆鋒9陷4滾．備份管理吃蠢9初5圈．用戶版本珠管理相油10慌6壁．研發(fā)部統(tǒng)胞一管理階段鉆性版本堅良10敲6.1滋階段性版本消的提交到研濟發(fā)部薄繁10旋6.2程階段性版本絨的發(fā)布到公芳司網(wǎng)站上活替10穿6.3肆各項目組新遼版本內(nèi)部及信時備份。緞車11絲7戒．版本工具賤的使用銳丈1鑄1博7.1進研發(fā)部采用問svn嘩配置管理工歐具適溫11彼8樹．各項目組渡提交文檔及露源碼以及規(guī)歉則合誤11發(fā)8.1陵各項目組需秩要提交的文楊檔紀賽11暑8.2想目前所管理洽的產(chǎn)品列表偶致12雕9晨．周報管理未制度脅妄12傍10誠．風險管理綢制度侵友13核文檔類別使奔用對象文檔類別緩該文檔是為乎泰豪振公司皂提供一個版裂本管理規(guī)范豐性些文件間。使用對象奧該文檔使用于對象為探泰豪軟件哈公司研發(fā)本踩部各部門邊項目帝經(jīng)理及版本叢管理人員，等以及其他那相關人員。插未經(jīng)許可，曬該文檔不得蚊提供給上述是規(guī)定對象以酒外的人員閱扇讀或使用。1．引言1.1目的厲本文檔是為貸規(guī)范嫌泰豪軟件公字司研發(fā)裙版本管理而瞇制定的。1.2范圍拉本文檔為各消產(chǎn)品部、事你業(yè)部版本管槽理員提供俱有關版本管柴理規(guī)范的相給關內(nèi)容，包仍括：歲版本標識方英法門軟件系統(tǒng)數(shù)撓據(jù)的存放爛文檔的修改權控制厘文檔的備份榜制度滑1.形3漢術語定義SVN半Svn是一脹個開源的版晨本控制系統(tǒng)意Subve諒rsion勒的簡稱文檔建兄一種數(shù)據(jù)媒媽體和其上所肯記錄的數(shù)據(jù)致。配置管理德標識和確定宅系統(tǒng)中配置堤項的過程，件在系統(tǒng)整個敲生存周期內(nèi)街控制這些項辨的投放和更與動，記錄并撇報告配置的鉛狀態(tài)和更動逐要求，驗證虎配置項的完江整性和正確彼性。軟件配置省軟件的具體柔形態(tài)在某時點刻的瞬時影獎像。配置項攤吊軟件配置管炊理的對象稱銹為配置項，左如：系統(tǒng)規(guī)澡格說明書，望項目開發(fā)計盯劃，用戶手濱冊，源碼?；€地柏軟件生存周小期中各開發(fā)弊階段末尾的洋標記，它的賓作用是把各釘階段工作的喜劃分更加明嘉確化，使本步來連續(xù)的工繭作在這些點摧上斷開，使具之便于檢驗獎和肯定階段運成果。濫1.炸4粱版序控制記肥錄光版序狀態(tài)辮擬稿掏審核誓批準危發(fā)布日期碑1.0低研發(fā)部園橋張洪鞋興浸0邁9/11/鼠18餓1.督5蓋版本更新記懸錄最*火A歪-字增加冠發(fā)M郊-排修改裙靈D罪-手刪除犧版本/修訂案版徒修改頁碼宵修改記錄耗修改人穿日期衫1.0限初始版本蠟20笨0奴9/慚02耐2砌．版本管理略2．1版本豐標識方法秩為了使工作椒規(guī)范化、統(tǒng)數(shù)一化，屋各開項目組銹實行的版本低標識管理方尋法分為：正床式版本和特煉殊版本。企2．1．1烈正式版本糾政公司在市場追上發(fā)行的正況規(guī)版本。醋以寺“凳V們”娘開頭，版本黃號放后。托V艇前面增加項欠目名稱，厭版本號分3架節(jié)：主版本辮號，次版本吸號和內(nèi)部版晉本號，每節(jié)枯之間以小數(shù)歉點（鄉(xiāng).控）間隔。如役V撕2.0.黑1甘表示主版本辦號為2，次單版本號為0苦，內(nèi)部版本子號為1。饞研發(fā)部控制鉛主版本號和襖次版本號，妹各項目組控佳制內(nèi)部版本御號。錦例如：一體蠅化平臺-平宴陰版v1.宰1.1飄,柱壟一體化平臺糾為產(chǎn)品名稱劃，平陰版為使版本名稱（芳平陰為具體底項目名稱）網(wǎng)，v1.1屯.1為主版規(guī)本號+次版錦本號+內(nèi)部枕版本號。沃2．2目錄誼結構悄由于各項目存組臺的實際情況演不同，目錄柳結構很難統(tǒng)來一，但為了刺能更好地管奪理各骨項目組盒的文檔，建迫議可將被管殲理的配置項佛分為三大類醬：文檔類、揉源碼目類及安裝盤弄類，這樣存己放比較清晰持，有利于版害本管理。至魂于二級目錄那是撈以版本劃分延，并根據(jù)制松定的目錄結悼構給出文件輛級目錄清單尿（先給出源戶程序及文檔貓的文件級目捎錄清單，安之裝盤的可以壓后再執(zhí)行）查：。欲現(xiàn)以農(nóng)電平販臺上1.0嬌的目錄結構銳舉例如下：臭根目錄查一級目錄啞二級目錄浸三級目錄命對應配置項騾備注繩產(chǎn)品名稱詢一體化平臺膜版本號獨源碼苦(F:)熱核心源碼包艙jar添源碼嘉存目錄前正陰在修改的內(nèi)聽容尿C僚lass文兇件裳擴展源碼包答源碼估sql禮SQL文件溜版本變動說月明錘文檔移(G:)秒需求文檔變用戶需求記決錄慰版本號在文跨件名上標識晝概要設計文贏檔廈總體設計文沿檔觀按版本號依窮次類推尾數(shù)據(jù)庫設計您詳細設計文地檔臉測試用例直測試記錄乏版本號在文鳥件名上標識內(nèi)用戶手冊良用戶使用手艇冊投產(chǎn)品說明書彎項目計劃常項目計劃州實施手冊學實施手冊虧月度計劃銹月度計劃制安裝盤奸(H:)雖REL鐵_SRC嚴產(chǎn)品盤罪或發(fā)布文檔管SETUP滲發(fā)布文檔最表示正式版銷本及特殊版泛本的目錄按嫂以下原則定姜義：郊正始版本：宋以研“囑V愿”縣開頭，版本隙號放后，主座版本號和次觸主版本號之諷間的飼“意.睬”摔去掉，明細魄版本號之前酒加弓“愉-鼻”帳。舉例如下遙：終版本號漢仍洋經(jīng)僅目錄名綁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文檔躬的存放異蛙使當前版本和緒歷史版本的歇存放界對于源碼文岔件，特別增穩(wěn)加了一個逐Curre財nt乖目錄，存放寶當前正在開信發(fā)與維護的全源碼文件，消當前未發(fā)布離版本的所有分數(shù)據(jù)都存放縮在辜見\CURR鞋ENT\霸下。一旦當有前版本正式示發(fā)行，則當赴前目錄被修妹改為相應的龜歷史目錄。私歷史版本是澡指已經(jīng)發(fā)行遇的版本，存貞放在相應的均版本目錄之址下，一般不錘允許改動。射2.3.分2藝密開發(fā)文檔的橫存放度根據(jù)各項目船部勉自己的情況券，將系統(tǒng)用殖戶需求記錄口、總體設計敲文檔物、詳細設計終及數(shù)據(jù)結構當文件、測試竹記錄、用戶戰(zhàn)手冊等放入乖相應的目錄吉下。敘折源代碼的老存放勇源代碼包括件如：訊java批，撐jsp厭，BMP，今ICO車等相關文件烈，是未經(jīng)編開譯處理的、安不能直接交普付使用的產(chǎn)蔥品文件以及糊編譯產(chǎn)品所觀需的文件；鞭聯(lián)機幫助文屬件HLP在芬未生成HL襖P文件之前賞的DOC，算RTF等格盟式的文檔也敬視為源代碼盆。呀各子系統(tǒng)當噸前的程序源挑文件放入相仁應的目錄下幕。對于一個庫子系統(tǒng)又分襯多個分子系唱統(tǒng)的情況，筐應在該目錄他下分別建立省幾個相應的構目錄。禽2.3.坡4梳SQL語旬句的存放騾各子系統(tǒng)膚SQL蓋文件放入必…..\.蜘捐.\SQL匠下，對于不學同的數(shù)據(jù)庫茫，分別建立拆不同的子目逗錄，如規(guī)oracl倒e廢、牢sysba肚se、db糠2嘗等。公共菠SQL模文件直接放彼入黨…\SQL沖下即可，不肉同數(shù)據(jù)庫的閘特殊克SQL網(wǎng)分別放入對駁應的子目錄堅下。償2.3.莖5該發(fā)行文檔的期存放揭發(fā)行文檔是霧指產(chǎn)品交付鍋用戶使用所鴿必須的文件賞。包括：產(chǎn)織品可執(zhí)行文種件，用戶使啟用說明書，州聯(lián)機幫助（傳HLP）；鮮資源文件（踏BMP，I慎CO等），野環(huán)境配置文紗件等。輩以上文檔作治為制作發(fā)行牢盤的素材，妨放在REL耽EASE的多REL猴_SRC季目錄之下，丈制作好的發(fā)訓行盤放在R搖ELEAS愛E的嫂SETUP網(wǎng)目錄。啊2．4權限浮控制管理件為保障文檔掘的安全性，政一致性，以服及防止意外耗修改，必須域?qū)Σ煌奈募臋n設置不同忠的訪問權限段。激文檔權限類墨別：只讀權區(qū)限，讀寫權炒限。殲文檔類別：臺設計文檔，登源碼，發(fā)行棗文檔。概用戶類別：徒開發(fā)人員、質(zhì)測試人員、夠分析設計人罩員、項目滴經(jīng)理、配置梨管理員、安劫裝盤制作人耗員、問題及因需求管理人印員、用戶文村檔編寫人員額等。沾為了控制不琴同的使用權馳限，根據(jù)要興求在服務器斗上分別建立販不同的用戶診，針對不同童的配置項所愉在目錄分配俊不同的權限擱。貓為了便于湖管理，應以褲表格的形式沸列出人員與贊管理對象的瞇訪問關系（檢用戶權限清演單）。壘3．更新管擋理六（版本升級字）百3.裹1枯版本升級原絨則反版本升級應先嚴格納入版寺本管理的控美制之下。應胳當謹慎地控初制版本的升示級，保障高示版本的向下寬兼容性，或掀提供嚴格定獸義的升級方毛法。琴在下面幾種丹情況下，進勸行版本演化咬和升級：首1、當產(chǎn)品族發(fā)生重大修音改和改進時雷，主版本號遠加1。重大基修改和改進背包括：平臺遷移；糧開發(fā)工具的午遷移；紹體系結構的兼變遷。圖2、當產(chǎn)品使發(fā)生較小的應改進或修改縮時，次版本苦號可以加1程。硬3、對基于改動量比完較少的，如繭修改產(chǎn)品的平錯誤，可增育加內(nèi)部版本暗號。內(nèi)部版礦本號對用戶頭來說是不可帝見的，只對掙項目子部內(nèi)部版本杜控制有用。玉4、記錄版足本升級過程輸。每次版本仙升級，都要繼填寫版本升工級記錄表，樸記錄表樣例足如下：尾版本升級記秤錄表歉版本號衰發(fā)布日期賄修改文件諷問題簡要描高述竄發(fā)布責任人沸批準人傾備注說明：胳定版本號：琴記錄當前料發(fā)布的版本走。棒竄發(fā)布日期：荷該版本批準尿發(fā)布的日期哪。凱時修改文件：罷版本修改記介錄文件，一吼般為版本修繼改日志。沙3.拼2背莖新版本的發(fā)歐布鼓新版本的發(fā)浙布包括主版智本號和次版妖本號的升級鬧，一般不包禮括內(nèi)部版本轉(zhuǎn)號的升級。醫(yī)流程如下：笛根據(jù)項目進倡展情況，或際者根據(jù)用戶場需要進行發(fā)注布準備。記在指定目錄嫁中，根據(jù)本薦次發(fā)布的版鑒本號建立相揉應的子目錄蔑，將園curre籮nt或下的所有內(nèi)暗容拷貝至新杠建目錄下。養(yǎng)可在新建目彩錄下建立珍readm郊e.txt史，并加入相瓣應的內(nèi)容。抱readm己e.txt浸文件是記錄君該版本與上邀一版本的不之同，作過哪向些改動。格轎式樣例如下境：拿增加或修改謠功能多涉及源文件媽改動原因煩4．備份管娘理抬為了保證文貍檔的最大可貨恢復性，要潤隨時及定期組地進行備份領工作。隨時備份：除開發(fā)人員每丘天都要將自話已當日修改云的源文件在知本地機器上版進行備份。籍開發(fā)負責人挎每天要將所廚有源文件在怪本地機備份屑。波建議備份采抖用循環(huán)備份法。定期備份撇備份形式為推硬盤備份和挽光盤備份。針硬盤備份時虛，要備份在南獨立的硬盤躍上；光盤備拒份時，要將愁光盤存放在朽可靠的地方走。眠備份周期視秒各產(chǎn)品部、仇事業(yè)部的具腔體情況而定寧。如果處于輛開發(fā)階段，世每周應對所云有的源程序謊項進行備份幟，一般為每麻周周五；如別果處于其它刃階段，根據(jù)嚇具體情況而場定，但周期堅不能超過兩需周。身備份要由版閃本管理員負特責，備份原悟則應是保證鵲文檔的最大安可恢復性。仇對于歷史版佛本或某用戶興的特殊版本堤，如果無特岔殊原因不再祝進行修改的紋話，建議用合光盤進行備胞份，而且應臥有備份盤說雅明文件BA刑CKUP.爹TXT。該冰文件應該記課錄以下內(nèi)容挺：本次備份祝時間，備份監(jiān)內(nèi)容，執(zhí)行駝人。脹5．用戶版鴉本管理菜籃目前主要焦以做項目為遲主，是根據(jù)木客戶要求開袋發(fā)的程序?？癁榱烁玫亻W管理源程序箱，應為每一袖用戶建立一服個用戶版本蔥文件，該文限件應包含以蟲下內(nèi)容：用戶編號：用戶名稱：是軟件版本號誘：打開始使用時短間：聯(lián)系人：聯(lián)系：福用戶程序更芝改日志樣例江如下：四更改時間舞版本號干修改模塊名千稱感變更原因痰變更概述速軟件位置角變更人員扇備注說明：肅用戶購買軟苦件時要為該趣用戶建立一獵個包含上述潤內(nèi)容的一個柴用戶版本文鳴件，并填寫床有關數(shù)據(jù)。越用戶進行版創(chuàng)本更新時要沒求填寫該文跪件的版本變漿更記錄，用匪以反映用戶飼版本的變更談情況。厲6計．美研發(fā)部走統(tǒng)一管理階士段性斗版本得擺6枝.1非階段性麥版本的提交責到研發(fā)部示當各項目組密更新了新版瞇本以后，如依果次版本號炕發(fā)生改變，包各項目組配羊置管理員經(jīng)毫項目經(jīng)理批狼準后月要把次版本站修改的內(nèi)容援（已提交的內(nèi)容精分為毫修改的闖源碼、巧新的碰文檔和安裝咱盤喪）搬提交給研發(fā)奸部版本管理彼人員訴。妖脅6父.2馳階段性緞版本的發(fā)布哭到公司網(wǎng)站薪上般產(chǎn)品新版本原發(fā)布以后，歐及時草在軟件演示求環(huán)境中進行行更新。并且映新版本的特推色和特點要云在公司網(wǎng)站憐上進行寄發(fā)布，陰描述新版本打特色的文檔頂要由各項目桐組進行提供寧給項目部，詳經(jīng)項目部保京存后，文檔補提交給公司圈網(wǎng)站管理人尋員進行發(fā)布快，掃以便供其他鉆項目組和公儀司營銷人員店進行了解。賓皺6.3各項章目組新版本辭內(nèi)部及時備夸份。蛋亭研發(fā)部負自責進行所有鍛產(chǎn)品版本的宣管理，但各限個項目組也掌要自己進行王備份。豐7．版本工型具的使用免7.1懶研發(fā)部采用懸svn配置傻管理工具巴研發(fā)部采用諸專門的配置濁管低理服離務器，此服件務器只是專邪門用于版本蔽的管理，一岸般不用于其充他的應用，經(jīng)配置管理軟騙件摟采用svn籍1.5駛進行配置管吉理。央8．各項目婚組提交文檔續(xù)及源碼綁以及童規(guī)則速8.1各條項目養(yǎng)組意需要提交的雄文檔蘿名稱萌成果描述姻立項申請書園寫名此項目可的價值、所得需人力資源教及費用、可建行性分析、遠成本-效益添分析、風險螺分析磨立項評審報敞告砍評審結論、府評審建議育軟件城需求說明書您目標客戶、蛛業(yè)務流程、連系統(tǒng)中的角綁色、藍子慈功能模塊介智紹、茫質(zhì)量要求、脆界面要求典系統(tǒng)設計說卵明書貍系統(tǒng)約束、革開發(fā)環(huán)境、烘數(shù)據(jù)流程圖鳳、用例圖、慧模塊之間的圍關系圖、由類函數(shù)文件浴變量等命名牢規(guī)則杯、系統(tǒng)安全稱設計說明錢、性能分析腐數(shù)據(jù)庫設計糟說明書驕所有表名、客表設計、表煉ER圖、生必成庫的sq泊l語句、存膀儲過程等。嬌表及字段命考名規(guī)則。佛用戶界面設牽計說明