# AI 核心业务统一引擎迁移 — 阶段收口

> 日期：2026-06-22
> 状态：AI 核心业务迁移阶段 — **DONE**
> HEAD：`e769d67`

---

## 1. 最终状态

```text
AI 核心业务统一引擎迁移：  DONE  ✅
生产灰度：                  PENDING
Legacy 退役：               PENDING
```

---

## 2. 里程碑结果

| 里程碑 | 能力 | 状态 | GATE | PASS Commit |
|--------|------|:---:|:---:|------------|
| M-AI-03 | Unified Job Engine / Registry / Outbox | PASS | PASS | `4915111` |
| M-AI-04 | Active Recall 迁移 | PASS | PASS | `a5ad0bc` |
| M-AI-05 | Feynman 迁移 | PASS | PASS | `f1e529b` |
| M-AI-06 | ReviewCard Child Job | PASS | PASS | `297c4c1` |
| M-AI-07 | Quiz Generation 迁移 | PASS | PASS | `62f324a` |
| M-AI-08 | Learning Analysis 迁移 + AI 闭环 | PASS | PASS | `fe277b4` |

---

## 3. AI Workflow 最终分类

| 分类 | 数量 | 明细 |
|------|:---:|------|
| 已迁移 Unified Engine | 6 | Active Recall, Feynman, ReviewCard, Quiz, Learning Analysis, Synthetic |
| Legacy 保留（待退役） | 4 | AiAnalysisWorker, ReviewCardSubscriber, RuntimeInternalService, External Runtime |
| 明确延期（非核心） | 5 | Learning Trend, Knowledge Import, RAG Chat, Vector Rerank, Admin Chat |

---

## 4. 当前生产策略

```text
Legacy 暂时保留            ← 全量默认
Unified 仅允许白名单灰度    ← Feature Flag + userId whitelist
Unified 失败不得自动 fallback Legacy
同一次请求不得双执行
已创建 Unified Job 必须继续完成
所有 Flag 可独立回滚
```

---

## 5. 当前禁止事项

```text
不得删除 Legacy Worker
不得删除 ReviewCardSubscriber
不得删除旧 Queue（ai-analysis）
不得将 Unified 直接全量开启
不得因迁移完成而跳过生产观测期
```

---

## 6. 阶段命名

```text
M-AI-03 ~ M-AI-08：   核心 AI 业务统一引擎迁移
M-AI-HARDENING：      生产灰度、运行可靠性、监控和成本治理
M-AI-RETIRE：         Legacy 流量清零、观察期和退役

M-AI-09 不再作为业务迁移里程碑。原 M-AI-09 "Heavy Runtime 退场"
已重命名为 M-AI-RETIRE-01。
```

---

## 7. Feature Flag 现状

| 能力 | Flag | 默认值 | Unified 值 | 白名单 |
|------|------|--------|-----------|:---:|
| Active Recall | `ACTIVE_RECALL_ENGINE_MODE` | legacy | unified | ✅ |
| Feynman | `FEYNMAN_ENGINE_MODE` | legacy | unified | ✅ |
| ReviewCard | `FEYNMAN_REVIEW_CARD_MODE` | legacy_event | child_job | ✅ |
| Quiz | `QUIZ_GENERATION_ENGINE_MODE` | legacy | unified | ✅ |
| Learning Analysis | `LEARNING_ANALYSIS_ENGINE_MODE` | legacy | unified | ✅ |

所有 Flag 生产默认值均为 Legacy。白名单通过 `FeatureFlagService.isEnabled(name, userId)` 控制。

---

## 8. 下一阶段

```text
M-AI-HARDENING：
  Stage 0：内部开发账号
  Stage 1：内部真实数据
  Stage 2：1% 白名单
  ...
  Stage 6：100%

M-AI-RETIRE：
  Legacy 流量清零 → 观察期 → 退役
```