【導(dǎo)讀】軟件開發(fā)管理手冊。〈項目名稱〉發(fā)布版本：〈〉。問題描述更改人日期。[][詳細(xì)內(nèi)容][姓名][]. 〈密級〉第5頁共66頁

　　

【正文】 〈軟件開發(fā)管理手冊〉 發(fā)布日期： 〈密級〉 第 29 頁 共 66頁 圖 45 概要設(shè)計報告內(nèi)容 詳細(xì)設(shè)計報告 本文件是詳細(xì)設(shè)計階段 的主要文檔。完成本文件要更新概要設(shè)計報告中的相似材料，增加大量細(xì)節(jié)。建議內(nèi)容如下： 〈項目名稱〉 發(fā)布版本：〈 〉 〈軟件開發(fā)管理手冊〉 發(fā)布日期： 〈密級〉 第 30 頁 共 66頁 1. 前言 【項目目的和背景，系統(tǒng)總體概念和文件概述】 2. 設(shè)計概述 設(shè)計驅(qū)動器（ drivers）和它們的重要性順序 重用策略 討論所選擇的系統(tǒng)設(shè)計方案并給出高層框圖描述，說明硬件接口、外部數(shù)據(jù)接口、子系統(tǒng)之間的相互接口和數(shù)據(jù)流 對應(yīng)于需求和功能說明的主要組件的可追蹤性矩陣 設(shè)計狀況 列出限制因素、關(guān)注項、問題范圍以及對設(shè)計的影響 列出設(shè)計假設(shè)及假設(shè)錯誤時對設(shè)計可能造成的影響 列出待定需求，并估計對系統(tǒng)規(guī)模、工作量、經(jīng)費(fèi)和進(jìn)度的影響 界面控制文檔（ ICD） 狀態(tài) 原型開發(fā)工作狀態(tài) 開發(fā)環(huán)境 3. 操作概述 操作方案 /腳本 系統(tǒng)性能考慮 4. 設(shè)計說明 系統(tǒng)總體能力 每種模式下處理過程的假設(shè)條件和限制因素 子系統(tǒng)的論述和高層框圖表示，包括界面、數(shù)據(jù)流和每種處理模式的信息 輸入和輸出高層描述 與操作者指定的輸入、根據(jù)控制點情況進(jìn)行的操作、所行使的功能以及獲得的結(jié)果（含正常和非正常的結(jié)果，即錯誤的處理和恢復(fù)）相關(guān)的處理過程的高層描述 延伸到子程序級的結(jié)構(gòu)框圖或面向?qū)ο蟮膱D表，說明接口、數(shù)據(jù)流、交互式控制、交互式輸入輸出和硬盤拷貝輸出 內(nèi)部存儲需求說明 ，如對數(shù)組及其大小、所有處理模式下的數(shù)據(jù)容量和處理的間接限制因素的說明 詳細(xì)輸入輸出說明 處理控制參數(shù)，如名稱列表 交互式圖形系統(tǒng)中圖形顯示的復(fù)制品 硬盤拷貝輸出的復(fù)制品 按照編號列出帶有系統(tǒng)和用戶操作說明的錯誤信息 公用區(qū)域或全程數(shù)據(jù)結(jié)構(gòu)的描述 各模塊單元（通常由于大小原因保存在不同的文檔中）的程序設(shè)計語言 5. 數(shù)據(jù)接口 【從概要設(shè)計報告中的描述性材料更新而來】 圖 46 詳細(xì)設(shè)計報告內(nèi)容〈項目名稱〉 發(fā)布版本：〈 〉 〈軟件開發(fā)管理手冊〉 發(fā)布日期： 〈密級〉 第 31 頁 共 66頁 測試計劃 聯(lián)編 /發(fā)布測試計劃 ? 本計劃由系統(tǒng)測試小組在詳細(xì)設(shè)計階段準(zhǔn)備； ? 本計劃用于測試每個聯(lián)編或發(fā)布（整個軟件 系統(tǒng)的功能性子集）功能，說明測試限制因素。聯(lián)編 /發(fā)布在軟件開發(fā) /管理計劃中定義； ? 測試計劃在單元測試和每個聯(lián)編 /發(fā)布集成后，由系統(tǒng)測試小組在實施階段立即執(zhí)行。 分析測試計劃 ? 該計劃由將要用到本系統(tǒng)的分析員在實施階段之前準(zhǔn)備； ? 該計劃用于幫助開發(fā)者驗證系統(tǒng)完成的復(fù)雜處理的結(jié)果； ? 單元級測試由開發(fā)者在實施階段完成；將端到端的測試作為系統(tǒng)測試的一部分來執(zhí)行。 系統(tǒng)測試計劃 ? 該計劃由系統(tǒng)測試小組在實施階段準(zhǔn)備； ? 該計劃用于驗證系統(tǒng)端到端的處理能力（在需求文檔中規(guī)定的），并說明限制因素； ? 該計劃由系統(tǒng)測試小組在系統(tǒng)測 試階段執(zhí)行。 驗收測試計劃 ? 該計劃由驗收測試小組根據(jù)需求和功能說明在需求定義階段結(jié)束后起草； ? 該計劃用于證明所建成的系統(tǒng)滿足需求和功能說明； ? 該計劃在驗收測試階段由驗收測試小組執(zhí)行。 測試計劃概要 1. 計劃介紹，包括目的、測試類型和級別、測試進(jìn)度安排； 2. 將每項需求和功能說明指向一個或多個測試用例的可追蹤矩陣； 3. 每項測試的測試說明（通常文檔長度不超過 12頁）： 測試目的，即所要測試的具體性能和需求； 詳細(xì)的輸入說明； 所需要的測試環(huán)境，如需要的數(shù)據(jù)集合、必要的計算機(jī)硬件； 操作過程，即怎樣實施測試； 詳細(xì)的輸出 描述，即期望的結(jié)果； 判定測試結(jié)果是否能夠接受的準(zhǔn)則； 對測試結(jié)果的討論，即，對測試結(jié)果偏差作出解釋，指出偏差的原因或證明偏差是合理的。 圖 47 測試計劃內(nèi)容 〈項目名稱〉 發(fā)布版本：〈 〉 〈軟件開發(fā)管理手冊〉 發(fā)布日期： 〈密級〉 第 32 頁 共 66頁 用戶說明書 開發(fā)小組在項目實施階段開始準(zhǔn)備用戶說明書，說明書中的第 2條和第 3條的部分內(nèi)容是詳細(xì)設(shè)計文檔材料的更新，但為了使用戶更易理解，對一些內(nèi)容進(jìn)行重寫是必要的。在實施階段結(jié)束時完成用戶說明草稿，在系統(tǒng)測試階段通過測試進(jìn)行評價，在驗收測試開始時，已有更新的版本，驗收測試小組用更新版本通過驗收測試作出評價，并進(jìn)行修改，最終版 本在測試結(jié)束時產(chǎn)生。建議內(nèi)容如下： 1. 前言 系統(tǒng)概要說明，包括目的和背景 文件組織結(jié)構(gòu) 系統(tǒng)論述和高層框圖，說明硬件接口、外部數(shù)據(jù)接口、軟件結(jié)構(gòu)和數(shù)據(jù)流程 2. 操作概要 操作方案 /腳本 顯示、窗口、菜單、報告等的概述和分層結(jié)構(gòu) 系統(tǒng)性能考慮 3. 描述 【 對各子系統(tǒng)和主要功能的描述】 各個子系統(tǒng)的性能 各種模式下處理過程的假設(shè)條件和限制因素 子系統(tǒng)論述和高層框圖，包括接口、數(shù)據(jù)流程和每種處理模式的信息 輸入輸出高層描述 與操作者指定的輸入、根據(jù)控制點情況進(jìn)行的操作、所行使的功能以及獲得的結(jié)果（包括正常和非正常的結(jié)果， 即，錯誤的處理和恢復(fù)）相關(guān)的處理過程的高層描述 對于交互式子系統(tǒng)，按照產(chǎn)生順序給出顯示的復(fù)制品 按照生成順序給出硬件拷貝輸出的復(fù)制品，并說明控制參數(shù) 按照編號給出系統(tǒng)和用戶操作（注解說明產(chǎn)生信息的子程序）說明的信息 4. 運(yùn)行需求 資源 【論述、高層框圖、系統(tǒng)和子系統(tǒng)的圖表】 硬件 數(shù)據(jù)定義，即數(shù)據(jù)分組和命名 外部空間因素 【數(shù)據(jù)存儲和打印輸出】 內(nèi)部存儲因素 【程序存儲，數(shù)組存儲和數(shù)據(jù)集合緩沖區(qū)】 時間因素 1) 樣本和處理周期的中央處理單元（ CPU）時間 2) 不同數(shù)據(jù)集合和處理類型的 I/O 時間 3) 例子和處理周期的時間 運(yùn)行信息 【不同處理模式的的控制語句】 控制參數(shù)信息 【根據(jù)子系統(tǒng)，給出所有控制參數(shù)（如名稱列表）的描述，包括名稱、計算機(jī)類型、長度、表示法，對具體參數(shù)，說明其有效值、缺省值、單位及與其它參數(shù)關(guān)系】 圖 48 用戶說明書內(nèi)容 〈項目名稱〉 發(fā)布版本：〈 〉 〈軟件開發(fā)管理手冊〉 發(fā)布日期： 〈密級〉 第 33 頁 共 66頁 系統(tǒng)描述 在項目實施階段，通過更新詳細(xì)設(shè)計中數(shù)據(jù)流 /對象圖表和結(jié)構(gòu)框圖，開發(fā)小組開始系統(tǒng)描述工作，在系統(tǒng)測試階段完成草稿，在驗收測試結(jié)束時定稿。建議內(nèi)容如下： 1. 前言 【項目目的和背景，系統(tǒng)總體概念和文件概述】 2. 系統(tǒng)概述 操作方案概述 設(shè)計驅(qū)動器（ drivers）（ 如系統(tǒng)性能因素），確定它們的重要性順序 重用策略 原型開發(fā)工作結(jié)果 所選擇的系統(tǒng)方案論述和高層框圖，說明硬件接口、外部數(shù)據(jù)接口子系統(tǒng)之間的接口和數(shù)據(jù)流 對應(yīng)需求和功能說明的主要系統(tǒng)組件的可追蹤性矩陣 3. 描述 【每個子系統(tǒng)和分解功能的描述】 整個子系統(tǒng)的性能 每種處理模式的假設(shè)條件和限制條件 子系統(tǒng)論述和高層框圖，包括界面、數(shù)據(jù)流、和每種處理模式的信息。 輸入輸出高層描述 延伸到子程序級的結(jié)構(gòu)框圖或面向?qū)ο蟮膱D表，說明接口、數(shù)據(jù)流、交互式控制、交互式輸入輸出和硬盤拷貝輸出 4. 創(chuàng)建（ creation）需求 資源 【論述、高層框圖、系統(tǒng)和子系統(tǒng)的說明圖表】 硬件 支持?jǐn)?shù)據(jù)集合 外部空間因素 【源碼存儲，空白空間和打印輸出】 內(nèi)部存儲因素 【程序生成存儲，數(shù)組存儲和數(shù)據(jù)集合緩沖區(qū)】 時間因素 1)編輯、聯(lián)編、基準(zhǔn)測試的中央處理單元（ CPU）時間 2)創(chuàng)建系統(tǒng)各個步驟的 I/O時間 創(chuàng)建信息 【不同步驟的控制語句】 程序結(jié)構(gòu)信息 【覆蓋或裝入程序的控制語句】 5. 輸入輸出詳細(xì)描述 （按步驟） 【系統(tǒng)和子系統(tǒng)源碼庫、對象源碼庫、執(zhí)行代碼庫、和支持庫】 6. 內(nèi)部存儲需求 【描述數(shù)組及其大小和各種處理模式下的數(shù)據(jù)容量，說明處理間接限制條 件】 7. 數(shù)據(jù)接口 【每個內(nèi)部和外部接口】 描述 【包括名稱、功能、頻度、坐標(biāo)、單位、計算機(jī)類型、長度和表示法】 格式 【結(jié)構(gòu)（如索引）、傳輸介質(zhì)、框架版式（例子、記錄、數(shù)據(jù)塊或發(fā)送）和存儲需求】 8. 公共數(shù)據(jù)塊描述 【包括任何硬編碼的物理常量】 9. 程序說明 /程序包描述 和每個子程序的 PDL（在不同文卷中） 10. 按字母表順序列出支持?jǐn)?shù)據(jù)集合中的子程序 【包括子程序功能描述和子程序?qū)Π闹С謹(jǐn)?shù)據(jù)集合的引用】 圖 49 系統(tǒng)描述內(nèi)容 〈項目名稱〉 發(fā)布版本：〈 〉 〈軟件開發(fā)管理手冊〉 發(fā)布日期： 〈密級〉 第 34 頁 共 66頁 軟件項目開發(fā)總結(jié)報告 項目開發(fā)歷史素材由項目經(jīng)理在軟件生命周期中 收集整理。在需求分析階段結(jié)束時，項目數(shù)據(jù)和早期教訓(xùn)被編輯成原始草稿，草稿在每個后續(xù)階段結(jié)束時被擴(kuò)充和精練，于是，在項目結(jié)束時所有的材料均被收集和記錄了下來。軟件開發(fā)歷史的最終版本在驗收結(jié)束后一個月內(nèi)完成。建議包含如下內(nèi)容： 1. 前言 【系統(tǒng)目的、系統(tǒng)用戶、關(guān)鍵需求、開發(fā)機(jī)器和語言】 2. 各階段歷史概述 【包括所產(chǎn)生的產(chǎn)品、里程碑和其它關(guān)鍵事件、階段持續(xù)時間、重要方法和決定、人員配置信息和特殊問題】 需求定義 【如果需求由軟件開發(fā)小組提供，此部分給出需求定義階段的歷史概述。否則，此部分給出系統(tǒng)需求和功能說明的起源和 文本】 需求分析 詳細(xì)設(shè)計 實施 【每個聯(lián)編 /發(fā)布的編碼和集成】 系統(tǒng)測試 驗收測試 3. 項目數(shù)據(jù) 人員和組織的結(jié)構(gòu) 【列出項目參加者、角色、從屬關(guān)系，包括每個角色（如分析員、開發(fā)者、各分項目管理者）的職責(zé)以及項目生命周期中的人員配置框架】 進(jìn)度 【給出項目開發(fā)過程中的關(guān)鍵日期表和說明估計時間（原始估計加上各階段結(jié)束時的再估計） /實際時間的表格】 項目特性 以下數(shù)據(jù)的標(biāo)準(zhǔn)表格表示：子系統(tǒng)數(shù)；總的、新的和重用的組件數(shù)；總的、新的、修改的、和重用的（逐字給出）源代碼行 SLOC數(shù)、語句和可執(zhí)行項；總的、管理的、程序員 的和支持的工作量；總的生產(chǎn)率 以下數(shù)據(jù)的標(biāo)準(zhǔn)圖表表示：項目進(jìn)展和變更歷史；階段工作量；各主要活動工作量； CPU 使用情況；系統(tǒng)測試概要；錯誤率；項目規(guī)模最初估計加上再估計于最終項目規(guī)模的比較；項目工作量加上再估計工作量于實際工作量的比較 項目主觀評價數(shù)據(jù) 【主觀評價表格（ SEF）的復(fù)制品或項目數(shù)據(jù)庫中的主觀評價數(shù)據(jù)報告】 4. 所獲得的教訓(xùn) 【描述項目開發(fā)過程和產(chǎn)品的主要優(yōu)點和弱點，從中得到的教訓(xùn)，以及對提高以后項目水平所能做的具體建議】 計劃 【開發(fā)計劃的適時性、有用性，對開發(fā)計劃的依附性，人員充足性】 需求 【設(shè)計需求的完整性和充足性，變更歷史和需求穩(wěn)定性、清晰性（是否有對需求的曲解）等】 開發(fā) 【在設(shè)計、編碼和測試中得到的教訓(xùn)】 測試 【在系統(tǒng)測試和驗收測試中得到的教訓(xùn)】 產(chǎn)品保證 【對標(biāo)準(zhǔn)和實踐的依賴性；質(zhì)量保證和配置管理教訓(xùn)】 新技術(shù) 【項目開發(fā)人員和管理人員評價所用新技術(shù)對費(fèi)用、進(jìn)度、質(zhì)量等的影響，對新技術(shù)在以后項目中的應(yīng)用作出建議】 〈項目名稱〉 發(fā)布版本：〈 〉 〈軟件開發(fā)管理手冊〉 發(fā)布日期： 〈密級〉 第 35 頁 共 66頁 圖 410 軟件開發(fā)歷史內(nèi)容 文檔評價準(zhǔn)則 軟件管理者將嚴(yán)格地評價已完成的文檔，成功的文檔應(yīng)有五項基本特性，這里給出的一般性準(zhǔn)則包括對被評價的文檔的五項基本特性的滿 足程度檢查： ? 準(zhǔn)確性 — 文檔正確么？有無明顯錯誤？對資源和環(huán)境的假設(shè)有效么？對問題和過程的重要方面是否有缺乏理解的跡象？ ? 清晰性 — 文檔是否以一種容易理解的方式表述？適合圖表表達(dá)的地方是否用了圖表而不是文字？ ? 完整性 — 根據(jù)文檔目的，是否用了正確的信息？是否有重要條款遺漏？如果文檔是前階段文檔不斷發(fā)展的發(fā)展，是否包括了前階段文檔的所有內(nèi)容？ ? 一致性 — 同一文檔中不同段落之間是否有沖突？所用符號是否和標(biāo)準(zhǔn)相一致？ ? 詳細(xì)程度 — 文檔內(nèi)容是否達(dá)到了與其目的相適應(yīng)的詳細(xì)程度？具體部分是否需要更詳盡的說明 ？ 以下各組問題可用于分析文檔中基本特性是否存在及基本特性的程度： ? 需求和功能說明 所有關(guān)于需求的假設(shè)是否已在功能說明書中說明？ 所有需求和功能說明是否（象文檔中的那樣）都可測試？ 是否已包括所有性能需求？ 需求和說明中與已有系統(tǒng)相同或相似的部分是否已清楚說明？ ? 操作概念文檔 已用的操作方