文件编写规范

1、密 级：内部公开文档编号：版 本 号： 分册名称：第 1 册/ 共 1 册文件编写规范xxx 科技有限公司编制：生效日期：审核：批 准：文件更改摘要日期版本号修订说明修订人审核人批准人目录1. 目的和范围 错误 !未定义书签2. 目标 错误 !未定义书签3. 术语表 错误 !未定义书签4. 文档编号规则 错误 !未定义书签5. 文档命名规范 错误 !未定义书签6. 文件结构规定 错误 !未定义书签7. 封面 错误 !未定义书签8. 修订页 错误 !未定义书签9. 正文内容格式 错误 !未定义书签10. 文件版本号和文件命名规定 . 错误 !未定义书签.文件版本号规定 错误 ! 未定义书签.文件

2、命名规定 错误 ! 未定义书签1. 目的和范围背景说明： 本文件作为公司内部文档管理文件，所有公司内编写的文档，均应遵 守本规定，作为公司的所有文档编写统一要求 。范围： 所有的 CMMI执行过程中产生的文档，均应当执行本文件要求作为基础的要 求，如果该部分的体系文件存在明确的要求的，按照体系文件要求执行，没有的则 按照本文件执行 。2. 目标 规范和统一公司管理体系中所有相关文件的风格和样式， 指导公司程序文件、 模版文件 以及各种记录文件的编写 。3. 术语表文件标识： 文件的属性标志，包括文件名称、文件编号、版本、生效日期、 审批状态、密级等。程序文件： 描述为完成管理体系中所有主要活动

3、提供方法和指导，分配具体的职责 和任务而定义的文件。模版文件： 为了使管理体系有效运行，组织统一设计的一些实用的表格和给出活动 结果的报告，规范记录组织的管理体系运行情况。记录文件： 简称记录，是组织根据设计的模版和体系要求，填写的表格或者给出活 动结果的报告，作为管理体系运行的证据。修订页： 记录文件的修订历史，所有程序文件、除了表格以外的模版和记录都需要 有变更履历，一般位于程序文件的第二页。文档密级 ：指本文档的保密程度，共分绝密、机密、秘密、内部公开、公开五级制 度。绝密 ：涉及公司与客户或上游供应商， 下游分销商所签订相关的文档资料。 仅限于公司最高管理层及各资料所涉及的经过相应管理

4、人员授权的相关人员查 阅。机密 ：公司内部所相关的规章制度及技术规范， 开发手册等； 还有各项目开发文档、管理文档及软件产品等仅供相关部门高级领导以及经过授权后相关人员查阅。秘密 ：需交付用户或与客户进行交流的文档与产品，可供相关项目客户查阅。内部公开 ： 内部不限制， 公司内部任何可以任何形式获得文档的信息并阅读、 保存、修改后自用等等，但是不允许向外传播的文件。公开 ：项目组开发过程中的自用文档或面向售前工作的部分项目介绍材料等。版本标识 ：作为文档的版本区分。所有发布版本之前不得大于，发布版本作为，而 其后只有重大修改可以调整小数点前的版本号，局部修改调整小数点后版本号，并 在修定记录表

5、中保留记录。4. 文档编号规则过程域与英文标识对应表： （ SSP：标准过程集）SSP过程类别SSP定义的过程域英文标识过程管理组织过程聚焦OPF组织过程定义OPD组织培训OT项目管理立项PIM集成项目管理IPM项目策划PP项目监督和控制PMC风险管理RSKM结项PCMSSP过程类别SSP定义的过程域英文标识采购SAM项目研发需求开发与管理RD系统设计编码SD产品集成PI测试TS评审TR产品发布PRDI产品实施PA项目实施与维护PAM过程支持配置管理CM过程和产品质量保证PPQA测量与分析MA决策分析和决定DAR文档类型与英文标识对应表：序号文档类型文档标识1过程Proc2规程、规范、指南Re

6、gu3模版、记录表格、工具Temp文档编号编写规则：规则XXXX-过程域标识 -文档类型标识 - 文档英文简称说明XXXX为 xxx 科技有限公司英文缩写。文档简称：为英文缩写。文档英文简称不可重复。举例组织过程定义过程 , 属于组织过程定义的过程文件， 过程域标识为 OPD， 文档类型标 识为 Proc ，简 称 OPDP，则 该过程 文档编号 为： XXXX OPD-Proc-OPDP,如有多个在后面加 -1 、-2 区别5. 文档命名规范公司所有项目及项目内所有技术文档应按照以下规范进行统一命名。、项目及项目编号的命名规范为（合同开发类项目、合同维护类项目）项目命名规则项目产品举例城市应

7、急救援指挥系统项目编号规则客户英文简称 （ 或汉语拼音简称 ）- 产品英文简称举例RFPreview说明客户英文简称 （或汉语拼音简称 ） 及产品英文简称应避免重名、项目文档的命名规范为：文档命名规则项目命名 - 过程模板文档名对可能重名的文档如项目周报， 命名如下：项目编号 - 过程模板文档名 - （文档编者）注：（文档编者）在不导致文档名称重复的情况下可以省略。举例RFPreview- 立项申请表文档编号规则项目编号 -过程域 - 英文编号对可能重复的文档编号，命名如下：项目编号号，如有多个在后面加 -1 、 -2 区别- 过程域 - 英文编举例RFPreview-PIM-IAPR说明项目

8、编号及标准文档模板编号应避免重名6. 文件结构规定所有记录中除表格之外的文件，在编制过程中应按照相关编制规范编写。文件通常包括：封面、修订页、目录、页眉、页脚和正文页码： 页码由第 1 章首页开始，显示在页脚，页脚左侧为公司全称, 右侧为页码 格式第 X 页 共 Y 页（ 其中 X,Y 均为阿拉伯 ）；页眉： 页眉内容为本文档的文件名称 +版本号 ；右侧对齐。页面设置： 除个别特殊需要以外，纸型设为纵向A4，页边距采用默认值（上下均为，左右均为） 。7. 封面 密 级： 文档编号：版 本 号： 分册名称：第 1 册/ 共 1 册文件名称xxx 科技有限公司编制：生效日期：审核：批准：8. 修订

9、页修订页内容建议包括：版本号、修改日期、作者（修改人） 、修订要点等，如下表所示， 可以根据实际情况添加内容。 注意， 在由模板文件生成实际组织或项目文件后， 修订页中的 原修订记录必须清除， 改为实际文件的修订记录。 修订页中的版本和作者要与封面的版本和 编制一致。日期版本号修订说明修订人审核人批准人9. 正文内容格式程序文件正文部分一般建议包含以下内容 ：1. 目的 /方针：目的：程序所控制的活动及控制目的；2. 范围 :程序所涉及的有关部门、活动、相关人员和产品。3. 术语表（可选）： 程序文件中的专用术语、缩略语等。4. 角色和职责： 规定负责实施该项程序的部门或人员及其责任和权限5.

10、 入口准则： 启动该程序需要满足的条件6. 输入： 作为该程序输入的工作产品7. 流程图8. 主要活动作活动的逻辑顺序写出开展该项活动的各个环节。一般应说明以下内容：规定应做的事情（ What）； 明确活动的实施者（ Who）； 规定活动的时间（ When）； 说明在何处实施（ Where）； 规定具体实施办法（ How）； 所采用的材料、设备、引用的文件等； 如何进行控制，应保留的记录； 例外特殊情况的处理方式等 。9. 输出： 作为该程序输出的工作产品10. 出口准则： 结束该程序需要满足的条件11. 引用文档： 涉及到的相关程序文件、模版文件以及其他技术或管理文件12. 使用模板10. 文件版本号和文件命名规定10.1. 文件版本号规定文件的版本号以 “”格式标识， A和 B均为数字， 其中A注释为结