1 目的及范围
配置项的选择、标识和版本标识以及软件配置库的构造等活动都是在标识的基础上进行的。本文目的是描述在本公司所有军用软件研发过程的配置管理活动中如何识别和标识配置项,以及配置项和发布的版本标识规范。
本文档适用于公司所有军用软件项目。
2 引用文件
a) GJB5000A-2008 军用软件研制能力成熟度模型
b) 软件过程体系文件编制规定
3 术语表
《软件过程体系文件编制规定》定义的术语、定义、缩略语适用于本文。
4 命名规范
4.1 项目命名
软件项目命名规范如表1。
表1 软件项目命名规范
项目代号 | 分隔符 | 软件类别 |
NN..N | _ | XXX |
a) “NN..N”为项目代号,用英文字母表示,不超过8位,在项目合同签订后,由科研生产部设定;
b) “XXX”为软件类别,由3位字母表示,不分大小写。软件类别各项目根据实际情况自己制定,PJT(project)-工程软件,CPT(cooperant)-配套软件,PDT(product)-产品软件。
示例1: AAAAA_PJT: AAAAA为项目代号,PJT为软件类别。
示例2: BBBBB_PDT: BBBBB为项目代号,PDT为软件类别。
4.2 文档配置项命名
文档名称命名规范,参见表4:
表2 文档名称命名
项目代号 | 分隔符 | 文档编号 | 分隔符 | 文档类型 | 分隔符 | 顺序号(可剪裁) |
NN..N | _ | YY..Y | _ | XXX | _ | 1-10 |
a) “NN..N”为项目代号,参见本文4.1项目命名中定义。
b) “YY..Y”文档编号,在项目合同签订后,由质量技术部设定
c) “XXX”表示文档类型,参见公司文档简称规范。例如:软件任务书用RW表示。
d) 顺序号用“1-10”的数字表示,当相同的项目文档分成几部分时,用来标识文档顺序。当只有唯一个文档时,可以剪裁。
示例1: AAAAA_PJT_Ae.184.406_RW_1: AAAAA_PJT为项目命名,Ae.184.406为文档编号,RW为文档类型,1为顺序号。
示例2: BBBBB_PDT_Ae.183.507_RW_1: BBBBB_PDT为项目命名,Ae.183.507为文档编号,RW为文档类型。
4.3 代码配置项命名
代码配置项规范命见表9
表3代码配置项命名规范
项目代号 | 分隔符 | 模块代号 |
NN..N | _ | XX..X |
a) “NN..N”为项目代号,参见本文4.1项目命名中定义。
b) “XX..X”表示模块代号,如果项目组以整个代码目录作为一个配置项,则使用项目命 名作为标识,不区分大小写。
c) 软件配置项版本命名参见本文第4.5章“配置项版本命名”,并由各项目组使用的配置管理工具实现版本记录。
示例:AAAAA_PJT_USER:AAAAA_PJT为项目代号,USER模块的命名,版本由工具自动记录,工具记录版本号符合命名规范4.5版本号。
4.4 基线命名
项目的基线名称和代号是由项目的配置管理部门定义的。在项目策划阶段,配置人员根据已确定的基线从《软件配置管理计划》中找出并为其进行标识。
项目的基线命名规范见表4:
表4 项目基线命名规范
项目代号 | 分隔符 | 基线版本号 | 年月日(可裁剪) | 分隔符 | 类型 |
NN..N | _ | VX.YY | YY..Y | for | XX |
a) “NN..N”为项目代号,参见本文4.1项目命名中定义。
b) “VX.YY”表示基线版本号, 参见本文第4.5章“其他配置项使用的版本号命名”。
c) “YY..Y”由8位数字,表示基线建立年月日,如在项目命名或其他部位已对时间进行过标识,则此处可以裁剪。
d) “for” 固定标识。
e) “XX”表示基线类型,分别为:
1) GN – 代表功能基线;
2) FP – 代表分配基线;
3) SJ - 代表设计基线;
4) BM - 代表编码基线;
5) CS - 代表测试基线;
6) RELEASE - 代表产品基线。
示例: AAAAA_PJT _V1.00_20100101_for_GN: AAAAA_PJT为项目命名,V1.00表示“F”阶段版本,20100101表示时间,for固定标识,GN标示功能基线。
4.5 配置项版本命名
a) 文档配置项版本命名:
初始版本用“NEW”来代表。
初始版本以后的版本由V1.0开始,其后以小版本V1.1,V1.2,依次递增,当有重大变化时,直接进行大版本升版,例如:V1.7升级为V2.0,之后遵循同样的编号准则。
b) 其他配置项使用的版本号命名:
表5 配置项版本命名规范
固定版本代号 | 大版本号 | 分隔符 | 小版本号 |
V | X | . | YY |
a) “V”为固定版本代号,
b) “X”为大版本号,表示研制阶段:
“受控”阶段为“1”,
“产品”阶段为“2”,
c) “YY”为小版本号,表示受控库中配置项变化,由数字00--99构成。
d) 初始版本为V1.00,然后V1.01,V1.02•••依次递增,当阶段变化时,升版为V2.00,其后变化遵循相同的准则。当某个项目不是从初始版本开始,即不是从“F”阶段开始,版本号选取对应其阶段的大版本号命名,如:某个项目直接从“S”阶段开始,则第一个版本为:V3.00。