【導(dǎo)讀】項(xiàng)項(xiàng)目目文文檔檔規(guī)規(guī)范范。中國(guó)建設(shè)銀行信息技術(shù)管理部

　　

【正文】 項(xiàng)目文檔規(guī)范 第 11 頁(yè) 共 57 頁(yè) 文檔編制中應(yīng)該考慮的因素 文檔編制是一個(gè)不斷改進(jìn)和完善的過(guò)程。從最初的設(shè)想到形成最后交付使用的文檔，其中每一步都要做很多工作。為了既不浪費(fèi) 資源，又能保證文檔的質(zhì)量，應(yīng)在文檔編制中考慮以下因素： 文檔的適應(yīng)性 每種文檔都有自己的特定讀者。這些讀者包括操作人員、測(cè)試人員、項(xiàng)目開(kāi)發(fā)人員，對(duì)項(xiàng)目進(jìn)行維護(hù)的技術(shù)人員以及管理人員和各級(jí)領(lǐng)導(dǎo)。他們期待能通過(guò)文檔了解項(xiàng)目情況，更好地開(kāi)展工作。因此，文檔編寫(xiě)人員必須了解讀者的需要，采用不同的表達(dá)形式和詳細(xì)程度編寫(xiě)各種文檔，以適應(yīng)這些讀者的水平、習(xí)慣和要求。 文檔的完備性 為了方便每種文檔各自的讀者，應(yīng)該使每類(lèi)文檔自成體系，盡量避免讀者在閱讀一種文檔時(shí)又不得不去參考另一文檔。文檔中的重復(fù)一般具體體現(xiàn)在兩處：一是每 種文檔的引言部分；二是文檔中對(duì)項(xiàng)目的說(shuō)明部分。當(dāng)然在重復(fù)的地方，還是應(yīng)該根據(jù)文檔的特點(diǎn)有所差別。 文檔的多樣性 本規(guī)范只規(guī)定了項(xiàng)目應(yīng)具備的基本的文檔種類(lèi)，若不能滿足某些項(xiàng)目的特殊要求時(shí)，項(xiàng)目組可以根據(jù)需要增加一些適合本項(xiàng)目使用的文檔。對(duì)這些文檔的編制要求可以在質(zhì)量保證計(jì)劃中加以說(shuō)明。 文檔的靈活性 本規(guī)范對(duì)重要文檔要包含的要素作了說(shuō)明，可以按照這些標(biāo)題編制文檔，同時(shí)也可以根據(jù)項(xiàng)目特點(diǎn)對(duì)章節(jié)內(nèi)容進(jìn)行細(xì)化和擴(kuò)展。文檔的格式可以采用自然語(yǔ)言或其他格式化的語(yǔ)言（如表格等）。 文檔的命名 項(xiàng)目文檔在納入配置管理系統(tǒng)管 理或歸檔時(shí)，要目錄清晰、分類(lèi)合理、命名規(guī)范，詳見(jiàn)《配置管理規(guī)范》。 項(xiàng)目文檔規(guī)范 第 12 頁(yè) 共 57 頁(yè) 向總行單個(gè)報(bào)送的項(xiàng)目文檔統(tǒng)一命名規(guī)則，要求如下： 項(xiàng)目名稱 _文檔名稱 _版本號(hào)（如 ） _編制日期（如 050320） 項(xiàng)目文檔規(guī)范 第 13 頁(yè) 共 57 頁(yè) 3 管理文檔編制規(guī)范 在項(xiàng)目開(kāi)發(fā)工作中，項(xiàng)目管理人員負(fù)有對(duì)項(xiàng)目開(kāi)發(fā)的過(guò)程進(jìn)行管理的責(zé)任。管理過(guò)程從任務(wù)書(shū)下達(dá)之日開(kāi)始，在計(jì)劃階段，管理人員應(yīng)當(dāng)制定項(xiàng)目開(kāi)發(fā)計(jì)劃，組織需求分析工作；在實(shí)施階段，管理人員應(yīng)履行對(duì)實(shí)施過(guò)程的控制，調(diào)查、分析和解決發(fā)現(xiàn)的問(wèn)題，問(wèn)題及其解決辦法都應(yīng)寫(xiě)成文檔；管理人員應(yīng)在約定的階段對(duì)項(xiàng)目進(jìn)展寫(xiě)出報(bào)告；當(dāng) 每一階段任務(wù)完成后，管理人員應(yīng)對(duì)產(chǎn)品進(jìn)行檢查和評(píng)價(jià)，保證產(chǎn)品和計(jì)劃的完整性和一致性。 管理文檔就是記錄項(xiàng)目開(kāi)發(fā)過(guò)程各類(lèi)管理信息的文檔。本章主要提供了應(yīng)用開(kāi)發(fā)類(lèi)項(xiàng)目和基礎(chǔ)設(shè)施類(lèi)項(xiàng)目在開(kāi)發(fā)過(guò)程中所應(yīng)產(chǎn)生的管理文檔的編寫(xiě)要求和內(nèi)容要素，期望通過(guò)規(guī)范管理文檔的形式來(lái)規(guī)范項(xiàng)目管理行為，從而達(dá)到提高項(xiàng)目開(kāi)發(fā)質(zhì)量的目的。 管理過(guò)程一般包括計(jì)劃、對(duì)計(jì)劃實(shí)施的控制以及對(duì)工作結(jié)果的評(píng)審和評(píng)價(jià)。以下將對(duì)管理文檔提出具體編寫(xiě)要求和內(nèi)容要素。 集成項(xiàng)目計(jì)劃 編寫(xiě)要求 集成項(xiàng)目計(jì)劃由項(xiàng)目實(shí)施單位采用 Microsoft Project 工 具進(jìn)行 編制。計(jì)劃的命名、任務(wù)層次及階段劃分等參考主計(jì)劃和詳細(xì)進(jìn)度計(jì)劃的要求。集成項(xiàng)目計(jì)劃的主要編寫(xiě)要求如下： （ 1）計(jì)劃任務(wù)的第一層為計(jì)劃編制單位名稱（如 XX 開(kāi)發(fā)中心）； （ 2）計(jì)劃任務(wù)的第二層按集成任務(wù)類(lèi)型分類(lèi)（如采購(gòu)、測(cè)試）； （ 3）計(jì)劃任務(wù)的第三層為具體的關(guān)聯(lián)任務(wù)：將項(xiàng)目間存在關(guān)聯(lián)的項(xiàng)目任務(wù)（包括與其他單位或項(xiàng)目組關(guān)聯(lián)的任務(wù)）按時(shí)間順序逐一編入相應(yīng)的任務(wù)類(lèi)型中； （ 4）集成項(xiàng)目計(jì)劃必須包含項(xiàng)目采購(gòu)任務(wù)，并將本單位所有項(xiàng)目的采購(gòu)任務(wù)按時(shí)間順序逐一編入。 （ 5）根據(jù)項(xiàng)目的變化情況，集成項(xiàng)目 計(jì)劃的內(nèi)容要實(shí)時(shí)更新。 項(xiàng)目文檔規(guī)范 第 14 頁(yè) 共 57 頁(yè) 內(nèi)容要素 集成項(xiàng)目計(jì)劃具體格式參見(jiàn)附件二項(xiàng)目主計(jì)劃 MPP格式文件。 項(xiàng)目計(jì)劃 編寫(xiě)要求 項(xiàng)目計(jì)劃是指項(xiàng)目總計(jì)劃。按照建行項(xiàng)目管理有關(guān)制度的要求，項(xiàng)目計(jì)劃包括：項(xiàng)目主計(jì)劃、項(xiàng)目詳細(xì)進(jìn)度計(jì)劃、變更控制計(jì)劃、人力資源計(jì)劃、質(zhì)量保證計(jì)劃、配置管理計(jì)劃、風(fēng)險(xiǎn)管理計(jì)劃、采購(gòu)計(jì)劃、培訓(xùn)計(jì)劃等。 內(nèi)容要素 目的 說(shuō)明本計(jì)劃的編制目的，指出預(yù)期的讀者。 說(shuō)明項(xiàng)目的名稱、任務(wù)提出者、開(kāi)發(fā)部門(mén)及使用部門(mén)。 本文中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義。 料 本文中引用的參考資料和文件。 簡(jiǎn)述項(xiàng)目的范圍及實(shí)現(xiàn)目標(biāo)。 項(xiàng)目成果 列舉計(jì)劃產(chǎn)生的項(xiàng)目成果。 項(xiàng)目環(huán)境 對(duì)項(xiàng)目的開(kāi)發(fā)環(huán)境、運(yùn)行環(huán)境要求進(jìn)行分述。 支持條件 綜述項(xiàng)目需要的用戶單位及其它單位的必要支持。 項(xiàng)目主計(jì)劃 項(xiàng)目文檔規(guī)范 第 15 頁(yè) 共 57 頁(yè) 簡(jiǎn)述項(xiàng)目各階段的劃分、進(jìn)度及主要責(zé)任人，并標(biāo)注：詳見(jiàn)《項(xiàng)目主計(jì)劃》（必須單獨(dú)編制）。 詳細(xì)進(jìn)度計(jì)劃 標(biāo)注：詳見(jiàn)《項(xiàng)目詳細(xì)進(jìn)度計(jì)劃》（必須單獨(dú)編制）。 變更控制計(jì)劃 參照《項(xiàng)目變更控制計(jì)劃》編制，內(nèi)容較多 時(shí)應(yīng)單獨(dú)編制，并標(biāo)注：詳見(jiàn)《項(xiàng)目變更控制計(jì)劃》。 人力資源計(jì)劃 參照《項(xiàng)目人力資源計(jì)劃》編制，內(nèi)容較多時(shí)應(yīng)單獨(dú)編制，并標(biāo)注：詳見(jiàn)《項(xiàng)目人力資源計(jì)劃》。 采購(gòu)計(jì)劃 參照《項(xiàng)目采購(gòu)計(jì)劃》編制，內(nèi)容較多時(shí)應(yīng)單獨(dú)編制，并標(biāo)注：詳見(jiàn)《項(xiàng)目采購(gòu)計(jì)劃》。 1培訓(xùn)計(jì)劃 參照《項(xiàng)目培訓(xùn)計(jì)劃》編制，內(nèi)容較多時(shí)應(yīng)單獨(dú)編制，并標(biāo)注：詳見(jiàn)《項(xiàng)目培訓(xùn)計(jì)劃》。 1質(zhì)量保證計(jì)劃 標(biāo)注：詳見(jiàn)《項(xiàng)目質(zhì)量保證計(jì)劃》（必須單獨(dú)編制）。 1風(fēng)險(xiǎn)管理計(jì)劃 參照《項(xiàng)目風(fēng)險(xiǎn)管理計(jì)劃》編制，內(nèi)容 較多時(shí)應(yīng)單獨(dú)編制，并標(biāo)注：詳見(jiàn)《項(xiàng)目風(fēng)險(xiǎn)管理計(jì)劃》。 1配置管理計(jì)劃 參照《項(xiàng)目配置管理計(jì)劃》編制，內(nèi)容較多時(shí)應(yīng)單獨(dú)編制，并標(biāo)注：詳見(jiàn)《項(xiàng)目配置管理計(jì)劃》。 1其它計(jì)劃 內(nèi)容較多時(shí)應(yīng)單獨(dú)編制，并標(biāo)注：詳見(jiàn)“ [其它計(jì)劃名稱 ]”。 項(xiàng)目文檔規(guī)范 第 16 頁(yè) 共 57 頁(yè) 項(xiàng)目主計(jì)劃 編寫(xiě)要求 項(xiàng)目主計(jì)劃，即里程碑計(jì)劃。項(xiàng)目經(jīng)理依據(jù)項(xiàng)目目標(biāo)，將項(xiàng)目劃分為幾個(gè)里程碑階段，并設(shè)置相互之間的依賴關(guān)系，每個(gè)里程碑階段應(yīng)有確定的起止日期和責(zé)任人。 （ 1）主計(jì)劃命名規(guī)則 項(xiàng)目主計(jì)劃采用 Microsoft Project 工具進(jìn)行編制。 項(xiàng)目主 計(jì)劃命名規(guī)則： [項(xiàng)目名稱 ]_[版本號(hào) ]_[YYMMDD].[文件后綴 ]。 項(xiàng)目名稱（以及主計(jì)劃內(nèi)容）盡可能用中文進(jìn)行標(biāo)識(shí)，慣用法、專(zhuān)業(yè)詞匯等除外。 版本號(hào)用 V[序號(hào) ].[序號(hào) ]進(jìn)行標(biāo)識(shí)，立項(xiàng)后主計(jì)劃第一次審批后版本號(hào)是，之后主計(jì)劃每次變更并審批通過(guò)后，第一個(gè)序號(hào)加 1；第二個(gè)序號(hào)標(biāo)識(shí)詳細(xì)進(jìn)度計(jì)劃的變更，該變更不影響主計(jì)劃。 注：項(xiàng)目主計(jì)劃和詳細(xì)進(jìn)度計(jì)劃物理上是同一個(gè)文件。項(xiàng)目主計(jì)劃變更并獲得項(xiàng)目處批準(zhǔn)后，形成新的基線，用另存為 .mpp 文件的方式保存每個(gè)基線。每個(gè)基線通過(guò)命名新的版本號(hào)進(jìn)行標(biāo)識(shí)。 （ 2） 任務(wù) 根據(jù)項(xiàng)目選擇的不同開(kāi)發(fā)模型，主計(jì)劃任務(wù)層次（大綱級(jí)別）可能不同。原則上，主計(jì)劃任務(wù)層次不超過(guò)四層： 1）第一層：項(xiàng)目名。 2）第二層：項(xiàng)目大階段，規(guī)定的階段有：計(jì)劃階段、實(shí)施階段、收尾階段。需上級(jí)部門(mén)協(xié)調(diào)的重要外部任務(wù)單獨(dú)作為一個(gè)階段在第二層中表示。 計(jì)劃中的外部任務(wù)指項(xiàng)目組需要外部資源完成的任務(wù)，一般該任務(wù)對(duì)項(xiàng)目組內(nèi)部的任務(wù)有直接影響。外部任務(wù)在項(xiàng)目主計(jì)劃中多標(biāo)識(shí)為里程碑事件。 3）第三層：分階段的功能釋放，分階段的項(xiàng)目目標(biāo)實(shí)施。大型項(xiàng)目、復(fù)雜項(xiàng)目、或者非瀑布模型的項(xiàng)目，在實(shí)施階段中往往出現(xiàn)類(lèi)似的多 個(gè)子階段。 4）第四層：開(kāi)發(fā)階段，如：軟件工程階段。 項(xiàng)目文檔規(guī)范 第 17 頁(yè) 共 57 頁(yè) 瀑布模型的項(xiàng)目主計(jì)劃，一般采用三層任務(wù)結(jié)構(gòu)（沒(méi)有上述第三層）。非瀑布模型的項(xiàng)目主計(jì)劃，根據(jù)需要，可以采用四層任務(wù)結(jié)構(gòu)，如迭代開(kāi)發(fā)模型，實(shí)施階段中先分功能釋放大階段，每個(gè)階段下再細(xì)分開(kāi)發(fā)階段。 原則上，主計(jì)劃底層任務(wù)包括三種： 1）軟件工程階段，如：需求、設(shè)計(jì)、編碼、測(cè)試、試運(yùn)行、推廣。在project 中一般用階段任務(wù)表示。 2）項(xiàng)目管理過(guò)程，如：項(xiàng)目啟動(dòng)、計(jì)劃、采購(gòu)、培訓(xùn)、驗(yàn)收、收尾。在project 中一般用階段任務(wù)表示。 3）關(guān)鍵任務(wù)或關(guān)鍵里程碑事件， 如：重要外部任務(wù)、重要事件點(diǎn)。規(guī)定的重要外部任務(wù)有：采購(gòu)獲?。◤奶峤徊少?gòu)文件到采購(gòu)資源可用，如公司人員到位、設(shè)備到貨）；開(kāi)發(fā)環(huán)境就緒、（集成、用戶）測(cè)試環(huán)境就緒、運(yùn)行環(huán)境就緒；相關(guān)系統(tǒng)配合（接口）就緒。關(guān)鍵里程碑事件如：系統(tǒng)切換。 項(xiàng)目主計(jì)劃定位為里程碑計(jì)劃，任務(wù)數(shù)量不宜過(guò)多，也不宜過(guò)少，一般底層任務(wù)數(shù)在 1020 個(gè)左右（不強(qiáng)制要求）。 任務(wù)屬性包括： WBS 編碼、工期、開(kāi)始時(shí)間、完成時(shí)間、完成百分比、提交件、資源、前置任務(wù)。 注： project 中還增加了 “是否主計(jì)劃任務(wù)？”屬性，主要原因是，項(xiàng)目主計(jì)劃和詳細(xì) 進(jìn)度計(jì)劃共用同一個(gè) project 文件，為區(qū)分兩個(gè)計(jì)劃，增設(shè)了該屬性，缺省值是“否”。這樣做的優(yōu)點(diǎn)是有利于維持兩個(gè)計(jì)劃的一致性，減少計(jì)劃編制者的工作量。 （ 3） WBS 編碼 WBS 編碼規(guī)則： [序號(hào) ].[序號(hào) ]…… 例如：項(xiàng)目管理系統(tǒng)項(xiàng)目，主計(jì)劃第二層第一個(gè)任務(wù) WBS 編碼為“ ”。 （ 4）工期、開(kāi)始時(shí)間、完成時(shí)間、完成百分比 項(xiàng)目主計(jì)劃編制的開(kāi)始時(shí)間為項(xiàng)目任務(wù)書(shū)下達(dá)的項(xiàng)目啟動(dòng)時(shí)間，時(shí)間周期不能超過(guò)任務(wù)書(shū)規(guī)定的工期。 主計(jì)劃任務(wù)工期的單位應(yīng)該為工作日。 完成百分比按照實(shí)際進(jìn)度及時(shí)跟蹤。 項(xiàng)目文檔規(guī)范 第 18 頁(yè) 共 57 頁(yè) 注：因?yàn)橹饔?jì)劃的變更要走 變更流程，所以，每個(gè)任務(wù)的時(shí)間要盡量考慮周全，避免頻繁的變更手續(xù)。 （ 5）提交件 原則上，主計(jì)劃底層任務(wù)都要有正式提交件，標(biāo)志該任務(wù)的完成。提交件的例子如：需求說(shuō)明書(shū)、概要設(shè)計(jì)說(shuō)明書(shū)、測(cè)試報(bào)告等。 注：主計(jì)劃任務(wù)的提交件是標(biāo)志本任務(wù)完成的主要提交件，不是其子任務(wù)（屬于詳細(xì)進(jìn)度計(jì)劃任務(wù)）提交件的集合。 （ 6）資源 最底層任務(wù)應(yīng)明確標(biāo)識(shí)資源：項(xiàng)目組內(nèi)部任務(wù)填寫(xiě)責(zé)任人，外部任務(wù)填寫(xiě)組織或單位名稱。 （ 7）前置任務(wù) 各任務(wù)之間的依賴關(guān)系必須標(biāo)識(shí)清楚。 （ 8）其他 主計(jì)劃中不允許涉及預(yù)算、采購(gòu)金額等保密信息。 項(xiàng)目主 計(jì)劃模板見(jiàn)附件二。 注：模版并不涵蓋所有的項(xiàng)目類(lèi)型，除本文規(guī)定的任務(wù)外，模版中的很多信息都是示意性的，項(xiàng)目組需根據(jù)本規(guī)范的原則，對(duì)模版進(jìn)行剪裁。 內(nèi)容要素 具體各種類(lèi)型項(xiàng)目模版請(qǐng)參見(jiàn)附件二 MPP格式文件，包括應(yīng)用開(kāi)發(fā)類(lèi)項(xiàng)目計(jì)劃模版、推廣類(lèi)項(xiàng)目計(jì)劃模版及基礎(chǔ)設(shè)施類(lèi)項(xiàng)目計(jì)劃模版。 詳細(xì)進(jìn)度計(jì)劃 編寫(xiě)要求 （ 1）編制順序 項(xiàng)目文檔規(guī)范 第 19 頁(yè) 共 57 頁(yè) （ 2）計(jì)劃要素 詳細(xì)進(jìn)度計(jì)劃的描述要素幾乎等同于里程碑計(jì)劃的要素。 （ 3）任務(wù)拆分原則 1）四十小時(shí)原則 這個(gè)原則表述的意思是處于層次最 末端的工作可以在一周內(nèi)完成，這樣可以把任務(wù)執(zhí)行檢查的周期控制在一周以內(nèi)，從而大幅度的增加任務(wù)分解的可靠性和任務(wù)執(zhí)行的及時(shí)性。 2）最末端的工作可以分配給某個(gè)具體的人或者某個(gè)團(tuán)隊(duì) 最末端的工作需要明確責(zé)任人或者資源，如果某個(gè)任務(wù)雖然已經(jīng)在一周內(nèi)可以完成，但是執(zhí)行該任務(wù)的資源卻大于 1人，則應(yīng)該按照每個(gè)人的任務(wù)再進(jìn)行分解，直到明確每個(gè)人或者每個(gè)團(tuán)隊(duì)具體的任務(wù)和職責(zé)。按照這一原則劃分的WBS不僅可以分清職責(zé)，而且在項(xiàng)目后評(píng)估的時(shí)候，可以清楚的得知每個(gè)團(tuán)隊(duì)或者每個(gè)人的工作量和工作質(zhì)量。 確定要素 任務(wù)分解 工期估計(jì) 關(guān)聯(lián)設(shè)定 關(guān)鍵路徑計(jì)算 開(kāi)始 結(jié)束 計(jì)劃調(diào)整