【正文】 需求設(shè)計(jì)文檔模板 19 課程內(nèi)容 ?為什么要文檔化 ?文檔寫作基本要求 ?需求設(shè)計(jì)文檔模板 ?需求文檔寫作 ?設(shè)計(jì)文檔寫作 什么是好的需求 什么樣的需求是好的需求 完整性 清晰性 可行性 一致性 可驗(yàn)證性 練習(xí) Requirements1 功能需求 1修改設(shè)置 smarton password命令 1. Introduction介紹 在設(shè)置 smarton password的同時(shí)，規(guī)定密碼顯示形式為明文和密文。在某個(gè)接口上禁止 arp動(dòng)態(tài)學(xué)習(xí)，不影響其他接口的 arp學(xué)習(xí)。 15 練習(xí) 修改原因： 這個(gè)函數(shù)是將要發(fā)送的 packet轉(zhuǎn)化為 buffer，系統(tǒng)原有函數(shù)RD_PutPacketToBuffer是針對(duì)認(rèn)證用戶設(shè)計(jì)的，由于本特性為設(shè)備啟動(dòng)后執(zhí)行，沒有用戶信息，所以在 RD_PutPacketToBuffer函數(shù)基礎(chǔ)上做了一些修改，形成該函數(shù)。 由于一臺(tái)設(shè)備可以設(shè)置多個(gè) radius服務(wù)器，即 radius scheme。 2.…… 下面的描述呢？ 白話 修改成如下的描述呢？ ………… LSW（ 支持記錄時(shí)間功能 ），利用設(shè)備時(shí)間戳特性可以檢測出設(shè)備 是否重啟 ， 設(shè)備重啟時(shí) 將 CAMS上的在線用戶刪除，并依據(jù)最后一次計(jì)費(fèi)更新報(bào)文終結(jié)計(jì)費(fèi)。 書房 門，書房南北長 4米，書房有一個(gè)一米見方的門廳，書房的西墻長 4米，包括 1米長的門廳長度，西墻把書房和次臥分隔開。 寬 3米，長 5米左右，房間門對(duì)著客廳。門廳東墻北端 90角折向東，長 2米，把書房和廚房北陽臺(tái)分隔開?？蛷d與餐廳連為一體，共 7米長， 4米寬，與客廳相連有一南陽臺(tái)，與客廳同寬，長 ?！? —— 摘自一位華為員工的瑞典出差報(bào)告 5 課程內(nèi)容 ?為什么要文檔化 ?文檔寫作基本要求 ?需求設(shè)計(jì)文檔模板 ?需求文檔寫作 ?設(shè)計(jì)文檔寫作 文檔寫作基本要求 下面的文檔出自于我們開發(fā)人員的手筆，大家覺得如何？ 文檔寫作基本要求 ? 應(yīng)使用標(biāo)準(zhǔn)模板寫作； ? 文檔封頁、頁眉頁腳、修訂記錄、附錄、參考文獻(xiàn)應(yīng)完善； ? 關(guān)鍵詞、摘要、縮略語應(yīng)完整； ? 目錄要及時(shí)更新； ? 通篇文檔標(biāo)題、文字格式、間距應(yīng)協(xié)調(diào)美觀； ? 所有文檔模板中的章節(jié)，只可增加，不可刪除； ? 編寫建議是用來指導(dǎo)文檔寫作的，在利用完后要及時(shí)刪除； ? 圖號(hào)置于圖形之下，表號(hào)置于表格之上； 文檔寫作基本要求 ? 應(yīng)追求圖文并茂的效果； ? 句子和段落要短； ? 使用語言應(yīng)嚴(yán)謹(jǐn)，不要使用白話； ? 采用主動(dòng)語氣； ? 不要出現(xiàn)“我們”、“你們”、“他們”這樣的稱謂，或“這個(gè)”、“那個(gè)”這樣的詞，應(yīng)使用“本”、“該”、“其”； ? 表述清晰，避免引起歧義； ? 通篇文檔細(xì)節(jié)上要保持一致； 練習(xí) 房子南北走向，房子大門在東側(cè)中間位置。我們現(xiàn)在有一個(gè)嚴(yán)重的問題是，大家好像不喜歡寫文檔，對(duì)于需要的實(shí)現(xiàn)方案，通常都是一個(gè)負(fù)責(zé)人在腦袋里想想該怎么實(shí)現(xiàn)，然后郵件或電話找?guī)讉€(gè)相關(guān)人員討論一下就算可以了， 可能連個(gè)會(huì)議材料或會(huì)議紀(jì)要都沒有。 而老外可不是這樣的，他們非常非常重視文檔，他們認(rèn)為 一個(gè)人在腦袋里想的東西是不清晰也不全面的，有時(shí)候心里想的認(rèn)為很正確的方案實(shí)際上可能存在致命缺陷。門廳長約 3米，寬 2米，門廳左面是主臥室，右面是廚房。餐廳的北面是衛(wèi)生間，衛(wèi)生間與廚房相對(duì)，中間由 1米寬， 3米長的過道隔開；衛(wèi)生間門對(duì)著過道，南墻與廚房的南墻在一條直線上；衛(wèi)生間為長方形，南墻長 3米，另一邊長 2米。 大家認(rèn)為下面的描述如何？ 究竟長多 少？ ? 是左？ 還是右？ 大段的敘述，不利于理解！ 10 練習(xí) ，房子大門在東側(cè)中間位置。 與餐廳連為一體，共 7米長， 4米寬，與客廳相連有一南陽臺(tái)，與客廳同寬，長 。門廳東墻北端 90角折向東，長 2米，把書房和廚房北陽臺(tái)分隔開。用戶可再次正常登陸。用戶可以通過命令行來配置該 radius服務(wù)器是否啟動(dòng)設(shè)備重啟防吊死功能。 修改原因： 該函數(shù)實(shí)現(xiàn)將待發(fā)送的 packet轉(zhuǎn)化為 buffer的功能，系統(tǒng)原有函數(shù)RD_PutPacketToBuffer針對(duì)認(rèn)證用戶設(shè)計(jì)，由于本特性為設(shè)備啟動(dòng)后執(zhí)行，沒有用戶信息，所以在 RD_PutPacketToBuffer函數(shù)基礎(chǔ)上做了一些修改，形成該函數(shù)。 在禁止了 arp動(dòng)態(tài)學(xué)習(xí)的接口上，只能通過手工添加靜態(tài) arp，或者其他一些被允許的模塊才可以添加 arp，這種 arp被稱為 ARP Authorized，授權(quán) arp不再和其他的動(dòng)態(tài)表項(xiàng)一樣老化，而是有自己的老化機(jī)制，后面會(huì)說明。 2. Inputs 輸入 1)密碼顯示形式。 4. output輸出 無 5. Inherit繼承性 Update需要改進(jìn) 大家看看下面的需求描述如何？ 密文兩種，但處理中描述的顯示形式卻是 simple和 cipher，不一致； ，長度有無限制，均沒有交待。初始化 MAC地址表相關(guān)指針。 當(dāng)收到 unit up消息時(shí)，本 unit向其它 unit發(fā)送端口鏡像同步消息。 不清晰一般也不可驗(yàn)證。 應(yīng)在范圍中描述 范圍不是用來描述本文包括什么、不包括什么 總體概述 總體概述 具體需求 設(shè)計(jì)約束 質(zhì)量屬性 簡介 附錄 依賴關(guān)系 其它需求 假設(shè)和依賴關(guān)系 總體概述 軟件功能 用戶特征 軟件概述 本節(jié)不對(duì)需求作具體描述，只是為了使那些需求更易于理解 總體概述－軟件概述 總體概述 具體需求 設(shè)計(jì)約束 質(zhì)量屬性 簡介 附錄 依賴關(guān)系 其它需求 ? 描述軟件與其它產(chǎn)品或項(xiàng)目所組成的整體環(huán)境 本軟件模塊 1 外部模塊 3 系統(tǒng)外部模塊 1 系統(tǒng)外部模塊 2 外部模塊 4 ? 本節(jié)是概要性描述，最好使用圖形描述系統(tǒng)或項(xiàng)目的組件、互聯(lián)性及外部接口 30 總體概述－軟件功能 總體概述 具體需求 設(shè)計(jì)約束 質(zhì)量屬性 簡介 附錄 依賴關(guān)系 其它需求 ? 提供軟件所實(shí)現(xiàn)功能的一個(gè)概要描述 ?可以從更高層規(guī)格文檔直接引用 ?清楚易懂 ?顯示不同功能及其相互關(guān)系 ?不描述具體需求 功能 3 功能 1 功能 2 。 ACL模塊的穩(wěn)定性，包括 ACL規(guī)則的維護(hù)、匹配等。 輸入 輸出 具體需求－功能需求 總體概述 具體需求 設(shè)計(jì)約束 質(zhì)量屬性 簡介 附錄 依賴關(guān)系 其它需求 功能需求描述 介紹 處理 該功能的目的、使用方法和技巧，及相關(guān)背景介紹 所有輸出數(shù)據(jù)的詳細(xì)描述 從輸入數(shù)據(jù)和中間參數(shù)獲得輸出的所有操作 所有輸入數(shù)據(jù)的詳細(xì)描述 輸入 輸出 具體需求－功能需求 總體概述 具體需求 設(shè)計(jì)約束 質(zhì)量屬性 簡介 附錄 依賴關(guān)系 其它需求 ?輸入數(shù)據(jù)的描述： ?輸入來源 ?數(shù)量 ?度量單位 ?時(shí)序 ?允許的輸入偏差范圍 具體需求－功能需求 總體概述 具體需求 設(shè)計(jì)約束 質(zhì)量屬性 簡介 附錄 依賴關(guān)系 其它需求 ?處理操作： ?輸入數(shù)據(jù)合法性檢測 ?操作次序 ?異常情況的響應(yīng) ?操作影響到的參數(shù) ?用于把系統(tǒng)輸入轉(zhuǎn)換到相應(yīng)輸出的所有方法，諸如方程式，數(shù)學(xué)算法，邏輯操作 ?對(duì)輸出數(shù)據(jù)的合法性檢測 ?溢出 ?通信失敗 ?錯(cuò)誤處理 40 具體需求－功能需求 總體概述 具體需求 設(shè)計(jì)約束 質(zhì)量屬性 簡介 附錄 依賴關(guān)系 其它需求 ?輸出數(shù)據(jù)的描述 ?輸出到何處（如打印機(jī)、文件等） ?數(shù)量 ?度量單位 ?時(shí)序 ?允許的輸出偏差范圍 ?對(duì)非法值的處理 ?錯(cuò)誤消息 具體需求－功能需求 功能需求寫作要點(diǎn)： ? 每個(gè)功能需求分配唯一編號(hào)，且給出一有意義的標(biāo)題，便于檢索。若認(rèn)為實(shí)在沒有，那最可能是功