文件编写规范.doc

密密 级级：内部公开：内部公开 文档文档编编号：号： 版版 本本 号：号：V1.0 分册名称：第分册名称：第 1 册册/共共 1 册册 文件文件编编写写规规范范 xxx 科技有限公司科技有限公司 编制： 生效日期： 审核： 批 准： _ 精品资料 文件更改摘要文件更改摘要 日期日期版本号版本号修修订说订说明明修修订订人人审审核人核人批准人批准人 _ 精品资料 目目 录录 1.目的和范目的和范围围.4 2.目目标标.4 3.术语术语表表.4 4.文档文档编编号号规则规则.5 5.文档命名文档命名规规范范.5 6.文件文件结结构构规规定定.6 7.封面封面.7 8.修修订页订页.8 9.正文内容格式正文内容格式.8 10.文件版本号和文件命名文件版本号和文件命名规规定定.9 10.1.文件版本号文件版本号规规定定.9 10.2.文件命名文件命名规规定定.9 _ 精品资料 1. 目的和范目的和范围围 背景背景说说明：明：本文件作为公司内部文档管理文件，所有公司内编写的文档，均应遵守 本规定，作为公司的所有文档编写统一要求。 范范围围： ：所有的 CMMI 执行过程中产生的文档，均应当执行本文件要求作为基础的要 求，如果该部分的体系文件存在明确的要求的，按照体系文件要求执行，没有的则 按照本文件执行。 2. 目目标标 规范和统一公司管理体系中所有相关文件的风格和样式，指导公司程序文件、模版文件 以及各种记录文件的编写。 3. 术语术语表表 文文件件标标识识： ：文件的属性标志，包括文件名称、文件编号、版本、生效日期、审批 状态、密级等。 程序文件：程序文件：描述为完成管理体系中所有主要活动提供方法和指导，分配具体的职责和 任务而定义的文件。 模版文件：模版文件：为了使管理体系有效运行，组织统一设计的一些实用的表格和给出活动结 果的报告，规范记录组织的管理体系运行情况。 记录记录文件：文件：简称记录，是组织根据设计的模版和体系要求，填写的表格或者给出活动 结果的报告，作为管理体系运行的证据。 修修订页订页： ：记录文件的修订历史，所有程序文件、除了表格以外的模版和记录都需要有 变更履历，一般位于程序文件的第二页。 文档密文档密级级：指本文档的保密程度，共分绝密、机密、秘密、内部公开、公开五级制度。 绝绝密密：涉及公司与客户或上游供应商，下游分销商所签订相关的文档资料。仅 限于公司最高管理层及各资料所涉及的经过相应管理人员授权的相关人员查 阅。 机密机密：公司内部所相关的规章制度及技术规范，开发手册等；还有各项目开发 文档、管理文档及软件产品等仅供相关部门高级领导以及经过授权后相关人 员查阅。 秘密秘密：需交付用户或与客户进行交流的文档与产品，可供相关项目客户查阅。 内部公开内部公开： 内部不限制，公司内部任何可以任何形式获得文档的信息并阅读、 保存、修改后自用等等，但是不允许向外传播的文件。 _ 精品资料 公开公开：项目组开发过程中的自用文档或面向售前工作的部分项目介绍材料等。 版本版本标识标识：作为文档的版本区分。所有发布版本之前不得大于 1.0，发布版本作为 1.0，而其后只有重大修改可以调整小数点前的版本号，局部修改调整小数点后版本 号，并在修定记录表中保留记录。 4. 文档文档编编号号规则规则 过程域与英文标识对应表：（SSP：标准过程集） SSP 过过程程类别类别SSP 定定义义的的过过程域程域英文英文标识标识 组织过程聚焦OPF 组织过程定义OPD 过程管理 组织培训OT 立项PIM 集成项目管理IPM 项目策划PP 项目监督和控制PMC 风险管理RSKM 结项 PCM 项目管理 采购SAM 需求开发与管理RD 系统设计编码SD 产品集成PI 测试 TS 评审 TR 产品发布PRDI 产品实施PA 项目研发 项目实施与维护PAM 配置管理CM 过程和产品质量保证PPQA 测量与分析MA 过程支持 决策分析和决定DAR 文档类型与英文标识对应表： 序号序号文档文档类类型型文档文档标识标识 1过程Proc 2规程、规范、指南Regu 3模版、记录表格、工具Temp 文档编号编写规则： 规则规则XXXX-过程域标识-文档类型标识-文档英文简称 说说明明XXXX 为 xxx 科技有限公司英文缩写。 文档简称：为英文缩写。 文档英文简称不可重复。 举举例例组织过程定义过程, 属于组织过程定义的过程文件，过程域标识为 OPD，文档类型标识为 Proc，简称 OPDP，则该过程文档编号为：XXXX _ 精品资料 OPD-Proc-OPDP,如有多个在后面加-1、-2 区别 5. 文档命名文档命名规规范范 公司所有项目及项目内所有技术文档应按照以下规范进行统一命名。 一、项目及项目编号的命名规范为（合同开发类项目、合同维护类项目）： 项目命名规则项目产品 举例城市应急救援指挥系统 项目编号规则客户英文简称(或汉语拼音简称)-产品英文简称 举例RFPreview 说明客户英文简称(或汉语拼音简称)及产品英文简称应避免重名 二、项目文档的命名规范为： 项目命名-过程模板文档名文档命名规则 对可能重名的文档如项目周报，命名如下：项目编号-过程模板 文档名-（文档编者） 注：（文档编者）在不导致文档名称重复的情况下可以省略。 举例RFPreview-立项申请表 项目编号-过程域-英文编号文档编号规则 对可能重复的文档编号，命名如下：项目编号-过程域-英文编号， 如有多个在后面加-1、-2 区别 举例RFPreview-PIM-IAPR 说明项目编号及标准文档模板编号应避免重名 6. 文件文件结结构构规规定定 所有记录中除表格之外的文件，在编制过程中应按照相关编制规范编写。文件通常包 括：封面、修订页、目录、页眉、页脚和正文。 页码页码： ：页码由第 1 章首页开始，显示在页脚，页脚左侧为公司全称,右侧为页码.格 式第 X 页 共 Y 页(其中 X,Y 均为阿拉伯)； 页页眉：眉：页眉内容为本文档的文件名称+版本号；右侧对齐。 页页面面设设置：置：除个别特殊需要以外，纸型设为纵向 A4，页边距采用默认值（上下均 为 2.54cm，左右均为 3.17cm）。 _ 精品资料 7. 封面封面 密密 级级： ： 文档文档编编号：号： 版版 本本 号：号：V1.0 分册名称：第分册名称：第 1 册册/共共 1 册册 文件名称文件名称 xxx 科技有限公司科技有限公司 编制： 生效日期： 审核： 批准： _ 精品资料 8. 修修订页订页 修订页内容建议包括：版本号、修改日期、作者（修改人）、修订要点等，如下表所示，可 以根据实际情况添加内容。注意，在由模板文件生成实际组织或项目文件后，修订页中的原 修订记录必须清除，改为实际文件的修订记录。修订页中的版本和作者要与封面的版本和编 制一致。 日期日期版本号版本号修修订说订说明明修修订订 人人 审审核核 人人 批准批准 人人 9. 正文内容格式正文内容格式 程序文件正文部分一般建议包含以下内容： 1.目的目的/方方针针： ： 目的：程序所控制的活动及控制目的； 2.范范围围:程序所涉及的有关部门、活动、相关人员和产品。 3.术语术语表（可表（可选选）：）：程序文件中的专用术语、缩略语等。 4.角色和角色和职责职责： ：规定负责实施该项程序的部门或人员及其责任和权限。 5.入口准入口准则则： ：启动该程序需要满足的条件 6.输输入：入：作为该程序输入的工作产品 7.流程流程图图 8.主要活主要活动动 作活动的逻辑顺序写出开展该项活动的各个环节。一般应说明以下内容： 规定应做的事情（What）； 明确活动的实施者（Who）； 规定活动的时间（When）； 说明在何处实施（Where）； 规定具体实施办法（How）； 所采用的材料、设备、引用的文件等； 如何进行控制，应保留的记录； _ 精品资料 例外特殊情况的处理方式等。 9.输输出：出：作为该程序输出的工作产品 10. 出口准出口准则则： ：结束该程序需要满足的条件 11. 引用文档：引用文档：涉及到的相关程序文件、模版文件以及其他技术或管理文件。 12. 使用模板使用模板 _ 精品资料 10.文件版本号和文件命名文件版本号和文件命名规规定定 10.1.文件版本号文件版本号规规定定 文件的版本号以“A.B”格式标识，A 和 B 均为数字，其中A注释为结构级修改；B 注 释为小范围修改。 10.2.文件命名文件命名规规定定 程序文件