From 8c8d2613c2f407d11a8215a6ef133f409be0e70b Mon Sep 17 00:00:00 2001 From: windyboy Date: Mon, 7 Sep 2026 08:29:49 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=88=E5=B9=B6=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E7=9B=AE=E5=BD=95=E2=80=94=E2=80=94doc/=20=E4=B8=8E=E6=A0=B9?= =?UTF-8?q?=E7=9B=AE=E5=BD=95=E5=9F=BA=E7=BA=BF=E6=9D=90=E6=96=99=E7=BB=9F?= =?UTF-8?q?=E4=B8=80=E5=85=A5=20docs/legacy/?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 消除 doc/ vs docs/ 双目录混淆（git mv 保留历史）： - doc/msgexchange-api-legacy-user-stories.md → docs/legacy/ - doc/unisysaodbsis.xsd → docs/legacy/ - SIS_AODB_RMS-V0.1.md（根目录 703KB）→ docs/legacy/ - 删除空 doc/ 目录；README「文档」导航补充 docs/legacy/（外部参考/基线材料， 非本系统文档）；更新 README/architecture 与基线文档自引的路径引用。 docs/ 现为：architecture.md、design.md（自产）+ legacy/（legacy 拷贝参考）。 --- README.md | 7 +++++-- docs/architecture.md | 3 ++- SIS_AODB_RMS-V0.1.md => docs/legacy/SIS_AODB_RMS-V0.1.md | 0 .../legacy}/msgexchange-api-legacy-user-stories.md | 2 +- {doc => docs/legacy}/unisysaodbsis.xsd | 0 5 files changed, 8 insertions(+), 4 deletions(-) rename SIS_AODB_RMS-V0.1.md => docs/legacy/SIS_AODB_RMS-V0.1.md (100%) rename {doc => docs/legacy}/msgexchange-api-legacy-user-stories.md (99%) rename {doc => docs/legacy}/unisysaodbsis.xsd (100%) diff --git a/README.md b/README.md index efafb13..7a2ac5c 100644 --- a/README.md +++ b/README.md @@ -24,8 +24,8 @@ ACM2-11/ACM2-12 定案**（自有 PostgreSQL 全内部状态 + 共享 MySQL 仅 ## 资源 -- `SIS_AODB_RMS-V0.1.md` + `doc/unisysaodbsis.xsd`：**消息结构唯一事实源**（wire 契约冻结， - 自 legacy 仓库复制以自包含；codec 实装依据，ACM2-2/ACM2-3）。 +- `docs/legacy/SIS_AODB_RMS-V0.1.md` + `docs/legacy/unisysaodbsis.xsd`：**消息结构唯一事实源** + （wire 契约冻结，自 legacy 仓库复制以自包含；codec 实装依据，ACM2-2/ACM2-3）。 - `db/migration/V1.0.0__own_pg_pipeline.sql`：**自有 PostgreSQL**（唯一自有库）表结构 （PROC_STATE / MSG_EVENT / PUMP_JOB / REQ_TRACK / REF_MASTER，PG 方言），ACM2-12 定案； 共享 MySQL（CMINMSGS/COUTMSGS）仅信箱 DML 不建表；快照 gen 与航班动态在 Redis。 @@ -96,6 +96,9 @@ MICRONAUT_ENVIRONMENTS=dev ./gradlew run # dev stub 冒烟：内存 stub，无 数据边界、部署与安全姿态、可观测性、就绪度（与代码同步维护）。 - [docs/design.md](docs/design.md)：设计细节——状态机与错误分类、数据模型、核心流程语义、 失败/重试/重放统一设计、不变量落点、参数表、测试策略、已知缺口（对照 ACM2-10）。 +- [docs/legacy/](docs/legacy/)：外部参考/基线材料（自 legacy 仓库拷贝，非本系统文档）—— + `msgexchange-api-legacy-user-stories.md`（行为对拍基线，ACMA-4）、`unisysaodbsis.xsd`、 + `SIS_AODB_RMS-V0.1.md`（消息结构唯一事实源）。 ## 关联 diff --git a/docs/architecture.md b/docs/architecture.md index d904cfc..96c02f6 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -19,7 +19,8 @@ - legacy 维护不受本仓库影响；本仓库不声明 legacy 旧表 schema，**且不在共享 MySQL 建任何表** （CMINMSGS/COUTMSGS 所在库属他人系统，本系统仅信箱 DML——ACM2-12，见 §6）。 -- wire 契约冻结：消息结构唯一事实源为 `SIS_AODB_RMS-V0.1.md` + `doc/unisysaodbsis.xsd`； +- wire 契约冻结：消息结构唯一事实源为 `docs/legacy/SIS_AODB_RMS-V0.1.md` + + `docs/legacy/unisysaodbsis.xsd`； HTTP 端点路径与响应语义沿用现役（如 `POST /cminmsgs/send` 返回记录 ID）。 - **影子对拍口径（ACM2-12）**：共享库是单信箱无法"同入口双收"，影子输入改以共享库只读 水位/回放 + 自有 PG 独立 schema 比对（详见 §8 与 ACM2-12 Checks ⑤）。 diff --git a/SIS_AODB_RMS-V0.1.md b/docs/legacy/SIS_AODB_RMS-V0.1.md similarity index 100% rename from SIS_AODB_RMS-V0.1.md rename to docs/legacy/SIS_AODB_RMS-V0.1.md diff --git a/doc/msgexchange-api-legacy-user-stories.md b/docs/legacy/msgexchange-api-legacy-user-stories.md similarity index 99% rename from doc/msgexchange-api-legacy-user-stories.md rename to docs/legacy/msgexchange-api-legacy-user-stories.md index 050de84..5497ee8 100644 --- a/doc/msgexchange-api-legacy-user-stories.md +++ b/docs/legacy/msgexchange-api-legacy-user-stories.md @@ -4,7 +4,7 @@ - 本文档记录 msgexchange-api（现役旧项目）的完整业务逻辑，并以用户故事形式组织，作为新系统（Micronaut + Kotlin）迁移设计及一致性对拍的行为基线。 - 内容依据仓库源码与资源配置编写：`src/main/java/com/gzzn/omms/msgexchange-api/**`、`src/main/resources/*.yml`；分支 `feature/add_dev_containers_supports`（HEAD `eb72a668`）。 -- 报文结构依据 `SIS_AODB_RMS-V0.1.md` 与 `doc/unisysaodbsis.xsd`。 +- 报文结构依据 `SIS_AODB_RMS-V0.1.md` 与 `unisysaodbsis.xsd`（同目录 docs/legacy/）。 - 文档中"关联代码"均为相对仓库根目录的源码路径，可据此逐条复核。 ## 1. 系统定位与集成边界 diff --git a/doc/unisysaodbsis.xsd b/docs/legacy/unisysaodbsis.xsd similarity index 100% rename from doc/unisysaodbsis.xsd rename to docs/legacy/unisysaodbsis.xsd