docs(acm2-75): 收口处理时间口径与开篇元信息
This commit is contained in:
windyboy
+4
-4
@@ -9,7 +9,7 @@
|
||||
| [README.md](README.md) | 入口、阅读顺序、文件职责、事实归属、ID 语法与引用纪律。 |
|
||||
| [requirements.md](requirements.md) | 阶段范围与非目标、`US-xx` / `OPS-x` 验收目标、需求覆盖与依赖。 |
|
||||
| [architecture.md](architecture.md) | 系统边界、模块职责、存储归属、总体流程与 `D1`–`D2` 决策。 |
|
||||
| [specification.md](specification.md) | 术语、外部契约 `C-x`、前提 `PRE-x`、不变量 `INV-x`、声明边界 `CLM-x`、待确认 `Qn`、当前已知偏差 `G-NAME`、验证映射。 |
|
||||
| [specification.md](specification.md) | 术语、对外约定 `C-x`、前提 `PRE-x`、不变量 `INV-x`、声明边界 `CLM-x`、待确认 `Qn`、当前已知偏差 `G-NAME`、验证映射。 |
|
||||
| [implementation.md](implementation.md) | 数据模型、状态机、管道机制、事务、投递、作业与恢复；航班域与静态参考数据的权威模型和合并语义。 |
|
||||
| [reference.md](reference.md) | 参数 `PARAM:<key>`、指标与健康、模块与代码入口、错误分类。 |
|
||||
| [legacy/](legacy/) | 外部协议与旧系统基线：现役行为对拍、[SIS 规范](legacy/SIS_AODB_RMS-V0.1.md)、[XSD](legacy/unisysaodbsis.xsd)、[历史决策记录](legacy/decision-flight-state-history.md)。外部协议事实（报文结构、字段语义、上游行为）以 SIS/XSD 为准；legacy 现役行为只是基线，已知缺陷不作依据。 |
|
||||
@@ -28,8 +28,8 @@
|
||||
| 事实 | 唯一归属 | 其他文档怎么写 |
|
||||
|---|---|---|
|
||||
| 收报扫描谓词与幂等登记 | implementation.md「收报」 | specification.md 写对库方的承诺 `C-30`；reference.md 写参数 |
|
||||
| 保留期下界 `R_keep`、清除前置条件 | specification.md「契约」 | implementation.md 只写行为约束；执行步骤在上线前另立 |
|
||||
| 处理标记值集与写权限 | specification.md `C-5`（值集）与 `C-15`（只填空值、不回撤不覆盖） | implementation.md 只写行为约束（`INV-7`） |
|
||||
| 保留期下界 `R_keep`、清除前置条件 | specification.md「约定」 | implementation.md 只写行为约束；执行步骤在上线前另立 |
|
||||
| 处理标记（处理时间）写权限 | specification.md `C-5`、`C-15`（只写完成时刻、只填空值） | implementation.md 只写行为约束（`INV-7`） |
|
||||
| 回填四结果、放弃语义、`R` 的作用 | implementation.md「回填」 | specification.md 记结论与可声明性 |
|
||||
| 退避 / `claim-batch` / 回填期限等取值 | reference.md「参数」 | 其余文档只引 `PARAM:<key>` |
|
||||
| 消费权排他、ID 不复位、报文不可变、时钟、单实例 | specification.md「前提」 | 其他文档只引 `PRE-x` |
|
||||
@@ -56,7 +56,7 @@
|
||||
- 外部 SIS 证据统一写 `SIS:<section>`（如 `SIS:3.16-note-4`），解析到 [legacy/SIS_AODB_RMS-V0.1.md](legacy/SIS_AODB_RMS-V0.1.md) 的章节；它不属于本项目规范 ID，不参与唯一定义检查。
|
||||
- `G-NAME` 是活跃偏差 ID：定义只在 specification.md「当前已知偏差」注册表，其他位置只写标记；偏差闭合时在同一变更中删除定义与全仓引用，历史与关闭证据只留 Plane。
|
||||
|
||||
**数值只有两个家**：参数默认值与指标名在 reference.md；契约数值（保留期、值集、下界）在 specification.md。
|
||||
**数值只有两个家**：参数默认值与指标名在 reference.md；数值口径（保留期、下界）在 specification.md。
|
||||
|
||||
**文档不记进度**：不写日期式状态、完成记录与 changelog；只记「主张是否可对外声明」（`CLM-x`）。
|
||||
|
||||
|
||||
@@ -62,7 +62,7 @@ AODB 经 CIIMS adapter 把 XML 报文写入 `CMINMSGS`，格式以架构指定
|
||||
|
||||
| 表 | 本系统的操作 | 需要对接方提供的物理契约 |
|
||||
|---|---|---|
|
||||
| `CMINMSGS` | 按信箱编号升序、分批读取未处理的报文，扫描与回写用同一处理时间列；兼容 HTTP 入口写入 XML 原文；处理完成后写入处理完成时刻，只填空值、不覆盖已有值；写回失败由后台任务重试，一直写不上的记录保留在案并告警（`US-01`、`US-02`、`US-10`）。 | 表 DDL、信箱编号与报文原文字段、处理时间列的列名和允许值、该列与对接方所称处理标记是否为同一列、各列类型与可空性、写入必需列、原文保留期和索引；信箱编号按到达顺序单调递增、不复用、不回退的保证（架构「必须保持的约束」）。 |
|
||||
| `CMINMSGS` | 按信箱编号升序、分批读取未处理的报文，扫描与回写用同一处理时间列；兼容 HTTP 入口写入 XML 原文；处理完成后写入处理完成时刻，只填空值、不覆盖已有值；写回失败由后台任务重试，一直写不上的记录保留在案并告警（`US-01`、`US-02`、`US-10`）。 | 表 DDL、信箱编号与报文原文字段、处理时间列的列名、类型与可空性及写入样例（处理标记即该处理时间列，见 [specification.md](../specification.md) 的 `C-5`）、写入必需列、原文保留期和索引；信箱编号按到达顺序单调递增、不复用、不回退的保证（架构「必须保持的约束」）。 |
|
||||
| `COUTMSGS` | 写入 `RQRD` 参考数据请求与 `RQFD` 日计划请求；CIIMS adapter 消费。交付承诺止于请求落信；写入结果不明时记录并告警，不直接重发（架构「主流程」）。 | 表 DDL、请求原文字段、写入必需列、编号生成方式、ACK/错误列的写入责任、重复落信的识别规则。 |
|
||||
|
||||
共享 MySQL 归 CIIMS adapter 方所有；本系统不建表、不改表结构、不清除数据，也不写共享历史表。外部表的物理字段必须以对接方提供的现行 DDL 与读写样例核对，不能由本文件推造。
|
||||
|
||||
+10
-8
@@ -1,6 +1,8 @@
|
||||
# 规范：术语、约定、前提、不变量与能力边界
|
||||
# 规范：术语、约定、前提、不变量、声明边界与验证映射
|
||||
|
||||
本文整理 msgexchange-v2 对外接口约定（`C-x`）、前提条件（`PRE-x`）、系统不变量（`INV-x`）、能力边界（`CLM-x`）、待确认事项（`Qn`）与已知偏差（`G-NAME`），并统一给出术语。条款依据 [requirements.md](requirements.md) 与 [architecture.md](architecture.md) 编写；字段联调草案另见 [contracts/interface-contract.md](contracts/interface-contract.md)，对外承诺以本文件为准。
|
||||
本文整理 msgexchange-v2 的术语，对外接口约定（`C-x`）、前提条件（`PRE-x`）、系统不变量（`INV-x`）、声明边界（`CLM-x`）、待确认事项（`Qn`）、已知偏差（`G-NAME`）与验证映射。条款依据 [requirements.md](requirements.md) 与 [architecture.md](architecture.md) 编写；字段联调草案另见 [contracts/interface-contract.md](contracts/interface-contract.md)，对外承诺以本文件为准。
|
||||
|
||||
`C-x`、`PRE-x`、`INV-x`、`CLM-x`、`Qn`、`G-NAME` 只在本文件定义；ID 语法见 [README.md](README.md)。
|
||||
|
||||
约定条目的标记：
|
||||
|
||||
@@ -23,12 +25,12 @@
|
||||
| 登记 | 本系统在自有 PG 为这条报文建立处理记录，排队等待处理。 |
|
||||
| 处理完成 | 该消息已得到处理结果，此后才允许回填与投递（`US-03` AC4）；成功类判据见 `INV-23`、`INV-31` 与架构「主流程」，非法与不支持见 `US-03` AC2。 |
|
||||
| 回填 | 把处理标记写回信箱行。 |
|
||||
| 投递 | 读待发事件发 Kafka。 |
|
||||
| Redis 投影 | 供 `GET /all/flights` 与运营航班显示界面查询的航班数据，内容来自自有 PG 当前态；读写边界见 `INV-24`。 |
|
||||
| 投递 | 读待发事件，发往 Kafka。 |
|
||||
| Redis 投影 | 供网页客户端（`GET /all/flights`）查询的航班投影，内容来自自有 PG 当前态；读写边界见 `INV-24`。 |
|
||||
| 自有 PG | 本系统唯一的业务数据库；航班当前态、管道记录与静态参考数据都在这里。 |
|
||||
| 权威 | 航班当前态的唯一权威是自有 PG（`INV-11b`）。 |
|
||||
| 权威 | 航班当前态以自有 PG 为准（`INV-11b`）。 |
|
||||
| 出站请求 | 经 `COUTMSGS` 发向 AODB 的 `RQRD` 参考数据请求与 `RQFD` 日计划请求，消费方为 CIIMS adapter。 |
|
||||
| 运营航班显示界面 | Kafka 主题 `msg` 与 `schd` 的消费方，即需求所称网页客户端。 |
|
||||
| 运营航班显示界面 | 需求所称网页客户端：Kafka 侧称运营航班显示界面，查询侧称网页客户端（`GET /all/flights` / Redis）。 |
|
||||
| 航班历史 | 已结束航班写入 Elasticsearch 后的副本；写成功后才从实时数据删除。 |
|
||||
| 静态参考数据 | 13 类基础数据与资源状态，写自有 PG 的独立数据表，admin-api 直接只读。 |
|
||||
|
||||
@@ -38,8 +40,8 @@
|
||||
|
||||
- **C-3** 信箱编号不复位、不复用、不回退，含表轮换、备份恢复与自增归零。不丢消息依赖这条（`PRE-2`、`PRE-3`）。`（待确认 Q2）`
|
||||
- **C-4** 报文行不可变：同一业务身份（`SNDR`、`TYPE`、`STYP`、`SEQN`）的重发是同一内容。`（待确认 Q15）`
|
||||
- **C-5** 处理标记的允许值由库方认可，本系统只在该值集内写入；死信、跳过与回填失败的原因记在自有 PG，不在信箱新增取值。
|
||||
待确认：允许值的具体取值（`Q7`）。
|
||||
- **C-5** 处理标记即处理时间列：本系统只写完成时刻、只填空值（`C-15`），不在该列引入状态码等其它语义；死信、跳过与回填失败的原因记在自有 PG。
|
||||
待确认：处理时间列的列名、类型与可空性（`Q7`）。
|
||||
- **C-6** 原文的保留期与清除时机由库方定；本系统不承诺清除时间，只要求不早于 `C-7` 的下界。`（待确认 Q7、Q9）`
|
||||
- **C-7** 保留期下界分两层：回填重试期间信箱行必须仍在、标记列仍为空——`US-10` AC2 的重试需要的是可更新的行，不是原文；处理未完成的消息原文必须仍在——下轮重处理（`US-03` AC3）以原文为依据。`（待确认 Q7、Q9）`
|
||||
- **C-8** 清除由库方执行；本系统不执行 DDL、不清数据、不写共享历史表（`C-14`）。清除是否需要标记以外的证据，另行确认。`（待确认 Q9）`
|
||||
|
||||
Reference in New Issue
Block a user