wangdl/api-server
2
0
Fork 0
Code Issues 28 Pull Requests Actions Packages Projects Releases Wiki Activity
api-server/docs/architecture/m-ai-business-migration-closure.md
wangdl 1f2d7825e7
All checks were successful
Deploy API Server / build-and-unit (push) Successful in 40s
Details
Deploy API Server / current-integration (push) Successful in 30s
Details
Deploy API Server / backward-compat (push) Successful in 0s
Details
Deploy API Server / deploy (push) Successful in 1m3s
Details
docs(ai): close unified business migration phase 
- 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>
2026-06-22 22:19:37 +08:00

2.9 KiB
Raw Blame History

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

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

1. 最终状态

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. 当前生产策略

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

5. 当前禁止事项

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

6. 阶段命名

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. 下一阶段

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

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