From 70d3505b94138a386f3a3f6c65bbf0eb59df93d4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=96=AF=E7=8B=82=E7=9A=84=E7=8B=AE=E5=AD=90Li?=
 <15040126243@163.com>
Date: Thu, 21 Aug 2025 10:07:15 +0800
Subject: [PATCH] update springdoc 2.8.9 => 2.8.10

---
 pom.xml                                              |  2 +-
 .../system/controller/monitor/CacheController.java   |  7 +++++++
 .../system/controller/system/SysMenuController.java  |  6 ++++++
 .../controller/system/SysProfileController.java      | 12 ++++++++++++
 .../system/controller/system/SysRoleController.java  |  6 ++++++
 5 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 1e513d925..bad2f4b8b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -19,7 +19,7 @@
         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
         <java.version>17</java.version>
         <mybatis.version>3.5.16</mybatis.version>
-        <springdoc.version>2.8.9</springdoc.version>
+        <springdoc.version>2.8.10</springdoc.version>
         <therapi-javadoc.version>0.15.0</therapi-javadoc.version>
         <fastexcel.version>1.2.0</fastexcel.version>
         <velocity.version>2.3</velocity.version>
diff --git a/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/monitor/CacheController.java b/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/monitor/CacheController.java
index 5767c8df0..4a82536f1 100644
--- a/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/monitor/CacheController.java
+++ b/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/monitor/CacheController.java
@@ -53,6 +53,13 @@ public class CacheController {
         }
     }
 
+    /**
+     * 缓存监控列表信息
+     *
+     * @param info         信息
+     * @param dbSize       数据库
+     * @param commandStats 命令统计
+     */
     public record CacheListInfoVo(Properties info, Long dbSize, List<Map<String, String>> commandStats) {}
 
 }
diff --git a/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysMenuController.java b/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysMenuController.java
index 86c08996f..d1b5b9bd5 100644
--- a/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysMenuController.java
+++ b/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysMenuController.java
@@ -179,6 +179,12 @@ public class SysMenuController extends BaseController {
         return toAjax(menuService.deleteMenuById(menuId));
     }
 
+    /**
+     * 角色菜单列表树信息
+     *
+     * @param checkedKeys 选中菜单列表
+     * @param menus       菜单下拉树结构列表
+     */
     public record MenuTreeSelectVo(List<Long> checkedKeys, List<Tree<Long>> menus) {
     }
 
diff --git a/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysProfileController.java b/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysProfileController.java
index 265bda99b..9621cb239 100644
--- a/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysProfileController.java
+++ b/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysProfileController.java
@@ -129,8 +129,20 @@ public class SysProfileController extends BaseController {
         return R.fail("上传图片异常，请联系管理员");
     }
 
+    /**
+     * 用户头像信息
+     *
+     * @param imgUrl 头像地址
+     */
     public record AvatarVo(String imgUrl) {}
 
+    /**
+     * 用户个人信息
+     *
+     * @param user      用户信息
+     * @param roleGroup 用户所属角色组
+     * @param postGroup 用户所属岗位组
+     */
     public record ProfileVo(ProfileUserVo user, String roleGroup, String postGroup) {}
 
 }
diff --git a/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysRoleController.java b/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysRoleController.java
index 8609e1950..755a9ecab 100644
--- a/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysRoleController.java
+++ b/ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/SysRoleController.java
@@ -235,6 +235,12 @@ public class SysRoleController extends BaseController {
         return R.ok(selectVo);
     }
 
+    /**
+     * 角色部门列表树信息
+     *
+     * @param checkedKeys 选中部门列表
+     * @param depts       下拉树结构列表
+     */
     public record DeptTreeSelectVo(List<Long> checkedKeys, List<Tree<Long>> depts) {}
 
 }