docs: 补充架构文档与设计文档(docs/architecture.md + docs/design.md)

- architecture.md:系统定位与双跑策略、技术栈、总体拓扑(两条单线程管道)、
  模块职责、关键决策 D1–D8、数据边界(六辅助表 vs legacy 旧表)、两阶段权威
  与就绪度(诚实口径:生产默认不可服务,前置 U05/U07/U09/U13/U15)、
  部署与安全姿态、可观测性。
- design.md:状态机与错误分类(含重放白名单)、六表数据模型(含 U18 已知缺口)、
  流程 1–4 与泵作业语义、失败/重试统一设计(U08)、不变量 I1–I5 落点、
  参数表、测试策略、可观测性、缺口清单对照 ACM2-10 U01–U30。
- README:新增文档导航;关联节按 ACM2-10 T16 修正改为 ACM2 现行入口
  (ACM2-3 架构权威 / ACM2-4 脚手架 / ACM2-10 评审),ACMA 仅归档。
This commit is contained in:
windyboy
2026-09-06 22:30:03 +08:00
parent 6c887adf56
commit f0411da5fa
3 changed files with 361 additions and 2 deletions
+10 -2
View File
@@ -69,7 +69,15 @@ MICRONAUT_ENVIRONMENTS=dev ./gradlew run # dev stub 冒烟:内存仓储 +
> dev/shadow 冒烟装配:`msgx.stubs=true`(内存仓储/适配层,见 infra/stub+
> `msgx.pipeline.autostart=true`PipelineLifecycle 拉起专用线程,U07);生产默认两者关闭。
## 文档
- [docs/architecture.md](docs/architecture.md):架构速览——总体拓扑、模块职责、关键决策、
数据边界、部署与安全姿态、可观测性、就绪度(与代码同步维护)。
- [docs/design.md](docs/design.md):设计细节——状态机与错误分类、数据模型、核心流程语义、
失败/重试/重放统一设计、不变量落点、参数表、测试策略、已知缺口(对照 ACM2-10)。
## 关联
Plane `airport_chengdu_msgexchange_api`ACMA-9(本阶段跟踪)、ACMA-8 v4(架构)、
ACMA-6(技术选型)、ACMA-3(总计划)、ACMA-4(行为对拍基线)。
Plane `airport_chengdu_msgexchange_api`**ACM2 为现行入口**):ACM2-3(综合架构 v4,
架构权威)、ACM2-4(脚手架跟踪)、ACM2-10(评审与实施计划 U01U30);ACMA 系列仅作
归档历史/迁移来源(ACMA-8 v4 / ACMA-6 选型 / ACMA-9 JDK 口径在归档中可溯)。