msgexchange-v2/docs/user-stories-todo.md

# 用户故事文档整改 TODO

> 本清单只跟踪文档收敛；实现任务仍由对应 Plane 工作项管理。新建 Plane 汇总项会与
> ACM2-15～22 重复，因此在确认合并策略前不重复创建。

## P0：先消除范围冲突

- [x] **ACM2-16 — RESP/DNLD 路由**：在 `user-stories.md` 增加报文路由矩阵；RESP/DNLD
  共用 SnapshotFlow，RESP 成功后再完成匹配的 RQFD 请求；ADFT 保持增量 Handler。
- [x] **ACM2-17 — 阶段边界**：ARCHIVE 独立为阶段 A US-11；HISTORY_SWEEP 独立为
  DEFERRED US-15，不作为阶段 A 切流门禁。
- [x] **ACM2-19 — 信箱回填**：新增 US-09，区分 PG 终态与共享信箱回填，覆盖提交后执行、
  持久化补偿、告警、影子禁写和双跑写权。
- [x] 将以上目标态同步回 Plane 架构权威（ACM2-3 / ACM2-16 / ACM2-17 / ACM2-19 已裁定并回写）；仓库文档与 Plane 口径一致。

## P1：补齐遗漏能力

- [x] **ACM2-15**：新增 ignoreMsg US-04，固定匹配位置、规则、SKIPPED 终态及回填依赖。
- [x] **ACM2-18**：新增实时查询 US-12、21 类 REF US-13、机位/登机桥 US-14；明确
  admin-api 21 类、现役 2 类与 AODB 15 类请求是不同集合。
- [x] **ACM2-20**：增加五个 legacy HTTP 端点的 KEEP/修正/不做矩阵。
- [x] **ACM2-21**：US-03 仅依赖 US-01；补 FAILED 占队头、毒丸与作业窗口，业务例外移至 US-05。

## P2：统一证据与可验收性

- [x] US-01 定义 watermark 快路径和补偿重扫，并注明当前 `afterId=0` 实现差距。
- [x] US-07（原请求故事）依赖补入采集和处理；重编号后为 US-08。
- [x] Kafka 旧 Broker 降级移至待确认，不再作为无权威出处的验收条件。
- [x] MALFORMED 重放统一为“跳过并返回逐项结果”，与 `ReplayService` 语义一致。
- [x] 将原 US-10 拆成 OPS-1～OPS-4，不再用“满足约定/评审”作单项验收。
- [x] 产品确认 `user-stories.md §7` 的八项开放问题，并把答案写回对应故事。
- [x] 文档定案后更新 Plane 关联项状态（ACM2-15～22 全部推进至 Todo，定案评论已写回）；没有发布证据时不得标记 Done。

## P3：二轮审查文档修复（ACM2-23～27）

- [x] **ACM2-23**：Kafka 生产契约 vs README 降级指南对齐（README 删生产降级 env；US-07/§7-6 增补 Broker 版本确认依赖）。
- [x] **ACM2-24**：消除 US-06 ↔ US-08 循环依赖（US-08 移除 US-06 依赖，AC6 改为集成验收）。
- [x] **ACM2-25**：US-02 ResponseDto 失败字段对齐 legacy（`err_code`/`err_msg`，不用 `msg`）。
- [x] **ACM2-26**：US-09 STATUS 值域定案（单值矩阵 + 库方确认依赖 + §7-9）。
- [x] **ACM2-27**：分区键 SNDR 固化、US-11/design §3.5 默认 1 天可配 1～7 天、小节末空行。
- [x] **ACM2-14**：取消并 relates_to ACM2-22（与 ACM2-22/23～27 重叠收束）。
- [x] **ACM2-22**：写入二轮审查闭环评论（已验证属实 + 新发现 1～5 + ACM2-23～27）。

## 验证清单

- [x] `architecture.md`、`design.md`、`user-stories.md` 的 RESP/DNLD 和阶段表述一致。
- [x] README 指向新的故事范围。
- [x] Markdown 变更通过 `git diff --check`。
- [x] Plane ACM2-23～27 已 commit 后转 Done（346929e）。
- [ ] 实现尚未随本文修改；后续代码 PR 必须补 FIFO、快照、回填和双库集成测试。