From 2965b454cf534f794f7261aeeb37b17f179c434c Mon Sep 17 00:00:00 2001
From: daiyongfei <974332738@qq.com>
Date: Fri, 22 Aug 2025 16:37:58 +0800
Subject: [PATCH] =?UTF-8?q?web:=E8=AE=BE=E5=A4=87=E5=88=86=E7=BB=84=20?=
 =?UTF-8?q?=E6=8E=A5=E5=8F=A3=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../web/controller/device/DeviceGroupController.java      | 8 ++++++++
 fys-admin/src/main/resources/application.yml              | 2 ++
 .../com/fuyuanshen/equipment/domain/bo/DeviceGroupBo.java | 3 +++
 3 files changed, 13 insertions(+)

diff --git a/fys-admin/src/main/java/com/fuyuanshen/web/controller/device/DeviceGroupController.java b/fys-admin/src/main/java/com/fuyuanshen/web/controller/device/DeviceGroupController.java
index 0f0eafab..28601a1a 100644
--- a/fys-admin/src/main/java/com/fuyuanshen/web/controller/device/DeviceGroupController.java
+++ b/fys-admin/src/main/java/com/fuyuanshen/web/controller/device/DeviceGroupController.java
@@ -3,6 +3,8 @@ package com.fuyuanshen.web.controller.device;
 import java.util.List;
 
 import com.fuyuanshen.common.mybatis.core.page.TableDataInfo;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
 import jakarta.servlet.http.HttpServletResponse;
 import jakarta.validation.constraints.*;
@@ -27,6 +29,7 @@ import com.fuyuanshen.equipment.service.IDeviceGroupService;
  * @author Lion Li
  * @date 2025-08-08
  */
+@Tag(name = "web:设备分组", description = "web:设备分组")
 @Validated
 @RequiredArgsConstructor
 @RestController
@@ -39,6 +42,7 @@ public class DeviceGroupController extends BaseController {
     /**
      * 查询设备分组列表
      */
+    @Operation(summary = "查询设备分组列表")
     @SaCheckPermission("fys-equipment:group:list")
     @GetMapping("/list")
     public R<List<DeviceGroupVo>> list(DeviceGroupBo bo) {
@@ -64,6 +68,7 @@ public class DeviceGroupController extends BaseController {
      *
      * @param id 主键
      */
+    @Operation(summary = "获取设备分组详细信息")
     @SaCheckPermission("fys-equipment:group:query")
     @GetMapping("/{id}")
     public R<DeviceGroupVo> getInfo(@NotNull(message = "主键不能为空") @PathVariable Long id) {
@@ -74,6 +79,7 @@ public class DeviceGroupController extends BaseController {
     /**
      * 新增设备分组
      */
+    @Operation(summary = "新增设备分组")
     @SaCheckPermission("fys-equipment:group:add")
     @Log(title = "设备分组", businessType = BusinessType.INSERT)
     @RepeatSubmit()
@@ -86,6 +92,7 @@ public class DeviceGroupController extends BaseController {
     /**
      * 修改设备分组
      */
+    @Operation(summary = "修改设备分组")
     @SaCheckPermission("fys-equipment:group:edit")
     @Log(title = "设备分组", businessType = BusinessType.UPDATE)
     @RepeatSubmit()
@@ -99,6 +106,7 @@ public class DeviceGroupController extends BaseController {
      *
      * @param ids 主键串
      */
+    @Operation(summary = "删除设备分组")
     @SaCheckPermission("fys-equipment:group:remove")
     @Log(title = "设备分组", businessType = BusinessType.DELETE)
     @DeleteMapping("/{ids}")
diff --git a/fys-admin/src/main/resources/application.yml b/fys-admin/src/main/resources/application.yml
index 3b4dce13..21924a61 100644
--- a/fys-admin/src/main/resources/application.yml
+++ b/fys-admin/src/main/resources/application.yml
@@ -219,6 +219,8 @@ springdoc:
       packages-to-scan: com.fuyuanshen.customer
     - group: APP模块
       packages-to-scan: com.fuyuanshen.app
+    - group: 设备分组
+      packages-to-scan: com.fuyuanshen.web.controller.device
 
 # 防止XSS攻击
 xss:
diff --git a/fys-modules/fys-equipment/src/main/java/com/fuyuanshen/equipment/domain/bo/DeviceGroupBo.java b/fys-modules/fys-equipment/src/main/java/com/fuyuanshen/equipment/domain/bo/DeviceGroupBo.java
index 37cff3b9..064c5aa2 100644
--- a/fys-modules/fys-equipment/src/main/java/com/fuyuanshen/equipment/domain/bo/DeviceGroupBo.java
+++ b/fys-modules/fys-equipment/src/main/java/com/fuyuanshen/equipment/domain/bo/DeviceGroupBo.java
@@ -30,18 +30,21 @@ public class DeviceGroupBo extends BaseEntity {
     /**
      * 分组名称
      */
+    @Schema(name = "分组名称")
     @NotBlank(message = "分组名称不能为空", groups = { AddGroup.class, EditGroup.class })
     private String groupName;
 
     /**
      * 状态：0-禁用，1-正常
      */
+    @Schema(name = "状态：0-禁用，1-正常")
     // @NotNull(message = "状态：0-禁用，1-正常不能为空", groups = { AddGroup.class, EditGroup.class })
     private Long status;
 
     /**
      * 父分组ID
      */
+    @Schema(name = "父分组ID")
     private Long parentId;
 
     /**