Files
YG-Datasets/data/05ae84ba-9df7-4c42-89ab-51f817e48a06/ready/ab0c2357-aae9-4939-b869-1dec750a815e_YG-CMMI-CM-PD10 代码提交规范.pdf.md
Developer 6aa271c4f7 refactor: 前端架构重构 - 提取 CSS 和逻辑到独立模块
前端重构:
- 删除旧的大体积 Vue 组件(HomeView, FileManage, TextSplit 等)
- 删除旧的 composables(useFormatters, useModels, useProjects)
- 新增 core/, page-logic/, pages/, shared/ 模块化目录结构
- 提取 CSS 到 styles/pages/ 目录
- 添加全局样式 variables.css 和 common.css

后端 API 更新:
- chunks: 语义分割 API 增强
- files: 文件处理 API 更新
- models: 模型管理 API 更新
- questions: 问答管理 API 更新
- database: 数据库连接优化
- semantic_embedding: 语义嵌入服务优化

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-19 14:23:34 +08:00

11 KiB
Raw Blame History

文件编号YG-CMMI-CM-PD04 发布日期2023-06-30 现行版本2.2

                                                                  商密【中】

代码提交规范

修订历史记录

日期 2013-08-5

版本 1.0 新增代码提交规范 张金金

批准 李剑/陈明有 周立

作者/修改人

审核

说明

2014-03-24

1.1

2017-08-30

1.2

2022-09-9

2.0

2023-02-20

2.1

2023-06-30

2.2

张羡

杨莹

陈金银

陈斯华

李美平

增加代码提交时需写注释,便于构 建系统识别变更集 增加提交代码总则,增加附注 ”GRIS 模块代码复审说明及操作” 修订 1.2.1 适用部门 新增 2 角色与职责; 新增 3 权限管理; 修订 4.1 代码提交原则; 修订 4.3.1 RTC 提交代码规范; 新增 4.3.3 GIT 提交代码规范。 修订适用范围、代码提交原则、增加 代码库明细表。 修订页眉中的商标引用,删除 RTC 代 码提交规范章节

姚国全 陈金银 刘发/王优

陈金银 黄德海

贾士中

向万红

姚国全

李锋

刘娟

远光软件股份有限公司 发布

远光软件股份有限公司

代码提交规范

文件编号 发布日期

现行版本 页 次

YG-CMMI-CM-PD04 2023-06-30

2.2 第 1 页 共 6 页

目 录

  1. 引言 ................................................................................................................................................... 2 1.1. 目的 ............................................................................................................................................................2 1.2. 适用范围 ....................................................................................................................................................2 1.2.1. 适用部门 ................................................................................................................................................2 1.2.2. 适应业务 ................................................................................................................................................2
  2. 角色与职责 ............................................................................................................................................... 2
  3. 权限管理 ........................................................................................................................................... 2 3.1. 用户管理及授权原则 ........................................................................................................................................2 3.2. 代码权限开通或关闭流程 ........................................................................................................................3
  4. 规范描述 ........................................................................................................................................... 4 4.1. 代码提交原则 ............................................................................................................................................4 4.2. 代码库管理工具的特性规范 ....................................................................................................................4 CCClearCase提交代码规范 ..........................................................................................................4 4.2.1. GIT 提交代码规范 .................................................................................................................................5 4.2.2.
  5. 相关附件 ........................................................................................................................................... 5
  6. 相关文档 ........................................................................................................................................... 5
  7. 附代码库明细表(供参考) .............................................................................................................. 5

商密【中】

远光软件股份有限公司

代码提交规范

文件编号 发布日期

现行版本 页 次

YG-CMMI-CM-PD04 2023-04-06

2.1 第 2 页 共 6 页

  1. 引言

1.1. 目的

为统一规范代码库用户管理及授权控制,规范代码提交,保证代码的安全性、完整性、可追溯性,

特制定本规范,用以保障代码管理工具 GIT 和 CCClearCase等提交代码活动的有序开展。

1.2. 适用范围

1.2.1. 适用部门

适用于公司产品研发部门、全资子公司,控股子公司参考执行。

1.2.2. 适应业务

项目代码交付。

  1. 角色与职责

序号

角色

职责

1

2

部门经理

项目经理 /开发经理

 负责审批本部门员工(含借调)提起的跨项目组代码权限申请。  负责审批项目组内员工(含借调)提起的代码权限申请。  及时关闭项目组调出、离职员工的代码权限。

3

开发工程师

4

配置管理工程师

 负责发起代码权限开通或关闭申请。  明确代码库权限开通或关闭范围。  了解代码库使用规范及要求。  借调员工加入项目组的接受项目组统一管理。  员工调岗、离职时需及时申请权限关闭。  负责代码库权限的设置。  协助项目成员正常使用代码库。  填写单据相关信息,更改单据状态。

  1. 权限管理

3.1. 用户管理及授权原则

  1. 用户代码权限,须经过项目经理(开发经理)或者部门经理审批,在审批通过后方可设置权限。

  2. 开通代码权限的用户,须妥善保管好自己的帐号和密码,不得转借他人使用,避免由此带来的泄密

及代码追溯困难等问题的风险。

  1. 开通了代码权限的用户,发现帐号/密码泄漏,须及时修改密码,设置的密码应符合公司安全规范。

因不遵守规范造成严重后果的,将按公司相关要求处理。

商密【中】

远光软件股份有限公司

代码提交规范

文件编号 发布日期

现行版本 页 次

YG-CMMI-CM-PD04 2023-04-06

2.1 第 3 页 共 6 页

  1. 开通了代码权限的用户,须严格按照代码提交规范要求及对应工具的操作手册进行代码提交,确保

代码的正确性、完整性及可追溯性。

  1. 开通了代码权限的用户,在调岗、离职时,需将代码交付完整后,按流程申请权限关闭。

3.2. 代码权限开通或关闭流程

入口准则

1 输入 1

需要代码库权限开通或关闭

过程步骤

1.1 申请人在公司研发管理平台上新建《代码库权限申请单》,提交代码权限开通或关闭申请。 申请人在《代码库权限申请单》填写相关内容,包括代码库地址、权限说明、执行人及其 它需说明的内容,申请人申请所在项目组代码库权限的由项目经理(开发经理)审批,申

1.2

商密【中】

远光软件股份有限公司

代码提交规范

文件编号 发布日期

现行版本 页 次

YG-CMMI-CM-PD04 2023-04-06

2.1 第 4 页 共 6 页

请部门其他项目组代码库权限的由项目归属的部门经理审批。

1.3 申请人将《代码库权限申请单》提交给部门经理、或项目经理(开发经理)审批。

1.4 部门经理、或项目经理(开发经理)审批通过,转单给配置管理工程师进行权限设置。

1.5 配置管理工程师按单据设置相应代码权限,并完善单据信息,变更单据状态。

输出 1

《代码库权限申请单》

出口准则

1

《代码库权限申请单》完整填写,权限已设置,单据内容已完善,单据状态已更改为结束。

裁剪 裁剪内容 不可裁剪 裁剪准则 无

  1. 规范描述

4.1. 代码提交原则

  1. 遵守已发布文档《YG-CMMI-CM-PD04 配置管理规范》中关于代码管理的所有原则。

  2. 依据研发管理平台单据交付代码,没纳入版本的需求单/工作单,不允许提交代码至代码库。

  3. 交付代码时必须按单号正确填写注释,格式如下:

注释必须含研发管理平台单据号,遵循以下三种要求: 格式 1单号 示例 843186 格式 2单号+空格+注释,示例 843186 注释内容 格式 3一个变更集可以对应多个单号需都写入注释中示例 843186 843187 注释内容 补充说明: 因解决编译报错修改的代码,关联导致编译报错时的代码变更集单据。 解决合并冲突产生的变更集,关联产生冲突时的代码变更集单据。

  1. 代码在本地构建通过后才能交付至代码库。

  2. 所有提交发布流(分支)、受控流(分支)的代码需经复审后才可正式提交。各代码流(或分支) 的具体管理要求请遵照发布文档《YG-CMMI-CM-PD04 配置管理规范(试行).pdf》中涉及的关于代 码管理的所有原则。

  3. 公司产品研发部门所有代码库的发布流(分支)、受控流(分支),原则上由配置管理工程师统一

创建和管理。

  1. 未按以上原则进行代码提交和管理,造成代码问题的,依据公司相关规定进行处理。

4.2. 代码库管理工具的特性规范

4.2.1. CCClearCase提交代码规范

  1. 按单据号在研发管理平台上申请权限,由研发管理部部门经理审批后开通权限。

商密【中】

远光软件股份有限公司

代码提交规范

文件编号 发布日期

现行版本 页 次

YG-CMMI-CM-PD04 2023-04-06

2.1 第 5 页 共 6 页

  1. 开发工程师在 CC 中提交代码,选中要检出的文件,填写修改该文件的研发管理平台中单据号,如

果多个文件需要同时修改,则选中多个文件,一起检出,填写一个单号即可。

  1. 每次创建单号后CC 都会记录,提示框显示出来的单号如果正确,无需重新创建单号。如果没有,

创建即可。同一个单号修改多个文件,无需多次创建同一单号。

  1. 详细的 Clearcase 操作指南请参见附件《YG-CMMI-CM-GD01 ClearcaseLT 客户端操作指南.doc》。

4.2.2. GIT 提交代码规范

  1. GIT 代码库因其分支灵活的特点,无法进行统一管控,项目组因各种原因须建立个人分支,须邮件 向项目经理申请,项目经理审批通过后方可建立,对建立的个人分支,配置管理工程师不纳入整体 的代码流管理,项目组需妥善管控,并定期清理,由此类分支管理混乱造成代码问题及引发严重后 果的,依据公司相关规定进行处理。

  2. 详细的 GIT 操作手册请参见附件《YG-CMMI-CM-GD05 Git 使用手册-开发工程师》。

  1. 相关附件

《YG-CMMI-CM-GD04 Git 安装指南-开发工程师》

《YG-CMMI-CM-GD05 Git 使用手册-开发工程师》

《YG-CMMI-CM-GD06 GAP 模块代码复审操作说明》

《RTC 操作手册-开发工程师》

  1. 相关文档

《YG-CMMI-CM-PD04 配置管理规范》

《YG-CMMI-CM-PD03 配置项标识规范》

《YG-CMMI-CM-GD01 ClearcaseLT 客户端操作指南》

  1. 附代码库明细表(供参考)

代码库明细表.xls

商密【中】