From ba7494242d359e33af588963fb9a3d6480963fd5 Mon Sep 17 00:00:00 2001 From: windyboy Date: Wed, 16 Sep 2026 11:40:43 +0800 Subject: [PATCH] =?UTF-8?q?docs(acm2-75):=20=E6=9C=AF=E8=AF=AD=E8=A1=A8?= =?UTF-8?q?=E5=8E=BB=E5=A5=91=E7=BA=A6=E5=8C=96=E5=B9=B6=E4=BF=AE=E6=AD=A3?= =?UTF-8?q?=E5=AE=8C=E6=88=90=E4=B8=8E=E6=8A=95=E5=BD=B1=E5=AE=9A=E4=B9=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/specification.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/specification.md b/docs/specification.md index 634aace..9169a4e 100644 --- a/docs/specification.md +++ b/docs/specification.md @@ -16,18 +16,18 @@ | 术语 | 含义 | |---|---| | 上游 | 产生报文的 AODB，报文经 CIIMS adapter 写入信箱。 | -| 信箱 | 共享 MySQL 的 `CMINMSGS`（入站）与 `COUTMSGS`（出站），归库方所有；本系统不建表、不改表结构、不清数据（`C-14`）。读与写的边界见 `C-30`、`C-24`、`C-28`。 | +| 信箱 | 共享 MySQL 的 `CMINMSGS`（入站）与 `COUTMSGS`（出站），归库方所有；边界见 `C-14`。 | | 库方 | 信箱所在的共享 MySQL 管理方，即 CIIMS adapter 方。 | -| 处理标记 | 即信箱行上的处理时间：为空表示未处理，处理完成时写入完成时刻；只填空值，不回撤、不覆盖。 | +| 处理标记 | 即信箱行上的处理时间：为空表示未处理，处理完成时写入完成时刻；写规则见 `C-15`。 | | 落信 | 报文写入信箱成为一行；入站由 CIIMS adapter 或兼容入口写入，出站由本系统写入 `COUTMSGS`；入站报文写进信箱后可能尚未登记。 | | 登记 | 本系统在自有 PG 为这条报文建立处理记录，排队等待处理。 | -| 处理完成 | 该消息的全部本地副作用已持久化、对外投影（若有）已写成功，此后才允许回填与投递（`US-03` AC4）；各类别的判据见 `INV-23`、`INV-31` 与架构「主流程」。 | +| 处理完成 | 该消息已得到处理结果，此后才允许回填与投递（`US-03` AC4）；成功类判据见 `INV-23`、`INV-31` 与架构「主流程」，非法与不支持见 `US-03` AC2。 | | 回填 | 把处理标记写回信箱行。 | | 投递 | 读待发事件发 Kafka。 | -| Redis 投影 | 供页面与 `GET /all/flights` 查询的航班数据；只由本系统写入和移除，不作权威。 | +| Redis 投影 | 供 `GET /all/flights` 与运营航班显示界面查询的航班数据，内容来自自有 PG 当前态；读写边界见 `INV-24`。 | | 自有 PG | 本系统唯一的业务数据库；航班当前态、管道记录与静态参考数据都在这里。 | -| 权威 | 航班当前态以自有 PG 为唯一权威，信箱、Redis、Kafka 与展示视图均不作权威。 | -| 出站请求 | 经 `COUTMSGS` 发向 AODB 的 `RQRD` 参考数据请求与 `RQFD` 日计划请求。 | +| 权威 | 航班当前态的唯一权威是自有 PG（`INV-11b`）。 | +| 出站请求 | 经 `COUTMSGS` 发向 AODB 的 `RQRD` 参考数据请求与 `RQFD` 日计划请求，消费方为 CIIMS adapter。 | | 运营航班显示界面 | Kafka 主题 `msg` 与 `schd` 的消费方，即需求所称网页客户端。 | | 航班历史 | 已结束航班写入 Elasticsearch 后的副本；写成功后才从实时数据删除。 | | 静态参考数据 | 13 类基础数据与资源状态，写自有 PG 的独立数据表，admin-api 直接只读。 |