docs: 按代码现状收敛 architecture/design/user-stories 口径并对齐 flight-state 口吻
- design.md：删除已退场 PUMP_JOB/Handler/Decision 等引用，改按 ScheduleProcessor 与 DynamicProcessors 实际分派描述；补 PROTOCOL 错误类与 RESP 守卫缺口；实现入口与 §10 差异清单按 HEAD 代码重写 - architecture.md：修正悬空章节引用；关键决策删减为仍具约束价值的 4 条并连续编号 D1–D4， 补当前状态列 - user-stories.md：逐条更新 US 当前基础与落点，清理已不存在的文件与旧叙事，Handler 术语统一 - README.md：实现核对日期更新至 2026-09-09（基线 d53a0a1） flight-state.md 与 docs/legacy/ 保持原样。
This commit is contained in:
windyboy
+30
-30
@@ -2,7 +2,7 @@
|
||||
|
||||
## 1. 如何使用本文
|
||||
|
||||
本文是把现有脚手架补成可用系统的实施入口：**故事定义要交付什么，验收标准定义怎样证明完成，代码落点说明从哪里改起**。保留 US-01～US-15、OPS-1～OPS-4 编号，便于关联已有任务和测试。
|
||||
本文定义阶段 A 的实施范围与验收口径：**故事定义要交付什么，验收标准定义怎样证明完成，代码落点说明从哪里改起**。保留 US-01～US-15、OPS-1～OPS-4 编号，便于关联已有任务和测试。
|
||||
|
||||
- 系统边界见 [architecture.md](architecture.md)，模块流程见 [design.md](design.md)。本文不重复设计全文，也不以工单状态代替代码验收。
|
||||
- “当前基础”来自本轮代码核对，只表示有接口或部分实现，不表示故事完成。`KEEP` 是保留业务兼容，`FIX` 是明确修正旧缺陷，`DEFERRED` 不进入阶段 A。
|
||||
@@ -26,7 +26,7 @@
|
||||
| S5：运维恢复 | US-10、US-11，完成 OPS-1～OPS-3 | 安全重放、归档后去重、故障告警、单写者保护、影子禁写均有验证证据。 |
|
||||
| S6：上线验证 | OPS-4，复核所有进入切流范围的故事 | 对拍、故障演练、配置和恢复 Runbook 验收后切流；US-15 不作为门槛。 |
|
||||
|
||||
**依赖口径**：US-03 是基础管道，不依赖具体业务 Handler；US-09 依赖其终态提交接口，US-04 复用 US-09。US-08 的请求登记与匹配基础不依赖 US-06；US-06 消费该基础，二者共同完成 RESP 集成验收，不形成开发依赖环。US-05 只有 PSDT 子范围依赖 US-14，不应阻塞其余 Handler。
|
||||
**依赖口径**：US-03 是基础管道，不依赖具体业务处理器；US-09 依赖其终态提交接口，US-04 复用 US-09。US-08 的请求登记与匹配基础不依赖 US-06；US-06 消费该基础，二者共同完成 RESP 集成验收，不形成开发依赖环。US-05 只有 PSDT 子范围依赖 US-14，不应阻塞其余处理器。
|
||||
|
||||
## 3. 阶段 A 用户故事
|
||||
|
||||
@@ -42,7 +42,7 @@
|
||||
4. PG 不可用或批次中途失败时不改信箱标记；恢复后补建遗漏，记录失败次数与扫描进度。
|
||||
5. 较小 ID 迟提交、ID 有空洞、兼容入口先入队较大 ID 时，必须遵守经 Q2 确认的发现与顺序协议；不能用“最终会重扫”冒充严格 FIFO。
|
||||
|
||||
**当前基础与落点**：`ingress/InboxPoller.kt`、`InboxEnqueue.kt`、`infra/persistence/jdbc/JdbcCminmsgInboxRepository.kt` 已有轮询和判重；固定 `afterId=0`，水位与补偿未实现。扩展 `InboxPollerTest`，补真实 PG/MySQL 中断恢复测试。
|
||||
**当前基础与落点**：`ingress/InboxPoller.kt`、`InboxEnqueue.kt`、`infra/persistence/jdbc/JdbcCminmsgInboxRepository.kt` 已有轮询与判重；固定 `afterId=0` 全量扫描，水位与补扫策略未实现（每轮顺带对账回填待办，见 US-09）。扩展 `InboxPollerTest`，补真实 PG/MySQL 中断恢复测试。
|
||||
|
||||
**前置**：共享库读契约；Q2 决定严格顺序的端到端验收。
|
||||
|
||||
@@ -72,7 +72,7 @@
|
||||
|
||||
**目标**：报文失败和重试不造成航班状态倒序，也不重复产生副作用。
|
||||
|
||||
**实施拆分**：调度与时钟 → 安全解码及路由 → 身份绑定 → 状态应用与 PG 提交。先用假 Handler 验证管道，不等 US-05 全部实现。
|
||||
**实施拆分**：调度与时钟 → 安全解码及路由 → 身份绑定 → 状态应用与 PG 提交。先用假处理器验证管道，不等 US-05 全部实现。
|
||||
|
||||
**验收标准**
|
||||
|
||||
@@ -80,12 +80,12 @@
|
||||
2. 安全解码 XML，至少覆盖 META、SCHD、FLOP、参考应答与忽略类路由；合法但能力未支持是 `UNSUPPORTED`，不能一律归为非法报文。保留原文以支持诊断和回放。
|
||||
3. 解码后首次绑定 `SNDR|TYPE|STYP|SEQN`；冲突转 `SKIPPED` 并记录原 ID；自身重试保留绑定。生产 `include-day-boundary=false`，更改算法须另行评审上游序号规则。
|
||||
4. `MALFORMED` 直接 `DEAD`；`CODEC_ERROR / UNSUPPORTED / INFRA` 按次数和退避处理，耗尽转 `DEAD(EXHAUSTED)`。不能无限重试未实现类型，也不能立即当非法报文丢弃。
|
||||
5. HOL deadline 使用稳定的 `PROC_STATE.CREATED_AT`，不使用每次重试刷新的 `updatedAt`；所有调度判断注入 `Clock`。默认 5 次重试、10 分钟滞留限制；积压与人工重放的 deadline 边界按 Q6 验证。
|
||||
5. HOL deadline 必须基于稳定起始时刻（必要时在 `PROC_STATE` 增加入队时间列），不能用每次重试刷新的 `updatedAt` 代替；调度判断注入 `Clock`。默认 5 次重试、10 分钟滞留限制；积压与人工重放的 deadline 边界按 Q6 验证。
|
||||
6. 主泵在同一 PG 事务提交航班主表/明细、事件与处理结果；终态回填意图通过 US-09 同事务保存。任一步失败整体回滚；提交后只重试外部回填，不重复生成业务事件。
|
||||
7. Handler 只返回 `Decision`，副作用由管道执行；失败只在持有消息上下文的边界落账，中断向上传递，不作为普通失败吞掉。
|
||||
7. 处理器只读取当前完整态、计算下一态，并把状态写入、事件与终态提交收敛在同一事务边界内，不直接触碰 Kafka；失败只在持有消息上下文的边界落账，中断向上传递，不作为普通失败吞掉。
|
||||
8. 权威存储不可用或未完成恢复时停止业务处理；不能把“整个状态丢失”误判为“单航班不存在”而批量成功结束增量报文。
|
||||
|
||||
**当前基础与落点**：`processing/Pump.kt`、`Identity.kt`、`codec/JacksonXmlCodec.kt`、`infra/retry/`、`JdbcPgRepositories.kt`。已有 PG 共享事务、身份/重试及 GTDT XML 链路；完整 SCHD 解码/路由、时钟与 deadline、同事务回填意图仍未完成。
|
||||
**当前基础与落点**：`processing/Pump.kt`（含 `MessageProcessor`）、`DynamicProcessors.kt`、`Identity.kt`、`codec/JacksonXmlCodec.kt`、`infra/retry/`。严格 FIFO 主泵、SCHD（DNLD/RESP/ADFT）/FLOP/FDEL 处理器、PG 单事务（含回填待办预登记）、身份绑定与重试已实现。尚未完成：忽略规则分支（US-04）、基于稳定起始时刻的滞留判据与可注入时钟、以及逐类矩阵与 golden 样例（US-05）。
|
||||
|
||||
**前置**：US-01；Q1 已定单库方向，Q6 决定 deadline 边界。数据库迁移只落自有库。
|
||||
|
||||
@@ -95,11 +95,11 @@
|
||||
|
||||
**验收标准**
|
||||
|
||||
1. 解码 META 后、身份绑定及业务 Handler 查找前，大小写不敏感匹配 `TYPE-STYP` 或 `TYPE-*`；基线为 `LDM-* / REGN-* / RSTA-* / EROR-*`，不混用 `ERROR`。
|
||||
1. 解码 META 后、身份绑定及处理器分派前，大小写不敏感匹配 `TYPE-STYP` 或 `TYPE-*`；基线为 `LDM-* / REGN-* / RSTA-* / EROR-*`，不混用 `ERROR`。
|
||||
2. 命中后转 `SKIPPED`，记录 `ignored:<rule>` 和计数；不更新航班、不创建业务通知。
|
||||
3. 通过 US-09 保存回填意图；命中、未命中、大小写和重扫均有测试。合法忽略报文不应因 `MsgKind` 尚不能表达它而先解码失败。
|
||||
|
||||
**当前基础与落点**：`MessageProcessor` 尚无忽略分支，`DecodedMessage/MsgKind` 主要覆盖 SCHD/FLOP；扩展解码与路由，不把忽略逻辑散落到 Handler。
|
||||
**当前基础与落点**：`MessageProcessor` 尚无忽略分支；`MsgKind` 已有 SCHD/FLOP/FDEL/Unsupported 分派。在解码后的路由边界补忽略匹配，不把规则散落到各处理器。
|
||||
|
||||
**前置**：US-03 解码/终态接口、US-09。
|
||||
|
||||
@@ -109,14 +109,14 @@
|
||||
|
||||
**验收标准**
|
||||
|
||||
1. `SCHD-ADFT` 与 29 个 FLOP 子类型逐项列入覆盖矩阵，每项有纯函数 Handler；未知类型可恢复失败。RESP/DNLD 不计入这批 Handler，走 US-06。
|
||||
1. `SCHD-ADFT` 与 29 个 FLOP 子类型逐项列入覆盖矩阵，每项有对应的处理器规则与回归测试；未知类型可恢复失败。RESP/DNLD 不计入这批处理器，走 US-06。
|
||||
2. 每类固定“输入与前态 → 后态 → msg → schd → 终态”五面样例；区分字段缺失、显式清空、重复报文和主/共享航班。清单和 golden 样例按 Q8 补齐，不以“已写 29 个类”替代验收。
|
||||
3. 对按 KEEP 规则需忽略的不存在航班，以 `SUCCEEDED` 无副作用结束，并由 US-09 回填；ADFT 建航班等行为按各类型矩阵执行。在 ACM2-28 运营航班落自有 PG 后，Redis 全损导致报文持续终结与白名单无法找回的 F1 损坏路径已被根除，PG 作为唯一权威重启即恢复。
|
||||
3. 对按 KEEP 规则需忽略的不存在航班，以 `SUCCEEDED` 无副作用结束，并由 US-09 回填；ADFT 建航班等行为按各类型矩阵执行。航班当前态以自有 PG 为唯一权威，重启即恢复，不存在 Redis 全损后白名单无法找回的损坏路径。
|
||||
4. 共享航班通常更新并通知主航班，不直接发共享通知。FDEL 删除共享航班时更新主航班 MAFL 并通知；删除主航班时删除主航班及其子共享关联并发删除通知；目标不存在幂等成功。
|
||||
5. ADFT/FDEL 使用值相等比较；主/共享关系一次原子变更，不出现主已删、子残留等半状态。
|
||||
6. PSDT 通过 US-14 的只读映射计算 `abdg`，Handler 不直接调用 admin-api。
|
||||
6. PSDT 通过 US-14 的只读映射计算 `abdg`，处理器不直接调用 admin-api。
|
||||
|
||||
**当前基础与落点**：`processing/Handler.kt`、`domain/Decision.kt`、`infra/persistence/FlightSchdRepository.kt` 为主要落点；变更直接入自有 PG 事务 2。按类型新增 Handler 与同包测试。
|
||||
**当前基础与落点**：落点已变为 `processing/DynamicProcessors.kt`（`FlopProcessor`/`FdelProcessor`/`AdftProcessor`）与 `domain/flight/FlightStateEngine`、`FlightStateRepository`。FDEL/ADFT 与通用 FLOP 处理器已接入（含 DELETED 幂等与重激活、tombstone 同事务登记）；29 类逐类语义矩阵与 golden 样例仍未补全，不能因处理器存在就视为覆盖完成。
|
||||
|
||||
**前置**：US-03；PSDT 另依赖 US-14；Q1、Q8。
|
||||
|
||||
@@ -128,7 +128,7 @@
|
||||
|---|---|---|---|
|
||||
| `SCHD-DNLD` | ScheduleProcessor | 不更新请求 | 不要求开放请求 |
|
||||
| `SCHD-RESP` | 匹配守卫后进入 ScheduleProcessor | 成功提交时匹配 RQFD → DONE | SKIPPED、审计，禁止更新快照 |
|
||||
| `SCHD-ADFT` | US-05 增量 Handler | 不更新请求 | 不适用 |
|
||||
| `SCHD-ADFT` | US-05 增量处理器 | 不更新请求 | 不适用 |
|
||||
|
||||
**验收标准**
|
||||
|
||||
@@ -137,7 +137,7 @@
|
||||
3. 在自有 PG 单事务内，批处理写入已校验的 `FLIGHT_SCHD` 航班状态与资源明细；本次日计划中未出现的航班不因此被删除。
|
||||
4. 在同一 PG 事务中提交 `FLIGHT_SCHD` 变更、`MSG_EVENT` 待发通知与 `PROC_STATE(SUCCEEDED)`；匹配 RESP 同事务完成请求并置 `DONE`；事务提交后执行信箱回填。
|
||||
5. 相同报文重放不二次写入或重复发事件；单事务崩溃整体回滚，重放幂等。
|
||||
**当前基础与落点**：主处理只分流 DNLD；需补 RESP 路由、`REQ_TRACK` 应答关联字段和事务测试。
|
||||
**当前基础与落点**：DNLD 与 RESP 已共同路由到 `processing/ScheduleProcessor.applyScheduleRecords`，整包校验、归属日冲突整包拒绝与单事务写入已实现；`REQ_TRACK` 表与 `ReqTrackRepository` 已建。仍需补 RESP 应答守卫（开放 RQFD 匹配、时间比对）与请求完成关联逻辑。
|
||||
|
||||
**前置**：US-03、US-08 请求登记/匹配基础；Q1、Q5。
|
||||
|
||||
@@ -150,11 +150,11 @@
|
||||
1. `KAFKA:msg` 按目标内 `EVENT_ID` 顺序发送，确认后才标 `SENT`；队头退避时不跳过，发送有超时上限。
|
||||
2. `KAFKA:schd` 只通过 `flushSchd` 聚合，默认 3 秒/500 条；同一 FLID 取批内最新状态，成功确认覆盖对应原事件，失败保持批次可恢复并退避，耗尽可见为 `DEAD`。
|
||||
3. 外部接收成功、本地确认失败或进程重启后允许重发；事件标识跨重发稳定，消费者有去重约定，不宣称端到端恰好一次。
|
||||
4. msg 的目标分区键为 `SNDR`。schd 的聚合粒度与分区键先按 Q4 定案，明确哪些顺序只在单分区成立；不能把多航班数组声称为“每个 FLID 都是该 Kafka record 的 key”。
|
||||
4. 当前 `KAFKA:msg` 与 `KAFKA:schd` 的分区键均为 `FLID`，schd 逐 `FLID` 发送最新状态，不再是 legacy 的多航班数组。`msg` 是否需按 `SNDR` 分区、发送粒度与去重标识的放置以 Q4 定案为准；定案前不宣称单分区之外的顺序保证。
|
||||
5. 生产强制 `acks=all`、`enable.idempotence=true`、`max.in.flight.requests.per.connection=1`；Broker 支持幂等生产协议并完成实际验证，不允许非幂等降级通过验收。
|
||||
6. 普通/聚合发送失败、确认丢失、批次标记中断和目标阻塞均有测试；DEAD 保留记录并告警。
|
||||
|
||||
**当前基础与落点**：`delivery/Dispatcher.kt`、`SchdAggregation.kt` 已有聚合和重试测试；`DeliveryPort.sendKafka` 仅接 topic/payload，无 key 或事件标识参数，真实生产适配与强制配置校验需补齐。
|
||||
**当前基础与落点**：`delivery/Dispatcher.kt` 已实现逐条 `KAFKA:msg` 与 `flushSchd` 聚合（按 `FLID` 合并最新 `STATE_VERSION`、TOMBSTONE 发 null）以及退避/DEAD 迁移；`DeliveryPort` 接口含 topic/key/事件类型参数。生产 Kafka 适配器未交付（仅 stub），强制配置校验与真实 Broker 验证需补齐。
|
||||
|
||||
**前置**：US-03 事件提交；Q4、现网 Broker 验证。wire 不兼容的标识字段不能直接加到现役载荷。
|
||||
|
||||
@@ -173,7 +173,7 @@
|
||||
5. 迟到、无匹配或已关闭请求的应答不得更新数据，转 `SKIPPED` 并审计。参考应答成功写入 REF_MASTER 后，与请求完成、处理终态和事件在 PG 边界内保持所需原子性。
|
||||
6. `POST /schd/sync` 复用请求入口，采用 24 小时制和非空/区间校验；响应明确已登记还是已落信，不承诺计划已更新。
|
||||
|
||||
**当前基础与落点**：`reference/RequestCoordinator.kt`、`ReqTrackRepository` 和 JDBC 表已存在；当前真实出站未实现就标发送，回显匹配和超时未闭环。需补 COUTMSGS 适配器、编码、并发约束、应答路由与故障测试。
|
||||
**当前基础与落点**：`ReqTrackRepository` 与 JDBC 实现、`REQ_TRACK` 表已存在；运行时协调器、`COUTMSGS` 出站适配与请求编码未实现（`XmlCodec.encodeRqrd` 仅占位），超时与应答匹配未闭环。需补协调器、出站适配、并发约束、应答路由与故障测试。
|
||||
|
||||
**前置**：US-01、US-03；Q5、Q8、出站信箱去重契约。请求基础不依赖 US-06。
|
||||
|
||||
@@ -189,7 +189,7 @@
|
||||
4. 重复补偿效果幂等，保留稳定的完成时间与审计；重放后的新处理结果不能被旧回填任务覆盖。非法报文缺 META 时也有明确回填方式。
|
||||
5. 影子模式禁写，双跑仅一个系统持有标记写权；暴露 PG 终态、回填状态、积压、最老年龄与持续失败告警。
|
||||
|
||||
**当前基础与落点**：`backfillOnSuccess` 当前仅同步写 `PROCESSED`，无持久意图。补自有 PG 意图模型/迁移、事务提交入口和独立补偿执行器；不在共享库新增补偿表。
|
||||
**当前基础与落点**：回填意图已在业务事务内预登记到自有 `BACKFILL_TODO`；提交后同步回填（写 `DATE_PROCESSED` 与 `PROCESSED`），失败由 `BackfillSweepJob` 到期重试（每 30 秒、指数退避）。剩余缺口：缺 META 或解码失败的死信回填方式，以及“待办落账后再失败 / 提交后崩溃”两个窗口的补偿闭环。
|
||||
|
||||
**前置**：US-03 终态接口；Q7、共享库更新权限。测试覆盖四类终态、事务回滚、重复补偿和重放竞争。
|
||||
|
||||
@@ -205,7 +205,7 @@
|
||||
4. DEAD 之后可能已有新状态，必须预检版本与覆盖风险；不安全时拒绝直接重放，改用经批准的隔离重建或恢复流程，禁止无保护的全量 `replayAll` 生产入口。
|
||||
5. 操作有认证、授权、范围限制与审计；死信、持续补偿失败、队列年龄越界有告警和处理 Runbook。
|
||||
|
||||
**当前基础与落点**：`infra/retry/ReplayService.kt` 仅按错误类批量重排并返回数量；需补按记录选择、预检、操作审计和管理入口，扩展 `ReplayServiceTest`。
|
||||
**当前基础与落点**：`infra/retry/ReplayService.kt` 已按错误类批量把 FAILED/DEAD 置回 `PENDING`（重置次数与下次执行时间，保留身份与错误审计）并返回数量；需补按记录选择、版本/覆盖预检、操作审计和管理入口，扩展 `ReplayServiceTest`。
|
||||
|
||||
**前置**：US-03、US-09 的恢复状态；Q6、OPS-1/OPS-2 的安全与可观测基础。
|
||||
|
||||
@@ -220,7 +220,7 @@
|
||||
3. 迁移与删除在自有库事务内完成，重复执行幂等；失败保留源记录并报告计数。归档后同信箱 ID/业务身份再次到达，仍能按约定去重。
|
||||
4. 不写共享 MySQL `CMINMSGS_HST`，不清理外部信箱；原文可用性与重放保留期由 Q7/Q8 关联确认。
|
||||
|
||||
**当前基础与落点**：`jobs/JobExecutor.kt`、`PumpJobRepository` 为入口；当前迁移无归档表。先确定去重记录保留与关联策略，再补迁移及归档中断测试。
|
||||
**当前基础与落点**：`PROC_STATE_HST` 未建表，也没有归档处理记录的作业；先确定去重记录保留与关联策略，再补迁移与归档中断测试。航班历史清理（`HistorySweepJob`，属 US-15 红线范围）与本文档处理记录归档不是同一件事，不能混为一谈。
|
||||
|
||||
**前置**：US-03、US-09；US-07 提供事件终态规则，US-10 提供恢复保留要求。不依赖 US-15。
|
||||
|
||||
@@ -230,11 +230,11 @@
|
||||
|
||||
**验收标准**
|
||||
|
||||
1. 保留 `GET /all/flights`，直接从自有 PostgreSQL `FLIGHT_SCHD` 查询（ACM2-28 定案：读源由 Redis 转为 PG），过滤 `MAID != NULL` 的共享航班；不改写业务状态。
|
||||
1. 保留 `GET /all/flights`，直接从自有 PostgreSQL `FLIGHT_SCHD` 查询，过滤 `MAID != NULL` 的共享航班；不改写业务状态。
|
||||
2. 固定响应样例、空结果、排序、大小限制及一致性时点。现役未分页时不能无声改为只返回第一页；分页或响应结构变更按 Q3 决定。
|
||||
3. 依赖异常不能伪装为空数组成功；影子只读影子状态，入口有约定的访问控制、限流与审计。
|
||||
|
||||
**当前基础与落点**：`InboxController.kt` 中仅有该接口 TODO；新增查询控制器与只读服务，复用权威读取端口，不能从空占位仓储返回成功。新增接口/状态不可用测试。
|
||||
**当前基础与落点**：`InboxController.kt` 仅有该接口的 TODO（阶段 2）；权威读取端口为 `FlightStateRepository` 的全量快照读取。新增查询控制器与只读服务，不能从空占位仓储返回成功，并补接口/状态不可用测试。
|
||||
|
||||
**前置**：Q1、Q3；所查询的 US-05/US-06 状态发布能力。
|
||||
|
||||
@@ -249,9 +249,9 @@
|
||||
3. 一类失败不破坏其他类或该类旧版本；同类由 AODB/admin-api 都提供时明确覆盖优先级，全量刷新时明确已删除项的处理，不能仅靠 SOURCE 日志解决冲突。
|
||||
4. 影子默认不主动刷新生产数据；需要参考样本时显式导入隔离副本。
|
||||
|
||||
**当前基础与落点**：`reference/ReferenceService.kt` 是空刷新入口，`JdbcStaticRefRepository` 有逐条 upsert；补客户端、类型清单、批次发布/事务和失败保旧测试。
|
||||
**当前基础与落点**：`reference/` 包与 `REF_MASTER` 表均未落地（无迁移、无客户端、无刷新服务）。按 Q8 清单从零补建：先固定 21 类端点与字段契约，再补客户端、批次发布/事务与失败保旧测试。
|
||||
|
||||
**前置**：admin-api 访问契约、Q8。可独立于消息 Handler 开发。
|
||||
**前置**：admin-api 访问契约、Q8。可独立于消息处理器开发。
|
||||
|
||||
### US-14 提供机位与登机桥映射
|
||||
|
||||
@@ -262,9 +262,9 @@
|
||||
1. 保留 `ORMS_STAND / ORMS_STAND_AIRBRIDGE` 两类，与 US-13 的 21 类分开统计；适配器拉取、完整校验后原子发布只读缓存。
|
||||
2. 近机位产生登机桥值，远机位或清空机位时 `abdg` 为空；一机位多桥、缺失映射与共享航班规则用 golden 固定。
|
||||
3. admin-api 不可用时使用最后可用版本；无可用版本或映射不完整时明确失败，不用空映射冒充正常清空，也不发布半批。
|
||||
4. Handler 输入包含所需只读参考视图，不允许其直接 HTTP 或写缓存。
|
||||
4. 处理器输入包含所需只读参考视图，不允许其直接 HTTP 或写缓存。
|
||||
|
||||
**当前基础与落点**：在 `reference/` 与 `infra/` 增加映射服务/适配器，必要时扩展 Handler 输入上下文；PSDT 测试使用固定映射，无需在线 admin-api。
|
||||
**当前基础与落点**：在 `reference/` 与 `infra/` 增加映射服务/适配器，必要时扩展处理器输入上下文；PSDT 测试使用固定映射，无需在线 admin-api。
|
||||
|
||||
**前置**：机位/桥数据契约及 Q8；不要求 US-13 全部完成。
|
||||
|
||||
@@ -272,9 +272,9 @@
|
||||
|
||||
### US-15 历史航班清场（DEFERRED，阶段 B）
|
||||
|
||||
历史存储确认成功后，才允许主泵删除对应实时航班；逐条隔离坏数据，不能删除写历史失败的集合。五条判史规则、业务时区 `Asia/Shanghai`、历史写入与删除事件之间的恢复协议需在启用前完成 golden 对拍。
|
||||
历史存储确认成功后，才允许删除对应实时航班；逐条隔离坏数据，不能删除写历史失败的集合。判史规则与保留期（`HistoryProps`）、业务时区 `Asia/Shanghai`、历史写入与删除事件之间的恢复协议需在启用前完成 golden 对拍。
|
||||
|
||||
阶段 A 不依赖 ES，不接通 `HISTORY_SWEEP / PROJECTION_REBUILD` 占位能力；没有历史写入能力时默认删除零条。不要因代码已有 B 枚举就启用它。
|
||||
阶段 A 不依赖 ES，不启用 `PROJECTION_REBUILD`。`HistorySweepJob` 已作为每日清理脚手架接入，但历史存储未接通（或 `history-store-enabled=false`）时删除 0 条；脚手架存在不等于清场已交付，红线见 flight-state.md §6。
|
||||
|
||||
## 5. 运行与切流验收
|
||||
|
||||
@@ -306,7 +306,7 @@
|
||||
| Q1 权威存储（方向已定） | 当前 PG 单库权威，主表 + 无损明细；现场供库目标为 Oracle 11g。 | 单库决策已采纳，Oracle 完整适配与部署验收仍待交付；不得退回 Redis 双写。 |
|
||||
| Q2 入队顺序 | 水位+补扫无法自动保证较小 ID 迟提交不越序；当前有限批扫描也可能被未回填记录挡住。 | 库方 ID/提交顺序约束，或明确的发现完整性与暂停/恢复协议；晚提交、空洞、兼容入口与重扫联合测试。不能凭空假定 ID 连续。 |
|
||||
| Q3 HTTP 契约 | 目标 ResponseDto 与现有 text/plain ID 不同；请求媒体类型目标已列出，错误码、状态码、查询格式等仍需对拍。 | 每个保留接口的真实请求/响应样例、错误表和契约测试；10MB 的字节口径、字符集及兼容变更说明一起固定。 |
|
||||
| Q4 Kafka wire | schd 当前多 FLID 聚为一个数组/一条 record，与“record 按 FLID 分区”冲突；msg 的 SNDR 尚未接线。 | 下游确认发送粒度、key、去重标识放置、分区内顺序及批次确认策略；同步 Dispatcher/设计，不擅自把现役数组改成逐航班消息。 |
|
||||
| Q4 Kafka wire | 当前 msg/schd 均按 `FLID` 逐航班发送（schd 由 `flushSchd` 合并为每个 FLID 的最新状态），与 legacy“多 FLID 数组”形态不同；msg 是否需按 `SNDR` 分区尚未接线。 | 下游确认发送粒度、key、去重标识放置、分区内顺序及批次确认策略；未定案前不改动现役消费契约。 |
|
||||
| Q5 请求匹配 | 目标优先 SEQN 回显，但回显是否可靠需确认；DTTM 降级存在跨代误匹配，尤其旧应答到达新请求期间。 | 15 类请求/响应样例、回显字段与时间格式；降级风险是否接受及拒绝条件。默认超时仍为 RQFD 60 秒、RQRD 30 秒。 |
|
||||
| Q6 deadline 与重放 | 入队时间作为稳定锚点会把长期排队消息计入滞留；历史重放保留 CREATED_AT 后可能立即过期。 | 明确首次处理/排队过期策略与“本次恢复尝试”计时方式，保留原始时间审计；测试积压恢复和旧 DEAD 重放，不用刷新 UPDATED_AT 绕过超时。 |
|
||||
| Q7 信箱外部契约 | 原目标为成功→SUCCESS、忽略→SKIPPED、重复→DUPLICATE、死信→DEAD；当前 JDBC 写 PROCESSED。新 STATUS 值尚不能假定库方支持。 | 库方认可的状态值、META/缺失字段、权限、原文保留期、出站去重与处理时间语义；若只允许 legacy 集合，显式映射内部原因，不新增外部枚举。 |
|
||||
|
||||
Reference in New Issue
Block a user