添加接口字段定义

ruoyi-api/tuoheng-api-device/pom.xml

@@ -28,6 +28,13 @@
             <scope>provided</scope>
         </dependency>
 
+        <!-- SpringDoc OpenAPI -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <scope>provided</scope>
+        </dependency>
+
     </dependencies>
 
 </project>

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/AircraftDetailVO.java

@@ -2,6 +2,7 @@ package com.ruoyi.device.api.domain;
 
 import com.ruoyi.common.core.annotation.Excel;
 import com.ruoyi.common.core.web.domain.BaseEntity;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.io.Serializable;
@@ -14,77 +15,94 @@ import java.util.List;
  * @date 2026-01-20
  */
 @Data
+@Schema(description = "无人机详情VO对象")
 public class AircraftDetailVO extends AircraftVO {
     private static final long serialVersionUID = 1L;
 
     // ========== 基本信息区域 ==========
 
     /** 无人机版本 */
+    @Schema(description = "无人机版本")
     @Excel(name = "无人机版本")
     private String aircraftVersion;
 
     /** 无人机SN号 */
+    @Schema(description = "无人机SN号")
     @Excel(name = "无人机SN号")
     private String snNumber;
 
     /** 电池SN号 */
+    @Schema(description = "电池SN号")
     @Excel(name = "电池SN号")
     private String batterySn;
 
     /** 绑定时间 */
+    @Schema(description = "绑定时间")
     @Excel(name = "绑定时间")
     private Long bindTime;
 
     /** 运维剩余天数 */
+    @Schema(description = "运维剩余天数")
     @Excel(name = "运维剩余天数")
     private Integer maintenanceDays;
 
     // ========== 统计信息区域 ==========
 
     /** 飞行时长 */
+    @Schema(description = "飞行时长")
     @Excel(name = "飞行时长")
     private Integer flightDuration;
 
     /** 作业架次 */
+    @Schema(description = "作业架次")
     @Excel(name = "作业架次")
     private Integer missionCount;
 
     // ========== 网络列表 ==========
 
     /** 网络列表 */
+    @Schema(description = "网络列表")
     private List<NetworkVO> networkList;
 
     // ========== 遥测数据区域 ==========
 
     /** RTK信号 */
+    @Schema(description = "RTK信号")
     @Excel(name = "RTK信号")
     private Double rtkSignal;
 
     /** 限高 */
+    @Schema(description = "限高")
     @Excel(name = "限高")
     private Integer maxAltitude;
 
     /** 限远 */
+    @Schema(description = "限远")
     @Excel(name = "限远")
     private Integer maxDistance;
 
     /** 电压 */
+    @Schema(description = "电压")
     @Excel(name = "电压")
     private Integer voltage;
 
     /** 电量 */
+    @Schema(description = "电量")
     @Excel(name = "电量")
     private Integer batteryLevel;
 
     /** 续航 */
+    @Schema(description = "续航")
     @Excel(name = "续航")
     private Integer flightTimeRemaining;
 
     /** 电池温度 */
+    @Schema(description = "电池温度")
     @Excel(name = "电池温度")
     private Double batteryTemperature;
 
     /** 循环次数 */
+    @Schema(description = "循环次数")
     @Excel(name = "循环次数")
     private Integer cycleCount;
 

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/AircraftVO.java

@@ -2,6 +2,7 @@ package com.ruoyi.device.api.domain;
 
 import com.ruoyi.common.core.annotation.Excel;
 import com.ruoyi.common.core.web.domain.BaseEntity;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.io.Serializable;
@@ -14,35 +15,43 @@ import java.util.List;
  * @date 2026-01-20
  */
 @Data
+@Schema(description = "无人机VO对象")
 public class AircraftVO implements Serializable {
 
     private static final long serialVersionUID = 1L;
 
     /** 无人机ID */
+    @Schema(description = "无人机ID")
     @Excel(name = "无人机ID")
     private Long aircraftId;
 
     /** 无人机IOT ID */
+    @Schema(description = "无人机IOT ID")
     @Excel(name = "无人机IOT ID")
     private String aircraftIotId;
 
     /** 无人机名称 */
+    @Schema(description = "无人机名称")
     @Excel(name = "无人机名称")
     private String aircraftName;
 
     /** 无人机厂商 */
+    @Schema(description = "无人机厂商")
     @Excel(name = "无人机厂商")
     private String aircraftManufacturer;
 
     /** 无人机型号 */
+    @Schema(description = "无人机型号")
     @Excel(name = "无人机型号")
     private String aircraftModel;
 
     /** 无人机状态 */
+    @Schema(description = "无人机状态")
     @Excel(name = "无人机状态")
     private String aircraftStatus;
 
     /** 挂载列表 */
+    @Schema(description = "挂载列表")
     private List<PayloadVO> payloadList;
 
 

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/DeviceTempVO.java

@@ -1,6 +1,7 @@
 package com.ruoyi.device.api.domain;
 
 import com.ruoyi.common.core.web.domain.BaseEntity;
+import io.swagger.v3.oas.annotations.media.Schema;
 
 /**
  * 设备临时表对象 tuoheng_device_temp
@@ -8,11 +9,13 @@ import com.ruoyi.common.core.web.domain.BaseEntity;
  * @author ruoyi
  * @date 2026-01-15
  */
+@Schema(description = "设备临时表对象")
 public class DeviceTempVO extends BaseEntity
 {
     private static final long serialVersionUID = 1L;
 
     /** 主键ID */
+    @Schema(description = "主键ID")
     private String id;
 
     public String getId()

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/DockDetailVO.java

@@ -2,6 +2,7 @@ package com.ruoyi.device.api.domain;
 
 import com.ruoyi.common.core.annotation.Excel;
 import com.ruoyi.common.core.web.domain.BaseEntity;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.io.Serializable;
@@ -13,6 +14,7 @@ import java.io.Serializable;
  * @date 2026-01-20
  */
 @Data
+@Schema(description = "机场详情VO对象")
 public class DockDetailVO extends DockVO {
     private static final long serialVersionUID = 1L;
 
@@ -22,24 +24,28 @@ public class DockDetailVO extends DockVO {
     /**
      * 固件版本
      */
+    @Schema(description = "固件版本")
     @Excel(name = "固件版本")
     private String firmwareVersion;
 
     /**
      * SN号
      */
+    @Schema(description = "SN号")
     @Excel(name = "SN号")
     private String snNumber;
 
     /**
      * 绑定时间
      */
+    @Schema(description = "绑定时间")
     @Excel(name = "绑定时间")
     private Long bindTime;
 
     /**
      * 运维剩余天数
      */
+    @Schema(description = "运维剩余天数")
     @Excel(name = "运维剩余天数")
     private Integer maintenanceDays;
 
@@ -48,12 +54,14 @@ public class DockDetailVO extends DockVO {
     /**
      * 备降点坐标（经度）
      */
+    @Schema(description = "备降点经度")
     @Excel(name = "备降点经度")
     private Double backupLongitude;
 
     /**
      * 备降点坐标（纬度）
      */
+    @Schema(description = "备降点纬度")
     @Excel(name = "备降点纬度")
     private Double backupLatitude;
 
@@ -62,36 +70,42 @@ public class DockDetailVO extends DockVO {
     /**
      * 运行时长
      */
+    @Schema(description = "运行时长")
     @Excel(name = "运行时长")
     private Integer runningDuration;
 
     /**
      * 作业架次
      */
+    @Schema(description = "作业架次")
     @Excel(name = "作业架次")
     private Integer missionCount;
 
     /**
      * 环境风速
      */
+    @Schema(description = "环境风速")
     @Excel(name = "环境风速")
     private Double windSpeed;
 
     /**
      * 环境雨量
      */
+    @Schema(description = "环境雨量")
     @Excel(name = "环境雨量")
     private Double rainfall;
 
     /**
      * 环境温度
      */
+    @Schema(description = "环境温度")
     @Excel(name = "环境温度")
     private Double environmentTemperature;
 
     /**
      * 环境湿度
      */
+    @Schema(description = "环境湿度")
     @Excel(name = "环境湿度")
     private Double environmentHumidity;
 
@@ -100,12 +114,14 @@ public class DockDetailVO extends DockVO {
     /**
      * 网络类型
      */
+    @Schema(description = "网络类型")
     @Excel(name = "网络类型")
     private String networkType;
 
     /**
      * 网络延迟
      */
+    @Schema(description = "网络延迟")
     @Excel(name = "网络延迟")
     private Integer networkDelay;
 
@@ -114,76 +130,89 @@ public class DockDetailVO extends DockVO {
     /**
      * 空调状态
      */
+    @Schema(description = "空调状态")
     @Excel(name = "空调状态")
     private String airConditionerStatus;
 
     /**
      * 舱门状态
      */
+    @Schema(description = "舱门状态")
     @Excel(name = "舱门状态")
     private String cabinDoorStatus;
 
     /**
      * 机场状态
      */
+    @Schema(description = "机场运行状态")
     @Excel(name = "机场运行状态")
     private String dockRunStatus;
 
     /**
      * 舱内摄像头
      */
+    @Schema(description = "舱内摄像头")
     @Excel(name = "舱内摄像头")
     private String internalCamera;
 
     /**
      * 舱外摄像头
      */
+    @Schema(description = "舱外摄像头")
     @Excel(name = "舱外摄像头")
     private String externalCamera;
 
     /**
      * 充放电状态
      */
+    @Schema(description = "充放电状态")
     @Excel(name = "充放电状态")
     private String chargingStatus;
 
     /**
      * 舱内温度
      */
+    @Schema(description = "舱内温度")
     @Excel(name = "舱内温度")
     private Double cabinTemperature;
 
     /**
      * 舱内湿度
      */
+    @Schema(description = "舱内湿度")
     @Excel(name = "舱内湿度")
     private Double cabinHumidity;
 
     /**
      * 升降架位置
      */
+    @Schema(description = "升降架位置")
     @Excel(name = "升降架位置")
     private String elevatorPosition;
 
     /**
      * X轴夹状态
      */
+    @Schema(description = "X轴夹状态")
     @Excel(name = "X轴夹状态")
     private String xAxisClampStatus;
 
     /**
      * Y轴夹状态
      */
+    @Schema(description = "Y轴夹状态")
     @Excel(name = "Y轴夹状态")
     private String yAxisClampStatus;
 
     /**
      *纬度
      */
+    @Schema(description = "纬度")
     private Double  latitude;
     /**
      * 经度
      */
+    @Schema(description = "经度")
     private Double  longitude;
 
 

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/DockVO.java

@@ -2,6 +2,7 @@ package com.ruoyi.device.api.domain;
 
 import com.ruoyi.common.core.annotation.Excel;
 import com.ruoyi.common.core.web.domain.BaseEntity;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.io.Serializable;
@@ -14,63 +15,78 @@ import java.util.List;
  * @date 2026-01-20
  */
 @Data
+@Schema(description = "机场VO对象")
 public class DockVO implements Serializable {
 
     private static final long serialVersionUID = 1L;
 
     /** 机场ID */
+    @Schema(description = "机场ID")
     @Excel(name = "机场ID")
     private Long dockId;
 
     /** 机场IOT ID */
+    @Schema(description = "机场IOT ID")
     @Excel(name = "机场IOT ID")
     private String dockIotId;
 
     /** 机场名称 */
+    @Schema(description = "机场名称")
     @Excel(name = "机场名称")
     private String dockName;
 
     /** 机场位置 */
+    @Schema(description = "机场位置")
     @Excel(name = "机场位置")
     private String dockLocation;
 
     /** 机场厂商 */
+    @Schema(description = "机场厂商")
     @Excel(name = "机场厂商")
     private String dockManufacturer;
 
     /** 机场型号 */
+    @Schema(description = "机场型号")
     @Excel(name = "机场型号")
     private String dockModel;
 
     /** 机场状态 */
+    @Schema(description = "机场状态")
     @Excel(name = "机场状态")
     private String dockStatus;
 
     /** 无人机ID */
+    @Schema(description = "无人机ID")
     @Excel(name = "无人机ID")
     private Long aircraftId;
 
     /** 无人机IOT ID */
+    @Schema(description = "无人机IOT ID")
     @Excel(name = "无人机IOT ID")
     private String aircraftIotId;
 
     /** 无人机名称 */
+    @Schema(description = "无人机名称")
     @Excel(name = "无人机名称")
     private String aircraftName;
 
     /** 无人机厂商 */
+    @Schema(description = "无人机厂商")
     @Excel(name = "无人机厂商")
     private String aircraftManufacturer;
 
     /** 无人机型号 */
+    @Schema(description = "无人机型号")
     @Excel(name = "无人机型号")
     private String aircraftModel;
 
     /** 无人机状态 */
+    @Schema(description = "无人机状态")
     @Excel(name = "无人机状态")
     private String aircraftStatus;
 
     /** 挂载列表 */
+    @Schema(description = "挂载列表")
     private List<PayloadVO> payloadList;
 
 }

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/DockWithGPSVO.java

@@ -1,6 +1,7 @@
 package com.ruoyi.device.api.domain;
 
 import com.ruoyi.common.core.annotation.Excel;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.io.Serializable;
@@ -13,69 +14,70 @@ import java.util.List;
  * @date 2026-01-20
  */
 @Data
+@Schema(description = "机场信息（含GPS坐标）")
 public class DockWithGPSVO implements Serializable {
 
     private static final long serialVersionUID = 1L;
 
-    /** 机场ID */
+    @Schema(description = "机场ID")
     @Excel(name = "机场ID")
     private Long dockId;
 
-    /** 机场IOT ID */
+    @Schema(description = "机场IOT ID")
     @Excel(name = "机场IOT ID")
     private String dockIotId;
 
-    /** 机场名称 */
+    @Schema(description = "机场名称")
     @Excel(name = "机场名称")
     private String dockName;
 
-    /** 机场位置 */
+    @Schema(description = "机场位置")
     @Excel(name = "机场位置")
     private String dockLocation;
 
-    /** 机场厂商 */
+    @Schema(description = "机场厂商")
     @Excel(name = "机场厂商")
     private String dockManufacturer;
 
-    /** 机场型号 */
+    @Schema(description = "机场型号")
     @Excel(name = "机场型号")
     private String dockModel;
 
-    /** 机场状态 */
+    @Schema(description = "机场状态")
     @Excel(name = "机场状态")
     private String dockStatus;
 
-    /** 无人机ID */
+    @Schema(description = "无人机ID")
     @Excel(name = "无人机ID")
     private Long aircraftId;
 
-    /** 无人机IOT ID */
+    @Schema(description = "无人机IOT ID")
     @Excel(name = "无人机IOT ID")
     private String aircraftIotId;
 
-    /** 无人机名称 */
+    @Schema(description = "无人机名称")
     @Excel(name = "无人机名称")
     private String aircraftName;
 
-    /** 无人机厂商 */
+    @Schema(description = "无人机厂商")
     @Excel(name = "无人机厂商")
     private String aircraftManufacturer;
 
-    /** 无人机型号 */
+    @Schema(description = "无人机型号")
     @Excel(name = "无人机型号")
     private String aircraftModel;
 
-    /** 无人机状态 */
+    @Schema(description = "无人机状态")
     @Excel(name = "无人机状态")
     private String aircraftStatus;
 
-    /** 挂载列表 */
+    @Schema(description = "挂载列表")
     private List<PayloadVO> payloadList;
 
-    /** 纬度 */
+    @Schema(description = "纬度")
     private Double latitude;
 
-    /** 经度 */
+    @Schema(description = "经度")
     private Double longitude;
 
 }

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/GroupVO.java

@@ -1,6 +1,7 @@
 package com.ruoyi.device.api.domain;
 
 import com.ruoyi.common.core.annotation.Excel;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.io.Serializable;
@@ -13,24 +14,29 @@ import java.util.List;
  * @date 2026-01-20
  */
 @Data
+@Schema(description = "分组VO对象")
 public class GroupVO implements Serializable
 {
 
     private static final long serialVersionUID = 1L;
 
     /** 分组ID */
+    @Schema(description = "分组ID")
     @Excel(name = "分组ID")
     private Long groupId;
 
     /** 分组名称 */
+    @Schema(description = "分组名称")
     @Excel(name = "分组名称")
     private String groupName;
 
     /** 无人机个数 */
+    @Schema(description = "机场个数")
     @Excel(name = "机场个数")
     private Integer dockCount;
 
     /** 机场列表 */
+    @Schema(description = "机场列表")
     private List<DockVO> dockList;
 
 

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/NetworkVO.java

@@ -2,6 +2,7 @@ package com.ruoyi.device.api.domain;
 
 import com.ruoyi.common.core.annotation.Excel;
 import com.ruoyi.common.core.web.domain.BaseEntity;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.io.Serializable;
@@ -13,15 +14,18 @@ import java.io.Serializable;
  * @date 2026-01-20
  */
 @Data
+@Schema(description = "网络信息VO对象")
 public class NetworkVO implements Serializable
 {
     private static final long serialVersionUID = 1L;
 
     /** 网络类型 */
+    @Schema(description = "网络类型")
     @Excel(name = "网络类型")
     private String networkType;
 
     /** 网络延迟 */
+    @Schema(description = "网络延迟")
     @Excel(name = "网络延迟")
     private Integer networkDelay;
 

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/PayloadDetailVO.java

@@ -2,6 +2,7 @@ package com.ruoyi.device.api.domain;
 
 import com.ruoyi.common.core.annotation.Excel;
 import com.ruoyi.common.core.web.domain.BaseEntity;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.io.Serializable;
@@ -13,23 +14,28 @@ import java.io.Serializable;
  * @date 2026-01-20
  */
 @Data
+@Schema(description = "挂载详情VO对象")
 public class PayloadDetailVO implements Serializable
 {
     private static final long serialVersionUID = 1L;
 
     /** 挂载类型 */
+    @Schema(description = "挂载类型")
     @Excel(name = "挂载类型")
     private String payloadType;
 
     /** 挂载型号 */
+    @Schema(description = "挂载型号")
     @Excel(name = "挂载型号")
     private String payloadModel;
 
     /** 固件版本 */
+    @Schema(description = "固件版本")
     @Excel(name = "固件版本")
     private String firmwareVersion;
 
     /** 是否在线 */
+    @Schema(description = "是否在线")
     @Excel(name = "是否在线")
     private String onlineStatus;
 

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/PayloadVO.java

@@ -2,6 +2,7 @@ package com.ruoyi.device.api.domain;
 
 import com.ruoyi.common.core.annotation.Excel;
 import com.ruoyi.common.core.web.domain.BaseEntity;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.io.Serializable;
@@ -13,23 +14,28 @@ import java.io.Serializable;
  * @date 2026-01-20
  */
 @Data
+@Schema(description = "挂载VO对象")
 public class PayloadVO implements Serializable
 {
     private static final long serialVersionUID = 1L;
 
     /** 挂载ID */
+    @Schema(description = "挂载ID")
     @Excel(name = "挂载ID")
     private Long payloadId;
 
     /** 挂载名称 */
+    @Schema(description = "挂载名称")
     @Excel(name = "挂载名称")
     private String payloadName;
 
     /** 挂载类型 */
+    @Schema(description = "挂载类型")
     @Excel(name = "挂载类型")
     private String payloadType;
 
     /** 挂载状态 */
+    @Schema(description = "挂载状态")
     @Excel(name = "挂载状态")
     private String payloadStatus;
 

ruoyi-api/tuoheng-api-device/src/main/java/com/ruoyi/device/api/domain/StatisticsVO.java

@@ -1,5 +1,6 @@
 package com.ruoyi.device.api.domain;
 
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.io.Serializable;
@@ -11,49 +12,50 @@ import java.io.Serializable;
  * @date 2026-01-23
  */
 @Data
+@Schema(description = "统计信息")
 public class StatisticsVO implements Serializable
 {
     private static final long serialVersionUID = 1L;
 
     // ========== 机场统计 ==========
-    /** 机场个数 */
+    @Schema(description = "机场个数")
     private Integer dockCount;
 
-    /** 空闲机场个数 */
+    @Schema(description = "空闲机场个数")
     private Integer idleDockCount;
 
-    /** 任务中机场个数 */
+    @Schema(description = "任务中机场个数")
     private Integer workingDockCount;
 
-    /** 调试机场个数 */
+    @Schema(description = "调试机场个数")
     private Integer debuggingDockCount;
 
-    /** 离线机场个数 */
+    @Schema(description = "离线机场个数")
     private Integer offlineDockCount;
 
     // ========== 无人机统计 ==========
-    /** 无人机个数 */
+    @Schema(description = "无人机个数")
     private Integer aircraftCount;
 
-    /** 舱内开机个数 */
+    @Schema(description = "舱内开机个数")
     private Integer powerOnInCabinCount;
 
-    /** 舱内关机个数 */
+    @Schema(description = "舱内关机个数")
     private Integer powerOffInCabinCount;
 
-    /** 任务中个数 */
+    @Schema(description = "任务中个数")
     private Integer inMissionCount;
 
-    /** 调试中个数 */
+    @Schema(description = "调试中个数")
     private Integer debuggingAircraftCount;
 
-    /** 离线个数 */
+    @Schema(description = "离线个数")
     private Integer offlineAircraftCount;
 
     // ========== 挂载统计 ==========
-    /** 全部挂载个数 */
+    @Schema(description = "全部挂载个数")
     private Integer payloadCount;
 
-    /** 离线个数 */
+    @Schema(description = "离线挂载个数")
     private Integer offlinePayloadCount;
 }