版本配置管理規(guī)范20151120

1、+研發(fā)過(guò)程管理規(guī)定版本配置管理規(guī)范深圳市艾派應(yīng)用系統(tǒng)有限公司Shenzhen iPi Application System Co.,Ltd.目 錄1.概述7目標(biāo)范圍7定義7角色及職責(zé)7版本管理員7項(xiàng)目經(jīng)理8開發(fā)人員8測(cè)試人員8測(cè)試部82.版本號(hào)管理規(guī)范8版本號(hào)規(guī)定9版本號(hào)變化基本原則9項(xiàng)目版本號(hào)變化9模塊版本號(hào)變化9項(xiàng)目與模塊版本號(hào)的一致性原則9版本號(hào)變化監(jiān)管10模塊補(bǔ)丁原則10適用范圍10基本原則103.文檔管理（提交）規(guī)范10模塊文檔10修改說(shuō)明10配置說(shuō)明11升級(jí)說(shuō)明12編譯及運(yùn)行環(huán)境說(shuō)明12全局文檔134.數(shù)據(jù)庫(kù)模塊提交規(guī)范135.發(fā)布(歸檔)庫(kù)管理規(guī)范15發(fā)布庫(kù)結(jié)構(gòu)15權(quán)限管理要求1

2、5發(fā)布庫(kù)檢查要求156.版本各過(guò)程管理規(guī)范16版本構(gòu)建要求16構(gòu)建腳本規(guī)則16構(gòu)建任務(wù)要求16版本提交要求17提交內(nèi)容17提交路徑17提交檢查17版本測(cè)試及回歸要求18布署版本及冒煙測(cè)試18退回重新提交18回歸測(cè)試及提交18版本發(fā)布/歸檔要求18歸檔內(nèi)容19歸檔路徑19歸檔說(shuō)明19發(fā)布要求19版本備份要求20版本獲取要求207.附錄20附錄：版本號(hào)編碼規(guī)范及示例20版本號(hào)編碼規(guī)范20項(xiàng)目版本號(hào)示例22補(bǔ)丁包及補(bǔ)丁編碼示例22附錄：源碼歸檔規(guī)范23C工程目錄設(shè)置：23JAVA工程目錄設(shè)置：25WEB工程目錄設(shè)置25版本號(hào)文件存放路徑26附錄配置庫(kù)(SVN)結(jié)構(gòu)及管理參考27總結(jié)構(gòu)27配置項(xiàng)內(nèi)容2

3、7配置項(xiàng)命名27配置項(xiàng)使用要求28配置庫(kù)存放文件類型及大小規(guī)定28代碼提交及獲取要求29附錄代碼提交操作說(shuō)明29操作方式一：項(xiàng)目的各模塊在本地已經(jīng)有關(guān)聯(lián)的路徑29操作方式二：項(xiàng)目的各模塊在本地?zé)o關(guān)聯(lián)的路徑31附錄版本構(gòu)建操作說(shuō)明34配置構(gòu)建任務(wù)34版本正式構(gòu)建36修訂記錄日期修訂版本描述作者2005-1-24發(fā)布研發(fā)過(guò)程管理小組2005-9-22修改研發(fā)過(guò)程管理小組2005-09-28修改研發(fā)過(guò)程管理小組2006-06-15修改研發(fā)過(guò)程管理小組2007-08-08修訂邱容珍2008-05-081.5修訂內(nèi)容：1. 修訂了關(guān)于需求文檔/設(shè)計(jì)文檔等大類文檔在測(cè)試庫(kù)的存檔目錄說(shuō)明，修訂了測(cè)試庫(kù)的目錄

4、結(jié)構(gòu)。2. 強(qiáng)調(diào)了關(guān)于末版本號(hào)的變化規(guī)則3. 修改了補(bǔ)丁版本號(hào)的命名規(guī)則4. 強(qiáng)調(diào)了關(guān)于項(xiàng)目經(jīng)理對(duì)歸檔庫(kù)檢查的規(guī)則5. 強(qiáng)調(diào)了關(guān)于測(cè)試人員對(duì)版本及時(shí)歸檔的規(guī)則6. 修訂了版本庫(kù)備份的規(guī)則邱容珍2008-06-121.61. 去掉了對(duì)開發(fā)人員開放測(cè)試庫(kù)權(quán)限不允許check out及check in的說(shuō)明2. 關(guān)于修改說(shuō)明面對(duì)的對(duì)象進(jìn)行了說(shuō)明。3. 對(duì)于開發(fā)文檔、測(cè)試文檔、用戶文檔的提交歸檔進(jìn)行了說(shuō)明。邱容珍2008-10-251.7.01. 對(duì)公司項(xiàng)目開展模式、定義，生命周期以及涉及到的術(shù)語(yǔ)進(jìn)行了明確。2. 對(duì)版本號(hào)結(jié)構(gòu)進(jìn)行了明確。3. 對(duì)文檔的歸檔及明確要求進(jìn)行了說(shuō)明。4. 對(duì)部分管理流程增加

5、了流程圖。邱容珍2009-08-05關(guān)于開發(fā)獲取版本的流程明確邱容珍2011-3-31增加邱容珍2011-11-15針對(duì)研發(fā)部對(duì)于版本上線流程中的版本號(hào)編碼規(guī)范不清增加的示例說(shuō)明邱容珍2013-08-132013-10-302.0.合并SVN管理的相關(guān)要求，對(duì)版本配置管理規(guī)范全部升級(jí)；包括如下：1. 文檔結(jié)構(gòu)調(diào)整；2. 版本號(hào)變化規(guī)則；3. 模塊文檔的書寫要求；4. 數(shù)據(jù)庫(kù)腳本提交要求；5. 歸檔相關(guān)要求；6. 發(fā)布庫(kù)權(quán)限管理要求；邱容珍2015-11-03根據(jù)實(shí)際執(zhí)行修改如下內(nèi)容1. 去掉歸檔中的按模塊歸檔。2. 去掉補(bǔ)丁包概念。3. 增加數(shù)據(jù)庫(kù)提交完整腳本的說(shuō)明及結(jié)構(gòu)邱容珍1. 概述本規(guī)定

6、制定與實(shí)施目的是為了規(guī)范公司項(xiàng)目的版本管理，明確公司項(xiàng)目在版本規(guī)劃、版本號(hào)確定、版本提交、版本測(cè)試、版本歸檔和版本發(fā)布等方面的流程和要求，以及研發(fā)體系在版本管理中的職責(zé)和配合關(guān)系等，保證版本管理的有序、高效進(jìn)行，以及版本的存儲(chǔ)正確、完整、安全和清晰等。1.1 目標(biāo)范圍n 規(guī)范流程、保證規(guī)劃統(tǒng)一、保障版本安全、考核過(guò)程以及行為n 貫穿研發(fā)生命周期中的所有過(guò)程以及成果管理。1.2 定義本規(guī)范中涉及的術(shù)語(yǔ)為如下：項(xiàng)目、模塊、補(bǔ)丁包及模塊補(bǔ)??；其中補(bǔ)丁包、模塊補(bǔ)丁都發(fā)生在項(xiàng)目基礎(chǔ)版本上線之后階段。項(xiàng)目：利用有限的資源為客戶完成包括業(yè)務(wù)解決方案定制、硬件設(shè)備安裝、應(yīng)用軟件開發(fā)、維護(hù)服務(wù)等在內(nèi)的系統(tǒng)集成工

7、作，達(dá)到客戶某一業(yè)務(wù)開展目標(biāo)的一系列工作。模塊：實(shí)現(xiàn)項(xiàng)目的特定功能的集合，是組成產(chǎn)品中的一部分，但它一般不能獨(dú)立滿足客戶的需求。補(bǔ)丁包：指實(shí)現(xiàn)某一局部改良需求的而修改的軟件成果的集合，它一般包括一個(gè)或多個(gè)模塊和模塊補(bǔ)丁。模塊補(bǔ)?。褐羔槍?duì)某模塊進(jìn)行局部修訂，并且不是以模塊整體更新的方式，而是以修補(bǔ)的方式提供的修訂成果。模塊補(bǔ)丁通常使用在WEB或數(shù)據(jù)庫(kù)模塊中。 1.3 角色及職責(zé)版本管理過(guò)程參與的角色，包括研發(fā)部及測(cè)試部，各自在版本管理中的職責(zé)定義如下。1.3.1 版本管理員n 執(zhí)行版本管理規(guī)定；調(diào)整版本庫(kù)結(jié)構(gòu)及控制權(quán)限；發(fā)現(xiàn)并及時(shí)向管理者反饋版本管理中的問(wèn)題；目前版本管理員由測(cè)試部成員兼任。1.

8、3.2 項(xiàng)目經(jīng)理n 執(zhí)行版本管理相關(guān)規(guī)定，解決版本管理過(guò)程中出現(xiàn)的問(wèn)題；n 負(fù)責(zé)版本規(guī)劃，明確版本的特性，確定版本開發(fā)計(jì)劃和版本號(hào)等；n 負(fù)責(zé)版本自立項(xiàng)至版本發(fā)布的整個(gè)過(guò)程中項(xiàng)目組相關(guān)人員版本行為的指導(dǎo)和監(jiān)督；n 負(fù)責(zé)檢查歸檔版本的正確性、完整性、規(guī)范性。1.3.3 開發(fā)人員n 執(zhí)行版本管理規(guī)定；n 按時(shí)提交版本，對(duì)提交版本的一致性、正確性、規(guī)范性負(fù)責(zé)；n 對(duì)版本開發(fā)過(guò)程中各自的中間工作成果的存儲(chǔ)安全負(fù)責(zé)，確保工作成果不遺失、可追溯。1.3.4 測(cè)試人員n 執(zhí)行版本管理規(guī)定、檢查開發(fā)人員的提交版本，對(duì)檢查結(jié)果負(fù)責(zé)；n 歸檔版本，對(duì)歸檔版本的一致性、正確性負(fù)責(zé)；n 發(fā)現(xiàn)并及時(shí)向管理者反饋版本管理

9、中的問(wèn)題。1.3.5 測(cè)試部n 建立、優(yōu)化版本管理規(guī)定；n 解釋、監(jiān)督、檢查版本管理規(guī)定的執(zhí)行；n 審查項(xiàng)目組版本管理規(guī)定的執(zhí)行情況和效果；n 收集管理規(guī)定執(zhí)行過(guò)程中的問(wèn)題、變更需求等，匯總并安排在適當(dāng)時(shí)機(jī)對(duì)本規(guī)定進(jìn)行修訂完善。2. 版本號(hào)管理規(guī)范在項(xiàng)目開發(fā)啟動(dòng)階段，項(xiàng)目經(jīng)理根據(jù)項(xiàng)目需求和計(jì)劃等，會(huì)同測(cè)試部制定開發(fā)版本的主/次/末版本號(hào)，明確版本特性，并向項(xiàng)目所開發(fā)和測(cè)試人員傳達(dá)。版本規(guī)劃可以在項(xiàng)目計(jì)劃或設(shè)計(jì)等文檔中體現(xiàn)。2.1 版本號(hào)規(guī)定所有版本編號(hào)采用統(tǒng)一方式：n 項(xiàng)目版本號(hào)編碼方式：V主版本號(hào).次版本號(hào)如：n 模塊的版本號(hào)編碼方式：V主版本號(hào).次版本號(hào).末版本號(hào)R發(fā)布版本號(hào)序號(hào)如：V.1

10、R0179101一個(gè)產(chǎn)品版本通常由多個(gè)模塊組成，項(xiàng)目經(jīng)理在確定版本編號(hào)時(shí)，模塊版本號(hào)需要同產(chǎn)品版本號(hào)的“V主版本號(hào).次版本號(hào)”保持一致，“末版本號(hào)+R發(fā)布版本號(hào)序號(hào)”則可據(jù)實(shí)際情況根據(jù)規(guī)范定義。詳細(xì)的編碼規(guī)范，請(qǐng)參照附錄：版本號(hào)編碼規(guī)范及示例。2.2 版本號(hào)變化基本原則版本號(hào)變化一般分為項(xiàng)目版本號(hào)變化及模塊版本號(hào)變化2.2.1 項(xiàng)目版本號(hào)變化項(xiàng)目版本號(hào)變化，指的是主/次版本號(hào)的變化，僅在發(fā)生了系統(tǒng)級(jí)演進(jìn)及功能級(jí)演進(jìn)時(shí)，方可進(jìn)行主、次版本號(hào)的變化。2.2.2 模塊版本號(hào)變化模塊主、次版本號(hào)隨項(xiàng)目版本號(hào)的變化而變化；同時(shí)，如果項(xiàng)目發(fā)生了局部模塊改良情況時(shí)，也可以進(jìn)行模塊版本號(hào)的變化，但僅限于末版本

11、號(hào)的變化；即每次規(guī)劃需發(fā)布（歸檔）一個(gè)局部改良版本，即需要對(duì)模塊版本的未版本號(hào)進(jìn)行升位。2.2.3 項(xiàng)目與模塊版本號(hào)的一致性原則n 當(dāng)一個(gè)項(xiàng)目中存在多個(gè)模塊，且經(jīng)過(guò)多次版本升級(jí)時(shí)，其各個(gè)模塊版本號(hào)允許不一致；n 每次項(xiàng)目版本號(hào)需進(jìn)行升位時(shí)，需同時(shí)對(duì)下屬的各子模塊主、次版本號(hào)進(jìn)行升位；n 在已運(yùn)行的項(xiàng)目中，新增加的獨(dú)立模塊，其版本號(hào)中的主、次版本號(hào)必須與項(xiàng)目版本號(hào)一致；n 對(duì)于已運(yùn)行項(xiàng)目中，如存在子模塊的主/次版本號(hào)與項(xiàng)目版本號(hào)不一致現(xiàn)象，后續(xù)對(duì)該模塊進(jìn)行升級(jí)發(fā)布時(shí)，需同時(shí)將主/次版本號(hào)升位到現(xiàn)有項(xiàng)目版本號(hào)一致。2.2.4 版本號(hào)變化監(jiān)管n 由研發(fā)總工在文檔設(shè)計(jì)評(píng)審時(shí)跟進(jìn)各項(xiàng)目的版本號(hào)規(guī)劃情況。

12、2.3 模塊補(bǔ)丁原則2.3.1 適用范圍n 版本正式發(fā)布后或版本回歸過(guò)程進(jìn)行的少量缺陷修復(fù)，并且需要以修補(bǔ)的方式提供的修訂成果的情況，如數(shù)據(jù)庫(kù)編寫的修訂更新腳本、WEB個(gè)別頁(yè)面或資源的更新等；2.3.2 基本原則n 模塊補(bǔ)丁由于涉及變更內(nèi)容較少，建議盡量采取部分更新升級(jí)的方式提交；3. 文檔管理（提交）規(guī)范文檔管理是版本配置管理中的重要部分，目前納入管理的文檔主要包括：需求文檔、設(shè)計(jì)文檔及數(shù)據(jù)庫(kù)字典、用戶文檔（配置手冊(cè)、用戶手冊(cè)）、驗(yàn)收文檔（驗(yàn)收手冊(cè)及其它手冊(cè)）、模塊文檔（修改說(shuō)明、升級(jí)說(shuō)明、配置說(shuō)明、環(huán)境布署說(shuō)明）3.1 模塊文檔模塊文檔指與當(dāng)前模塊相關(guān)的修改說(shuō)明、升級(jí)說(shuō)明、配置說(shuō)明、編譯及

13、運(yùn)行說(shuō)明，對(duì)于每個(gè)模塊都應(yīng)該存在這些內(nèi)容信息。3.1.1 修改說(shuō)明作為開發(fā)人員追朔版本的依據(jù)，也作為測(cè)試人員了解修改內(nèi)容的依據(jù)。修改說(shuō)明以追加的方式編寫（如全新啟動(dòng)的項(xiàng)目，請(qǐng)以倒序排序）。內(nèi)容要求如下：對(duì)于公共資源包的修改說(shuō)明，需對(duì)當(dāng)前版本與其它版本的兼容及依賴關(guān)系進(jìn)行說(shuō)明。3.1.2 配置說(shuō)明配置說(shuō)明作為各模塊配置的依據(jù)，包括每個(gè)配置文件所在的位置及配置項(xiàng)的說(shuō)明。每次涉及到配置項(xiàng)增加或修改，都必須更新配置說(shuō)明，配置說(shuō)明只保留最新的一份（與最新配置文件中的各需配置項(xiàng)一致），但配置說(shuō)明杜絕為配置文件內(nèi)容的COPY，而應(yīng)為實(shí)際配置的指導(dǎo)。內(nèi)容要求如下：3.1.3 升級(jí)說(shuō)明作為版本升級(jí)的依據(jù)，以實(shí)際

14、升級(jí)步驟為準(zhǔn)，需考慮到不影響現(xiàn)網(wǎng)的配置文件、運(yùn)行過(guò)程中生成的數(shù)據(jù)。每次版本發(fā)布都必須提供升級(jí)說(shuō)明，以追加方式提供（如全新啟動(dòng)的項(xiàng)目，請(qǐng)以倒序排序）。，其中每次發(fā)布版本僅保留一次升級(jí)說(shuō)明信息（即回歸版本的升級(jí)說(shuō)明應(yīng)為修改，而非追加）。內(nèi)容要求如下：n 每次提交的可執(zhí)行程序所對(duì)應(yīng)的文件夾結(jié)構(gòu)必須一致，在確保此條件下，對(duì)應(yīng)文件的升級(jí)寫明為覆蓋相應(yīng)的文件夾內(nèi)容即可；如涉及文件夾結(jié)構(gòu)變化或需要先刪除后更新時(shí)，則必須寫明具體的路徑；n 補(bǔ)丁升級(jí)如存在配置的變更，不允許以“覆蓋文件、具體配置參照配置說(shuō)明修改”方式來(lái)編寫升級(jí)說(shuō)明，而應(yīng)詳細(xì)說(shuō)明哪個(gè)配置文件中增加什么樣配置；注意，需注意文字“覆蓋”、“替換”的正

15、確使用。3.1.4 編譯及運(yùn)行環(huán)境說(shuō)明說(shuō)明編譯需要的環(huán)境，包括編譯環(huán)境版本、編譯方法和步驟、依賴的公共資源和外部控件及其版本等。運(yùn)行說(shuō)明作為版本運(yùn)行的依據(jù)；當(dāng)涉及到編譯或運(yùn)行環(huán)境變更時(shí)，則需要更新編譯及運(yùn)行環(huán)境說(shuō)明，內(nèi)容要求如下：3.2 全局文檔全局文檔包括開發(fā)文檔和用戶文檔等，如需求文檔、設(shè)計(jì)文檔、數(shù)據(jù)庫(kù)字典、配置手冊(cè)、操作手冊(cè)等，都提交到與模塊平級(jí)的全局文檔目錄下；全局文檔的提交時(shí)間要求視不同版本而定；一般情況下，需求/設(shè)計(jì)類文檔需隨即將歸檔版本一起提交，以確保各文檔資料的最新；用戶類及驗(yàn)收類文檔（如驗(yàn)收手冊(cè)、操作手冊(cè)等）可后補(bǔ)歸檔；詳細(xì)包括：1. 需求文檔：要求提供開發(fā)過(guò)程中被確認(rèn)、細(xì)化

16、和修正后的需求文檔。其原始需求文檔也作附件提交；暫不對(duì)文檔格式作要求。2. 設(shè)計(jì)文檔：要求提供開發(fā)過(guò)程中最終被確認(rèn)的設(shè)計(jì)文檔；3. 數(shù)據(jù)庫(kù)字典：數(shù)據(jù)庫(kù)字典也為全局文檔，需提供與實(shí)際數(shù)據(jù)庫(kù)相符的數(shù)據(jù)庫(kù)字典；4. 配置手冊(cè)：根據(jù)各產(chǎn)品的實(shí)際需要提供配置手冊(cè)。配置手冊(cè)要求對(duì)每個(gè)配置參數(shù)進(jìn)行詳細(xì)說(shuō)明，需要對(duì)參數(shù)的缺省值、取值范圍、配置指導(dǎo)原則、推薦配置等進(jìn)行細(xì)致的說(shuō)明。必要時(shí)還要按照一定的步驟進(jìn)行描述，對(duì)需要配置的部分，能夠突出顯示。比如：以紅色標(biāo)注。對(duì)于比較復(fù)雜的配置，可以借助圖片來(lái)說(shuō)明。5. 用戶/驗(yàn)收手冊(cè)：要求提供完整的用戶/驗(yàn)收手冊(cè)，有關(guān)手冊(cè)的編寫要求請(qǐng)查閱相應(yīng)的規(guī)范。4. 數(shù)據(jù)庫(kù)模塊提交規(guī)范

17、數(shù)據(jù)庫(kù)腳本提交相關(guān)要求如下：1. 數(shù)據(jù)庫(kù)作為獨(dú)立模塊進(jìn)行提交，版本號(hào)命名規(guī)則與工程模塊一致；提交內(nèi)容需要包括完整腳本、升級(jí)腳本、文檔；其中升級(jí)腳本相當(dāng)于工程模塊的“可執(zhí)行程序”，存放當(dāng)次的升級(jí)腳本；完整腳本相當(dāng)工程模塊的“源碼”，存放所有的數(shù)據(jù)庫(kù)腳本，文檔與工程模塊一致；文件夾結(jié)構(gòu)如下所示：源目錄：提交目錄：Build實(shí)例如下所示。2. 數(shù)據(jù)庫(kù)腳本中，可按照腳本的執(zhí)行特性來(lái)命名（建表、建庫(kù)、建序列、初始化數(shù)據(jù)、建存儲(chǔ)過(guò)程等）如下圖所示：3. 修改說(shuō)明、升級(jí)說(shuō)明與3.1模塊文檔說(shuō)明要求一樣，同時(shí)升級(jí)說(shuō)明中需注意要求：a) 執(zhí)行工具和方式、權(quán)限（比如：請(qǐng)使用PLSQL/COMMAND方式/普通用戶

18、權(quán)限執(zhí)行）；b) 執(zhí)行腳本的順序；4. 升級(jí)腳本中，必須在腳本中標(biāo)明本次數(shù)據(jù)庫(kù)的版本號(hào)，在注釋部分指明該升級(jí)腳本是在哪一個(gè)版本基礎(chǔ)上進(jìn)行的修改；5. 在版本回歸過(guò)程中，如涉及到數(shù)據(jù)庫(kù)腳本存在變化，可靈活選用更新方式（直接修改上輪提交的腳本文件或新增加一個(gè)對(duì)上個(gè)腳本修訂的文件），確保測(cè)試可回歸以及現(xiàn)網(wǎng)正常升級(jí)即可。6. 數(shù)據(jù)庫(kù)完整腳本僅供歸檔，測(cè)試不需驗(yàn)證正確性。5. 發(fā)布(歸檔)庫(kù)管理規(guī)范當(dāng)版本測(cè)試完成達(dá)到發(fā)布條件后，需將當(dāng)前的版本歸檔到發(fā)布庫(kù)；作為以后版本追溯的依據(jù)。發(fā)布庫(kù)存放內(nèi)容包括基線文檔、測(cè)試通過(guò)的源碼、可執(zhí)行程序、發(fā)布說(shuō)明文檔5.1 發(fā)布庫(kù)結(jié)構(gòu)n 一級(jí)目錄為項(xiàng)目名稱。歸檔說(shuō)明，放到此

19、級(jí)下即可。n 二級(jí)目錄類型（工程模塊、全局文檔、數(shù)據(jù)庫(kù)腳本）。n 三級(jí)目錄為發(fā)布版本日期（數(shù)據(jù)庫(kù)腳本仍直接為版本號(hào)）。n 四級(jí)目錄為具體的版本所有模塊（包括工程模塊、數(shù)據(jù)庫(kù)腳本、本次對(duì)應(yīng)的文檔）。n 為了方便文檔獲取，文檔除在對(duì)應(yīng)的工程模塊下進(jìn)行歸檔后，同時(shí)在全局文檔目錄進(jìn)行歸檔。5.2 權(quán)限管理要求版本發(fā)布后的版本位置為65發(fā)布庫(kù)；為了發(fā)布庫(kù)的安全，對(duì)權(quán)限管理要求如下： n 僅超級(jí)管理員具有發(fā)布庫(kù)的所有權(quán)；n 非測(cè)試部成員僅有只讀權(quán)限；n 測(cè)試部成員具有自己所負(fù)責(zé)項(xiàng)目的讀寫權(quán)限，其它項(xiàng)目的讀權(quán)限；n 測(cè)試部指定人員每月必須檢查權(quán)限情況，對(duì)于權(quán)限超出范圍的權(quán)限，及時(shí)調(diào)整。

20、5.3 發(fā)布庫(kù)檢查要求測(cè)試部成員、項(xiàng)目經(jīng)理在日常工作中，有義務(wù)監(jiān)督反映問(wèn)題，由測(cè)試部安排人員進(jìn)行跟進(jìn)處理；1. 測(cè)試部需安排人員不定期對(duì)歸檔情況進(jìn)行檢查；針對(duì)檢查情況不符合要求者，進(jìn)行相應(yīng)考核。2. 檢查結(jié)果進(jìn)行改進(jìn)后，需再進(jìn)行復(fù)檢，以最終確保歸檔的有效性。6. 版本各過(guò)程管理規(guī)范6.1 版本構(gòu)建要求6.1.1 構(gòu)建腳本規(guī)則根據(jù)項(xiàng)目的情況，每個(gè)項(xiàng)目組都必須在版本提交之前做好構(gòu)建腳本。1. 構(gòu)建腳本ü 用于完整版本提交，其中產(chǎn)生的構(gòu)建目錄包括:可執(zhí)行程序(完整)DOC源碼(完整)，如下所示：ü 對(duì)于部分項(xiàng)目存在打補(bǔ)丁的情況時(shí)，需提供補(bǔ)丁構(gòu)建版本，補(bǔ)丁構(gòu)建腳本要求如下：補(bǔ)丁構(gòu)建

21、腳本；用于各個(gè)補(bǔ)丁版本提交；需注意每次提交時(shí)，需及時(shí)調(diào)整補(bǔ)丁構(gòu)建腳本其中提交的內(nèi)容包括：可執(zhí)行程序(補(bǔ)丁)DOC源碼(完整)2. 構(gòu)建腳本規(guī)則l 構(gòu)建發(fā)布路徑必須使用$release.home，以確保所有項(xiàng)目發(fā)布的路徑一致；l 數(shù)據(jù)庫(kù)腳本需作為一個(gè)獨(dú)立模塊打包；l 客戶端程序由開發(fā)自行打包提交，但同時(shí)需提供復(fù)制到發(fā)布路徑的構(gòu)建腳本；6.1.2 構(gòu)建任務(wù)要求版本提交后，配置人員需要進(jìn)行版本的構(gòu)建。首次提交版本時(shí)，測(cè)試人員需要將構(gòu)建任務(wù)設(shè)置為定時(shí)構(gòu)建，以節(jié)約等待構(gòu)建的時(shí)間；構(gòu)建任務(wù)需注意檢查如下內(nèi)容：1. 確認(rèn)構(gòu)建的指向路徑是否正確。2. 確認(rèn)構(gòu)建產(chǎn)出的版本路徑是否正確，3. 確認(rèn)構(gòu)建產(chǎn)出的版本內(nèi)

22、容是否完整。4. 版本構(gòu)建成功后，構(gòu)建生成的版本存放地址為65構(gòu)建庫(kù)如版本多次構(gòu)建不成功且反復(fù)找不到原因時(shí)（2小時(shí)內(nèi)），版本構(gòu)建人員有權(quán)打回版本并記一次提交問(wèn)題。6.2 版本提交要求6.2.1 提交內(nèi)容版本提交內(nèi)容為SVN上指定的代碼，且最后打包出來(lái)的內(nèi)容包括可執(zhí)行程序、源碼（完整）、文檔（請(qǐng)參考文檔要求）。版本提交不要求必須按補(bǔ)丁或是按完整版本提交；但項(xiàng)目經(jīng)理需確保按照升級(jí)說(shuō)明的內(nèi)容能正常完成版本升級(jí)；同時(shí)，為了避免后續(xù)環(huán)節(jié)不必要的工作量浪費(fèi)，項(xiàng)目經(jīng)理需合理控制版本的提交方式以及升級(jí)說(shuō)明的有效性。6.2.2 提交路徑版本提交路徑為當(dāng)前項(xiàng)目的tags/test/sourc

23、e/（補(bǔ)丁版本路徑為：tags/test/source_pm），詳細(xì)操作方式請(qǐng)查看附錄；如tags/test/source下已經(jīng)存在歷史提交的版本，由提交人員進(jìn)行刪除即可；版本中的各模塊非首次提交版本時(shí)，不能擅自修改提交路徑，以避免自動(dòng)構(gòu)建失敗而影響工作效率。6.2.3 提交檢查版本提交責(zé)任主體為項(xiàng)目經(jīng)理，項(xiàng)目經(jīng)理對(duì)版本提交質(zhì)量負(fù)責(zé)；故項(xiàng)目經(jīng)理需檢查提交的版本是否達(dá)到提交要求（例如內(nèi)容是否齊全、版本路徑是否正確、是否能正常打包等），當(dāng)檢查無(wú)問(wèn)題后，項(xiàng)目經(jīng)理方走OA流程通知測(cè)試接口人及其它人員；注意事項(xiàng)：客戶端、數(shù)據(jù)庫(kù)提交也是按模塊提交方式一樣，Build文件僅實(shí)現(xiàn)從SVN路徑下獲取到構(gòu)建目錄下

24、。版本提交前如發(fā)現(xiàn)source存在上次版本的文件，請(qǐng)自行進(jìn)行版本刪除。6.3 版本測(cè)試及回歸要求測(cè)試及回歸過(guò)程中存在冒煙測(cè)試、打回、重新提交的相關(guān)事宜。6.3.1 布署版本及冒煙測(cè)試1. 測(cè)試人員接收版本署成功后，進(jìn)行冒煙測(cè)試，如冒煙測(cè)試不通過(guò)（2小時(shí)內(nèi)無(wú)法解決），測(cè)試人員可打回版本，并需要將事件以郵件的形式，通知測(cè)試部經(jīng)理/項(xiàng)目經(jīng)理及研發(fā)管理相關(guān)人員。2. 對(duì)于升級(jí)說(shuō)明編寫錯(cuò)誤造成的版本無(wú)法正常運(yùn)行問(wèn)題，如問(wèn)題及時(shí)解決，可不走版本打回流程，如果問(wèn)題在2小時(shí)內(nèi)仍無(wú)法解決，需走正式的版本打回流程。6.3.2 退回重新提交退回的版本再次提交時(shí)，版本號(hào)中的R發(fā)布版本號(hào)不需要改變，但只要是重新打包過(guò)的

25、版本，序號(hào)就需要進(jìn)行更新（如果退回版本隔天提交時(shí)，R發(fā)布版本號(hào)需要進(jìn)行更新）。6.3.3 回歸測(cè)試及提交回歸測(cè)試版本的提交流程及接收標(biāo)準(zhǔn)，與正常提交流程相同。1. 回歸測(cè)試過(guò)程中，版本的主、次、末版本號(hào)不能改變。如果特殊情況下需要改變，需要項(xiàng)目經(jīng)理確認(rèn)并通知對(duì)應(yīng)的測(cè)試人員。2. 回歸測(cè)試版本中的各模塊文檔內(nèi)容，如升級(jí)說(shuō)明有所變化，則修改升級(jí)說(shuō)明的內(nèi)容；修改說(shuō)明為追加方式，不能混淆。6.4 版本發(fā)布/歸檔要求當(dāng)版本測(cè)試完成達(dá)到發(fā)布條件時(shí)，由測(cè)試人員負(fù)責(zé)此版本的歸檔及發(fā)布；歸檔版本必須保證一致性、正確性、完整性。6.4.1 歸檔內(nèi)容包括測(cè)試通過(guò)的打包文件（可執(zhí)行程序doc源碼）、數(shù)據(jù)庫(kù)腳本、版本對(duì)

26、應(yīng)的最新的需求/設(shè)計(jì)及用戶文檔；同時(shí)：Ø 執(zhí)行程序歸檔：除了歸檔EXE外，還必須包含整個(gè)運(yùn)行環(huán)境，如：配置文件，資源文件，附屬目錄等Ø 源代碼歸檔：必須保證源碼能夠正確編譯；保證不將編譯產(chǎn)生的中間文件、備份文件、臨時(shí)文件，或者其他無(wú)效文件歸入。Ø 文檔歸檔：為當(dāng)前版本對(duì)應(yīng)的最新文檔歸檔。6.4.2 歸檔路徑歸檔時(shí)，按發(fā)布（歸檔）庫(kù)管理規(guī)范歸檔即可。注意保持目錄結(jié)構(gòu)的統(tǒng)一性。同時(shí)：Ø 按模塊的目錄下，各模塊補(bǔ)丁必須歸為具體的模塊文件夾下層。Ø 當(dāng)存在需求或設(shè)計(jì)資料且該版本對(duì)應(yīng)一個(gè)以上模塊時(shí)，文檔必須獨(dú)立于模塊外歸檔；6.4.3 歸檔說(shuō)明n 版本發(fā)

27、布時(shí)，必須形成的完整的版本發(fā)布記錄，以方便版本正常被獲取；版本發(fā)布說(shuō)明以追加方式編寫。內(nèi)容格式如下：n 注意：u 當(dāng)存在文檔歸檔時(shí)，對(duì)相關(guān)文檔標(biāo)識(shí)為有發(fā)布要求測(cè)試人員進(jìn)行版本歸檔后，再將對(duì)應(yīng)版本的可執(zhí)行程序/文檔發(fā)布給指定的用服人員；杜絕進(jìn)行任何源碼的發(fā)布。6.5 版本備份要求1. 每天定時(shí)自動(dòng)進(jìn)行SVN庫(kù)完整備份；2. 每月初由測(cè)試部指定人員進(jìn)行異地備份（包括SVN庫(kù)及版本庫(kù)），并交由總經(jīng)辦保管。6.6 版本獲取要求當(dāng)開發(fā)需要在已有歷史項(xiàng)目版本的基礎(chǔ)上進(jìn)行開發(fā)時(shí)，需遵守如下要求：n 項(xiàng)目經(jīng)理提要求與測(cè)試人員，由測(cè)試人員提供具體的版本地址信息與項(xiàng)目經(jīng)理；n 開發(fā)人員必須從項(xiàng)目經(jīng)理處獲取版本相關(guān)

28、信息，杜絕開發(fā)人員直接找測(cè)試人員獲取版本的情況；n 如項(xiàng)目經(jīng)理非從測(cè)試處獲取源碼者，由項(xiàng)目經(jīng)理對(duì)源碼的正確有效性負(fù)責(zé)。7. 附錄7.1 附錄：版本號(hào)編碼規(guī)范及示例7.1.1 版本號(hào)編碼規(guī)范所有版本編號(hào)采用統(tǒng)一方式：n 項(xiàng)目版本號(hào)編碼方式：V主版本號(hào).次版本號(hào)（如：V1.2）n 模塊的版本號(hào)編碼方式：V主版本號(hào).次版本號(hào)末版本號(hào)R發(fā)布版本號(hào)序號(hào)（如：V1.R0179101）一個(gè)產(chǎn)品版本通常由多個(gè)模塊組成，在版本標(biāo)號(hào)時(shí)，模塊版本號(hào)需要同項(xiàng)目版本號(hào)在“V主版本號(hào).次版本號(hào)”保持一致，“未版本號(hào)+R發(fā)布版本號(hào)序號(hào)”則可根據(jù)不同模塊，靈活定義。主版本號(hào)：數(shù)字, 最大兩位，不夠兩位，不必左補(bǔ)0次版本號(hào)：數(shù)

29、字，最大三位，不夠三位，不必左補(bǔ)0末版本號(hào)：數(shù)字，最大三位，不夠三位，不必左補(bǔ)0發(fā)布版本號(hào)：數(shù)字，固定5位，左補(bǔ)0，以時(shí)間基礎(chǔ)的算法計(jì)算而得序號(hào)： 數(shù)字，固定2位，左補(bǔ)0，依次累加發(fā)布版本號(hào)將以日期為基礎(chǔ)，但不要用明顯的日期表示，所以需要按照一定的規(guī)則計(jì)算，產(chǎn)生一個(gè)編號(hào)。并且根據(jù)這種規(guī)則，我們還能夠?qū)l(fā)布版本號(hào)還原得到日期。計(jì)算方法：發(fā)布版本號(hào)=YY*32*13+MM*32+DD（最大值37231）還原方法：YY=發(fā)布版本號(hào)/(32*13)MM=(發(fā)布版本號(hào)- (YY*32*13)/32DD =發(fā)布版本號(hào)- YY*32*13-MM*327.1.1 項(xiàng)目版本號(hào)示例項(xiàng)目版本號(hào)模塊版本號(hào)：即主版本號(hào)

30、的前三位，主版本號(hào)+次版本號(hào)+末版本號(hào)；如：V項(xiàng)目版本號(hào)隨項(xiàng)目主模塊的版本號(hào)變化，每次主模塊的主版本號(hào)或次版本號(hào)變化，則項(xiàng)目版本號(hào)隨之變化；例如：第一次發(fā)布版本：主版本：m1V第二次發(fā)布版本：m1V第三次發(fā)布版本：m2V則項(xiàng)目版本號(hào)：第四次發(fā)布版本：主版本為：m1V1.1.0第五次發(fā)布版本：m2V1.1.0則項(xiàng)目版本號(hào)為：PMN0017.1.2 補(bǔ)丁包及補(bǔ)丁編碼示例補(bǔ)丁包編碼規(guī)范：P+M+主.次版本號(hào)+N序號(hào)+D區(qū)號(hào)說(shuō)明：P代表補(bǔ)丁包，M代表主次版本號(hào)；N代表第幾個(gè)補(bǔ)丁包，PM1.1N001；代表V1.1版本的第一個(gè)補(bǔ)丁包；PM3.21N002D755；代表V3.21版本的第二個(gè)補(bǔ)丁包（深圳專

31、有）；l 序號(hào)(N)：數(shù)字，最大三位，序列遞增；l 對(duì)于專有補(bǔ)丁包，方需要增加D區(qū)號(hào)模塊/數(shù)據(jù)庫(kù)補(bǔ)丁編碼示例：模塊名+PM主次末版本號(hào)+N+序號(hào)+發(fā)布版本號(hào)Web_PM1N1R0179101；代表web端Web_PM1N2 D755R0179101第二個(gè)補(bǔ)丁(深圳專有)Sql_PM1N2D755R0179101；代表數(shù)據(jù)庫(kù)V1.0.7的第二個(gè)補(bǔ)?。ㄉ钲趯Ｓ校﹍ 序號(hào)(N)：數(shù)字，最大三位，序列遞增；不夠3位，可不必左補(bǔ)07.2 附錄：源碼歸檔規(guī)范源碼的歸檔比較復(fù)雜，規(guī)范如下：n 源文件必須完備源文件歸檔注意包括所有有效文件，包括子目錄，源文件，工程文件，資源文件等等。n 設(shè)置工程的相關(guān)目錄，不

32、將中間文件歸入版本庫(kù)代碼編譯產(chǎn)生的中間文件，備份文件等無(wú)用文件，不歸入版本庫(kù)。要在項(xiàng)目的工程文件中設(shè)置中間文件的輸出目錄，具體設(shè)置如下。n 源碼中使用到的第三方控件，將作為CODE的一部分，獨(dú)立一個(gè)目錄進(jìn)行歸檔。目前VCL控件還需要進(jìn)一步的整理，把不需要用到的控件版本清除掉，保證其歸檔控件最??；VCL也可以作為獨(dú)立的公共資源進(jìn)行管理，但在版本中，需要說(shuō)明明確的存放路徑，必須保證使用該資源時(shí)的正確性。n 歸檔目錄組織源碼歸檔目錄可自行組織，但是必須能夠完成編譯。有些開發(fā)人員本地的開發(fā)目錄同版本庫(kù)目錄不一致，而工程文件中通常保持有編譯路徑，這樣導(dǎo)致從版本庫(kù)中取得的版本不能編譯，所有，要求開發(fā)人員本

33、地目錄要同版本庫(kù)保持一致。下面內(nèi)容對(duì)delphi，c+，java三種語(yǔ)言歸檔規(guī)范進(jìn)行了簡(jiǎn)單的介紹，詳細(xì)內(nèi)容可參考培訓(xùn)資料庫(kù)中的相關(guān)編程規(guī)范。7.2.1 C工程目錄設(shè)置：n 歸檔目錄結(jié)構(gòu)參考： |模塊名 |源代碼和資源文件等|Output|模塊名 |編譯生成的中間文件|Release|模塊名|可發(fā)布的執(zhí)行文件輸入文件的目錄設(shè)置如下：（debug和release）n 歸檔源文件按照上述設(shè)置中間文件輸入目錄以后，項(xiàng)目目錄下的自動(dòng)生成的工程文件，源文件，配置、DLL、LIB、說(shuō)明文件等都可歸檔。7.2.2 JAVA工程目錄設(shè)置：n 歸檔目錄結(jié)構(gòu)參考： |src |源代碼和資源文件等|build|編譯的

34、ant文件|lib|工程使用的lib|doc|工程相關(guān)文檔|output|可執(zhí)行程序輸入目錄|bin|.class編譯輸出文件n 歸檔源文件按照上述目錄在eclipse的工程中建立目錄，ant工程文件的使用參見java編程規(guī)范，bin目錄下的文件不要?dú)w檔，其他都需要?dú)w檔。7.2.3 WEB工程目錄設(shè)置n 開發(fā)目錄結(jié)構(gòu)參考：|src |源代碼和資源文件等|buildjsp|編譯JSP的ant文件與lib|doc |工程相關(guān)文檔|WebRoot |WEB工程目錄|work |編譯JSP之后的.java,.class工作目錄n WEB工程目錄如下：|images |存放圖片目錄，可按圖片功能劃分，也

35、可按WEB功能劃分子目錄|btn|banner|pic|include |存放包含文件，包括js,css,htc等|css|js|htc|META-INF|存放版本信息，說(shuō)明信息等|temp|存放臨時(shí)文件目錄，如上傳的圖片，文件等|images|update|WEB-INF |存放classes,jsp,lib,xml,等信息 |classes|jsp|lib|data|wap|conf|index.jsp 放置首頁(yè)轉(zhuǎn)發(fā)頁(yè)注：所有的配置文件、jsp頁(yè)面（轉(zhuǎn)發(fā)的除外）、數(shù)據(jù)文件必須放置在WEB-INF下，其中、 、 必須放置在WEB-INF根目錄下，其他文件放到相應(yīng)的子目錄下；如果沒有對(duì)應(yīng)的子目

36、錄，可自行創(chuàng)建子目錄存放。7.2.4 版本號(hào)文件存放路徑根據(jù)不同開發(fā)語(yǔ)言的工程目錄設(shè)置規(guī)則，版本號(hào)需存放到不同路徑下的版本文件中。1. JAVA類：版本號(hào)信息需存放到META-INF文件中。2. .NET類：版本號(hào)信息需存放到Properties文件中（最終形成為dll文件的版本號(hào)）。3. C+類：版本號(hào)信息一般存放到*.rc文件中，檢查人員僅需檢查可執(zhí)行文件的文件屬性中的產(chǎn)品版本號(hào)即可。7.3 附錄配置庫(kù)(SVN)結(jié)構(gòu)及管理參考目前輔助管理工具為SVN，對(duì)應(yīng)的配置庫(kù)管理規(guī)范如下：7.3.1 總結(jié)構(gòu)總共分Tag、Branches、trunk三個(gè)庫(kù)，其中Tag為提交庫(kù)，為研發(fā)向測(cè)試提交版本的存放

37、空間、Branches為分支庫(kù)，包括主干外的分支源碼、項(xiàng)目資料；trunk則為項(xiàng)目主體開發(fā)庫(kù)Tag庫(kù)結(jié)構(gòu)Tag下主要存放各模塊的源碼提交信息如下圖所示：test下，source及source_pm下的目錄結(jié)構(gòu)與trunks下的source結(jié)構(gòu)一致，source用于版本源碼完整提交的臨時(shí)存儲(chǔ)；source_pm用于版本源碼補(bǔ)丁提交的臨時(shí)存儲(chǔ)。Trunk/branchs庫(kù)項(xiàng)目資料結(jié)構(gòu)項(xiàng)目資料包括項(xiàng)目過(guò)程中所涉及的所有項(xiàng)目信息，包括項(xiàng)目管理、需求、設(shè)計(jì)、原型、測(cè)試、用戶文檔等等；但原則上不包括現(xiàn)網(wǎng)工程相關(guān)信息（避免現(xiàn)網(wǎng)登錄信息外泄）。Trunk/branchs庫(kù)Src結(jié)構(gòu)在trunk/branchs

38、庫(kù)中，以模塊為目錄，存放源程序。源程序目錄結(jié)構(gòu)請(qǐng)參照版本管理規(guī)范；同時(shí)數(shù)據(jù)庫(kù)腳本作為與模塊同級(jí)的目錄塊存在，每次提交的數(shù)據(jù)庫(kù)腳本以版本號(hào)為二級(jí)目錄。7.3.2 配置項(xiàng)內(nèi)容目前SVN本配置項(xiàng)主要包括各階段的文檔、源碼；包括但不限于如下：文檔類研發(fā)過(guò)程中所產(chǎn)生的各類文檔，過(guò)程文檔和結(jié)果文檔；比如各階段評(píng)審記錄、需求規(guī)劃說(shuō)明書、概要設(shè)計(jì)以測(cè)試報(bào)告、驗(yàn)收手冊(cè)等等。代碼類：自行開發(fā)模塊源碼、公共資可執(zhí)行包（或必要的源碼）7.3.3 配置項(xiàng)命名所有文檔的管理納入配置管理庫(kù)，用版本控制工具進(jìn)行統(tǒng)一管理。文檔的版本控制主要通過(guò)文檔的名稱、文檔控制頁(yè)實(shí)現(xiàn)。 文檔類配置項(xiàng)命名原則1、項(xiàng)目成果類文檔命名方式：地區(qū)+

39、項(xiàng)目簡(jiǎn)稱+文檔分類適用文檔：項(xiàng)目開發(fā)計(jì)劃，需求規(guī)格文檔，技術(shù)方案文檔，概要設(shè)計(jì)文檔，數(shù)據(jù)庫(kù)設(shè)計(jì)文檔，配置手冊(cè)，用戶手冊(cè)，驗(yàn)收手冊(cè)等。地區(qū)：可選，主要用于該產(chǎn)品屬于多個(gè)項(xiàng)目時(shí)進(jìn)行的標(biāo)識(shí)。項(xiàng)目簡(jiǎn)稱：必填，表現(xiàn)所屬哪個(gè)項(xiàng)目。文檔分類：必填，表現(xiàn)當(dāng)前文檔所屬的類型2、項(xiàng)目過(guò)程監(jiān)控類文檔命名方式：項(xiàng)目簡(jiǎn)稱+文檔分類適用文檔：過(guò)程跟進(jìn)表、評(píng)審意見表單代碼類命名原則：參照版本管理規(guī)范7.3.4 配置項(xiàng)使用要求1) 開發(fā)人員每次修改，或者新增、刪除、拷貝工作區(qū)對(duì)象后，應(yīng)該立刻提交到版本庫(kù)，有效保持工作區(qū)與配置庫(kù)的高度一致；2) 開發(fā)人員在每次修改工作區(qū)中代碼或者文檔時(shí)，首先更新該對(duì)象，可以盡量減少?zèng)_突、合并；3) 開發(fā)人員確保每天下班之前進(jìn)行一次配置項(xiàng)的Update；4) 保證提交到的版本庫(kù)的代碼沒有BUG以免影響開發(fā)組，可以適當(dāng)利用加鎖機(jī)制，減少?zèng)_突；5) 保證各文檔的最新版本及時(shí)提交至SVN.7.3.5 配置庫(kù)存放文件類型及大小規(guī)定u 文件名及目錄規(guī)定：按照配置庫(kù)結(jié)構(gòu)及配置項(xiàng)命名規(guī)則進(jìn)行命名；u 文件大小規(guī)定