PRD产品开发项目文档管理规范.doc

PRD产品开发项目文档管理规范142020年4月19日文档仅供参考，不当之处，请联系改正。产品开发项目文档管理规范文档编号：COSHIP-CMMI-PRD-PDPDM密级：机密版本信息：1.8批准日期：编辑软件：Microsoft Word Microsoft Visio 同洲电子股份有限公司 版权所有内部资料 注意保密文档修订记录序号版本编号变化状态变更（+/-）说明作者日期1V1.0C 2V1.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-版本管理规范。