ouyangxq
19745e46c1
18 个服务与公共模块重复复制的 314 字符数据库访问约束改为指向后端根唯一定义，并给索引门禁增加防退化校验。 - 18 处重复段落合并为一句指针，规则正文只在后端根 AGENTS.md 维护 - 门禁新增路由表行宽上限（根/Admin/Client/后端根/海外 PDA），防止业务规则重新回流表格 - 同步包含此前未提交的链接与锚点、表格存在性校验 - 仅索引文档与门禁脚本，未改动业务代码
1.8 KiB
1.8 KiB
Gateway 模块指引
数据库访问与中文注释约束
- 强制继承
../AGENTS.md的“数据库访问与中文代码注释”全部规则；该节是分层、SQL 执行和方法/核心逻辑中文注释的唯一维护处，本模块不另设例外。
职责与边界
- 负责路由、CORS、JWT/Redis 会话校验、平台/客户访问域隔离、请求标识和 Swagger 聚合。
- 只做入口认证，不做业务编排；下游服务仍必须校验客户归属、数据范围和权限。
模块入口与验证
- 应用：
BaiyueGatewayApplication.java - Security/访问域：
config/GatewaySecurityConfig.java、AppScopeAuthorizationManager.java - 会话/CORS/请求头：
config/RedisTokenSessionWebFilter.java、GatewayCorsConfiguration.java、filter/TrustedIdentityHeaderFilter.java、CorrelationIdWebFilter.java - 路由配置：
src/main/resources/application*.yml、../config/nacos/test/gateway.yml - 测试：
src/test/java/com/baiyue/gateway/；mvn -pl gateway -am test
修改约束与分期
- 新增路由同步检查本地/Nacos、App Scope、CORS、公开路径和 Swagger；不得暴露内部令牌接口。
- 订单与客户承载登录后 Admin/Client 入口；入库测量与计费接入到仓/测量/计费公开路由但保持内部测量接口隔离；国内货柜履约仅在 Controller、权限和公开访问域契约稳定后新增必要路由，内部 PDA、仓储和服务令牌接口继续不得经 Gateway 暴露。
- 已知路由任务直接核对目标 Controller、公开访问域、权限、Gateway 配置和 OpenAPI；只有货柜业务范围或流程门禁不明时，才从
../../docs/国内货柜履约/README.md或../../docs/头程到尾程/README.md进入。归档开工门禁仅用于历史追溯，不以新增路由推定业务已完成。