軟件開(kāi)發(fā)管理規(guī)范匯編課件

1、軟件開(kāi)發(fā)管理規(guī)范匯編軟件開(kāi)發(fā)管理規(guī)范匯編內(nèi)容提要文檔的分類和等級(jí)文檔管理的原則和方法文檔示例與討論2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范2內(nèi)容提要2022年9月4日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范4為什么需要文檔管理？項(xiàng)目管理的依據(jù)了解進(jìn)度、分析問(wèn)題，提供項(xiàng)目可預(yù)見(jiàn)性工作交流的憑證口說(shuō)無(wú)憑，立字為據(jù)軟件測(cè)試的基礎(chǔ)沒(méi)有文檔，測(cè)試人員無(wú)法展開(kāi)工作培訓(xùn)用戶的參考幫助外界人員了解項(xiàng)目?jī)?nèi)幕技術(shù)支持的幫手幫助技術(shù)支持人員熟悉系統(tǒng)、分析錯(cuò)誤、解決問(wèn)題記錄歷史的必須軟件最大的價(jià)值在于可復(fù)用性2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范3為什么需要文檔管理？項(xiàng)目管理的依據(jù)2022年9月4日軟件項(xiàng)目為什

2、么需要文檔管理？2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范4按規(guī)范要求生成一整套文檔的過(guò)程，就是按照軟件開(kāi)發(fā)規(guī)范完成一個(gè)軟件開(kāi)發(fā)的過(guò)程。為什么需要文檔管理？2022年9月4日軟件項(xiàng)目管理培訓(xùn)之三編寫(xiě)文檔的基本思路明確文檔范圍，避免空泛浮躁大而全的文檔是沒(méi)有用的定位讀者角度，防止對(duì)牛彈琴以讀者能夠理解作為編寫(xiě)文檔的標(biāo)準(zhǔn)規(guī)范名詞稱謂，保持前后一致統(tǒng)一的名詞和稱謂，會(huì)降低文檔的歧義性注重版本控制，切忌顧此失彼不同階段的文檔記錄了項(xiàng)目開(kāi)發(fā)的完整過(guò)程應(yīng)用圖文表格，保證內(nèi)容清晰簡(jiǎn)潔的圖形和表格勝過(guò)前言萬(wàn)語(yǔ)2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范5編寫(xiě)文檔的基本思路明確文檔范圍，避免空泛浮躁2

3、022年9月4文檔的分類（1）類型讀者時(shí)間可行性研究報(bào)告管理/研發(fā)人員可行性研究與計(jì)劃階段項(xiàng)目開(kāi)發(fā)計(jì)劃管理/研發(fā)人員可行性研究、需求分析階段設(shè)需求規(guī)格說(shuō)明書(shū)研發(fā)人員需求分析階段計(jì)功能規(guī)格說(shuō)明書(shū)研發(fā)人員需求分析階段開(kāi)概要設(shè)計(jì)說(shuō)明書(shū)研發(fā)/維護(hù)人員設(shè)計(jì)階段發(fā)詳細(xì)設(shè)計(jì)說(shuō)明書(shū)研發(fā)/維護(hù)人員設(shè)計(jì)階段類數(shù)據(jù)庫(kù)設(shè)計(jì)說(shuō)明書(shū)研發(fā)/維護(hù)人員設(shè)計(jì)階段模塊開(kāi)發(fā)卷宗管理/研發(fā)/維護(hù)人員實(shí)現(xiàn)、測(cè)試階段測(cè)試計(jì)劃研發(fā)人員需求分析、設(shè)計(jì)階段測(cè)試分析報(bào)告研發(fā)/維護(hù)人員測(cè)試階段管開(kāi)發(fā)進(jìn)度月報(bào)管理人員貫穿整個(gè)開(kāi)發(fā)過(guò)程理項(xiàng)目開(kāi)發(fā)總結(jié)管理人員測(cè)試階段類職責(zé)定義管理人員可行性研究與計(jì)劃階段進(jìn)度變更記錄管理人員隨時(shí)產(chǎn)用戶指南用戶需求分析、設(shè)計(jì)

4、、實(shí)現(xiàn)階段品操作手冊(cè)用戶設(shè)計(jì)、實(shí)現(xiàn)階段類信息廣告用戶測(cè)試階段2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范6文檔的分類（1）類型讀者時(shí)間可行性研究報(bào)告管理/研發(fā)人員文檔的分類（2）文件 階段可行性研究與計(jì)劃階段需求分析階段設(shè)計(jì)階段實(shí)現(xiàn)階段測(cè)試階段運(yùn)行與維護(hù)階段數(shù)據(jù)需求說(shuō)明書(shū)項(xiàng)目開(kāi)發(fā)計(jì)劃軟件需求說(shuō)明書(shū)數(shù)據(jù)需求說(shuō)明書(shū)測(cè)試計(jì)劃概要設(shè)計(jì)說(shuō)明書(shū)詳細(xì)設(shè)計(jì)說(shuō)明書(shū)數(shù)據(jù)庫(kù)設(shè)計(jì)說(shuō)明書(shū)模塊開(kāi)發(fā)卷宗用戶手冊(cè)操作手冊(cè)測(cè)試分析報(bào)告開(kāi)發(fā)進(jìn)度月報(bào)項(xiàng)目開(kāi)發(fā)總結(jié)2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范7文檔的分類（2）文件 階段可文檔的分類（3）2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范8開(kāi)發(fā)文檔可行性研究報(bào)告項(xiàng)

5、目開(kāi)發(fā)計(jì)劃模塊開(kāi)發(fā)卷宗測(cè)試分析報(bào)告需求規(guī)格說(shuō)明書(shū)功能規(guī)格說(shuō)明書(shū)概要設(shè)計(jì)說(shuō)明書(shū)詳細(xì)設(shè)計(jì)說(shuō)明書(shū)數(shù)據(jù)庫(kù)設(shè)計(jì)說(shuō)明書(shū)測(cè)試計(jì)劃文檔的分類（3）2022年9月4日軟件項(xiàng)目管理培訓(xùn)之三文文檔的分類（4）2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范9產(chǎn)品文檔用戶指南操作手冊(cè)用戶指南產(chǎn)品手冊(cè)文檔的分類（4）2022年9月4日軟件項(xiàng)目管理培訓(xùn)之三文文檔的分類（5）2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范10管理文檔開(kāi)發(fā)進(jìn)度月報(bào)項(xiàng)目開(kāi)發(fā)總結(jié)職責(zé)定義進(jìn)度變更記錄文檔的分類（5）2022年9月4日軟件項(xiàng)目管理培訓(xùn)之三文文檔的等級(jí)（1）確定文檔質(zhì)量等級(jí)根據(jù)項(xiàng)目資源、項(xiàng)目大小和風(fēng)險(xiǎn)確定每個(gè)文檔的格式及詳細(xì)程度文檔

6、格式和文檔內(nèi)容同樣重要必須保證文檔的質(zhì)量，文檔管理才有意義 2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范11文檔的等級(jí)（1）確定文檔質(zhì)量等級(jí)2022年9月4日軟件項(xiàng)目管文檔的等級(jí)（2）文檔按照質(zhì)量可劃分為四個(gè)等級(jí)：最低限度文檔（1級(jí)文檔）適合開(kāi)發(fā)工作量低于一個(gè)人月的開(kāi)發(fā)者自用程序包含程序清單、開(kāi)發(fā)記錄、測(cè)試數(shù)據(jù)和程序簡(jiǎn)介內(nèi)部文檔（2級(jí)文檔）適合于沒(méi)有與其他用戶共享資源的專用程序1級(jí)文檔內(nèi)容，加上足夠的注釋和說(shuō)明2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范12文檔的等級(jí)（2）文檔按照質(zhì)量可劃分為四個(gè)等級(jí)：2022年9月文檔的等級(jí)（3）文檔按照質(zhì)量可劃分為四個(gè)等級(jí)：工作文檔（3級(jí)文檔）適合

7、于由同一單位內(nèi)若干人聯(lián)合開(kāi)發(fā)的程序，或可被其他單位使用的程序正式文檔（4級(jí)文檔）適合那些要正式發(fā)行供普遍使用的軟件產(chǎn)品關(guān)鍵性程序或具有重復(fù)管理應(yīng)用性質(zhì)（如工資計(jì)算）的程序需要4級(jí)文檔2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范13文檔的等級(jí)（3）文檔按照質(zhì)量可劃分為四個(gè)等級(jí)：2022年9月內(nèi)容提要文檔的分類和等級(jí)文檔管理的原則和方法文檔示例與討論2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范14內(nèi)容提要2022年9月4日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范1文檔管理的基本原則完整性原則項(xiàng)目文檔集應(yīng)覆蓋軟件開(kāi)發(fā)的完整流程簡(jiǎn)潔性原則編寫(xiě)文檔不應(yīng)浪費(fèi)過(guò)多的時(shí)間和經(jīng)歷有效性原則文檔必須能夠起到輔助決策、

8、指導(dǎo)參考的作用延續(xù)性原則文檔的變化必須有合理依據(jù)，保持連續(xù)發(fā)展2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范15文檔管理的基本原則完整性原則2022年9月4日軟件項(xiàng)目管理培文檔管理的內(nèi)容建立文檔規(guī)范，培養(yǎng)良好習(xí)慣制定編寫(xiě)計(jì)劃，明確編寫(xiě)責(zé)任檢查文檔質(zhì)量，提高利用效率控制文檔范圍，保護(hù)知識(shí)產(chǎn)權(quán)實(shí)施版本控制，有效記錄歷史2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范16文檔管理的內(nèi)容建立文檔規(guī)范，培養(yǎng)良好習(xí)慣2022年9月4日軟文檔管理方法：如何命名？命名規(guī)范的重要性統(tǒng)一的對(duì)外形象（舉例）有效的文檔分類（舉例）快速的文檔查找（舉例）命名規(guī)則的制定并無(wú)統(tǒng)一規(guī)則，依據(jù)項(xiàng)目環(huán)境自定義技巧1：確定統(tǒng)一的

9、空白封面和項(xiàng)目名稱技巧2：同類型多個(gè)文檔的命名方法技巧3：文檔存儲(chǔ)和管理的方法2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范17文檔管理方法：如何命名？命名規(guī)范的重要性2022年9月4日軟文檔管理方法：如何保證內(nèi)容完整？?jī)?nèi)容殘缺的體現(xiàn)缺少項(xiàng)目背景和內(nèi)容目錄（舉例）缺少表格和示意圖（舉例）缺少對(duì)思想的闡述和問(wèn)題的分析（舉例）保證內(nèi)容完整的方法技巧1：提供統(tǒng)一的項(xiàng)目背景資料技巧2：培養(yǎng)一致的文檔編寫(xiě)習(xí)慣技巧3：明確要求表格和圖形的使用方式2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范18文檔管理方法：如何保證內(nèi)容完整？?jī)?nèi)容殘缺的體現(xiàn)2022年9月文檔管理方法：如何寫(xiě)好需求分析做好需求分析的前提

10、條件客戶應(yīng)用環(huán)境的了解市場(chǎng)主流與技術(shù)主流的了解客戶現(xiàn)有需求的總結(jié)和潛在需求的挖掘完成需求分析的過(guò)程第一步：項(xiàng)目建議書(shū)（Proposal） 第二步：市場(chǎng)與技術(shù)調(diào)研報(bào)告（M&T Report)第三步：需求變更風(fēng)險(xiǎn)分析第四步：需求分析初稿2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范19文檔管理方法：如何寫(xiě)好需求分析做好需求分析的前提條件2022文檔管理方法：如何寫(xiě)好概要設(shè)計(jì)做好概要設(shè)計(jì)的前提條件客戶需求細(xì)節(jié)的了解技術(shù)重點(diǎn)和難點(diǎn)的分析系統(tǒng)結(jié)構(gòu)的設(shè)計(jì)與劃分完成概要設(shè)計(jì)的過(guò)程第一步：功能描述（Function Description）第二步：功能定義（Function Specification）第三

11、步：重點(diǎn)難點(diǎn)問(wèn)題解決思路第四步：概要設(shè)計(jì)草案2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范20文檔管理方法：如何寫(xiě)好概要設(shè)計(jì)做好概要設(shè)計(jì)的前提條件2022文檔管理方法：如何寫(xiě)好詳細(xì)設(shè)計(jì)詳細(xì)設(shè)計(jì)的底線是什么？主要處理流程的詳細(xì)說(shuō)明對(duì)外接口的詳細(xì)說(shuō)明主要邏輯結(jié)構(gòu)和數(shù)據(jù)結(jié)構(gòu)的詳細(xì)說(shuō)明完成詳細(xì)設(shè)計(jì)的過(guò)程第一步：流程定義（Control Flow）第二步：數(shù)據(jù)結(jié)構(gòu)定義（Data Flow)第三步：接口定義（API Specification）第四步：詳細(xì)設(shè)計(jì)草案2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范21文檔管理方法：如何寫(xiě)好詳細(xì)設(shè)計(jì)詳細(xì)設(shè)計(jì)的底線是什么？2022文檔管理方法：如何寫(xiě)好里程碑報(bào)

12、告里程碑報(bào)告的內(nèi)容預(yù)期目標(biāo)的解釋和說(shuō)明已完成工作的說(shuō)明進(jìn)度情況、測(cè)試結(jié)果的分析和說(shuō)明下一步工作的重點(diǎn)和難點(diǎn)完成里程碑報(bào)告的過(guò)程第一步：分析前一個(gè)里程碑報(bào)告的內(nèi)容第二步：說(shuō)明當(dāng)前里程碑的主要進(jìn)展第三步：總結(jié)存在的問(wèn)題、困難和障礙第四步：列出下一個(gè)里程碑的主要工作計(jì)劃2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范22文檔管理方法：如何寫(xiě)好里程碑報(bào)告里程碑報(bào)告的內(nèi)容2022年9文檔管理方法：確定最小文檔集如何確定最小文檔集重要認(rèn)識(shí)：最小文檔集不是指最簡(jiǎn)單文檔集最重要、最必須的文檔組成最小文檔集如何實(shí)現(xiàn)最小文檔集人員分工：多人協(xié)作完成一份文檔文檔格式：提供統(tǒng)一易用的模板內(nèi)容組織：合并細(xì)節(jié)結(jié)構(gòu)，保持總

13、體完整2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范23文檔管理方法：確定最小文檔集如何確定最小文檔集2022年9月反思：為什么中國(guó)人不善于寫(xiě)文檔？文化背景的原因官修史與私修史：從孔子談起封建專制與思想禁錮：焚書(shū)坑儒和文字獄現(xiàn)代教育的原因缺乏方法教育和人格教育缺乏法律意識(shí)和嚴(yán)謹(jǐn)態(tài)度官本位、錢(qián)本位的價(jià)值觀2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范24反思：為什么中國(guó)人不善于寫(xiě)文檔？文化背景的原因2022年9月內(nèi)容提要文檔的分類和等級(jí)文檔管理的原則和方法文檔示例與討論2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范25內(nèi)容提要2022年9月4日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范2文檔編寫(xiě)技巧文檔排版方法問(wèn)題：你會(huì)用MS Word嗎？圖表制作方法問(wèn)題：你會(huì)用MS Visio和MS Excel嗎？文檔分類結(jié)構(gòu)問(wèn)題：如何設(shè)計(jì)良好的文件夾結(jié)構(gòu)？文檔命名方式問(wèn)題：如何對(duì)自己的項(xiàng)目進(jìn)行文檔命名？2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范26文檔編寫(xiě)技巧2022年9月4日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)文檔示例與討論需求分析文檔示例研發(fā)類項(xiàng)目概要設(shè)計(jì)與詳細(xì)設(shè)計(jì)示例應(yīng)用類項(xiàng)目概要設(shè)計(jì)與詳細(xì)設(shè)計(jì)示例數(shù)據(jù)庫(kù)與數(shù)據(jù)倉(cāng)庫(kù)類設(shè)計(jì)文檔示例測(cè)試計(jì)劃與測(cè)試案例類文檔示例工作日志、周工作報(bào)告、里程碑報(bào)告文檔示例2022年9月10日軟件項(xiàng)目管理培訓(xùn)之三文檔規(guī)范27文檔示例與討論2022年9