项目文档命名规则及格式要求.doc

1、 项目文档命名规则编 制： 日期：_/_/_审 核： 日期：_/_/_批 准： 日期：_/_/_XXXX 公司二零一五年五月制XXXX 公司 命名规则第 2 页 共 10 页历史记录编号 章节名称 说明 修订日期 版本号 修订人 发布日期01 全文 新建 1.002 修订 章节 4.1 1.1XXXX 公司 命名规则第 3 页 共 10 页目 录1 目的 .42 适用范围 .43 术语和缩略词 .44 规程 .44.1 文档命名规则 .44.2 配置项的版本标识 .84.3 标签的命名 .9XXX 公司 命名规则第 4 页 共 10 页1 目的本文的目的是定义各项目所有相关文档和 CMM 要求

2、的过程文件的格式和规则，以及配置管理中对配置项和版本的标识。2 适用范围本规则适用于所有需求、设计等文档和过程文件。3 术语和缩略词无4 规程4.1 文档命名规则1 组织标准软件过程文档编号(1) 过程文件格式：XXX-P-，初始编号为：XXX-P-01，最大编号为：XXX-P-99。(2) 指南文件编号：XXX-G-，前两位为指南所对应的过程文件编号。(3) 模板文件编号：XXX-T-，前两位为指南所对应的过程文件编号。2 产品命名规范(1) 中文命名规范：中文全称 V 产品版本号。英文命名规范：首字母大写 V 产品版本号。3 项目文档编号(1) 编号规则分三种：1) 单个文档：首字母大写

3、V 产品版本号-阶段英文缩写-文档名称英文缩写。2) 多个子文档：首字母大写 V 产品版本号-阶段英文缩写-文档名称英文缩写流水号。3) 周期性：首字母大写 V 产品版本号-文档名称/英文名称-八位日期。(2) 项目阶段及文档名称英文缩写，见下表：阶段 序号 文档名称 英文及缩写1 产品调研任务书 PIA(Project Investigate Assignment)产品调研(PI) 2 产品调研计划 PIP(Project Investigate Plan)XXX 公司 命名规则第 5 页 共 10 页3 竞争对手产品对比差异分析报告 OPA(Opponent Product Differe

4、nce Analyse Report)4 标准吻合度分析报告 SMR(Standard Match Report)5 产品系统需求 PSR(Product System Requirement )1 XX 技术预研计划 TSP(Technology Study Plan)2 XX 技术预研报告 TSR(Technology Study Report)3 技术可行性分析报告 TFA(Technology Feasibility Analyse Report)技术预研(TS)4 产品系统需求 PSR(Product System Requirement )1 产品需求规格说明书 SRS(Produ

5、ct Requirement Specification)2 项目开发计划 PDP(Product Development Plan)3 风险管理计划 RMP(Risk Management Plan)4 产品系统测试计划 PTP(Product Test Plan)5 质量保证计划 QAP(Quality Assurance Plan)6 配置管理计划 CMP(Configuration Management Plan)7 项目会议记录 meeting8 产品工程计划与进度跟表 PST(Product Schedule Trace)9 产品界面原型设计 UID(User Interface

6、Design)10 产品任务书 无需计划与立项(PP)11 产品立项申请书 PSA(Product Start Apply)1 产品总体设计说明书 PSD(Product System Design)2 XX 模块概要设计说明书 HLD(High Level Design)设计(DE) 3 XX 模块详细设计说明书 DD(Detail Design)1 产品单元测试汇总报告 UTR(Product Unit Test Report)2 用户手册 无需3 产品集成测试用例 ITC(Product Integerate Test Case)编码、单元测试(CUT)4 集成测试计划 ITP(Inte

7、gerate Test Plan)1 产品集成测试报告 ITR(Integerate Test Report)集成测试(IT) 2 产品系统测试用例 STC(System Test Case)1 测试入口检查单 无需2 系统测试方案 STP(System Test Plan)3 增量测试方案 ATP(Alternate Test Plan)4 增量测试报告 ATR(Alternate Test Report)增量测试和系统测试(ST) 5 系统测试报告 STR(System Test Report)4 文档版本(1) 格式：V.，初始版本号为 V0.1，最大版本号为：V999.999。其中，X

8、XX 公司 命名规则第 6 页 共 10 页草稿状态的版本均为 V0.，例如：V0.1，V0.2V0.999；而经过评审通过的文档版本均从 V1.0 开始，例如：V1.0，V1.1，V2.0 等。5 密级程度(1) 文档（包括电子文档和纸质文档）的密级分为三级，由低到高分别是：公开级、限制级、核心级：1) 公开级的文档使用的范围不受约束，例如研发人员，生产人员、市场人员、行政人员和产品用户等；包括 用户手册、技术白皮书、产品安装说明、宣传资料等。2) 限制级的文档使用的范围仅限于研发内部的人员或生产人员；包括 研发制度和规范、计划、产品需求、总体设计、模块设计、详细设计、测试用例、测试报告、评

9、审文档、生产资料等。3) 核心级的文档使用的范围仅限于研发开发经理以上的人员。包括 产品源码、产品镜像文件、公司或部门的敏感文件。(2) 密级标注密级在密级标识栏中填写，若无标识栏则在文档的右上角标注密级。6 文档编写格式文档编写可以从研发模板库中取得相应模板进行编写，也可根据格式要求进行编写，具体格式要求如下：(1) 封面1) 页眉、页脚空白2) 封面上方文档编号表格 属性：文字环绕- 无 置顶，上面无空行 中文宋体、英文 Arial，全部加粗，宋体，10.5 号3) 标题 2 行：第一行：产品中文名称 Vx.x；第二行：文档名称 小一号字体，黑体，Arial，加粗 段前段后 2.6 磅，单

10、倍行距；无缩进，无悬挂 上方空 2 行，下方空 3 行4) 签核栏位XXX 公司 命名规则第 7 页 共 10 页 四号字体，宋体，Arial ，加粗 签核栏位 4 栏，到部门批准（研发副总） ；签核栏位 5 栏，到批准（郭总）。具体的签核栏位数见研发过程文档命名及签批流程.xls 左侧缩进 4 字符，右侧缩进-4.16 字符，无悬挂；段前段后 2.6 磅，单倍行距5) 模板制度日期 “XXXX 公司” “二零 XX 年 X 月制”分两行； 小三号字体，黑体，Arial，加粗；居中 段前段后 0 行，单倍行距；无缩进，无悬挂 下方插入分节符“下一页”(2) 历史记录1) “历史记录” 小三，黑

11、体，不加粗 段前段后 0 行，单倍行距2) 表格 属性：文字环绕选无；行高，0.6，最小；设置“在各页端以标题行形式重复出现” 表头：五号，宋体，加粗，全部居中 格式：五号，宋体，Arial，不加粗，全部居中 内容：日期格式为 yyyy.mm.dd，版本号 Vx.x 表格下方插入分节符-下一页3) 页眉、页脚 页眉： 页脚：开始插入页码，页码格式为“第 X 页 共 X 页” ，小五号，宋体，Arial，居中(3) 目录2) “目录” 字体：小三，黑体，不加粗 “目录”两个字中间空 2 个字 段前段后 0 行，多倍行距，设置选 33) 目录内容XXX 公司 命名规则第 8 页 共 10 页 来自

12、模板，显示级别 3 级，不加冒号4) 页眉、页脚 页眉： 页脚：插入页码，页码格式为“第 X 页 共 X 页” ，小五号，宋体，Arial，居中(4) 正文1) 标题：字体均采用宋体加黑，标题一为小三号字体，标题二为四号，依次类推。段落为单倍行距。2) 标题一段落段前 13 磅，段后 6 磅；标题二段落段前段后 6 磅；3) 页眉页脚：页眉格式：左上角标注“西安交大公司网络科技有限公司” ，右上角标注文档名称；页脚格式：第页 共页，封面不显示页码。4) 内容：正文，字体，宋体，Arial，五号，不加粗，两端对齐，首行缩进 2 字符，段后 0 行，1.5 倍行距。(5) 表格1) 表头：字体宋体

13、，Arial，五号，加粗；上下居中，水平居中；表格底纹设置为灰度 25%2) 内容：字体宋体，Arial，五号，不加粗3) 行高：0.6cm，最小值4) 宽度：设置为页面宽度(6) 流程图均采用 Visio 画图，底色均为默认的白色，图中字体均为宋体，大小采用五号字体或 10pt 大小字体。(7) 页边距：上下 2.54 厘米，左右 3.17 厘米均采用 Visio 画图，底色均为默认的白色，图中字体均为宋体，大小采用五号字体或 10pt 大小字体。4.2 配置项的版本标识根据产品的需要，软件产品制造过程中的每个配置项和不同阶段的基线发布都需要进行相应的版本标识，下面分别介绍。1、配置项版本标

14、识对于文档、软件和硬件的版本号，项目过程中采用三位编码的原则，格式如下：XXX 公司 命名规则第 9 页 共 10 页Vxxx.xxx.xxxx，初始版本号为 V1.0.0，最大版本号为：V999.999.9999.例如：V1.0.0；V82.456.15在个人工作区如果对文档或编码进行修改，版本号的第三位迭代 1，如 V1.0.1。文档、软件和硬件的各配置项的版本号第二位应统一。从个人工作区提交到开发区时，由项目经理控制版本号的第二位的迭代。建议：如果其中一项的特征进行了较大修改或者增加了新特性，第二位迭代 1，第三位恢复为 0。如V1.1.0。从开发区提交到基线区时，由 SCCB 控制版本

15、号的第一位的迭代，进行一次变更版本号的第二位迭代 1,并由 SCM 去掉版本号的第三位后放入基线区。如：V56.45。2、基线版本标识SCM 负责人负责把基线发布给外部客户（如发布运行基线）或内部使用（如为测试而发布） 。基线的版本号采用两位编号原则，格式如下：Vxxx.xxx,初始版本号为 V1.0.，最大版本号为 V999.999。例如：V1.0；V33.994.3 标签的命名SCM 人员负责对开发过程中的重要里程碑及基线进行标签的标注。标签的命名不可随意为之，要让标签名称具有很强的自说明性，并且尽量不要过于复杂。标签命名分为以下两种情况：a) 正是基线命名标签名称必须以该项目组产品名称的

16、英文字母开头，格式如下：产品英文名称_版本号_REL+标签版本号，其中“版本号”指的是所开发产品的版本，初始版本号为 v1_0，最大版本号为 v999_999；而“标签版本号”指的是每次打标签递增的序号，范围从 01 到 99。b) 非正式基线或里程碑命名标签名称以类型的英文字母开头，格式如下：类型_版本号_标签版本号，其中“类型”指的是 alpha 测试版、beta 测试版等， “版本号”指的是所开发产品的版本，初始版本号为 v1_0，最大版本号为 v999_999；而“标签版本号”指的是每次打标签递增的序号，范围从 01 到 99。XXX 公司 命名规则第 10 页 共 10 页 注意：标签名称必须以字母开头，中间可以包含字母、数字、下划线（_）和连字符（） ，不能使用小数点。