Files
msgexchange-v2/docs
windyboy 879d658159 refactor(flight-state): 按 flight-state.md 审计定稿全量重构脚手架与 SQL (ACM2-31)
- SQL 基线 V1__flight_state_baseline.sql 整体取代 V1.0.0–V1.4.0:
  PIPELINE_LOCK/PROC_STATE/MSG_EVENT/REQ_TRACK/BACKFILL_TODO/FLIGHT_SCHD
  + 8 张资源明细表 + FLIGHT_ROUTE_POINT + SCHD_SNAP_LOG 留痕层
- 废除 FDAY 日代/SCHD_GEN/名单差删:OPERATION_DAY 不可变(应用层校验 +
  条件更新强化 §7.4),STATE 仅 ACTIVE/DELETED,物理清除只在历史归档后
- 处理器化:applyScheduleRecords(§5.1 七步同一事务,重放判定/整包
  DEAD(PROTOCOL)/归属冲突不落地)+ FLOP/FDEL/ADFT(tombstone 仅
  ACTIVE→DELETED,重复 FDEL 幂等不推进版本)
- 投递:KAFKA_SCHD 同 FLID 按最新 STATE_VERSION 合并,被压掉事件关闭,
  TOMBSTONE 发 null 值消息(键缺失=删除旧值 §7.3)
- 回填待办改为业务事务内预登记,消除提交后写待办的崩溃窗口(§7.2/§10)
- XML 解码改为 jackson-dataformat-xml 数据类直接映射(SIS 信封强类型,
  FLTR 开放标签泛型承载)
- 历史归档/物理清除顺序不可颠倒:归档确认成功集才物理删除,未接通删 0 条
- 移除 PUMP_JOB 队列/ReferenceService/FlightStoreDiffTool 等旧机制与测试,
  新增运营日/引擎/快照/FDEL/归档顺序不变性回归测试
2026-09-09 17:53:08 +08:00
..

设计文档入口

当前实现核对日期:2026-09-08。文档中的目标能力不等于已实现;测试通过不等于现场已发布。

文档 唯一职责
architecture.md 系统边界、模块职责、FIFO、单写者、数据库归属。
design.md 管道流程、处理/投递状态、恢复与运行配置。
flight-state.md 航班当前态、快照账本、表关系、事务流程和开放问题。
user-stories.md US/OPS 验收目标,不能用“当前基础”替代完成证据。
decision-flight-state.md 有效决策与理由,历史全文转入 legacy。
SIS 规范 / XSD 外部协议事实;即使在 legacy 目录仍是兼容依据。

维护规则:架构写约束,设计写机制,故事写目标,Plane 跟踪工作。不要在多份文档复制阶段清单。