From 56ad8c9220423e9e2ab67112d78a298abfb66c73 Mon Sep 17 00:00:00 2001 From: windyboy Date: Wed, 16 Sep 2026 11:12:09 +0800 Subject: [PATCH] =?UTF-8?q?docs(acm2-75):=20=E6=94=B6=E7=AA=84=20c30=20?= =?UTF-8?q?=E5=86=99=E8=BE=B9=E7=95=8C=E5=B9=B6=E4=BF=AE=E6=AD=A3=E6=9E=B6?= =?UTF-8?q?=E6=9E=84=E6=89=AB=E6=8F=8F=E8=B0=93=E8=AF=8D=E6=8C=87=E9=92=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/architecture.md | 2 +- docs/specification.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/architecture.md b/docs/architecture.md index 162c794..26fba69 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -8,7 +8,7 @@ msgexchange-v2 是 OMMS H5 查询系统的消息网关，替换旧版 `msgexchan 功能需求是 [requirements.md](requirements.md) 的十四条用户故事（采集、处理、投递、查询、维护，`US-01`～`US-14`），运行需求是四条验收（单实例、可观测、测试隔离、切换回退，`OPS-1`～`OPS-4`）。不生成航班/业务数据类报文，不替代 CIIMS/AODB，不调用 admin-api；完整非目标见同文件「范围与非目标」。 -- **主要入口**：轮询共享 MySQL 入站表 `CMINMSGS`，只取处理时间为空的行，按编号升序、每批有上限（`US-01`；`C-30`）。 +- **主要入口**：轮询共享 MySQL 入站表 `CMINMSGS`，只取处理时间为空的行，按编号升序、每批有上限（`US-01`；`INV-2b`）。 - **兼容入口**：`POST /cminmsgs/send` 供联调工具把报文写进信箱，与上游投递走同一条处理路径；返回的编号只表示已进信箱，不代表已处理或下游已收到（`US-02`）。 - **查询入口**：`GET /all/flights` 返回当前全部动态航班（不含共享航班），读 Redis，与网页客户端同源（`US-12`；`INV-24`）。 - **出站**：只向 AODB 发参考数据请求 `RQRD` 和日计划请求 `RQFD`，经共享 MySQL 出站表 `COUTMSGS`，由 CIIMS adapter 消费；只保证请求写入信箱，不保证 AODB 收到（`US-09`；`C-24`）。 diff --git a/docs/specification.md b/docs/specification.md index b974dbc..f41c2de 100644 --- a/docs/specification.md +++ b/docs/specification.md @@ -47,7 +47,7 @@ - **C-14** 本系统不建表、不改表结构、不迁移 schema、不清数据，也不写共享历史表。 - **C-15** 处理标记只在空值上写入处理完成时刻，写完不回撤、不覆盖已有值。`（本系统单方承诺）` - **C-16** 回填失败的行保留记录并告警，记录在对应信箱行被清除前保持可查。`（本系统单方承诺）` -- **C-30** 本系统读取信箱不加锁、不阻塞写入方，读取谓词、顺序与批量以 `INV-2b` 为准；除回填处理标记（`C-15`）外不写信箱。 +- **C-30** 本系统读取入站信箱 `CMINMSGS` 不加锁、不阻塞写入方，读取谓词、顺序与批量以 `INV-2b` 为准；除回填处理标记（`C-15`）与兼容入口落信（`C-28`）外不写 `CMINMSGS`。`COUTMSGS` 的写入见 `C-24`。 - **C-34** 切换与回退以信箱处理标记交接（`OPS-4`、`PRE-1`）：切回旧系统前，「已终态但未回填」的行必须清零——每条终态行的处理标记都已写上才算交接完成。放弃自动重试的行标记仍为空（放弃不等于标记已确认），本系统没有任何能阻止旧系统消费它的可观察状态（`C-15` 只填空值、不覆盖）：必须先人工恢复重试至打标，或与库方另行定处置（`Q9`）；否则这些行切回后会被旧系统再处理。已登记、未到处理完成的消息同样没有交接状态。 待确认：在途消息的回退处置（`Q21`）。