项目文档命名规则编制:日期:____/____/____ 审核:日期:____/____/____ 批准:日期:____/____/____XXXX公司二零一五年五月制历史记录编号章节名称说明修订日期版本号修订人发布日期01 全文新建 1.002 修订章节 4.1 1.1目录1 目的 (4)2 适用范围 (4)3 术语和缩略词 (4)4 规程 (4)4.1 文档命名规则 (4)4.2 配置项的版本标识 (8)4.3 标签的命名 (9)1 目的本文的目的是定义各项目所有相关文档和CMM要求的过程文件的格式和规则,以及配置管理中对配置项和版本的标识。
2 适用范围本规则适用于所有需求、设计等文档和过程文件。
3 术语和缩略词无4 规程4.4文档命名规则1 组织标准软件过程文档编号(1) 过程文件格式:XXX-P-××,初始编号为:XXX-P-01,最大编号为:XXX-P-99。
(2) 指南文件编号:XXX-G-××××,前两位××为指南所对应的过程文件编号。
(3) 模板文件编号:XXX-T-××××,前两位××为指南所对应的过程文件编号。
2 产品命名规范(1) 中文命名规范:中文全称V 产品版本号。
英文命名规范:首字母大写V 产品版本号。
3 项目文档编号(1) 编号规则分三种:1) 单个文档:首字母大写V产品版本号- 阶段英文缩写- 文档名称英文缩写。
2) 多个子文档:首字母大写V产品版本号- 阶段英文缩写- 文档名称英文缩写—流水号。
3) 周期性:首字母大写V 产品版本号- 文档名称/ 英文名称- 八位日期。
(2) 项目阶段及文档名称英文缩写,见下表:阶段序号文档名称英文及缩写产品调1 产品调研任务书P IA(Project InvestigateAssignment)研(PI) 2 产品调研计划PIP(Project Investigate Plan)3 竞争对手产品对比差异分析报告OPA(Opponent ProductDifference Analyse Report) 4 标准吻合度分析报告SMR(Standard Match Report)5 产品系统需求P SR(Product System Requirement )1 XX技术预研计划TSP(Technology Study Plan)2 XX技术预研报告TSR(Technology Study Report) 技术预研(TS) 3 技术可行性分析报告T FA(Technology FeasibilityAnalyse Report)4 产品系统需求P SR(Product SystemRequirement )1 产品需求规格说明书S RS(Product RequirementSpecification)2 项目开发计划PDP(Product Development Plan)3 风险管理计划RMP(Risk Management Plan)4 产品系统测试计划PTP(Product Test Plan)计划与 5 质量保证计划QAP(Quality Assurance Plan)立项(PP)6 配置管理计划C MP(Configuration ManagementPlan)7 项目会议记录meeting8 产品工程计划与进度跟表PST(Product Schedule Trace)9 产品界面原型设计UID(User Interface Design)10 产品任务书无需11 产品立项申请书PSA(Product Start Apply)设计(DE) 1 产品总体设计说明书PSD(Product System Design)2 XX模块概要设计说明书HLD(High Level Design)3 XX模块详细设计说明书DD(Detail Design)1 产品单元测试汇总报告UTR(Product Unit Test Report)编码、单 2 用户手册无需元测试(CUT) 3 产品集成测试用例I TC(Product Integerate TestCase)4 集成测试计划ITP(Integerate 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 。
其中,草稿状态的版本均为V0. ×××,例如:V0.1,V0.2 ,, V0.999 ;而经过评审通过的文档版本均从V1.0 开始,例如:V1.0,V1.1 ,V2.0 等。
5 密级程度(1) 文档(包括电子文档和纸质文档)的密级分为三级,由低到高分别是:公开级、限制级、核心级:1) 公开级的文档使用的范围不受约束,例如研发人员,生产人员、市场人员、行政人员和产品用户等;包括用户手册、技术白皮书、产品安装说明、宣传资料等。
2) 限制级的文档使用的范围仅限于研发内部的人员或生产人员;包括研发制度和规范、计划、产品需求、总体设计、模块设计、详细设计、测试用例、测试报告、评审文档、生产资料等。
3) 核心级的文档使用的范围仅限于研发开发经理以上的人员。
包括产品源码、产品镜像文件、公司或部门的敏感文件。
(2) 密级标注密级在密级标识栏中填写,若无标识栏则在文档的右上角标注密级。
6 文档编写格式文档编写可以从研发模板库中取得相应模板进行编写,也可根据格式要求进行编写,具体格式要求如下:(1) 封面1) 页眉、页脚空白2) 封面上方文档编号表格属性:文字环绕--无置顶,上面无空行中文宋体、英文Arial ,全部加粗,宋体,10.5 号3) 标题2 行:第一行:产品中文名称Vx.x ;第二行:文档名称小一号字体,黑体,Arial ,加粗段前段后 2.6 磅,单倍行距;无缩进,无悬挂上方空 2 行,下方空 3 行4) 签核栏位四号字体,宋体,Arial ,加粗签核栏位 4 栏,到部门批准(研发副总);签核栏位 5 栏,到批准(郭总)。
具体的签核栏位数见《研发过程文档命名及签批流程.xls》左侧缩进 4 字符,右侧缩进-4.16 字符,无悬挂;段前段后 2.6 磅,单倍行距5) 模板制度日期“XXXX 公司”“二零XX 年X 月制”分两行;小三号字体,黑体,Arial ,加粗;居中段前段后0 行,单倍行距;无缩进,无悬挂下方插入分节符“下一页”(2) 历史记录1) “历史记录”小三,黑体,不加粗段前段后0 行,单倍行距2) 表格属性:文字环绕选无;行高,0.6,最小;设置“在各页端以标题行形式重复出现”表头:五号,宋体,加粗,全部居中格式:五号,宋体,Arial ,不加粗,全部居中内容:日期格式为yyyy.mm.dd ,版本号Vx.x表格下方插入分节符-下一页3) 页眉、页脚页眉:页脚:开始插入页码,页码格式为“第X 页共X 页”,小五号,宋体,Arial ,居中(3) 目录2) “目录”字体:小三,黑体,不加粗“目录”两个字中间空 2 个字段前段后0 行,多倍行距,设置选 33) 目录内容来自模板,显示级别 3 级,不加冒号4) 页眉、页脚页眉:页脚:插入页码,页码格式为“第X 页共X 页”,小五号,宋体,Arial ,居中(4) 正文1) 标题:字体均采用宋体加黑,标题一为小三号字体,标题二为四号,依次类推。
段落为单倍行距。
2) 标题一段落段前13 磅,段后 6 磅;标题二段落段前段后 6 磅;3) 页眉页脚:页眉格式:左上角标注“西安交大公司网络科技有限公司”,右上角标注文档名称;页脚格式:第×页共×页,封面不显示页码。
4) 内容:正文,字体,宋体,Arial ,五号,不加粗,两端对齐,首行缩进 2 字符,段后0 行,1.5 倍行距。
(5) 表格1) 表头:字体宋体,Arial ,五号,加粗;上下居中,水平居中;表格底纹设置为灰度25%2) 内容:字体宋体,Arial ,五号,不加粗3) 行高:0.6cm,最小值4) 宽度:设置为页面宽度(6) 流程图均采用Visio 画图,底色均为默认的白色,图中字体均为宋体,大小采用五号字体或10pt 大小字体。
(7) 页边距:上下 2.54 厘米,左右 3.17 厘米均采用Visio 画图,底色均为默认的白色,图中字体均为宋体,大小采用五号字体或10pt 大小字体。
4.5配置项的版本标识根据产品的需要,软件产品制造过程中的每个配置项和不同阶段的基线发布都需要进行相应的版本标识,下面分别介绍。
1、配置项版本标识对于文档、软件和硬件的版本号,项目过程中采用三位编码的原则,格式如下: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控制版本号的第一位的迭代,进行一次变更版本号的第二位迭代1, 并由SCM去掉版本号的第三位后放入基线区。
如:V56.45 。
2、基线版本标识SCM负责人负责把基线发布给外部客户(如发布运行基线)或内部使用(如为测试而发布)。
基线的版本号采用两位编号原则,格式如下:Vxxx.xxx, 初始版本号为V1.0. ,最大版本号为V999.999 。
例如:V1.0 ;V33.994.6标签的命名SCM 人员负责对开发过程中的重要里程碑及基线进行标签的标注。
标签的命名不可随意为之,要让标签名称具有很强的自说明性,并且尽量不要过于复杂。
标签命名分为以下两种情况:a)正是基线命名标签名称必须以该项目组产品名称的英文字母开头,格式如下:产品英文名称_版本号_REL+ 标签版本号,其中“版本号”指的是所开发产品的版本,初始版本号为v1_0,最大版本号为v999_999;而“标签版本号”指的是每次打标签递增的序号,范围从01 到99。