 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
|
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
|
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
|
2b112f527c
|
docs: consolidate flight state design
|
2026-09-09 11:43:34 +08:00 |
|
|
windyboy
|
107be5d74a
|
feat(infra): 数据库方言接缝 SqlDialect（PG 实装 + 11g MERGE 编译级交付）(ACM2-29 P3-B)
- SqlDialect 接口：快照 upsert / 主行存在性保障两类方言敏感 SQL；
PostgreSqlDialect 承接现有 ON CONFLICT 路径，JdbcFlightSchdRepository 已接入
- Oracle11gDialect：MERGE INTO 模板（编译级交付，未经目标库验证）——激活门控
写入 KDoc：11.2 补丁 × JDK25 × ojdbc × Flyway(oracle11g location) × 连接池
组合现场实测通过才允许切换，MERGE 绑定顺序适配随激活完成
- db/migration/oracle11g/README.md：11g 迁移位置占位与前置条件清单（CLOB 映射、
空串=NULL 语义回归、display 视图 11g 版）
验证：MSGX_PG_PORT=5433 真实 PG 全量 108 用例 0 失败 0 跳过
|
2026-09-08 17:10:40 +08:00 |
|