You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Real-time-monitoring/CHANGE.md

1030 lines
45 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 更新日志
## v1.3.2-beta 20260116
> [!NOTE]
>
> [升级指南](https://szadmin.cn/md/Help/doc/other/upgrade.html#v1.3.2-beta)
### sz-boot-parent
#### 新增
- [代码生成器] 支持选择弹窗类型(抽屉、弹窗)。
- 通用 API新增获取 OSS 私有文件访问 URL 接口。
- 通用 API新增文件下载接口。
- 参数管理新增「是否前端加载」字段。
- websocket新增支持同步字典、权限和前端参数。
#### 修改
- oss.yml 配置,新增 `oss.richtextBucketName` 配置项,用于为富文本编辑器**单独指定** bucket
#### 优化
- 优化逻辑删除监听器的登录状态检查增加异常处理以支持非Web环境
---
### sz-admin
#### 新增
- [代码生成器] - 增加弹窗类型的支持(抽屉、弹窗)。
- 参数 / 字典 / 权限的 websocket同步支持并在参数管理中新增「是否前端加载」配置。
- 新增: useDialogWidth Hook 组件,实现弹窗/对话框宽度的动态自适应。
#### 重构
- 重构 websocket实现将消息解析与频道处理逻辑解耦结构更清晰、扩展性更强。
#### 修复
- 修复 `MenuForm.vue` 中目录类型的可操作属性,恢复路由名称和路由地址属性。([issue 25](https://github.com/feiyuchuixue/sz-admin/issues/25))。
- 修复 `SearchFormItem` 组件仅在搜索项配置 `enum` 时读取 `undefined` 导致的报错问题。现在在 `SearchProps``ColumnProps` 任一处配置 `enum` 即可正常使用。([issue 26](https://github.com/feiyuchuixue/sz-admin/issues/26))。
#### 优化
- `Avatar` 头像组件:增加对 OSS 私有访问地址的支持。
- `FileDownloadList` 文件回显展示组件:增加对 OSS 私有访问地址的支持。
- `Img` 图片组件:增加对 OSS 私有访问地址的支持。
- `Imgs` 多图片组件:增加对 OSS 私有访问地址的支持。
- 账户管理 - 添加/编辑用户:头像字段增加对 OSS 私有访问地址的支持。
- `JoditEditor` 富文本组件:支持使用独立的 bucket 空间(通过 `oss.richtextBucketName` 配置)。
- 文件管理列表:优化文件下载方式。
- `useUrlDownload`:移除前端 Fetch 下载逻辑,改为调用通用 API 文件下载接口,解决文件跨域问题。
### 数据库变更
- 更新 `sys_config` 表:增加 `frontend_visible` 字段,用于标记参数是否需要前端加载、缓存及使用。
- 更新 `generator_table` 表:增加 `window_show_type` 字段用于配置窗口展示方式0dialog 弹窗1drawer 抽屉)。
## v1.3.1-beta 20251210
> [!NOTE]
>
> [升级指南](https://szadmin.cn/md/Help/doc/other/upgrade.html#v1.3.1-beta)
### sz-boot-parent
#### 依赖升级
- modelmapper3.2.6
- mybatis-flex1.11.4
- commons-lang33.20.0
- swagger-annotations2.2.41
- lombok1.18.42
- org.lionsoul-ip2region3.1.0
- springdoc-openapi-starter-webmvc-ui2.8.14
#### 新增
- 添加 .editorconfig 文件以统一编码和行结束符设置。
#### 修复
- 代码生成设置中的业务名称修改后路由路径不生效问题。(感谢[lxwcv](https://github.com/lxwcv)
- spring-doc 增加开关控制参数 `springdoc.api-docs.enabled``springdoc.swagger-ui.enabled`,生产环境建议关闭。
- 更新ip2region 版本为3.1.0 RegionUtils 以支持 IPv4 地址库,改进 IP 地址库加载逻辑。
#### 修改
- 演示案例 - [教师统计] 增加富文本编辑器功能。
#### 优化
- 更新Dockerfile安装curl支持容器内的健康检查。
- [代码生成器] - 添加 jodit-editor 富文本编辑器的支持。
- 代码模板 Dialog 弹窗组件添加动态宽度的支持。
---
### sz-admin
### 依赖升级
- 对package.json文件中的依赖进行了兼容性升级。
#### 新增
- 新增:添加.editorconfig文件。
- 富文本编辑器组件-JoditEditor。
- 新增: useDialogWidth Hook 组件,实现弹窗/对话框宽度的动态自适应。
#### 重构
- [UploadFiles 组件] 增加多项功能并修正若干问题。
- 角色管理-权限分配组件重构,提升交互体验。
#### 优化
- 权限组件,暗黑模式下的样式不适配的问题。
- 多维选择器组件,暗黑模式下的样式不适配的问题。
- 更新表格组件的 rowKey 属性为可选,并修复 radio 组件的类型问题。
#### 修复
- 更新protable组件部分类型问题。
#### 修改
- 演示案例 - 【教师统计】 增加富文本编辑器功能。
- 【代码生成器】- 添加 jodit-editor 富文本编辑器的支持。
### 数据库变更
- 更新 `teacher_statistics` 表:增加`content_html`字段及演示数据。
## v1.3.0-beta 20251109| 大型更新
> [!NOTE]
>
> [升级指南](https://szadmin.cn/md/Help/doc/other/upgrade.html#v1.3.0-beta)
>
> <font color="red">!存在潜在破坏性变更,请务必仔细阅读升级文档!</font>
>
> **重要提示**:升级至本版本前,请先**清理 Redis 缓存**中的用户信息,否则可能因数据结构变更导致**登录异常**。
### sz-boot-parent
#### 新增
- 支持 Spring Boot Actuator 监控。
- login 相关密码传输支持 AES-GCM 加密,提升安全性。
- 增加登录请求及验证码请求次数的限制配置。
- [代码生成器] 支持多文件上传fileUpload
- [代码生成器] 支持数据权限创建。
- 账户管理新增账户类型设置,支持超管账户指定。
- 支持“超级管理员”角色参数配置。
#### 重构
- <font color="red">破坏性变更</font>:模板文件管理及下载等逻辑。
- <font color="red">破坏性变更</font>:移除独立数据权限角色,合并至系统角色。
- <font color="red">破坏性变更</font>:简化数据权限核心 SimplePermissionDialect实现与处理流程更加清晰。
- <font color="red">破坏性变更</font>调整数据存储结构login 相关方法引入 dataScope 缓存,移除 ruleMap、userRuleMap、deptRuleMap。因数据结构升级后可能需要清空redis缓存。
#### 修复
- 修复登录日志异步线程引发的记录异常。
- 修复 IP 地址获取失败的问题。
- 修复 Excel 导入时数据为空问题,移除代码模板中的 @Accessors(chain = true)。
- 回退 FastExcel 版本至 1.2.0,解决部分 Excel 导出异常。
#### 修改/移除
- 移除生产环境配置中的 CORS 设置。
- ImportExcel 方法支持数据库入库功能。
- [演示案例] 教师统计,支持附件文件上传。
- sys_data_role、sys_data_role_menu 相关业务标记为弃用,功能合并至 sys_role。
- Dockerfile 镜像切换至 azul/zulu-openjdkJDK 21
- 移除 Flyway数据库迁移已完全转至 liquibase。
#### 优化
- 登录列表倒序排序显示。
- [代码生成器] 菜单按钮的查询与排序优化。
- 修复[动态字典]部门、角色在 redisCache 中循环赋值导致的性能问题。
- OSS 上传支持原始文件名元数据与特殊字符(如#)处理。
- HttpReqResUtil 增加 getRequest 方法,支持全局 HttpServletRequest 获取。
- StringUtils.getRealKey 方法增强字符串替换、null 处理与异常捕获。
---
### sz-admin
#### 新增
- 新增 FileDownloadList 组件,实现 ProTable 中文件资源展示、支持多文件下载与预览、文件列表回显优化。
- login 相关密码传输支持 AES-GCM 加密,提升安全性。
- 账户管理支持账户类型设置,可直接指定管理员身份。
#### 重构
- [UploadFiles 组件] 增加多项功能并修正若干问题。
- 角色管理-权限分配组件重构,提升交互体验。
#### 优化
- useDownload 组件优先采用 response header 中 filename 作为下载文件名。
- 优化菜单表单的操作逻辑,新增提示说明。
- 优化模板文件管理列表的文件操作列。
- [ImportExcel] 增加模板信息展示及必填参数校验。
- [file 组件] 优化 accept 文件类型检查,可选开启,默认不限制类型。
- 文件下载和模板功能进一步优化,提升用户体验:
- 优化 useDownload Hook 的实现
- 文件模板相关逻辑调整
- 菜单 Form 表单增加提示性 tooltip
- 修正 blob 流响应拦截器的错误处理
- 列表文件展示统一切换为 FileDownloadList 组件
#### 修复
- [ProTable] 因数据类型不匹配导致的列表字典项渲染样式异常。
#### 修改
- [演示案例] 教师统计,新增多文件上传及回显组件支持。
### 数据库变更
- 更新 `sys_menu` 表:优化菜单数据,采用更简洁的路由名称,并将原本在菜单上的查询权限提取为按钮级权限。
- 调整 `sys_role_menu` 表:新增字段 `permission_type`(权限类型,如功能权限、数据权限),新增字段 `data_scope_cd`(数据权限范围)。
- 更新 `sys_data_role_relation` 表:新增字段 `menu_id`,用于关联菜单。
-`sys_data_role_menu`、`sys_data_role` 标记为**废弃**,相关业务已合并至 `sys_role``sys_data_role_relation` 表。
- 优化 `sys_temp_file`、`sys_temp_file_history` 表:将 `url` 字段类型调整为 JSON并插入演示数据。
<font color="red"> !!注意:此更改会导致原有数据不兼容。</font>
- `sys_temp_file` 表新增 `alias` 字段,用于标识文件别名。
- `sys_role`、`sys_role_menu`、`sys_data_role_relation`、`sys_user_role` 表补充及调整了演示数据。
> **升级建议**
>
> - 建议在升级前做好数据和数据库结构的完整备份,以保障您的数据安全。
> - 本次数据库结构及功能调整,可能影响部分旧数据兼容性及现有业务,请结合自身情况提前评估,并根据实际需求做好适配与数据处理。
> - 欢迎在升级过程中通过社区或交流群反馈遇到的问题,我们也会积极协助答疑与经验分享。
## v1.2.6-beta 20250831
> [!NOTE]
>
> [升级指南](https://szadmin.cn/md/Help/doc/other/upgrade.html#v1.2.6-beta)
sz-boot-parent
- 依赖升级:
- **spring-boot-starter-parent3.5.3 -> 3.5.5。**
- **mybatis-flex1.11.0 -> 1.11.1。**
- software.amazon.awssdk:s32.31.78 -> 2.32.29。
- fastexcel1.2.0 -> 1.3.0。
- io.swagger.core.v3-swagger-annotations2.2.34 -> 2.2.36
- jackson2.19.0 -> 2.19.1
- commons-lang3: 3.17.0 -> 3.18.0
- HikariCP6.3.0 -> 7.0.2
- commons-io-commons-io2.19.0 -> 2.20.0
- jackson2.19.1 -> 2.19.2
- mysql-connector-j9.3.0 -> 9.4.0
- 新增: 新增部门角色设置功能,更新部门下所有用户的角色信息,实现用户在设置部门时自动继承部门角色权限 (感谢[liuce](https://github.com/nullPointer0123))。
- 修复增强WebSocket消息解析添加错误处理。
- 优化: 部门设置角色使用mybatisFlex链式操纵替换sql。
- 新增:[动态字典] - 系统部门。
- 新增:[动态字典] - 系统角色。
- 优化:账号管理-部门、角色列展示查询。
- 优化:部门管理-负责人查询。
- 优化:部门管理-角色查询。
- 优化:[代码生成器]- 添加Lombok @Accessors 的支持(感谢[liuce](https://github.com/nullPointer0123))。
- 优化: [mysql.yml] - 指定 liquibase 版本表名,兼容不同环境表名大小写,避免版本控制失效。
- 优化: [代码生成器] - 菜单管理SQL格式。
- 新增:登录日志(感谢[liuce](https://github.com/nullPointer0123))。
sz-admin
- 新增: 新增部门角色设置功能,更新部门下所有用户的角色信息,实现用户在设置部门时自动继承部门角色权限(感谢[liuce](https://github.com/nullPointer0123))。
- 优化:[ProTable-TableColumn组件] 支持多标签展示。
- 支持 tag=false 且 enum 配置时,自动翻译多值并逗号拼接展示。
- 支持 tag=true 且 enum 配置时,多标签分组展示及收起。
- 支持 tag 未设置且 enum 配置时,正常翻译多值展示。
- 兼容多种数据格式(数组、逗号分隔字符串)。
- 空值统一展示为 "--"。
- 新增 tagLimit 属性说明:设置展示标签数量,超出部分通过 Popover 收起展示tagLimit=-1 时展示全部标签默认值tagLimit=3
- 优化: 添加部门绑定角色提示,调整部门页面操作列宽(感谢[liuce](https://github.com/nullPointer0123))。
- 新增: 添加登陆日志(感谢[liuce](https://github.com/nullPointer0123))。
- 优化:账号管理-部门、角色列展示。
- 优化:部门管理-负责人展示。
- 优化:部门管理-角色展示。
## v1.2.5-beta 20250716
> [!NOTE]
>
> [升级指南](https://szadmin.cn/md/Help/doc/other/upgrade.html#v1.2.5-beta)
- sz-boot-parent
- 依赖升级:
- **spring-boot-starter-parent3.5.0 -> 3.5.3。**
- **mybatis-flex1.10.9 -> 1.11.0。**
- software.amazon.awssdk:s32.29.50 -> 2.31.78。
- hutool-jwt5.8.38 -> 5.8.39。
- pagehelper6.1.0 -> 6.1.1。
- io.swagger.core.v3-swagger-annotations2.2.32 -> 2.2.34
- jackson2.19.0 -> 2.19.1
- commons-lang3: 3.17.0 -> 3.18.0
- HikariCP6.2.1 -> 6.3.0
- commons-io-commons-io2.18.0 -> 2.19.0
- jackson2.19.0 -> 2.19.1
- modelmapper3.2.3 -> 3.2.4
- springdoc-springdoc-openapi-starter-webmvc-ui2.8.8 -> 2.8.9
- 优化适配解决maven编译时无法识别Lombok和Mybatis-Flex APT注解器导致的”找不到符
- 修复: 更正Excel最大columnWidth = 255 * 256。(Excel 中列宽column width最大值是 255 * 256 = 65280)
- 优化:[SQL] 查询用户具有的菜单。
- 修复: 特殊情况下因用户session失效而导致的用户元数据同步失败的问题。
- 修复数据权限某些场景下导致page失效的问题。
- 重构:字典加载器相关类的包结构和接口定义,优化动态字典加载逻辑。
- 优化JacksonConfiguration 全局配置文件;实现针对不同类型的 Jackson null 值序列化器。
- String 类型 null → ""
- List/Set 类型 null → []
- Map 类型 null → {}
- Other 类型 null → ""
- 优化SysTempFileVO 添加 JacksonTypeHandler 以支持 url 字段的自定义序列化。
- 优化: pom 文件中按需引入 knife4j避免因多余依赖导致 WebSocket 服务可访问 knife4j 接口。
- sz-admin
- 新增:[演示] 多维选择器组件。
- 优化上传组件增加目录参数dir更换上传接口。
- 优化downloadFile函数将url类型由string改为string[]。
- 文档:
- 新增:[方案] [多数据源的实现](https://szadmin.cn/md/Help/doc/solution/multi-datasource.html)。
## v1.2.4-beta 20250614
- sz-boot-parent
- 修复: 菜单路径和组件路径拼写错误"menuManage"。(感谢[Kang-Yang](https://github.com/Kang-Yang)
- 修复异常枚举类message方法并发问题。
- 重构:将异常枚举类实现改为通用响应枚举模板。
- 升级sa-token v1.41.0 -> v1.44.0 && 同步改造。
- sz-admin
- 修复: 菜单路径和组件路径拼写错误"menuManage"。(感谢[Kang-Yang](https://github.com/Kang-Yang)
- 修复账户管理批量设置部门后checkbox未重置的问题。
- 优化Grid组件重构字段查找逻辑提升性能和可读性。
- 优化ToolBarRight组件修改展示项用户名为昵称。
## v1.2.3-beta 20250603
- sz-boot-parent
- 依赖升级:
- **spring-boot-starter-parent3.4.4 -> 3.5.0。**
- software.amazon.awssdk.crt:aws-crt0.33.7 -> 0.38.4。
- software.amazon.awssdk:s32.29.50 -> 2.31.54。
- hutool-jwt5.8.34 -> 5.8.38。
- fastexcel1.1.0 -> 1.2.0。
- mysql-mysql-connector-j: 9.2.0 -> 9.3.0
- HikariCP6.2.1 -> 6.3.0
- commons-io-commons-io2.18.0 -> 2.19.0
- jackson2.18.2 -> 2.19.0
- springdoc-springdoc-openapi-starter-webmvc-ui2.8.3 -> 2.8.8
- org.aspectj-aspectjweaver1.9.23 -> 1.9.24
- modelmapper3.2.2 -> 3.2.3
- io.swagger.core.v3-swagger-annotations2.2.27 -> 2.2.32
- commons-collections44.4 -> 4.5.0
- 优化适配解决maven编译时无法识别Lombok和Mybatis-Flex APT注解器导致的”找不到符号“报错问题。 (感谢[JoeyFrancisTribbiani](https://github.com/JoeyFrancisTribbiani)
- 修复FastExcel 依赖 Apache POI漏洞。
- 优化logback.xml中`converterClass`已废弃,更换为新语法`class`。
- 更新com.diffplug.spotless-spotless-maven-plugin-2.44.5。
- 优化cicd 脚本将admin和websocket合并成一个脚本。
- 修改多文件上传不再支持单字符串统一改为JSON数组形式。
- sz-admin
- 优化:多文件上传组件不再支持单字符串,统一改为数组形式。
## v1.2.2-beta 20250528
> [!NOTE]
>
> [升级指南](https://szadmin.cn/md/Help/doc/other/upgrade.html#v1.2.2-beta)
- sz-boot-parent
- 优化:将**继承** `WebMvcConfigurationSupport`改为**实现** `WebMvcConfigurer`,提升框架兼容性。
- 修复:[数据权限]-一些已知问题。
- 优化:[代码生成器]
- 导入数据表添加对createId/updateId/createTime/updateTime常用字段的支持。
- 前端模版添加对useDict生成的支持
- SQL Insert 支持IGNORE
- Teacher演示案例的同步改造
- 代码模版格式优化
- 新增: [sz-common-wechat]-新增企业微信消息发送的支持。
- sz-admin
- 修复:版本号读取异常问题。
- 优化:[演示案例] - 教师统计。
- 优化UploadFiles多文件上传组件, 简化使用方式并修复一些问题。
## v1.2.1-beta 20250509
> [!NOTE]
>
> [升级指南](https://szadmin.cn/md/Help/doc/other/upgrade.html#v1.2.1-beta)
- sz-boot-parent
- 新增Liquibase数据库管理弃用Flyway配置 (**Flyway 将于v1.3.0-beta 版本弃用**)。
- 修改已支持Liquibase默认配置关闭Flyway将于v1.3.0-beta版本弃用
- 修复部分菜单路由名称与组件名称不一致时导致的菜单keep-alive缓存失效问题。
- 修改README.md 添加deepwiki。感谢[dongyu6/main](https://github.com/dongyu6)。
- sz-admin
- 优化:.env环境变量无需指定`.env.development.local `文件即可使用。
- 升级sass 1.79.6 -> 1.87.0, vite 5.4.17 -> 6.3.4,以及其他依赖的同步升级。
- 修复部分菜单路由名称与组件名称不一致时导致的菜单keep-alive缓存失效问题。
- 修改README.md 添加deepwiki。感谢[dongyu6/main](https://github.com/dongyu6))。
## v1.2.0-beta 20250422
> [!NOTE]
>
> [升级指南](https://szadmin.cn/md/Help/doc/other/upgrade.html#v1-2-0-beta)
- sz-boot-parent
- 优化:[代码生成器] - 为生成代码增加是否忽略表前缀的功能。PR[#140](https://github.com/feiyuchuixue/sz-boot-parent/pull/140)(感谢[crash](https://github.com/processcrash))。
- 优化:重构**数据权限**核心逻辑,修复部分问题。
- 修复:[数据填充]-deptScope属性失败问题
- 优化Websocket相关简化SocketMessage和TransferMessage类的泛型使用
- 新增:系统消息功能
- 新增:[演示] 消息发送接口
- 新增:[CICD] Docker Sz-Socket CI Prod.yml
- 优化:提高用户元数据变更性能
- sz-admin
- 修复:滑块验证码在某些浏览器无法滑动的问题
- 新增:分类筛选器组件
- 优化:滑块验证码的耗时计算逻辑
- 新增系统消息功能搭配Websocket可体验完整功能
- 新增:功能演示
- 新增:关于项目
- 新增:全局菜单:[消息、功能演示菜、关于项目]
## v1.1.0-beta 20250406
> [!NOTE]
>
> [升级指南](https://szadmin.cn/md/Help/doc/other/upgrade.html)
- sz-boot-parent
- 依赖升级:
- spring-boot-starter-parent3.4.2 -> 3.4.4。
- mybatis-flex.version1.10.8 -> 1.10.9。
- sa-token1.40.0 -> 1.41.0。
- swagger-annotations2.2.27 -> 2.2.29。
- aspectjweaver1.9.22.10 -> 1.9.23。
- springdoc-openapi-starter-webmvc-ui: 2.8.3 -> 2.8.6
- aws-crt 0.33.7 -> 0.37.0
- HikariCP6.2.1 -> 6.3.0
- aws.s32.29.50 -> 2.31.11
- 优化:[代码生成器] - 添加/api/types/*.ts生成模板
- sz-admin
- 升级Eslint8.x -> Eslint9
- 新增:`useDictOptions` Hook
- 优化:同步`useDictOptions` Hook写法
- 修复:某些情况下部门树多选报错的问题
- 优化:@import scss 官方已不推荐使用,修改为 @use
- 更新pnpm 依赖
## v1.0.2-beta 20250302
- sz-boot-parent
- 依赖升级:
- mybatis-flex.version1.10.7 -> 1.10.8。
- 优化更新OSS配置添加协议scheme支持并**弃用isHttps字段**。
- <font color="red">可能的破坏性更新: </font>请切换`isHttps=true/false"` 为` scheme="https/http"`
- 优化重构isNotNull方法支持更广泛的集合类型。
- 优化重构BeanCopyUtils以使用单例ModelMapper实例。
- 优化【代码生成器】添加将bigint类型映射成long Java类型处理。
- 优化在EntityChangeListener onInsert事件中添加对updateTime和updateId的初始设置。
- 修复Excel导出时Long类型在某些情况下报错的问题。
- 新增:系统字典查询-根据类型查询接口。
- sz-admin
- 新增:[Hook] useDict 方法。可使用此方法更新指定typeCode的字典缓存
- 新增:[Hook] useDict 的演示案例。
- 修改:删除字典接口注释。**Issue**[#11](https://github.com/feiyuchuixue/sz-admin/issues/11)(感谢[Kang-Yang](https://github.com/Kang-Yang))。
- 修改README中的地址更正。**Issue**[#12](https://github.com/feiyuchuixue/sz-admin/issues/12)(感谢[Kang-Yang](https://github.com/Kang-Yang))。
## v1.0.1-beta 20250215
- sz-boot-parent
- 依赖升级:
- spring-boot-starter-parent3.4.1 -> 3.4.2。
- mybatis-flex.version1.10.5 -> 1.10.7。
- sa-token1.39.0 -> 1.40.0。
- excel-fastexcel1.0.0 -> 1.1.0。
- mysql-connector-j9.1.0 -> 9.2.0。
- 优化:字典类型删除时同步清除缓存。
- 优化统一异常code规范追加prefix。
- 优化:指定目标账户密码修改后,触发“踢下线”功能。
- 修改:菜单树增加返回参数。
- 优化: 日志格式。**Issue**[#10](https://github.com/feiyuchuixue/sz-admin/issues/10)。(感谢[129duckflew](https://github.com/129duckflew))。
- 新增:第三方开源库和许可证文件说明
- sz-admin
- 修复无效Token响应码不一致的问题。
- 修复AES-GCM加密方法在某些场景浏览器不可用的问题行为验证码
- 优化:【代码生成器】- 生成信息中**上级菜单=目录**时与模块名的联动。
- 新增:第三方开源库和许可证文件说明
## v1.0.0-beta 20250128| 大型更新
- sz-boot-parent
- 优化sonar 代码(质量)规范化
- sz-admin
- 优化sonar 代码(质量)规范化
## v0.9.0 20250119
- sz-boot-parent
- 优化:无效文件清理
- 优化javadoc 注释
- 优化:[sz-service-websocket] 同步调整config路径至项目根目录下
- 优化qodana 代码(质量)规范化
- sz-admin
-
## v0.8.8 20250118
- sz-boot-parent
- 修改Jackson序列化添加对`MultipartFile`类型的支持。
- 修改:`router.whitelist` 属性为Set结构。
- 优化:系统用户更新时,同步更新缓存信息。
- 优化:[行为验证码-滑块验证] 增加对double精度的支持。
- 优化:接口白名单,删除非必要的放行接口。
- 修复aop日志打印的一些问题 http-topic.log
- 修复:[代码生成器] 预览时插入按钮SQL问题。
- 修复EntityChangeListener 在处理未登录用户数据初始化时的异常问题。
- 修复:验证码参数`sys.captcha.requestLimit`未启用时redis中仍然记录了次数的问题。
- 修复:[部门管理] 上级部门为`根部门`时编辑校验未通过的问题。
- 依赖升级:
- spotless-maven-plugin2.43.0 -> 2.44.1。
- mybatis-flex.version1.10.2 -> 1.10.5。
- aws.s3.version2.29.23 -> 2.29.50。
- springdoc-openapi-starter-webmvc-ui2.7.0 -> 2.8.3。
- modelmapper3.2.1 -> 3.2.2。
- swagger-annotations2.2.26 -> 2.2.27。
- sz-admin
- 修复个别浏览器Socket异常的问题。
- 优化:[行为验证码-滑块验证] 添加对移动端浏览器的支持。
## v0.8.7 20250109
- sz-boot-parent
- 新增:`sz.cors.allowedOrigins`配置项,允许用户通过配置的方式指定限定域名
- 修复springboot启动时打印logback配置信息的问题 && 优化logback配置
- 优化:接口防抖逻辑
- 当全局设置忽略GET请求的参数为true时如果GET请求的Controller未标注@Debounce注解则跳过防抖处理但若Controller标注了@Debounce注解即使是GET请求也会执行防抖逻辑。
- 新增:行为验证码-滑块验证。感谢([阳纸伞](https://github.com/1327614618))
- 新增:[演示案例] 远程搜索下拉选择组件
- sz-admin
- 新增:行为验证码-滑块验证
- 新增:远程搜索下拉选择组件
- 新增:[演示案例] 远程搜索下拉选择组件
## v0.8.6 20250102
- sz-boot-parent
- 修复: sys_config 缓存时间问题。
- 修改: 移动配置文件至项目【根目录】下。| <font color="red">可能的破坏性更新 </font>
- 修改: 移除pom镜像源配置
- 修改: Dockerfile 增加配置目录挂载的支持
- 新增: GitHub Action workflow |
- sz-admin
- 修复VITE自定义变量验证问题
- 新增gzip打包支持
- 新增Dockerfile
- 修改:.env.production 配置
- 新增GitHub Action workflow
## v0.8.5 20241229
- sz-boot-parent
- 优化commons-logging 引用冲突问题。
- 修复部门编辑时层级deep赋值不正确问题。
- 修复前端module模板文件导入excel缺少参数问题。
- 修复:部门列表节点数量展示问题。
- 优化升级EasyExcel为FastExcel。 | <font color="red">可能的破坏性更新 easyExcel -> fastExcel 的Package包切换</font>
- 优化:增强 Excel 导入异常处理,新增表头校验功能。详见[Excel导入导出](https://szadmin.cn/md/Help/doc/excel.html)
- 依赖升级:
- spring-boot-starter-parent3.4.0 -> 3.4.1。
- sz-admin
- 优化:文件上传模板组件样式。(感谢[Alex-1116](https://github.com/Alex-1116)
- 优化Excel导入组件增加上传进度的支持。
- 优化axios对全局response error的处理。
## v0.8.4 20241216
- sz-boot-parent
- 依赖升级:
- spring-boot-starter-parent3.3.5 -> 3.4.0。
- mybatis-flex.version1.9.7 -> 1.10.2。
- aws-crt0.33.0 -> 0.33.3。
- hutool-jwt5.8.32 -> 5.8.34。
- aws.s32.29.0 -> 2.29.23。
- HikariCP6.0.0 -> 6.2.1。
- common-io2.17.0 -> 2.18.0。
- lombok1.18.34 -> 1.18.36。
- jackson2.17.2 -> 2.18.2。
- swagger-annotations2.2.25 -> 2.2.26。
- mysql-connector-j9.0.0 -> 9.1.0。
- 修改SpringBoot升级3.4.0后对knife4j的兼容性处理 | <font color="red">兼容性更新springboot升级3.4.0后knife4增强默认需禁用</font>
- 删除minio dependency。
- 优化:代码生成器查询。 **PR**[#57]([https://github.com/feiyuchuixue/sz-boot-parent/pull/57)。(感谢**[AiMing317](https://github.com/AiMing317)** )。
- 优化:[代码生成器] 修复若干问题。
- 新增ossClient新增oss文件流下载方法。
- 优化FileUtils 新增对response header的处理方法。
- 优化历史MapperXml/PO的结构映射。
- 新增:模板文件管理模块。
- sz-admin
- 优化:头像框样式。
- 优化:代码生成器查询。 **PR**[#57]([https://github.com/feiyuchuixue/sz-boot-parent/pull/57)。(感谢**[AiMing317](https://github.com/AiMing317)** )。
- 优化Img、Imgs上传组件增加@change事件可获取完整的UploadResul。
- 优化:[代码生成器] 修复一些问题,样式及便利性更新。
- 优化View.DefaultParams添加参数isAdd。可用于区分新增 OR 编辑。
- 优化useDownload组件blob流式下载文件名从response中获取。
- 新增:模板文件管理模块。
- 修改:更新教师统计模板文件名。
## v0.8.3 20241126
- sz-boot-parent
- **删除minio模块。** | <font color="red">可能的破坏性更新</font>
- 新增oss模块使用**AWS S3**协议支持更多云存储厂商阿里、七牛、腾讯、minio等
- 修改切换minio模块至oss模块切换上传方法至ossClient。请将minio.yml文件切换为oss.yml。
- 优化移除冗余NotNull注解。
- sz-admin
- 新增:文件管理。
- 修改oss模块同步改动。
- 新增vite-plugin-vue-devtools插件。
- 优化完善UploadResult返回结构优化文件代码格式。
- 新增:图片上传、批量图片上传组件 (感谢 **Geeker-Admin** https://github.com/HalseySpicy/Geeker-Admin
- 修改:切换用户头像上传为新的组件。
- 文档:
- [oss存储](https://szadmin.cn/md/Help/doc/oss.html)
## v0.8.2 20241119
- sz-boot-parent
- 修复: 菜单详情页权限唯一值校验异常问题。
- 修复: [代码生成] MySql5.7 导入表异常问题。
- 新增: [代码生成] 对字典别名的支持。
- 优化: 字典类型sysDictType增加缓存同步机制。
- sz-admin
- 修复:客户端管理列表,授权类型展示问题。
- 新增:[代码生成] 对字典别名的支持。
## v0.8.1 20241106
- sz-boot-parent
- 依赖升级:
- spring-boot-starter-data-redis3.3.4 -> 3.3.5。
- spring-boot-starter-parent3.3.4 -> 3.3.5。
- 优化sz-service-socket添加启动Banner与版本号。
- 优化:部门列表-未设置部门节点用户数量查询逻辑调整
- 优化:账户登录的查询。
- 修复excel导出字典CodeName为null时的异常问题。
- 优化Excel导入导出及字典转换提升性能。
- sz-admin
- 优化: vite.config.mts更新 SCSS 预处理器配。
- 优化: 锁定sass版本为~1.79.x版本。
- 优化: tsconfig.app.json 增加package.json的支持。
- 优化: 使用TypeScript的模块扩展优化package.json 的version。
- 优化: 增强 env.d.ts 文件中的类型定义。
- 文档:
- [Excel导入导出](https://szadmin.cn/md/Help/doc/excel.html)
## v0.8.0 20241017
- sz-boot-parent
- 依赖升级:
- spring-boot-starter-data-redis3.3.3 -> 3.3.4。
- 修复sql预览模版结尾多余空格问题。
- 修复:无法正常解锁用户问题 **PR**[#26](https://github.com/feiyuchuixue/sz-boot-parent/issues/26#issue-2577509320)。(感谢[andyjia](https://github.com/andyjia)
- 优化:重构异常处理,引入错误前缀枚举,增强代码可读性和可维护。
- 新增spotless maven 格式化插件,全局格式化。
- 新增CHANGE.md 更新日志。
- 修改将数据表中的自增ID字段类型升级为**bigint**,以支持更大的数据范围和避免潜在的溢出问题。| <font color="red">可能的破坏性更新</font>
- 优化自增ID字段升级为bigint
- 代码生成
- 系统菜单
- 系统字典
- 角色
- 用户
- 教师统计(演示)
- 新增自增ID字段升级为bigint DDL脚本。
- 修复:部分页面批量删除异常问题。
- 优化:[代码生成] 前端模版添加对(string | number)[] 类型的支持。
- 优化:验证权限标识唯一性接口。
- 优化接口防抖增加GET请求忽略的支持。
- 优化通用返回接口对额外参数param的处理。
- 优化:[代码生成] 模版对菜单预览SQL的调整。
- 优化:数据库迁移脚本 --业务脚本 示例修改。
- sz-admin
- 依赖升级:
- **vite****4.5.3 -> 5.4.8**。
- **axios** 1.7.2 -> 1.7.7
- **vue**3.4.21 -> 3.5.12
- pinia2.1.7 -> 2.2.4
- **vue-router****4.4.0 -> 4.4.5**
- sortablejs1.15.2 -> 1.15.3
- pinia-plugin-persistedstate 3.2.1 -> 3.2.3
- @vueuse/core10.11.0 -> 10.11.1
- prettier3.3.2 -> 3.3.3
- @types/node18.19.39 -> 18.19.55
- **element-plus****2.7.6 -> 2.8.5**
- **sass****1.77.7 -> 1.79.5**
- @vue/tsconfig0.4.0 -> 0.5.1
- vue-tsc1.8.27 -> 2.1.6
- 修复:菜单管理、字典管理 预览SQL的格式问题。
- 修复:代码预览组件行号展示问题。
- 优化: 更新API状态码常量。
- 优化:提取请求超时时间参数**VITE_APP_HTTP_TIMEOUT** 单位ms默认超时时间60s
- 优化: useSelection组件添加对number数组的支持。
- 优化: 修改API参数类型以支持数字和字符串。
- 优化: 角色标识展示样式。
- 优化: vite5.x 使用ESM语法 vite.config.ts 升级为vite.config.mts。
- 优化: eslintrc.cjs 规则。
- 优化: prettier format配置。
- 优化:代码格式化,代码清理。
## v0.7.11 20241009
- sz-boot-parent
- 依赖升级:
- spring-boot-starter-data-redis3.3.3 -> 3.3.4。
- 修复sql预览模版结尾多余空格问题。
- 修复:无法正常解锁用户问题 **PR**[#26](https://github.com/feiyuchuixue/sz-boot-parent/issues/26#issue-2577509320)。(感谢[andyjia](https://github.com/andyjia)
- 优化:重构异常处理,引入错误前缀枚举,增强代码可读性和可维护。
- 新增spotless maven 格式化插件,全局格式化。
- 新增CHANGE.md 更新日志。
- 修改将数据表中的自增ID字段类型升级为**bigint**,以支持更大的数据范围和避免潜在的溢出问题。| <font color="red">可能的破坏性更新</font>
- 优化自增ID字段升级为bigint
- 代码生成
- 系统菜单
- 系统字典
- 角色
- 用户
- 教师统计(演示)
- 新增自增ID字段升级为bigint DDL脚本。
- 修复:部分页面批量删除异常问题。
- 优化:[代码生成] 前端模版添加对(string | number)[] 类型的支持。
- 优化:验证权限标识唯一性接口。
- 优化接口防抖增加GET请求忽略的支持。
- 优化通用返回接口对额外参数param的处理。
- 优化:[代码生成] 模版对菜单预览SQL的调整。
- 优化:数据库迁移脚本 --业务脚本 示例修改。
## v0.7.10 20240919
- sz-boot-parent
- 依赖升级:
- com.alibaba:easyexcel4.0.2 -> 4.0.3。
- 修复:某些情况下账户列表查询的分页问题。
- 修复数据权限组合拼接条件时OR、AND的优先级问题。
- 新增:接口防抖功能。
- 优化sz自定义配置格式统一化。
- sz-admin
- 优化WebSocket验证逻辑。
- 优化env环境变量。
- 修复dict接口登录时请求两次的问题。
## v0.7.9 20240913
- sz-boot-parent
- 依赖升级:
- org.apache.commons:commons-lang33.16.0 -> 3.17.0
- swagger-annotations 2.2.21 -> 2.2.23.
- org.aspectj:aspectjweaver1.9.22 -> 1.9.22.1
- mysql-connector-j 8.4.0 -> 9.0.0
- hutool-jwt 5.8.31 -> 5.8.32
- 新增BeanCopyUtils 增加copy, copyNotIgnoreNull方法。
- 优化:**数据权限**映射表名的获取规则:优先使用@Table注解名称属性。
- 修复:角色管理标识空值校验问题。
- 优化:[代码生成] 前端搜索项独立enum Select的支持。
- 修复: @SaIgnore注解失效问题。
- 优化: @SaIgnore的使用场景,[详见文档](https://szadmin.cn/md/Help/doc/code-standard.html#_9-%E6%8E%A5%E5%8F%A3%E9%89%B4%E6%9D%83) 。
- 优化: 账户detail详情查询接口排除敏感信息。
- sz-admin
- 优化改造SearchForm组件添加对enum的独立支持。感谢[Alex-1116](https://github.com/Alex-1116)
- 修改:[教师统计] searchColumns enum演示。
## v0.7.8 20240902
- sz-boot-parent
- 依赖升级:
- spring-boot-starter-parent3.2.5 -> 3.3.3
- jackson2.16.1 -> 2.17.2
- hutool-jwt5.8.27 -> 5.8.31
- easyexcel 3.3.4 -> 4.0.2
- aspectjweaver 1.9.22 -> 1.9.22.1
- commons-lang33.14.0 -> 3.16.0
- mybatis-flex-spring-boot3-starter1.9.3 -> 1.9.7
- modelmapper3.2.0 -> 3.2.1
- minio8.5.10 -> 8.5.12
- sa-token1.38.0 -> 1.39.0
- 修复代码生成zip生成时流未关闭的问题。
- 修复ftl sql模板int类型参数自动转换千分位的问题。
- 修复:字典更新问题。
- 优化:类名、包结构。
- 修改MybatisFlex**禁用全局null值自动忽略**。代码生成器模版、部分业务查询拼接同步改动。|增强逻辑清晰和确定性。
- sz-admin
- 修改客户端管理Form项描述错误
- 优化:[代码生成] 编辑Form字典类型下拉展示。区分静态字典和动态字典。感谢[Alex-1116](https://github.com/Alex-1116)
## v0.7.7 20240823
- sz-boot-parent
- 优化:包结构及代码。
- 修复字典sql导出ID格式问题。
- 修复:[代码生成] LocalDateTime范围查询Search区域展示异常问题。
- 新增:字典改造,对静态字典、动态字典提供支持。
- 优化DictVO对象完善字典查询sql增加对逻辑删除的支持。
- 修改SysUser 动态字典:用户信息的支持。
- 优化TeacherStatics演示示例@DictFormat注解isSelected()的调整等。感谢[阳纸伞](https://github.com/1327614618)的贡献代码。
- sz-admin
- 优化:账户管理-切换部门列表时list接口请求两次额问题。
## v0.7.6 20240814
- sz-boot-parent
- 修复:[代码生成] excel导出条数与列表查询数不符的问题。
- 修复:[代码生成] 关联字典的查询条件生成类型为input而非select的问题。
- 修复:[代码生成] 新增菜单类型【菜单】时deep层级赋值不正确问题。
- 优化:[代码生成] 代码生成逻辑修复一些bug。
- 优化添加business业务Flyway README描述文件。
- 优化遵循jdk21建议使用@Serial注解标识serialVersionUID。
- 优化角色增加is_lock, permissions属性。
- 修复字典菜单SQL查看时某些原因无法展示的问题。
- sz-admin
- 优化:代码生成字段类型添加描述。
- 优化角色管理增加标识属性permissions、锁定状态is_lock
## v0.7.5 20240812
- sz-boot-parent
- 优化:账户新增时,如果选择了可用的部门,将账户创建到指定部门。
- 新增字典管理SQL导出功能。
- 优化:代码生成模板格式。
- sz-admin
- 修复Header结构Avatar组件 默认头像展示问题。(感谢[Alex-1116](https://github.com/Alex-1116)
- 优化: 代码生成HighCode组件 增加行号展示。(感谢[Alex-1116](https://github.com/Alex-1116)
- 修复:账号管理 新增用户后 与部门列表的通讯问题。(感谢[Alex-1116](https://github.com/Alex-1116)
- 优化:代码生成编辑操作 根据导入导出checkbox 动态展示对应columns。感谢[Alex-1116](https://github.com/Alex-1116)
- 优化:账户新增时,如果选择了可用的部门,将账户创建到指定部门下。
- 新增字典管理SQL导出功能。
- 修复:代码生成组件 行号 头部标题固定。(感谢[Alex-1116](https://github.com/Alex-1116)
## v0.7.4 20240730
- sz-boot-parent
- 优化业务与框架Flyway迁移脚本分离
- 新增多 Flyway 实例配置,分别管理业务和框架迁移脚本。
- 修改 `flyway.yml` 配置项,实现配置的清晰划分。
- 利用 `@ConfigurationProperties` 自动绑定配置项,创建独立的 Flyway 实例
- 各自使用独立的历史版本表t_db_version 和 t_db_version_business以避免相互干扰
- 优化迁移管理,提高数据库版本管理的灵活性和扩展性
- 更新了flyway的ddl脚本路径在classpath:/db 路径下新增framework、business路径并**将原 classpath:/db 路径下 的DDL文件移动至 classpath:/db/framework下**。| <font color="red">可能的破坏性更新</font>
> [!IMPORTANT]
>
> - **重要通知:数据库迁移操作**
>
> 为了确保数据库迁移的顺利进行,我们特别提醒您注意以下步骤:
>
> 1. **迁移DDL脚本**请将所有使用Flyway编写的自定义DDL非框架提供的v1.1~v1.8版本)迁移脚本移动至`classpath:/db/business`目录下。
> 2. **重新规划DDL版本**在迁移脚本完成后重新规划并更新DDL的版本号确保版本控制的一致性和可追溯性。
> 3. **数据备份****务必在执行迁移操作之前**,对现有数据库进行全面的数据备份。这是保障数据安全的关键步骤,避免在迁移过程中发生数据丢失或损坏的风险。
> 4. **执行迁移操作**在确认数据备份无误后按照既定的迁移计划执行DDL迁移操作。
## v0.7.3 20240728
- sz-boot-parent
- 修复部门逻辑删除后account数据展示问题。
- 优化permission唯一性校验。
- 新增逻辑删除自动填充支持delete_id,delete_time属性。
- 优化:代码生成器,提取配置文件。
- 优化代码生成器menu生成Sort逻辑。
- 修复:预览时检查菜单重复的问题。
- sz-admin
- 优化permission唯一性校验。
- 优化码生成器编辑Form表单的交互体验。
- 官网文档:
- 新增:[代码生成器](https://szadmin.cn/md/Help/gen/generator-tools.html)文档。
## v0.7.2 20240719
> [!WARNING]
>
> **数据权限的session存储结构部分发生了改变移除了customUserIds、customDeptIds。启用了userRuleMap、deptRuleMap来配合灵活的自定义规则。**
- sz-boot-parent
- 修改:数据权限,逻辑优化。减少用户操作,提升用户体验。
- sz-admin
- 修改数据权限Form优化交互逻辑。
- 修复数据权限编辑后再新增操作项disable的问题。
- 官网文档:
- 修改:[数据权限文档](https://szadmin.cn/md/Help/doc/data-scope.html) 对部分逻辑进行了简化。
## v0.7.1 20240717
- sz-boot-parent
- 修复代码生成pojo类注释名称问题
- 优化:用户管理功能,代码清理
- 修复TreeUtils constructTreeRecursiveExcludeNode方法忽略指定节点不生效的问题
- 修复AOP url参数解析异常问题
- 优化:文件清理,命名规范化
- 新增StringUtils toSnakeCase方法
- **修改:字典管理,添加业务类型,区分系统字典、业务字典** | <font color="red">可能的破坏性更新</font>
> [!IMPORTANT] !重要
>
> 1000号段为业务性字典如有新增的字典请迁移至2000号段。受影响的字典类型值为“1006”、“1007”。
- 新增:数据权限实现
- sz-admin
- 优化账户添加Form tooltip
- 修复:菜单缓存失效问题 [#IA8QI1](https://gitee.com/feiyuchuixue/sz-admin/issues/IA8QI1) | Gitee
- 优化角色权限Form禁止esc关闭及点击其他区域关闭
- 修复socket参数不存在时仍连接socket的问题
- 新增:数据字典-业务类型
- 修复:默认头像无法展示问题
- 修复home页切换“分栏”布局报错问题
- 修复:查询条件项在某些条件下无法展示全的问题
- 优化:代码清理,规范化命名
- 新增:数据权限
- 官网文档:
- 新增:[数据权限文档](https://szadmin.cn/md/Help/doc/data-scope.html)
## v0.6.5 20240619
- sz-boot-parent
- 修复:未登录状态接口自动数据填充异常问题
- 修复:代码生成,批量删除异常问题
- 升级升级Mybatis-Flex版本v1.9.3
## v0.6.4 20240612
- sz-boot-parent
- 修复权限问题orRole不生效的问题 [#IA4F9Z](https://gitee.com/feiyuchuixue/sz-boot-parent/issues/IA4F9Z)
- 新增:查询用户角色接口
- sz-admin
- 新增权限校验v-auth指令 对超管角色的处理。env 新增 VITE_ADMIN_BYPASS_PERMISSION属性。
## v0.6.3 20240609
- sz-boot-parent
- 修复:代码生成器拖拽排序丢失问题
- 优化:代码生成器-字段信息编辑模板调整,增加数据库模板
- 优化:代码生成菜单唯一性检查逻辑
- 修改: 升级Mybatis-Flex版本v1.9.2
- sz-admin
- 优化:代码生成器-字段信息编辑、生成信息编辑的操作逻辑
- 优化:代码生成器-字段信息编辑 选择模板功能区,增加数据库模板选项,完善提示信息
- 修复ElMessage提示信息展示不在顶层的问题
- 优化:页脚增加版本号展示
## v0.6.2 20240605
- sz-boot-parent
- 优化:将密码错误次数、错误冻结时间等魔法值提取到参数管理中
- sz-admin
- 优化优化nginx推荐配置解决网络原因导致socket频繁断开的问题
- 官网文档:
- 新增:代码规范,前端代码提交前检查
- 修改:序言,商业用途免费。
- 优化:技术栈增加技术依赖超链接
- 新增websocket Nginx配置建议
- 修改感谢对前端贡献者s1990218yao增加描述
- 修改:页脚,增加友链
## v0.6.1 20240603
- sz-boot-parent
- 修改admin账户初始密码为**sz123456**
- 优化更新README文档
- sz-admin
- 修改登陆页面placeholder
- 优化更新README文档
----
## v0.6.0 20240602
- sz-boot-parent
- init
- sz-admin
- init
- sz-deploy
- init