1、泰豪軟件研發(fā)版本管理規(guī) v1.0（ 草案 ）研發(fā)部2009-2-4目錄文檔類別使用對(duì)象 31引言 41.1 目的 41.2 圍 41.3 術(shù)語(yǔ)定義 41.4 版序控制記錄 51.5 版本更新記錄 52版本管理 521 版本標(biāo)識(shí)方法 521 1正式版本 622 目錄結(jié)構(gòu) 623 文檔的存放 72.3.1 當(dāng)前版本和歷史版本的存放 72.3.2 開(kāi)發(fā)文檔的存放 72.3.3 源代碼的存放 72.3.4 SQL 語(yǔ)句的存放 72.3.5 發(fā)行文檔的存放 83更新管理（版本升級(jí)） 89101024 權(quán)限控制管理 83.1 版本升級(jí)原則 83.2 新版本的發(fā)布 94備份管理 5用戶版本管理 6研發(fā)部統(tǒng)一

2、管理階段性版本 6.1 階段性版本的提交到研發(fā)部 106.2 階段性版本的發(fā)布到公司上 116.3 各項(xiàng)目組新版本部及時(shí)備份。 117版本工具的使用 117.1研發(fā)部采用SVN配置管理工具11118各項(xiàng)目組提交文檔及源碼以及規(guī)則8.1 各項(xiàng)目組需要提交的文檔 118.2 目前所管理的產(chǎn)品列表 129周報(bào)管理制度 1210風(fēng)險(xiǎn)管理制度 13文檔類別使用對(duì)象文檔類別該文檔是為泰豪公司提供一個(gè)版本管理規(guī)性文件。使用對(duì)象該文檔使用對(duì)象為泰豪軟件公司研發(fā)本部各部門(mén)項(xiàng)目經(jīng)理及版本管理人員，以及其 他相關(guān)人員。未經(jīng)許可，該文檔不得提供給上述規(guī)定對(duì)象以外的人員閱讀或使用。1引言1.1 目的本文檔是為規(guī)泰豪軟件

3、公司研發(fā)版本管理而制定的1.2 圍本文檔為各產(chǎn)品部、事業(yè)部版本管理員提供有關(guān)版本管理規(guī)的相關(guān)容，包括： 版本標(biāo)識(shí)方法軟件系統(tǒng)數(shù)據(jù)的存放文檔的修改控制文檔的備份制度1.3 術(shù)語(yǔ)定義SVNSvn是一個(gè)開(kāi)源的版本控制系統(tǒng)Subversion的簡(jiǎn)稱文檔 一種數(shù)據(jù)媒體和其上所記錄的數(shù)據(jù)。配置管理 標(biāo)識(shí)和確定系統(tǒng)中配置項(xiàng)的過(guò)程，在系統(tǒng)整個(gè)生存周期控制這些項(xiàng)的投放和更動(dòng)， 記錄并報(bào)告配置的狀態(tài)和更動(dòng)要求，驗(yàn)證配置項(xiàng)的完整性和正確性。軟件配置 軟件的具體形態(tài)在某時(shí)刻的瞬時(shí)影像。配置項(xiàng) 軟件配置管理的對(duì)象稱為配置項(xiàng)，如：系統(tǒng)規(guī)格說(shuō)明書(shū)，項(xiàng)目開(kāi)發(fā)計(jì)劃，用戶手冊(cè)，源碼。基線 軟件生存周期中各開(kāi)發(fā)階段末尾的標(biāo)記，它的

4、作用是把各階段工作的劃分更加明確化，使本來(lái)連續(xù)的工作在這些點(diǎn)上斷開(kāi)，使之便于檢驗(yàn)和肯定階段成果。1.4版序控制記錄版序狀 態(tài)擬稿審核批準(zhǔn)發(fā)布日期1.0研發(fā)部洪、興 洪八09/11/181.5版本更新記錄*A -增加 M-修改 D -刪除版本/修訂版修改頁(yè)碼修改記錄修改人日期1.0初始版本2009/022.版本管理2. 1版本標(biāo)識(shí)方法為了使工作規(guī)化、統(tǒng)一化，各項(xiàng)目組實(shí)行的版本標(biāo)識(shí)管理方法分為：正式版本和特 殊版本。2. 1. 1正式版本公司在市場(chǎng)上發(fā)行的正規(guī)版本。以“V'開(kāi)頭，版本號(hào)放后。V前面增加項(xiàng)目名稱，版本號(hào)分3節(jié)：主版本號(hào)，次版 本號(hào)和部版本號(hào)，每節(jié)之間以小數(shù)點(diǎn)（）間隔。如表示主

5、版本號(hào)為2，次版本 號(hào)為0，部版本號(hào)為1。研發(fā)部控制主版本號(hào)和次版本號(hào)，各項(xiàng)目組控制部版本號(hào)。例 如：一體化平臺(tái)-平陰版V1.1.1 ,體化平臺(tái)為產(chǎn)品名稱，平陰版為版本名稱（平陰為具體項(xiàng)目名稱），為主版本號(hào)+次版本號(hào)+部版本號(hào)。2. 2目錄結(jié)構(gòu)由于各項(xiàng)目組的實(shí)際情況不同，目錄結(jié)構(gòu)很難統(tǒng)一，但為了能更好地管理各項(xiàng)目組 的文檔，建議可將被管理的配置項(xiàng)分為三大類：文檔類、源碼類及安裝盤(pán)類，這樣存放 比較清晰，有利于版本管理。至于二級(jí)目錄是以版本劃分，并根據(jù)制定的目錄結(jié)構(gòu)給出 文件級(jí)目錄清單（先給出源程序及文檔的文件級(jí)目錄清單，安裝盤(pán)的可以后再執(zhí)行）：。現(xiàn)以農(nóng)電平臺(tái)1.0的目錄結(jié)構(gòu)舉例如下：根目錄一級(jí)

6、目錄二級(jí)目錄三級(jí)目錄對(duì)應(yīng)配置項(xiàng)備注產(chǎn)品名稱 一體化平 臺(tái)版本號(hào)源碼（F:）核心 源碼 包jarClass文件源碼存目錄前正在修改的容擴(kuò)展源碼包源碼sqlSQL文件版本變動(dòng)說(shuō)明文檔（G:）需求文檔用戶需求記 錄版本號(hào)在文件名上標(biāo)識(shí)概要設(shè)計(jì)文檔 數(shù)據(jù)庫(kù)設(shè)計(jì)詳細(xì)設(shè)計(jì)文檔總體設(shè)計(jì)文檔按版本號(hào)依次類推測(cè)試用例測(cè)試記錄版本號(hào)在文件名上標(biāo)識(shí)用戶手冊(cè) 產(chǎn)品說(shuō)明書(shū)用戶使用手nn冊(cè)項(xiàng)目計(jì)劃項(xiàng)目計(jì)劃實(shí)施手冊(cè)實(shí)施手冊(cè)月度計(jì)劃月度計(jì)劃安裝盤(pán)（H：）REL SRCSETUP產(chǎn)品盤(pán)或發(fā)布文檔發(fā)布文檔表示正式版本及特殊版本的目錄按以下原則定義：(1) 正始版本：以“ V'開(kāi)頭，版本號(hào)放后，主版本號(hào)和次主版本號(hào)之間的去

7、掉，明細(xì)版本號(hào)之前加“-”。舉例如下：版本號(hào)目錄名V1.0V1.0V1.1V1.12. 3文檔的存放當(dāng)前版本和歷史版本的存放對(duì)于源碼文件，特別增加了一個(gè) Current目錄，存放當(dāng)前正在開(kāi)發(fā)與維護(hù)的源碼文 件，當(dāng)前未發(fā)布版本的所有數(shù)據(jù)都存放在下。一旦當(dāng)前版本正式發(fā)行，則當(dāng)前目錄被修改為相應(yīng)的歷史目錄。歷史版本是指已經(jīng)發(fā)行的版本，存放在相應(yīng)的版本目錄之下，一般不允許改動(dòng)。開(kāi)發(fā)文檔的存放根據(jù)各項(xiàng)目部自己的情況，將系統(tǒng)用戶需求記錄、總體設(shè)計(jì)文檔、詳細(xì)設(shè)計(jì)及數(shù)據(jù) 結(jié)構(gòu)文件、測(cè)試記錄、用戶手冊(cè)等放入相應(yīng)的目錄下。源代碼的存放源代碼包括如：java，jsp，BMP ICO等相關(guān)文件，是未經(jīng)編譯處理的、不能

8、直接 交付使用的產(chǎn)品文件以及編譯產(chǎn)品所需的文件；聯(lián)機(jī)幫助文件HLP在未生成HLP文件之前的DOC RTF等格式的文檔也視為源代碼。各子系統(tǒng)當(dāng)前的程序源文件放入相應(yīng)的目錄下。對(duì)于一個(gè)子系統(tǒng)又分多個(gè)分子系統(tǒng) 的情況，應(yīng)在該目錄下分別建立幾個(gè)相應(yīng)的目錄。2.3.4 SQL語(yǔ)句的存放各子系統(tǒng)SQL文件放入.SQL下，對(duì)于不同的數(shù)據(jù)庫(kù)，分別建立不同的子目錄，如oracle、sysbase、db2等。公共SQL文件直接放入SQL下即可，不同數(shù) 據(jù)庫(kù)的特殊SQL分別放入對(duì)應(yīng)的子目錄下。2.3.5 發(fā)行文檔的存放發(fā)行文檔是指產(chǎn)品交付用戶使用所必須的文件。包括：產(chǎn)品可執(zhí)行文件，用戶使用 說(shuō)明書(shū)，聯(lián)機(jī)幫助（HLP

9、;資源文件（BMP ICO等），環(huán)境配置文件等。以上文檔作為制作發(fā)行盤(pán)的素材，放在 RELEAS的REL_SR目錄之下，制作好的發(fā) 行盤(pán)放在RELEAS的 SETUPS錄。24 權(quán)限控制管理為保障文檔的安全性，一致性，以及防止意外修改，必須對(duì)不同的文檔設(shè)置不同的 訪問(wèn)權(quán)限。文檔權(quán)限類別：只讀權(quán)限，讀寫(xiě)權(quán)限。文檔類別：設(shè)計(jì)文檔，源碼，發(fā)行文檔。用戶類別：開(kāi)發(fā)人員、測(cè)試人員、分析設(shè)計(jì)人員、項(xiàng)目經(jīng)理、配置管理員、安裝盤(pán) 制作人員、問(wèn)題及需求管理人員、用戶文檔編寫(xiě)人員等。為了控制不同的使用權(quán)限，根據(jù)要求在服務(wù)器上分別建立不同的用戶，針對(duì)不同的 配置項(xiàng)所在目錄分配不同的權(quán)限。為了便于管理，應(yīng)以表格的形式

10、列出人員與管理對(duì)象的訪問(wèn)關(guān)系（用戶權(quán)限清單）3更新管理（版本升級(jí)）3.1 版本升級(jí)原則版本升級(jí)應(yīng)嚴(yán)格納入版本管理的控制之下。應(yīng)當(dāng)謹(jǐn)慎地控制版本的升級(jí)，保障高版 本的向下兼容性，或提供嚴(yán)格定義的升級(jí)方法。在下面幾種情況下，進(jìn)行版本演化和升級(jí)：1、當(dāng)產(chǎn)品發(fā)生重大修改和改進(jìn)時(shí)，主版本號(hào)加 1。重大修改和改進(jìn)包括：1）平臺(tái)遷移;2）開(kāi)發(fā)工具的遷移;3）體系結(jié)構(gòu)的變遷。2、當(dāng)產(chǎn)品發(fā)生較小的改進(jìn)或修改時(shí)，次版本號(hào)可以加 1。3 、對(duì)于改動(dòng)量比較少的，如修改產(chǎn)品的錯(cuò)誤，可增加部版本號(hào)。部版本號(hào)對(duì)用戶 來(lái)說(shuō)是不可見(jiàn)的，只對(duì)項(xiàng)目部部版本控制有用。4、記錄版本升級(jí)過(guò)程。 每次版本升級(jí)， 都要填寫(xiě)版本升級(jí)記錄表，

11、記錄表樣例如下：版本升級(jí)記錄表版本號(hào)發(fā)布日期修改文件問(wèn)題簡(jiǎn)要描述發(fā)布責(zé)任人批準(zhǔn)人備注說(shuō)明：版本號(hào)：記錄當(dāng)前發(fā)布的版本。發(fā)布日期：該版本批準(zhǔn)發(fā)布的日期。修改文件：版本修改記錄文件，一般為版本修改日志。3.2新版本的發(fā)布新版本的發(fā)布包括主版本號(hào)和次版本號(hào)的升級(jí)，一般不包括部版本號(hào)的升級(jí)。流程 如下：1、根據(jù)項(xiàng)目進(jìn)展情況，或者根據(jù)用戶需要進(jìn)行發(fā)布準(zhǔn)備。2、 在指定目錄中，根據(jù)本次發(fā)布的版本號(hào)建立相應(yīng)的子目錄，將curre nt下的 所有容拷貝至新建目錄下。3、可在新建目錄下建立readme.txt，并加入相應(yīng)的容。readme.txt文件是記錄該版本與上一版本的不同，作過(guò)哪些改動(dòng)。格式樣例如下：增加

12、或修改功能涉及源文件改動(dòng)原因4. 備份管理為了保證文檔的最大可恢復(fù)性，要隨時(shí)及定期地進(jìn)行備份工作。1、隨時(shí)備份：(1) 開(kāi)發(fā)人員每天都要將自已當(dāng)日修改的源文件在本地機(jī)器上進(jìn)行備份。(2) 開(kāi)發(fā)負(fù)責(zé)人每天要將所有源文件在本地機(jī)備份。(3) 建議備份采用循環(huán)備份。2、定期備份(1) 備份形式為硬盤(pán)備份和光盤(pán)備份。 硬盤(pán)備份時(shí)，要備份在獨(dú)立的硬盤(pán)上; 光盤(pán)備份時(shí)，要將光盤(pán)存放在可靠的地方。(2) 備份周期視各產(chǎn)品部、事業(yè)部的具體情況而定。如果處于開(kāi)發(fā)階段，每 周應(yīng)對(duì)所有的源程序項(xiàng)進(jìn)行備份，一般為每周周五；如果處于其它階段, 根據(jù)具體情況而定，但周期不能超過(guò)兩周。(3) 備份要由版本管理員負(fù)責(zé)，備份原

13、則應(yīng)是保證文檔的最大可恢復(fù)性。(4) 對(duì)于歷史版本或某用戶的特殊版本，如果無(wú)特殊原因不再進(jìn)行修改的話， 建議用光盤(pán)進(jìn)行備份，而且應(yīng)有備份盤(pán)說(shuō)明文件 BACKUP.TXT該文件應(yīng) 該記錄以下容：本次備份時(shí)間，備份容，執(zhí)行人。5. 用戶版本管理目前主要以做項(xiàng)目為主，是根據(jù)客戶要求開(kāi)發(fā)的程序。為了更好地管理源程序，應(yīng) 為每一用戶建立一個(gè)用戶版本文件，該文件應(yīng)包含以下容：用戶編號(hào)：用戶名稱：軟件版本號(hào)：開(kāi)始使用時(shí)間：聯(lián)系人：聯(lián)系：用戶程序更改日志樣例如下:更改 時(shí)間版本號(hào)修改模 塊名稱變更原因變更概述軟件位置變更 人員備注說(shuō)明：1) 用戶購(gòu)買軟件時(shí)要為該用戶建立一個(gè)包含上述容的一個(gè)用戶版本文件，并填寫(xiě)

14、 有關(guān)數(shù)據(jù)。2) 用戶進(jìn)行版本更新時(shí)要求填寫(xiě)該文件的版本變更記錄，用以反映用戶版本的變 更情況。6. 研發(fā)部統(tǒng)一管理階段性版本6.1階段性版本的提交到研發(fā)部當(dāng)各項(xiàng)目組更新了新版本以后，如果次版本號(hào)發(fā)生改變，各項(xiàng)目組配置管理員經(jīng)項(xiàng) 目經(jīng)理批準(zhǔn)后要把次版本修改的容(提交的容分為修改的源碼、新的文檔和安裝盤(pán))提 交給研發(fā)部版本管理人員。6.2階段性版本的發(fā)布到公司上產(chǎn)品新版本發(fā)布以后，及時(shí)在軟件演示環(huán)境中進(jìn)行更新。并且新版本的特色和特點(diǎn) 要在公司上進(jìn)行發(fā)布，描述新版本特色的文檔要由各項(xiàng)目組進(jìn)行提供給項(xiàng)目部，經(jīng)項(xiàng)目 部保存后，文檔提交給公司管理人員進(jìn)行發(fā)布，以便供其他項(xiàng)目組和公司營(yíng)銷人員進(jìn)行 了解。6

15、.3各項(xiàng)目組新版本部及時(shí)備份。研發(fā)部負(fù)責(zé)進(jìn)行所有產(chǎn)品版本的管理，但各個(gè)項(xiàng)目組也要自己進(jìn)行備份7. 版本工具的使用7.1研發(fā)部采用svn配置管理工具研發(fā)部采用專門(mén)的配置管理服務(wù)器，此服務(wù)器只是專門(mén)用于版本的管理，一般不用 于其他的應(yīng)用，配置管理軟件采用 svn 1.5進(jìn)行配置管理。&各項(xiàng)目組提交文檔及源碼以及規(guī)則8.1各項(xiàng)目組需要提交的文檔名稱成果描述立項(xiàng)申請(qǐng)書(shū)寫(xiě)名此項(xiàng)目的價(jià)值、所需人力資源及費(fèi)用、可行性分析、成 本-效益分析、風(fēng)險(xiǎn)分析立項(xiàng)評(píng)審報(bào)告評(píng)審結(jié)論、評(píng)審建議軟件需求說(shuō)明書(shū)目標(biāo)客戶、業(yè)務(wù)流程、系統(tǒng)中的角色、子功能模塊介紹、質(zhì) 量要求、界面要求系統(tǒng)設(shè)計(jì)說(shuō)明書(shū)系統(tǒng)約束、開(kāi)發(fā)環(huán)境、數(shù)據(jù)流

16、程圖、用例圖、模塊之間的關(guān) 系圖、類函數(shù)文件變量等命名規(guī)則、系統(tǒng)安全設(shè)計(jì)說(shuō)明、性 能分析數(shù)據(jù)庫(kù)設(shè)計(jì)說(shuō)明書(shū)所有表名、表設(shè)計(jì)、表 ER圖、生成庫(kù)的sql語(yǔ)句、存儲(chǔ)過(guò) 程等。表及子段叩名規(guī)則。用戶界面設(shè)計(jì)說(shuō)明書(shū)系統(tǒng)界面設(shè)計(jì)說(shuō)明、原型圖模塊設(shè)計(jì)說(shuō)明書(shū)編程的接口、主要的數(shù)據(jù)結(jié)構(gòu)、主要算法測(cè)試用例用例名稱、用例描述、輸入值、希望輸出值缺陷報(bào)告Bug名稱、bug狀態(tài)、bug緊急情況、bug處理人等測(cè)試報(bào)告界面測(cè)試報(bào)告、性能測(cè)試報(bào)告部署說(shuō)明書(shū)部署環(huán)境說(shuō)明、初始化的數(shù)據(jù)、注意事項(xiàng)、數(shù)據(jù)的遷移等安裝和使用手冊(cè)安裝過(guò)程描述、各模塊使用手冊(cè)、FAQ手冊(cè)軟件源代碼源代碼、開(kāi)發(fā)工具、API詳細(xì)說(shuō)明、代碼注釋、編譯后程序系

17、統(tǒng)維護(hù)記錄問(wèn)題描述、問(wèn)題解決情況技術(shù)評(píng)審報(bào)告評(píng)審容、評(píng)審結(jié)果、評(píng)審人系統(tǒng)安裝程序打包程序、打包工具、打包完以后的安裝程序8.2目前所管理的產(chǎn)品列表序列號(hào)產(chǎn)品名稱應(yīng)用圍所屬項(xiàng)目組產(chǎn)品介紹1一體化平臺(tái)Sg186農(nóng)電農(nóng)電2安全性評(píng)價(jià)系統(tǒng)電網(wǎng)安全性 評(píng)價(jià)調(diào)度3電網(wǎng)調(diào)度專業(yè)技術(shù) 安全知識(shí)在線調(diào)考 系統(tǒng)（網(wǎng)省版）電網(wǎng)調(diào)度4電網(wǎng)現(xiàn)場(chǎng)標(biāo)準(zhǔn)化作 業(yè)系統(tǒng)電網(wǎng)調(diào)度5國(guó)調(diào)E語(yǔ)言編輯瀏 覽器電網(wǎng)調(diào)度6省電力公司生產(chǎn)安 全管理系統(tǒng)電網(wǎng)調(diào)度7省電力公司電網(wǎng)輸電GIS電網(wǎng)調(diào)度8一體化 OMS項(xiàng)目建 設(shè)電網(wǎng)調(diào)度9生產(chǎn)管理系統(tǒng)短信 平臺(tái)電網(wǎng)調(diào)度10泰豪EOMP業(yè)務(wù)基礎(chǔ) 平臺(tái)電網(wǎng)調(diào)度11泰豪圖形化智能操 作票系統(tǒng)電網(wǎng)調(diào)度9. 周報(bào)管理制度各項(xiàng)目組每周向研發(fā)部提交周報(bào)。周報(bào)具體的格式如下:項(xiàng)目周報(bào)報(bào)告名稱所屬項(xiàng)目