开发指南
更新日志

【v2.2.0】2024-08-02

# 支持 AIGC 人工智能、商城在线客服

# 📈 Statistic

总代码行数：222554
源码代码行数：137846
注释行数：50515
单元测试用例数：1043

# ⭐ New Features

【新增】支持人大金仓数 KingbaseES，由 @dhb52 (opens new window) 贡献 #982 (opens new window)
【新增】find_in_set 函数的跨数据库实现，由 @dhb52 (opens new window) 贡献 #994 (opens new window)、#1000 (opens new window)
【新增】支持华为 openGauss，由 @dhb52 (opens new window) 贡献 #985 (opens new window)
【新增】Vue3 管理后台：动态表单支持字典选择器分离，重新封装 API 选择器，扩展字体图标，由 @puhui999 (opens new window) 贡献 #435 (opens new window)、#441 (opens new window)、#446 (opens new window)、#449 (opens new window)
【新增】华为短信 Client 实现，由 @scholarli (opens new window) 贡献 #997 (opens new window)
【新增】protection 模块新增 signature 实现 API 签名，由 @slipper4j (opens new window) 贡献 #526 (opens new window)、#531 (opens new window)、#532 (opens new window)、#541 (opens new window)
【优化】短信验证码前置补零对其 endCode 长度，由 @aqiangaqiang (opens new window) 贡献 #116 (opens new window)
【优化】优化记录 infra_api_access_log 方法，截取参数最长 8000 字符，由 @高高 (opens new window) 贡献 #976 (opens new window)、#977 (opens new window)
【新增】Vben 管理后台：新增《代码生成案例》，由 @JackLi (opens new window) 贡献 #42 (opens new window)
【优化】Vue3 管理后台：提取默认登录使用的租户与账号密码, 规避潜在的账户泄露问题，由 @邓超 (opens new window) 贡献 #56 (opens new window)
【优化】Vue3 管理后台：Add StringDictDataType type by imitating getIntDictOptions，由 @AhJindeg (opens new window) 贡献 #453 (opens new window)
【优化】MyBatis 从 3.5.5 升级到 3.5.7，并简化数据权限的实现，由 @xl_niu (opens new window) 贡献 #1007 (opens new window)
【新增】Cloud：支持数据权限在 RPC 调用时，传递忽略数据权限的能力，由 @芋道源码 (opens new window) 贡献 e18069d (opens new window)
【新增】多租户缓存，增加忽略的 Spring Cache 配置，由 @芋道源码 (opens new window) 贡献 1c95e12 (opens new window)
【新增】微信小程序的订阅消息，由 @puhui999 (opens new window) 贡献 #1018 (opens new window)、#61 (opens new window)、#1019 (opens new window)、#1021 (opens new window)、#1023 (opens new window)、#1024 (opens new window)、#63 (opens new window)、#1025 (opens new window)、#63 (opens new window)、#64 (opens new window)、#1027 (opens new window)
【优化】文件存储 S3 兼容腾讯云、火山云的 VirtualStyle 模式，由 @芋道源码 (opens new window) 贡献 4386c70 (opens new window)
【优化】Vben 管理后台：接入 V2 版本操作日志，接入访问日志的操作信息，由 @芋道源码 (opens new window) 贡献 59d2baa (opens new window)、09d3fac (opens new window)
【优化】Vue2 管理后台：接入 V2 版本操作日志，接入访问日志的操作信息，由 @芋道源码 (opens new window) 贡献 06750bf (opens new window)、49dbfd0 (opens new window)
【优化】Area 在 IDEA debug 时 toString 方法报错StackOverflowError、指定 jackson 默认序列化时双向引用的前向、后向出口避免死循环报错，由 @常柯柯 (opens new window) 贡献 #2 (opens new window)、#1022 (opens new window)

CRM 客户管理系统专区：

【新增】员工业绩统计，由 @scholarli (opens new window) 贡献 #966 (opens new window)、#438 (opens new window)、#971 (opens new window)

MALL 商城专区：

【新增】获取小程序码相关接口，由 @puhui999 (opens new window) 贡献 #972 (opens new window)、#975 (opens new window)、#53 (opens new window)、#979 (opens new window)、#54 (opens new window)、#55 (opens new window)
【新增】客服功能的实现，由 @puhui999 (opens new window) 贡献 #980 (opens new window)、#993 (opens new window)、#468 (opens new window)、#1001 (opens new window)、#470 (opens new window)、#471 (opens new window)、#1008 (opens new window)、#474 (opens new window)、#476 (opens new window)、#1010 (opens new window)、#469 (opens new window)、#1014 (opens new window)、#483 (opens new window)、#56 (opens new window)
【新增】增加租户 ID 自定义配置支持，由 @downeyin (opens new window) 贡献 #62 (opens new window)

PAY 支付专区：

【优化】微信支付使用 certSerialNo 替代 privateCertContent，由 @芋道源码 (opens new window) 贡献 f0d680b (opens new window)、188b403 (opens new window)

AI 大模型专区：

【新增】对话聊天的前后端实现，由 cherishsince (opens new window) 贡献 #469 (opens new window)、#1006 (opens new window)、#1013 (opens new window)
【新增】绘图创作的前后端实现，由 cherishsince (opens new window) 贡献 #469 (opens new window)、#1006 (opens new window)、#1013 (opens new window)、#479 (opens new window)
【新增】音乐创作的后端实现，由 @小新 (opens new window) 贡献 #1 (opens new window)、#2 (opens new window)、#3 (opens new window)、#4 (opens new window)、#5 (opens new window)、#6 (opens new window)、#7 (opens new window)、#8 (opens new window)
【新增】音乐创作的前端实现，由 @紫星 (opens new window) 贡献 #467 (opens new window)
【新增】写作助手的后端实现，由 @小新 (opens new window) 贡献 #9 (opens new window)、#11 (opens new window)、#13 (opens new window)、#14 (opens new window)
【新增】写作创作的前端实现，由 @hhhero (opens new window) 贡献 #473 (opens new window)、#477 (opens new window)、#482 (opens new window)
【新增】思维导图的前端实现，由 @hhhero (opens new window) 贡献 #484 (opens new window)

# 🐞 Bug Fixes

【修复】SYSTEM：获取菜单精简信息列表接口没有排除父 ID 非 0 的节点，由 @dongdongxiang (opens new window) 贡献 #561 (opens new window)
【修复】Vue3 管理后台：菜单新增时，id=0 导致 SQLServer 新增菜单失败，由 @dhb52 (opens new window) 贡献 #440 (opens new window)
【修复】Vue3 管理后台：由于 .env.local-dev 重命名导致的构建指令异常，由 @邓超 (opens new window) 贡献 #39 (opens new window)
【修复】Vue3 管理后台：三方登录 SocialLogin.vue 的验证码开关取反，由 @天痕 (opens new window) 贡献 #443 (opens new window)、#442 (opens new window)
【修复】Vue3 管理后台：解决部门管理页面中，重置按钮失效问题，由 @刘岩Tony (opens new window) 贡献 #445 (opens new window)
【修复】MySQL 转 PostgreSQL、SQLServer 脚本，增加 dual 表需要一条数据，由 @dhb52 (opens new window) 贡献 #968 (opens new window)
【修复】Vben 管理后台：mail regular 不正确，由 @Tech--man (opens new window) 贡献 #5 (opens new window)
【修复】更新角色时，记录修改内容，由 @syubun (opens new window) 贡献 #114 (opens new window)
【修复】Vue2 管理后台：导出 Excel 时，发生异常时，进行提示，由 @芋道源码 (opens new window) 贡献 edc7293 (opens new window)
【修复】SYSTEM：id 获取不到用户引发的 NPE 异常，由 @g_l (opens new window) 贡献 #974 (opens new window)
【修复】上传文件测试时 pg 数据库字段与 FileContentDO 类型不一致报错修复，由 @orchidblessing (opens new window) 贡献 #534 (opens new window)
【修复】定时任务指定某一年执行时，只会执行一次，后台查看任务详细会报错，由 @高高 (opens new window) 贡献 #987 (opens new window)
【修复】导入微信地址的时候无法获取areaId（只针对四个直辖市），由 @SuperHao (opens new window)、@hunao0221 (opens new window) 贡献 #988 (opens new window)、#585 (opens new window)
【修复】模块名称和表名称一样时，代码生成存在问题，如“shop”模块的“shop”表生成代码时shop都被移除了，由 @山野羡民 (opens new window) 贡献 #990 (opens new window)
【修复】Vue3 管理后台：操作日志无法搜索操作人的问题，由 @杨宇庆 (opens new window) 贡献 #457 (opens new window)
【修复】Vue3 管理后台：定时任务的列表中点击“开启/关闭”按钮，弹窗点击取消，列表页状态已更改，由 @ms_think (opens new window) 贡献 #456 (opens new window)
【修复】修复主子表 ER P模式下代码自动生成不全问题，由 @jiushinakecai (opens new window)、@panjiabao (opens new window) 贡献 #583 (opens new window)
【修复】controller.vm 模版中的 export-excel 引用的 Vo 类没有加上 sceneEnum.prefixClass 前缀导致报错，由 @Syriana_Zh (opens new window) 贡献 #1004 (opens new window)
【修复】Vue3 管理后台：定时任务-调度日志执行结果使用字段错误，由 @AhJindeg (opens new window) 贡献 #464 (opens new window)
【修复】Vue3 管理后台：刷新令牌过期后，未正确跳转登录页，由 @AhJindeg (opens new window) 贡献 #465 (opens new window)
【修复】请求租户不存在时，记录访问日志、操作日志异常的问题，由 @芋道源码 (opens new window) 贡献 bbdf9e9 (opens new window)
【修复】Vben 管理后台：前端代码生成后列表页面是空的问题，由 @little-rex (opens new window) 贡献 #1020 (opens new window)
【修复】Vue2 管理后台：角色导出 URL 不正确的问题，由 @芋道源码 (opens new window) 贡献 7e3f310 (opens new window)
【修复】代码生成 Vue2 版本导出 undefined 问题，由 @zhkwork (opens new window) 贡献 #125 (opens new window)
【修复】AI 模块的 Redis 配置错误、打包配置缺失、日志冲突的问题，由 @OnPeaceOfMind (opens new window) 贡献 #127 (opens new window)、#128 (opens new window)
【修复】Vben 管理后台：升级 axios 版本，修复 token 过期刷新后，文件重传失败的问题，由 @芋道源码 (opens new window) 贡献 a76b0ec (opens new window)
【修复】Vben 管理后台：Excel 等导出时，如果发生异常，则不进行下载 Excel，而是错误提示，由 @芋道源码 (opens new window) 贡献 941e95 (opens new window)
【修复】SYSTEM：导入系统用户时，增加注解校验过程，与界面添加和修改用户保持一致，由 @尹先生 (opens new window) 贡献 #1017 (opens new window)
【修复】Vue3 管理后台：axios 请求拦截错误处理中 Promise.reject(error) 未返回，由 @perterHUAN (opens new window) 贡献 #488 (opens new window)
【修复】Vben 管理后台：处理表单设计器右侧属性配置面板表单不展示问题，由 @summer001-pd (opens new window) 贡献 #7 (opens new window)

CRM 客户管理系统专区：

【修复】商品统计计数显示成价格了，由 @山野羡民 (opens new window) 贡献 #439 (opens new window)
【修复】合同详情中团队成员未展示权限编辑的问题，由 @downeyin (opens new window) 贡献 #472 (opens new window)
【修复】回款管理导出报错的问题，由 @芋道源码 (opens new window) 贡献 87126d8 (opens new window)

MALL 商城专区：

【修复】性别未知时的枚举值与 member_user.sex 默认值不一致的问题，由 @邓超 (opens new window) 贡献 #509 (opens new window)
【修复】商城首页销售额查询错误，由 @JJBoy1995 (opens new window) 贡献 #518 (opens new window)、#42 (opens new window)
【修复】MemberUserBaseVO 的 sex 与 SexEnum 不一致的问题重命名导致的构建指令异常，由 @邓超 (opens new window) 贡献 #510 (opens new window)
【修复】秒杀时间段配置的 URL simple-list 不正确的问题，由 @芋道源码 (opens new window) 贡献 e1a5302 (opens new window)
【修复】填写商品属性后按回车键导致页面刷新的问题，由 @邓超 (opens new window) 贡献 #45 (opens new window)
【修复】radeOrderUpdateService 的单元测试，由 @邓超 (opens new window) 贡献 #525 (opens new window)
【修复】后台获取商品 SPU 分页列表数据时，数据会出现错乱问题，由 @dongdongxiang (opens new window) 贡献 #565 (opens new window)
【修复】被禁用的账户可以通过短信验证码再次登录的问题，由 @邓超 (opens new window) 贡献 #568 (opens new window)
【修复】会员签到记录 Bug，由 @随便v走走 (opens new window) 贡献 #984 (opens new window)
【修复】分销用户绑定时判断是否为新用户逻辑错误问题，由 @孙南北 (opens new window) 贡献 #124 (opens new window)
【修复】修复会员和售后退款中订和单明细查询传递参数错误，由 @OnPeaceOfMind (opens new window) 贡献 #466 (opens new window)
【修复】售后退货界面，加载物流公司失败的问题，由 @zhaowg (opens new window) 贡献 #59 (opens new window)
【修复】复制订单信息失败，字段错误，由 @WCH (opens new window) 贡献 #58 (opens new window)
【修复】订单项取消时，分销未取消所有推广员的推广记录问题，由 @芋道源码 (opens new window) 贡献 cf6f3ea (opens new window)
【修复】更新库存时，同时更新销量，和 taobao 保持一致的逻辑，由 @芋道源码 (opens new window) 贡献 714f0be (opens new window)
【修复】uni-app login.vue 微信登录绑定过慢，导致登录失败，由 @芋道源码 (opens new window) 贡献 714f0be (opens new window)
【修复】uni-app 在微信小程序下，切换手机 + 密码登录失败的问题，由 @芋道源码 (opens new window) 贡献 d716bc4 (opens new window)
【修复】优惠劵的折扣计算不正确，由 @芋道源码 (opens new window) 贡献 3d9ec19 (opens new window)
【修复】商城装修页面拖动组件时会异常选择所有文字的问题，由 @zhaoyu (opens new window) 贡献 #487 (opens new window)

BPM 工作流专区：

【修复】Vue3 管理后台：OA 请假，修复列表展示的状态字段取值错误，由 @dhb52 (opens new window) 贡献 #444 (opens new window)
【修复】多租户使用同一个流程标识 key 时查询报错，由 @今晚打老虎 (opens new window) 贡献 #444 (opens new window)
【修复】Vue3 管理后台：流程详情的表单不显示数据问题，由 @OlyLis (opens new window) 贡献 #459 (opens new window)
【修复】Vue3 管理后台：OA 请假示例审批结果字段不正确的问题，由 @geekymv (opens new window) 贡献 #63 (opens new window)
【修复】Vue3 管理后台：流程设计器 bpmn 流转条件-流转类型选择默认流转路径，未正确显示 /，由 @最后的梦想 (opens new window) 贡献 #463 (opens new window)
【修复】Cloud bpm 模块启动会失败的情况，由 @9527 (opens new window) 贡献 #129 (opens new window)
【修复】Vue3 管理后台：流程设计器中，选择表达式时，不生效的情况，由 @芋道源码 (opens new window) 贡献 46da7e2 (opens new window)
【修复】Vue3 管理后台：流程重新发起时，禁用业务表单的情况，避免报错，由 @芋道源码 (opens new window) 贡献 5d91131 (opens new window)
【修复】发起用户可能没有部门，由 @今晚打老虎 (opens new window) 贡献 #123 (opens new window)

PAY 支付专区：

【修复】示例订单完成支付后跳转到 404 页面的问题，由 @邓超 (opens new window) 贡献 #50 (opens new window)
【修复】无法配置微信原生支付与网站支付的问题，由 @邓超 (opens new window) 贡献 #53 (opens new window)
【修复】微信扫码支付 v2 版本，缺少 product_id 的报错，由由 @芋道源码 (opens new window) 贡献 e02b95f (opens new window)

ERP 企业管理专区：

【修复】采购订单菜单权限错误问题，由 @咖啡不苦 (opens new window) 贡献 #113 (opens new window)
【修复】采购金额计算逻辑错误，由 @zhenxi-he (opens new window) 贡献 #563 (opens new window)
【修复】数据统计时，租户在 MyBatis XML 不生效的问题，由 @芋道源码 (opens new window) 贡献 fe3f144 (opens new window)

MP 公众号专区：

【修复】Vue3 管理后台：/mp/open/ -> /admin-api/mp/open/，由 @21克的爱情 (opens new window) 贡献 #461 (opens new window)

REPORT 报表专区：

【修复】修复积木在访问 jmreport/index 会报错的问题，由 @芋道源码 (opens new window) 贡献 39bf9cf (opens new window)

# 🔨 Dependency Upgrades

【升级】spring boot from 3.2.2 to 3.3.1
【升级】druid from 1.2.21 to 1.2.23
【升级】dynamic-datasource from 4.3.0 to 4.3.1
【升级】spring boot admin from 3.2.1 to 3.3.2
【升级】podam from 8.0.1 to 8.0.2
【升级】jedis-mock from 1.0.13 to 1.1.2
【升级】lombok from 1.18.30 to 1.18.34
【升级】jsoup from 1.17.2 to 1.18.1
【升级】hutool-5 from 5.8.25 to 5.8.29
【升级】hutool-6 from 6.0.0-M10 to 6.0.0-M14
【升级】guava from 33.0.0-jre to 33.2.1-jre
【升级】commons-net from 3.10.0 to 3.11.1
【升级】tika-core from 2.9.1 to 2.9.2
【升级】easy-excel from 3.3.3 to 3.3.4
【升级】mybatis-plus from 3.5.5 to 3.5.7
【升级】spring-cloud-alibaba from 2022.0.0.0 to 2023.0.1.2
【升级】jimureport from 1.6.6 to 1.7.8
【升级】easy-trans from 2.2.11 to 3.0.5
【升级】redisson from 3.26.0 to 3.32.0
【升级】knife4j from 4.3.0 to 4.5.0
【升级】maven-compiler-plugin from 3.11.0 to 3.13.0
【升级】flatten-maven-plugin from 1.5.0 to 1.6.0

← 【v2.3.0】2024-10-07 【v2.1.0】2024-05-05→