1、源代碼管理制度(討論稿)一、總則為了加強公司產品、項目開發源代碼及相關技術文檔的管理，進 而確保項目實施的效率和質量，特制定本辦法。二、適用范圍產品、項目開發技術人員及項目實施負責人。三、定義項是指通過公司立項確定需要按期實施的項目。項目實施：是指為完成立項項目進行的階段性或特定領域的實施過程，主要包括研發實施和部署實施。源代碼：是指產品、項目研發過程中所產生的程序源代碼。技術文檔：是指產品、項目配套的各類設計文檔、操作手冊等技術性 文檔。版本管理服務器：指公司架設供所有開發人員使用的Subversion(SVN) 服務器。源代碼提交：指開發人員通過客戶端程序將所編寫源代碼上傳至版本 管理服務

2、器的操作過程。四、源代碼日常管理流程源代碼管理是技術研發過程的日常管理.，上要包括源代碼提交、 源代碼審閱、異常協調等兒個環節。準備五、源代碼結構設定源代碼結構是指源代碼在版本管理服務器上存放的文件夾結構。源代嗎結構的設定由項目實施負責人決定。源代碼結構設定有幾項基本要求：必須設置文檔文件夾：每一個獨立項目或子項目源代碼文件內， 至少設定一個docs或doc文件夾以存放僅與該項目相關技術文檔 和參考資料；必須考慮支持庫：源代碼結構中，應考慮具體項目所引用的非標 第三方支持庫或框架的存放位置；必須可以直接編譯：源代碼結構必須是可宜接編譯結構。即任何 一臺新裝計算機，在安裝了必要的開發環境軟件以后

3、，通過從版 本管理服務器上簽出整套源代碼后，應該可以直接完成編譯。六、500提交500提交是指項R實施期間,所有參與開發的技術人員,每日5:00 必須將當日所編制的源碼或技術文檔提交至版本管理服務器。源代碼及技術文檔提交有如下幾項要求：任何一次提交都必須對所提交內容進行注釋；提交注釋必須包含的信息項包括：所屬模塊或功能（必須與項目 實施進度計劃一致）、性質（正常開發、修改BUG、擴展功能）、 狀態（編碼中（x%）、調試通過、獨測通過、聯測通過）、更新說 明（本次提交所涉及修改部分的簡要說明）。提交注釋必須以下圖示例格式為準。Message:（ Recent messagesI質顯一拄忒功應廢如

4、法充題隹想.正知線然杰微硬勺（80+）更至說理。己經買羽毯咬條仔趣苦亙以懣過五谷專魂運三金品.龍三? 黑！I的舞E暴兼基融二愛溟整J所提交源碼必須是編譯無錯版本。七、530審閱530審閱是指項目實施負責人，每II下班前審閱版本服務器上所有下屬技術人員所提交的源代碼和技術文檔。源代碼審閱布以下兒點審閱標準：下屬技術人員必須全員按時提交；所7T提交必須附rr符合要求的提交注釋；各人所提交的內容必須與既定的項H實施進度計劃安排一致；審閱過程中，凡不符合上述任一條標準的，則表示當日源碼提交 出現異常。項目實施負責人應立即進行協調，未按時提交者督促其即 刻提交；沒有附提交注釋或注釋不符介要求者，補充提交

5、注釋；提交 內容與既定項目實施進度計劃安排不一致者，要進行溝通和協調，保 證參與實施人員的每H工作均按既定計劃分步實施。八、進度計劃更新項口實施負責人，通過53()審閱和必要的簡短溝通，確認各在執 行子任務的真實進度，并以此為準更新進度計劃文檔。九、版本庫布局版本庫按項FI布局，每一個項目建立一個獨立的版本庫，項目版 本庫下設置trunk和branches兩個文件夾，分別用于存放原始項目 資料和起源于原始項目的分支項Ho每個項目分支都應該有含義明確的命名，并以分支名稱在 branches文件夾下建立子文件夾。分支文件夾的結構與trunk文件 夾結構一致。trunk文件夾下設置working和l

6、ocked兩個文件夾，其中 working為工作文件夾，參與項目的開發人員有改寫權限。locked文 件夾為定版文件夾，項目開發人員無權訪問，項目實施負責人有改寫 權限，品監部有簽出權限。working文件夾下設置docs和projects兩個文件夾，其中docs 文件夾存放項目相關設計文檔，projects文件夾存放各子項目工程 文件夾。docs和projects文件夾以下子文件夾結構不做限定，但對于C/S 類項目建議在projects文件夾下設置server和client兩個文件夾, 分別存放服務端子項目資料和客戶端子項n資料。十、項目定版項目定版是指項目研發實施到某個進度計劃中設定的里程

7、碑狀 態或其他特定狀態時，整體提交的一個階段性版本。一些既定的定版 包括：系統聯機調試定版、內測定版、演示定版、實測定版、發布定 版、升級定版。對于項目定版有如下要求：項目所有子項目、子模塊源碼均編譯無錯;編譯所成系統可聯機運行；所有技術文檔與實現源碼一致；項目定版由項目實施負責人組織實施，實施過程在源代碼庫上面 體現為：working文件夾下最新版本的源碼和文檔被一次性完整的提 交到locked文件夾。項目定版操作建議：將locked文件夾檢出(Checkout)一個副本到本地文件夾； 將 workingdocs 和 workingprojects 兩個文件夾導出(Export)到locke

8、d副本文件夾，覆蓋locked文件夾下的原文件； > 提交(Commit) locked 文件夾;項目定版提交必須附提交注釋，注釋內容必須包含的項目包括： 定版目的（聯機調試、內測、演示、實測、發布、升級）、版本特性。 其中版本特性要進行詳細說明。如果是笫一個定版，版本特性應詳細 列舉已經實現的功能，后續定版提交注釋的版本特性說明則只需寫明 新版本較上一-個版本的新特性。十一、項目既定定版說明既定定版是指在項目研發實施過程中的必須設定的兒個階段性 版本。聯機調試定版：是指項口整體設計中的所有子系統和子模塊都已 經完成基礎開發，在研發實施團隊內部進行完整系統聯機調試通 過以后的版本。聯機調

9、試版本中的各個子系統和子模塊不需要完 整實現了所有既定功能，也不需要達到既定設計性能，可以存在 BUG,其主要作用是為研發實施團隊自身構建一個可供各功能模塊 進行聯機調試的系統環境，并確認系統整體設計的可實施性。聯 機調試定版后，研發實施團隊應撰寫系統部署手冊草案；內測定版：是指移交品監部進行系統測試的版本。內測版本應該 是通過若干次聯機調試，并且已經解決了所有聯機調試過程中所 發現問題以后的版本。內測定版不一定實現了所有的功能，但已 經實現的功能應該具備基本的穩定性；演示定版：是指通過若干次內測之后，不存在特別嚴重缺陷，可供商務人員向客戶進行產品功能和性能演示的版本。演示定版不一定實現了所有的功能，也不一定達到系統既定設計性能。實測定版：是指通過若干次內測之后，不存在影響正常使用的缺 陷，可供在客戶真實環境試用的版本。實測定版應該實現了所有 核心功能，允許少量存在不確定因素的功能缺失；發布定版：是指通過若干次內測和實測之后，已經實現了所有既 定