基于 SpringBoot 3.5.6 开发的 Java 后端后台管理业务基础框架，常用的业务功能已经集成，开箱即用，相关使用说明，可以参考：

• 快速开始
• 指南

主要更新

3.5.1 将兼容使用 Gradle 管理项目，随着项目的体积越来越大，模块越来越多，在传统的 Maven 项目中，无论是编译或是打包运行，都让项目变得越来越缓慢，所以引入了 Gradle 的项目配置，新项目直接选择使用 Gradle 管理就行了，如果是老项目升级，可以参考：Maven 项目迁移到 Gradle

• 更新存在漏洞的相关依赖

在实际项目中，我们需要保存文件，比如用户上传的头像，或者上传的文档，一般不会保存到数据库中，而是保存到文件系统，比如本地文件系统，或者云存储。文件服务整合本地文件系统、阿里云OSS、MinIO、FastDFS，提供统一的接口操作文件的上传和下载删除操作，开发者后续也可以自行实现接口扩展。

除了已经集成的 RPC 框架（Spring Cloud OpenFeign、Apache Dubbo）之外，也提供了消息队列的解决方案，比如 Kafka、RabbitMQ 等。

在实际开发过程中，如果有涉及到和第三方的对接，我们会提供一些接口出去，但是，如果有很多对接方，那么，后续升级接口，就会导致接口的版本问题，所以，这边建议写接口的时候呢，加上版本号，
对接旧接口的继续使用，不会影响，新接口的，则需要加上更高的版本号，这样，当对接方升级的时候，就会自动使用新的接口，而不会影响到旧接口的使用。

目录结构来区分

.
`-- controller
    |-- v1
    |   `-- SysUserController.java
    |-- v2
    |   `-- SysUserController.java
    `-- v3
        `-- SysUserController.java

角色权限控制（RBAC）是一种基于角色的权限控制方式，它将用户分配给不同的角色，每个角色都有一组权限，用户只能访问自己角色所拥有的权限。

角色

角色是权限控制中的核心概念，它表示一组权限。

权限

权限是角色所拥有的权限，它表示用户可以执行的操作。

菜单权限（查看权限）

菜单权限表示用户可以查看的菜单。

接口权限（操作权限）

在前端来看表示用户可以点击哪些按钮进行操作，在后端来看表示用户可以访问哪些接口进行操作。

E-R 模型

使用说明

1. 单体架构

使用说明

1. 单体架构

基于 SpringBoot 3.2.5 开发的 Java 后端后台管理业务基础框架，常用的业务功能已经集成，开箱即用，相关使用说明，可以参考：

• 快速开始
• 指南

主要更新

工具包

• 核心模块
  • 【优化】WebSocket 优化
      1. 新增 topic 类型 system，用于系统发送消息，例如连接是否成功这种提示
      2. 消息载体改为 WSR（类似 R 对象），这种类似 http 接口的消息返回方式，让返回结构统一
      3. 新增了消息发送状态的判断方法以及默认的实现
      4. 优化了二进制传输
      5. 消息用户的反馈更精准（使用 session 绑定每次的消息）
  • 【优化】History 相关的都修改为 DBOperateHistory，因为有些 Bean 冲突问题
  • 【优化】修改部分 final class 为 record
  • 【修复】MyBatisUtil 获取 JSON 的时候需要做非空判断

    if (field.isAnnotationPresent(TableFieldJSON.class) && ObjectUtil.isNotEmpty(fieldValue))
  • 【修复】文件上传空文件拦截异常，如果上传了一个空的文件，比如一个空的 word 文件，就会报异常

    /**
     * 检测文件是否为空
    *
    * @param wordFile 文件
    */
    private static void checkWordFileEmpty(MultipartFile wordFile){
        if (isWordFileEmpty(wordFile)){
            throw new FileUploadException("上传文件不能为空");
        }
    }
  • 【修复】修复不合适的依赖

    import org.ehcache.impl.internal.concurrent.ConcurrentHashMap;
    修改为
    import java.util.concurrent.ConcurrentHashMap;
  • 【升级】为了让项目可以最小化运行，兼容了 Sqlite
    top 情况：

    top - 17:25:51 up 13 days, 6 min,  3 users,  load average: 0.00, 0.00, 0.00
    Tasks: 110 total,   2 running, 108 sleeping,   0 stopped,   0 zombie
    %Cpu(s):  0.2 us,  0.0 sy,  0.0 ni, 99.7 id,  0.2 wa,  0.0 hi,  0.0 si,  0.0 st
    MiB Mem :   1613.1 total,    143.8 free,    817.9 used,    819.9 buff/cache
    MiB Swap:      0.0 total,      0.0 free,      0.0 used.    795.2 avail Mem
    
      PID USER      PR  NI    VIRT    RES    SHR S  %CPU  %MEM     TIME+ COMMAND
    87183 root      20   0 3039528 505164  29056 S   1.0  30.6   1:59.76 java
    free 情况：

                  total        used        free      shared  buff/cache   available
    Mem:           1.6Gi       817Mi       143Mi       2.6Mi       819Mi       795Mi
    Swap:             0B          0B          0B