docs: 纠正对齐后的文档反向漂移（UNSUPPORTED/CHDT/FDEL/Flyway）
ACM2-83/87/90 落地后 reference、implementation、MsgEvent 与迁移注释仍描述旧行为；拆开 UNSUPPORTED 两行，并写清 V1+V2 与删航班只走 msg。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
windyboy
@@ -300,7 +300,7 @@ PG 是航班数据源（`INV-5`）；Redis 从 PG 同步，处理完成前写入
|
||||
| 资源明细表 | 保存登机门、值机柜台、转盘、计划机位、滑槽、延误、靠撤桥、轮挡等变长集合；`SRVT`/`VIPF` 专用明细见 `G-SRVT-VIPF`。主键为 `(FLID, ORDINAL)`。 |
|
||||
| `FLIGHT_ROUTE_POINT` | ROUT 与 ERUT 两类路线点，使用 `ROUTE_KIND` 区分；主键应包含该列，避免两类路线的序号冲突。 |
|
||||
| `PROC_STATE` | 信箱消息的处理终态、业务身份幂等记录，以及回填事实（`RECEIVED_AT` / `BACKFILL_*`）。 |
|
||||
| `MSG_EVENT` | 事务 outbox，承载整态快照、变更通知和删除事件（tombstone）。 |
|
||||
| `MSG_EVENT` | 事务 outbox，承载整态快照与变更通知；删航班只走 `msg`（`C-9`）。 |
|
||||
| `SCHD_SNAP_LOG` | 日计划处理留痕，只追加、可重建，不参与状态决策。 |
|
||||
|
||||
### 11.2 航班身份与运营日
|
||||
@@ -342,7 +342,7 @@ PG 是航班数据源（`INV-5`）；Redis 从 PG 同步，处理完成前写入
|
||||
- 相同资源号不代表同一条分配，禁止按资源号去重。
|
||||
- 每次持久化完整航班状态时，明细表按该 `FLID` 先删后插，以完整合并结果为准。
|
||||
- ROUT 与 ERUT 是两类独立集合，不能因相同序号覆盖彼此。
|
||||
- `CHDT` 的类字段固定为 `CCLS`/`CTYP`；当前 wire DTO 与持久化列误写成 `CHCLS`/`CHTYP`，见 `G-FLOP-UNMAPPED`。
|
||||
- `CHDT` 的类字段固定为 `CCLS`/`CTYP`（wire DTO 与 `flight_chute` 列 `ccls`/`ctyp` 已对齐；迁移见 `V2__flight_chute_class_type_rename.sql`）。
|
||||
- 主/共享：`MAID` 指向主航班 `FLID`；`MAFL` 从子航班派生，不入站。
|
||||
|
||||
### 11.4 `MAFL`
|
||||
@@ -395,7 +395,7 @@ PG 是航班数据源（`INV-5`）；Redis 从 PG 同步，处理完成前写入
|
||||
|
||||
### 12.3 删除与重建
|
||||
|
||||
FDEL：`ACTIVE→DELETED`，写 tombstone。物理删除仅历史清理成功后（`US-14`、`D1`）。覆盖范围内快照缺席也标删（`INV-7`）。
|
||||
FDEL：`ACTIVE→DELETED`，只登记 `KAFKA:msg` 变更通知（`C-9`；不再写 `schd` tombstone）。物理删除仅历史清理成功后（`US-14`、`D1`）。覆盖范围内快照缺席也标删（`INV-7`）。
|
||||
|
||||
ADFT：Set-only（`US-04` AC2），未带字段不清。有 `SODT` 则算 `OPERATION_DAY`。
|
||||
|
||||
|
||||
+2
-1
@@ -137,7 +137,8 @@
|
||||
| `MALFORMED` | 找不到原文，或 XML、必要字段无效 | 立即记 `DEAD`，停止自动处理 | 否 |
|
||||
| `PROTOCOL` | 整份报文未通过业务校验，或运营日不一致 | 整份不写数据库，记 `DEAD` | 否 |
|
||||
| `CODEC_ERROR` | 解码程序尚不能识别报文结构 | 记 `FAILED`，等待后重试 | 是 |
|
||||
| `UNSUPPORTED` | 当前没有对应的处理程序 | 当前代码记 `FAILED` 并重试；`US-03` AC2 要求跳过合法未知类型 | 是 |
|
||||
| `UNSUPPORTED`（合法未知类型） | 报文种类可识别，但没有对应处理程序（`MsgKind.Unsupported`） | 记 `SKIPPED`，写回信箱为已处理（`US-03` AC2） | 否（终态，不进重放白名单） |
|
||||
| `UNSUPPORTED`（参考数据） | 参考数据类别已识别，但处理器尚未落地（`MsgKind.RefData`） | 记 `FAILED(UNSUPPORTED)` 并重试 | 是 |
|
||||
| `INFRA` | 数据库、网络或程序执行出错 | 记 `FAILED`，等待后重试 | 是 |
|
||||
| `EXHAUSTED` | 自动重试次数已用尽 | 记 `DEAD`；原错误类别被覆盖，原因留在 `LAST_ERROR` | 是 |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user