產(chǎn)品開(kāi)發(fā)文檔規(guī)范(I).doc

產(chǎn)品開(kāi)發(fā)項(xiàng)目文檔管理規(guī)范文檔編號(hào)：COSHIP-CMMI-PRD-PDPDM密級(jí)：機(jī)密版本信息：1.8批準(zhǔn)日期：編輯軟件：Microsoft Word 2003 Microsoft Visio 2003同洲電子股份有限公司 版權(quán)所有內(nèi)部資料 注意保密文檔修訂記錄序號(hào)版本編號(hào)變化狀態(tài)變更（+/-）說(shuō)明作者日期1V1.0C2004年2V1.5M根據(jù)實(shí)際情況進(jìn)行優(yōu)化階段代號(hào)和文檔密級(jí)等王巖2007-11-93V1.8M根據(jù)評(píng)審意見(jiàn)進(jìn)行修改王巖2007-11-20*變化狀態(tài)：C創(chuàng)建，A增加，M修改，D刪除文檔審批信息版本過(guò)程改進(jìn)組（EPG）審核會(huì)簽批 準(zhǔn)備 注目 錄1概述11.1目的11.2適用范圍12產(chǎn)品開(kāi)發(fā)文檔體系13文檔質(zhì)量的度量準(zhǔn)則34主要角色和職責(zé)34.1文檔作者34.2項(xiàng)目經(jīng)理44.3PPQA44.4配置管理工程師44.5評(píng)審組44.6部門(mén)經(jīng)理45文檔審核流程55.1審核流程55.2歸檔簽名65.3納入基線(xiàn)66文檔保密制度77文檔編號(hào)77.1文檔編號(hào)規(guī)則77.2階段代號(hào)88文檔版本91 概述1.1 目的規(guī)范公司產(chǎn)品開(kāi)發(fā)項(xiàng)目的文檔體系，加強(qiáng)文檔的標(biāo)準(zhǔn)化管理。1.2 適用范圍公司內(nèi)所有產(chǎn)品開(kāi)發(fā)項(xiàng)目。2 產(chǎn)品開(kāi)發(fā)文檔體系在產(chǎn)品開(kāi)發(fā)項(xiàng)目開(kāi)發(fā)過(guò)程中，各階段都有相應(yīng)的文檔輸出，文檔的編寫(xiě)應(yīng)先于或同步于開(kāi)發(fā)工作。產(chǎn)品開(kāi)發(fā)項(xiàng)目過(guò)程中的文檔體系如表1所示。表1. 產(chǎn)品開(kāi)發(fā)項(xiàng)目文檔體系序號(hào)文檔名稱(chēng)文檔作者備注立項(xiàng)1可行性研究報(bào)告項(xiàng)目經(jīng)理2產(chǎn)品規(guī)格書(shū)項(xiàng)目經(jīng)理3立項(xiàng)報(bào)告項(xiàng)目經(jīng)理需求4系統(tǒng)需求規(guī)格說(shuō)明書(shū)需求分析師5軟件需求規(guī)格說(shuō)明書(shū)軟件工程師6硬件需求規(guī)格說(shuō)明書(shū)硬件工程師7結(jié)構(gòu)需求表結(jié)構(gòu)工程師8電源需求規(guī)格說(shuō)明書(shū)電源工程師9需求管理矩陣項(xiàng)目經(jīng)理計(jì)劃10系統(tǒng)總體設(shè)計(jì)說(shuō)明書(shū)系統(tǒng)設(shè)計(jì)師11項(xiàng)目計(jì)劃書(shū)項(xiàng)目經(jīng)理12 1質(zhì)量保證計(jì)劃PPQA13配置管理計(jì)劃配置管理工程師14進(jìn)度計(jì)劃項(xiàng)目經(jīng)理設(shè)計(jì)15軟件概要設(shè)計(jì)說(shuō)明書(shū)軟件工程師16結(jié)構(gòu)概要設(shè)計(jì)說(shuō)明書(shū)結(jié)構(gòu)工程師17硬件概要設(shè)計(jì)說(shuō)明書(shū)硬件工程師實(shí)現(xiàn)18軟件模塊詳細(xì)設(shè)計(jì)說(shuō)明書(shū)軟件工程師19單元測(cè)試計(jì)劃軟件工程師20單元測(cè)試用例軟件工程師21單元測(cè)試報(bào)告軟件工程師22電路原理圖硬件工程師23PCB設(shè)計(jì)圖PCB設(shè)計(jì)工程師24結(jié)構(gòu)圖紙結(jié)構(gòu)工程師25BOM 硬件工程師研發(fā)BOM26產(chǎn)品集成計(jì)劃項(xiàng)目經(jīng)理27集成測(cè)試計(jì)劃項(xiàng)目經(jīng)理28接口說(shuō)明書(shū)軟件工程師29集成測(cè)試用例軟件工程師30集成測(cè)試報(bào)告軟件工程師驗(yàn)證31系統(tǒng)測(cè)試計(jì)劃測(cè)試工程師32系統(tǒng)測(cè)試用例測(cè)試工程師33產(chǎn)品缺陷列表測(cè)試工程師34認(rèn)證性測(cè)試報(bào)告測(cè)試工程師研發(fā)中心出具35系統(tǒng)測(cè)試報(bào)告測(cè)試工程師發(fā)布36驗(yàn)證測(cè)試報(bào)告認(rèn)證代表37回歸測(cè)試報(bào)告測(cè)試工程師38缺陷報(bào)告測(cè)試工程師39用戶(hù)使用文檔技術(shù)資料工程師交付結(jié)項(xiàng)40項(xiàng)目總結(jié)報(bào)告項(xiàng)目經(jīng)理41項(xiàng)目結(jié)項(xiàng)表單項(xiàng)目經(jīng)理42系統(tǒng)測(cè)試報(bào)告測(cè)試工程師43產(chǎn)品缺陷列表測(cè)試工程師3 文檔質(zhì)量的度量準(zhǔn)則評(píng)審文檔質(zhì)量的度量準(zhǔn)則有以下六條：完整性：所承擔(dān)產(chǎn)品開(kāi)發(fā)任務(wù)的項(xiàng)目組，需按照公司文檔體系的規(guī)定編寫(xiě)相應(yīng)的文檔，以保證在項(xiàng)目結(jié)束時(shí)其文檔是齊全的。正確性：在項(xiàng)目各個(gè)階段所編寫(xiě)的文檔的內(nèi)容，必須真實(shí)的反映階段的工作且與該階段的需求相一致。文檔與所述的對(duì)象保持一致，必要時(shí)應(yīng)進(jìn)行實(shí)時(shí)的文檔版本升級(jí)?？勺x性：文檔應(yīng)該表達(dá)清晰、邏輯條理分明、表現(xiàn)形式通用。簡(jiǎn)明性：在項(xiàng)目各個(gè)階段所編寫(xiě)的各種文檔的語(yǔ)言表達(dá)應(yīng)該準(zhǔn)確簡(jiǎn)練。規(guī)范性：文檔的規(guī)范性是指采用當(dāng)前最新的模板。其完整性及內(nèi)容的充實(shí)程度應(yīng)不低于模板的要求?？勺匪菪裕涸陧?xiàng)目各個(gè)階段所編寫(xiě)的各種文檔應(yīng)該具有良好的可追溯性。由于各開(kāi)發(fā)階段編制的文檔與各階段完成的工作有著密切的關(guān)系，前后階段生成的文件，隨著開(kāi)發(fā)工作的逐步擴(kuò)展，具有一定的繼承關(guān)系。在一個(gè)項(xiàng)目各開(kāi)發(fā)階段之間提供的文件必定存在著可追溯的關(guān)系。4 主要角色和職責(zé)4.1 文檔作者文檔作者包括公司內(nèi)的項(xiàng)目組成員以及外協(xié)人員。文檔作者在文檔方面的主要工作為：1） 在項(xiàng)目開(kāi)發(fā)過(guò)程的各個(gè)階段中，按照規(guī)定及時(shí)地完成項(xiàng)目文檔的編寫(xiě)工作，文檔作者有責(zé)任保證文檔編寫(xiě)與開(kāi)發(fā)同步。2） 文檔作者不僅要審核文檔字面上有無(wú)錯(cuò)漏，還要審核所陳述的技術(shù)內(nèi)容是否精確，及表達(dá)方式上是否清晰易懂。文檔作者對(duì)文檔的正確性、可讀性和規(guī)范性全面負(fù)責(zé)。3） 文檔作者保證所編寫(xiě)的文檔與所描述的對(duì)象保持很好的一致性，必要時(shí)及時(shí)更新文檔，便于以后維護(hù)工作和后續(xù)開(kāi)發(fā)工作的開(kāi)展。4.2 項(xiàng)目經(jīng)理項(xiàng)目經(jīng)理是控制文檔準(zhǔn)確性的關(guān)鍵環(huán)節(jié)，項(xiàng)目經(jīng)理與文檔作者一起構(gòu)成文檔正確性的直接責(zé)任人。項(xiàng)目經(jīng)理在文檔方面的主要工作為：1） 項(xiàng)目經(jīng)理制定整個(gè)項(xiàng)目的文檔計(jì)劃（包含在項(xiàng)目計(jì)劃中），并督促落實(shí)文檔計(jì)劃的實(shí)施。2） 負(fù)責(zé)對(duì)技術(shù)內(nèi)容正確性的檢查并校對(duì)文檔內(nèi)容與所述對(duì)象最新版本是否保持一致。3） 定義項(xiàng)目文檔的密級(jí)。4.3 PPQAPPQA的主要工作為：1） 對(duì)文檔作者提供的文檔進(jìn)行編號(hào)。2） 檢查項(xiàng)目各階段文檔計(jì)劃的執(zhí)行情況，確保文檔的三級(jí)審核制度得到執(zhí)行直至最后歸檔。3） 對(duì)文檔進(jìn)行規(guī)范性審查。4） 根據(jù)文檔計(jì)劃，組織評(píng)審組對(duì)文檔進(jìn)行評(píng)審。5） 確認(rèn)項(xiàng)目經(jīng)理定義的文檔密級(jí)，并確保文檔的保密性得到有效控制。4.4 配置管理工程師將評(píng)審?fù)ㄟ^(guò)或是部門(mén)經(jīng)理審核通過(guò)的文檔納入基線(xiàn)管理，根據(jù)密級(jí)確認(rèn)相應(yīng)的權(quán)限。4.5 評(píng)審組對(duì)需要評(píng)審的文檔（可行性研究報(bào)告、項(xiàng)目計(jì)劃書(shū)、需求規(guī)格說(shuō)明書(shū)、概要設(shè)計(jì)書(shū)等）的內(nèi)容進(jìn)行質(zhì)量把關(guān)。4.6 部門(mén)經(jīng)理文檔作者所屬部門(mén)的部門(mén)經(jīng)理對(duì)不需評(píng)審的文檔進(jìn)行最終審核。5 文檔審核流程對(duì)每一份文檔要求在納入基線(xiàn)前，從項(xiàng)目經(jīng)理、PPQA、部門(mén)經(jīng)理或評(píng)審組，進(jìn)行三級(jí)審核，這樣，分別從文檔質(zhì)量的完備性、正確性、可讀性、簡(jiǎn)明性、規(guī)范性、可追溯性等方面進(jìn)行分層把關(guān)，并最后簽字確認(rèn)其文檔質(zhì)量合格。產(chǎn)品開(kāi)發(fā)項(xiàng)目的文檔管理層次結(jié)構(gòu)如圖1所示：評(píng)審組部門(mén)經(jīng)理PPQA項(xiàng)目經(jīng)理文檔作者圖1 文檔管理層次結(jié)構(gòu)5.1 審核流程產(chǎn)品開(kāi)發(fā)項(xiàng)目文檔在歸檔前均要經(jīng)過(guò)多級(jí)審核，各審核一般都對(duì)應(yīng)到文檔封面的簽名。文檔的審核歸檔流程如圖2所示。圖2 文檔的審核流程5.2 歸檔簽名開(kāi)發(fā)階段文檔在納入基線(xiàn)之前需要經(jīng)過(guò)三級(jí)審批，包括文檔作者在內(nèi)共四級(jí)簽名： 文檔作者：為文檔的主要思想提供者和寫(xiě)作者。如果有多人參與，則記錄主要人員。 項(xiàng)目經(jīng)理：為在立項(xiàng)評(píng)審時(shí)指定的項(xiàng)目負(fù)責(zé)人。 審核：PPQA。 批準(zhǔn)：如果此文檔需評(píng)審，則批準(zhǔn)人為評(píng)審組長(zhǎng)；否則為文檔作者所屬部門(mén)的部門(mén)經(jīng)理。5.3 納入基線(xiàn)產(chǎn)品開(kāi)發(fā)項(xiàng)目文檔在經(jīng)過(guò)三級(jí)審批通過(guò)后，由配置管理工程師納入基線(xiàn)進(jìn)行管理。6 文檔保密制度為確保產(chǎn)品開(kāi)發(fā)項(xiàng)目文檔的安全性，防止技術(shù)資料的外泄以及維護(hù)公司的權(quán)益，對(duì)每種文檔還應(yīng)劃定它們各自的保密級(jí)別。每份文檔的密級(jí)原則上根據(jù)其所含技術(shù)的保密要求以及產(chǎn)品進(jìn)入市場(chǎng)的程度，由項(xiàng)目經(jīng)理負(fù)責(zé)指定。文檔是按照與開(kāi)發(fā)同步的原則寫(xiě)作，所以大多數(shù)文檔在第一次納入基線(xiàn)時(shí)，其密級(jí)一般為“機(jī)密”，然后隨著產(chǎn)品的逐漸成熟，其保密程度會(huì)逐漸放開(kāi)，所以每份文檔的密級(jí)標(biāo)志是動(dòng)態(tài)的。納入基線(xiàn)后的文檔密級(jí)若需要改變，可由項(xiàng)目經(jīng)理提出申請(qǐng)，配置管理工程師責(zé)對(duì)文檔所在配置庫(kù)重新分配權(quán)限。文檔密級(jí)共分為四級(jí)： 絕密：指只有極少數(shù)人可以查閱的文檔。如：核心技術(shù)的文檔、預(yù)研項(xiàng)目的文檔等。此類(lèi)文檔應(yīng)嚴(yán)格保密，配置庫(kù)權(quán)限一般只分配給研發(fā)領(lǐng)導(dǎo)指定人員，須簽訂保密協(xié)議。 機(jī)密：指只有項(xiàng)目組的人可以查閱的文檔。如：軟件概要設(shè)計(jì)說(shuō)明書(shū)、硬件概要設(shè)計(jì)說(shuō)明書(shū)等。對(duì)此類(lèi)文檔，配置庫(kù)權(quán)限分配給項(xiàng)目組成員，其他人如需申請(qǐng)權(quán)限，需經(jīng)項(xiàng)目經(jīng)理批準(zhǔn)。 普通：指在公司范圍內(nèi)開(kāi)放的文檔。如：產(chǎn)品規(guī)格等。此類(lèi)文檔可在公司范圍內(nèi)進(jìn)行傳閱。 公開(kāi)：指對(duì)外開(kāi)放的文檔。如：產(chǎn)品說(shuō)明書(shū)及相關(guān)宣傳資料等。對(duì)此類(lèi)文檔不做權(quán)限控制。以上密級(jí)歸類(lèi)僅供參考，各項(xiàng)目經(jīng)理應(yīng)根據(jù)產(chǎn)品競(jìng)爭(zhēng)策略需要等實(shí)際情況確定歸入哪個(gè)密級(jí)，做到在保密基礎(chǔ)上的資源共享。7 文檔編號(hào)文檔以產(chǎn)品和項(xiàng)目為單位進(jìn)行劃分，對(duì)每篇文檔根據(jù)其所屬產(chǎn)品、項(xiàng)目和具體描述內(nèi)容定義一個(gè)唯一的編號(hào)。文檔編號(hào)由PPQA分配。注：硬件原理圖、PCB圖、結(jié)構(gòu)圖紙、BOM等文件編碼不在此編號(hào)范圍內(nèi)。7.1 文檔編號(hào)規(guī)則文檔編號(hào)由五部分組成，各部分由-分隔，其構(gòu)成如下：產(chǎn)品型號(hào)_項(xiàng)目編號(hào)_階段代號(hào)_模塊代號(hào) 對(duì)文檔進(jìn)行編號(hào)時(shí)，各組成部分最好都有對(duì)應(yīng)的代號(hào)及含義。如果不需區(qū)分模塊，則以&代替模塊代號(hào)。其中： 產(chǎn)品型號(hào)：一般對(duì)應(yīng)于產(chǎn)品型號(hào)（外部型號(hào)）。 項(xiàng)目編號(hào)：所開(kāi)發(fā)產(chǎn)品的項(xiàng)目編號(hào)。 階段代號(hào)：此文檔對(duì)應(yīng)的項(xiàng)目階段代號(hào)，請(qǐng)參見(jiàn)7.2。 模塊代號(hào)：軟件功能模塊或硬件單板的縮寫(xiě)。如：新華社項(xiàng)目設(shè)計(jì)階段的設(shè)計(jì)文檔MPE模塊概要設(shè)計(jì)書(shū)的文檔標(biāo)號(hào)為：CDVB5110G_ DC-P071114-21_PD.SW_MPE。7.2 階段代號(hào)階段代號(hào)由24位英文字母和一位“.”字符表示，構(gòu)成如下：主階段代號(hào).子階段代號(hào) 12位 12位例如，“可行性研究報(bào)告”文檔對(duì)應(yīng)的階段編號(hào)為I.R,“系統(tǒng)測(cè)試計(jì)劃”文檔對(duì)應(yīng)的階段代號(hào)為SA.TP。文檔各階段代號(hào)如表2所示。表2. 文檔階段代號(hào)項(xiàng)目階段文檔名稱(chēng)主階段代號(hào)子階段代號(hào)立項(xiàng)可行性研究報(bào)告I(Initialization)F(Feasibility)產(chǎn)品規(guī)格說(shuō)明書(shū)I(Initialization)S(Specification)立項(xiàng)報(bào)告I(Initialization)R(Report)需求系統(tǒng)需求規(guī)格說(shuō)明書(shū)R(Requirement）S(System)軟件需求規(guī)格說(shuō)明書(shū)R(Requirement）SW(Software)硬件需求規(guī)格說(shuō)明書(shū)R(Requirement）HW(Hardware)結(jié)構(gòu)需求表R(Requirement）ST(Structure)電源需求規(guī)格說(shuō)明書(shū)R(Requirement）P(Power)需求管理矩陣 R(Requirement）M(Management)計(jì)劃系統(tǒng)總體設(shè)計(jì)說(shuō)明書(shū)P(Planning)SL(Solution)項(xiàng)目計(jì)劃書(shū)P(Planning)I(Integration)質(zhì)量保證計(jì)劃P(Planning)QA(Quality Assurance)配置管理計(jì)劃P(Planning)CM(Configuration Management)進(jìn)度計(jì)劃P(Planning)S(Schedule)設(shè)計(jì)軟件概要設(shè)計(jì)說(shuō)明書(shū)PD(Preliminary Design)SW(Software)硬件概要設(shè)計(jì)說(shuō)明書(shū)PD(Preliminary Design)HW(Hardware)結(jié)構(gòu)概要設(shè)計(jì)說(shuō)明書(shū)PD(Preliminary Design)ST(Structure)實(shí)現(xiàn)軟件詳細(xì)設(shè)計(jì)說(shuō)明書(shū)IM(Implementation)SW(Software)單元測(cè)試計(jì)劃書(shū)IM(Implementation)UP(Unit Testing Plan)單元測(cè)試用例IM(Implementation)UC(Unit Testing Case)單元測(cè)試報(bào)告IM(Implementation)UR(Unit Testing Report)產(chǎn)品集成計(jì)劃IM(Implementation)IP(Integration Plan)集成測(cè)試計(jì)劃書(shū)IM(Implementation)TP(Testing Plan)接口說(shuō)明書(shū)IM(Implementation)I(Interface)集成測(cè)試用例IM(Implementation)TC(Testing Case)集成測(cè)試報(bào)告IM(Implementation)TR(Testing Report)驗(yàn)證系統(tǒng)測(cè)試計(jì)劃書(shū)V(Validation)TP(Testing Plan)系統(tǒng)測(cè)試用例V(Validation)TC(Testing Case)產(chǎn)品缺陷列表V(Validation)BL(Buglist)認(rèn)證性測(cè)試報(bào)告V(Validation)AT(Authentication Testing) 系統(tǒng)測(cè)試報(bào)告V(Validation)TR(Testing Report)發(fā)布驗(yàn)證測(cè)試報(bào)告RL(Release)V(Validation)回歸測(cè)試報(bào)告RL(Release)TR (Regression Testing Report)缺陷報(bào)告RL(Release)BL(Bug