标签: Spring Cloud

即时通讯（WebSocket）

即时通讯（WebSocket）在项目里面很常见，例如消息通知，实时翻译，语音转译等等。本框架在集成了 WebSocket 的基础上，实现了简单的消息通知以及角标统计功能，并且对于集成的 WebSocket 功能做了抽象优化，后续你可以自己实现自己的 WebSocket 功能。

消息通知

框架已经实现了简单的消息通知功能，并且加上了实时通知，这需要前端先连接上服务器，然后，服务端会向前端推送消息。

前端连接服务器

参考：示例项目的 WebSocket 配置

Mango Crisp2026年9月21日大约 2 分钟

3.5.1

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

主要更新

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

Mango Crisp2025年11月28日大约 4 分钟

接口版本

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

目录结构来区分

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

Mango Crisp2025年10月29日大约 1 分钟

基于角色的权限控制（Role Based Access Control）

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

角色

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

权限

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

菜单权限（查看权限）

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

接口权限（操作权限）

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

E-R 模型

Mango Crisp2025年10月29日大约 3 分钟

3.5.0

重要！重要！

介于开源需要，本项目已经由组织 TayBct 来维护，原来的部分仓库已经转移到组织 TayBct 的项目下，请移步

Mango Crisp2025年10月27日大约 6 分钟

流程引擎

使用说明

1. 单体架构

Mango Crisp2025年9月29日大约 3 分钟

在线文档

使用说明

1. 单体架构

Mango Crisp2025年9月29日大约 3 分钟

3.2.4

基于 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

Mango Crisp2025年9月28日大约 5 分钟

3.5.2

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

主要更新

3.5.2 主要更新了工具升级和一些业务功能，以及修复一些配置错误

工具包

Mango Crisp2025年3月10日大约 1 分钟

3.5.3

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

主要更新

3.5.3 定时任务，控制台日志管理功能 、 SQL注入的安全问题相关优化 、解决WebSocket 多模块并发问题

Mango Crisp2025年3月10日大约 7 分钟