docs: 纠正 #7988 FAILED 态测试环境无法构造的成因——异步消费窗口过短,非灰度开关

原文错误引用了灰度开关,实际原因是 PENDING 在途窗口小于 2.6 秒、异步消费方
(GroupDispatchPlanRefreshOutboxListener,@Async + AFTER_COMMIT)在窗口内即完成,
导致测试环境构造不出停滞态;但生产环境可达。前端必须实现该分支。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot
2026-09-21 23:04:15 +08:00
共同撰写人 Claude Opus 5
父节点 d86979fbac
当前提交 25ee4c716f
@@ -271,7 +271,7 @@ Authorization: Bearer <token>
| **前端是否必须同步** | 是。新字段是告警判据的唯一来源,不同步则无法正确判停滞;`planRefreshStalled` 与 `planRefreshStalledReason` 必须实现 |
| **路径 / HTTP 方法** | 不变 |
| **入参 / 出参结构** | 只新增 7 个字段,不删不改既有字段 |
| **FAILED 态生产可达** | 是。生产环境灰度开关尚未开启(属独立运维动作),但 FAILED 态的业务逻辑已就绪;前端**必须**把 `planRefreshStalled=true + planRefreshStalledReason=STATE_FAILED` 这条分支实现出来,不要因为测试环境造不出来就跳过 |
| **FAILED 态生产可达** | 是。`FAILED` 态在测试环境中无法构造(刷新在途窗口过短,异步消费方在窗口内即完成),但**生产环境可达**。前端**必须**实现 `planRefreshStalled=true` + `planRefreshStalledReason=STATE_FAILED` 这条分支 |
| **性能影响** | 极小。七个字段由既有表直读或实时计算,无新 JOIN、无新子查询 |
| **下游兼容** | 安全。字段全是观测投影,无外发依赖 |