windyboy
99a0f5f738
按现行 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（与代码基线 d53a0a1 一致）。文档中的目标能力不等于已实现；测试通过不等于现场已发布。
| 文档 | 唯一职责 |
|---|---|
| architecture.md | 系统边界、模块职责、FIFO、单写者、数据库归属。 |
| design.md | 管道流程、处理/投递状态、恢复与运行配置。 |
| flight-state.md | 航班设计的唯一现行规范：当前态、表关系、事务流程和开放问题。 |
| user-stories.md | US/OPS 验收目标，不能用“当前基础”替代完成证据。 |
| legacy/decision-flight-state-history.md | 已撤销方案的存档说明；现行规则仍以 flight-state.md 为准。 |
| SIS 规范 / XSD | 外部协议事实；即使在 legacy 目录仍是兼容依据。 |
维护规则：架构写约束，设计写机制，故事写目标，Plane 跟踪工作。不要在多份文档复制阶段清单。