DB21∕T2139-2013计算机软件工程文档编号规范

1、DB21 / T 2139-2013计算机软件工程文档编号规范L70DB21辽宁省地点标准DB XX/ XXXXX XXXX运算机软件工程文档编号规范Specification of computer software engineering documentation numberin g2013 - XX - XX 公布2013 - XX - XX 实施公布（报批稿）目次 TOC o 1-5 h z 前言II引言III范畴 1规范性引用文件1术语和定义1文档 1软件工程文档1文档编号差不多规则1文档编号字符1文档编号差不多原则1文档编号一样要求2分类编号2隶属编号2软件工程文档编号2软件工

2、程文档编号组成结构 3软件产品编号3软件工程过程编号4子系统、组件、模块文档编号4文档种类编号6文档序号7语种编号7软件工程文档编号储备与标注 8软件工程文档格式 8软件工程文档编号储备8软件工程文档编号标注8附录A （资料性附录）软件工程文档编号示例 9参考文献 12前言本标准依据GB/T1.1 2009标准化工作导则第 1 部分： 标准的结构与编写制定。本标准由大连市经济和信息化委员会提出。本标准由辽宁省经济和信息化委员会归口。本标准起草单位：大连华信运算机技术股份有限公司、大连软件行业协会。本标准于 2013年 xx 月 xx 日首次公布。引言本规范借鉴其他行业的设计文档编号规范，对运算

3、机软件开发过程输出的软件工程文档的编号提出一样性要求。软件工程文档从使用的角度上大致可分为开发方在开发过程中使用的软件工程文档和软件用户需要的用户文档两类。本标准适用于对在开发过程中使用的软件工程文档的编号治理。使用者可按照实际情形对本标准进行适当的裁剪。供方应提供给需方的用户文档类型和编号，由软件的需方和供方在合同中规定。运算机软件工程文档编号规范范畴本规范规定了文档编号的通用要求，以及软件工程文档编号、软件工程文档编号的储备与标注要求。规范性引用文件下列文件中的条款通过本标准的引用而成为本部分的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本部分，然而

4、，鼓舞使用本标准的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本部分。GB/T 8566-2007 信息技术 软件生存周期过程GB/T 8567-2006 运算机软件工程文档编制规范GB/T 11457-2006 软件开发术语术语和定义GB/T 11457-2006 确立的以及以下术语和定义适用于本文件。文档 docment能供人或机器阅读的，一样具有永久性的一套数据媒介和其中包含的信息（不管它们记录在什么媒体上） 。软件工程文档 Software engineering docment在运算机软件开发过程中所形成、用以描述或规定软件产品必要信息的有关技术文档

5、。文档编号差不多规则文档编号字符文档编号一样可采纳下列字符表示：09阿拉伯数字；AZ拉丁字母（O、I除外）；短横线（ - ） 、圆点（ ? ） 。文档编号差不多原则科学性：选择事物或概念的最稳固的本质属性或特点作为信息分类的基础和依据。系统性：将选定的事物、概念的属性或特点按一定排列顺序予以系统化，并形成一个合理的科学分类体系。唯独性：一个编号只能唯独地标识一个分类对象。可延性：应当设置收容类目，以便保证增加新的事物和概念时，不致打乱已建立的分类体系，同时，还应为下级信息治理系统在原有基础上的延拓、细化制造条件。规范性：同一层级代码的编写格式必须统一。文档编号一样要求每个产品、子系统、组件、模

6、块的文档均应有独立的编号。采纳表格时，表中每个产品、子系统、组件、模块都应标出独立的编号。同一产品、子系统、组件、模块的文档用数张纸印刷成纸介质文档时，各张纸介质文档应标注同一编号。同一文档使用两种以上的储备介质时，每种储备介质中的文档都应标注同一编号。复用文档的编号应采纳被复用文档的编号。文档的编号一样可采纳分类编号或隶属编号。也可采纳将分类编号与隶属编号混合组合方式进行编号。文档的编号应与企业运算机辅助治理分类编号要求相和谐。分类编号分类编号是按对象（软件产品、子系统、组件、模块）、功能、特性等的相似性，采纳十进位分类法编号。编号的差不多部分由分类号 （大类） 、 特点号（中类）和识别号（

7、小类）三部分组成，中间能够圆点或短横线分开，圆点在下方，短横线在中间。必要时能够在尾部加尾注号。大、中、小类的编号按十进位分类编号法。每类的码位一样由 2 位数（如软件产品、子系统、组件、模块）组成。分类编号码位的序列及其含义表分类号（大类）特点号（中类）识别号（小类）尾注号校验号软件工程文档按软件 开发过程、类型等编 号软件产品、子系统、 组件、模块区分码位软件工程文档按种 类、编写语言等编号软件工程文档、软件产品改进尾注号检验软件产品代号的 码位尾注号表示软件工程文档、软件产品改进。一样改进的尾注号用拉丁 字母表示。用运算机自动生成软件产品文档编号时，应在编号终端加校验号（校 验码）。隶属

8、编号隶属编号是按系统、组件、模块的隶属关系编号。编号由软件产品编号和隶属号组成。中间可用圆点或短横线隔开，必 要时可加尾注号。需要时在首位前加分类号表示运算机辅助治理信息分类编号系统的大 类号。系统编号由字母和数字组成。隶属号由数字组成，其级数和位数应按软件产品结构的复杂程度而定。组件的序号，应在其所属（系统或上一级组件）的范畴内编号。模块的序号，应在其所属（系统或组件）的范畴内编号。编流水号时，可在尾部以带“ 0”或不带“0”区别模块与组件。软件工程文档编号软件工程文档编号组成结构软件工程文档编号应由8部分组成。各部分位数如下：软件产品编号（3位）工程过程编号（2位）子系统编号（2位）组件编

9、号（2位）模块编号（2位）文档种类编号（2位）文档序号（2位）系统编号、系伸编号、模块编号是采纳隶属编号。软件工雨期1褊杼纽函江）软件产品编号（3位）结构参见图1软件工程文档编号组成图软件产品编号软件产品编号应满足如下要求：软件产品编号应由3位英文大写字母或3为数字组成。当软件产品编号为英文缩写时，表示该软件为软件产品或软件包。3位大写字母应该为软件产品英文缩写。软件产品编号示例，参见表2软件产品编号表。软件产品编号表软件产品名称软件产品编号英文数字编号英文缩写编号A系统001SSASystemB系统002SSBSystemC系统003SSCSystem当软件产品编号为数字时，表示在软件产品基

10、础上为客户定制的系统。3为数字应客户代码，不足3位，用“0”从右侧补足3位。为客户定制系 统编号本例，参见表3。客户定制系统编号表客户名称软件产品编号演示系统000A客户100B客户200B客户的B1子公司210软件工程过程编号软件工程过程编号应满足如下要求：软件工程过程编号应由2位大写的英文字母或数字组成。大写的英文字母是软件工程过程的英文名称缩写软件工程过程的编号示例，参见表4概要编码单体集成系统运行、一友尤略。层百模考号件软件带过程”一第0层件工程过程名称二表第1层_L第2层钵件工程过程编号 1L1 11 第3层1_L 第4层:英文名称数字编号11英文缩雪编号SSA-00听1系统航SSA

11、-0000a01公共子系统021 r-S.SA-000100公共组件BAjSSA-000.公共模多101 Busine如Requir1)ss Analysis 1Rement Development r计03BD rDesignSSA-000Basic 102 如 Detail计04D1公共模多Design05CCoding，一oSA-000200公共组件试06 JS、UTr-SSA-000公修楼主20Unit T如Integraesting .试07 ；TTition Testing 1试08 ：STSSA-000Dysiei 202 匚 Applic 如叫i e i esiing 1付09

12、aD1公共模上ojtion Delivery护10P i:ions & Maintenancepera软件工程文档彳1 程文档编号可j 在软件开发中，:1:多个软牌开发号 子系统1公共组件笏改写A施01J 公共模块软件开11b可省略。不区分软件开夕113:过幼翼嗽件j 1发就愣档编-子系统、组件、 子系统、组件、 子系统、组件、11模块文档编号:：11上排十档飨县由浦H加下凄索;SSA-010102一模块SSA-0200；模块如编号E-/I 1，1SSA-020000Z由软侏编，SSA-020001 出口各愿顺序号制成。分文档最多不走 每层文档的编士I过 5层。卜方法应统一，夕1 SSA-02

13、0100 示号应连续。一:SSA-020101模块第5层的模块二汁当采纳并列顺序编号，必要时1I|7I:第2层开始采纳并列顺序号方法II，晦SA-02010200模块当本层级顺序号为SSAkftOo表示此sSA融0沐层级的SSA碗0系统 一一，、I 一， r r zt-t，/Hr r电勺软件工程文档I子系统公共组件模块组件、子系统、组件、模块文档编号示意图 文档种类编号文档种类编号应满足如下要求：文档种类编号由2位大写的英文字母或数字组成。大写的英文字母是文档种类的英文名称缩写。文档种类编号示例，参见表 5。当文档种类名称为“功能定义”时，文档种类编号可省略。文档种类编号表文档种类名称文档种类

14、编号英文数字编号英文缩写编号产品介绍01PTProduct Introduction产品方案02SLProduct Solution流程图03WFWork Flow组织结构04RSOrganizational Structure Chart实体关系05EREntity Relation Chart功能定义06FDFunction Define产品需求定义07PDProduct Requirement Define数据字典08DDData Dictionary架构模型09AMArchitecture ModelCRUD 巨阵10CMCRUD Matrix需求与变更11RCRequirement

15、and Change确认报告13VRValidation Report用户界面14UFUser Interface测试用例17TCTesting Case测试报告18TRTesting Report检查单19CLCheck List评估报告20ARAssessment Report培训21TRTraining缺陷22DFDefect评审23RWReview需求跟踪矩阵24RTRequment Tracing Matrix词语表25TTTerminology Table产品介绍01PTProduct Introduction产品方案02SLProduct Solution文档序号文档序号编号应满

16、足如下要求：文档序号编号由2为数字组成。不足2两位，左侧用“ 0”补足。当相同的子系统、组件或模块，且相同文档种类存在多个文档时，使 用文档序号进行编号区分。当只有一份文档时，文档序号可省略。语种编号语种编号应满足如下要求：语种编号为2位英文大写字母或数字组成。大写的英文字母是语言的英文名称缩写。当语言种类为“中文”时，可省略。常用语种编号示例，参见表 6语种编号表。语种编号表文档语言名称文档语种编号英文数字编号英文缩写编号中文01CNChina英文02ENEnglish日文03JPJapanese德语04GNGerman软件工程文档编号储备与标注软件工程文档格式软件工程文档格式为办公软件的兼

17、容格式，文档用于公布能够采纳PDF格式。软件工程文档编号储备在OFFICE的兼容格式文件中，软件工程文档编号存放在文件的“属 性”的自定义项目的“文档编号”字段中。当一个文件中存在多个文档时, 存放软件开发主文档编号。软件工程文档编号标注在每个文档的封面应标注文档编号。在电子表格类（如：XLS）文档中，在表头部分标注文档编号。在文字类（如：DOC）文档中，在页眉或页脚中标注文档编号。（资料性附录）软件工程文档编号示例示例讲明以A软件产品的01子系统为例，讲明软件各类文档编号。所有文档使用中文编写。示例中的各种文档在软件开发中只是典型的文档，并不代表软件开发中全部种类文档。共同文档01子系统共同

18、文档编号示例如下:文档名称文档编号（英文缩写）文档种类01子系统数据字典SSA-01-DD数据字典01子系统的需求跟踪矩阵表SSA-01-TT词语表01子系统的词语表SSA-01-RT需求跟踪矩阵表01子系统的缺陷记录（第1个）SSA-01-DF01缺陷记录业务分析过程01子系统的业务分析文档编号示例如下:文档名称文档编号文档种类01子系统业务介绍SSA-BA01-PT介绍01子系统业务方案SSA-BA01-SL方案01子系统业务流程图SSA-BA01-WF流程图01子系统业务有关的组织结构图SSA-BA01-RS组织结构图01子系统数据概念模型SSA-BA01-ER实体关系图01子系统业务功

19、能总体讲明SSA-BA0100-FD功能定义01子系统业务功能组件 01讲明SSA-BA0101-FD功能定义01子系统业务总体架构图SSA-BA01-AM架构图01子系统业务功能与数据实体 CRUD巨阵表SSA-BA01-CMCRUD 巨阵01子系统业务分析确认单（第1个）SSA-BA01-VR01确认报告01子系统业务分析文档评审检查单（第1个）SSA-BA01-CL01检查单01子系统业务分析评估报告（第1个）SSA-BA01-AR01评估报告01子系统业务分析评审记录表（第1个）SSA-BA01-RW01评审记录01子系统业务的培训资料（第1个）SSA-BA01-TR01培训需求定义过

20、程01子系统的功能需求定义文档编号示例如下:文档名称文档编号文档种类01子系统的系统功能介绍文档SSA-RD01-PT介绍01子系统功能流程图SSA-RD01-WF流程图01子系统有关角色组织结构图SSA-RD01-RS组织结构图01子系统的数据逻辑模型SSA-RD01-ER实体关系图01子系统功能需求总体讲明SSA-RD0100-FD功能定义文档名称文档编号文档种类01子系统功能需求组件 01讲明SSA-RD0101-FD功能定义01子系统总体结构图SSA-RD01-AM架构图01子系统CRUD巨阵表SSA-RD01-CMCRUD 巨阵01子系统需求变更票（第1个）SSA-RD01-RC01需求与变更票01子系统用户界面（第1个）SSA-RD01-UF01用户界面01子系统评审检查单（第1个）SSA-RD01-CL01检查单01子系统需求定义评审记录表（第1个）SSA-RD01-RW01评审记录01子系统评估报告（第1个）SSA-RD01-AR01评估报告设计过程A子系统的设计文档编号示例如下:文档名称文档编号文档种类01子系统处理模块流程图SSA-BD01-WF流程图01子系统的数据物理模型SSA-BD01-ER实体关系图01子系统设计总体讲明SSA-BD0100-FD功能定义01子系统01组件设计讲明SSA-BD010