(完整word)產(chǎn)品開發(fā)項目及項目文檔管理規(guī)范

1、(完整word版)產(chǎn)品開發(fā)項目文檔管理規(guī)范(完整word版)產(chǎn)品開發(fā)項目文檔管理規(guī)范PAGE9(完整word版)產(chǎn)品開發(fā)項目文檔管理規(guī)范產(chǎn)品開發(fā)項目文檔管理規(guī)范文檔編號：COSHIP-CMMI-PRD-PDPDM密級：機密版本信息：批準日期：編輯軟件：Microsoft Word2003 Microsoft Visio 2003同洲電子股份有限公司 版權所有內部資料 注意保密文檔修訂記錄序號版本編號變化狀態(tài)變更（+/-）說明作者日期1C2004年2M根據(jù)實際情況進行優(yōu)化階段代號和文檔密級等王巖2007-11-93M根據(jù)評審意見進行修改王巖2007-11-20*變化狀態(tài)：C創(chuàng)建，A增加，M修改，

2、D刪除文檔審批信息版本過程改進組（EPG）審核會簽批 準備注目 錄TOC o 1-3 h z uHYPERLINK l _Toc91概述 PAGEREF _Toc9 h 1HYPERLINK l _Toc0目的 PAGEREF _Toc0 h 1HYPERLINK l _Toc1適用范圍 PAGEREF _Toc1 h 1HYPERLINK l _Toc22產(chǎn)品開發(fā)文檔體系 PAGEREF _Toc2 h 1HYPERLINK l _Toc33文檔質量的度量準則 PAGEREF _Toc3 h 3HYPERLINK l _Toc44主要角色和職責 PAGEREF _Toc4 h 3HYPERL

3、INK l _Toc5文檔作者 PAGEREF _Toc5 h 3HYPERLINK l _Toc6項目經(jīng)理 PAGEREF _Toc6 h 4HYPERLINK l _Toc7 PAGEREF _Toc7 h 4HYPERLINK l _Toc8配置管理工程師 PAGEREF _Toc8 h 4HYPERLINK l _Toc9評審組 PAGEREF _Toc9 h 4HYPERLINK l _Toc0部門經(jīng)理 PAGEREF _Toc0 h 4HYPERLINK l _Toc15文檔審核流程 PAGEREF _Toc1 h 5HYPERLINK l _Toc2審核流程 PAGEREF _T

4、oc2 h 5HYPERLINK l _Toc3歸檔簽名 PAGEREF _Toc3 h 6HYPERLINK l _Toc4納入基線 PAGEREF _Toc4 h 6HYPERLINK l _Toc56文檔保密制度 PAGEREF _Toc5 h 7HYPERLINK l _Toc67文檔編號 PAGEREF _Toc6 h 7HYPERLINK l _Toc7文檔編號規(guī)則 PAGEREF _Toc7 h 7HYPERLINK l _Toc8階段代號 PAGEREF _Toc8 h 8HYPERLINK l _Toc98文檔版本 PAGEREF _Toc9 h 9概述目的規(guī)范公司產(chǎn)品開發(fā)項

5、目的文檔體系，加強文檔的標準化管理。適用范圍公司內所有產(chǎn)品開發(fā)項目。產(chǎn)品開發(fā)文檔體系在產(chǎn)品開發(fā)項目開發(fā)過程中，各階段都有相應的文檔輸出，文檔的編寫應先于或同步于開發(fā)工作。產(chǎn)品開發(fā)項目過程中的文檔體系如表1所示。產(chǎn)品開發(fā)項目文檔體系序號文檔名稱文檔作者備注立項可行性研究報告項目經(jīng)理產(chǎn)品規(guī)格書項目經(jīng)理立項報告項目經(jīng)理需求系統(tǒng)需求規(guī)格說明書需求分析師軟件需求規(guī)格說明書軟件工程師硬件需求規(guī)格說明書硬件工程師結構需求表結構工程師電源需求規(guī)格說明書電源工程師需求管理矩陣項目經(jīng)理計劃系統(tǒng)總體設計說明書系統(tǒng)設計師項目計劃書項目經(jīng)理1質量保證計劃PPQA配置管理計劃配置管理工程師進度計劃項目經(jīng)理設計軟件概要設計

6、說明書軟件工程師結構概要設計說明書結構工程師硬件概要設計說明書硬件工程師實現(xiàn)軟件模塊詳細設計說明書軟件工程師單元測試計劃軟件工程師單元測試用例軟件工程師單元測試報告軟件工程師電路原理圖硬件工程師PCB設計圖PCB設計工程師結構圖紙結構工程師BOM硬件工程師研發(fā)BOM產(chǎn)品集成計劃項目經(jīng)理集成測試計劃項目經(jīng)理接口說明書軟件工程師集成測試用例軟件工程師集成測試報告軟件工程師驗證系統(tǒng)測試計劃測試工程師系統(tǒng)測試用例測試工程師產(chǎn)品缺陷列表測試工程師認證性測試報告測試工程師研發(fā)中心出具系統(tǒng)測試報告測試工程師發(fā)布驗證測試報告認證代表回歸測試報告測試工程師缺陷報告測試工程師用戶使用文檔技術資料工程師交付結項項目

7、總結報告項目經(jīng)理項目結項表單項目經(jīng)理系統(tǒng)測試報告測試工程師產(chǎn)品缺陷列表測試工程師文檔質量的度量準則評審文檔質量的度量準則有以下六條：完整性：所承擔產(chǎn)品開發(fā)任務的項目組，需按照公司文檔體系的規(guī)定編寫相應的文檔，以保證在項目結束時其文檔是齊全的。正確性：在項目各個階段所編寫的文檔的內容，必須真實的反映階段的工作且與該階段的需求相一致。文檔與所述的對象保持一致，必要時應進行實時的文檔版本升級?？勺x性：文檔應該表達清晰、邏輯條理分明、表現(xiàn)形式通用。簡明性：在項目各個階段所編寫的各種文檔的語言表達應該準確簡練。規(guī)范性：文檔的規(guī)范性是指采用當前最新的模板。其完整性及內容的充實程度應不低于模板的要求。可追溯

8、性：在項目各個階段所編寫的各種文檔應該具有良好的可追溯性。由于各開發(fā)階段編制的文檔與各階段完成的工作有著密切的關系，前后階段生成的文件，隨著開發(fā)工作的逐步擴展，具有一定的繼承關系。在一個項目各開發(fā)階段之間提供的文件必定存在著可追溯的關系。主要角色和職責文檔作者文檔作者包括公司內的項目組成員以及外協(xié)人員。文檔作者在文檔方面的主要工作為：在項目開發(fā)過程的各個階段中，按照規(guī)定及時地完成項目文檔的編寫工作，文檔作者有責任保證文檔編寫與開發(fā)同步。文檔作者不僅要審核文檔字面上有無錯漏，還要審核所陳述的技術內容是否精確，及表達方式上是否清晰易懂。文檔作者對文檔的正確性、可讀性和規(guī)范性全面負責。文檔作者保證所

9、編寫的文檔與所描述的對象保持很好的一致性，必要時及時更新文檔，便于以后維護工作和后續(xù)開發(fā)工作的開展。項目經(jīng)理項目經(jīng)理是控制文檔準確性的關鍵環(huán)節(jié)，項目經(jīng)理與文檔作者一起構成文檔正確性的直接責任人。項目經(jīng)理在文檔方面的主要工作為：項目經(jīng)理制定整個項目的文檔計劃（包含在項目計劃中），并督促落實文檔計劃的實施。負責對技術內容正確性的檢查并校對文檔內容與所述對象最新版本是否保持一致。定義項目文檔的密級。PPQAPPQA的主要工作為：對文檔作者提供的文檔進行編號。檢查項目各階段文檔計劃的執(zhí)行情況，確保文檔的三級審核制度得到執(zhí)行直至最后歸檔。對文檔進行規(guī)范性審查。根據(jù)文檔計劃，組織評審組對文檔進行評審。確認

10、項目經(jīng)理定義的文檔密級，并確保文檔的保密性得到有效控制。配置管理工程師將評審通過或是部門經(jīng)理審核通過的文檔納入基線管理，根據(jù)密級確認相應的權限。評審組對需要評審的文檔（可行性研究報告、項目計劃書、需求規(guī)格說明書、概要設計書等）的內容進行質量把關。部門經(jīng)理文檔作者所屬部門的部門經(jīng)理對不需評審的文檔進行最終審核。文檔審核流程對每一份文檔要求在納入基線前，從項目經(jīng)理、PPQA、部門經(jīng)理或評審組，進行三級審核，這樣，分別從文檔質量的完備性、正確性、可讀性、簡明性、規(guī)范性、可追溯性等方面進行分層把關，并最后簽字確認其文檔質量合格。產(chǎn)品開發(fā)項目的文檔管理層次結構如圖1所示：評審組部門經(jīng)理評審組部門經(jīng)理PP

11、QAPPQA項目經(jīng)理項目經(jīng)理文檔作者文檔作者圖1 文檔管理層次結構審核流程產(chǎn)品開發(fā)項目文檔在歸檔前均要經(jīng)過多級審核，各審核一般都對應到文檔封面的簽名。文檔的審核歸檔流程如圖2所示。圖2 文檔的審核流程歸檔簽名開發(fā)階段文檔在納入基線之前需要經(jīng)過三級審批，包括文檔作者在內共四級簽名：文檔作者：為文檔的主要思想提供者和寫作者。如果有多人參與，則記錄主要人員。項目經(jīng)理：為在立項評審時指定的項目負責人。審核：PPQA。批準：如果此文檔需評審，則批準人為評審組長；否則為文檔作者所屬部門的部門經(jīng)理。納入基線產(chǎn)品開發(fā)項目文檔在經(jīng)過三級審批通過后，由配置管理工程師納入基線進行管理。文檔保密制度為確保產(chǎn)品開發(fā)項目

12、文檔的安全性，防止技術資料的外泄以及維護公司的權益，對每種文檔還應劃定它們各自的保密級別。每份文檔的密級原則上根據(jù)其所含技術的保密要求以及產(chǎn)品進入市場的程度，由項目經(jīng)理負責指定。文檔是按照與開發(fā)同步的原則寫作，所以大多數(shù)文檔在第一次納入基線時，其密級一般為“機密”，然后隨著產(chǎn)品的逐漸成熟，其保密程度會逐漸放開，所以每份文檔的密級標志是動態(tài)的。納入基線后的文檔密級若需要改變，可由項目經(jīng)理提出申請，配置管理工程師責對文檔所在配置庫重新分配權限。文檔密級共分為四級：絕密：指只有極少數(shù)人可以查閱的文檔。如：核心技術的文檔、預研項目的文檔等。此類文檔應嚴格保密，配置庫權限一般只分配給研發(fā)領導指定人員，須

13、簽訂保密協(xié)議。機密：指只有項目組的人可以查閱的文檔。如：軟件概要設計說明書、硬件概要設計說明書等。對此類文檔，配置庫權限分配給項目組成員，其他人如需申請權限，需經(jīng)項目經(jīng)理批準。普通：指在公司范圍內開放的文檔。如：產(chǎn)品規(guī)格等。此類文檔可在公司范圍內進行傳閱。公開：指對外開放的文檔。如：產(chǎn)品說明書及相關宣傳資料等。對此類文檔不做權限控制。以上密級歸類僅供參考，各項目經(jīng)理應根據(jù)產(chǎn)品競爭策略需要等實際情況確定歸入哪個密級，做到在保密基礎上的資源共享。文檔編號文檔以產(chǎn)品和項目為單位進行劃分，對每篇文檔根據(jù)其所屬產(chǎn)品、項目和具體描述內容定義一個唯一的編號。文檔編號由PPQA分配。注：硬件原理圖、PCB圖、

14、結構圖紙、BOM等文件編碼不在此編號范圍內。文檔編號規(guī)則文檔編號由五部分組成，各部分由-分隔，其構成如下：產(chǎn)品型號_項目編號_階段代號_模塊代號 對文檔進行編號時，各組成部分最好都有對應的代號及含義。如果不需區(qū)分模塊，則以&代替模塊代號。其中：產(chǎn)品型號：一般對應于產(chǎn)品型號（外部型號）。項目編號：所開發(fā)產(chǎn)品的項目編號。階段代號：此文檔對應的項目階段代號，請參見。模塊代號：軟件功能模塊或硬件單板的縮寫。如：新華社項目設計階段的設計文檔MPE模塊概要設計書的文檔標號為：。階段代號階段代號由24位英文字母和一位“.”字符表示，構成如下：主階段代號.子階段代號12位 12位例如，“可行性研究報告”文檔對

15、應的階段編號為,“系統(tǒng)測試計劃”文檔對應的階段代號為。文檔各階段代號如表2所示。文檔階段代號項目階段文檔名稱主階段代號子階段代號立項可行性研究報告I(Initialization)F(Feasibility)產(chǎn)品規(guī)格說明書I(Initialization)S(Specification)立項報告I(Initialization)R(Report)需求系統(tǒng)需求規(guī)格說明書R(Requirement）S(System)軟件需求規(guī)格說明書R(Requirement）SW(Software)硬件需求規(guī)格說明書R(Requirement）HW(Hardware)結構需求表R(Requirement）ST(

16、Structure)電源需求規(guī)格說明書R(Requirement）P(Power)需求管理矩陣 R(Requirement）M(Management)計劃系統(tǒng)總體設計說明書P(Planning)SL(Solution)項目計劃書P(Planning)I(Integration)質量保證計劃P(Planning)QA(Quality Assurance)配置管理計劃P(Planning)CM(Configuration Management)進度計劃P(Planning)S(Schedule)設計軟件概要設計說明書PD(Preliminary Design)SW(Software)硬件概要設計說

17、明書PD(Preliminary Design)HW(Hardware)結構概要設計說明書PD(Preliminary Design)ST(Structure)實現(xiàn)軟件詳細設計說明書IM(Implementation)SW(Software)單元測試計劃書IM(Implementation)UP(Unit Testing Plan)單元測試用例IM(Implementation)UC(Unit Testing Case)單元測試報告IM(Implementation)UR(Unit TestingReport)產(chǎn)品集成計劃IM(Implementation)IP(IntegrationPlan

18、)集成測試計劃書IM(Implementation)TP(Testing Plan)接口說明書IM(Implementation)I(Interface)集成測試用例IM(Implementation)TC(Testing Case)集成測試報告IM(Implementation)TR(Testing Report)驗證系統(tǒng)測試計劃書V(Validation)TP(Testing Plan)系統(tǒng)測試用例V(Validation)TC(Testing Case)產(chǎn)品缺陷列表V(Validation)BL(Buglist)認證性測試報告V(Validation)AT(Authentication Testing)系統(tǒng)測試報告V(Validation)TR(Testing Report)發(fā)布驗證測試報告RL(Release)V(Validation)回歸測試報告RL(Release)TR(Regression Te