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

1、泰豪軟件研發(fā)版本管理規(guī)范v1.0(草案)研發(fā)部2009-2-44目錄TOC o 1-3文檔類別使使用對象象 PAGEREF _Toc222026166 h 31引言 PAGEREF _Toc222026167 h 41.1目的的 PAGEREF _Toc222026168 h 41.2范圍圍 PAGEREF _Toc222026169 h 41.3術(shù)語語定義 PAGEREF _Toc222026170 h 41.4版序序控制記記錄 PAGEREF _Toc222026171 h 51.5版本本更新記記錄 PAGEREF _Toc222026172 h 52版本管管理 PAGEREF _Toc2

2、22026173 h 521版本本標(biāo)識方方法 PAGEREF _Toc222026174 h 52111正式版版本 PAGEREF _Toc222026175 h 522目錄錄結(jié)構(gòu) PAGEREF _Toc222026176 h 623文檔檔的存放放 PAGEREF _Toc222026177 h 72.3.11 當(dāng)前前版本和和歷史版版本的存存放 PAGEREF _Toc222026178 h 72.3.22 開發(fā)發(fā)文檔的的存放 PAGEREF _Toc222026179 h 72.3.33 源代代碼的存存放 PAGEREF _Toc222026180 h 72.3.44 SQQL語句句的存放

3、放 PAGEREF _Toc222026181 h 72.3.55發(fā)行文文檔的存存放 PAGEREF _Toc222026182 h 724權(quán)限限控制管管理 PAGEREF _Toc222026183 h 83更新管管理（版版本升級級） PAGEREF _Toc222026184 h 83.1版本本升級原原則 PAGEREF _Toc222026185 h 83.2 新新版本的的發(fā)布 PAGEREF _Toc222026186 h 94備份管管理 PAGEREF _Toc222026187 h 95用戶版版本管理理 PAGEREF _Toc222026188 h 106研發(fā)部部統(tǒng)一管管理階段段

4、性版本本 PAGEREF _Toc222026189 h 106.1階段段性版本本的提交交到研發(fā)發(fā)部 PAGEREF _Toc222026190 h 106.2階段段性版本本的發(fā)布布到公司司網(wǎng)站上上 PAGEREF _Toc222026191 h 106.3各項項目組新新版本內(nèi)內(nèi)部及時時備份。 PAGEREF _Toc222026192 h 117版本工工具的使使用 PAGEREF _Toc222026193 h 117.1研發(fā)發(fā)部采用用svnn配置管管理工具具 PAGEREF _Toc222026194 h 118各項目目組提交交文檔及及源碼以以及規(guī)則則 PAGEREF _Toc222026

5、195 h 118.1 各各項目組組需要提提交的文文檔 PAGEREF _Toc222026196 h 118.2目前前所管理理的產(chǎn)品品列表 PAGEREF _Toc222026197 h 129周報管管理制度度 PAGEREF _Toc222026198 h 1210風(fēng)險險管理制制度 PAGEREF _Toc222026199 h 13文檔類別使使用對象象文檔類別該文檔是為為泰豪公司司提供一一個版本本管理規(guī)規(guī)范性文文件。使用對象該文檔使用用對象為為泰豪軟軟件公司司研發(fā)本本部各部部門項目目經(jīng)理及及版本管管理人員員，以及及其他相相關(guān)人員員。未經(jīng)經(jīng)許可，該該文檔不不得提供供給上述述規(guī)定對對象以外外

6、的人員員閱讀或或使用。 1引言1.1目的的本文檔是為為規(guī)范泰泰豪軟件件公司研研發(fā)版本本管理而而制定的的。1.2范圍圍本文檔為各各產(chǎn)品部部、事業(yè)業(yè)部版本本管理員員提供有有關(guān)版本本管理規(guī)規(guī)范的相相關(guān)內(nèi)容容，包括括：版本標(biāo)識方方法軟件系統(tǒng)數(shù)數(shù)據(jù)的存存放文檔的修改改控制文檔的備份份制度1.3術(shù)語語定義SVNSvn是一一個開源源的版本本控制系系統(tǒng)Suubveersiion的的簡稱文檔一種數(shù)據(jù)據(jù)媒體和和其上所所記錄的的數(shù)據(jù)。配置管理標(biāo)識和確定定系統(tǒng)中中配置項項的過程程，在系系統(tǒng)整個個生存周周期內(nèi)控控制這些些項的投投放和更更動，記記錄并報報告配置置的狀態(tài)態(tài)和更動動要求，驗驗證配置置項的完完整性和和正確性性。

7、軟件配置軟件的具體體形態(tài)在在某時刻刻的瞬時時影像。配置項 軟件配配置管理理的對象象稱為配配置項，如如：系統(tǒng)統(tǒng)規(guī)格說說明書，項項目開發(fā)發(fā)計劃，用用戶手冊冊，源碼碼?；€ 軟件生生存周期期中各開開發(fā)階段段末尾的的標(biāo)記，它它的作用用是把各各階段工工作的劃劃分更加加明確化化，使本本來連續(xù)續(xù)的工作作在這些些點上斷斷開，使使之便于于檢驗和和肯定階階段成果果。1.4版序序控制記記錄版序狀態(tài)擬稿審核批準(zhǔn)發(fā)布日期1.0研發(fā)部 張張洪興09/111/1881.5版本本更新記記錄*A - 增加 M - 修改 D - 刪除版本/修訂訂版修改頁碼修改記錄修改人日期1.0初始版本2009/022版本管管理21版本本標(biāo)識方

8、方法為了使工作作規(guī)范化化、統(tǒng)一一化，各各項目組組實行的的版本標(biāo)標(biāo)識管理理方法分分為：正正式版本本和特殊殊版本。2111正式版版本 公司司在市場場上發(fā)行行的正規(guī)規(guī)版本。以“V”開開頭，版版本號放放后。VV前面增增加項目目名稱，版本號分3節(jié)：主版本號，次版本號和內(nèi)部版本號，每節(jié)之間以小數(shù)點（.）間隔。如V2.0.1表示主版本號為2，次版本號為0，內(nèi)部版本號為1。研發(fā)部控制主版本號和次版本號，各項目組控制內(nèi)部版本號。例如：一體化平臺-平陰版v1.1.1 , 一體化平臺為產(chǎn)品名稱，平陰版為版本名稱（平陰為具體項目名稱），v1.1.1為主版本號+次版本號+內(nèi)部版本號。22目錄錄結(jié)構(gòu)由于各項目目組的實實際

9、情況況不同，目目錄結(jié)構(gòu)構(gòu)很難統(tǒng)統(tǒng)一，但但為了能能更好地地管理各各項目組組的文檔檔，建議議可將被被管理的的配置項項分為三三大類：文檔類類、源碼碼類及安安裝盤類類，這樣樣存放比比較清晰晰，有利利于版本本管理。至至于二級級目錄是是以版本本劃分，并并根據(jù)制制定的目目錄結(jié)構(gòu)構(gòu)給出文文件級目目錄清單單（先給給出源程程序及文文檔的文文件級目目錄清單單，安裝裝盤的可可以后再再執(zhí)行）：?，F(xiàn)以農(nóng)電平平臺1.0的目目錄結(jié)構(gòu)構(gòu)舉例如如下：根目錄一級目錄二級目錄三級目錄對應(yīng)配置項項備注產(chǎn)品名稱一體化平臺臺版本號源碼(F:)核心源碼包包jar源碼存目錄前正正在修改改的內(nèi)容容Classs文件擴(kuò)展源碼包包源碼sqlSQL文件

10、件版本變動說說明文檔(G:)需求文檔用戶需求記記錄版本號在文文件名上上標(biāo)識概要設(shè)計文文檔總體設(shè)計文文檔按版本號依依次類推推數(shù)據(jù)庫設(shè)計計詳細(xì)設(shè)計文文檔測試用例測試記錄版本號在文文件名上上標(biāo)識用戶手冊用戶使用手手冊產(chǎn)品說明書書項目計劃項目計劃實施手冊實施手冊月度計劃月度計劃安裝盤(HH:)REL_SSRC產(chǎn)品盤或發(fā)布文檔檔SETUPP發(fā)布文檔表示正式版版本及特特殊版本本的目錄錄按以下下原則定定義：正始版本：以“V”開頭，版版本號放放后，主主版本號號和次主主版本號號之間的的“.”去掉，明明細(xì)版本本號之前前加“-”。舉例例如下：版本號 目錄錄名V1.0 V11.0V1.1 V11.1V1.0.1 V1

11、1.0.1V1.1.2 V11.1.223文檔檔的存放放2.3.11 當(dāng)前版版本和歷歷史版本本的存放放對于源碼文文件，特特別增加加了一個個Currrennt目錄錄，存放放當(dāng)前正正在開發(fā)發(fā)與維護(hù)護(hù)的源碼碼文件，當(dāng)當(dāng)前未發(fā)發(fā)布版本本的所有有數(shù)據(jù)都都存放在在CURRRENNT下下。一旦旦當(dāng)前版版本正式式發(fā)行，則則當(dāng)前目目錄被修修改為相相應(yīng)的歷歷史目錄錄。歷史版本是是指已經(jīng)經(jīng)發(fā)行的的版本，存存放在相相應(yīng)的版版本目錄錄之下，一一般不允允許改動動。2.3.22 開發(fā)文文檔的存存放根據(jù)各項目目部自己己的情況況，將系系統(tǒng)用戶戶需求記記錄、總總體設(shè)計計文檔、詳詳細(xì)設(shè)計計及數(shù)據(jù)據(jù)結(jié)構(gòu)文文件、測測試記錄錄、用戶戶手

12、冊等等放入相相應(yīng)的目目錄下。2.3.33 源代代碼的存存放源代碼包括括如：jjavaa，jspp，BMMP，IICO等等相關(guān)文文件，是是未經(jīng)編編譯處理理的、不不能直接接交付使使用的產(chǎn)產(chǎn)品文件件以及編編譯產(chǎn)品品所需的的文件；聯(lián)機(jī)幫幫助文件件HLPP在未生生成HLLP文件件之前的的DOCC，RTTF等格格式的文文檔也視視為源代代碼。各子系統(tǒng)當(dāng)當(dāng)前的程程序源文文件放入入相應(yīng)的的目錄下下。對于于一個子子系統(tǒng)又又分多個個分子系系統(tǒng)的情情況，應(yīng)應(yīng)在該目目錄下分分別建立立幾個相相應(yīng)的目目錄。2.3.44 SQQL語句句的存放放各子系統(tǒng)SSQL文文件放入入.SQLL下，對對于不同同的數(shù)據(jù)據(jù)庫，分分別建立立不同

13、的的子目錄錄，如ooraccle、syssbasse、ddb2等等。公共共SQLL文件直直接放入入SSQL下下即可，不不同數(shù)據(jù)據(jù)庫的特特殊SQQL分別別放入對對應(yīng)的子子目錄下下。2.3.55發(fā)行文文檔的存存放發(fā)行文檔是是指產(chǎn)品品交付用用戶使用用所必須須的文件件。包括括：產(chǎn)品品可執(zhí)行行文件，用用戶使用用說明書書，聯(lián)機(jī)機(jī)幫助（HHLP）；資源文文件（BBMP，IICO等等），環(huán)環(huán)境配置置文件等等。以上文檔作作為制作作發(fā)行盤盤的素材材，放在在RELLEASSE的RREL_SRCC目錄之之下，制制作好的的發(fā)行盤盤放在RRELEEASEE的SEETUPP目錄。24權(quán)限限控制管管理為保障文檔檔的安全全性，

14、一一致性，以以及防止止意外修修改，必必須對不不同的文文檔設(shè)置置不同的的訪問權(quán)權(quán)限。文檔權(quán)限類類別：只只讀權(quán)限限，讀寫寫權(quán)限。文檔類別：設(shè)計文文檔，源源碼，發(fā)發(fā)行文檔檔。用戶類別：開發(fā)人人員、測測試人員員、分析析設(shè)計人人員、項項目經(jīng)理理、配置置管理員員、安裝裝盤制作作人員、問問題及需需求管理理人員、用用戶文檔檔編寫人人員等。為了控制不不同的使使用權(quán)限限，根據(jù)據(jù)要求在在服務(wù)器器上分別別建立不不同的用用戶，針針對不同同的配置置項所在在目錄分分配不同同的權(quán)限限。為了便于管管理，應(yīng)應(yīng)以表格格的形式式列出人人員與管管理對象象的訪問問關(guān)系（用用戶權(quán)限限清單）。3更新管管理（版版本升級級）3.1版本本升級原原

15、則版本升級應(yīng)應(yīng)嚴(yán)格納納入版本本管理的的控制之之下。應(yīng)應(yīng)當(dāng)謹(jǐn)慎慎地控制制版本的的升級，保保障高版版本的向向下兼容容性，或或提供嚴(yán)嚴(yán)格定義義的升級級方法。在下面幾種種情況下下，進(jìn)行行版本演演化和升升級：1、當(dāng)產(chǎn)品品發(fā)生重重大修改改和改進(jìn)進(jìn)時，主主版本號號加1。重重大修改改和改進(jìn)進(jìn)包括：平臺遷移；開發(fā)工具的的遷移；體系結(jié)構(gòu)的的變遷。2、當(dāng)產(chǎn)品品發(fā)生較較小的改改進(jìn)或修修改時，次次版本號號可以加加1。 3、對對于改動動量比較較少的，如如修改產(chǎn)產(chǎn)品的錯錯誤，可可增加內(nèi)內(nèi)部版本本號。內(nèi)內(nèi)部版本本號對用用戶來說說是不可可見的，只只對項目目部內(nèi)部部版本控控制有用用。4、記錄版版本升級級過程。每每次版本本升級，都

16、都要填寫寫版本升升級記錄錄表，記記錄表樣樣例如下下：版本升級記記錄表版本號發(fā)布日期修改文件問題簡要描描述發(fā)布責(zé)任人人批準(zhǔn)人備注說明： 版本號號： 記錄當(dāng)當(dāng)前發(fā)布布的版本本。 發(fā)布日日期：該該版本批批準(zhǔn)發(fā)布布的日期期。 修改文文件：版版本修改改記錄文文件，一一般為版版本修改改日志。3.2 新新版本的的發(fā)布新版本的發(fā)發(fā)布包括括主版本本號和次次版本號號的升級級，一般般不包括括內(nèi)部版版本號的的升級。流流程如下下：根據(jù)項目進(jìn)進(jìn)展情況況，或者者根據(jù)用用戶需要要進(jìn)行發(fā)發(fā)布準(zhǔn)備備。在指定目錄錄中，根根據(jù)本次次發(fā)布的的版本號號建立相相應(yīng)的子子目錄，將將currrennt下的的所有內(nèi)內(nèi)容拷貝貝至新建建目錄下下?？?/p>

17、在新建目目錄下建建立reeadmme.ttxt，并并加入相相應(yīng)的內(nèi)內(nèi)容。readmme.ttxt文文件是記記錄該版版本與上上一版本本的不同同，作過過哪些改改動。格格式樣例例如下： 增加或修改改功能涉及源文件件改動原因4備份管管理為了保證文文檔的最最大可恢恢復(fù)性，要要隨時及及定期地地進(jìn)行備備份工作作。隨時備份：開發(fā)人員每每天都要要將自已已當(dāng)日修修改的源源文件在在本地機(jī)機(jī)器上進(jìn)進(jìn)行備份份。開發(fā)負(fù)責(zé)人人每天要要將所有有源文件件在本地地機(jī)備份份。建議備份采采用循環(huán)環(huán)備份。定期備份備份形式為為硬盤備備份和光光盤備份份。硬盤盤備份時時，要備備份在獨獨立的硬硬盤上；光盤備備份時，要要將光盤盤存放在在可靠的的

18、地方。備份周期視視各產(chǎn)品品部、事事業(yè)部的的具體情情況而定定。如果果處于開開發(fā)階段段，每周周應(yīng)對所所有的源源程序項項進(jìn)行備備份，一一般為每每周周五五；如果果處于其其它階段段，根據(jù)據(jù)具體情情況而定定，但周周期不能能超過兩兩周。備份要由版版本管理理員負(fù)責(zé)責(zé)，備份份原則應(yīng)應(yīng)是保證證文檔的的最大可可恢復(fù)性性。對于歷史版版本或某某用戶的的特殊版版本，如如果無特特殊原因因不再進(jìn)進(jìn)行修改改的話，建建議用光光盤進(jìn)行行備份，而而且應(yīng)有有備份盤盤說明文文件BAACKUUP.TTXT。該該文件應(yīng)應(yīng)該記錄錄以下內(nèi)內(nèi)容：本本次備份份時間，備備份內(nèi)容容，執(zhí)行行人。5用戶版版本管理理目前主要要以做項項目為主主，是根根據(jù)客戶戶

19、要求開開發(fā)的程程序。為為了更好好地管理理源程序序，應(yīng)為為每一用用戶建立立一個用用戶版本本文件，該該文件應(yīng)應(yīng)包含以以下內(nèi)容容：用戶編號：用戶名稱：軟件版本號號：開始使用時時間：聯(lián)系人：聯(lián)系電話：用戶程序更更改日志志樣例如如下：更改時間版本號修改模塊名名稱變更原因變更概述軟件位置變更人員備注說明：用戶購買軟軟件時要要為該用用戶建立立一個包包含上述述內(nèi)容的的一個用用戶版本本文件，并并填寫有有關(guān)數(shù)據(jù)據(jù)。用戶進(jìn)行版版本更新新時要求求填寫該該文件的的版本變變更記錄錄，用以以反映用用戶版本本的變更更情況。6研發(fā)部部統(tǒng)一管管理階段段性版本本 6.11階段性性版本的的提交到到研發(fā)部部當(dāng)各項目組組更新了了新版本本

20、以后，如如果次版版本號發(fā)發(fā)生改變變，各項項目組配配置管理理員經(jīng)項項目經(jīng)理理批準(zhǔn)后后要把次次版本修修改的內(nèi)內(nèi)容（提提交的內(nèi)內(nèi)容分為為修改的的源碼、新新的文檔檔和安裝裝盤）提交給給研發(fā)部部版本管管理人員員。 6.22階段性性版本的的發(fā)布到到公司網(wǎng)網(wǎng)站上產(chǎn)品新版本本發(fā)布以以后，及及時在軟軟件演示示環(huán)境中中進(jìn)行更更新。并并且新版版本的特特色和特特點要在在公司網(wǎng)網(wǎng)站上進(jìn)進(jìn)行發(fā)布布，描述述新版本本特色的的文檔要要由各項項目組進(jìn)進(jìn)行提供供給項目目部，經(jīng)經(jīng)項目部部保存后后，文檔檔提交給給公司網(wǎng)網(wǎng)站管理理人員進(jìn)進(jìn)行發(fā)布布，以便便供其他他項目組組和公司司營銷人人員進(jìn)行行了解。 6.33各項目目組新版版本內(nèi)部部及時

21、備備份。 研研發(fā)部負(fù)負(fù)責(zé)進(jìn)行行所有產(chǎn)產(chǎn)品版本本的管理理，但各各個項目目組也要要自己進(jìn)進(jìn)行備份份。7版本工工具的使使用7.1研發(fā)發(fā)部采用用svnn配置管管理工具具研發(fā)部采用用專門的的配置管管理服務(wù)器器，此服服務(wù)器只只是專門門用于版版本的管管理，一一般不用用于其他他的應(yīng)用用，配置置管理軟軟件采用用svnn1.55進(jìn)行配配置管理理。8各項目目組提交交文檔及及源碼以以及規(guī)則則8.1 各各項目組組需要提提交的文文檔名稱成果描述立項申請書書寫名此項目目的價值值、所需需人力資資源及費費用、可可行性分分析、成成本-效效益分析析、風(fēng)險險分析立項評審報報告評審結(jié)論、評評審建議議軟件需求說說明書目標(biāo)客戶、業(yè)業(yè)務(wù)流程

22、程、系統(tǒng)統(tǒng)中的角角色、子子功能模模塊介紹紹、質(zhì)量量要求、界界面要求求系統(tǒng)設(shè)計說說明書系統(tǒng)約束、開開發(fā)環(huán)境境、數(shù)據(jù)據(jù)流程圖圖、用例例圖、模模塊之間間的關(guān)系系圖、類類函數(shù)文文件變量量等命名名規(guī)則、系系統(tǒng)安全全設(shè)計說說明、性性能分析析數(shù)據(jù)庫設(shè)計計說明書書所有表名、表表設(shè)計、表表ER圖圖、生成成庫的ssql語語句、存存儲過程程等。表表及字段段命名規(guī)規(guī)則。用戶界面設(shè)設(shè)計說明明書系統(tǒng)界面設(shè)設(shè)計說明明、原型型圖模塊設(shè)計說說明書編程的接口口、主要要的數(shù)據(jù)據(jù)結(jié)構(gòu)、主主要算法法測試用例用例名稱、用用例描述述、輸入入值、希希望輸出出值缺陷報告Bug名稱稱、buug狀態(tài)態(tài)、buug緊急急情況、bbug處處理人等等測試報告界面測試報報告、性性能測試試報告部署說明書書部署環(huán)境說說明、初初始化的的數(shù)據(jù)、注注意事項項、數(shù)據(jù)據(jù)的遷移移等安裝和使用用手冊安裝過程描描述、各各模塊使使用手冊冊、FAAQ手冊冊軟件源代碼碼源代碼、開開發(fā)工