第一講：研發(fā)項目需求說明書模板講解與案例分析 V1

研發(fā)項目需求、概設說明書模板講解與案例分析北京合眾偉奇科技有限公司設計部王亮（第一講）目錄CONTENTPART

ONEPART

TWOPART

THREEPART

FOUR項管過程需求模板編寫原則案例分析北京合眾偉奇科技有限公司PART

ONE項管過程北京合眾偉奇科技有限公司PARTONE項目管理的5個過程組(1)啟動過程組(2)規(guī)劃過程組(3)執(zhí)行過程組(4)控制過程組(5)收尾過程組需求調研，可行性研究，批準立項等需求分析，編寫需求說明書；做項目設計，制定進度計劃、資源計劃、項目預算等協(xié)調人力和其他資源，執(zhí)行計劃通過定期監(jiān)控和測量進度，確定與計劃存在的偏差，以便采取措施，并達成目標項目管理的五個過程組項目正式驗收，并有序結束此項目我PARTONE需求、設計過程的3個重要文檔用戶需求說明書

為了使用戶和軟件開發(fā)者雙方對該軟件的初始規(guī)定有一個共同的理解，使之成為整個開發(fā)工作的基礎。包含硬件、功能、性能、輸入輸出、接口需求、警示信息、保密安全、數(shù)據與數(shù)據庫、文檔和法規(guī)的要求等等。

也稱為“需求規(guī)格說明書”，是從業(yè)務規(guī)則講起的，細一點，偏向于軟件的概要設計。是從開發(fā)、測試的角度去講產品功能，里面要包含原型界面、業(yè)務接口、活動圖等。

是設計人員根據用戶交互過程和產品需求說明書來形成系統(tǒng)框架，其結果往往以反映交互控件布置、界面元素分組以及界面整體板式的頁面框架圖的形式來呈現(xiàn)。主要任務是把需求分析得到的系統(tǒng)擴展用例圖轉換為軟件結構和數(shù)據結構。產品需求說明書系統(tǒng)概要設計說明書PARTONE需求的重要性各方交流工具便于用戶、開發(fā)人員進行理解和交流。開發(fā)工作依據反映出用戶問題的結構，可以作為軟件開發(fā)工作的基礎和依據。驗收確認依據作為確認測試和驗收的依據。需要用戶簽字畫押，以備不測。重要過程檔案研發(fā)過程重要檔案。項目管理責任追溯、知識積累的依據需求的重要性準確、可靠的需求信息是產品開發(fā)、交付高質量產品的重要基石。PARTONE需求圖形化分析方法示例UML（UnifiedModelingLanguage）

又稱統(tǒng)一建模語言或標準建模語言，是始于1997年一個OMG標準，它是一個支持模型化和軟件系統(tǒng)開發(fā)的圖形化語言，為軟件開發(fā)的所有階段提供模型化和可視化支持，包括由需求分析到規(guī)格，到構造和配置。面向對象的分析與設計(OOA&D，OOAD)方法的發(fā)展在80年代末至90年代中出現(xiàn)了一個高潮，UML是這個高潮的產物。它不僅統(tǒng)一了Booch、Rumbaugh和Jacobson的表示方法，而且對其作了進一步的發(fā)展，并最終統(tǒng)一為大眾所接受的標準建模語言。用例圖示例：PARTONE需求圖形化分析方法示例UML（UnifiedModelingLanguage）

又稱統(tǒng)一建模語言或標準建模語言，是始于1997年一個OMG標準，它是一個支持模型化和軟件系統(tǒng)開發(fā)的圖形化語言，為軟件開發(fā)的所有階段提供模型化和可視化支持，包括由需求分析到規(guī)格，到構造和配置。面向對象的分析與設計(OOA&D，OOAD)方法的發(fā)展在80年代末至90年代中出現(xiàn)了一個高潮，UML是這個高潮的產物。它不僅統(tǒng)一了Booch、Rumbaugh和Jacobson的表示方法，而且對其作了進一步的發(fā)展，并最終統(tǒng)一為大眾所接受的標準建模語言。用例圖示例：PARTONE需求圖形化分析方法示例UML（UnifiedModelingLanguage）用例圖主要的作用有三個：（1）獲取需求；（2）指導測試；（3）還可在整個過程中的其它工作流起到指導作用。用例圖示例：PARTONE需求圖形化分析方法示例UML（UnifiedModelingLanguage）時序圖示例：PARTTWO需求模板北京合眾偉奇科技有限公司PARTTWO用戶需求與產品需求的區(qū)別用戶需求說明書

是根據與現(xiàn)場實際客戶進行溝通，把客戶的需求進行整理，重點是站在客戶的角度講產品功能。用戶需求說明書

用戶需求說明書是用戶的需求，需要和用戶確認，并讓用戶簽字畫押。是對外的，給用戶看的。用戶需求說明書

主要包含：硬件、功能、性能、輸入輸出、接口需求、警示信息、保密安全、數(shù)據與數(shù)據庫、文檔和法規(guī)的要求等。產品需求說明書

是從業(yè)務規(guī)則講起的，細一點偏向于軟件的概要設計。是從開發(fā)、測試的角度去講產品功能。產品需求說明書

主要包含功能模塊、功能點、業(yè)務接口、活動圖等。是對內的，給設計人員、開發(fā)人員看的。用戶需求：對外；基于用戶需求調查表進行結構化分析、整理產品需求：對內，基于用戶需求說明書進行系統(tǒng)化分析、整理PARTTWO填寫需求說明書模板的思路（口訣）適用于：用戶需求說明書、產品需求說明書。用戶需求說明書中叫“綜述”；產品需求說明書中叫“概述”。開篇都是先綜述適用于：用戶需求說明書。用戶需求說明書中“總體結構圖”分兩部分，第一部分：繪制業(yè)務類總體結構圖（業(yè)務框圖）；第二部分：繪制“業(yè)務框圖”對應的“總體流程圖”總體結構分兩步適用于：用戶需求說明書?！皹I(yè)務及崗位對照表”章節(jié)，業(yè)務編號（4層）規(guī)則：BM01【業(yè)務類】、BM01_01【業(yè)務子類】、BM01_01_01【業(yè)務項】、BM01_01_01_01【業(yè)務子項】。業(yè)務崗位要分明適用于：用戶需求說明書、產品需求說明書、概要設計說明書。基于前述“業(yè)務編號規(guī)則”，功能明細使用其中的前三層編號，即，【業(yè)務類】、【業(yè)務子類】、【業(yè)務項】。功能明細含三層適用于：產品需求說明書。章節(jié)4業(yè)務項與功能項對照表，其中填寫“產品需求說明書功能項”與“用戶需求說明書業(yè)務項”的對應關系；章節(jié)5功能項、功能子項一覽表，其中填寫“產品需求說明書功能項”編號明細。功能項編號分三層：【功能域】、【功能項】、【功能子項】。業(yè)務/功能勤對照適用于：用戶需求說明書、產品需求說明書。編寫用戶需求說明書、產品需求說明書時，如果有相關參考文檔、數(shù)據等內容，可以放到“附錄”章節(jié)中詳細說明。猶有未盡附錄表123456PARTTWO需求說明書繪圖預備知識PARTTWO概要設計說明書文檔結構重點注意事項：模板中的文檔結構不允許隨意刪除。如需修改，先上報到部門，經部門評審通過后，由部門反饋到質管部統(tǒng)一更新、維護、發(fā)布文檔模板PARTTWO用戶需求說明書模板結構介紹總體結構圖總體業(yè)務過程用戶需求文檔結構總體結構分兩步PARTTWO用戶需求說明書模板結構介紹用戶需求文檔結構業(yè)務類業(yè)務子類業(yè)務項業(yè)務子項崗位BM01/臺區(qū)電子化驗收閉環(huán)管理BM01_01/電子化驗收BM01_01_01/高壓新裝驗收BM01_01_01_01/現(xiàn)場安裝調試驗收現(xiàn)場作業(yè)人員BM01_01_01_02/費控裝置跳閘試驗BM01_01_01_03/費控參數(shù)設置檢查BM01_01_01_04/電量下發(fā)信息檢查BM01_01_02/低壓批量驗收

現(xiàn)場作業(yè)人員BM01_01_03/低壓新裝驗收BM01_01_03_01/現(xiàn)場安裝驗收現(xiàn)場作業(yè)人員BM01_01_03_02/費控裝置跳閘試驗BM01_01_03_03/現(xiàn)場聯(lián)調BM01_02/驗收業(yè)務支撐BM01_02_01/臺區(qū)驗收工單管理

后臺管理員BM01_02_02/驗收臺賬信息管理

后臺管理員BM01_02_03/檢查單信息管理

后臺管理員業(yè)務崗位要分明PARTTWO用戶需求說明書模板結構介紹用戶需求文檔結構填寫后的效果功能明細含三層PARTTWO用戶需求說明書模板結構介紹用戶需求文檔結構崗位崗位描述現(xiàn)場作業(yè)人員1、接收臺區(qū)驗收工單。2、執(zhí)行臺區(qū)現(xiàn)場驗收。3、收集驗收臺賬信息。后臺管理員1、生成臺區(qū)驗收工單。2、檢查驗收流程前置資料是否完備（技術資料審查）。3、管理驗收流程中的“檢查單信息”。4、給“現(xiàn)場作業(yè)人員”派發(fā)臺區(qū)驗收工單。XX供電公司供電專用發(fā)票存根聯(lián)戶號：

計費年月：

客戶名稱劉維軍開戶銀行

地址桃源小區(qū)＃25東三單元三層東帳號

項目名稱計量單位數(shù)量單價金額本次應收

36.36上次余額

0.20本次余額0.44電費電費違約金kWh680.5235.361.00合計(大寫)人民幣

備注:上月底度：936本月底度：1004拆尾電量：0填票人:

收款人:

填票日期：崗位一覽表示例表卡單據示例猶有未盡附錄表PARTTWO產品需求說明書模板結構介紹產品需求文檔結構總體結構圖PARTTWO產品需求說明書模板結構介紹產品需求文檔結構業(yè)務類業(yè)務子類業(yè)務項功能項/功能子項/主題BM01/臺區(qū)電子化驗收閉環(huán)管理BM01_01/電子化驗收BM01_01_01/高壓新裝驗收F01_01/生成工單F01_02/技術資料審查F01_03/派發(fā)工單F01_04/現(xiàn)場安裝調試驗收F01_05/現(xiàn)場費控信息收集（錄入，高壓新裝臺賬）F01_06/業(yè)擴送電申請F01_07/閉環(huán)驗收歸檔（手動/自動）F01_08/費控裝置跳閘試驗F01_09/費控參數(shù)設置檢查F01_10/電量下發(fā)檢查F01_11/采集系統(tǒng)校核（手動/自動）BM01_01_02/低壓批量驗收F02_01/生成工單F02_02/派發(fā)工單F02_03/現(xiàn)場抽樣初檢F02_04/現(xiàn)場信息核查（復檢）F02_05/閉環(huán)驗收歸檔（手動/自動）BM01_01_03/低壓新裝驗收F03_01/生成工單F03_02/技術資料核查F03_03/派發(fā)工單F03_04/現(xiàn)場設備安裝F03_05/現(xiàn)場設備安裝證據上傳F03_06/現(xiàn)場安裝驗收F03_07/計量采集設備信息收集（錄入，低壓新裝臺賬）F03_08/新裝方案信息歸檔（手動/自動）F03_09/業(yè)擴送電申請F03_10/閉環(huán)驗收歸檔（手動/自動）F03_11/費控裝置跳閘試驗F03_12/表計無負荷/有負荷示數(shù)檢查F03_13/現(xiàn)場聯(lián)調F03_14/采集系統(tǒng)校核（手動/自動）BM01_02/驗收業(yè)務支撐BM01_02_01/臺區(qū)驗收工單管理F04_01/臺區(qū)驗收工單管理BM01_02_02/驗收臺賬信息管理F04_02/驗收臺賬信息管理BM01_02_03/檢查單信息管理F04_03/檢查單信息管理業(yè)務/功能勤對照PARTTWO產品需求說明書模板結構介紹產品需求文檔結構功能域功能項功能子項描述F01/臺區(qū)高壓新裝驗收F01_01/生成工單

生成工單F01_02/技術資料審查

審核高壓新裝驗收前置條件（資料）F01_03/派發(fā)工單

派發(fā)工單到相關現(xiàn)場作業(yè)人員F01_04/現(xiàn)場安裝調試驗收

現(xiàn)場作業(yè)人員安裝設備并調試檢查F01_05/現(xiàn)場費控信息收集

現(xiàn)場費控信息錄入并上傳到閉環(huán)后臺F01_06/業(yè)擴送電申請

聯(lián)系營銷業(yè)擴部門，給現(xiàn)場送電F01_07/閉環(huán)驗收歸檔

現(xiàn)場送電前的驗收信息歸檔，上傳到閉環(huán)后臺F01_08/費控裝置跳閘試驗

現(xiàn)場設備加電狀態(tài)下，進行費控裝置：遠程、本地控制跳閘試驗F01_09/費控參數(shù)設置檢查

現(xiàn)場設備家電狀態(tài)下檢查費控參數(shù)設置F01_10/電量下發(fā)檢查

現(xiàn)場設備家電狀態(tài)下檢查電量下發(fā)數(shù)據F01_11/采集系統(tǒng)校核

送電后驗收完成之后，進行采集檔案信息與現(xiàn)場信息校核F02/臺區(qū)低壓批量新裝驗收F02_01/生成工單

生成工單F02_02/派發(fā)工單

派發(fā)工單F02_03/現(xiàn)場抽樣初檢

現(xiàn)場抽樣初檢F02_04/現(xiàn)場信息核查（復檢）

現(xiàn)場信息核查F02_05/閉環(huán)驗收歸檔

現(xiàn)場驗收信息歸檔，上傳到閉環(huán)后臺F03/臺區(qū)低壓新裝驗收F03_01/生成工單

F03_02/技術資料核查

F03_03/派發(fā)工單

F03_04/現(xiàn)場設備安裝

F03_05/現(xiàn)場設備安裝證據上傳

F03_06/現(xiàn)場安裝驗收

F03_07/計量采集設備信息收集

F03_08/新裝方案信息歸檔

F03_09/業(yè)擴送電申請

F03_10/閉環(huán)驗收歸檔

F03_11/費控裝置跳閘試驗

F03_12/表計無/有負荷示數(shù)檢查

F03_13/現(xiàn)場聯(lián)調

F03_14/采集系統(tǒng)校核

F04/臺區(qū)電子化驗收系統(tǒng)支撐F04_01/臺區(qū)驗收工單管理F04_01_01/臺區(qū)驗收工單信息管理

F04_01_02/臺區(qū)驗收工單流轉信息管理F04_02/驗收臺賬管理F04_02_01/現(xiàn)場費控信息管理

F04_02_02/低壓新裝設備信息管理F04_03/檢查單管理F04_03_01/檢查單信息管理

F04_03_02/檢查項信息管理F04_03_02/檢查項參數(shù)管理不太合適的功能劃分PARTTWO產品需求說明書模板結構介紹產品需求文檔結構填寫后的效果不太合適的功能劃分PARTTWO產品需求說明書模板結構介紹產品需求文檔結構功能域功能項功能子項描述F01/臺區(qū)電子化驗收F01_01/臺區(qū)高壓新裝驗收F01_01_01/生成工單生成工單F01_01_02/技術資料審查審核高壓新裝驗收前置條件（資料）F01_01_03/派發(fā)工單派發(fā)工單到相關現(xiàn)場作業(yè)人員F01_01_04/現(xiàn)場安裝調試驗收現(xiàn)場作業(yè)人員安裝設備并調試檢查F01_01_05/現(xiàn)場費控信息收集現(xiàn)場費控信息錄入并上傳到閉環(huán)后臺F01_01_06/業(yè)擴送電申請聯(lián)系營銷業(yè)擴部門，給現(xiàn)場送電F01_01_07/閉環(huán)驗收歸檔現(xiàn)場送電前的驗收信息歸檔，上傳到閉環(huán)后臺F01_01_08/費控裝置跳閘試驗現(xiàn)場設備加電狀態(tài)下，進行費控裝置：遠程、本地控制跳閘試驗F01_01_09/費控參數(shù)設置檢查現(xiàn)場設備家電狀態(tài)下檢查費控參數(shù)設置F01_01_10/電量下發(fā)檢查現(xiàn)場設備家電狀態(tài)下檢查電量下發(fā)數(shù)據F01_01_11/采集系統(tǒng)校核送電后驗收完成之后，進行采集檔案信息與現(xiàn)場信息校核F01_02/臺區(qū)低壓批量新裝驗收F01_02_01/生成工單生成工單F01_02_02/派發(fā)工單派發(fā)工單F01_02_03/現(xiàn)場抽樣初檢現(xiàn)場抽樣初檢F01_02_04/現(xiàn)場信息核查（復檢）現(xiàn)場信息核查F01_02_05/閉環(huán)驗收歸檔現(xiàn)場驗收信息歸檔，上傳到閉環(huán)后臺F01_03/臺區(qū)低壓新裝驗收F01_03_01/生成工單

F01_03_02/技術資料核查

F01_03_03/派發(fā)工單

F01_03_04/現(xiàn)場設備安裝

F01_03_05/現(xiàn)場設備安裝證據上傳

F01_03_06/現(xiàn)場安裝驗收

F01_03_07/計量采集設備信息收集

F01_03_08/新裝方案信息歸檔

F01_03_09/業(yè)擴送電申請

F01_03_10/閉環(huán)驗收歸檔

F01_03_11/費控裝置跳閘試驗

F01_03_12/表計無/有負荷示數(shù)檢查

F01_03_13/現(xiàn)場聯(lián)調

F01_03_14/采集系統(tǒng)校核

F02/臺區(qū)電子化驗收系統(tǒng)支撐F02_01/臺區(qū)驗收工單管理F02_01_01/臺區(qū)驗收工單信息管理

F02_01_02/臺區(qū)驗收工單流轉信息管理F02_02/驗收臺賬管理F02_02_01/現(xiàn)場費控信息管理

F02_02_02/低壓新裝設備信息管理F02_03/檢查單管理F02_03_01/檢查單信息管理

F02_03_02/檢查項信息管理F02_03_02/檢查項參數(shù)管理合適的功能劃分PARTTWO產品需求說明書模板結構介紹產品需求文檔結構填寫后的效果合適的功能劃分PARTTWO產品需求說明書模板結構介紹產品需求文檔結構信息類內容信息分類單位分類售電均價波動/03_03_01_01_01供電單位、電費年月、用電類別、本期售電均價、上年同期售電均價、上月售電均價、售電均價同比、售電均價環(huán)比、偏差率、閥值。人工創(chuàng)建單位單戶售電均價波動匯總/03_03_01_01_02供電單位、電費年月、用電類別、異常用戶數(shù)、總用戶數(shù)。數(shù)據類索引示例XX供電公司供電專用發(fā)票存根聯(lián)戶號：

計費年月：

客戶名稱劉維軍開戶銀行

地址桃源小區(qū)＃25東三單元三層東帳號

項目名稱計量單位數(shù)量單價金額本次應收

36.36上次余額

0.20本次余額0.44電費電費違約金kWh680.5235.361.00合計(大寫)人民幣

備注:上月底度：936本月底度：1004拆尾電量：0填票人:

收款人:

填票日期：表卡單據示例猶有未盡附錄表PART

THREE編寫原則北京合眾偉奇科技有限公司PARTTHREE編寫需求文檔的注意事項注意事項定義業(yè)務項的粒度合理的控制業(yè)務項定義的粒度大小。圖形的繪制規(guī)范現(xiàn)行模板中通用圖形繪制的一些要求。業(yè)務(功能)項的層次關于現(xiàn)行模板業(yè)務（功能）項分層問題。用戶、產品需求區(qū)別分辨清楚用戶、產品需求，有助于更好的劃分、定義業(yè)務項的粒度。PARTTHREE定義業(yè)務項的粒度控制用例總體數(shù)量一般來說，一個相當復雜的系統(tǒng)的用例數(shù)量可能在30-50個之間，如果一個系統(tǒng)的用例數(shù)量大大超過了這一范圍，那就該看看是不是陷入了功能分解的誤區(qū)。高內聚低耦合用例是被從現(xiàn)實的場景中抽象出來的。如果這些場景有緊密的聯(lián)系（高內聚），那用用例技術來組織它們則可以復用這些場景中的步驟描述，從而達到事倍功半的效果。多寫幾稿試試根據需求調研結果，多寫幾稿，看看是不是符合高內聚、低耦合的原則，實際上在寫用例的過程中，用例模型往往是需要不斷進行調整的。避免功能分解陷阱功能分解是正確使用用例技術的最大敵人，很多用例粒度的討論其實都是功能分解的思想在作怪。定義業(yè)務項的粒度PARTTHREE業(yè)務(功能)項的層次BM01/臺區(qū)電子化驗收閉環(huán)管理BM01_01_03/低壓新裝驗收BM01_01/電子化驗收BM01_02/驗收業(yè)務支撐BM01_01_02/低壓批量驗收BM01_01_01/高壓新裝驗收BM01_02_02/驗收臺賬信息管理BM01_02_01/臺區(qū)驗收工單管理【編寫內容】以表格形式列出系統(tǒng)的業(yè)務項、業(yè)務子項以及對應的崗位。【描述方法】其中編號規(guī)則如下：業(yè)務類：BM<2位順序號>業(yè)務子類：<業(yè)務類編號>_<2位順序號>業(yè)務項：<業(yè)務子類編號>_<2位順序號>業(yè)務子項：<業(yè)務項編號>_<2位順序號>。用戶需求說明書模板業(yè)務項層次（最多4層）BM01_02_03/檢查單信息管理BM01_01_01_03/費控參數(shù)設置檢查BM01_01_01_02/費控裝置跳閘試驗BM01_01_01_01/現(xiàn)場安裝調試驗收BM01_01_01_04/電量下發(fā)信息檢查PARTTHREE業(yè)務(功能)項的層次F02/臺區(qū)低壓批量新裝驗收F02_04/現(xiàn)場信息核查（復檢）F02_01/生成工單F02_05/閉環(huán)驗收歸檔F02_03/現(xiàn)場抽樣初檢F02_02/派發(fā)工單F02_04_02/計量設備編號核查F02_04_01/供用電方案核查需求規(guī)格中功能項編號：功能域：“F××”（2位業(yè)務類順序號）功能項：功能域編號+“_”+“××”（2位順序號）功能子項：功能項編號+“_”+“××”（2位順序號）產品需求說明書模板業(yè)務項層次（最多3層）F02_04_03/用電戶信息核查PARTTHREE圖形的繪制規(guī)范PARTTHREE圖形的繪制規(guī)范文稿使用特殊符號約定：〖〗業(yè)務