IT軟件項目管理ch10.ppt

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

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

3、何實現(xiàn)，這些可以是國際標準、國家標準、行業(yè)標準等。 工作文檔：這些文檔是在項目開發(fā)中最主要的交流溝通工具，記錄了軟件項目開發(fā)中軟件工程師的想法等。 備忘錄及電子信息：主要記錄了每天項目經(jīng)理和開發(fā)人員之間的詳細交流信息。,過程文檔可以分為如下幾類：,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)品文檔,需求文檔及相關的基本原理說明。 系統(tǒng)體系結構文檔。 對系統(tǒng)的每一個程序，都有相應的程序體系結構文檔。 每個子系統(tǒng)的規(guī)范和設計

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

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

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

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

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

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

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