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

项目文档命名规则编制：日期：____/____/____审核：日期：____/____/____批准：日期：____/____/____XXXX公司二零一五年五月制XXXX公司命名规则第2页共9页历史记录编号章节名称说明修订日期版本号修订人发布日期01全文新建1.002修订章节4.11.1XXXX公司命名规则第3页共9页目录1目的..............................................................................................................................................42适用范围.......................................................................................................................................43术语和缩略词...............................................................................................................................44规程..............................................................................................................................................44.1文档命名规则....................................................................................................................44.2配置项的版本标识............................................................................................................84.3标签的命名........................................................................................................................9XXX公司命名规则第4页共9页1目的本文的目的是定义各项目所有相关文档和CMM要求的过程文件的格式和规则，以及配置管理中对配置项和版本的标识。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)单个文档：首字母大写V产品版本号-阶段英文缩写-文档名称英文缩写。2)多个子文档：首字母大写V产品版本号-阶段英文缩写-文档名称英文缩写—流水号。3)周期性：首字母大写V产品版本号-文档名称/英文名称-八位日期。(2)项目阶段及文档名称英文缩写，见下表：阶段序号文档名称英文及缩写产品调研(PI)1产品调研任务书PIA(ProjectInvestigateAssignment)2产品调研计划PIP(ProjectInvestigatePlan)3竞争对手产品对比差异分析报告OPA(OpponentProductXXX公司命名规则第5页共9页DifferenceAnalyseReport)4标准吻合度分析报告SMR(StandardMatchReport)5产品系统需求PSR(ProductSystemRequirement)技术预研(TS)1XX技术预研计划TSP(TechnologyStudyPlan)2XX技术预研报告TSR(TechnologyStudyReport)3技术可行性分析报告TFA(TechnologyFeasibilityAnalyseReport)4产品系统需求PSR(ProductSystemRequirement)计划与立项(PP)1产品需求规格说明书SRS(ProductRequirementSpecification)2项目开发计划PDP(ProductDevelopmentPlan)3风险管理计划RMP(RiskManagementPlan)4产品系统测试计划PTP(ProductTestPlan)5质量保证计划QAP(QualityAssurancePlan)6配置管理计划CMP(ConfigurationManagementPlan)7项目会议记录meeting8产品工程计划与进度跟表PST(ProductScheduleTrace)9产品界面原型设计UID(UserInterfaceDesign)10产品任务书无需11产品立项申请书PSA(ProductStartApply)设计(DE)1产品总体设计说明书PSD(ProductSystemDesign)2XX模块概要设计说明书HLD(HighLevelDesign)3XX模块详细设计说明书DD(DetailDesign)编码、单元测试(CUT)1产品单元测试汇总报告UTR(ProductUnitTestReport)2用户手册无需3产品集成测试用例ITC(ProductIntegerateTestCase)4集成测试计划ITP(IntegerateTestPlan)集成测试(IT)1产品集成测试报告ITR(IntegerateTestReport)2产品系统测试用例STC(SystemTestCase)增量测试和系统测试(ST)1测试入口检查单无需2系统测试方案STP(SystemTestPlan)3增量测试方案ATP(AlternateTestPlan)4增量测试报告ATR(AlternateTestReport)5系统测试报告STR(SystemTestReport)4文档版本(1)格式：V×××.×××，初始版本号为V0.1，最大版本号为：V999.999。其中，草稿状态的版本均为V0.×××，例如：V0.1，V0.2……V0.999；而经过评审通过XXX公司命名规则第6页共9页的文档版本均从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，加粗XXX公司命名规则第7页共9页签核栏位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级，不加冒号XXX公司命名规则第8页共9页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.2配置项的版本标识根据产品的需要，软件产品制造过程中的每个配置项和不同阶段的基线发布都需要进行相应的版本标识，下面分别介绍。1、配置项版本标识对于文档、软件和硬件的版本号，项目过程中采用三位编码的原则，格式如下：Vxxx.xxx.xxxx，初始版本号为V1.0.0，最大版本号为：V999.999.9999.XXX公司命名规则第9页共9页例如：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.3标签的命名SCM人员负责对开发过程中的重要里程碑及基线进行标签的标注。标签的命名不可随意为之，要让标签名称具有很强的自说明性，并且尽量不要过于复杂。标签命名分为以下两种