Appearance
支持与基建平台
平台层沿用 PigX 的注册、网关、认证、UPMS 和公共组件能力,并按墨台服务边界扩展 SSE、WebSocket、MCP、OSS、Milvus、Neo4j、幂等、加密、灰度和任务组件。
业务服务只依赖稳定的公共 API,不应直接复制认证、租户、文件签名、日志和幂等实现。
请求经过平台层的顺序
Browser/IM -> Gateway -> Auth 校验/主体上下文 -> UPMS/领域服务
-> Feign/API/MQ/MCP -> R<T>、SSE 或文件流
Gateway 负责入口路由和横切策略,Auth 负责身份认证与 Token,UPMS 负责用户、组织、角色、菜单和租户资源。领域服务仍要做资源级授权,不能把“网关已验证 Token”当成“用户可以读任意业务 ID”。
| 组件 | 主要职责 | 领域服务应依赖 |
|---|---|---|
| Nacos/Register | 服务发现、配置、健康状态 | 服务名和配置契约 |
| Gateway | 动态路由、认证透传、限流、跨域、长连接 | 稳定 URL 前缀 |
| Auth | OAuth2 登录、刷新、登出、验证码 | Token/主体上下文 |
| UPMS | 用户、角色、菜单、部门、租户 | Feign/API DTO |
| pigx-common | 租户、Feign、异常、SSE、OSS、锁、日志 | 公共接口和自动配置 |
公共组件升级必须回归认证透传、租户过滤、统一异常、SSE/WebSocket、文件签名、Feign 重试和幂等。公共模块不应持有某个业务域的状态。