源代碼管理規(guī)范

1、代碼管理制度1 總則22 源代碼完整性保障23 源代碼的授權(quán)訪問24 代碼版本管理35 源代碼復(fù)制和傳播46 系統(tǒng)測試驗(yàn)收流程56.1 系統(tǒng)初驗(yàn)56.2 試運(yùn)行56.3 系統(tǒng)終驗(yàn)56.4 系統(tǒng)驗(yàn)收標(biāo)準(zhǔn)66.5 文檔評(píng)審?fù)ㄟ^標(biāo)準(zhǔn)76.6 確認(rèn)測試通過標(biāo)準(zhǔn)76.7 系統(tǒng)試運(yùn)行通過標(biāo)準(zhǔn)71總則1、為保障公司源代碼和開發(fā)文檔安全不至于泄露，保證源代碼的完整，明確源代碼控制管理流程，特制定此管理辦法。2、本辦法適用于所有涉及接觸源代碼的各部門各崗位。所涉及部門都必須嚴(yán)格執(zhí)行本管理辦法。3、源代碼直接控制管理部門為技術(shù)開發(fā)部。4、本辦法管理重點(diǎn)在于控制管理源代碼的完整性，不被非授權(quán)獲取，不被非授權(quán)復(fù)制和傳

2、播。5、本辦法所指源代碼不僅限于公司開發(fā)人員自行編寫實(shí)現(xiàn)功能的程序代碼，而且還包括相應(yīng)的開發(fā)設(shè)計(jì)文檔及用于支撐整個(gè)系統(tǒng)運(yùn)行所必須具備的第三方軟件、控件和其它支撐庫等文件。2 源代碼完整性保障1、所有軟件的源代碼文件及相應(yīng)的開發(fā)設(shè)計(jì)文檔均必須及時(shí)加入到指定的源代碼服務(wù)器中的指定庫中。2、我們研發(fā)的產(chǎn)品軟件運(yùn)行所必須的第三方軟件、控件和其它支撐庫等文件也必須及時(shí)加入源代碼服務(wù)器中指定的庫中。3、軟件開始編寫或者調(diào)整代碼之前，其相應(yīng)的設(shè)計(jì)文檔和代碼必須先從相應(yīng)的SVN庫進(jìn)行SVNUpdate操作。軟件編碼或功能調(diào)整結(jié)束測試正確無誤后，相應(yīng)的源代碼必須進(jìn)行SVNCommi臊作，在最終進(jìn)行SVNComm

3、i腺作之前需要再進(jìn)行SVNUpdate操作，查看是否有沖突產(chǎn)生，如果有沖突產(chǎn)生需要和沖突相關(guān)人一并解決沖突。3 源代碼的授權(quán)訪問1、源代碼服務(wù)器對于共享的SVN庫的訪問建立操作系統(tǒng)級(jí)的，基于身份和口令的訪問授權(quán)。第十條在SVN庫中設(shè)置用戶，并為不同用戶分配不同的，適合工作的最小訪問權(quán)限。要求連接SVN庫時(shí)必須校驗(yàn)SVN中用戶身份及其口令。在SVN庫中要求區(qū)別對待不同用戶的可訪問權(quán)、可讀權(quán)、可寫權(quán)。2、曾經(jīng)涉及、觸及源代碼的計(jì)算機(jī)在轉(zhuǎn)作它用，或者離開研發(fā)部門之前必須由網(wǎng)絡(luò)管理人員全面清除計(jì)算機(jī)硬盤中存儲(chǔ)的源代碼。如果不能確定，必須對計(jì)算機(jī)中所有硬盤進(jìn)行全面格式化后方可以轉(zhuǎn)做它用或離開研發(fā)部門。4

4、 代碼版本管理1、終端軟件的版本標(biāo)識(shí)管理終端軟件版本由終端型號(hào)、版本號(hào)和內(nèi)部修訂號(hào)來進(jìn)行標(biāo)識(shí)。終端型號(hào)：終端型號(hào)是硬件標(biāo)識(shí)號(hào)，也唯一的標(biāo)識(shí)了我們的項(xiàng)目。版本號(hào)：由“主版本號(hào).次版本號(hào).修訂號(hào)”三段組成，中間是點(diǎn)號(hào)分開。版本號(hào)的目的主要是管理終端軟件的對外發(fā)布，終端軟件的BUG的記錄和統(tǒng)計(jì)，主要是針對于版本號(hào)的，測試部、項(xiàng)目部、客戶等會(huì)記錄某個(gè)版本號(hào)的終端軟件存在哪些BUG,BUG會(huì)在哪個(gè)版本號(hào)中得到修正；終端軟件一個(gè)新的版本號(hào)出來后，我們會(huì)統(tǒng)計(jì)新的版本號(hào)解決了上一個(gè)版本號(hào)中的哪些BUG,以及增加了哪些新功能，等等。內(nèi)部修訂號(hào)：也就是“應(yīng)用程序的源代碼的svn修訂號(hào)”，主要是由軟件部和測試部內(nèi)部

5、來使用，內(nèi)部修訂號(hào)唯一標(biāo)識(shí)我們的終端軟件，即：通過內(nèi)部修訂號(hào)能夠唯一的找出我們發(fā)布的終端軟件所對應(yīng)的全部軟件源代碼，目的是為了軟件排錯(cuò)使用。另外，終端軟件在發(fā)布時(shí)，還會(huì)給出發(fā)布日期，以便開發(fā)、測試、項(xiàng)目、客戶等相關(guān)人口分”員參考。2、終端軟件版本發(fā)布管理終端軟件主要是以版本號(hào)為基準(zhǔn)，對外發(fā)布，目前采用不定時(shí)發(fā)布策略，發(fā)布的時(shí)間由軟件部、項(xiàng)目部和客戶方根據(jù)情況，共同商量決定。由于目前項(xiàng)目時(shí)間緊，終端軟件無法得到完整的測試就要發(fā)布，在發(fā)布之后，有一些需要緊急需要修復(fù)的BUG，軟件部需要緊急修復(fù)后就要發(fā)布更新包，以便用戶能夠使用，所以，在一個(gè)版本號(hào)發(fā)布后，需要進(jìn)行多次修訂，對于這些修訂的版本，其版本

6、號(hào)保持不變，內(nèi)部修訂發(fā)生變化。軟件BUG記錄、管理和統(tǒng)計(jì)軟件BUG的記錄、管理和統(tǒng)計(jì)主要以版本號(hào)為基準(zhǔn)，但為了軟件開發(fā)人員能夠找到BUG的出處，需要用戶、測試人員在報(bào)告和驗(yàn)證BUG時(shí)，輸入內(nèi)部修訂號(hào)。3、軟件配置組對版本的記錄軟件版本記錄的目標(biāo)有兩個(gè)：記錄軟件版本的發(fā)布?xì)v史；發(fā)布的每一個(gè)版本，都要能夠唯一的從源代碼庫（SVN）中找到對應(yīng)的全部源代碼。測試方案：作為軟件開發(fā)的重要環(huán)節(jié)，作為交付成功的優(yōu)質(zhì)的產(chǎn)品的重要保證手段和方法，軟件測試越來越受到項(xiàng)目的重視。要做好測試首先要做好測試的組織、管理、計(jì)設(shè)、實(shí)施等工作。系統(tǒng)測試方案概述：測試是指在軟件投入運(yùn)行前，對軟件需求分析、設(shè)計(jì)規(guī)格說明和編碼的最

7、終復(fù)審，是軟件質(zhì)量保證的關(guān)鍵步驟。測試的目標(biāo)：以較少的用例、時(shí)間和人力找出軟件中潛在的各種錯(cuò)誤和缺陷，以確保系統(tǒng)的質(zhì)量。在實(shí)際項(xiàng)目中，測試作為軟件開發(fā)生命周期中的一個(gè)重要過程，但從其具體工作的前后過程來看，它又是由一系列的不同測試所組成，這些測試的步驟分為：單元測試、集成測試（又稱組裝測試）、確認(rèn)測試和系統(tǒng)測試。軟件開發(fā)的過程是自頂向下的，測試則正好相反，以上這些過程就是自底向上，逐步集成的。在項(xiàng)目過程中，我們按以上的測試步驟完成系統(tǒng)的測試。5源代碼復(fù)制和傳播1、源代碼向研發(fā)部門以外復(fù)制必須獲得總經(jīng)理的書面授權(quán)。并必需記錄復(fù)制人、批準(zhǔn)人、復(fù)制時(shí)間、復(fù)制目的、文件流向、文件版本或內(nèi)容。2、源代碼

8、以任何介質(zhì)形式進(jìn)行存儲(chǔ)的備份，必須由專人負(fù)責(zé)保管。對于這些介質(zhì)地借閱，用于研發(fā)部內(nèi)部使用的必須獲得研發(fā)部經(jīng)理的授權(quán)，對于用于研發(fā)部以外使用的必須獲得總經(jīng)理的書面授權(quán)。3、源代碼的借閱、復(fù)制必須進(jìn)行詳細(xì)的登記，必需記錄借閱人、批準(zhǔn)人、借閱時(shí)間、借閱目的、文件流向、文件版本或內(nèi)容、歸還時(shí)間。4、任何紙質(zhì)材料的借閱都必需記錄借閱人、批準(zhǔn)人、借閱時(shí)間、借閱目的、文件流向、文件版本或內(nèi)容、歸還時(shí)間。5、對于因合作需要，需要向外復(fù)制、傳播、分發(fā)源代碼的，不論是全部還是部分代碼和資料，均必需和對方簽訂技術(shù)、源碼的保密協(xié)定，明確對方應(yīng)當(dāng)承擔(dān)的對源碼保密的責(zé)任和義務(wù)。6系統(tǒng)測試驗(yàn)收流程嚴(yán)格執(zhí)行代碼管理流程。對于

9、開發(fā)完成的系統(tǒng)進(jìn)行測試發(fā)布。測試發(fā)布流程如下：6.1 系統(tǒng)初驗(yàn)系統(tǒng)初驗(yàn)由技術(shù)開發(fā)部進(jìn)行單項(xiàng)測試，系統(tǒng)進(jìn)行聯(lián)調(diào)測試無誤后，由開發(fā)部編制項(xiàng)目測試報(bào)告，提交測試報(bào)告給匯測試部審核，完成系統(tǒng)初驗(yàn)。6.2 試運(yùn)行本系統(tǒng)集成后上線運(yùn)行三個(gè)月為試運(yùn)行期。由公司技術(shù)人員現(xiàn)場排除系統(tǒng)試運(yùn)行過程中出現(xiàn)的硬件故障及軟件故障，對于易出現(xiàn)問題的設(shè)備提供備用件。技術(shù)人員隨時(shí)解答業(yè)務(wù)人員在使用過程中出現(xiàn)的問題并進(jìn)行解決。6.3 系統(tǒng)終驗(yàn)正式驗(yàn)收主要圍繞設(shè)備的配置、功能、性能及各項(xiàng)技術(shù)參數(shù)指標(biāo)進(jìn)行，完成用戶整體的系統(tǒng)驗(yàn)收。當(dāng)整個(gè)系統(tǒng)進(jìn)入試運(yùn)行期，技術(shù)開發(fā)部提供行之有效的技術(shù)支持以確保整個(gè)業(yè)務(wù)的穩(wěn)定和有效地運(yùn)營，并確保整個(gè)業(yè)務(wù)

10、能夠順利通過系統(tǒng)驗(yàn)收。在此同時(shí)，技術(shù)開發(fā)部將通過具體的技術(shù)支持幫助匯運(yùn)維操作人員熟悉和掌握這些設(shè)備和維護(hù)技術(shù)。系統(tǒng)試運(yùn)行期是一個(gè)非常重要的時(shí)期。在此期間，由于運(yùn)維技術(shù)人員的技術(shù)水平、設(shè)備管理、設(shè)備操作和具體設(shè)備維護(hù)之間的磨合，將會(huì)出現(xiàn)許多意想不到的問題和人為故障。因此在系統(tǒng)試運(yùn)行期，技術(shù)開發(fā)人員需配合運(yùn)維人員提出的要求提供必要的現(xiàn)場技術(shù)支持，同時(shí)通過定期維護(hù)以避免設(shè)備故障的發(fā)生。在通過系統(tǒng)試運(yùn)行的情況下，技術(shù)開發(fā)的項(xiàng)目小組將和業(yè)務(wù)運(yùn)營人員以及運(yùn)維人員進(jìn)行系統(tǒng)終驗(yàn)。系統(tǒng)調(diào)試、驗(yàn)收程序：驗(yàn)收采取過程中定期抽檢、全檢，最后實(shí)行總體驗(yàn)收的方法進(jìn)行。程序?yàn)閳?bào)告申請驗(yàn)收，各有關(guān)單位會(huì)同驗(yàn)收，最后會(huì)簽認(rèn)同。

11、參見下圖：系統(tǒng)驗(yàn)收將由驗(yàn)收小組進(jìn)行，驗(yàn)收時(shí)做好記錄，簽署驗(yàn)收證書，并立檔、歸檔。當(dāng)驗(yàn)收不合格時(shí)，技術(shù)人員需無條件進(jìn)行返修。系統(tǒng)的安裝驗(yàn)收主要有以下內(nèi)容：(1)系統(tǒng)設(shè)備器材清單明細(xì)以及隨設(shè)備包裝的各種附件、資料等是否齊全；(2)各主要設(shè)備器材的外觀評(píng)估與內(nèi)在技術(shù)指標(biāo)確認(rèn)；(3)系統(tǒng)安裝整體外觀效果評(píng)估；(3)各系統(tǒng)工程各相關(guān)技術(shù)文件、現(xiàn)場檢查驗(yàn)收記錄等是否齊全；(4)系統(tǒng)的安裝客觀測試；(5)系統(tǒng)的工程安裝驗(yàn)收將按用戶需求進(jìn)行。6.4 系統(tǒng)驗(yàn)收標(biāo)準(zhǔn)項(xiàng)目的驗(yàn)收工作包括兩個(gè)方面的活動(dòng)：文檔評(píng)審和軟件產(chǎn)品包的測試與試運(yùn)行檢驗(yàn)，對于不同的驗(yàn)收活動(dòng)制定不同的驗(yàn)收通過標(biāo)準(zhǔn)。衡量被評(píng)審文檔或被測試軟件產(chǎn)品質(zhì)量

12、的一個(gè)重要指標(biāo)是：評(píng)審或測試發(fā)現(xiàn)的缺陷數(shù)。為進(jìn)一步明確文檔或軟件產(chǎn)品的質(zhì)量水平，需要對發(fā)現(xiàn)的缺陷按其嚴(yán)重程度進(jìn)行分類，在本項(xiàng)目中，將對缺陷分為四個(gè)等級(jí)，如下表所示：嚴(yán)重等級(jí)分類的解釋嚴(yán)重的缺陷對進(jìn)度的影響可能是非常致命的，或者可能是一個(gè)停止器一一即終止用戶繼續(xù)使用系統(tǒng)主要的相同類型的缺陷在很多程序或模塊中出現(xiàn)，需要改正每一個(gè)缺陷。例如，在任一程序中沒有遵守編程標(biāo)準(zhǔn)。或者，缺陷終止了用戶按正常方式繼續(xù)前進(jìn)，但可以繞行次要的這個(gè)缺陷是獨(dú)立的缺陷，或者不影響用戶繼續(xù)前進(jìn)，但會(huì)帶來不便普通的缺陷并不影響軟件產(chǎn)品的性能，例如，美觀問題和消息中的語法錯(cuò)誤等6.5 文檔評(píng)審?fù)ㄟ^標(biāo)準(zhǔn)按照評(píng)審對象的規(guī)模（頁數(shù)）

13、，根據(jù)評(píng)審?fù)度氲墓ぷ髁亢桶l(fā)現(xiàn)的缺陷數(shù)來確定是否通過評(píng)審：評(píng)審?fù)度氲墓ぷ髁浚ㄔu(píng)審準(zhǔn)備和評(píng)審會(huì)議的時(shí)間）：是否在一個(gè)合理的范圍內(nèi)，如果投入的評(píng)審時(shí)間過低，則不論發(fā)現(xiàn)的缺陷數(shù)如何，都不能通過評(píng)審。發(fā)現(xiàn)的陷數(shù)：是否在一個(gè)合理的范圍內(nèi)，如果發(fā)現(xiàn)的缺陷數(shù)太多，則不能通過評(píng)審。如果發(fā)現(xiàn)的缺陷數(shù)低于合理的水平，則需要分析評(píng)審過程和評(píng)審人員，以便確定是否通過評(píng)審。6.6 確認(rèn)測試通過標(biāo)準(zhǔn)對軟件產(chǎn)品包的確認(rèn)測試，根據(jù)測試用例質(zhì)量、執(zhí)行測試用例情況和發(fā)現(xiàn)的缺陷數(shù)來確定是否通過確認(rèn)測試：測試用例質(zhì)量：是否通過評(píng)審，如果測試用例沒有通過評(píng)審，則不能進(jìn)入確認(rèn)測試過程。測試用例的執(zhí)行：確認(rèn)測試過程必須保證執(zhí)行了所有的確認(rèn)測試用例數(shù)據(jù)，測試結(jié)果得到真實(shí)記錄。發(fā)現(xiàn)的陷數(shù)：與以前階段成果評(píng)審、軟件產(chǎn)品的集成測試和系統(tǒng)測試所發(fā)現(xiàn)的缺陷數(shù)相比，是否在一個(gè)合理的范圍內(nèi)。一般而言，確認(rèn)測試階段發(fā)現(xiàn)的缺陷數(shù)應(yīng)與確認(rèn)