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

用户故事文档整改 TODO

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

P0：先消除范围冲突

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

P1：补齐遗漏能力

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

P2：统一证据与可验收性

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

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

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

验证清单

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