windy/msgexchange-v2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
122 Commits 1 Branch 0 Tags
72c282bcffd578d3e07873be57b5885e89e49129
Commit Graph
65 Commits
Author SHA1 Message Date
windyboy 72c282bcff docs(acm2-75): 按复审结论修正投影可见性、重复身份与回退交接口径 2026-09-16 10:32:27 +08:00
windyboy 491fc276c9 docs(acm2-75): 按审核结论收口规范内容缺口 2026-09-16 10:21:42 +08:00
windyboyandCursor fd65bb24fb docs(acm2-75): 按需求与架构收口契约和规范 
补齐接口契约的入站、Redis 与出站边界，规范对齐已定语义并作废过期条款；Kafka 生产端约束编号改为 D2。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-09-16 08:49:19 +08:00
windyboy 7cd17409f5 docs(acm2-75): 起草接口契约与现役对拍线索 2026-09-15 22:10:19 +08:00
windyboy de2549af2e docs(acm2-75): 澄清需求与架构验收口径 2026-09-15 21:48:37 +08:00
windyboy ca7c36ef38 docs(acm2-75): 精简重构架构文档并对齐两段事务口径 
- architecture.md：§1–§7 全文精简重构——图收敛为拓扑、主流程改七步时序+类别差异表、
  约束红线去行话、数据归属去黑话、关键决策按章程瘦身为 D1/D2
- specification.md：INV-17b 补静态参考数据单事务口径
- implementation/reference/README/requirements：对齐扫描谓词与两段事务表述
- AGENTS.md：新增文字纪律与用词归属规则
 2026-09-15 13:23:40 +08:00
windyboy 723b3e4c09 docs(acm2-75): 精简规范引言并重写术语表 
- 删除引言段：唯一出处清单、编号规则与空缺说明按评审结论去除
- 术语表逐行改写为平话：库方收敛为 CIIMS adapter 方（信箱表在其 MySQL，表结构变更与清除归它，机制未定）；上游收敛为 CIIMS adapter 写入，AODB 经它落信
- 落信涵盖兼容 HTTP 入口；处理标记标注与需求文档「处理时间」的对应
- 术语行去掉内部表名、编号括注与管道术语指针；处理完成、Redis 投影按 US-05/US-07 口径收窄 Redis 条件
 2026-09-14 17:56:18 +08:00
windyboy e57152dd83 docs(acm2-75): 规范全面对齐新需求口径 
specification.md 按新需求重写：
- 扫描模型反转：水位/ID 区间 → 处理标记为谓词（C-30 取代 C-1/C-2/C-13；INV-2b 替代 INV-2/4/5）
- Redis 回归为查询投影：处理完成门（INV-23）、投影治理与同源读取（INV-24），INV-11b 扩充非权威清单
- 日计划快照语义反转：缺席航班删除、未携带字段清除（INV-15b），增量报文语义另立（INV-14b）
- 终态记录归档 → 到期删除（INV-25），G-PROC-HST/G-HST-RETENTION/G-REPLAY-CHANNEL/G-FLOP-DIRECTION 关闭并清扫全仓引用
- 重放移出交付范围：R_keep 公式收窄、CLM-3 重定义为重处理幂等、Q6 删除
- 新增 INV-23~28：Redis 完成门、投影治理、清理谓词、参考数据逐类保存/门控、历史先行红线
- C-25/C-26 定案（原子级联不回发 EROR；快照未携带字段清除），Q13/Q14 关闭，Q6/Q12 删除，新增 C-30/C-31

联动：implementation.md 收报/回填/快照/生命周期/FLOP 方向各章按新口径重写；architecture.md
D1/D4 改删除语义；reference.md 退役 archive-after；requirements.md OPS 表改为注册表定义
语法；AGENTS.md 状态边界随新口径更新；check-docs.py OPS 注册表节名同步。

scripts/check-docs.sh 全部通过。
 2026-09-14 16:40:00 +08:00
windyboy 2471ea9cab docs(acm2-75): 大范围修正需求定义与验收口径 
- 收敛为 US-01~US-14 + OPS-1~4 的交付定义，去除阶段 A 框架、覆盖矩阵与契约依赖索引
- 明确系统定位与数据流向：航班动态入 PG 并同步写 Redis、经 Kafka 通知网页客户端，静态参考数据入库供 admin-api 只读
- US-14 改为航班历史与清理（ES 历史库），删除原 US-15
- 非目标重写：单实例、至少一次投递、同 FLID 保序、Oracle 未验证不承诺、不调 admin-api
 2026-09-14 15:54:16 +08:00
windyboy 0fbdf381b2 docs(acm2-75): align static reference data flow 2026-09-14 08:28:47 +08:00
windyboy 5b7938ac4b docs(acm2-74): 补齐 FLOP 逐类语义、静态参考数据与数据结构 
自洽与精简：

- specification 补第四种状态词 [我们自证]、验证映射补 INV-14 两行、去 CLM-7/CLM-9 的进度语、补编号空缺说明
- architecture/requirements/implementation 去除逐字复述（领域决策三写句、时间常数排序、C-25/C-26、INV-12/21/22）与参数值重复
- README 与新文档对齐：收报谓词改 ID>W、删不存在的 reference/ 包与 lua/、删 msgx.phase 与 MSGX_REDIS_URI、设计权威口径改 docs/、进度段改指 Plane

内容补齐：

- 新增 implementation.md「动态运行事件（FLOP）」：按 SIS 3.19–3.43 的 25 类逐类映射与空标签语义（含 CNCL 空标签为撤销等），补 RMS→AODB 方向拒绝、ROUT 只保留 4 条、VIPP 忽略等约束；厘清 legacy 29 类与 SIS 25 类的差集
- 新增 implementation.md「静态参考数据」章：13 类参考数据与资源状态的 RTYPE/RKEY、list 与增量合并语义、删除只由 DEL 表达、SLST/REMT/RSTA 机位与登机桥映射
- §11.3 数据结构改为标量分组表与集合明细表（元素键、条数上限、SIS 锚点）
- specification 新增 G-FLOP-DIRECTION / G-FLOP-UNMAPPED / G-REF-DATA；Q8 收窄为真实报文分布与 admin-api 清单
 2026-09-14 07:34:17 +08:00
windyboy cedd859bdf docs(acm2-74): consolidate design documentation 2026-09-13 20:31:13 +08:00
windyboy 800d7617f2 chore(db): 压缩 Flyway 迁移链为单基线 
原 V1–V10 的净结构全部合并进 V1__flight_state_baseline.sql，迁移链收敛为一条。
表集合、逐列类型/非空/默认值、表级约束、索引与种子行经重放比对与旧链条一致；
仅丢弃 5 条只对既有库有意义的存量数据语句（RECEIVED_AT/ENQUEUED_AT 回填、
schd 与开放请求去重、SENT_AT 回写）。

已按旧链迁移过的库版本链与校验和对不上，必须重建 schema 或删除数据卷后重跑，
禁止手工 repair 或改写 flyway_schema_history。

- 删除 V2–V10 共 9 个迁移文件
- 注释统一范式并改用稳定 ID（INV-x/C-x/G-x），修正 KAFKA_MSG/KAFKA_SCHD 与实际值不符
- 同步 docs/reference.md、docs/user-stories.md、oracle11g/README.md、README、application.yml、compose.yaml
- FlywayMigrationTest 改为断言单基线，并补 MSG_EVENT.SENT_AT 覆盖
 2026-09-13 16:31:14 +08:00
windyboy 62f61ad9e4 feat(delivery): 真实 Kafka 投递端口 + 闭合 G-BACKFILL-BACKOFF 配置缺口 
- 新增 KafkaDeliveryPort：ProducerRegistry + 同步 Future.get() 至少一次投递，
  闭合 OPS-1 真实适配器要求与 US-07 INV-10/C-29
- 回填退避从硬编码 30s/15min 提升为 backfill-backoff-ms / backfill-backoff-cap-ms
  配置绑定，闭合 [G-BACKFILL-BACKOFF]
- 删除死依赖 micronaut-redis-lettuce（代码零引用，ACM2-28 Redis 已退出阶段 A）
 2026-09-13 16:26:03 +08:00
windyboy 5bb9d6bb07 docs(spec): 精简需求边界闭合方案 2026-09-13 16:01:07 +08:00
windyboy fc744d0cfd feat(acm2): 闭合 G-KAFKA-D3 / G-IGNORE / G-EVENT-RETENTION 三个缺口 
- G-KAFKA-D3：max-in-flight 默认收敛到 1，KafkaD3Check 启动自检钉住三项联合满足 D3
- G-IGNORE：IgnoreRules 在身份绑定后精确匹配 TYPE 字段，命中写 SKIPPED + 回填意图
- G-EVENT-RETENTION：V10 迁移加 SENT_AT 列，投递原子写，EventCleanupJob 有界清理过期 SENT 行
 2026-09-13 15:48:16 +08:00
windyboy d37a9eb38e docs(spec): 收敛领域边界闭合方案为三个缺口 
- 本轮只做 G-KAFKA-D3 / G-IGNORE / G-EVENT-RETENTION，其余缺口不再写入 spec
- 删除约束与表结构副本、User Stories 重复、phase B 清单与进度记录
- US-04 AC1 明确先绑定身份再转 SKIPPED，引用改用稳定 ID US-03
 2026-09-13 13:49:06 +08:00
windyboy 30dc8adf00 docs(spec): 领域边界闭合 spec 与配套文档修正 
新增 docs/spec-boundary-closure.md：自包含 spec，内联展开所有
PRE/INV/CLM/D/C/US/PARAM/Q/错误分类/表结构/时间常数序引用，
覆盖 G-KAFKA-D3 / G-IGNORE / G-EVENT-RETENTION / G-BACKFILL-BACKOFF
/ G-PROC-HST 五个缺口的实现决策、验收与测试决策。

同步修正 design.md（归档段落改条件 DELETE、ARCHIVED 影子行、
SENT_AT 描述）与 user-stories.md US-11（AC1 改 UPDATED_AT、
AC2 删投递判据、AC3 补条件回滚语义）。
 2026-09-13 12:52:21 +08:00
windyboy 729e102b8e docs(lifecycle): 补齐清除生命周期与逐对象归档边界 
- design.md 9.3 扩为「生命周期与清除」：清除通则、逐对象生命周期表、
  处理终态归档判据（终态 ∧ 回填了结 ∧ 终局后到期）与时间常数排序
- contracts.md 新增 C-16：回填放弃清单在对应信箱边界清除前必须保持可查
- invariants.md 缺口索引新增 G-HST-RETENTION、G-FLIGHT-HIST-RETENTION、
  G-REQ-TRACK-RETENTION
- flight-state.md 补航班历史存储保留期开放项
- 同步 architecture.md / user-stories.md 的 9.3 交叉引用
 2026-09-13 10:49:48 +08:00
windyboy 17a4bfe91b feat(codec): 观测未落库的 SRVT/VIPF 集合 
SRVT/VIPF 只保留在 wire/domain 并计数告警，不落明细表、不参与合并：
出现事实不再被静默丢弃，为 Q13 定案提供真实流量证据（[G-SRVT-VIPF]）。

- wire DTO：SRVT/SERVICEDATA、VIPF/VIPDATA 与嵌套 VIPT（OPER 为元素属性）
- 出现即留键：缺席与"出现但为空"不再等价；已落库 10 类集合语义不变
- 新增 msgx.pipeline.codec.srvt_seen.total / vipf_seen.total（reference.md 已登记）
- 一并提交此前的 MAFL 文档改动（INV-21/INV-22、flight-state §2.3、G-MAFL 措辞）
 2026-09-13 09:21:51 +08:00
windyboy b8738554e6 refactor(ingress): 移除 G1 窗口补偿扫描与迟到到达检测 
实际负载不足 10 条/秒，G1 属过度防御。删除迟到到达检测机制、
existingIds 接口、PipelineCounters 字段、lateDetect 配置，
以及文档中 CLM-1/CLM-2 声明与 G1 缺口索引。
 2026-09-13 08:08:43 +08:00
windyboy 8053c01964 docs(contracts): Q8/Q13 标记为暂缓 
- Q8 逐类清单现阶段不处理
- Q13 缺失字段语义测试前不决定，真实消息优先于 SIS 文档
 2026-09-12 22:39:09 +08:00
windyboy cfece0c559 docs: drop merged message-lifecycle stub 
message-lifecycle.md 内容已全部并入 design.md / contracts.md；仓库内唯一引用是 docs/README.md 的跳转说明，已同步删除并在「当前状态」记录删除事实。历史链接按 README §2 职责表重定向到 design.md。
 2026-09-12 21:04:42 +08:00
windyboy 82cc70cbb3 docs(acm2-63): 精简架构文档并闭合模块入口登记 
architecture.md 138→116 行：删除 §9「当前实现与上线门槛」（进度内容，归 invariants 声明边界与 Plane，其中部署前提并入 §8）；§4 主流程压成链路摘要 + design 节名指针，去掉与 design 重复的机制细节；§8 可观测性收成一句并把指标口径指向 reference；D1–D4 第三列由「当前状态」改为「证据 / 缺口」稳定 ID 指针。

reference.md：模块入口补 infra/metrics/JobActivity.kt、infra/health/JobRunnerHealthIndicator.kt 与 config/OperationDayProps.kt；迁移清单补 V7–V9。
 2026-09-12 21:03:23 +08:00
windyboy 8093d20f9b docs(acm2-63): 收敛文档口径并补齐作业健康指标登记 
含：MAFL 派生投影与 SRVT/VIPF 无界集合口径、schd EVENT_ID 写代次与 DEAD 代次替换、运营日时区 fail-fast、缺口索引增删（G-MAFL/G-SRVT-VIPF/G-COMPAT-HTTP/G-REQ-OPEN-UNIQUE，移除 G-JOB-HEARTBEAT）、job 心跳/扫描积压/最近失败指标登记、INV-18 验证映射改为实际测试名。
 2026-09-12 21:00:01 +08:00
windyboy 3085431bea docs: 落地上轮复审修正并修正参考表位置 
- G-IGNORE 缺口表述去掉错引 INV-19、补 US-04
- reference 登记 msgx.pipeline.backfill-scan-period
- user-stories 的 R_keep 下界/deadline 措辞对齐
- reference 归档参数行从空行后挪回参数表内（修正 acm2-52 提交中的表格位置）
 2026-09-12 11:36:52 +08:00
windyboy dcdc5117bf docs(acm2-51): 收口 D10/D14/D15 
- D10 投递保序：architecture 改为 FLID 级（与 design/CLM-7 对齐，实现收敛归 ACM2-34）
- D14 REQ_TRACK 状态名：user-stories US-08 对齐实现的 PENDING/SENT/DONE/EXPIRED
- D15 容量假设：invariants 新增 CLM-10（未实测，含解除条件），design §10 加指针
纯文档，不改代码/迁移/配置/legacy。
 2026-09-12 11:33:58 +08:00
windyboy 69c2cf219f docs(acm2-52): 修正跨文档事实冲突 F1–F9 与错引编号 
- F1/F6 HTTP 契约：C-28 目标 ResponseDto + 请求体上限暂定 10MB，Q3 指向 C-28
- F2 legacy 与 SIS 的优先级限定；F3 超期判据对齐 ENQUEUED_AT；F4 改引 D1
- F5 参数默认值改引 reference/PARAM；F7 补 4 条契约状态词；F8 定义 MAID/MAFL 并明确排除共享航班；F9 补 INV-20
- N1/N2 错配编号改引；N3 迁移链指针；N4/M5 白名单补 D-x/OPS-x；N6 补 INV-16/17 映射；N7 加粗规则
- M1 回填退避事实与论证；M2 Q6/Q7；M4 Q4 假定标注；M7 去复述
纯文档，不改代码/迁移/配置/legacy。
 2026-09-12 09:57:26 +08:00
windyboy 817236ca26 fix(processing): 落地 D1/D5/D6 三项裁决，删除 head-deadline 参数 
D5（终态判据只保留尝试上限）：
- Pump.tick 内联 attempts 判定，删除 head-deadline 相关的毒丸分支与滞留告警代码
- 删除配置项 head-deadline（PipelineProps / application.yml）与 PumpDeadlineTest
- PROCESSING_STARTED_AT 变为只写，注释如实说明当前无判据消费它

D1（回填放弃判据改为时间）：
- 暂时性故障在 R 之前只退避重试，不再按尝试次数放弃；到 R 才放弃并记 TRANSIENT_DEADLINE
- backfill-max-attempts 降级为单行重试的告警阈值

D6（超期判据改用本地入队时间）：
- 新增 V6 迁移：PROC_STATE 加 ENQUEUED_AT（回填存量后置为非空 + 默认）
- findBackfillDue 的谓词与 overdue 标记改比较 enqueued_at，不再用库方时钟的 received_at
- BackfillDue 增加 overdue；收报与兼容入口显式写入本地入队时间

文档同步：
- 清理 4 处 message-lifecycle.md 章节号死链（Pump/InboxService/PipelineProps/application.yml）
- 关闭 G-HEAD-DEADLINE、G-BACKFILL-ABANDON-BYTIME、G-ENQUEUED-AT 三条缺口登记
- reference/user-stories/README 与实现对齐

验证：./gradlew test ⇒ 122 tests, 0 failures, 1 skipped

Refs: ACM2-45
 2026-09-11 20:44:30 +08:00
windyboy 6eade95a97 docs: 拆分契约/前提/参数文档，合并消息生命周期并收敛设计裁决 
- design.md 合并 message-lifecycle.md（后者保留跳转 stub），去重并改用稳定 ID 引用
- 新增 invariants.md（前提/不变量/声明边界/验证映射）、contracts.md（对外条款与 Q 台账）、
  reference.md（参数/指标/模块/错误分类）
- architecture/flight-state/user-stories/README 同步重划引用；README 废止「引用章节号」
- 裁决收敛：R 按超期而非次数放弃、清除前提含放弃清单、航班表写者互斥、head-deadline 仅告警、
  超期判据用本地入队时间、投递批次读取时刻冻结、schd 只进不退与条件标记、FLID 复用为前提
- 删除 runbooks 与 CI 防漂移校验：设计阶段不产出面向执行期的产物

Refs: ACM2-42..51
 2026-09-11 15:48:14 +08:00
windyboy 632a5fe422 docs: 精简重复论证与过时流程表述，口径与实现双向对齐 2026-09-11 14:26:44 +08:00
windyboy fed0b5df26 docs: 同步取报-处理-回填链路的修复结论 
- 事务边界表：区分业务型/非业务型终态；回填改为扫描驱动（主泵不再 inline 回填）
- 符号与配置：补 delivery-batch / backfill-max-attempts / cutover-watermark /
  late-detect-* / backlog-cache-ttl-ms / 邮箱超时与指标口径
- 闭环状态：G2/G3/G9 标记已修；G1 标注「阶段 0 只读迟到检测已交付」
- 修正 R/R_keep 论证：R 不保护重放窗口；原文保留归 R_keep 与 Q7/Q9，
  并删除「由 SIS Expiry 推导提交时延」的无效推论
- 回填语义补全：四种结果、放弃 ≠ 标记已确认、公平轮转与饥饿说明
- 兼容入口与水位：登记行超出水位、水位追平前不被领取，并写明运维含义

Plane: ACM2-35 ACM2-37 ACM2-38 ACM2-39 ACM2-41
 2026-09-11 08:08:39 +08:00
windyboy 50e0e7f389 docs: 修复跨文档冲突与外部规范口径 
不动代码、配置与迁移，只收敛文档口径。

- 登记两项外部冲突：Q13 日计划缺失可选字段（SIS §3.16 注释 4 要求删除本地值，
  与现行"未携带字段保留"相反）、Q14 主/共享删除顺序与 EROR 回报义务
  （SIS §1.6.1-1.d / §4.8）；航班级"缺席不删"补 SIS §3.16 注释 1 依据。
- flight-state §3.3 补主/共享关联按 FLID 值比较的规则。
- message-lifecycle：§11 水位不变量与 §5.1 空洞老化自洽；删除过期的 updatedAt
  判据，统一为 PROCESSING_STARTED_AT + 可注入 Clock；§5.1/§6 补 SIS 480 分钟
  Expiry 与 legacy 1 天保留窗，作为 Q2/Q6/Q7 的取值参照。
- architecture/design：明细表口径统一为 8 张资源明细表 + FLIGHT_ROUTE_POINT；
  Oracle 11g 断言收敛为待适配验证；配置键按 application.yml 实际名称加 msgx. 前缀。
- user-stories：Q2/Q6/Q11 补外部锚点并收窄 Q11 到重置周期 + SNDR 值域；
  新增 Q13/Q14 并挂入 US-05/06/08 前置；五个独立事实改为引用 message-lifecycle §1。
- README/legacy：文档基线改为代码基线 eea1120 + git log 指引；补"外部协议冲突以
  SIS 为准"的维护规则；修正 /all/flights 过滤措辞；术语统一为「回填意图」。

验证：文档间章节引用 0 缺失、markdown 0 断链、SIS 引用小节全部存在、
Q1–Q14 正文与 Q 表双向可解析、代码块配对正常。
 2026-09-10 20:54:01 +08:00
windyboy eea11203a2 fix(processing): 收紧消息生命周期与投递约束 2026-09-10 20:39:22 +08:00
windyboy dd839e6abb docs: 统一生命周期与处理职责口径 2026-09-10 19:48:49 +08:00
windyboy 8c6bb83b62 docs: 同步信箱生命周期实现口径——§4 缺口收敛、水位空洞老化、回填事实并入 PROC_STATE 
message-lifecycle.md：§4 两个崩溃窗口随"终态与回填意图同体同行"消除（不再是缺口，改为
说明剩余未闭环项是回填跨库单写期间的持续失败）；§5.1 补空洞老化规则（自增回滚空位会使
水位永久停摆，超出最大提交时延即判永久并放行，只跳过空洞不越过已存在的行）；§5.2 补判据
机制（不依赖独立待办表，R 覆盖退避）；§3 表格改回填意图与"到期或已达 NOW − R"。
design.md：§2.1 表以 INBOX_CURSOR 取代 BACKFILL_TODO、PROC_STATE 责任补回填事实；
§3.1 收报改为按 ID 区间扫描且不以标记为谓词；§3.3 终态由处理器事务内落库、死信同样可
补写；§6.1 维护作业改为 BackfillService.sweep；§7 补 max-commit-delay/overdue-backfill/
backfill-batch 与 mailbox.processed-value；§8 验证表补"终态未回填不得阻断发现"与"意图随
事务回滚"；§9 入口表更新；§10 缺口两则改写为现状与待确认项。
architecture.md：§4 主流程第 1/3/4 步与 §3 存储表同步（水位、回填意图、单事务范围）。
flight-state.md：§2 对象表同步。user-stories.md：US-01/US-09 当前基础与落点改为实现现状、
Q2 口径改为"老化阈值待库方书面承诺"。
 2026-09-10 11:00:02 +08:00
windyboy ffd3abd655 docs: message-lifecycle 审查修正——消解跨文档冲突、口径归口并登记 Q12 
message-lifecycle.md：
- §5.3 日计划改为现行合并语义（缺席不删、缺失保留，引 flight-state §3.1），类型粒度统一 TYPE-STYP
- §5.1 明确两条扫描路径按 ID 区间取行、不以处理标记为谓词；水位定义与 Q2 绑定
- §4 两个缺口改与 design §10 同措辞；§5.2 的 R 构成挂 Q6/Q9，新增 Q12 积压跳过授权
- §6 方案 B 对账补“只补缺失行、标记单调不回退”；删除能力声明标注待 Q9 确认
- §7 改为“尚未实现”、统一 COUTMSGS_* 列名；§11 ID 不断链改为条件式不变量

user-stories.md：US-11 第 4 条限定为“本系统不写共享历史表/不清除外部信箱”；US-01 扫描谓词指向 lifecycle §5.1；US-01/09/11 前置补口径指针；新增 Q12；OPS-2 补积压与最老未处理信龄；Q10 列名统一。

architecture.md：共享 MySQL 红线限定主体；§6 中断恢复表改为指向 message-lifecycle §4；收报步骤补扫描谓词指针。

design.md：水位定义、回填死信处理、维护作业、归档、缺口恢复统一指向 message-lifecycle。

README.md：核对日期更新至 2026-09-10（代码基线 99a0f5f，文档基线 328bbf8）；维护规则补规范类文档一档。
 2026-09-10 09:00:53 +08:00
windyboy 328bbf88d2 docs: 新增 message-lifecycle.md——上游消息生命周期唯一规范（五事实/崩溃恢复/水位/超期补写/历史积压/信箱清除 A/B/出站契约），登记 Q9/Q10/Q11，README 索引与 architecture/design 指针补齐 2026-09-10 08:55:43 +08:00
windyboy 8068ed975b docs: 文档整理——统一 KAFKA 事件名与运营日术语，链接文字对齐标题，修复两处空行格式，README 补旧行为基线索引；主/共享级联语义上移至 flight-state §3.3 并增补 STATE_VERSION 不变量（architecture §9 引用同步改为 §3.1/§4/§7） 2026-09-10 08:16:31 +08:00
windyboy 99a0f5f738 refactor(flight-state): SCHD 日计划收敛为缺失保留合并语义并对齐现行设计文档 
按现行 docs/flight-state.md（111 行版，§1-§7）全面对齐 domain 包及其消费方，
删除整套指向已退役长版文档（§5.x-§10）的引用与死代码：

- 语义：FlightStateEngine.snapshotState 由"完整快照整体替换"改为 §3.1 合并语义
  ——出现 Set/Replace、缺失保留、标量空串显式清空；DELETED 不被日计划恢复（§3.3）。
- 校验：validateMessage 移除从未接线的报文覆盖范围（scope）参数，只保留 §4 步骤 2
  的声明数量/航班标识/运营日推导校验；ScheduleBody 删除 scopeStart/scopeEnd。
- 删除死代码：domain/Decision.kt、FlightModel 的 SnapshotPatch/UpsertOutcome、
  ProcState.isTerminal/archivable、SnapshotFlag.SEQN_REGRESSION、
  ScheduleRecord.seqn（及 wire FlightRecordXml.SEQN）；codec 移除未消费 FFID。
- 删除未接线且引用已退役列（fday/last_message_id）的 SqlDialect 方言脚手架，
  oracle11g README 改为按 V1 现列重建的口径。
- 注释/测试：domain、processing、infra 仓储与 jobs/delivery、配置类及对应测试的
  KDoc 章节引用全部对齐现行 flight-state.md/design.md；FlightStateEngineTest
  重写为合并语义（62/62 通过）。

V1__flight_state_baseline.sql 保留原样（内容注释仍带旧章节号，改动会破坏
已应用迁移的 Flyway checksum，待重建基线或 V2 净迁移时收敛）。
 2026-09-09 22:17:04 +08:00
windyboy b75f566276 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/ 保持原样。
 2026-09-09 21:50:05 +08:00
windyboy d53a0a1c2f docs: remove retired schedule generation design 2026-09-09 20:22:10 +08:00
windyboy c2d4a76e3e docs: flight-state 定稿唯一设计规范，移除 §10–§12 并落地评审修正 A–M (ACM2-31) 2026-09-09 19:28:14 +08:00
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
windyboy 6af292d103 docs(flight-state): 移除对账账本并按三轮评审收敛删除与时序语义 (ACM2-31) 2026-09-09 15:40:54 +08:00
windyboy 9e434d6486 docs(flight-state): 重写当前态设计为简洁版并落定航班身份模型 (ACM2-32) 
按评审意见重写 docs/flight-state.md（603 → 332 行），去掉堆叠的补充说明，每条规则只保留一处：

身份模型：
- FLID 由 AODB 分配、与运营日绑定；同一 FLNO 不同运营日 = 不同 FLID
- OPERATION_DAY 一经确定不可变，跨日归属不符属协议异常（整包拒绝）
- 延误跨日不是迁移：同一 FLID、运营日不变，由 FLOP 继续更新
- 补齐 FDEL 删除入口（§2、§6.2）：按 FLID 删除并移出名单，不换代
- 代码共享与过站关联分离；物理列名 FDAY 统一改称 OPERATION_DAY

快照与差删：
- 11 步事务固定顺序；差删集合即 O − N，OPERATION_DAY = D 为删除前断言
- 覆盖范围按“是否单个完整运营日”判定：48 小时窗口只覆盖状态、不差删
- 完整快照字段缺失即清除（SIS §3.16 注释 2/4），只对本模块映射字段生效
- SEQN 仅用于同会话顺序观测，不启用陈旧拦截

其余：留痕 RESULT/FLAGS 分列、身份不变量六条、保留期默认 7/90/7 天、
未定事项与 SIS 规范依据各收进一张表（§10）。
 2026-09-09 14:54:54 +08:00
windyboy 2b112f527c docs: consolidate flight state design 2026-09-09 11:43:34 +08:00
windyboy 4449ee5dcc docs(flight-state): 按 2026-09-09 二轮评审修正设计文档，开放项锚定 ACM2-31 (ACM2-31) 
依据 ACM2-31 二轮外部评审逐条修正，待协议确认项已对照 SIS_AODB_RMS V0.1 佐证：

- 标注约定：区分规范要求与现状/未决披露，杜绝混作依据
- 航班身份：FLID≠航班号，FDEL+ADFT 换名时 FLID 可能不同（规范 §3.18），代码共享独立事件经 MAID/TAID 关联
- FDAY 三日期概念区分（业务日期/快照覆盖日期/名单归属日期）；跨日归属回迁列为未决（§3.3 约束 4）
- 规则 M 补成立条件标注（快照生成时点 + 投递顺序前提未逐条核实）
- 差删完整性前提引协议口径：单包不分段、RECS 记录数、完整快照注释（§3.16.1）
- 动态线集合全量/增量语义待逐类确认（CHOT CSNO 实为机位序号 §3.22.2），Replace 全集仅对快照线定案
- tombstone 澄清为自定义删除事件（非 Kafka 原生墓碑），删除版本/世代缺口开放
- 行锁表述纠正（跨实例同样生效，但不实现认领/选主/切换/FIFO）；Oracle 空串=NULL 为既定行为，验证目标改为字段语义保真
- ACTT 实际时间口径（进港 ATA/出港 ATD §3.20），修正示例字段名；FLOP 29 类改为规范 §3.19–3.43 实数；99 上限标注协议出处
- 语言修订：主泵/数据一致性比对/JSON 数组/整态替换措辞等；错误矩阵每类错误单一默认路径
- 开放项（回迁防护/动态集合语义/删除世代/幂等键/FIFO 参数/一致性读/TAOP 语义核对等）归集 ACM2-31
 2026-09-09 10:47:03 +08:00
windyboy bb81deae0a docs: 航班状态设计重写为当前基线，按请求/下载与动态两条线讲清状态变更 (ACM2-30) 2026-09-08 18:50:34 +08:00
windyboy 7c2d22e8f1 feat(persistence)!: V1.4.0 退场 legacy 槽位存储，persistNextStates 成为唯一写路径 (ACM2-29 P4) 
- V1.4.0 迁移：DROP FLIGHT_SCHD 全部 77 个槽位/里程碑/紧凑航路列（V1.3.0 起
  零写入、P2-2 起零读取）+ 三个与 PK 前缀冗余的 (flid) 单列索引；回退窗口关闭
  （对拍留档：P2-1 FS7 v2 双读差异记录）
- 接口收敛：FlightSchdRepository 删除 upsertSnapshotBatch/upsertIncremental，
  删除废弃 FlightStateRepository 及 Jdbc/Stub 适配器；仓储与装配器删除全部
  legacy flatten/slot/milestone/route 视图代码，ALL_COLUMNS 收敛为无损承载列
- FS7 对拍工具移除 diffDualRead（legacy 槽位基准退场）；diff() 对 legacy
  FLTR JSON 比对保留；FlightStoreDualReadTest 随工具移除
- 测试种子统一走 v2 写路径（support/SeedHelpers），GuardedFlightSchd 简化
- docs/decision-flight-state.md：头部复核入口更新 + 新增 §10 v2 落地终态索引，
  §1–§9 保留为历史记录

验证：MSGX_PG_PORT=5433 真实 PG 全量 100 用例 0 失败 0 跳过；无环境变量
Testcontainers 全新容器 V1.0.0→V1.4.0 迁移链 18/18 全绿
 2026-09-08 17:44:20 +08:00