華為需求設(shè)計(jì)寫作培訓(xùn)質(zhì)量管理ppt課件

1、需求設(shè)計(jì)寫作培訓(xùn)質(zhì)量管理部SQA小組2005.06課程范圍僅關(guān)注如何寫作文檔不涉及具體的需求分析和設(shè)計(jì)方法課程內(nèi)容為什么要文檔化文檔寫作基本要求需求設(shè)計(jì)文檔模板需求文檔寫作設(shè)計(jì)文檔寫作為什么要文檔化開發(fā)人員通過文檔化的過程查錯(cuò)補(bǔ)遺；便于評(píng)審，在早期發(fā)現(xiàn)技術(shù)上的問題；后續(xù)階段開發(fā)任務(wù)可能由他人承擔(dān)，輸出文檔便于他們開展工作；維護(hù)人員開展維護(hù)工作需要；文檔是必要的交付件；可讀性就尤為關(guān)鍵為什么要文檔化“所有的過程分析都要形成文檔。我們現(xiàn)在有一個(gè)嚴(yán)重的問題是，大家好像不喜歡寫文檔，對(duì)于需要的實(shí)現(xiàn)方案，通常都是一個(gè)負(fù)責(zé)人在腦袋里想想該怎么實(shí)現(xiàn)，然后郵件或電話找?guī)讉€(gè)相關(guān)人員討論一下就算可以了，可能連個(gè)會(huì)

2、議材料或會(huì)議紀(jì)要都沒有。而老外可不是這樣的，他們非常非常重視文檔，他們認(rèn)為一個(gè)人在腦袋里想的東西是不清晰也不全面的，有時(shí)候心里想的認(rèn)為很正確的方案實(shí)際上可能存在致命缺陷。他們要求必須把心里的想法形成文檔才能有效的避免這種問題。寫文檔的過程中，可以更加有效的、更進(jìn)一步去整理您原來心里的思路，很多問題在您寫過文檔的過程中您就能發(fā)現(xiàn)；另外，文檔寫作多使用圖表，浪費(fèi)口水的文字盡量少用，和我們一起工作的系統(tǒng)工程師在系統(tǒng)架構(gòu)分析中就畫了五六十張圖，就算看不懂他寫的英文，從圖中我們就能夠很清晰的指導(dǎo)整個(gè)產(chǎn)品的系統(tǒng)架構(gòu)?！?摘自一位華為員工的瑞典出差報(bào)告5課程內(nèi)容為什么要文檔化文檔寫作基本要求需求設(shè)計(jì)文檔模板

3、需求文檔寫作設(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)使用“本”、“該”、“其”；表

4、述清晰，避免引起歧義；通篇文檔細(xì)節(jié)上要保持一致； 練習(xí) 房子南北走向，房子大門在東側(cè)中間位置。門廳長(zhǎng)約3米，寬2米，門廳左面是主臥室，右面是廚房。廚房3米寬，4米長(zhǎng)，廚房門對(duì)著門廳，廚房的頂頭還有一個(gè)北陽臺(tái)，與廚房同寬，長(zhǎng)1米。主臥室寬3米，長(zhǎng)5米左右，房間門對(duì)著客廳?？蛷d與餐廳連為一體，共7米長(zhǎng)，4米寬，與客廳相連有一南陽臺(tái)，與客廳同寬，長(zhǎng)1.5米。餐廳的北面是衛(wèi)生間，衛(wèi)生間與廚房相對(duì)，中間由1米寬，3米長(zhǎng)的過道隔開；衛(wèi)生間門對(duì)著過道，南墻與廚房的南墻在一條直線上；衛(wèi)生間為長(zhǎng)方形，南墻長(zhǎng)3米，另一邊長(zhǎng)2米。衛(wèi)生間的北面是次臥，同寬，門朝著過道，次臥長(zhǎng)4米。過道的北端是書房門，書房南北長(zhǎng)4米，

5、書房有一個(gè)一米見方的門廳，書房的西墻長(zhǎng)4米，包括1米長(zhǎng)的門廳長(zhǎng)度，西墻把書房和次臥分隔開。門廳東墻北端90角折向東，長(zhǎng)2米，把書房和廚房北陽臺(tái)分隔開。大家認(rèn)為下面的描述如何？究竟長(zhǎng)多少？? 是左？還是右？大段的敘述，不利于理解！10練習(xí)1.房子南北走向，房子大門在東側(cè)中間位置。2.門廳長(zhǎng)3米，寬2米，門廳左面是主臥室，右面是廚房。3.廚房3米寬，4米長(zhǎng)，廚房門對(duì)著門廳，廚房的頂頭還有一個(gè)北陽臺(tái)，與廚房同寬，長(zhǎng)1米。4.主臥室寬3米，長(zhǎng)5米左右，房間門對(duì)著客廳。5.客廳與餐廳連為一體，共7米長(zhǎng)，4米寬，與客廳相連有一南陽臺(tái)，與客廳同寬，長(zhǎng)1.5米。6.餐廳的北面是衛(wèi)生間，衛(wèi)生間與廚房相對(duì)，中間由

6、1米寬，3米長(zhǎng)的過道隔開；衛(wèi)生間門對(duì)著過道，南墻與廚房的南墻在一條直線上；衛(wèi)生間為長(zhǎng)方形，南墻長(zhǎng)3米，另一邊長(zhǎng)2米。7.衛(wèi)生間的北面是次臥，同寬，門朝著過道，次臥長(zhǎng)4米。8.過道的北端是書房門，書房南北長(zhǎng)4米，書房有一個(gè)一米見方的門廳，書房的西墻長(zhǎng)4米，包括1米長(zhǎng)的門廳長(zhǎng)度，西墻把書房和次臥分隔開。門廳東墻北端90角折向東，長(zhǎng)2米，把書房和廚房北陽臺(tái)分隔開。修改成如下描述之后呢？練習(xí)主臥室次臥室廚房餐廳客廳陽臺(tái)陽臺(tái)衛(wèi)生間書房門廳過道北西再改成如下圖形描述呢？練習(xí)LSW與CAMS配合實(shí)現(xiàn)認(rèn)證計(jì)費(fèi)的方案中，客戶（禁止多人同時(shí)使用的業(yè)務(wù)帳號(hào)）登陸通過認(rèn)證開始計(jì)費(fèi)后，如果出現(xiàn)LSW重起的情況，處理方法

7、分為兩種：1.有時(shí)間芯片的LSW（可以記錄時(shí)間的），設(shè)備重起后會(huì)使用設(shè)備時(shí)間戳的特性判斷出設(shè)備重起了，這時(shí)會(huì)將CAMS上的在線用戶刪除并按照最后一次計(jì)費(fèi)更新報(bào)文來終結(jié)計(jì)費(fèi)。用戶可再次正常登陸。2.下面的描述呢？白話修改成如下的描述呢？1.使用時(shí)間芯片的LSW（支持記錄時(shí)間功能），利用設(shè)備時(shí)間戳特性可以檢測(cè)出設(shè)備是否重啟，設(shè)備重啟時(shí)將CAMS上的在線用戶刪除，并依據(jù)最后一次計(jì)費(fèi)更新報(bào)文終結(jié)計(jì)費(fèi)。用戶可再次正常登陸。練習(xí)由于一臺(tái)設(shè)備可以設(shè)置多個(gè)radius服務(wù)器，也就是radius scheme。用戶可以通過命令行來配置該radius服務(wù)器是否啟動(dòng)設(shè)備重啟防吊死功能。 由于一臺(tái)設(shè)備可以設(shè)置多個(gè)ra

8、dius服務(wù)器，即radius scheme。用戶可以通過命令行來配置該radius服務(wù)器是否啟動(dòng)設(shè)備重啟防吊死功能。 練習(xí)CAMS收到該報(bào)文后會(huì)立即回應(yīng)一個(gè)code=5的計(jì)費(fèi)回應(yīng)報(bào)文，然后根據(jù)accounting-on報(bào)文攜帶的NAS-IP和NAS-ID找到通過該設(shè)備認(rèn)證的用戶，并將他們的在線信息刪除。 CAMS收到該報(bào)文后會(huì)立即回應(yīng)一個(gè)code=5的計(jì)費(fèi)回應(yīng)報(bào)文，然后根據(jù)accounting-on報(bào)文攜帶的NAS-IP和NAS-ID找到通過該設(shè)備認(rèn)證的用戶，并將其在線信息刪除。 15練習(xí)修改原因： 這個(gè)函數(shù)是將要發(fā)送的packet轉(zhuǎn)化為buffer，系統(tǒng)原有函數(shù)RD_PutPacketTo

9、Buffer是針對(duì)認(rèn)證用戶設(shè)計(jì)的，由于本特性為設(shè)備啟動(dòng)后執(zhí)行，沒有用戶信息，所以在RD_PutPacketToBuffer函數(shù)基礎(chǔ)上做了一些修改，形成該函數(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ù)。 練習(xí)ARP Authorized加強(qiáng)了網(wǎng)絡(luò)安全，阻止了DHCP server對(duì)非法ARP回應(yīng)進(jìn)行學(xué)習(xí)，并且通過周期的ARP ping可以快速的探測(cè)到用戶是否下線。在設(shè)備的接口

10、上使能ARP Authorized，該接口的ARP動(dòng)態(tài)學(xué)習(xí)功能被禁止。在某個(gè)接口上禁止arp動(dòng)態(tài)學(xué)習(xí)，不影響其他接口的arp學(xué)習(xí)。在禁止了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ì)說明。DHCP server就是這樣的一個(gè)模塊。靜態(tài)arp的優(yōu)先級(jí)高于授權(quán)arp，也就是說可以覆蓋授權(quán)arp。 1. ARP與arp、ARP Authorized與授權(quán)arp，使用術(shù)語應(yīng)該統(tǒng)一；2. ARP Authorized應(yīng)先解釋后引用；3. “D

11、HCP server就是這樣的一個(gè)模塊”，是否相關(guān)？課程內(nèi)容為什么要文檔化文檔寫作基本要求需求設(shè)計(jì)文檔模板需求文檔寫作設(shè)計(jì)文檔寫作模板何處獲取需求SRS文檔：REP01T01http:/jvpal接口文檔：REP01T03http:/jvpal設(shè)計(jì)概要設(shè)計(jì)：DVP05T01http:/jvpal詳細(xì)設(shè)計(jì)：DVP05T03http:/jvpal軟件設(shè)計(jì)：DVP05T04http:/jvpal移植設(shè)計(jì)：DVP05T05http:/jvpal需求設(shè)計(jì)合一來自華為北研所h3crnd01-fs軟件部規(guī)范小特性開發(fā)規(guī)范模板需求設(shè)計(jì)需求設(shè)計(jì)文檔模板19課程內(nèi)容為什么要文檔化文檔寫作基本要求需求設(shè)計(jì)文檔模板需

12、求文檔寫作設(shè)計(jì)文檔寫作什么是好的需求什么樣的需求是好的需求完整性清晰性可行性一致性可驗(yàn)證性練習(xí)2.1.1Functional Requirements1 功能需求1修改設(shè)置smarton password命令1.Introduction介紹 在設(shè)置smarton password的同時(shí)，規(guī)定密碼顯示形式為明文和密文。2.Inputs 輸入 1)密碼顯示形式。 2)smarton password。3.Process 處理 1)記錄密碼顯示形式。 2)當(dāng)密碼顯示形式為simple時(shí)，直接設(shè)置smarton password為設(shè)置值；當(dāng)密碼顯示形式為cipher時(shí)，如果設(shè)置值是密文，先將其進(jìn)行解密

13、成明文再設(shè)置，如果是明文則直接設(shè)置。4.output輸出 無5.Inherit繼承性 Update-需要改進(jìn)大家看看下面的需求描述如何？1.介紹中描述的顯示形式有明文和密文兩種，但處理中描述的顯示形式卻是simple和cipher，不一致；2.密碼允許輸入哪些字符，長(zhǎng)度有無限制，均沒有交待。不完整3.輸出沒有嗎？不完整練習(xí)2.1.1配置或者取消配置系統(tǒng)WOL功能1.Introduction介紹 在系統(tǒng)視圖下配置或者取消配置WOL使能。2.Inputs 輸入 系統(tǒng)視圖下: wol enable 或 undo wol enable3.Process 處理 在系統(tǒng)視圖下配置或者取消WOL使能。去系統(tǒng)

14、WOL使能時(shí)，將WOL模塊的MAC-ADDR表清空，釋放所占內(nèi)存。初始化MAC地址表相關(guān)指針。4.output輸出 WOL功能在系統(tǒng)中被使能或被去使能；去系統(tǒng)使能時(shí)，MAC-ADDR表被清空。5.Inherit繼承性 NEW-新增功能在前面沒有介紹的情況下，這里應(yīng)對(duì)縮略語進(jìn)行詳細(xì)解釋，否則不完整練習(xí)2.1.1SRS.FUNC.DHG.001 IKE模塊支持DH交換時(shí)使用Group5，Group141.Introduction介紹 支持IKE DH組的Group5和Group14是由8040波蘭提出的新需求，用戶希望能提供更高安全級(jí)別的安全密鑰，希望能支持DH 3/4/5，但是DH Group3

15、/4是由橢圓曲線來實(shí)現(xiàn)的，與Group1/2/5有很大的區(qū)別，且需要較大的工作量，因此本次特性開發(fā)暫且實(shí)現(xiàn)對(duì)Group5/14的支持。完整性：這種術(shù)語也應(yīng)該簡(jiǎn)單介紹，畢竟不是算數(shù)學(xué)題練習(xí)2.2.18R.FUNC. 018支持XRN堆疊 3.Process 處理 當(dāng)unit down時(shí)，處理端口刪除消息，把down掉的unit端口從鏡像組中刪除，由此可能有相應(yīng)的鏡像組狀態(tài)的改變。 當(dāng)收到unit up消息時(shí)，本unit向其它unit發(fā)送端口鏡像同步消息。此消息包含本unit所配置的鏡像組信息。2.2.1Performance Requirements 性能需求1.Performance Requ

16、irements1 性能需求1 通話語音要求流暢?！翱赡堋?、“流暢”都是不清晰的，不同人理解不一樣。不清晰一般也不可驗(yàn)證。25SRS大綱簡(jiǎn)介目的范圍總體概述軟件概述軟件功能用戶特征假設(shè)和依賴關(guān)系需求建模建模工具具體需求功能需求性能需求外部接口需求總體設(shè)計(jì)約束標(biāo)準(zhǔn)符合性硬件約束技術(shù)限制軟件質(zhì)量屬性可維護(hù)性可靠性依賴關(guān)系其他需求需求分級(jí)附錄簡(jiǎn)介總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求目的范圍描述文檔目的指明文檔讀者軟件命名軟件要做什么，不做什么軟件的應(yīng)用要點(diǎn)：“目的”是針對(duì)文檔，“范圍”針對(duì)的是軟件功能。練習(xí)1Introduction 簡(jiǎn)介1.1Purpose 目的 本文用于描述D

17、HCP增強(qiáng)項(xiàng)目中ARP相關(guān)需求的需求及設(shè)計(jì)，滿足以下分配需求： 1.在接口上禁止ARP動(dòng)態(tài)學(xué)習(xí)； 2.允許DHCP server添加授權(quán)ARP； 3.ARP PING； 4.配置授權(quán)ARP老化時(shí)間； 5.如果dhcp server刪除租約則應(yīng)刪除相應(yīng)的arp； 6.刪除授權(quán)ARP表項(xiàng)后刪除租約； 本文適用于相關(guān)開發(fā)及維護(hù)人員，本文檔描述了COMWAREV300R002產(chǎn)品的軟件需求。1.2Scope 范圍 本文包括DHCP增強(qiáng)項(xiàng)目中ARP相關(guān)需求的需求規(guī)格分析及軟件設(shè)計(jì)說明。 本文不包括相關(guān)實(shí)現(xiàn)代碼、用戶指導(dǎo)及測(cè)試計(jì)劃。應(yīng)在范圍中描述范圍不是用來描述本文包括什么、不包括什么總體概述總體概述具體

18、需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求假設(shè)和依賴關(guān)系總體概述軟件功能用戶特征軟件概述本節(jié)不對(duì)需求作具體描述，只是為了使那些需求更易于理解總體概述軟件概述總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(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ì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求提供軟件所實(shí)現(xiàn)功能的一個(gè)概要描述可以從更高層規(guī)格文檔直接引用清楚易懂顯示不同功能及其相互關(guān)系不描述具體需求功能3功能1功能2。總體概述用戶特征

19、總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求描述影響特定需求的最終用戶的一般特征最終用戶：操作人員、維護(hù)人員、系統(tǒng)管理人員等考慮方面：受教育程度、經(jīng)驗(yàn)、專業(yè)技術(shù)知識(shí)等總體概述假設(shè)和依賴總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求假設(shè)尚不確定但又必須要的情況下，所設(shè)定的一個(gè)參考結(jié)果，與已知事實(shí)相對(duì)。依賴對(duì)外部條件的依賴，兩者之間存在明確的需求關(guān)系。練習(xí)1.本項(xiàng)目基于PPPoFR和MPoFR應(yīng)用，是針對(duì)虛模板上的QoS應(yīng)用的增強(qiáng)型項(xiàng)目，要求原有的PPPoFR模塊、QoS模塊、MP模塊穩(wěn)定可靠。2.本項(xiàng)目依賴ACL模塊的穩(wěn)定性，包括ACL規(guī)則的維護(hù)、匹配等。3.本項(xiàng)目依賴VR

20、P提供的VOS底層平臺(tái)，如內(nèi)存管理、定時(shí)器、消息和隊(duì)列等。4.本性能優(yōu)化項(xiàng)目基于的前提是，目前系統(tǒng)轉(zhuǎn)發(fā)性能的瓶頸在轉(zhuǎn)發(fā)流程，而非硬件限制。下面的描述是假設(shè)還是依賴？假設(shè)依賴依賴假設(shè)需求建模需求建模具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求總體概述DFD樣例在DOS環(huán)境下模擬實(shí)現(xiàn)ATM柜員機(jī)的功能需求分析方法更多的培訓(xùn)資料參見 h3crnd01-fs軟件部規(guī)范小特性開發(fā)規(guī)范培訓(xùn)需求設(shè)計(jì)35具體需求功能需求具體需求性能需求接口需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求逐條定義具體需求包含需求規(guī)格的所有細(xì)節(jié)一條需求必須有一個(gè)編號(hào)具體需求功能需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性

21、簡(jiǎn)介附錄依賴關(guān)系其它需求處理功能需求描述每一個(gè)需求的輸入怎樣被轉(zhuǎn)換成輸出，描述軟件必須執(zhí)行的基本動(dòng)作，同時(shí)給出該規(guī)格的優(yōu)先級(jí)。輸入輸出具體需求功能需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求功能需求描述介紹處理該功能的目的、使用方法和技巧，及相關(guān)背景介紹所有輸出數(shù)據(jù)的詳細(xì)描述從輸入數(shù)據(jù)和中間參數(shù)獲得輸出的所有操作所有輸入數(shù)據(jù)的詳細(xì)描述輸入輸出具體需求功能需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求輸入數(shù)據(jù)的描述：輸入來源數(shù)量度量單位時(shí)序允許的輸入偏差范圍具體需求功能需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求處理操作：輸入數(shù)據(jù)合法性檢測(cè)操作次序異

22、常情況的響應(yīng)操作影響到的參數(shù)用于把系統(tǒng)輸入轉(zhuǎn)換到相應(yīng)輸出的所有方法，諸如方程式，數(shù)學(xué)算法，邏輯操作對(duì)輸出數(shù)據(jù)的合法性檢測(cè)溢出通信失敗錯(cuò)誤處理40具體需求功能需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求輸出數(shù)據(jù)的描述輸出到何處（如打印機(jī)、文件等）數(shù)量度量單位時(shí)序允許的輸出偏差范圍對(duì)非法值的處理錯(cuò)誤消息具體需求功能需求功能需求寫作要點(diǎn)：每個(gè)功能需求分配唯一編號(hào)，且給出一有意義的標(biāo)題，便于檢索。標(biāo)題通常是動(dòng)賓詞組，不要使用“功能需求一/二”這樣的描述。是描述What to do，而不是How to do；介紹部分描述“做什么”沒有意義，因?yàn)楹竺鍵PO會(huì)詳細(xì)介紹。應(yīng)描述有利于理解后續(xù)I

23、PO的內(nèi)容： Why，為什么會(huì)有此需求 When/Where，什么時(shí)候/什么場(chǎng)合使用 How，如何使用 對(duì)IPO描述中將使用到的特殊術(shù)語的解釋 與其它功能需求的聯(lián)系等具體需求功能需求功能需求寫作要點(diǎn)(續(xù))：處理部分可以采用C語言中關(guān)鍵詞如if、else、while等輔助描述，這樣在時(shí)序、邏輯上更清晰；IPO缺一不可 有些情況下，輸入輸出可能不直觀，如：定時(shí)器超時(shí)事件、接口up/down事件等，但并不是沒有，否則處理什么。若認(rèn)為實(shí)在沒有，那最可能是功能需求分解不合理，所描述的功能根本就不成為需求。不要將命令行作為功能需求描述 單純的命令行不能提供任何功能，只是用戶界面而已； 每一命令行之后都承載

24、著一具體功能； 命令行的形式我們可以自行定義，但其后的功能我們無法自行定義； 用戶真正需要的是命令行承載的功能。命令行形式，甚至是命令行是否必要，這些用戶并不會(huì)關(guān)心。練習(xí)2.1.1.取撥號(hào)口屬性函數(shù)1.Introduction介紹 取以下配置：鏈路空閑掛斷時(shí)間：dialer timer idle；呼叫間隔時(shí)間：dialer timer enable；鏈路建立等待時(shí)間：dialer timer wait-carrier；競(jìng)爭(zhēng)等待時(shí)間： dialer timer compete；緩沖區(qū)報(bào)文數(shù)： dialer queue-length2.Inputs 輸入 NULL。3.Process 處理 遍歷所

25、有的全局DDR控制塊鏈表 是Dialer接口和物理接口 取DDR的ifnet 取所有的撥號(hào)口屬性 返回鏈表頭指針4.Output 輸出 撥號(hào)口屬性鏈表頭指針。1.在描述實(shí)現(xiàn)，按照這樣的IPO描述無法對(duì)其進(jìn)行驗(yàn)證；2.更應(yīng)該作為一個(gè)接口需求，而不是功能需求；具體需求性能需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求描述軟件或人機(jī)交互的靜態(tài)和動(dòng)態(tài)量化需求。靜態(tài)的量化需求支持的終端數(shù)目支持的并發(fā)用戶數(shù)目需處理的文件和記錄的數(shù)目表和文件的大小動(dòng)態(tài)的量化需求可包括正常和滿負(fù)荷業(yè)務(wù)量條件下，某時(shí)間段（如一小時(shí)）內(nèi)處理的事務(wù)和任務(wù)的數(shù)目以及數(shù)據(jù)量。45具體需求性能需求舉例：性能需求寫作要點(diǎn)：每

26、條性能需求必須以可測(cè)量的術(shù)語進(jìn)行描述，即應(yīng)給出明確的量化指標(biāo)，包括度量單位；對(duì)于動(dòng)態(tài)性能指標(biāo)，除性能指標(biāo)外，還應(yīng)包含必要的的前置條件；前置條件交易能很快完成，操作員不必等待。95%的事務(wù)應(yīng)在1秒內(nèi)被處理。電梯由靜止?fàn)顟B(tài)進(jìn)入正常勻速(2m/s)狀態(tài)時(shí)間限定在22.5s秒內(nèi)。具體需求接口需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求接口需求硬件接口軟件接口用戶接口通信接口軟件人機(jī)交互特性與系統(tǒng)硬件之間的接口與其他軟件產(chǎn)品或應(yīng)用系統(tǒng)之間的接口消息、回調(diào)函數(shù)等系統(tǒng)內(nèi)部通信接口具體需求接口需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求用戶接口示例：系統(tǒng)用戶通過一個(gè)顯示終端進(jìn)行

27、操作，需要描述：要求的屏幕格式頁面布局以及報(bào)告或菜單的內(nèi)容輸入和輸出的相關(guān)時(shí)序是否支持可編輯功能鍵具體需求接口需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求軟件接口描述如何使用其他軟件，針對(duì)每個(gè)所需軟件描述：名字助記符版本號(hào)來源描述與其他軟件的接口，針對(duì)每個(gè)接口描述：接口的目的通過消息和格式定義接口具體需求接口需求接口需求寫作要點(diǎn)：用戶接口若是命令行，寫作需遵照操作手冊(cè)的格式進(jìn)行；軟件接口小節(jié)，應(yīng)只描述本軟件/系統(tǒng)對(duì)外提供的軟件接口，不包括外部提供給本軟件/系統(tǒng)的接口，后者應(yīng)在依賴中予以描述；軟件接口若為函數(shù)，寫作可以按照代碼中函數(shù)頭的格式進(jìn)行，這樣在后續(xù)階段能很方便地重用。如：

28、1.R.INTF.SOFT.001 認(rèn)證接口/* 函數(shù)名稱: ATMLoginInProc* 功能描述: 讀取輸入的用戶的賬號(hào)名及密碼，保存到當(dāng)前用戶信息全局變量中，* 并到賬務(wù)處理系統(tǒng)進(jìn)行認(rèn)證。 * 輸 入: 無 * 輸 出: 無 * 返 回 值: VOS_OK： 表示登錄成功； VOS_ERR：表示登錄失敗。 * 調(diào)用關(guān)系: 略* 其 它: 無*/50總體設(shè)計(jì)約束描述由標(biāo)準(zhǔn)、硬件、技術(shù)限制等造成的對(duì)設(shè)計(jì)的限制標(biāo)準(zhǔn)順從：描述來自現(xiàn)有標(biāo)準(zhǔn)和規(guī)則的需求報(bào)告格式數(shù)據(jù)命名協(xié)議硬件約束：描述支持軟件運(yùn)行的硬件條件，如內(nèi)存限制技術(shù)限制：描述對(duì)使用的特定技術(shù)的限制，如數(shù)據(jù)庫、并行操作等總體概述具體需求設(shè)計(jì)

29、約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求軟件質(zhì)量屬性可維護(hù)性可靠性安全性可移植性易用性.總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求軟件質(zhì)量屬性總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求可維護(hù)性描述支持軟件可維護(hù)的具體需求例如：跟蹤調(diào)試功能告警提示功能對(duì)軟件模塊之間的耦合度進(jìn)行考慮軟件質(zhì)量屬性總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求可靠性容錯(cuò)性在出現(xiàn)軟件故障的時(shí)候仍然能夠維持某種層次性能的能力?？苫謴?fù)性在出現(xiàn)故障時(shí)的恢復(fù)能力和重新建立某種層次性能的能力。例如：主備板熱備份通信鏈路中斷重連軟件質(zhì)量屬性總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求安

30、全性在此描述防止軟件遭到意外或惡意的侵入、使用、修改、破壞或泄密的因素。例如：使用特定的加密技術(shù)保存詳細(xì)的日志或歷史數(shù)據(jù)對(duì)不同模塊分配特定的功能限制程序某些區(qū)域間進(jìn)行通信對(duì)重要的數(shù)據(jù)計(jì)算校驗(yàn)和55軟件質(zhì)量屬性總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求可移植性描述把軟件從一個(gè)環(huán)境轉(zhuǎn)換到另一個(gè)環(huán)境時(shí)，所需要的用戶程序、用戶接口兼容性限制等需求。軟件質(zhì)量屬性總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求易用性易懂性：用戶通曉邏輯概念花費(fèi)的人力和軟件的適用性易學(xué)性：用戶學(xué)習(xí)應(yīng)用程序花費(fèi)的人力易操作性：用戶操作應(yīng)用程序所花費(fèi)的人力依賴關(guān)系依賴關(guān)系解釋每一條需求的內(nèi)部和外部依賴關(guān)系

31、說明：依賴關(guān)系也可以在前面具體介紹每一條需求時(shí)進(jìn)行描述總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求其它需求總體概述具體需求設(shè)計(jì)約束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求數(shù)據(jù)庫操作本地化需求其它需求附錄附錄I/O 格式的示例，成本分析研究的描述，用戶調(diào)查的結(jié)果有助于用戶閱讀SRS的支持或背景信息軟件將解決的問題的描述被支持組織的歷史，背景，經(jīng)驗(yàn)和操作特征軟件需求與項(xiàng)目里程碑的交叉參考表，指明哪些軟件需求將在哪些里程碑階段里完成為了符合安全、出口、安裝或其它需求，對(duì)代碼和介質(zhì)的特殊包裝要求說明：附錄不是必須要求的內(nèi)容SRS中包含附錄時(shí)，應(yīng)明確聲明附錄是否是需求的一部分?？傮w概述具體需求設(shè)計(jì)約

32、束質(zhì)量屬性簡(jiǎn)介附錄依賴關(guān)系其它需求60需求文檔寫作要點(diǎn)僅關(guān)注“What to do”，即系統(tǒng)需提供什么功能。不要描述“How to do”，那是設(shè)計(jì)關(guān)注的事情。1.功能需求部分不要出現(xiàn)“函數(shù)”、“數(shù)據(jù)結(jié)構(gòu)”、“指針”、buildrun之類的表述；2.站在客戶的立場(chǎng)上來寫需求，而不是站在開發(fā)人員的立場(chǎng)上。需求文檔寫作要點(diǎn)功能需求劃分應(yīng)合理3.1Functional Requirements 功能需求3.1.1配置要求通過PPP協(xié)商從對(duì)端得到協(xié)商的DNS地址1.Introduction介紹 在接口視圖下通過以下命令來配置要求通過PPP主動(dòng)協(xié)商從對(duì)端得到DNS地址：ppp ipcp dns requ

33、est 2.Inputs 輸入 用戶在某一封裝了PPP協(xié)議的接口視圖下，輸入 ：ppp ipcp dns request 3.Process 處理 路由器解析此命令輸入正確后，將修改PPP協(xié)議中的協(xié)商參數(shù)，使的路由器在進(jìn)行PPP協(xié)商的時(shí)候會(huì)要求對(duì)端分配協(xié)商的DNS地址。4.Output 輸出 操作成功后，可以通過在當(dāng)前視圖下輸入 display this 命令來查看配置是否成功。否則顯示出錯(cuò)提示。3.1.2配置取消要求通過PPP協(xié)商從對(duì)端得到協(xié)商的DNS地址1.Introduction介紹 在接口視圖下通過以下命令來配置取消要求通過PPP主動(dòng)協(xié)商從對(duì)端得到DNS地址：undo ppp ipcp

34、 dns request 下一頁需求文檔寫作要點(diǎn)2.Inputs 輸入 用戶在某一封裝了PPP協(xié)議的接口視圖下，輸入 ： undo ppp ipcp dns request 3.Process 處理 路由器解析此命令輸入正確后，將修改PPP協(xié)議中的協(xié)商參數(shù)，使的路由器在進(jìn)行PPP協(xié)商的時(shí)候不會(huì)要求對(duì)端分配協(xié)商的DNS地址。4.Output 輸出 操作成功后，可以通過在當(dāng)前視圖下輸入 display this 命令來查看先前配置是否被取消。否則顯示出錯(cuò)提示。3.1.3配置保存協(xié)商得到的DNS地址，并可通過命令display interface查看1.Introduction介紹 保存從對(duì)端協(xié)商得

35、到的DNS地址，并可通過查看接口信息的display interface命令將得到的DNS地址顯示出來。2.Inputs 輸入 取出協(xié)商得到的DNS地址3.Process 處理 路由器保存協(xié)商得到的DNS地址，并將其添加到接口信息中4.Output 輸出 操作成功后，協(xié)商得到的DNS地址保存GotOptions里，并被添加到接口信息中，否則顯示出錯(cuò)提示，不會(huì)顯示在接口信息中。分析： 前兩個(gè)功能點(diǎn)是在描述一條命令行，而后一功能點(diǎn)描述的是另一條相關(guān)的命令行。 用戶的需求是什么？是這兩條命令行嗎？ 命令行只是我們提供的用戶界面，隱藏其后的功能需求是什么？ “支持通過PPP協(xié)商獲取DNS地址”，就這一

36、條。 拆成三條，需求分解不合理，如何修正？ 一條功能需求（支持通過PPP協(xié)商獲取DNS地址） display命令的修改可以在功能需求的輸出中提及。 一條接口需求（undo ppp ipcp dns request ）需求文檔寫作要點(diǎn)唐僧：唉唉唉！大家不要生氣，生氣會(huì)犯了嗔戒的！悟空你也太調(diào)皮了，我跟你說過，叫你不要亂扔?xùn)|西。亂扔?xùn)|西這么多你看我還沒說完呢，你把棍子又給扔掉了！月光寶盒是寶物，你把它扔掉會(huì)污染環(huán)境。唉，要是砸到小朋友呢，怎么辦？就算沒有砸到小朋友，砸到那些花花草草也是不對(duì)的呀！保持語句和段落的簡(jiǎn)短。需求文檔寫作要點(diǎn)需求陳述應(yīng)該具有一致的樣式。例如“系統(tǒng)必須”或者“用戶必須”，并緊

37、跟一個(gè)行為動(dòng)作和可觀察的結(jié)果。舉例：計(jì)算過程中出現(xiàn)除零錯(cuò)誤時(shí)，系統(tǒng)必須立即彈出對(duì)話框顯示該錯(cuò)誤，并進(jìn)行聲音提示。舉例：計(jì)算過程中出現(xiàn)除零錯(cuò)誤時(shí)，系統(tǒng)必須給出提示信息。65需求文檔寫作要點(diǎn)必須避免模糊的、主觀的術(shù)語，減少不確定性。例如：也許、大概、可能、界面友好、容易、簡(jiǎn)單、美觀、迅速、有效、支持、許多、最新技術(shù)、優(yōu)越的、可接受的和健壯的。 .美女. !需求文檔寫作要點(diǎn)避免使用比較性的詞匯，例如：提高、最大化、最小化和最佳化。定量地說明所需要提高的程度或者說清一些參數(shù)可接受的最大值和最小值。提高文件柜的高度?；镉?jì)2伙計(jì)3伙計(jì)1伙計(jì)1需求文檔寫作要點(diǎn)不應(yīng)該把多個(gè)需求集中在一個(gè)冗長(zhǎng)的敘述段落中。務(wù)必

38、記?。翰灰谛枨笳f明中使用“和/或”，“等等”之類的連詞。C&C08交換機(jī)應(yīng)該提供呼叫等待和三方通話等新業(yè)務(wù)。C&C08交換機(jī)應(yīng)該提供呼叫等待功能。C&C08交換機(jī)應(yīng)該提供三方通話功能。C&C08交換機(jī)應(yīng)該提供呼叫轉(zhuǎn)移功能。C&C08交換機(jī)應(yīng)該提供鬧鐘服務(wù)功能。 這個(gè)“等”包含哪些內(nèi)容？怎么測(cè)試？測(cè)試人員需求范例69課程內(nèi)容為什么要文檔化文檔寫作基本要求需求設(shè)計(jì)文檔模板需求文檔寫作設(shè)計(jì)文檔寫作設(shè)計(jì)文檔大綱(開發(fā)項(xiàng)目)零層設(shè)計(jì)一層設(shè)計(jì)二層設(shè)計(jì)配置和控制簡(jiǎn)介模塊1詳設(shè)數(shù)據(jù)庫模塊n詳設(shè)HLDLLD上下文定義設(shè)計(jì)思路分解描述依賴性描述接口描述分解描述依賴性描述接口描述數(shù)據(jù)描述函數(shù)描述開發(fā)項(xiàng)目：系統(tǒng)總體

39、設(shè)計(jì)子系統(tǒng)設(shè)計(jì)系統(tǒng)對(duì)外關(guān)系HLD分解層次一般不超過3層（0層、1層、2層），每層的模塊數(shù)以2到4個(gè)為宜，最多不要超過7個(gè)。單元模塊函數(shù)總數(shù)也不超過7個(gè)；HLD階段將所有函數(shù)全部分解出來，LLD階段不再關(guān)注模塊分解；HLD使用結(jié)構(gòu)圖描述函數(shù)的調(diào)用關(guān)系；函數(shù)分解規(guī)模以3050行(非空非注釋)為宜，最大不超過200行。每個(gè)函數(shù)的復(fù)雜度控制在10以內(nèi)，即：一個(gè)函數(shù)中不能有太多的if，else，for, switchcase等邏輯；LLD階段寫偽碼，推薦在source insight中寫，完成后嵌入LLD中。偽碼的粗細(xì)程度以適宜作注釋為標(biāo)準(zhǔn)；設(shè)計(jì)文檔寫作要點(diǎn)結(jié)構(gòu)圖(structure chart)描述了

40、一個(gè)系統(tǒng)的模塊劃分，體現(xiàn)了模塊之間的層次、組織和通信關(guān)系 示例：結(jié)構(gòu)圖偽碼又叫PDL(Program Design Language)，是一種混合語言，用自然語言（如英語、漢語等）描述程序的處理邏輯，用一定的關(guān)鍵字語法（如if、else等）定義控制結(jié)構(gòu)和數(shù)據(jù)結(jié)構(gòu)。優(yōu)點(diǎn)：維護(hù)方便容易評(píng)審作為代碼注釋缺點(diǎn)：不容易掌握粗細(xì)容易寫成代碼偽碼偽碼 = 關(guān)鍵字語法 + 自然語言描述偽碼使用C語言的語法書寫偽代碼，使用標(biāo)準(zhǔn)符號(hào)，如：if, else, , while等；用描述性語言來描述；if（接口是以太網(wǎng)接口）if（InterfaceType = ETHERNET)詳略得當(dāng)。用概括性的語句來描述具體的處理

41、，要求在每個(gè)邏輯處理分支用簡(jiǎn)練、概括性的語言描述處理，而不要局限于處理的細(xì)節(jié)。 封裝IP報(bào)文頭的內(nèi)容;用收到報(bào)文的源地址來設(shè)置發(fā)送報(bào)文的目的地址;用發(fā)送報(bào)文接口的地址來設(shè)置發(fā)送報(bào)文的源地址;偽碼寫作說明：75設(shè)計(jì)樣例設(shè)計(jì)文檔大綱(增強(qiáng)、移植項(xiàng)目)移植或增強(qiáng)項(xiàng)目：修改分類1修改原因影響分析修改描述修改點(diǎn)1修改點(diǎn)n修改分類N增強(qiáng)、移植設(shè)計(jì)修改分類：對(duì)所有需要的修改點(diǎn)進(jìn)行分類，一個(gè)修改分類包含一個(gè)或多個(gè)修改點(diǎn)，實(shí)現(xiàn)一相對(duì)獨(dú)立的功能；每個(gè)修改分類都應(yīng)使用有明確含義的標(biāo)題，如：“關(guān)于XXX的修改”。修改分類一關(guān)于將MQC策略應(yīng)用到ATM PVC接口下的修改修改點(diǎn)：一個(gè)修改點(diǎn)描述一處修改，如一個(gè)數(shù)據(jù)結(jié)構(gòu)的修改，一個(gè)宏定義的修改，一個(gè)函數(shù)的修改等；修改點(diǎn)也應(yīng)使用有意義的標(biāo)題，不要使用“修改點(diǎn)1”等。增強(qiáng)、移植設(shè)計(jì)修改原因：針對(duì)每個(gè)修改點(diǎn)，具體闡述