源代碼管理規(guī)范

1、1源代碼管理21.1 總則21.2 源代碼完整性保障21.3 源代碼的授權(quán)訪問31.4 代碼版本管理31.5 源代碼復(fù)制和傳播51.6 系統(tǒng)測試驗收流程61.6.1 系統(tǒng)初驗61.6.2 試運行61.6.3 系統(tǒng)終驗71.6.4 應(yīng)用系統(tǒng)驗收標(biāo)準(zhǔn)91.6.5 文檔評審?fù)ㄟ^標(biāo)準(zhǔn)91.6.6 確認(rèn)測試通過標(biāo)準(zhǔn)101.6.7 系統(tǒng)試運行通過標(biāo)準(zhǔn)101代碼管理1.1總、則1、為保障公司源代碼和開發(fā)文檔安全不至于泄露，保證源代碼的完整，明確源代碼控制管理流程，特制定此管理辦法。2、本辦法適用于所有涉及接觸源代碼的各部門各崗位。所涉及部門都必須嚴(yán)格執(zhí)行本管理辦法。3、源代碼直接控制管理部門為技術(shù)開發(fā)部。4

2、、本辦法管理重點在于控制管理源代碼的完整性，不被非授權(quán)獲取，不被非授權(quán)復(fù)制和傳播。5、本辦法所指源代碼不僅限于公司開發(fā)人員自行編寫實現(xiàn)功能的程序代碼，而且還包括相應(yīng)的開發(fā)設(shè)計文檔及用于支撐整個系統(tǒng)運行所必須具備的第三方軟件、控件和其它支撐庫等文件。1.2源代碼完整性保障1、所有軟件的源代碼文件及相應(yīng)的開發(fā)設(shè)計文檔均必須及時加入到指定的源代碼服務(wù)器中的指定庫中。2、我們研發(fā)的產(chǎn)品軟件運行所必須的第三方軟件、控件和其它支撐庫等文件也必須及時加入源代碼服務(wù)器中指定的庫中。3、軟件開始編寫或者調(diào)整代碼之前，其相應(yīng)的設(shè)計文檔和代碼必須先從相應(yīng)的SVNS進(jìn)行SVNUpdate®作。軟件編碼或功能

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

4、代碼。如果不能確定，必須對計算機(jī)中所有硬盤進(jìn)行全面格式化后方可以轉(zhuǎn)做它用或離開研發(fā)部門。代碼版本管理1、終端軟件的版本標(biāo)識管理終端軟件版本由終端型號、版本號和內(nèi)部修訂號來進(jìn)行標(biāo)識。終端型號：終端型號是硬件標(biāo)識號，也唯一的標(biāo)識了我們的項目。版本號：由“主版本號>.<次版本號>.修訂號”三段組成，中間是點號分開。版本號的目的主要是管理終端軟件的對外發(fā)布，終端軟件的BUG的記錄和統(tǒng)計，主要是針對于版本號的，測試部、項目部、客戶等會記錄某個版本號的終端軟件存在哪些BUG,BUG會在哪個版本號中得到修正；終端軟件一個新的版本號出來后，我們會統(tǒng)計新的版本號解決了上一個版本號中的哪些BUG

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

6、要發(fā)布更新包，以便用戶能夠使用，所以，在一個版本號發(fā)布后，需要進(jìn)行多次修訂，對于這些修訂的版本，其版本號保持不變，內(nèi)部修訂發(fā)生變化。軟件BUG記錄、管理和統(tǒng)計軟件BUG的記錄、管理和統(tǒng)計主要以版本號為基準(zhǔn)，但為了軟件開發(fā)人員能夠找到BUG的出處，需要用戶、測試人員在報告和驗證BUG時，輸入內(nèi)部修訂號。件配輅組對版本的記錄軟件版本記錄的目標(biāo)有兩個：記錄軟件版本的發(fā)布?xì)v史；發(fā)布的每一個版本，都要能夠唯一的從源代碼庫（SVN）中找到對應(yīng)的全部源代碼。測試方案作為軟件開發(fā)的重要環(huán)節(jié)，作為交付成功的優(yōu)質(zhì)的產(chǎn)品的重要保證手段和方法，軟件測試越來越受到項目的重視。要做好測試首先要做好測試的組織、管理、計設(shè)、

7、實施等工作。系統(tǒng)測試方案概述測試是指在軟件投入運行前，對軟件需求分析、設(shè)計規(guī)格說明和編碼的最終復(fù)審，是軟件質(zhì)量保證的關(guān)鍵步驟。測試的目標(biāo)：以較少的用例、時間和人力找出軟件中潛在的各種錯誤和缺陷，以確保系統(tǒng)的質(zhì)量。在實際項目中，測試作為軟件開發(fā)生命周期中的一個重要過程，但從其具體工作的前后過程來看，它又是由一系列的不同測試所組成，這些測試的步驟分為：單元測試、集成測試（又稱組裝測試）、確認(rèn)測試和系統(tǒng)測試。軟件開發(fā)的過程是自頂向下的，測試則正好相反，以上這些過程就是自底向上，逐步集成的。在項目過程中，我們按以上的測試步驟完成系統(tǒng)的測試。源代碼復(fù)制和傳播1、源代碼向研發(fā)部門以外復(fù)制必須獲得總經(jīng)理的書

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

9、定，明確對方應(yīng)當(dāng)承擔(dān)的對源碼保密的責(zé)任和義務(wù)。系統(tǒng)測試驗收流程貴州匯聯(lián)通公司技術(shù)開發(fā)部分是外包給上海華騰公司完成，嚴(yán)格執(zhí)行外包管理流程。對于開發(fā)完成的系統(tǒng)進(jìn)行測試驗收。測試驗收流程如下：系統(tǒng)初驗系統(tǒng)初驗由華騰公司技術(shù)開發(fā)部進(jìn)行單項測試，系統(tǒng)進(jìn)行聯(lián)調(diào)測試無誤后，由華騰公司將編制項目測試報告，提交測試報告給匯聯(lián)通公司審核，完成系統(tǒng)初驗。試運行本系統(tǒng)集成后上線運行三個月為試運行期。由華騰公司現(xiàn)場排除系統(tǒng)試運行過程中出現(xiàn)的硬件故障及軟件故障，對于易出現(xiàn)問題的設(shè)備提供備用件華騰公司需提供熱線電話，為我公司使用過程中出現(xiàn)的問題進(jìn)行解決。華騰公司應(yīng)我公司技術(shù)人員的要求，隨時講解系統(tǒng)的結(jié)構(gòu)及設(shè)計，包括硬件性能

10、、系統(tǒng)軟件、備份結(jié)構(gòu)特點。系統(tǒng)終驗正式驗收主要圍繞設(shè)備的配輅、功能、性能及各項技術(shù)參數(shù)指標(biāo)進(jìn)行，完成用戶整體的系統(tǒng)驗收。當(dāng)整個系統(tǒng)進(jìn)入試運行期，華騰公司需向我公司提供行之有效的技術(shù)支持以確保整個業(yè)務(wù)的穩(wěn)定和有效地運營，并確保整個業(yè)務(wù)能夠順利通過系統(tǒng)驗收。在此同時，華騰公司將通過具體的技術(shù)支持幫助匯聯(lián)通公司操作人員熟悉和掌握這些設(shè)備和維護(hù)技術(shù)。系統(tǒng)試運行期是一個非常重要的時期。在此期間，由于匯聯(lián)通公司技術(shù)人員的技術(shù)水平、設(shè)備管理、設(shè)備操作和具體設(shè)備維護(hù)之間的磨合，將會出現(xiàn)許多意想不到的問題和人為故障。因此在系統(tǒng)試運行期，華騰公司需配合匯聯(lián)通公司的要求提供必要的現(xiàn)場技術(shù)支持，同時通過定期維護(hù)以避免

11、設(shè)備故障的發(fā)生。在通過系統(tǒng)試運行的情況下，華騰公司項目小組將和匯聯(lián)通公司進(jìn)行系統(tǒng)終驗。系統(tǒng)調(diào)試、驗收程序：驗收采取過程中定期抽檢、全檢，最后實行總體驗收的方法進(jìn)行。程序為報告申請驗收，各有關(guān)單位會同驗收，最后會簽認(rèn)同。參見下圖：驗收結(jié)果必須交由雙方共同確認(rèn)有效，方可存檔。雙方各一份備案。系統(tǒng)驗收將由驗收小組進(jìn)行，驗收時做好記錄，簽署驗收證書，并立檔、歸檔。當(dāng)驗收不合格時，華騰公司需無條件進(jìn)行返修。系統(tǒng)的安裝驗收主要有以下內(nèi)容：(1)系統(tǒng)設(shè)備器材清單明細(xì)以及隨設(shè)備包裝的各種附件、資料等是否齊全；(2)各主要設(shè)備器材的外觀評估與內(nèi)在技術(shù)指標(biāo)確認(rèn)；(3)系統(tǒng)安裝整體外觀效果評估；(3)各系統(tǒng)工程各相

12、關(guān)技術(shù)文件、現(xiàn)場檢查驗收記錄等是否齊全；(4)系統(tǒng)的安裝客觀測試；(5)系統(tǒng)的工程安裝驗收將按用戶需求進(jìn)行。1.6.4系統(tǒng)驗收標(biāo)準(zhǔn)項目的驗收工作包括兩個方面的活動：文檔評審和軟件產(chǎn)品包的測試與試運行檢驗，對于不同的驗收活動制定不同的驗收通過標(biāo)準(zhǔn)。衡量被評審文檔或被測試軟件產(chǎn)品質(zhì)量的一個重要指標(biāo)是：評審或測試發(fā)現(xiàn)的缺陷數(shù)。為進(jìn)一步明確文檔或軟件產(chǎn)品的質(zhì)量水平，需要對發(fā)現(xiàn)的缺陷按其嚴(yán)重程度進(jìn)行分類，在本項目中，將對缺陷分為四個等級，如下表所示：嚴(yán)重等級分類的解釋嚴(yán)重的缺陷對進(jìn)度的影響可能是非常致命的，或者可能是一個停止器一一即終止用戶繼續(xù)使用系統(tǒng)主要的相同類型的缺陷在很多程序或模塊中出現(xiàn)，需要改正

13、每一個缺陷。例如，在任一程序中沒有遵守編程標(biāo)準(zhǔn)?；蛘撸毕萁K止了用戶按正常方式繼續(xù)前進(jìn)，但可以繞行次要的這個缺陷是獨立的缺陷，或者不影響用戶繼續(xù)前進(jìn)，但會帶來不便普通的缺陷并不影響軟件產(chǎn)品的性能，例如，美觀問題和消息中的語法錯誤等1.6.5文檔評審?fù)ㄟ^標(biāo)準(zhǔn)按照評審對象的規(guī)模（頁數(shù)），根據(jù)評審?fù)度氲墓ぷ髁亢桶l(fā)現(xiàn)的缺陷數(shù)來確定是否通過評審：評審?fù)度氲墓ぷ髁浚ㄔu審準(zhǔn)備和評審會議的時間）：是否在一個合理的范圍內(nèi)，如果投入的評審時間過低，則不論發(fā)現(xiàn)的缺陷數(shù)如何,都不能通過評審。發(fā)現(xiàn)的陷數(shù)：是否在一個合理的范圍內(nèi)，如果發(fā)現(xiàn)的缺陷數(shù)太多，則不能通過評審。如果發(fā)現(xiàn)的缺陷數(shù)低于合理的水平，則需要分析評審過程和評審人員，以便確定是否通過評審。1.6.6確認(rèn)測試通過標(biāo)準(zhǔn)對軟件產(chǎn)品包的確認(rèn)測試，根據(jù)測試用例質(zhì)量、執(zhí)行測試用例情況和發(fā)現(xiàn)的缺陷數(shù)來確定是否通過確認(rèn)測試：測試用例質(zhì)量：是否通過評審，如果測試用例沒有通過評審，則不能進(jìn)入確認(rèn)測試過程。測試用例的執(zhí)行：確認(rèn)測試過程必須保證執(zhí)行了所有的確認(rèn)測試用例數(shù)據(jù)，測試結(jié)果得到真實記錄。發(fā)現(xiàn)的陷數(shù)：與以前階段成果評審、軟件產(chǎn)品的集成測試和系統(tǒng)測試所發(fā)現(xiàn)的缺陷數(shù)相比，是否在一個合理的范圍內(nèi)。一般而言，確認(rèn)測試階段發(fā)