概述

ShardMapHelperFacade 是专门为分库分表映射库表设计的门面服务，继承自 ShardHelperFacade 的所有功能，并新增了映射表特有的查询方法。

特点：

• ✅ 继承 ShardHelperFacade 所有方法
• ✅ 专门用于映射表（Map表）操作
• ✅ 新增非业务ID查询功能
• ✅ 新增模糊查询功能
• ✅ 内置 Redis Hash 缓存

版本: v1
作者: youhujun & xueer
更新日期: 2026-03-05

📖 概述

ModelMapRouterFacade 是游鹄生态中用于兼容单体和微服务架构的映射表查询门面服务。它是业务代码重构时查询映射表的主要入口。

核心特点

• ✅ 单体/微服务自动适配：根据配置自动选择查询方式
• ✅ 智能路由选择：单体时直接查询数据库，微服务时调用API
• ✅ 映射表模型映射：通过 modelFlagMap 管理映射表模型
• ✅ 统一接口：业务层无需关心底层架构，使用统一方法调用
• ✅ 支持所有映射表：通用方法，适配所有映射表（UserMap、OrderMap等）

版本: v1
作者: youhujun & xueer
更新日期: 2026-03-04

📖 概述

ApiRequestFacade 是游鹄生态中用于微服务之间API通信的安全请求门面服务。它提供了跨服务的加密请求、认证和响应处理功能。

核心特点

• ✅ AES 加密通信：请求参数使用 AES 加密传输
• ✅ 服务认证管理：自动获取和管理各服务的认证信息
• ✅ 统一请求封装：统一的请求头格式和参数加密
• ✅ 日志记录：自动记录请求和响应日志
• ✅ 多服务支持：支持 youhu-base、shard-map、youhu、youhushop、xuehu 等服务

版本: v1
作者: youhujun & xueer
更新日期: 2026-03-04

📖 概述

SyncDataFacade 是游鹄生态中用于同步数据到映射表的专用门面服务。它负责将主表的数据同步到对应的映射表中，以支持跨服务的数据查询和路由。

核心特点

• ✅ 自动创建/更新映射表：根据业务ID自动查询或创建映射表记录
• ✅ 分片路由支持：自动根据分片信息路由到正确的映射表分片
• ✅ 模型映射管理：通过 modelMap 管理不同模型映射表的同步逻辑
• ✅ 事件驱动：同步完成后自动触发事件通知
• ✅ 日志记录：自动记录同步操作日志

版本: v1
作者: youhujun & xueer
更新日期: 2026-03-05

📖 概述

QueryMapFacade 是游鹄生态中用于微服务间映射表查询的专用门面服务。它提供了通过非业务ID查询映射表的 API 接口，支持跨服务的映射表查询功能。

核心特点

• ✅ 模型映射管理：通过 modelMap 管理不同模型映射表的查询
• ✅ 非业务ID查询：支持通过账号名、手机号等非业务ID字段查询
• ✅ 模糊查询支持：支持模糊查询获取业务ID列表
• ✅ DTO 参数封装：使用 DTO 对象封装请求参数
• ✅ 日志记录：自动记录查询操作日志