首页 / Java 平台（cloud-java） / system 系统管理
system 系统管理
租户、后台用户、RBAC、字典、OAuth、通知模板与操作日志。
职责概览
系统管理模块 独立端口 48090，负责平台后台的基础治理能力：租户、后台用户、角色权限（RBAC）、菜单、数据字典、OAuth 登录、通知模板、短信/邮件渠道与操作审计。
- 面向
system_users（后台管理员域），与member_user（APP 会员域）严格分离。 - 接口前缀
/admin-api/system/...；权限标识以 Controller 上@PreAuthorize为准。
接口清单
| 分组 | Controller（示例） | 说明 |
|---|---|---|
| 认证 | AuthController | 后台登录、OAuth 授权、登出 |
| 用户/角色/菜单 | UserController、RoleController、MenuController | 用户管理、RBAC 角色授权、菜单权限 |
| 租户 | TenantController、TenantPackageController | 多租户与租户套餐 |
| 字典 | DictTypeController、DictDataController | 数据字典类型与数据；App 端也有只读字典接口 |
| 通知 | NotifyTemplateController、NotifyMessageController、NotifyMessageTaskController | 通知模板、站内信与消息任务（后台侧） |
| 短信/邮件 | SmsChannelController、SmsTemplateController、SmsLogController、MailLogController | 短信渠道/模板/日志、邮件日志；SmsCallbackController 处理回执 |
| 日志 | LoginLogController、OperateLogController | 登录日志与操作审计 |
| App 端 | AppTenantController、AppNotifyMessageController、AppDictDataController、AppAreaController 等 | 租户、站内信、字典、区域等只读/轻量接口 |
关键实现
| 能力 | 实现位置 | 说明 |
|---|---|---|
| 消息任务消费 | NotifyMessageTaskConsumer | RocketMQ 消费站内信发送任务并跟踪状态 |
| 短信发送 | SmsSendConsumer | 异步发送短信，失败重试与日志落库 |
| 邮件发送 | MailSendConsumer | 异步发送邮件 |
| 演示任务 | DemoJob（@XxlJob） | 定时任务示例，验证 XXL-JOB 链路 |
数据与维护注意
核心表：system_*（35 张），覆盖用户、角色、菜单、租户、字典、通知、短信/邮件、日志等。
- 后台用户
system_users与会员member_user是两个主体，查询与授权不得混用。 - 通知接收人字段需区分后台用户与会员用户语义，不按字段名机械替换。
- 新增菜单/权限需同步角色授权数据与前端路由；权限标识变更会影响既有接口。