1、泰豪軟件研發版本管理規 v1.0（ 草案 ）研發部2009-2-4目錄文檔類別使用對象 31引言 41.1 目的 41.2 圍 41.3 術語定義 41.4 版序控制記錄 51.5 版本更新記錄 52版本管理 521 版本標識方法 521 1正式版本 622 目錄結構 623 文檔的存放 72.3.1 當前版本和歷史版本的存放 72.3.2 開發文檔的存放 72.3.3 源代碼的存放 72.3.4 SQL 語句的存放 72.3.5 發行文檔的存放 83更新管理（版本升級） 89101024 權限控制管理 83.1 版本升級原則 83.2 新版本的發布 94備份管理 5用戶版本管理 6研發部統一

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

3、公司研發版本管理而制定的1.2 圍本文檔為各產品部、事業部版本管理員提供有關版本管理規的相關容，包括： 版本標識方法軟件系統數據的存放文檔的修改控制文檔的備份制度1.3 術語定義SVNSvn是一個開源的版本控制系統Subversion的簡稱文檔 一種數據媒體和其上所記錄的數據。配置管理 標識和確定系統中配置項的過程，在系統整個生存周期控制這些項的投放和更動， 記錄并報告配置的狀態和更動要求，驗證配置項的完整性和正確性。軟件配置 軟件的具體形態在某時刻的瞬時影像。配置項 軟件配置管理的對象稱為配置項，如：系統規格說明書，項目開發計劃，用戶手冊，源碼。基線 軟件生存周期中各開發階段末尾的標記，它的

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

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

6、目錄二級目錄三級目錄對應配置項備注產品名稱 一體化平 臺版本號源碼（F:）核心 源碼 包jarClass文件源碼存目錄前正在修改的容擴展源碼包源碼sqlSQL文件版本變動說明文檔（G:）需求文檔用戶需求記 錄版本號在文件名上標識概要設計文檔 數據庫設計詳細設計文檔總體設計文檔按版本號依次類推測試用例測試記錄版本號在文件名上標識用戶手冊 產品說明書用戶使用手nn冊項目計劃項目計劃實施手冊實施手冊月度計劃月度計劃安裝盤（H：）REL SRCSETUP產品盤或發布文檔發布文檔表示正式版本及特殊版本的目錄按以下原則定義：(1) 正始版本：以“ V'開頭，版本號放后，主版本號和次主版本號之間的去

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

8、直接 交付使用的產品文件以及編譯產品所需的文件；聯機幫助文件HLP在未生成HLP文件之前的DOC RTF等格式的文檔也視為源代碼。各子系統當前的程序源文件放入相應的目錄下。對于一個子系統又分多個分子系統 的情況，應在該目錄下分別建立幾個相應的目錄。2.3.4 SQL語句的存放各子系統SQL文件放入.SQL下，對于不同的數據庫，分別建立不同的子目錄，如oracle、sysbase、db2等。公共SQL文件直接放入SQL下即可，不同數 據庫的特殊SQL分別放入對應的子目錄下。2.3.5 發行文檔的存放發行文檔是指產品交付用戶使用所必須的文件。包括：產品可執行文件，用戶使用 說明書，聯機幫助（HLP

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

10、列出人員與管理對象的訪問關系（用戶權限清單）3更新管理（版本升級）3.1 版本升級原則版本升級應嚴格納入版本管理的控制之下。應當謹慎地控制版本的升級，保障高版 本的向下兼容性，或提供嚴格定義的升級方法。在下面幾種情況下，進行版本演化和升級：1、當產品發生重大修改和改進時，主版本號加 1。重大修改和改進包括：1）平臺遷移;2）開發工具的遷移;3）體系結構的變遷。2、當產品發生較小的改進或修改時，次版本號可以加 1。3 、對于改動量比較少的，如修改產品的錯誤，可增加部版本號。部版本號對用戶 來說是不可見的，只對項目部部版本控制有用。4、記錄版本升級過程。 每次版本升級， 都要填寫版本升級記錄表，

11、記錄表樣例如下：版本升級記錄表版本號發布日期修改文件問題簡要描述發布責任人批準人備注說明：版本號：記錄當前發布的版本。發布日期：該版本批準發布的日期。修改文件：版本修改記錄文件，一般為版本修改日志。3.2新版本的發布新版本的發布包括主版本號和次版本號的升級，一般不包括部版本號的升級。流程 如下：1、根據項目進展情況，或者根據用戶需要進行發布準備。2、 在指定目錄中，根據本次發布的版本號建立相應的子目錄，將curre nt下的 所有容拷貝至新建目錄下。3、可在新建目錄下建立readme.txt，并加入相應的容。readme.txt文件是記錄該版本與上一版本的不同，作過哪些改動。格式樣例如下：增加

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

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

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

15、.3各項目組新版本部及時備份。研發部負責進行所有產品版本的管理，但各個項目組也要自己進行備份7. 版本工具的使用7.1研發部采用svn配置管理工具研發部采用專門的配置管理服務器，此服務器只是專門用于版本的管理，一般不用 于其他的應用，配置管理軟件采用 svn 1.5進行配置管理。&各項目組提交文檔及源碼以及規則8.1各項目組需要提交的文檔名稱成果描述立項申請書寫名此項目的價值、所需人力資源及費用、可行性分析、成 本-效益分析、風險分析立項評審報告評審結論、評審建議軟件需求說明書目標客戶、業務流程、系統中的角色、子功能模塊介紹、質 量要求、界面要求系統設計說明書系統約束、開發環境、數據流

16、程圖、用例圖、模塊之間的關 系圖、類函數文件變量等命名規則、系統安全設計說明、性 能分析數據庫設計說明書所有表名、表設計、表 ER圖、生成庫的sql語句、存儲過 程等。表及子段叩名規則。用戶界面設計說明書系統界面設計說明、原型圖模塊設計說明書編程的接口、主要的數據結構、主要算法測試用例用例名稱、用例描述、輸入值、希望輸出值缺陷報告Bug名稱、bug狀態、bug緊急情況、bug處理人等測試報告界面測試報告、性能測試報告部署說明書部署環境說明、初始化的數據、注意事項、數據的遷移等安裝和使用手冊安裝過程描述、各模塊使用手冊、FAQ手冊軟件源代碼源代碼、開發工具、API詳細說明、代碼注釋、編譯后程序系

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