IT軟件項(xiàng)目管理ch10.ppt

1、第 10 章,IT軟件項(xiàng)目文檔管理 （1次、2課時(shí)）,第10章 IT軟件項(xiàng)目文檔管理,10.1 軟件項(xiàng)目文檔管理概述 10.2 項(xiàng)目文檔的質(zhì)量 10.3 項(xiàng)目文檔準(zhǔn)備 10.4 主要項(xiàng)目文檔 10.5 思考題,10.1 軟件項(xiàng)目文檔管理概述,10.1.1 項(xiàng)目文檔管理的概念 10.1.2 項(xiàng)目文檔的分類 10.1.3 過程文檔 10.1.4 產(chǎn)品文檔,10.1.1 項(xiàng)目文檔管理的概念,能作為開發(fā)組員之間交流溝通的媒介。 能為軟件項(xiàng)目的維護(hù)工程師提供有關(guān)信息系統(tǒng)的資料和知識庫。 能為項(xiàng)目管理者提供項(xiàng)目計(jì)劃、預(yù)算、開發(fā)進(jìn)度等各方面的信息。 能作為最終用戶或管理員的用戶手冊，使用戶知道如何使用、維護(hù)

2、及管理系統(tǒng)。,概念屬性：,10.1.2 項(xiàng)目文檔的分類,過程文檔，是指那些記錄軟件項(xiàng)目開發(fā)和維護(hù)過程的文檔資料，項(xiàng)目的計(jì)劃、進(jìn)度、過程質(zhì)量、組織及項(xiàng)目標(biāo)準(zhǔn)等都是過程文檔。 產(chǎn)品文檔，是那些描述正在開發(fā)的產(chǎn)品的資料。這類文檔又可以分為從軟件工程師開發(fā)和維護(hù)系統(tǒng)的角度描述產(chǎn)品的系統(tǒng)文檔，以及主要以客戶為對象描述產(chǎn)品的用戶文檔。,文檔可分為以下兩大類，即過程文檔和產(chǎn)品文檔 ：,10.1.3 過程文檔,軟件項(xiàng)目計(jì)劃、預(yù)測和進(jìn)度安排文檔：這些文檔由項(xiàng)目經(jīng)理負(fù)責(zé)產(chǎn)生，以便預(yù)測和控制軟件的開發(fā)過程。 相關(guān)報(bào)告：這些文檔用來報(bào)告在軟件開發(fā)過程中，資源是如何分配和利用的。 標(biāo)準(zhǔn)報(bào)告：這些文檔規(guī)定了軟件過程應(yīng)該如

3、何實(shí)現(xiàn)，這些可以是國際標(biāo)準(zhǔn)、國家標(biāo)準(zhǔn)、行業(yè)標(biāo)準(zhǔn)等。 工作文檔：這些文檔是在項(xiàng)目開發(fā)中最主要的交流溝通工具，記錄了軟件項(xiàng)目開發(fā)中軟件工程師的想法等。 備忘錄及電子信息：主要記錄了每天項(xiàng)目經(jīng)理和開發(fā)人員之間的詳細(xì)交流信息。,過程文檔可以分為如下幾類：,10.1.4 產(chǎn)品文檔,(1)系統(tǒng)功能描述 (2)初級使用手冊 (3)系統(tǒng)參考手冊 (4)系統(tǒng)安裝文檔 (5)系統(tǒng)管理員手冊,產(chǎn)品文檔可以分為用戶文檔和系統(tǒng)文檔：,用戶文檔包括：,10.1.4 產(chǎn)品文檔,10.1.4 產(chǎn)品文檔,需求文檔及相關(guān)的基本原理說明。 系統(tǒng)體系結(jié)構(gòu)文檔。 對系統(tǒng)的每一個(gè)程序，都有相應(yīng)的程序體系結(jié)構(gòu)文檔。 每個(gè)子系統(tǒng)的規(guī)范和設(shè)計(jì)

4、說明書。 程序代碼列表。這些列表包括程序注釋、用來解釋代碼中復(fù)雜代碼段和采用的編碼方法等。 描述每個(gè)程序怎樣驗(yàn)證和驗(yàn)證信息與需求之間關(guān)系的驗(yàn)證文檔。 維護(hù)指導(dǎo)文檔，主要描述系統(tǒng)已知的問題、軟件支持、硬件支持等信息，以便維護(hù)時(shí)使用。,系統(tǒng)文檔包括：,10.2 項(xiàng)目文檔的質(zhì)量,10.2.1 項(xiàng)目文檔結(jié)構(gòu) 10.2.2 文檔標(biāo)準(zhǔn) 10.2.3 文檔書寫風(fēng)格,10.2.1 項(xiàng)目文檔結(jié)構(gòu),主要信息：,10.2.2 文檔標(biāo)準(zhǔn),過程標(biāo)準(zhǔn)：這種標(biāo)準(zhǔn)定義了高質(zhì)量文檔應(yīng)該遵守的過程。 產(chǎn)品標(biāo)準(zhǔn)：這種標(biāo)準(zhǔn)操縱文檔本身。 交互標(biāo)準(zhǔn)：通過電子郵件和文檔數(shù)據(jù)庫交換文檔變得越來越重要，交互標(biāo)準(zhǔn)使得所有的文檔都存在可比性。,

5、包括：,10.2.2 文檔標(biāo)準(zhǔn),10.2.3 文檔書寫風(fēng)格,運(yùn)用主動的而不是被動的語氣。 運(yùn)用正確的術(shù)語和語法結(jié)構(gòu)。 句子不宜過長，盡量用短句。 段落簡短。 用詞簡潔，不要長篇累犢。 簡明定義用到的專業(yè)術(shù)語。 應(yīng)用標(biāo)題和子標(biāo)題。 盡可能地逐條列舉事實(shí)。 不要單純地參考數(shù)字、圖、表來理解信息，應(yīng)當(dāng)有一定的說明和注釋。,編寫文檔時(shí)，也應(yīng)該注意以下問題：,10.3 項(xiàng)目文檔準(zhǔn)備,文檔制作：文字處理器、文本格式器、表格和公式編輯器、繪圖工具包等。 文檔修改：拼寫檢查器和風(fēng)格檢查器。 文檔產(chǎn)品發(fā)布：桌面發(fā)布包、技術(shù)工作包等。,文檔的準(zhǔn)備分3個(gè)階段 ：,10.3 項(xiàng)目文檔準(zhǔn)備,文檔管理系統(tǒng) ：,10.4

6、主要項(xiàng)目文檔,10.4.1 項(xiàng)目開發(fā)立項(xiàng)報(bào)告 10.4.2 可行性研究報(bào)告 10.4.3 項(xiàng)目開發(fā)計(jì)劃報(bào)告 10.4.4 項(xiàng)目分析報(bào)告 10.4.5 項(xiàng)目設(shè)計(jì)報(bào)告 10.4.6 程序設(shè)計(jì)報(bào)告 10.4.7 項(xiàng)目測試報(bào)告 10.4.8 項(xiàng)目使用與維護(hù)手冊 10.4.9 項(xiàng)目評價(jià)報(bào)告 10.4.10 項(xiàng)目開發(fā)總結(jié)報(bào)告,10.4.1 項(xiàng)目開發(fā)立項(xiàng)報(bào)告,(1) 概述：概述現(xiàn)行系統(tǒng)的組織結(jié)構(gòu)、功能、業(yè)務(wù)流程以及存在的主要問題。 (2) 新系統(tǒng)的目標(biāo)：開發(fā)新系統(tǒng)的意義和新系統(tǒng)實(shí)現(xiàn)后的功能、技術(shù)指標(biāo)、安全和保密性、新系統(tǒng)運(yùn)行環(huán)境等。 (3) 經(jīng)費(fèi)預(yù)測和經(jīng)費(fèi)來源。 (4) 項(xiàng)目進(jìn)度和完成期限。 (5) 驗(yàn)收標(biāo)

7、準(zhǔn)和方法。 (6) 移交的文檔資料。 (7) 開始可行性研究的組織隊(duì)伍、機(jī)構(gòu)與預(yù)算。 (8) 其他需要說明的有關(guān)問題。,包括以下內(nèi)容 :,10.4.2 可行性研究報(bào)告,(1) 系統(tǒng)概述。 (2) 新系統(tǒng)的目標(biāo)、要求和約束。 (3) 可行性研究的基本準(zhǔn)則。 (4) 現(xiàn)行系統(tǒng)描述及現(xiàn)行系統(tǒng)存在的主要問題。 (5) 新系統(tǒng)對現(xiàn)行系統(tǒng)的影響。 (6) 投資與效益分析。 (7) 其他可選方案及國內(nèi)外同類方案的比較。 (8) 有關(guān)建議。,包括以下內(nèi)容 :,10.4.3 項(xiàng)目開發(fā)計(jì)劃報(bào)告,(1)概述：主要包括系統(tǒng)開發(fā)的主要目標(biāo)、基本方針、參加人員、工作階段和內(nèi)容等。 (2)開發(fā)計(jì)劃：系統(tǒng)開發(fā)各個(gè)工作階段或者

8、子項(xiàng)目的劃分、任務(wù)、分工、負(fù)責(zé)人、計(jì)劃時(shí)間(開始及結(jié)束時(shí)間)、人力資源需求、資金及設(shè)備消耗、實(shí)際執(zhí)行情況等?？梢杂霉ぷ鬟M(jìn)度表、甘特圖、網(wǎng)絡(luò)圖及關(guān)鍵路徑法等工具輔助管理。 (3)驗(yàn)收標(biāo)準(zhǔn)：每項(xiàng)工作完成后驗(yàn)收的標(biāo)準(zhǔn)，包括時(shí)間、資金、質(zhì)量等。 (4)協(xié)調(diào)方法：項(xiàng)目開發(fā)中各個(gè)單位、階段之間的銜接、協(xié)調(diào)方法、負(fù)責(zé)人、權(quán)限等。,包括以下內(nèi)容 :,10.4.4 項(xiàng)目分析報(bào)告,(1) 概述。 (2) 系統(tǒng)需求。 (3) 新系統(tǒng)的目標(biāo)與新鮮系統(tǒng)的功能。 (4) 新系統(tǒng)的邏輯模型。 (5) 新系統(tǒng)的運(yùn)行環(huán)境。 (6) 新系統(tǒng)的驗(yàn)收標(biāo)準(zhǔn)與培訓(xùn)計(jì)劃。,包括以下內(nèi)容 :,10.4.5 項(xiàng)目設(shè)計(jì)報(bào)告,(1) 系統(tǒng)概述。

9、(2) 系統(tǒng)總體結(jié)構(gòu)。 (3) 計(jì)算機(jī)系統(tǒng)配置方案。 (4) 代碼設(shè)計(jì)。 (5) 文件/數(shù)據(jù)庫設(shè)計(jì)。 (6) 輸入輸出設(shè)計(jì)。 (7) 計(jì)算機(jī)處理過程設(shè)計(jì)。 (8) 接口及通信環(huán)境設(shè)計(jì)。 (9) 安全保密設(shè)計(jì)。 (10)數(shù)據(jù)準(zhǔn)備。 (11)系統(tǒng)測試計(jì)劃。 (12)培訓(xùn)計(jì)劃。,包括以下內(nèi)容 :,10.4.6 程序設(shè)計(jì)報(bào)告,(1) 概述。 (2) 程序結(jié)構(gòu)圖。 (3) 程序控制圖。 (4) 算法。 (5) 程序流程圖。 (6) 源程序。 (7) 程序注釋及說明。,包括以下內(nèi)容 :,10.4.7 項(xiàng)目測試報(bào)告,(1) 概述：說明項(xiàng)目測試的目的。 (2) 測試環(huán)境：有關(guān)軟、硬件、通信、數(shù)據(jù)庫、人員等情況

10、。 (3) 測試內(nèi)容：系統(tǒng)、子系統(tǒng)、模塊的名稱、性能技術(shù)指標(biāo)等。 (4) 測試方案：測試的方法、測試數(shù)據(jù)、測試步驟、測試中故障的解決方案等。 (5) 測試結(jié)果：測試的實(shí)際情況。 (6) 結(jié)論：項(xiàng)目功能評價(jià)、性能技術(shù)指標(biāo)評價(jià)、結(jié)論。,包括以下內(nèi)容 :,10.4.8 項(xiàng)目使用與維護(hù)手冊,(1) 概述：主要包括系統(tǒng)功能、系統(tǒng)運(yùn)行環(huán)境(軟硬件環(huán)境)、系統(tǒng)安裝等內(nèi)容。 (2) 使用說明：系統(tǒng)操作使用說明較為詳細(xì)地說明了操作的目的、過程、方式、輸入輸出的數(shù)據(jù)等。最好將系統(tǒng)操作的界面圖放入說明書中，便于使用者學(xué)習(xí)與操作。 (3) 問題解釋：解釋了系統(tǒng)使用中可能出現(xiàn)的問題及解決辦法，如非常規(guī)操作命令、系統(tǒng)恢復(fù)過程及意外情況、與開發(fā)單位的聯(lián)系方式等。,包括以下內(nèi)容 :,10.4.9 項(xiàng)目評價(jià)報(bào)告,(1) 概述。 (2) 系統(tǒng)構(gòu)成。 (3) 系統(tǒng)達(dá)到設(shè)計(jì)目標(biāo)的情況。 (4) 系統(tǒng)的可靠性、安全性、保密性、可維護(hù)性等狀況。 (5) 系統(tǒng)的經(jīng)濟(jì)效益與社會效益的評價(jià)。 (6) 總結(jié)性評價(jià)。,包括以下內(nèi)容 :,10.4.10 項(xiàng)目開發(fā)總結(jié)報(bào)告,(1) 概述：包括項(xiàng)目的提供者、開發(fā)者、用戶；項(xiàng)目開發(fā)的主要依據(jù)；項(xiàng)目開發(fā)的目的；項(xiàng)目開發(fā)的可行性分析等。 (2) 項(xiàng)目的完成情況：包括項(xiàng)目構(gòu)成與主要