1f2d7825e7
- Inventory: updated with M-AI-08 PASS as baseline, Legacy retention details - Closure: all 6 milestones PASS commits recorded, feature flag matrix - Rollout plan: 7-stage progressive rollout with metrics & rollback - Gitea: M-AI-09 renamed to M-AI-RETIRE-01 - Stage naming: M-AI-HARDENING + M-AI-RETIRE for post-migration phases AI core business migration stage: DONE Next stage: production grayscale rollout (M-AI-HARDENING) Co-Authored-By: Claude <noreply@anthropic.com>
107 lines
2.9 KiB
Markdown
107 lines
2.9 KiB
Markdown
# 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 流量清零 → 观察期 → 退役
|
||
```
|