docs: 合并文档目录——doc/ 与根目录基线材料统一入 docs/legacy/

消除 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 拷贝参考)。
This commit is contained in:
windyboy
2026-09-07 08:29:49 +08:00
parent e0ce863905
commit 8c8d2613c2
5 changed files with 8 additions and 4 deletions
+5 -2
View File
@@ -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_MASTERPG 方言),ACM2-12 定案;
共享 MySQLCMINMSGS/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`(消息结构唯一事实源)。
## 关联
+2 -1
View File
@@ -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 ⑤)。
@@ -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. 系统定位与集成边界