# Codeup研发资产集成

## 目录

1. 仓库覆盖
2. 分支策略
3. 正式关联
4. 提交与合并请求
5. CI01多仓库门禁
6. 验证场景

## 1. 仓库覆盖

前端、后端均可触发研发自动化，前提是仓库接入正确项目，分支/提交/MR正式关联需求，规则没有错误限定到单一仓库。

逐仓库记录：仓库名、角色、项目集成状态、Webhook、实际集成分支、是否纳入全部MR门禁和观察证据。

## 2. 分支策略

- 检查真实集成分支：存在`dev`则优先`dev`，否则使用存在的`develop`。
- 从集成分支创建`feature/<WORK-ITEM-ID>`或`fix/<WORK-ITEM-ID>`。
- 一个需求涉及多个仓库时，每个仓库可有一个同名活动分支。
- 快速迭代仍使用短生命周期分支；合并后是否删除按仓库策略和用户授权处理。
- 不直接推送保护分支，不为自动化方便创建不存在的`dev`/`develop`。

## 3. 正式关联

关联优先级：

1. 从需求“代码”区域创建分支并回到需求确认资产数量。
2. 在Codeup创建分支/MR时显式选择工作项；存在开发任务时同时关联需求和开发任务。
3. 使用以工作项ID结尾的分支名，并在需求页确认自动关联。
4. 提交说明关键字仅作兜底，必须回需求页验证。

需求编号、分支名或MR标题有关键字，不等同已正式关联。

## 4. 提交与合并请求

- 提交可带工作项ID增强追溯，但不判定开发完成。
- MR目标必须是仓库真实集成分支。
- MR显式关联需求和对应开发任务并完成评审。
- 只有全部相关MR合并后才观察R08。
- 首次提交时间不作为真实开发开始时间；人工“开始开发”为效能主口径。

## 5. CI01多仓库门禁

CI01要求所有相关前后端仓库的分支、提交和MR都正式关联需求与对应开发任务。只遗漏一个仓库或只关联需求，平台的“全部MR已合并”就可能只看到部分资产、提前完成需求，或完全无法完成开发任务。

如果无法可靠聚合所有仓库，保留人工核对门禁，不能声称R08已完全自动化。

## 6. 验证场景

| 场景 | 操作 | 期望 |
|---|---|---|
| 正式关联分支 | 从需求代码区创建真实仓库分支 | 异步进入开发中 |
| 非关联分支 | 仅本地创建/推送无关系分支 | 不触发R07 |
| 仅有提交 | 提交代码但不合并MR | 不进入开发完成 |
| 单仓库MR | 所有相关仓库只有一个MR合并 | 仍保持开发中 |
| 多仓库全部合并 | 所有相关MR正式关联并合并 | 进入开发完成 |
| 错误集成分支 | MR指向非真实集成分支 | 阻塞并修正，不伪造通过 |