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

1、实用标准项目文档命名规则编审批制：日期：_/_/_核：日期：_/_/_准：日期：_/_/_文档实用标准xxxx公司二零一五年五月制文档实用标准历史记录编号章节名称说明修订日期版本号修订人发布日期0102全文修订新建章节4.11.01.1文档实用标准目录1目的.52适用范围.53术语和缩略词.54规程.54.1文档命名规则.54.2配置项的版本标识.124.3标签的命名.13文档实用标准1目的本文的目的是定义各项目所有相关文档和cmm要求的过程文件的格式和规则，以及配置管理中对配置项和版本的标识。2适用范围本规则适用于所有需求、设计等文档和过程文件。3术语和缩略词无4规程4.1文档命名规则1组织

2、标准软件过程文档编号(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产品版本号-文档名称/英文名称-八位

3、日期。(2)项目阶段及文档名称英文缩写，见下表：阶段序号文档名称英文及缩写pia(projectinvestigate1产品调研任务书assignment)2产品调研计划pip(projectinvestigateplan)产品调opa(opponentproduct3竞争对手产品对比差异分析报告研(pi)differenceanalysereport)4标准吻合度分析报告5产品系统需求smr(standardmatchreport)psr(productsystemrequirement)12xx技术预研计划xx技术预研报告tsp(technologystudyplan)tsr(techno

4、logystudyreport)技术预tfa(technologyfeasibility3技术可行性分析报告研(ts)analysereport)psr(productsystem4产品系统需求requirement)srs(productrequirement计划与1产品需求规格说明书specification)立项pdp(productdevelopment(pp)2项目开发计划plan)文档345实用标准风险管理计划产品系统测试计划质量保证计划rmp(riskmanagementplan)ptp(producttestplan)qap(qualityassuranceplan)cmp(c

5、onfiguration6配置管理计划78910111项目会议记录产品工程计划与进度跟表产品界面原型设计产品任务书产品立项申请书产品总体设计说明书managementplan)meetingpst(productscheduletrace)uid(userinterfacedesign)无需psa(productstartapply)psd(productsystemdesign)设计2xx模块概要设计说明书hld(highleveldesign)(de)编码、单元测试(cut)集成测试(it)增量测31234121xx模块详细设计说明书产品单元测试汇总报告用户手册产品集成测试用例集成测试计划

6、产品集成测试报告产品系统测试用例测试入口检查单dd(detaildesign)utr(productunittestreport)无需itc(productintegeratetestcase)itp(integeratetestplan)itr(integeratetestreport)stc(systemtestcase)无需文档实用标准试和系统测试(st)2345系统测试方案增量测试方案增量测试报告系统测试报告stp(systemtestplan)atp(alternatetestplan)atr(alternatetestreport)str(systemtestreport)4文档版

7、本(1)格式：v.，初始版本号为v0.1，最大版本号为：v999.999。其中，草稿状态的版本均为v0.，例如：v0.1，v0.2v0.999；而经过评审通过的文档版本均从v1.0开始，例如：v1.0，v1.1，v2.0等。5密级程度(1)文档（包括电子文档和纸质文档）的密级分为三级，由低到高分别是：公开级、限制级、核心级：1)公开级的文档使用的范围不受约束，例如研发人员，生产人员、市场人员、行政人员和产品用户等；包括用户手册、技术白皮书、产品安装说明、宣传资料等。2)限制级的文档使用的范围仅限于研发内部的人员或生产人员；包括研发制度和规范、计划、产品需求、总体设计、模块设计、详细设计、测试用

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

9、，无悬挂上方空2行，下方空3行4)签核栏位四号字体，宋体，arial，加粗签核栏位4栏，到部门批准（研发副总）；签核栏位5栏，到批准（郭总）。具体的签核栏位数见研发过程文档命名及签批流程.xls左侧缩进4字符，右侧缩进-4.16字符，无悬挂；段前段后2.6磅，单倍行距文档实用标准5)模板制度日期“xxxx公司”“二零xx年x月制”分两行；小三号字体，黑体，arial，加粗；居中段前段后0行，单倍行距；无缩进，无悬挂下方插入分节符“下一页”(2)历史记录1)“历史记录”小三，黑体，不加粗段前段后0行，单倍行距2)表格属性：文字环绕选无；行高，0.6，最小；设置“在各页端以标题行形式重复出现”表头

10、：五号，宋体，加粗，全部居中格式：五号，宋体，arial，不加粗，全部居中内容：日期格式为yyyy.mm.dd，版本号vx.x表格下方插入分节符-下一页3)页眉、页脚页眉：文档实用标准页脚：开始插入页码，页码格式为“第x页共x页”，小五号，宋体，arial，居中(3)目录2)“目录”字体：小三，黑体，不加粗“目录”两个字中间空2个字段前段后0行，多倍行距，设置选33)目录内容来自模板，显示级别3级，不加冒号4)页眉、页脚页眉：页脚：插入页码，页码格式为“第x页共x页”，小五号，宋体，arial，居中(4)正文1)标题：字体均采用宋体加黑，标题一为小三号字体，标题二为四号，依次类推。段落为单倍行

11、距。2)标题一段落段前13磅，段后6磅；标题二段落段前段后6磅；，3)页眉页脚：页眉格式：左上角标注“西安交大公司网络科技有限公司”右上角标注文档名称；页脚格式：第页共页，封面不显示页码。文档实用标准4)内容：正文，字体，宋体，arial，五号，不加粗，两端对齐，首行缩进2字符，段后0行，1.5倍行距。(5)表格1)表头：字体宋体，arial，五号，加粗；上下居中，水平居中；表格底纹设置为灰度25%2)内容：字体宋体，arial，五号，不加粗3)行高：0.6cm，最小值4)宽度：设置为页面宽度(6)流程图均采用visio画图，底色均为默认的白色，图中字体均为宋体，大小采用五号字体或10pt大小

12、字体。(7)页边距：上下2.54厘米，左右3.17厘米均采用visio画图，底色均为默认的白色，图中字体均为宋体，大小采用五号字体或10pt大小字体。4.2配置项的版本标识根据产品的需要，软件产品制造过程中的每个配置项和不同阶段的基线发布都需要进行相应的版本标识，下面分别介绍。1、配置项版本标识文档实用标准对于文档、软件和硬件的版本号，项目过程中采用三位编码的原则，格式如下：vxxx.xxx.xxxx，初始版本号为v1.0.0，最大版本号为：v999.999.9999.例如：v1.0.0；v82.456.15在个人工作区如果对文档或编码进行修改，版本号的第三位迭代1，如v1.0.1。文档、软件

13、和硬件的各配置项的版本号第二位应统一。从个人工作区提交到开发区时，由项目经理控制版本号的第二位的迭代。建议：如果其第中一项的特征进行了较大修改或者增加了新特性，二位迭代1，第三位恢复为0。如v1.1.0。从开发区提交到基线区时，由sccb控制版本号的第一位的迭代，进行一次变更版本号的第二位迭代1,并由scm去掉版本号的第三位后放入基线区。如：v56.45。2、基线版本标识scm负责人负责把基线发布给外部客户（如发布运行基线）或内部使用（如为测试而发布）。基线的版本号采用两位编号原则，格式如下：vxxx.xxx,初始版本号为v1.0.，最大版本号为v999.999。例如：v1.0；v33.994.3标签的命名scm人员负责对开发过程中的重要里程碑及基线进行标签的标注。标签的命名不可随意为之，要让标签名称具有很强的自说明性，并且尽量不要过于复杂。标签命名分为以下两种情况：a)正是基线命名标签名称必须以该项目组产品名称的英文字母开头，格式如下：产品英文名称_版本号_rel+标签版本号，其中“版本号”指的是所开发产品的版本，文档实用标准初始版本号为v1_0，最大版本号为v999_999；而“标签版本号”指的是每