公共组件边界

pigx-common 包含数据访问、Feign、Gateway、SSE/WebSocket、OSS、Milvus、Neo4j、Nacos MCP、日志、安全、加密脱敏、幂等、任务和 Swagger 等模块。

升级公共组件时按影响面回归：认证透传、租户过滤、异常响应、文件上传、长连接、消息消费、分布式锁和敏感字段脱敏。公共组件不得隐式持有业务状态。

组件如何影响 AI 服务

pigx-common-data 负责 TenantContext、MyBatis 租户处理和 Feign 租户透传；安全组件提供主体与权限上下文；Gateway 组件提供动态路由和健康指示器；SSE/WebSocket、OSS、Milvus、Neo4j、Nacos MCP、日志、加密脱敏、幂等和 XXl-Job 通过自动配置接入业务模块。

AI 服务中的 @TenantTable 实体、Feign 调用、FileRoom ACL、SSE 事件和异步消费都依赖这些上下文。新增 Controller 要确认统一异常和审计；新增 Feign 要确认 tenant header、超时、重试和熔断；新增长连接要确认代理超时、线程/连接上限和断线清理。

公共模块版本升级后至少回归登录与 refresh、跨租户访问、R<T> 错误结构、文件签名与断点上传、AI SSE、MCP tools/list、分布式锁、MQ 幂等、敏感字段脱敏和 Actuator 健康状态。