System 数据库设计总览
System 负责用户组织、权限租户、字典公告、认证、通知和系统审计，并消费 TDengine 分钟访问统计。本次整理覆盖 32 个 MySQL 实体表、1 个 TDengine 超级表与 Redis 使用点 。32 个 MySQL 表均已在测试环境确认，完整实库字段共 472 列；额外列、索引和配置缺口见实测对照。
数据源与证据
| 使用范围 | 服务路由 | 配置引用 / 目标 | 核验边界 |
|---|---|---|---|
| 32 个关系表 | 默认 master | datasource.system → ik_yudao_system | 已采集元数据，未启动服务 |
| 访问统计 | tdApiVisit | datasource.td_api_visit 未在提供配置中定义；SQL 明确 monitor.visit_minute | 同测试 TD 实例额外只读采集 monitor；不等价于验证服务配置 |
| 缓存、QwenPaw、验证码 | Redis | application-common.yaml 的 DB 0 | 只核对源码和配置，未连接 Redis |
| ES | 未发现本服务直接对象 | 无本服务 ES 索引实体 / Mapper | 不推断共享 ES 实例无数据 |
配置入口：doc/数据库设计管理/nacos/system-server.yaml:8、datasource.yaml:41、application-common.yaml:35。TD 常量见 ik_project/yudao-cloud/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/framework/core/constant/DataSourceConstants.java:20。源码相对路径均相对工作区；本文 Java 根为 ik_project/yudao-cloud/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/。
阅读导航与完整源码对象清单
| 业务域 | 对象 |
|---|---|
| 用户、部门与岗位 | system_dept、system_post、system_user_post、system_users |
| 角色与菜单权限 | system_menu、system_role、system_role_menu、system_user_role |
| 租户与套餐 | system_tenant、system_tenant_package |
| 字典与公告 | system_dict_data、system_dict_type、system_notice |
| OAuth2 授权与令牌 | system_oauth2_access_token、system_oauth2_approve、system_oauth2_client、system_oauth2_code、system_oauth2_refresh_token |
| 第三方登录与社交账号 | system_social_client、system_social_user_bind、system_social_user |
| 短信渠道、模板与发送记录 | system_sms_channel、system_sms_code、system_sms_log、system_sms_template |
| 邮件与站内信 | system_mail_account、system_mail_log、system_mail_template、system_notify_message、system_notify_template |
| 登录与操作审计 | system_login_log、system_operate_log |
| 分钟访问统计 | monitor.visit_minute；20 个实测子表（动态名称） |
| Redis 与框架存储 | Spring Cache、OAuth Token、QwenPaw Hash / Token / 锁、验证码、微信 SDK |
各业务域列出实体和 Mapper 路径行号、全部业务字段、继承字段、查询入口及逻辑关联。公共映射解释继承、JSON 和租户 SQL 拦截；实测对照包含逐表字段数和差异清单。
关系与数据边界
用户—角色—菜单、用户—部门/岗位、租户—套餐构成本服务核心关系。通知、审计和 OAuth 用户引用需同时解释 user_id 与 user_type；业务表中的 user_id、creator、updater 可能由其他微服务使用，本服务保有用户身份定义，不因引用而变成跨库物理外 键。实测没有 MySQL 物理外键。
全部 SQL 表名固定，System 源码未定义动态 MySQL 分表。TDengine 子表名由统计时间和接口参与生成；System 当前 Mapper 是统计读取方。Redis QwenPaw 对象是用户接入与异步状态持久信息，区别于可重建的 Spring Cache。
本目录只新增文档。原 SQL 脚本未作为实库依据，业务代码和旧文档保持原样；未执行构建、应用启动或业务测试。