docs(acm2-75): 收敛日计划覆盖范围、信箱清除边界与历史判据

This commit is contained in:
windyboy
2026-09-21 10:35:00 +08:00
parent 6dde1d3050
commit 6da5a0021a
8 changed files with 27 additions and 25 deletions
+9 -9
View File
@@ -79,7 +79,7 @@ msgexchange-v2 怎么处理报文:记录模型、状态机、事务边界、
写回延迟期间扫描量会涨,须观测积压([reference.md](reference.md) 指标)。
信箱 ID 单调不复用(`INV-1`)。`POST /cminmsgs/send` 与 adapter 同路径(`C-7`)。单活动实例(`OPS-1`);多实例靠主键幂等,仍须单实例排他。
信箱 ID 单调不复用(`INV-1`;较小编号晚提交时最坏只是被发现得晚(下轮扫描仍会读到),不会丢,但它不会排在已经处理完的较大编号之前`POST /cminmsgs/send` 与 adapter 同路径(`C-7`)。单活动实例(`OPS-1`);多实例靠主键幂等,仍须单实例排他。
## 5. 主泵调度与单条处理
@@ -189,7 +189,7 @@ LIMIT PARAM:msgx.pipeline.backfill-batch
1. 已成功 → 幂等,只追加留痕。
2. 整包校验失败 → `DEAD(PROTOCOL)`,不写半包(`INV-4`)。
3. 分批写:跨运营日整包失败;快照缺席航班标删、发删除事件、删 Redis(`INV-7`)。每批同事务写变更 + 事件(`INV-3`)。
3. 分批写:跨运营日整包失败;**覆盖范围内**快照缺席航班标删、发删除事件、删 Redis,范围外的不受影响`INV-7`)。每批同事务写变更 + 事件(`INV-3`)。
4. 整包成功 → `SUCCEEDED` + 回填意图;留痕在事务外。
字段语义见「航班域」。`RESP` 须匹配开放请求,否则不更新(`G-RESP-GUARD`)。
@@ -266,14 +266,14 @@ PENDING → SENT → DONE
`JobRunner` 周期跑写回扫描、历史清理、留痕清理;不挡主泵 FIFO。历史清理跳过处理中的航班(`US-14` AC4)。
清除须终局证据(航班 `US-14`/`D1`信箱 `C-1`)。证据不明 → 删 0 条。写回失败记录在信箱删前可查(`US-10` AC2)。
清除须终局证据(航班 `US-14`/`D1`共享信箱的清除属库方职责,见 `C-1`)。证据不明 → 删 0 条。写回失败记录在其覆盖的信箱行被清除前可查(`US-10` AC2)。
**逐对象**(保留期见 [reference.md](reference.md)
| 对象 | 终局判据 | 归档目标 | 清除证据 | 执行方 | 偏差 |
|---|---|---|---|---|---|
| 共享信箱 `CMINMSGS` 原文 | 回填了结`BACKFILL_AT` 非空)且超保留期(约 1 个月,`C-1` | | 回填已了结 + 超保留期;放弃行无 `BACKFILL_AT`,不删 | 我们 | — |
| `FLIGHT_SCHD` + 资源明细 | 判史规则 | 历史存储 | 历史写入确认 + 版本复查 | 我们 | — |
| 共享信箱 `CMINMSGS` 原文 | 写回完成`BACKFILL_AT` 非空) | — | 待确认(`Q9` | 库方 | 清除协议未确认(`C-1` |
| `FLIGHT_SCHD` + 资源明细 | `US-14` AC2 的已结束条件 | 历史存储 | 历史写入确认 + 版本复查 | 我们 | — |
| 航班历史存储 | 保留期 | — | — | 我们 | `G-FLIGHT-HIST-RETENTION` |
| `SCHD_SNAP_LOG` | 保留期 | 无(本地可重建) | 无 | 我们 | — |
| `MSG_EVENT` 已发送行 | `SENT` | 无 | 无 | 我们 | — |
@@ -286,7 +286,7 @@ PENDING → SENT → DONE
## 10. 容量假设
单机场、单实例;日消息千~万级;单条 ≤ 10⁴ 字节;延迟秒级可接受。不引入多实例/分布式锁/分区表。参数依据见 [reference.md](reference.md)`CLM-6`)。
单机场、单实例;日消息千~万级;单条报文按 CIIMS 支持的 10 MB 上限、不分片设计(`SIS:3.16`),读取、解码与回归样例都以该上限为准;延迟秒级可接受。不引入多实例/分布式锁/分区表。参数依据见 [reference.md](reference.md)`CLM-6`)。
## 11. 航班域:数据模型与合并
@@ -353,7 +353,7 @@ PG 是航班数据源(`INV-5`);Redis 从 PG 同步,处理完成前写入
### 12.1 SCHD
整包校验通过后分批写入;快照缺席标删`INV-7`)。未带字段清空(`C-6`)。成功航班推进 `STATE_VERSION` 并写 `schd`+`msg` 事件。重复由 `PROC_STATE` 控制;校验失败整包不写(`INV-4`)。
整包校验通过后分批写入;**覆盖范围内**快照缺席标删,范围外的不受影响`INV-7`)。未带字段清空(`C-6`)。成功航班推进 `STATE_VERSION` 并写 `schd`+`msg` 事件。重复由 `PROC_STATE` 控制;校验失败整包不写(`INV-4`)。
### 12.2 动态运行事件(FLOP
@@ -395,7 +395,7 @@ PG 是航班数据源(`INV-5`);Redis 从 PG 同步,处理完成前写入
### 12.3 删除与重建
FDEL`ACTIVE→DELETED`,写 tombstone。物理删除仅历史清理成功后(`US-14``D1`)。快照缺席也标删(`INV-7`)。
FDEL`ACTIVE→DELETED`,写 tombstone。物理删除仅历史清理成功后(`US-14``D1`)。覆盖范围内快照缺席也标删(`INV-7`)。
ADFTSet-only`US-04` AC2),未带字段不清。有 `SODT` 则算 `OPERATION_DAY`
@@ -407,7 +407,7 @@ ADFTSet-only`US-04` AC2),未带字段不清。有 `SODT` 则算 `OPERA
### 12.5 生命周期
运营日过去 ≠ 航班结束。历史清理:保留期 + 终态证据 → 先写 ES 再删失败删 0 行(`D1`)。
运营日过去 ≠ 航班结束。历史清理候选按 `US-14` AC2 的五类已结束条件选取;先写 ES 再删失败删 0 行(`D1`)。当前配置的判据与窗口尚未对齐该验收,见 [reference.md](reference.md) 依据列标「与需求冲突」的四项。
## 13. 静态参考数据