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 净迁移时收敛)。
This commit is contained in:
windyboy
2026-09-09 22:17:04 +08:00
parent b75f566276
commit 99a0f5f738
35 changed files with 320 additions and 370 deletions
@@ -1,22 +1,23 @@
package com.gzzn.omms.msgexchange.domain
/** MSG_EVENT 事件形态(§7.3)。 */
/** MSG_EVENT 事件形态(design.md §2.1UPSERT 整态/通知,TOMBSTONE 删除)。 */
enum class EventType { UPSERT, TOMBSTONE }
/** MSG_EVENT 投递状态outbox 状态机)。 */
/** MSG_EVENT 投递状态机(design.md §2.3PENDING → SENT;失败退避重试;耗尽转 DEAD 保留作 DLQ)。 */
enum class EventStatus { PENDING, SENT, DEAD }
/**
* MSG_EVENToutbox§3.2):状态、变更、删除通知。
* KAFKA_SCHD 整态 + KAFKA_MSG 变化通知;TOMBSTONE 仅在 ACTIVE→DELETED 时
* 与删除同事务登记(§7.3),投递失败持续重试
* MSG_EVENToutboxdesign.md §2.1):状态、变更、删除通知。
* KAFKA_SCHD 整态KAFKA_MSG 只通知变化(docs/flight-state.md §5,两主题不承诺顺序);
* TOMBSTONE 仅在 ACTIVE→DELETED(§3.3)或生命周期清理前补发(§6),与删除同事务登记。
* stateVersion:发布时的航班版本;KAFKA_SCHD 聚合按 FLID 取最新(§5)。
*/
data class MsgEvent(
val eventId: Long? = null,
val target: String,
val partitionKey: String, // 恒为 FLID
val eventType: EventType = EventType.UPSERT,
val stateVersion: Long = 0, // 发布时航班版本;Dispatcher 合并同 FLID 未发事件取最新(§7.3)
val stateVersion: Long = 0,
val payloadJson: String,
val state: EventStatus = EventStatus.PENDING,
val attempts: Int = 0,