001軟件配置管理規(guī)范.doc

4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 1/24 文件編號std-zs-kf-2010-001 中山森中山森創(chuàng)創(chuàng)信息技信息技術(shù)術(shù)有限公司有限公司 版本/修改a/0 文件名稱文件名稱軟件配置管理規(guī)范頁數(shù)共 22 頁 中山森創(chuàng)信息技術(shù)有限公司中山森創(chuàng)信息技術(shù)有限公司 軟件配置管理規(guī)范軟件配置管理規(guī)范 版權(quán)所有，未經(jīng)雙方許可不得復(fù)制或?qū)ν鈧鏖啺鏅?quán)所有，未經(jīng)雙方許可不得復(fù)制或?qū)ν鈧鏖?4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 2/24 目目 錄錄 1配置管理目標(biāo)配置管理目標(biāo).3 2配置管理的主要內(nèi)容配置管理的主要內(nèi)容.3 3配置管理角色、職責(zé)及權(quán)限配置管理角色、職責(zé)及權(quán)限.4 3.1配置經(jīng)理.4 3.2項(xiàng)目負(fù)責(zé)人.4 3.3配置管理員（cmo）.5 3.4開發(fā)人員.5 3.5軟件測試人員.5 3.6軟件維護(hù)人員.6 3.7質(zhì)量保證人員.6 3.8角色、權(quán)限圖.6 4配置管理過程配置管理過程.8 5配置管理工具及環(huán)境配置管理工具及環(huán)境.9 5.1文件服務(wù)器.9 5.2配置管理工具.9 5.3配置服務(wù)器.9 6配置管理計(jì)劃配置管理計(jì)劃.10 6.1配置工具的選擇.10 6.2配置庫的基本目錄結(jié)構(gòu).10 6.3權(quán)限設(shè)置.11 6.4配置項(xiàng)標(biāo)識(shí)規(guī)定.11 6.5協(xié)作開發(fā)規(guī)定.11 6.6其它.11 7配置項(xiàng)管理配置項(xiàng)管理.11 7.1配置項(xiàng)標(biāo)識(shí)號命名規(guī)范.12 7.2配置項(xiàng)名稱命名規(guī)范.13 7.3程序文件、數(shù)據(jù)文件.14 8基線建立及變更管理基線建立及變更管理.14 9文檔版本管理文檔版本管理.16 9.1.文檔版本及版本號的概念.16 9.2.版本號的定義及生成方法.16 9.3.定版的具體操作方法.17 9.4.定版的具體操作方法.17 10軟件版本管理軟件版本管理.18 10.1定版的具體操作方法.18 10.2版本號的定義及生成方法.18 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 3/24 10.3定版的具體操作方法.19 10.4在 vss 上定版的具體操作方法20 10.5版本發(fā)布流程.20 10.6版本保存.20 11公用程序庫的建立及公用程序庫的建立及維維護(hù)護(hù).21 12配置庫的安全管理配置庫的安全管理.21 12.1版本保存.21 12.2配置服務(wù)器的安全控制.21 12.3配置庫備份.21 12.4配置管理平臺(tái)維護(hù).22 13工作空間管理工作空間管理.22 14變更文件的審批與確認(rèn)變更文件的審批與確認(rèn).22 1配置管理目標(biāo)配置管理目標(biāo) 通過實(shí)施配置管理活動(dòng)，令項(xiàng)目開發(fā)團(tuán)隊(duì)工作在一個(gè)規(guī)范的配置管理平臺(tái)上，從而提高 軟件產(chǎn)品質(zhì)量、提高軟件開發(fā)的整體工作效率，達(dá)到用戶滿意。同時(shí)，通過配置管理活動(dòng)， 將項(xiàng)目開發(fā)過程中所有的產(chǎn)出、開發(fā)活動(dòng)、管理活動(dòng)等進(jìn)行記錄，以方便今后的軟件維護(hù)及 類似項(xiàng)目的參照。 2 配置管理的主要內(nèi)容配置管理的主要內(nèi)容 軟件開發(fā)的配置管理主要包括以下內(nèi)容： 配置項(xiàng)標(biāo)識(shí)的管理； 配置庫的建立及變更管理； 版本控制； 配置管理計(jì)劃編制； 公用程序庫的建立及維護(hù)； 配置庫的安全管理； 小組協(xié)作管理； 工作空間管理； 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 4/24 3 配置管理角色、職責(zé)及權(quán)限配置管理角色、職責(zé)及權(quán)限 在配置管理平臺(tái)下，軟件開發(fā)人員按照不同的角色的要求、根據(jù)系統(tǒng)賦予的權(quán)限來執(zhí)行 相應(yīng)的動(dòng)作。具體主要涉及下列的角色和分工： 3.13.1 配置經(jīng)理配置經(jīng)理 負(fù)責(zé)指導(dǎo)和控制部門配置管理的各項(xiàng)具體活動(dòng)的進(jìn)行，為項(xiàng)目經(jīng)理的決策提供建議。配 置經(jīng)理由指定的專人兼任，其具體職責(zé)為以下幾項(xiàng)： 建立、管理部門配置管理平臺(tái)； 建立項(xiàng)目配置庫； 配置庫的備份等安全管理； 制定配置管理規(guī)范； 輔助項(xiàng)目組建立配置管理環(huán)境； 審核配置管理計(jì)劃； 指導(dǎo)項(xiàng)目組配置管理活動(dòng)； 監(jiān)督、考核各項(xiàng)目組配置管理活動(dòng)的執(zhí)行情況。 3.23.2 項(xiàng)目負(fù)責(zé)人項(xiàng)目負(fù)責(zé)人 項(xiàng)目負(fù)責(zé)人根據(jù)配置管理員的建議，批準(zhǔn)、監(jiān)督該項(xiàng)目配置管理的各項(xiàng)活動(dòng)并控制它們 的進(jìn)程。其具體職責(zé)為以下幾項(xiàng)： 參與規(guī)劃、制定和修改項(xiàng)目配置管理策略； 批準(zhǔn)、發(fā)布配置管理計(jì)劃； 決定項(xiàng)目起始基線和開發(fā)里程碑； 建立基線，審核基線變更申請； 制定配置管理相關(guān)權(quán)限策略； 監(jiān)控配置管理過程； 項(xiàng)目負(fù)責(zé)人可以查看該項(xiàng)目配置庫中配置項(xiàng)，在允許的權(quán)限內(nèi)可以對配置項(xiàng)進(jìn)行增、刪、 改。 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 5/24 3.33.3 配置管理員（配置管理員（cmocmo） 各項(xiàng)目組指定配置管理員，配置管理員根據(jù)配置管理計(jì)劃執(zhí)行該項(xiàng)目各項(xiàng)配置管理任務(wù)， 其具體職責(zé)為以下幾項(xiàng)： 編制、提交配置管理計(jì)劃； 嚴(yán)格管理配置項(xiàng)的操作權(quán)限； 執(zhí)行版本控制流程； 執(zhí)行變更控制方案； 建立開發(fā)人員的工作空間； 對開發(fā)人員進(jìn)行相關(guān)的培訓(xùn)； 項(xiàng)目小組開發(fā)協(xié)作管理； 各配置項(xiàng)的日常管理與維護(hù)； 識(shí)別配置管理過程中存在的問題并擬就解決方案； 向配置經(jīng)理、項(xiàng)目負(fù)責(zé)人定期匯報(bào)項(xiàng)目組配置管理情況。 配置管理員可以查看該項(xiàng)目配置庫中配置項(xiàng)，在允許的權(quán)限內(nèi)可以對配置項(xiàng)進(jìn)行增、刪、 改。 3.43.4 開發(fā)人員開發(fā)人員 開發(fā)人員的職責(zé)就是根據(jù)軟件配置管理計(jì)劃和相關(guān)規(guī)定，按照軟件配置管理工具的使用 方式來完成開發(fā)任務(wù)。 開發(fā)人員可以查看、修改項(xiàng)目配置庫中有權(quán)限的配置項(xiàng)，但不允許對配置項(xiàng)進(jìn)行永久刪 除操作。 3.53.5 軟件測試人員軟件測試人員 軟件測試人員的職責(zé)就是根據(jù)軟件配置管理計(jì)劃和相關(guān)規(guī)定，按照軟件配置管理工具的 使用方式來完成軟件測試任務(wù)。 軟件測試人員可以查看軟件的相關(guān)開發(fā)文檔，在權(quán)限范圍內(nèi)可以對配置項(xiàng)增加、修改， 但不允許對配置項(xiàng)進(jìn)行永久刪除操作。 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 6/24 3.63.6 軟件維護(hù)人員軟件維護(hù)人員 軟件維護(hù)人員的職責(zé)就是根據(jù)軟件配置管理計(jì)劃和相關(guān)規(guī)定，按照軟件配置管理工具的 使用方式來完成軟件維護(hù)任務(wù)。 軟件維護(hù)人員可以查看、修改該人員負(fù)責(zé)維護(hù)的軟件的相關(guān)開發(fā)文檔、源程序，在權(quán)限 范圍內(nèi)可以對配置項(xiàng)增加、修改，但不允許對配置項(xiàng)進(jìn)行永久刪除操作。 3.73.7 質(zhì)量保證人員質(zhì)量保證人員 質(zhì)量保證人員的職責(zé)就是根據(jù)軟件配置管理計(jì)劃和相關(guān)規(guī)定，按照軟件配置管理工具的 使用模型來完成質(zhì)量保證任務(wù)。 質(zhì)量保證人員可以查看軟件的相關(guān)開發(fā)文檔，在權(quán)限范圍內(nèi)可以對配置項(xiàng)增加、修改， 但不允許對配置項(xiàng)進(jìn)行永久刪除操作。 3.83.8 角色、權(quán)限圖角色、權(quán)限圖 以下角色、權(quán)限圖主要針對 vss 配置管理工具。 角色 project 配置經(jīng)理 項(xiàng)目經(jīng)理配置管理員開發(fā)人員軟件測試人員質(zhì)量保證人 員 準(zhǔn)備階段 rrcarcad r (ca 授權(quán)) r r (ca 授權(quán)) 需求分析階段 rrcarcad r (ca 授權(quán)) rr 系統(tǒng)設(shè)計(jì)階段 rrcarcad r (ca 授權(quán))無 r 系統(tǒng)實(shí)現(xiàn)階段 rrcarcad r (ca 授權(quán))無無 系統(tǒng)測試階段 rrcarcadrcarcar 系統(tǒng)維護(hù)階段 rrcarcad r (ca 授權(quán))無 r 質(zhì)量保證 rrrcadrrrca 項(xiàng)目管理 rrcarcadr 無 r 配置管理 rrrcadrrr 測試管理 rrrcadrrcar 個(gè)人工作庫 r 無 rcadrcad 無無 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 7/24 項(xiàng)目共享庫 rrcarcadrrr 項(xiàng)目基線庫 r r (ca 授權(quán)) rcad r (ca 授權(quán))r (ca 授權(quán)) rca 注： 1.權(quán)限 r表示具有 read 權(quán)限。 c表示具有 check in/check out 權(quán)限。 a表示具有 add/rename/delete 權(quán)限。 d表示具有 destroy 權(quán)限。 無表示不具有該項(xiàng)權(quán)限。 授權(quán)表示需要項(xiàng)目負(fù)責(zé)人根據(jù)需要配置相應(yīng)權(quán)限。 2.由于配置管理員具有最高權(quán)限，可以進(jìn)行任何操作，但執(zhí)行非 read 操作時(shí)必須經(jīng) 項(xiàng)目負(fù)責(zé)人同意。 3. 個(gè)人工作空間允許擁有者進(jìn)行任何操作，包括 destroy 操作。 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 8/24 4 配置管理過程配置管理過程 開 始 配置管理策劃 評審 不通過 建立配置管理環(huán)境 通過 配置、標(biāo)識(shí)和 管理 變更控制版本控制 基線審核和發(fā) 布 報(bào)告狀態(tài) 發(fā)布產(chǎn)品 結(jié)束 配置管理的策劃由項(xiàng)目組配置管理員負(fù)責(zé)，策劃的結(jié)果為配置管理計(jì)劃； 配置管理策劃的評審由開發(fā)部配置經(jīng)理、項(xiàng)目經(jīng)理進(jìn)行評審，形成相關(guān)的評審紀(jì)錄； 配置管理環(huán)境由開發(fā)部配置經(jīng)理負(fù)責(zé)； 配置庫的具體管理由配置管理員負(fù)責(zé)，形成相關(guān)的記錄，包括配置項(xiàng)信息登記表 、配置管理周報(bào)、配置管理工作表、軟件配置管理評分表、變更申 請記錄表、應(yīng)用軟件版本發(fā)布申請表、版本記錄表、變更文件審批與 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 9/24 確認(rèn)登記表。 5配置管理工具及環(huán)境配置管理工具及環(huán)境 5.15.1 文件服務(wù)器文件服務(wù)器 在開發(fā)部建立獨(dú)立的文件服務(wù)器，文件服務(wù)器的主要作用為： 提供共享程序服務(wù) 將常用應(yīng)用程序（包括開發(fā)工具、數(shù)據(jù)庫工具、管理工具等）存放共享目錄下，方便各 開發(fā)人員隨時(shí)使用，并提供共享目錄以便各開發(fā)人員上傳共享程序。 提供共享資料服務(wù) 將常用資料存放共享目錄下，方便各開發(fā)人員隨時(shí)使用，并提供共享目錄以便各開發(fā)人 員上傳共享文檔。 提供開發(fā)人員個(gè)人空間 為每個(gè)開發(fā)人員建立個(gè)人目錄，開發(fā)人員可將關(guān)鍵文檔在文件服務(wù)器上進(jìn)行備份。此為 開發(fā)人員的私有目錄，別人無權(quán)訪問。 5.25.2 配置管理工具配置管理工具 可采用以下配置管理工具： microsoft visual sourcesafe(vss) 基于 windows 的開發(fā)采用 microsoft visual sourcesafe(vss)作為配置管理工具。 基于 unix 下的開發(fā)采用 samba 作為磁盤映射工具，microsoft visual sourcesafe(vss) 作為配置管理工具。 cvs 工具 基于 unix 下的開發(fā)采用 cvs 作為程序版本控制工具，同時(shí)在 windows 環(huán)境下 用vss 建立項(xiàng)目文檔等配置項(xiàng)的管理環(huán)境。 5.35.3 配置服務(wù)器配置服務(wù)器 在開發(fā)部建立統(tǒng)一的配置服務(wù)器，逐步進(jìn)行配置庫的集中管理，項(xiàng)目組內(nèi)部不再單 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 10/24 獨(dú)設(shè)立配置服務(wù)器。 配置服務(wù)器今后將成為軟件開發(fā)的項(xiàng)目庫，記錄所有軟件開發(fā)項(xiàng)目的開發(fā)及維護(hù)過 程。對新項(xiàng)目的開發(fā)，項(xiàng)目負(fù)責(zé)人可以申請查閱配置庫中相類似的項(xiàng)目資料，以更好地 把握新項(xiàng)目的開發(fā)。 配置服務(wù)器也是開發(fā)部的公用程序庫服務(wù)器。各項(xiàng)目組在項(xiàng)目開發(fā)過程中有義務(wù)將 通用的程序模塊放入公用程序庫中，被其他項(xiàng)目組使用，達(dá)到程序共享，避免重復(fù)開發(fā)。 公用程序庫的建立及維護(hù)見第八章。 6 配置管理計(jì)劃配置管理計(jì)劃 配置管理計(jì)劃應(yīng)細(xì)化以下內(nèi)容： 6.16.1 配置工具的選擇配置工具的選擇 配置管理計(jì)劃中明確采用的配置工具，如采用 unix 下的 cvs 工具，還必須編寫完善 的配置操作腳本，并注明使用方法。 6.26.2 配置庫的基本目錄結(jié)構(gòu)配置庫的基本目錄結(jié)構(gòu) 根據(jù)具體的項(xiàng)目設(shè)置配置庫的基本目錄結(jié)構(gòu)，并進(jìn)行基本的解釋，一般可以包含以下的 一級目錄及二級目錄： 01 項(xiàng)目工作庫 01 準(zhǔn)備階段 02 需求分析階段 03 系統(tǒng)設(shè)計(jì)階段 04 系統(tǒng)實(shí)現(xiàn)階段 05 系統(tǒng)測試階段 06 運(yùn)行推廣階段 07 系統(tǒng)維護(hù)階段 02 項(xiàng)目管理庫 01 質(zhì)量保證 02項(xiàng)目管理 03配置管理 04測試管理 03 項(xiàng)目共享庫 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 11/24 01 項(xiàng)目模版 02 項(xiàng)目規(guī)范 03 項(xiàng)目制度 04 共享資料 04 項(xiàng)目基線庫 01 計(jì)劃基線 02 需求基線 03 設(shè)計(jì)基線 04 產(chǎn)品基線 05 個(gè)人工作庫 下設(shè)每個(gè)項(xiàng)目組成員的目錄 06 其他 6.36.3 權(quán)限設(shè)置權(quán)限設(shè)置 明確項(xiàng)目組成員對各配置目錄的操作權(quán)限。 6.46.4 配置項(xiàng)標(biāo)識(shí)規(guī)定配置項(xiàng)標(biāo)識(shí)規(guī)定 根據(jù)項(xiàng)目規(guī)模和實(shí)際情況的不同，在項(xiàng)目的配置管理計(jì)劃中詳細(xì)規(guī)定配置項(xiàng)標(biāo)識(shí)的命名 規(guī)則。 6.56.5 協(xié)作開發(fā)規(guī)定協(xié)作開發(fā)規(guī)定 在項(xiàng)目的配置管理計(jì)劃中，必須對項(xiàng)目組的協(xié)作開發(fā)作相應(yīng)的規(guī)定，比如，項(xiàng)目成員每 日的工作是否必須提交？更改了公用頭文件如何通知項(xiàng)目組成員？等等，具體項(xiàng)目具體規(guī)定。 6.66.6 其它其它 7 配置項(xiàng)管理配置項(xiàng)管理 配置項(xiàng)是配置管理的對象，主要包括各種開發(fā)/測試文檔、源程序、測試腳本、關(guān)鍵數(shù) 據(jù)、項(xiàng)目報(bào)告、會(huì)議紀(jì)要等。通過建立配置庫對配置項(xiàng)的維護(hù)、變更等進(jìn)行管理，對配置項(xiàng) 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 12/24 要進(jìn)行統(tǒng)一的配置標(biāo)識(shí)管理及名稱管理。配置標(biāo)識(shí)就是為產(chǎn)品的結(jié)構(gòu)、產(chǎn)品的構(gòu)件及其類型， 分配唯一的標(biāo)識(shí)符，具體項(xiàng)目可根據(jù)項(xiàng)目規(guī)模和實(shí)際情況的不同，在項(xiàng)目的配置管理計(jì)劃中 進(jìn)一步補(bǔ)充、刪減、細(xì)化配置項(xiàng)標(biāo)識(shí)的命名規(guī)則。開發(fā)部的配置項(xiàng)標(biāo)識(shí)及名稱總體規(guī)則如下： 7.17.1 配置項(xiàng)標(biāo)識(shí)號命名規(guī)范配置項(xiàng)標(biāo)識(shí)號命名規(guī)范 配置項(xiàng)標(biāo)識(shí)號命名規(guī)則： 項(xiàng)目名標(biāo)識(shí)-配置類別-子系統(tǒng)標(biāo)識(shí)-組成部分標(biāo)識(shí)-模塊標(biāo)識(shí)-配置項(xiàng)特殊標(biāo)識(shí)， 其中中的內(nèi)容可根據(jù)系統(tǒng)規(guī)模和實(shí)際情況有所省略，項(xiàng)目名標(biāo)識(shí)、配置項(xiàng)特殊標(biāo) 識(shí)一般是約定俗成的英文代碼名。 下表列出了我們在項(xiàng)目中使用的配置類別命名： 配置類別配置類別說明說明常用配置項(xiàng)特殊標(biāo)識(shí)舉例常用配置項(xiàng)特殊標(biāo)識(shí)舉例 pdp(project development plan) 項(xiàng)目開發(fā)計(jì)劃 cmp(configure management plan)配置管理計(jì)劃 qap(quality assurance plan)質(zhì)量保證計(jì)劃 frr(feasibility research report)可行性研究 init準(zhǔn)備階段其他文檔準(zhǔn)備階段其他文檔 crs(client requirement statement)客戶需求 srs(software requirement statement) 需求規(guī)格說明書 ra(requirement analyse)需求分析階段其他文檔需求分析階段其他文檔 eis(external interface statement)外部接口規(guī)范說明文檔 hld(holistic design)概要設(shè)計(jì)文檔總體方案：-totle dds(detail design statement)詳細(xì)設(shè)計(jì)文檔 dbd(database design)數(shù)據(jù)庫設(shè)計(jì)文檔數(shù)據(jù)字典：-dictionary design 設(shè)計(jì)階段其他文檔設(shè)計(jì)階段其他文檔 軟件架構(gòu)設(shè)計(jì)： -architecture；階段計(jì)劃： -plan；階段總結(jié)報(bào)告： -summarize scode(source code)源代碼文件 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 13/24 ecode（executable code）執(zhí)行代碼文件 cf(configure file)配置文件 code實(shí)現(xiàn)階段其他文檔實(shí)現(xiàn)階段其他文檔 階段計(jì)劃：-plan；階段總結(jié) 報(bào)告：-summarize utest(unit test)單元測試文檔單元測試記錄：-record itest(integration test)集成測試文檔集成測試記錄：-record test測試階段文檔測試階段文檔 測試計(jì)劃：-plan；測試方案： -scheme；測試案例：-case 測試記錄：-record；測試問 題：-problem；測試分析報(bào) 告:-summarize man軟件說明書和手冊 操作手冊：-operate；用戶手 冊：-user；維護(hù)手冊：- maintenance；安裝手冊：-setup issue產(chǎn)品發(fā)行文檔產(chǎn)品發(fā)行文檔發(fā)行記錄：-record delivery交付階段文檔交付階段文檔 switch切換階段文檔切換階段文檔切換方案：-scheme smsyyyymm0199 (software maintain statement) 軟件維護(hù)說明書 maintain維護(hù)階段其他文檔維護(hù)階段其他文檔維護(hù)記錄：-record pds(project development summarize)項(xiàng)目開發(fā)總結(jié)報(bào)告 rtm(requirement track matric)需求跟蹤矩陣 cryyyymm0199(change record)變更控制號 pryyyymmddaz(peer review)評審號 train培訓(xùn)記錄和培訓(xùn)文檔培訓(xùn)記錄：-record project項(xiàng)目其他文檔 注 1：粗體部分的配置類別是按軟件生存周期的階段劃分的，如配置項(xiàng)具有明確的階段 性，但不屬于某類具體的配置類別，則納入所屬階段的配置類別中；如是貫穿項(xiàng)目多個(gè) 階段或歸屬于項(xiàng)目整體的配置項(xiàng)，且不屬于某類具體的配置類別，則納入“project”配置 類別中。 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 14/24 7.27.2 配置項(xiàng)名稱命名規(guī)范配置項(xiàng)名稱命名規(guī)范 開發(fā)技術(shù)文檔名稱通過項(xiàng)目名稱標(biāo)識(shí)或項(xiàng)目簡稱文檔類別名稱進(jìn)行命名，主要包括以下文 檔： 可行性研究報(bào)告； 項(xiàng)目開發(fā)計(jì)劃； 配置管理計(jì)劃 質(zhì)量保證計(jì)劃； 測試計(jì)劃； 程序開發(fā)規(guī)范； 需求規(guī)格說明書； 總體設(shè)計(jì)說明書； 概要設(shè)計(jì)說明書； 詳細(xì)設(shè)計(jì)說明書； 數(shù)據(jù)庫設(shè)計(jì)說明書； 用戶手冊； 維護(hù)手冊； 部分文檔名稱命名時(shí)需附加相關(guān)信息，主要包括以下文檔： 項(xiàng)目周報(bào)：項(xiàng)目名標(biāo)識(shí)或項(xiàng)目簡稱“_項(xiàng)目周報(bào)_yyyymmdd” 軟件開發(fā)進(jìn)度月報(bào)：項(xiàng)目名標(biāo)識(shí)或項(xiàng)目簡稱“_月報(bào)_yyyymmdd” 子項(xiàng)目周報(bào)：項(xiàng)目名標(biāo)識(shí)或項(xiàng)目簡稱“_子項(xiàng)目簡稱_周報(bào)_yyyymmdd” 質(zhì)量周報(bào)：項(xiàng)目名標(biāo)識(shí)或項(xiàng)目簡稱“_質(zhì)量周報(bào)_yyyymmdd” 會(huì)議紀(jì)要：項(xiàng)目名標(biāo)識(shí)或項(xiàng)目簡稱“_會(huì)議紀(jì)要_yyyymmdd” 軟件維護(hù)說明書：項(xiàng)目名標(biāo)識(shí)或項(xiàng)目簡稱“_軟件維護(hù)說明書_yymm0199” 變更記錄：項(xiàng)目名標(biāo)識(shí)或項(xiàng)目簡稱“_變更記錄_yymm0199” 評審記錄：項(xiàng)目名標(biāo)識(shí)或項(xiàng)目簡稱“_評審記錄_yymmddaz” 說明：斜體部分根據(jù)實(shí)際情況用相應(yīng)內(nèi)容替代。 7.37.3 程序文件、數(shù)據(jù)文件程序文件、數(shù)據(jù)文件 按項(xiàng)目開發(fā)規(guī)范要求執(zhí)行。 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 15/24 8 基線建立及變更管理基線建立及變更管理 基線的是已經(jīng)正式通過審核批準(zhǔn)的某階段成果，它可作為進(jìn)一步開發(fā)的基礎(chǔ)，并且只能 通過正式的變化控制過程改變。一般在某階段成果通過評審后，對該成果建立基線，納入基 線管理。（在項(xiàng)目開發(fā)的里程碑階段一般要建立項(xiàng)目基線）。開發(fā)過程的階段成果可以納入 基線管理的主要有：項(xiàng)目開發(fā)計(jì)劃、測試計(jì)劃、質(zhì)量保證計(jì)劃、業(yè)務(wù)需求說明書、需求分析 說明書、總體設(shè)計(jì)說明書、概要設(shè)計(jì)說明書、程序開發(fā)規(guī)范、數(shù)據(jù)庫設(shè)計(jì)說明書、軟件維護(hù) 手冊、用戶手冊、測試案例、已通過測試的軟件版本等。 對項(xiàng)目的每個(gè)基線對應(yīng)一個(gè)唯一的標(biāo)識(shí)號?；€標(biāo)識(shí)可采用“bl” +“基線版本號” “-”+“基線日期（yymmdd）表示。 基線類別定義如下：需求基線、設(shè)計(jì)基線、測試基線、代碼基線 基線版本號由 2 個(gè)數(shù)字組成，格式為：bl1.0 第一位：對每個(gè)基線類型（需求基線、設(shè)計(jì)基線、測試基線、代碼基線等），都從 1 開始，增改編幅或重要性比例大于 10，則在原來的基礎(chǔ)上加 1。 第二位：增改編幅或重要性比例小于 10，則在原來的基礎(chǔ)上加 1 例如： “bl1.0-050101”表示 進(jìn)入基線管理的階段成果，是經(jīng)過評審?fù)ㄟ^的，配置管理員對其必須進(jìn)行嚴(yán)格的權(quán)限控 制，一般只允許讀取，不允許修改，確實(shí)需要修改的，執(zhí)行變更管理流程。 變更管理的一般流程是： a) 獲得/提出變更請求； b) 變更預(yù)計(jì)影響的評估，包括可能受影響配置項(xiàng)以及對資源、進(jìn)度、質(zhì)量等影響 的分析，描述實(shí)施方案； c) 項(xiàng)目經(jīng)理審核并決定是否批準(zhǔn)，必要時(shí)報(bào)請領(lǐng)導(dǎo)批準(zhǔn)； d) 如變更請求被接受，由配置管理員從配置庫中檢出配置項(xiàng)，賦予相關(guān)人員修改 的權(quán)限； e)項(xiàng)目組實(shí)施變更，修改配置項(xiàng)的內(nèi)容，提交確認(rèn)，如不通過則返回項(xiàng)目組繼續(xù) 修改； f)配置管理員回收相關(guān)權(quán)限，把配置項(xiàng)檢入，形成新基線版本，發(fā)布新版本，并 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 16/24 發(fā)布變更通知給所有相關(guān)人員，包括項(xiàng)目組成員、質(zhì)量保證人員、測試人員及 其它部門人員等。 9 文檔版本管理文檔版本管理 9.1.9.1. 文檔版本及版本號的概念文檔版本及版本號的概念 文檔的版本用于區(qū)別文檔的不同狀態(tài)。每個(gè)版本都有唯一的版本號進(jìn)行標(biāo)識(shí)。版本的概 念對于文檔不同的階段還可以細(xì)分為草稿版本（draft versions）、版本（versions）。 草稿版本號：未定稿的文檔的版本號稱為草稿版本號。 版本號：已定稿的文檔的版本號稱為版本號。 9.2.9.2. 版本號的定義及生成方法版本號的定義及生成方法 草稿版本號 未定稿的文檔，在經(jīng)過修改后，如果覺得有需要，可由負(fù)責(zé)編寫文檔的人員制定出新的 草稿版本號。 草稿版本號由前綴加 2 個(gè)數(shù)字組成，格式為：draft 0.1 第一位：固定為 0 第二位：在原來的基礎(chǔ)上加 1 草稿版本號的起始標(biāo)識(shí)為：draft 0.1 草稿版本號的變動(dòng)：第 2 位數(shù)字在原來的基礎(chǔ)上加 1。 例如： draft 0.2 - draft 0.3 draft 0.8 - draft 0.9 版本號的生成 定稿的文檔，每次的修訂后，視文檔的重要性由不同權(quán)限的人員制定出新的版本號。一 般的文檔或者重要文檔中的單個(gè)文檔是可由負(fù)責(zé)編寫文檔的人員制定出新的版本號。重要的 文檔如需求規(guī)格說明書詳細(xì)設(shè)計(jì)等階段性文檔，由項(xiàng)目配置管理員與項(xiàng)目經(jīng)理協(xié)商， 在征得項(xiàng)目經(jīng)理同意后制定出新的版本號。 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 17/24 版本號由前綴加 2 個(gè)數(shù)字組成，格式為：ver 1.0 第一位：增改編幅或重要性比例大于 10 第二位：增改編幅或重要性比例小于 10 版本號的起始標(biāo)識(shí)為：ver 1.0 版本號的變動(dòng)：根據(jù)其實(shí)際情況選擇相應(yīng)位置的數(shù)值加 1，并將該位置右邊的所有數(shù)值 置 0。 例如： ver 1.1 - ver 1.2 9.3.9.3. 定版的具體操作方法定版的具體操作方法 文檔的定版必須在文檔開始處按模板要求填寫表格。并在 checkin 到 vss 時(shí)將該版本 的改動(dòng)內(nèi)容填寫到 comment 中。同時(shí)還要遵照變更文件審批與確認(rèn)的規(guī)定執(zhí)行（詳見本文 相關(guān)段落）。 9.4.9.4. 定版的具體操作方法定版的具體操作方法 示例 1，文擋封面處： xxx 系統(tǒng)系統(tǒng) 需求規(guī)格說明書需求規(guī)格說明書 示例 2，文擋信息部分： 文檔編號版本號密級 xxx-srs1.1秘密 sun trend 中山市森創(chuàng)公司 開發(fā)部文檔 名稱：xxx 系統(tǒng)_需求規(guī)格說明書共 120 頁 修訂歷史記錄 日期日期版本號版本號修訂內(nèi)容修訂內(nèi)容修訂人修訂人評審號評審號變更控制號變更控制號 2010.06.090.9新建張三 2010.06.121.0 根據(jù)評審問題修改 張三xxx-pr20040612 秘密/機(jī)密/絕密當(dāng)前版本號 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 18/24 章節(jié) 1.1.3 2010.07.081.1在 1.2.4 中在增 加 張三xxx-cr20040601 10 軟件版本管理軟件版本管理 10.110.1 定版的具體操作方法定版的具體操作方法 版本用于區(qū)別軟件產(chǎn)品的不同狀態(tài)。每個(gè)版本都有唯一的版本號進(jìn)行標(biāo)識(shí)。版本的概念 對于不同的軟件產(chǎn)品和不同的階段還可以細(xì)分為測試版本（test versions）、版本 （versions）。 測試版本號：提供測試的可執(zhí)行文件的版本稱為測試版本號。 版本號：通過測試的可執(zhí)行文件的版本稱為版本號。 10.210.2 版本號的定義及生成方法版本號的定義及生成方法 測試版本號 可執(zhí)行文件的各部分通過單元測試，總體編譯通過，由項(xiàng)目配置管理員與項(xiàng)目經(jīng)理協(xié)商， 在項(xiàng)目經(jīng)理同意下制定出新的測試版本號。 測試版本號由前綴加 2 個(gè)數(shù)字組成，格式為：test 0.1 第一位：固定為 0 第二位：在原來的基礎(chǔ)上加 1 測試版本號的起始標(biāo)識(shí)為：test 0.1 測試版本號的變動(dòng)：第 2 位數(shù)字在原來的基礎(chǔ)上加 1。 例如： test 0.2 - test 0.3 test 0.18 - test 0.19 版本號的生成 可執(zhí)行文件的各部分通過單元測試，總體編譯通過，并通過了系統(tǒng)測試，由項(xiàng)目配置管 理員與項(xiàng)目經(jīng)理協(xié)商，在項(xiàng)目經(jīng)理同意下制定出新的版本號。 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 19/24 版本號由前綴加 4 個(gè)數(shù)字組成，格式為：ver 1.0.0.0 其中，后兩個(gè)數(shù)字可選，即如果后兩個(gè)數(shù)字同時(shí)為 0 時(shí)，可以同時(shí)省去。但版本號一 定是兩個(gè)或四個(gè)數(shù)字。 第一位：系統(tǒng)整個(gè)框架性設(shè)計(jì)改動(dòng)或者業(yè)務(wù)功能的增改編幅或重要性比例大于 10 第二位：系統(tǒng)部分設(shè)計(jì)改動(dòng)或者業(yè)務(wù)功能的增改編幅或重要性比例大于 5 第三位：系統(tǒng)的代碼改動(dòng)或者業(yè)務(wù)功能的增改編幅或重要性比例小于 5 第四位：對系統(tǒng)的 bug 修改或者業(yè)務(wù)功能的增改編幅或重要性均微小。 版本號的起始標(biāo)識(shí)為：ver 1.0 版本號的變動(dòng)：根據(jù)其實(shí)際情況選擇相應(yīng)位置的數(shù)值加 1，并將該位置右邊的所有數(shù)值 置 0。如果在同一次的修訂中，同時(shí)出現(xiàn)兩個(gè)或以上位置的數(shù)值都符合改變的情況時(shí)，只 需按照符合條件的最左位的數(shù)值加 1，并將該位置右邊的所有數(shù)值置 0。如果后兩個(gè)數(shù)字同 時(shí)為0 時(shí)，可以同時(shí)省去。 例如： ver 1.1.2.1 - ver 1.2.0.0 - ver 1.2 ver 1.2.0.1 - ver 1.2.1.0 ver 1.3.9.0 - ver 1.3.8.1 ver 1.3.9.0 - ver 1.3.10.0 10.310.3 定版的具體操作方法定版的具體操作方法 每個(gè)項(xiàng)目必須有一份版本記錄表。當(dāng)需要生成一個(gè)測試版本時(shí)，填寫測試版本一欄 信息。當(dāng)某一個(gè)測試版本通過了測試，有條件生成一個(gè)版本時(shí)，在該測試版本所對應(yīng)的一行 中填上版本一欄信息。當(dāng)某一個(gè)版本需要發(fā)布，在該版本所對應(yīng)的一行中填上發(fā)布一欄信息 測試版本號和版本號均由項(xiàng)目配置管理員與項(xiàng)目經(jīng)理協(xié)商，在項(xiàng)目經(jīng)理同意下制定。 版本號欄可根據(jù)實(shí)際情況填寫，發(fā)布版本號為空。 版本類型欄選擇填寫以下之一：測試版本、版本、發(fā)布。 對于測試版本的注釋欄填寫該測試版本與上一測試版本的不同之處，對于版本的注釋欄 填寫該版本對應(yīng)的測試版本號以及與上一版本的不同之處，對于發(fā)布的注釋欄填寫該版本發(fā) 布對應(yīng)的版本號以及對生產(chǎn)的影響等情況。 項(xiàng)目負(fù)責(zé)人欄電子文檔填寫項(xiàng)目負(fù)責(zé)人姓名，紙質(zhì)文件由項(xiàng)目負(fù)責(zé)人簽名。 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 20/24 配置管理員欄電子文檔填寫項(xiàng)目配置管理員姓名，紙質(zhì)文件由項(xiàng)目配置管理員簽名。 其他相關(guān)人員欄如有需要電子文檔填寫其他相關(guān)人員姓名，紙質(zhì)文件由其他相關(guān)人員簽 名。其他相關(guān)人員如公司經(jīng)理。 項(xiàng)目配置管理員負(fù)責(zé)填寫版本記錄表，并對vss 庫中的源代碼加上版本號并填 上注釋。 版本記錄表 項(xiàng)目名稱： 序號版本號定版日期版本類型注釋項(xiàng)目負(fù)責(zé)人配置管理員其他相關(guān)人員 10.410.4 在在 vssvss 上定版的具體操作方法上定版的具體操作方法 在 vss 上，可以通過加 lable 的功能實(shí)現(xiàn)對系統(tǒng)中所有的源代碼文件進(jìn)行加版本號的 管理。 當(dāng)需要加測試版本號是，選擇所有源代碼的最高一級目錄，為其加上 lable，lable 為： test0.1（0.1 為具體的測試版本號），并在 comment 中填上該測試版的定版日期和注釋。 操作完成后，vss 對該目錄一下的所有子目錄及文件均加上相同的 lable 和 comment。 當(dāng)需要加版本號時(shí)，選擇所有源代碼的最高一級目錄，按右鍵并選擇顯示歷史信息，然 后在信息中選中標(biāo)有該版本對應(yīng)的測試版本號的 lable，雙擊。在回顯框上，修改 lable， 加上當(dāng)前的版本號，修改后的 lable為：test0.1ver1.2.2.2（0.1為具體的測試版本號, 1.2.2.2 為具體的版本號），并在 lablecomment 中填上該版本的定版日期和注釋。操作完成后，vss對該 目錄一下的所有子目錄及文件均改為相同的 lable 和 lablecomment。 當(dāng)某一版本需要發(fā)布時(shí)，按上述操作，選擇對應(yīng)的 lable，并在相應(yīng)的 lablecomment 中加上發(fā)布日期及注釋。 10.510.5 版本發(fā)布流程版本發(fā)布流程 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 21/24 項(xiàng)目組軟件版本發(fā)布流程如下圖所示： 序號序號 流程流程 責(zé)任人責(zé)任人相關(guān)人員相關(guān)人員文件文件/ /記錄記錄說明說明 a01 配置管理 員 配置管理 員 、軟件 開發(fā)人員 用戶測試 報(bào)告、開 發(fā)、維護(hù)文 檔、應(yīng)用 軟件版本發(fā) 布申請表 開發(fā)及維護(hù)文 檔必須存放項(xiàng) 目配置庫中 a02 各項(xiàng)目部 門負(fù)責(zé)人、 局領(lǐng)導(dǎo) 項(xiàng)目經(jīng)理、 開發(fā)人員 應(yīng)用軟件 版本發(fā)布申 請表 嚴(yán)格審核出部 門、公司的技 術(shù)文檔。 a03 配置管理 員、 相關(guān) 部門 項(xiàng)目經(jīng)理 軟件版本、 技術(shù) 資料 a04 軟件接收 部門 開發(fā)人員書面通知書內(nèi)容包括：版 本發(fā)布原因、 版本業(yè)務(wù)功 能、安裝時(shí)間、 影響范圍、安 裝后業(yè)務(wù)驗(yàn)證 內(nèi)容 a05 項(xiàng)目負(fù)責(zé) 人 開發(fā)人員必要時(shí)提供現(xiàn) 場技術(shù)支持。 a06 用戶、測 試組 開發(fā)人員業(yè)務(wù)驗(yàn)證測 試報(bào)告 根據(jù)需要進(jìn)行 a07 項(xiàng)目負(fù)責(zé) 人 維護(hù)人員、 開發(fā)人員 必要時(shí)現(xiàn)場技 術(shù)支持 a08 開始 a01提交版本發(fā)布申請 a02審核版本發(fā)布申請 a03版本交付 是否需要業(yè)務(wù) 部門驗(yàn)證測試 a04業(yè)務(wù)驗(yàn)證測試通知 是 a05版本安裝技術(shù)支持 否 a06業(yè)務(wù)驗(yàn)證測試 a07系統(tǒng)運(yùn)行技術(shù)支持 a08保存版本 結(jié)束 配置管理 員 綜合人員光盤可備份配置庫 時(shí)進(jìn)行備份 4.1 軟件配置管理規(guī)范 std-zs-kf-2010-003 4.3- 22/24 10.610.6 版本保存版本保存 配置管理員必須保證發(fā)布版本源程序的完整性及一致性，質(zhì)量保證人員保證發(fā)布版本的 文檔的完整性，配置經(jīng)理及對每一次發(fā)布的版本，在配置庫中對應(yīng)地建立版本標(biāo)識(shí)，隨配置庫備份 刻錄光盤時(shí)，交綜合人員登記并永久保存，綜合人員應(yīng)在光盤標(biāo)簽上標(biāo)注光盤內(nèi)容、備份時(shí)間、提 交人員，以便查閱。對光盤的查閱必須經(jīng)部門負(fù)責(zé)人同意。 11 公用程序庫的建立及維護(hù)公用程序庫的建立及維護(hù) 公用程序主要包括： 公用函數(shù)模塊：提供某一特定功能。 公用類模塊：提供具有通用性的類的定義及方法實(shí)現(xiàn)。 加密模塊：各項(xiàng)目組涉及加密的功能模塊由專人開發(fā)。 自行開發(fā)實(shí)用工具：各項(xiàng)目組開發(fā)的實(shí)用工具。 實(shí)現(xiàn)某一功能的完整程序；例如采用 socket 的通訊程序。 具有普遍實(shí)用的程序框架；例如 sco unix 下終端程序框架。 其他； 各項(xiàng)目組在項(xiàng)目開發(fā)過程中應(yīng)