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

　　

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