api-server/docs/operations/ai-unified-rollout-plan.md
wangdl 1f2d7825e7
All checks were successful
Deploy API Server / build-and-unit (push) Successful in 40s
Deploy API Server / current-integration (push) Successful in 30s
Deploy API Server / backward-compat (push) Successful in 0s
Deploy API Server / deploy (push) Successful in 1m3s
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

66 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# AI Unified Engine 生产灰度计划
> 日期2026-06-22
> 状态:计划阶段 — 尚未执行
---
## 阶段定义
| 阶段 | 范围 | 最短观察期 | 进入条件 |
|------|------|----------|---------|
| Stage 0 | 内部开发账号 | 1 天 | M-AI-08 PASSCI 全绿 |
| Stage 1 | 内部真实数据 | 3 天 | Stage 0 无 P0/P1 |
| Stage 2 | 1% 白名单 | 7 天 | Stage 1 无 P0/P1 |
| Stage 3 | 5% | 7 天 | Stage 2 无 P0/P1 |
| Stage 4 | 20% | 14 天 | Stage 3 无 P0/P1 |
| Stage 5 | 50% | 14 天 | Stage 4 无 P0/P1 |
| Stage 6 | 100% | 30 天 | Stage 5 无 P0/P1 |
---
## 每阶段观察指标
| 指标 | 正常范围 | 告警阈值 |
|------|---------|---------|
| Job 创建成功率 | > 99% | < 95% |
| queuedrunning 延迟 | < 5s | > 30s |
| running→succeeded 时长 | 按 Job Type 定义 | > timeoutMs |
| succeeded rate | > 95% | < 85% |
| failed rate | < 5% | > 10% |
| retry rate | < 3% | > 10% |
| Outbox 发布延迟 | < 1s | > 10s |
| 重复 Artifact 数量 | 0 | > 0 |
| Token 成本偏差 | < 10% | > 30% |
| 跨用户安全事件 | 0 | > 0 |
---
## 暂停条件
- 任一 P0 问题
- 任一 P1 问题且未在 1 小时内修复
- failed rate 超过告警阈值
- 成本偏差超过 50%
- 跨用户数据泄漏
---
## 回滚操作
```text
1. 修改对应 FeatureFlag: enabled = false
2. 新请求立即走 Legacy
3. 已创建 Unified Job 继续完成
4. 已生成产物保留
5. 无需数据库回滚
```
---
## 数据负责人
- 每阶段指定一名值班人员
- 记录每日指标快照
- 异常 30 分钟内升级