本文基于 dromara (opens new window) / RuoYi-Vue-Plus (opens new window)，5.x 分支，2023-10-25 代码。

模块结构

ruoyi-common

ruoyi-common-core 核心模块

• 引入依赖：Spring、Spring MVC、hutool、离线 IP 地址定位等
• 定义了一些通用对象、工具类

ruoyi-common-json 序列化模块

• 引入依赖：jackson-databind
• 提供了 JsonUtils 工具类

ruoyi-common-mybatis 数据库服务

• 引入依赖：mybatis-plus、p6spy (sql 性能分析插件)、dynamic-datasource (多数据源)

• 配置了 Mybatis-plus 插件：数据权限、分页、乐观锁

ruoyi-common-tenant 租户模块

• 引入依赖：transmittable-thread-local
• 在 ruoyi-common-mybatis 模块的基础上，配置了多租户插件，并放在第一位。
• 对 CacheManager 缓存管理器进行了重写，追加了 {tenantId}: 前缀

ruoyi-common-security 安全模块

• 引用了 ruoyi-common-satoken
• 用于处理拦截器、全局异常处理

功能设计

客户端管理

客户端管理主要功能为对不同客户端配置不同的：Token 活跃超时时间、固定超时时间、可使用的登录方式。

登录功能

• 用户登录时，传递客户端 id、授权类型（密码、短信、第三方支付等）
  • 根据不同的客户端 id，成功登录后返回的 Token 时效不同
  • 根据不同的客户端 id，可使用的登录方式不同