PRD产品开发综合项目文档管理标准规范.doc

产品开发项目文档管理规范文档编号：COSHIP-CMMI-PRD-PDPDM密级：机密版本信息：1.8同意日期：编辑软件：Microsoft Word Microsoft Visio 同洲电子股份 版权全部内部资料 注意保密文档修订统计序号版本编号改变状态变更（+/-）说明作者日期1V1.0C2V1.5M依据实际情况进行优化阶段代号和文档密级等王岩-11-93V1.8M依据评审意见进行修改王岩-11-20*改变状态：C创建，A增加，M修改，D删除文档审批信息版本过程改善组（EPG）审核会签批 准备 注目 录1概述11.1目标11.2适用范围12产品开发文档体系13文档质量度量准则34关键角色和职责34.1文档作者34.2项目经理44.3PPQA44.4配置管理工程师44.5评审组44.6部门经理45文档审核步骤55.1审核步骤55.2归档署名65.3纳入基线66文档保密制度77文档编号77.1文档编号规则77.2阶段代号88文档版本91 概述1.1 目标规范企业产品开发项目标文档体系，加强文档标准化管理。1.2 适用范围企业内全部产品开发项目。2 产品开发文档体系在产品开发项目开发过程中，各阶段全部有对应文档输出，文档编写应先于或同时于开发工作。产品开发项目过程中文档体系如表1所表示。表1. 产品开发项目文档体系序号文档名称文档作者备注立项1可行性研究汇报项目经理2产品规格书项目经理3立项汇报项目经理需求4系统需求规格说明书需求分析师5软件需求规格说明书软件工程师6硬件需求规格说明书硬件工程师7结构需求表结构工程师8电源需求规格说明书电源工程师9需求管理矩阵项目经理计划10系统总体设计说明书系统设计师11项目计划书项目经理12 1质量确保计划PPQA13配置管理计划配置管理工程师14进度计划项目经理设计15软件概要设计说明书软件工程师16结构概要设计说明书结构工程师17硬件概要设计说明书硬件工程师实现18软件模块具体设计说明书软件工程师19单元测试计划软件工程师20单元测试用例软件工程师21单元测试汇报软件工程师22电路原理图硬件工程师23PCB设计图PCB设计工程师24结构图纸结构工程师25BOM 硬件工程师研发BOM26产品集成计划项目经理27集成测试计划项目经理28接口说明书软件工程师29集成测试用例软件工程师30集成测试汇报软件工程师验证31系统测试计划测试工程师32系统测试用例测试工程师33产品缺点列表测试工程师34认证性测试汇报测试工程师研发中心出具35系统测试汇报测试工程师公布36验证测试汇报认证代表37回归测试汇报测试工程师38缺点汇报测试工程师39用户使用文档技术资料工程师交付结项40项目总结汇报项目经理41项目结项表单项目经理42系统测试汇报测试工程师43产品缺点列表测试工程师3 文档质量度量准则评审文档质量度量准则有以下六条：完整性：所负担产品开发任务项目组，需根据企业文档体系要求编写对应文档，以确保在项目结束时其文档是齐全。正确性：在项目各个阶段所编写文档内容，必需真实反应阶段工作且和该阶段需求相一致。文档和所述对象保持一致，必需时应进行实时文档版本升级。可读性：文档应该表示清楚、逻辑条理分明、表现形式通用。简明性：在项目各个阶段所编写多种文档语言表示应该正确简练。规范性：文档规范性是指采取目前最新模板。其完整性及内容充实程度应不低于模板要求。可追溯性：在项目各个阶段所编写多种文档应该含有良好可追溯性。因为各开发阶段编制文档和各阶段完成工作有着亲密关系，前后阶段生成文件，伴随开发工作逐步扩展，含有一定继承关系。在一个项目各开发阶段之间提供文件肯定存在着可追溯关系。4 关键角色和职责4.1 文档作者文档作者包含企业内项目组组员和外协人员。文档作者在文档方面关键工作为：1） 在项目开发过程各个阶段中，根据要求立即地完成项目文档编写工作，文档作者有责任确保文档编写和开发同时。2） 文档作者不仅要审核文档字面上有没有错漏，还要审核所陈说技术内容是否正确，及表示方法上是否清楚易懂。文档作者对文档正确性、可读性和规范性全方面负责。3） 文档作者确保所编写文档和所描述对象保持很好一致性，必需时立即更新文档，便于以后维护工作和后续开发工作开展。4.2 项目经理项目经理是控制文档正确性关键步骤，项目经理和文档作者一起组成文档正确性直接责任人。项目经理在文档方面关键工作为：1） 项目经理制订整个项目标文档计划（包含在项目计划中），并督促落实文档计划实施。2） 负责对技术内容正确性检验并校对文档内容和所述对象最新版本是否保持一致。3） 定义项目文档密级。4.3 PPQAPPQA关键工作为：1） 对文档作者提供文档进行编号。2） 检验项目各阶段文档计划实施情况，确保文档三级审核制度得到实施直至最终归档。3） 对文档进行规范性审查。4） 依据文档计划，组织评审组对文档进行评审。5） 确定项目经理定义文档密级，并确保文档保密性得到有效控制。4.4 配置管理工程师将评审经过或是部门经理审核经过文档纳入基线管理，依据密级确定对应权限。4.5 评审组对需要评审文档（可行性研究汇报、项目计划书、需求规格说明书、概要设计书等）内容进行质量把关。4.6 部门经理文档作者所属部门部门经理对不需评审文档进行最终审核。5 文档审核步骤对每一份文档要求在纳入基线前，从项目经理、PPQA、部门经理或评审组，进行三级审核，这么，分别从文档质量完备性、正确性、可读性、简明性、规范性、可追溯性等方面进行分层把关，并最终签字确定其文档质量合格。产品开发项目标文档管理层次结构图1所表示：评审组部门经理PPQA项目经理文档作者图1 文档管理层次结构5.1 审核步骤产品开发项目文档在归档前均要经过多级审核，各审核通常全部对应到文档封面署名。文档审核归档步骤图2所表示。图2 文档审核步骤5.2 归档署名开发阶段文档在纳入基线之前需要经过三级审批，包含文档作者在内共四级署名： 文档作者：为文档关键思想提供者和写作者。假如有多人参与，则统计关键人员。 项目经理：为在立项评审时指定项目责任人。 审核：PPQA。 同意：假如此文档需评审，则同意人为评审组长；不然为文档作者所属部门部门经理。5.3 纳入基线产品开发项目文档在经过三级审批经过后，由配置管理工程师纳入基线进行管理。6 文档保密制度为确保产品开发项目文档安全性，预防技术资料外泄和维护企业权益，对每种文档还应划定它们各自保密等级。每份文档密级标准上依据其所含技术保密要求和产品进入市场程度，由项目经理负责指定。文档是根据和开发同时标准写作，所以大多数文档在第一次纳入基线时，其密级通常为“机密”，然后伴随产品逐步成熟，其保密程度会逐步放开，所以每份文档密级标志是动态。纳入基线后文档密级若需要改变，可由项目经理提出申请，配置管理工程师责对文档所在配置库重新分配权限。文档密级共分为四级： 绝密：指只有极少数人能够查阅文档。如：关键技术文档、预研项目标文档等。这类文档应严格保密，配置库权限通常只分配给研发领导指定人员，须签署保密协议。 机密：指只有项目组人能够查阅文档。如：软件概要设计说明书、硬件概要设计说明书等。对这类文档，配置库权限分配给项目组组员，其它人如需申请权限，需经项目经理同意。 一般：指在企业范围内开放文档。如：产品规格等。这类文档可在企业范围内进行传阅。 公开：指对外开放文档。如：产品说明书及相关宣传资料等。对这类文档不做权限控制。以上密级归类仅供参考，各项目经理应依据产品竞争策略需要等实际情况确定归入哪个密级，做到在保密基础上资源共享。7 文档编号文档以产品和项目为单位进行划分，对每篇文档依据其所属产品、项目和具体描述内容定义一个唯一编号。文档编号由PPQA分配。注：硬件原理图、PCB图、结构图纸、BOM等文件编码不在此编号范围内。7.1 文档编号规则文档编号由五部分组成，各部分由-分隔，其组成以下：产品型号_项目编号_阶段代号_模块代号 对文档进行编号时，各组成部分最好全部有对应代号及含义。假如不需区分模块，则以&替换模块代号。其中： 产品型号：通常对应于产品型号（外部型号）。 项目编号：所开发产品项目编号。 阶段代号：此文档对应项目阶段代号，请参见7.2。 模块代号：软件功效模块或硬件单板缩写。如：新华社项目设计阶段设计文档MPE模块概要设计书文档标号为：CDVB5110G_ DC-P071114-21_PD.SW_MPE。7.2 阶段代号阶段代号由24位英文字母和一位“.”字符表示，组成以下：主阶段代号.子阶段代号 12位 12位比如，“可行性研究汇报”文档对应阶段编号为I.R,“系统测试计划”文档对应阶段代号为SA.TP。文档各阶段代号如表2所表示。表2. 文档阶段代号项目阶段文档名称主阶段代号子阶段代号立项可行性研究汇报I(Initialization)F(Feasibility)产品规格说明书I(Initialization)S(Specification)立项汇报I(Initialization)R(Report)需求系统需求规格说明书R(Requirement）S(System)软件需求规格说明书R(Requirement）SW(Software)硬件需求规格说明书R(Requirement）HW(Hardware)结构需求表R(Requirement）ST(Structure)电源需求规格说明书R(Requirement）P(Power)需求管理矩阵 R(Requirement）M(Management)计划系统总体设计说明书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)硬件概要设计说明书PD(Preliminary Design)HW(Hardware)结构概要设计说明书PD(Preliminary Design)ST(Structure)实现软件具体设计说明书IM(Implementation)SW(Software)单元测试计划书IM(Implementation)UP(Unit Testing Plan)单元测试用例IM(Implementation)UC(Unit Testing Case)单元测试汇报IM(Implementation)UR(Unit Testing Report)产品集成计划IM(Implementation)IP(Integration Plan)集成测试计划书IM(Implementation)TP(Testing Plan)接口说明书IM(Implementation)I(Interface)集成测试用例IM(Implementation)TC(Testing Case)集成测试汇报IM(Implementation)TR(Testing Report)验证系统测试计划书V(Validation)TP(Testing Plan)系统测试用例V(Validation)TC(Testing Case)产品缺点列表V(Validation)BL(Buglist)认证性测试汇报V(Validation)AT(Authentication Testing) 系统测试汇报V(Validation)TR(Testing Report)公布验证测试汇报RL(Release)V(Validation)回归测试汇报RL(Release)TR (Regression Testing Report)缺点汇报RL(Release)BL(Buglist)用户使用文档RL(Release)U(User)交付结项项目总结汇报PF（Project Finish）R(Report)项目结项表单PF（Project Finish）L（List）系统测试汇报PF（Project Finish）TR(Testing Report)产品缺点列表PF（Project Finish）BL(Buglist)8 文档版本版本编号由2位数字组成，以“.”来分割。 格式为：.主版本 副版本比如：V3.1表示：主版本为3，副版本为1，开发文档初始版本为V1.0。具体请参见PRD-版本管理规范。