params;
+
+ /**
+ * 设备信息
+ */
+ @Data
+ public static class Device {
+
+ /**
+ * 产品标识
+ */
+ @NotEmpty(message = "产品标识不能为空")
+ private String productKey;
+
+ /**
+ * 设备名称
+ */
+ @NotEmpty(message = "设备名称不能为空")
+ private String deviceName;
+
+ // TODO @芋艿：阿里云还有 sign 签名
+
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/device/dto/control/upstream/IotDeviceUpstreamAbstractReqDTO.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/device/dto/control/upstream/IotDeviceUpstreamAbstractReqDTO.java
new file mode 100644
index 000000000..a0c8ce92a
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/device/dto/control/upstream/IotDeviceUpstreamAbstractReqDTO.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.iot.api.device.dto.control.upstream;
+
+import cn.iocoder.yudao.framework.common.util.json.databind.TimestampLocalDateTimeSerializer;
+import com.fasterxml.jackson.databind.annotation.JsonSerialize;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+/**
+ * IoT 设备上行的抽象 Request DTO
+ *
+ * @author 芋道源码
+ */
+@Data
+public abstract class IotDeviceUpstreamAbstractReqDTO {
+
+ /**
+ * 请求编号
+ */
+ private String requestId;
+
+ /**
+ * 插件实例的进程编号
+ */
+ private String processId;
+
+ /**
+ * 产品标识
+ */
+ @NotEmpty(message = "产品标识不能为空")
+ private String productKey;
+ /**
+ * 设备名称
+ */
+ @NotEmpty(message = "设备名称不能为空")
+ private String deviceName;
+
+ /**
+ * 上报时间
+ */
+ @JsonSerialize(using = TimestampLocalDateTimeSerializer.class) // 解决 iot plugins 序列化 LocalDateTime 是数组，导致无法解析的问题
+ private LocalDateTime reportTime;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/device/dto/control/upstream/IotPluginInstanceHeartbeatReqDTO.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/device/dto/control/upstream/IotPluginInstanceHeartbeatReqDTO.java
new file mode 100644
index 000000000..9125b5f24
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/device/dto/control/upstream/IotPluginInstanceHeartbeatReqDTO.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.iot.api.device.dto.control.upstream;
+
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * IoT 插件实例心跳 Request DTO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class IotPluginInstanceHeartbeatReqDTO {
+
+ /**
+ * 请求编号
+ */
+ @NotEmpty(message = "请求编号不能为空")
+ private String processId;
+
+ /**
+ * 插件包标识符
+ */
+ @NotEmpty(message = "插件包标识符不能为空")
+ private String pluginKey;
+
+ /**
+ * 插件实例所在 IP
+ */
+ @NotEmpty(message = "插件实例所在 IP 不能为空")
+ private String hostIp;
+ /**
+ * 插件实例的进程编号
+ */
+ @NotNull(message = "插件实例的进程编号不能为空")
+ private Integer downstreamPort;
+
+ /**
+ * 是否在线
+ */
+ @NotNull(message = "是否在线不能为空")
+ private Boolean online;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/device/dto/package-info.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/device/dto/package-info.java
new file mode 100644
index 000000000..cb946cd89
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/device/dto/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * TODO 芋艿：占位
+ */
+package cn.iocoder.yudao.module.iot.api.device.dto;
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/package-info.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/package-info.java
new file mode 100644
index 000000000..7da0c665b
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/api/package-info.java
@@ -0,0 +1,6 @@
+/**
+ * 占位
+ *
+ * TODO 芋艿：后续删除
+ */
+package cn.iocoder.yudao.module.iot.api;
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ApiConstants.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ApiConstants.java
new file mode 100644
index 000000000..2c4147be1
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ApiConstants.java
@@ -0,0 +1,16 @@
+package cn.iocoder.yudao.module.iot.enums;
+
+import cn.iocoder.yudao.framework.common.enums.RpcConstants;
+
+/**
+ * API 相关的枚举
+ *
+ * @author 芋道源码
+ */
+public class ApiConstants {
+
+ public static final String PREFIX = RpcConstants.RPC_API_PREFIX + "/iot";
+
+ public static final String VERSION = "1.0.0";
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/DictTypeConstants.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/DictTypeConstants.java
new file mode 100644
index 000000000..d8f0cc60d
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/DictTypeConstants.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.iot.enums;
+
+/**
+ * IoT 字典类型的枚举类
+ *
+ * @author 芋道源码
+ */
+public class DictTypeConstants {
+
+ public static final String PRODUCT_STATUS = "iot_product_status";
+ public static final String PRODUCT_DEVICE_TYPE = "iot_product_device_type";
+ public static final String NET_TYPE = "iot_net_type";
+ public static final String PROTOCOL_TYPE = "iot_protocol_type";
+ public static final String DATA_FORMAT = "iot_data_format";
+ public static final String VALIDATE_TYPE = "iot_validate_type";
+
+ public static final String DEVICE_STATE = "iot_device_state";
+
+ public static final String IOT_DATA_BRIDGE_DIRECTION_ENUM = "iot_data_bridge_direction_enum";
+ public static final String IOT_DATA_BRIDGE_TYPE_ENUM = "iot_data_bridge_type_enum";
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ErrorCodeConstants.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ErrorCodeConstants.java
new file mode 100644
index 000000000..230baca3f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ErrorCodeConstants.java
@@ -0,0 +1,75 @@
+package cn.iocoder.yudao.module.iot.enums;
+
+import cn.iocoder.yudao.framework.common.exception.ErrorCode;
+
+/**
+ * iot 错误码枚举类
+ *
+ * iot 系统，使用 1-050-000-000 段
+ */
+public interface ErrorCodeConstants {
+
+ // ========== 产品相关 1-050-001-000 ============
+ ErrorCode PRODUCT_NOT_EXISTS = new ErrorCode(1_050_001_000, "产品不存在");
+ ErrorCode PRODUCT_KEY_EXISTS = new ErrorCode(1_050_001_001, "产品标识已经存在");
+ ErrorCode PRODUCT_STATUS_NOT_DELETE = new ErrorCode(1_050_001_002, "产品状是发布状态，不允许删除");
+ ErrorCode PRODUCT_STATUS_NOT_ALLOW_THING_MODEL = new ErrorCode(1_050_001_003, "产品状是发布状态，不允许操作物模型");
+
+ // ========== 产品物模型 1-050-002-000 ============
+ ErrorCode THING_MODEL_NOT_EXISTS = new ErrorCode(1_050_002_000, "产品物模型不存在");
+ ErrorCode THING_MODEL_EXISTS_BY_PRODUCT_KEY = new ErrorCode(1_050_002_001, "ProductKey 对应的产品物模型已存在");
+ ErrorCode THING_MODEL_IDENTIFIER_EXISTS = new ErrorCode(1_050_002_002, "存在重复的功能标识符。");
+ ErrorCode THING_MODEL_NAME_EXISTS = new ErrorCode(1_050_002_003, "存在重复的功能名称。");
+ ErrorCode THING_MODEL_IDENTIFIER_INVALID = new ErrorCode(1_050_002_003, "产品物模型标识无效");
+
+ // ========== 设备 1-050-003-000 ============
+ ErrorCode DEVICE_NOT_EXISTS = new ErrorCode(1_050_003_000, "设备不存在");
+ ErrorCode DEVICE_NAME_EXISTS = new ErrorCode(1_050_003_001, "设备名称在同一产品下必须唯一");
+ ErrorCode DEVICE_HAS_CHILDREN = new ErrorCode(1_050_003_002, "有子设备，不允许删除");
+ ErrorCode DEVICE_KEY_EXISTS = new ErrorCode(1_050_003_003, "设备标识已经存在");
+ ErrorCode DEVICE_GATEWAY_NOT_EXISTS = new ErrorCode(1_050_003_004, "网关设备不存在");
+ ErrorCode DEVICE_NOT_GATEWAY = new ErrorCode(1_050_003_005, "设备不是网关设备");
+ ErrorCode DEVICE_IMPORT_LIST_IS_EMPTY = new ErrorCode(1_050_003_006, "导入设备数据不能为空！");
+ ErrorCode DEVICE_DOWNSTREAM_FAILED = new ErrorCode(1_050_003_007, "执行失败，原因：{}");
+
+ // ========== 产品分类 1-050-004-000 ==========
+ ErrorCode PRODUCT_CATEGORY_NOT_EXISTS = new ErrorCode(1_050_004_000, "产品分类不存在");
+
+ // ========== 设备分组 1-050-005-000 ==========
+ ErrorCode DEVICE_GROUP_NOT_EXISTS = new ErrorCode(1_050_005_000, "设备分组不存在");
+ ErrorCode DEVICE_GROUP_DELETE_FAIL_DEVICE_EXISTS = new ErrorCode(1_050_005_001, "设备分组下存在设备，不允许删除");
+
+ // ========== 插件配置 1-050-006-000 ==========
+ ErrorCode PLUGIN_CONFIG_NOT_EXISTS = new ErrorCode(1_050_006_000, "插件配置不存在");
+ ErrorCode PLUGIN_INSTALL_FAILED = new ErrorCode(1_050_006_001, "插件安装失败");
+ ErrorCode PLUGIN_INSTALL_FAILED_FILE_NAME_NOT_MATCH = new ErrorCode(1_050_006_002, "插件安装失败，文件名与原插件id不匹配");
+ ErrorCode PLUGIN_CONFIG_DELETE_FAILED_RUNNING = new ErrorCode(1_050_006_003, "请先停止插件");
+ ErrorCode PLUGIN_STATUS_INVALID = new ErrorCode(1_050_006_004, "插件状态无效");
+ ErrorCode PLUGIN_CONFIG_KEY_DUPLICATE = new ErrorCode(1_050_006_005, "插件标识已存在");
+ ErrorCode PLUGIN_START_FAILED = new ErrorCode(1_050_006_006, "插件启动失败");
+ ErrorCode PLUGIN_STOP_FAILED = new ErrorCode(1_050_006_007, "插件停止失败");
+
+ // ========== 插件实例 1-050-007-000 ==========
+
+ // ========== 固件相关 1-050-008-000 ==========
+
+ ErrorCode OTA_FIRMWARE_NOT_EXISTS = new ErrorCode(1_050_008_000, "固件信息不存在");
+ ErrorCode OTA_FIRMWARE_PRODUCT_VERSION_DUPLICATE = new ErrorCode(1_050_008_001, "产品版本号重复");
+
+ ErrorCode OTA_UPGRADE_TASK_NOT_EXISTS = new ErrorCode(1_050_008_100, "升级任务不存在");
+ ErrorCode OTA_UPGRADE_TASK_NAME_DUPLICATE = new ErrorCode(1_050_008_101, "升级任务名称重复");
+ ErrorCode OTA_UPGRADE_TASK_DEVICE_IDS_EMPTY = new ErrorCode(1_050_008_102, "设备编号列表不能为空");
+ ErrorCode OTA_UPGRADE_TASK_DEVICE_LIST_EMPTY = new ErrorCode(1_050_008_103, "设备列表不能为空");
+ ErrorCode OTA_UPGRADE_TASK_CANNOT_CANCEL = new ErrorCode(1_050_008_104, "升级任务不能取消");
+
+ ErrorCode OTA_UPGRADE_RECORD_NOT_EXISTS = new ErrorCode(1_050_008_200, "升级记录不存在");
+ ErrorCode OTA_UPGRADE_RECORD_DUPLICATE = new ErrorCode(1_050_008_201, "升级记录重复");
+ ErrorCode OTA_UPGRADE_RECORD_CANNOT_RETRY = new ErrorCode(1_050_008_202, "升级记录不能重试");
+
+ // ========== MQTT 通信相关 1-050-009-000 ==========
+ ErrorCode MQTT_TOPIC_ILLEGAL = new ErrorCode(1_050_009_000, "topic illegal");
+
+ // ========== IoT 数据桥梁 1-050-010-000 ==========
+ ErrorCode DATA_BRIDGE_NOT_EXISTS = new ErrorCode(1_050_010_000, "IoT 数据桥梁不存在");
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/device/IotDeviceMessageIdentifierEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/device/IotDeviceMessageIdentifierEnum.java
new file mode 100644
index 000000000..6de9359ba
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/device/IotDeviceMessageIdentifierEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.iot.enums.device;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+// TODO @芋艿：需要添加对应的 DTO，以及上下行的链路，网关、网关服务、设备等
+/**
+ * IoT 设备消息标识符枚举
+ */
+@Getter
+@RequiredArgsConstructor
+public enum IotDeviceMessageIdentifierEnum {
+
+ PROPERTY_GET("get"), // 下行 TODO 芋艿：【讨论】貌似这个“上行”更合理？device 主动拉取配置。和 IotDevicePropertyGetReqDTO 一样的配置
+ PROPERTY_SET("set"), // 下行
+ PROPERTY_REPORT("report"), // 上行
+
+ STATE_ONLINE("online"), // 上行
+ STATE_OFFLINE("offline"), // 上行
+
+ CONFIG_GET("get"), // 上行 TODO 芋艿：【讨论】暂时没有上行的场景
+ CONFIG_SET("set"), // 下行
+
+ SERVICE_INVOKE("${identifier}"), // 下行
+ SERVICE_REPLY_SUFFIX("_reply"), // 芋艿：TODO 芋艿：【讨论】上行 or 下行
+
+ OTA_UPGRADE("upgrade"), // 下行
+ OTA_PULL("pull"), // 上行
+ OTA_PROGRESS("progress"), // 上行
+ OTA_REPORT("report"), // 上行
+
+ REGISTER_REGISTER("register"), // 上行
+ REGISTER_REGISTER_SUB("register_sub"), // 上行
+ REGISTER_UNREGISTER_SUB("unregister_sub"), // 下行
+
+ TOPOLOGY_ADD("topology_add"), // 下行;
+ ;
+
+ /**
+ * 标志符
+ */
+ private final String identifier;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/device/IotDeviceMessageTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/device/IotDeviceMessageTypeEnum.java
new file mode 100644
index 000000000..0354157ed
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/device/IotDeviceMessageTypeEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.iot.enums.device;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT 设备消息类型枚举
+ */
+@Getter
+@RequiredArgsConstructor
+public enum IotDeviceMessageTypeEnum implements ArrayValuable {
+
+ STATE("state"), // 设备状态
+ PROPERTY("property"), // 设备属性：可参考 https://help.aliyun.com/zh/iot/user-guide/device-properties-events-and-services 设备属性、事件、服务
+ EVENT("event"), // 设备事件：可参考 https://help.aliyun.com/zh/iot/user-guide/device-properties-events-and-services 设备属性、事件、服务
+ SERVICE("service"), // 设备服务：可参考 https://help.aliyun.com/zh/iot/user-guide/device-properties-events-and-services 设备属性、事件、服务
+ CONFIG("config"), // 设备配置：可参考 https://help.aliyun.com/zh/iot/user-guide/remote-configuration-1 远程配置
+ OTA("ota"), // 设备 OTA：可参考 https://help.aliyun.com/zh/iot/user-guide/ota-update OTA 升级
+ REGISTER("register"), // 设备注册：可参考 https://help.aliyun.com/zh/iot/user-guide/register-devices 设备身份注册
+ TOPOLOGY("topology"),; // 设备拓扑：可参考 https://help.aliyun.com/zh/iot/user-guide/manage-topological-relationships 设备拓扑
+
+ public static final String[] ARRAYS = Arrays.stream(values()).map(IotDeviceMessageTypeEnum::getType).toArray(String[]::new);
+
+ /**
+ * 属性
+ */
+ private final String type;
+
+ @Override
+ public String[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/device/IotDeviceStateEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/device/IotDeviceStateEnum.java
new file mode 100644
index 000000000..6ce2677db
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/device/IotDeviceStateEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.iot.enums.device;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT 设备状态枚举
+ *
+ * @author haohao
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotDeviceStateEnum implements ArrayValuable {
+
+ INACTIVE(0, "未激活"),
+ ONLINE(1, "在线"),
+ OFFLINE(2, "离线");
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotDeviceStateEnum::getState).toArray(Integer[]::new);
+
+ /**
+ * 状态
+ */
+ private final Integer state;
+ /**
+ * 状态名
+ */
+ private final String name;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+ public static boolean isOnline(Integer state) {
+ return ONLINE.getState().equals(state);
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ota/IotOtaUpgradeRecordStatusEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ota/IotOtaUpgradeRecordStatusEnum.java
new file mode 100644
index 000000000..e809a7e5b
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ota/IotOtaUpgradeRecordStatusEnum.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.iot.enums.ota;
+
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT OTA 升级记录的范围枚举
+ *
+ * @author haohao
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotOtaUpgradeRecordStatusEnum implements ArrayValuable {
+
+ PENDING(0), // 待推送
+ PUSHED(10), // 已推送
+ UPGRADING(20), // 升级中
+ SUCCESS(30), // 升级成功
+ FAILURE(40), // 升级失败
+ CANCELED(50),; // 已取消
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotOtaUpgradeRecordStatusEnum::getStatus).toArray(Integer[]::new);
+
+ /**
+ * 范围
+ */
+ private final Integer status;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ota/IotOtaUpgradeTaskScopeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ota/IotOtaUpgradeTaskScopeEnum.java
new file mode 100644
index 000000000..6dccbb041
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ota/IotOtaUpgradeTaskScopeEnum.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.iot.enums.ota;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT OTA 升级任务的范围枚举
+ *
+ * @author haohao
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotOtaUpgradeTaskScopeEnum implements ArrayValuable {
+
+ ALL(1), // 全部设备：只包括当前产品下的设备，不包括未来创建的设备
+ SELECT(2); // 指定设备
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotOtaUpgradeTaskScopeEnum::getScope).toArray(Integer[]::new);
+
+ /**
+ * 范围
+ */
+ private final Integer scope;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ota/IotOtaUpgradeTaskStatusEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ota/IotOtaUpgradeTaskStatusEnum.java
new file mode 100644
index 000000000..78af16cb2
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/ota/IotOtaUpgradeTaskStatusEnum.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.iot.enums.ota;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT OTA 升级任务的范围枚举
+ *
+ * @author haohao
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotOtaUpgradeTaskStatusEnum implements ArrayValuable {
+
+ IN_PROGRESS(10), // 进行中：升级中
+ COMPLETED(20), // 已完成：已结束，全部升级完成
+ INCOMPLETE(21), // 未完成：已结束，部分升级完成
+ CANCELED(30),; // 已取消：一般是主动取消任务
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotOtaUpgradeTaskStatusEnum::getStatus).toArray(Integer[]::new);
+
+ /**
+ * 范围
+ */
+ private final Integer status;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/plugin/IotPluginDeployTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/plugin/IotPluginDeployTypeEnum.java
new file mode 100644
index 000000000..b6ef4f0cc
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/plugin/IotPluginDeployTypeEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.iot.enums.plugin;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT 部署方式枚举
+ *
+ * @author haohao
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotPluginDeployTypeEnum implements ArrayValuable {
+
+ JAR(0, "JAR 部署"),
+ STANDALONE(1, "独立部署");
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotPluginDeployTypeEnum::getDeployType).toArray(Integer[]::new);
+
+ /**
+ * 部署方式
+ */
+ private final Integer deployType;
+ /**
+ * 部署方式名
+ */
+ private final String name;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/plugin/IotPluginStatusEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/plugin/IotPluginStatusEnum.java
new file mode 100644
index 000000000..7e3fa657e
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/plugin/IotPluginStatusEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.iot.enums.plugin;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT 插件状态枚举
+ *
+ * @author haohao
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotPluginStatusEnum implements ArrayValuable {
+
+ STOPPED(0, "停止"),
+ RUNNING(1, "运行");
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotPluginStatusEnum::getStatus).toArray(Integer[]::new);
+
+ /**
+ * 状态
+ */
+ private final Integer status;
+ /**
+ * 状态名
+ */
+ private final String name;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/plugin/IotPluginTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/plugin/IotPluginTypeEnum.java
new file mode 100644
index 000000000..ec0b72f9f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/plugin/IotPluginTypeEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.iot.enums.plugin;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 插件类型枚举
+ *
+ * @author haohao
+ */
+@AllArgsConstructor
+@Getter
+public enum IotPluginTypeEnum implements ArrayValuable {
+
+ NORMAL(0, "普通插件"),
+ DEVICE(1, "设备插件");
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotPluginTypeEnum::getType).toArray(Integer[]::new);
+
+ /**
+ * 类型
+ */
+ private final Integer type;
+ /**
+ * 类型名
+ */
+ private final String name;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotDataFormatEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotDataFormatEnum.java
new file mode 100644
index 000000000..0cfe1c9f4
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotDataFormatEnum.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.iot.enums.product;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * 产品数据格式枚举类
+ *
+ * @author ahh
+ * @see 阿里云 - 什么是消息解析
+ */
+@AllArgsConstructor
+@Getter
+public enum IotDataFormatEnum implements ArrayValuable {
+
+ JSON(0, "标准数据格式（JSON）"),
+ CUSTOMIZE(1, "透传/自定义");
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotDataFormatEnum::getType).toArray(Integer[]::new);
+
+ /**
+ * 类型
+ */
+ private final Integer type;
+ /**
+ * 描述
+ */
+ private final String description;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotNetTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotNetTypeEnum.java
new file mode 100644
index 000000000..2a54e489f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotNetTypeEnum.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.iot.enums.product;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 联网方式枚举类
+ *
+ * @author ahh
+ */
+@AllArgsConstructor
+@Getter
+public enum IotNetTypeEnum implements ArrayValuable {
+
+ WIFI(0, "Wi-Fi"),
+ CELLULAR(1, "Cellular"),
+ ETHERNET(2, "Ethernet"),
+ OTHER(3, "其他");
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotNetTypeEnum::getType).toArray(Integer[]::new);
+
+ /**
+ * 类型
+ */
+ private final Integer type;
+ /**
+ * 描述
+ */
+ private final String description;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotProductDeviceTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotProductDeviceTypeEnum.java
new file mode 100644
index 000000000..7910f1b2d
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotProductDeviceTypeEnum.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.iot.enums.product;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 产品的设备类型
+ *
+ * @author ahh
+ */
+@AllArgsConstructor
+@Getter
+public enum IotProductDeviceTypeEnum implements ArrayValuable {
+
+ DIRECT(0, "直连设备"),
+ GATEWAY_SUB(1, "网关子设备"),
+ GATEWAY(2, "网关设备");
+
+ /**
+ * 类型
+ */
+ private final Integer type;
+
+ /**
+ * 描述
+ */
+ private final String description;
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotProductDeviceTypeEnum::getType).toArray(Integer[]::new);
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+ /**
+ * 判断是否是网关
+ *
+ * @param type 类型
+ * @return 是否是网关
+ */
+ public static boolean isGateway(Integer type) {
+ return GATEWAY.getType().equals(type);
+ }
+
+ /**
+ * 判断是否是网关子设备
+ *
+ * @param type 类型
+ * @return 是否是网关子设备
+ */
+ public static boolean isGatewaySub(Integer type) {
+ return GATEWAY_SUB.getType().equals(type);
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotProductStatusEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotProductStatusEnum.java
new file mode 100644
index 000000000..b9bbbeec7
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotProductStatusEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.iot.enums.product;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 产品的状态枚举类
+ *
+ * @author ahh
+ */
+@AllArgsConstructor
+@Getter
+public enum IotProductStatusEnum implements ArrayValuable {
+
+ UNPUBLISHED(0, "开发中"),
+ PUBLISHED(1, "已发布");
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotProductStatusEnum::getStatus).toArray(Integer[]::new);
+
+ /**
+ * 类型
+ */
+ private final Integer status;
+ /**
+ * 描述
+ */
+ private final String description;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotProtocolTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotProtocolTypeEnum.java
new file mode 100644
index 000000000..d24dea92e
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotProtocolTypeEnum.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.iot.enums.product;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 接入网关协议枚举类
+ *
+ * @author ahh
+ */
+@AllArgsConstructor
+@Getter
+public enum IotProtocolTypeEnum implements ArrayValuable {
+
+ CUSTOM(0, "自定义"),
+ MODBUS(1, "Modbus"),
+ OPC_UA(2, "OPC UA"),
+ ZIGBEE(3, "ZigBee"),
+ BLE(4, "BLE");
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotProtocolTypeEnum::getType).toArray(Integer[]::new);
+
+ /**
+ * 类型
+ */
+ private final Integer type;
+ /**
+ * 描述
+ */
+ private final String description;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotValidateTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotValidateTypeEnum.java
new file mode 100644
index 000000000..2a15d16a4
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/product/IotValidateTypeEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.iot.enums.product;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 数据校验级别枚举类
+ *
+ * @author ahh
+ */
+@AllArgsConstructor
+@Getter
+public enum IotValidateTypeEnum implements ArrayValuable {
+
+ WEAK(0, "弱校验"),
+ NONE(1, "免校验");
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotValidateTypeEnum::getType).toArray(Integer[]::new);
+
+ /**
+ * 类型
+ */
+ private final Integer type;
+ /**
+ * 描述
+ */
+ private final String description;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotAlertConfigReceiveTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotAlertConfigReceiveTypeEnum.java
new file mode 100644
index 000000000..3fdd53234
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotAlertConfigReceiveTypeEnum.java
@@ -0,0 +1,31 @@
+package cn.iocoder.yudao.module.iot.enums.rule;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT 告警配置的接收方式枚举
+ *
+ * @author 芋道源码
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotAlertConfigReceiveTypeEnum implements ArrayValuable {
+
+ SMS(1), // 短信
+ MAIL(2), // 邮箱
+ NOTIFY(3); // 通知
+
+ private final Integer type;
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotAlertConfigReceiveTypeEnum::getType).toArray(Integer[]::new);
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotDataBridgeDirectionEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotDataBridgeDirectionEnum.java
new file mode 100644
index 000000000..a9d445fd2
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotDataBridgeDirectionEnum.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.iot.enums.rule;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT 数据桥接的方向枚举
+ *
+ * @author 芋道源码
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotDataBridgeDirectionEnum implements ArrayValuable {
+
+ INPUT(1), // 输入
+ OUTPUT(2); // 输出
+
+ private final Integer type;
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotDataBridgeDirectionEnum::getType).toArray(Integer[]::new);
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotDataBridgeTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotDataBridgeTypeEnum.java
new file mode 100644
index 000000000..78fc8452e
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotDataBridgeTypeEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.iot.enums.rule;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT 数据桥接的类型枚举
+ *
+ * @author 芋道源码
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotDataBridgeTypeEnum implements ArrayValuable {
+
+ HTTP(1, "HTTP"),
+ TCP(2, "TCP"),
+ WEBSOCKET(3, "WEBSOCKET"),
+
+ MQTT(10, "MQTT"),
+
+ DATABASE(20, "DATABASE"),
+ REDIS_STREAM(21, "REDIS_STREAM"),
+
+ ROCKETMQ(30, "ROCKETMQ"),
+ RABBITMQ(31, "RABBITMQ"),
+ KAFKA(32, "KAFKA");
+
+ private final Integer type;
+
+ private final String name;
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotDataBridgeTypeEnum::getType).toArray(Integer[]::new);
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotRuleSceneActionTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotRuleSceneActionTypeEnum.java
new file mode 100644
index 000000000..2bdf7d0ed
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotRuleSceneActionTypeEnum.java
@@ -0,0 +1,31 @@
+package cn.iocoder.yudao.module.iot.enums.rule;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT 规则场景的触发类型枚举
+ *
+ * 设备触发，定时触发
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotRuleSceneActionTypeEnum implements ArrayValuable {
+
+ DEVICE_CONTROL(1), // 设备执行
+ ALERT(2), // 告警执行
+ DATA_BRIDGE(3); // 桥接执行
+
+ private final Integer type;
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotRuleSceneActionTypeEnum::getType).toArray(Integer[]::new);
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotRuleSceneTriggerConditionParameterOperatorEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotRuleSceneTriggerConditionParameterOperatorEnum.java
new file mode 100644
index 000000000..5ed90ccae
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotRuleSceneTriggerConditionParameterOperatorEnum.java
@@ -0,0 +1,64 @@
+package cn.iocoder.yudao.module.iot.enums.rule;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT 场景触发条件参数的操作符枚举
+ *
+ * @author 芋道源码
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotRuleSceneTriggerConditionParameterOperatorEnum implements ArrayValuable {
+
+ EQUALS("=", "#source == #value"),
+ NOT_EQUALS("!=", "!(#source == #value)"),
+
+ GREATER_THAN(">", "#source > #value"),
+ GREATER_THAN_OR_EQUALS(">=", "#source >= #value"),
+
+ LESS_THAN("<", "#source < #value"),
+ LESS_THAN_OR_EQUALS("<=", "#source <= #value"),
+
+ IN("in", "#values.contains(#source)"),
+ NOT_IN("not in", "!(#values.contains(#source))"),
+
+ BETWEEN("between", "(#source >= #values.get(0)) && (#source <= #values.get(1))"),
+ NOT_BETWEEN("not between", "(#source < #values.get(0)) || (#source > #values.get(1))"),
+
+ LIKE("like", "#source.contains(#value)"), // 字符串匹配
+ NOT_NULL("not null", "#source != null && #source.length() > 0"); // 非空
+
+ private final String operator;
+ private final String springExpression;
+
+ public static final String[] ARRAYS = Arrays.stream(values()).map(IotRuleSceneTriggerConditionParameterOperatorEnum::getOperator).toArray(String[]::new);
+
+ /**
+ * Spring 表达式 - 原始值
+ */
+ public static final String SPRING_EXPRESSION_SOURCE = "source";
+ /**
+ * Spring 表达式 - 目标值
+ */
+ public static final String SPRING_EXPRESSION_VALUE = "value";
+ /**
+ * Spring 表达式 - 目标值数组
+ */
+ public static final String SPRING_EXPRESSION_VALUE_List = "values";
+
+ public static IotRuleSceneTriggerConditionParameterOperatorEnum operatorOf(String operator) {
+ return ArrayUtil.firstMatch(item -> item.getOperator().equals(operator), values());
+ }
+
+ @Override
+ public String[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotRuleSceneTriggerTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotRuleSceneTriggerTypeEnum.java
new file mode 100644
index 000000000..a420a21d5
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/rule/IotRuleSceneTriggerTypeEnum.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.iot.enums.rule;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * IoT 场景流转的触发类型枚举
+ *
+ * @author 芋道源码
+ */
+@RequiredArgsConstructor
+@Getter
+public enum IotRuleSceneTriggerTypeEnum implements ArrayValuable {
+
+ DEVICE(1), // 设备触发
+ TIMER(2); // 定时触发
+
+ private final Integer type;
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotRuleSceneTriggerTypeEnum::getType).toArray(Integer[]::new);
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotDataSpecsDataTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotDataSpecsDataTypeEnum.java
new file mode 100644
index 000000000..5524fdeb4
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotDataSpecsDataTypeEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.iot.enums.thingmodel;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 数据定义的数据类型枚举类
+ *
+ * @author 芋道源码
+ */
+@AllArgsConstructor
+@Getter
+public enum IotDataSpecsDataTypeEnum implements ArrayValuable {
+
+ INT("int"),
+ FLOAT("float"),
+ DOUBLE("double"),
+ ENUM("enum"),
+ BOOL("bool"),
+ TEXT("text"),
+ DATE("date"),
+ STRUCT("struct"),
+ ARRAY("array");
+
+ public static final String[] ARRAYS = Arrays.stream(values()).map(IotDataSpecsDataTypeEnum::getDataType).toArray(String[]::new);
+
+ private final String dataType;
+
+ @Override
+ public String[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelAccessModeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelAccessModeEnum.java
new file mode 100644
index 000000000..c0a2b329b
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelAccessModeEnum.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.iot.enums.thingmodel;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 产品物模型属性读取类型枚举
+ *
+ * @author ahh
+ */
+@AllArgsConstructor
+@Getter
+public enum IotThingModelAccessModeEnum implements ArrayValuable {
+
+ READ_ONLY("r"),
+ READ_WRITE("rw");
+
+ public static final String[] ARRAYS = Arrays.stream(values()).map(IotThingModelAccessModeEnum::getMode).toArray(String[]::new);
+
+ private final String mode;
+
+ @Override
+ public String[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelParamDirectionEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelParamDirectionEnum.java
new file mode 100644
index 000000000..4f06cefce
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelParamDirectionEnum.java
@@ -0,0 +1,31 @@
+package cn.iocoder.yudao.module.iot.enums.thingmodel;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+
+/**
+ * IoT 产品物模型参数是输入参数还是输出参数枚举
+ *
+ * @author HUIHUI
+ */
+@AllArgsConstructor
+@Getter
+public enum IotThingModelParamDirectionEnum implements ArrayValuable {
+
+ INPUT("input"), // 输入参数
+ OUTPUT("output"); // 输出参数
+
+ public static final String[] ARRAYS = Arrays.stream(values()).map(IotThingModelParamDirectionEnum::getDirection).toArray(String[]::new);
+
+ private final String direction;
+
+ @Override
+ public String[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelServiceCallTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelServiceCallTypeEnum.java
new file mode 100644
index 000000000..376db6b4a
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelServiceCallTypeEnum.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.iot.enums.thingmodel;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 产品物模型服务调用方式枚举
+ *
+ * @author HUIHUI
+ */
+@AllArgsConstructor
+@Getter
+public enum IotThingModelServiceCallTypeEnum implements ArrayValuable {
+
+ ASYNC("async"), // 异步调用
+ SYNC("sync"); // 同步调用
+
+ public static final String[] ARRAYS = Arrays.stream(values()).map(IotThingModelServiceCallTypeEnum::getType).toArray(String[]::new);
+
+ private final String type;
+
+ @Override
+ public String[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelServiceEventTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelServiceEventTypeEnum.java
new file mode 100644
index 000000000..c7c74092a
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelServiceEventTypeEnum.java
@@ -0,0 +1,31 @@
+package cn.iocoder.yudao.module.iot.enums.thingmodel;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 产品物模型事件类型枚举
+ *
+ * @author HUIHUI
+ */
+@AllArgsConstructor
+@Getter
+public enum IotThingModelServiceEventTypeEnum implements ArrayValuable {
+
+ INFO("info"), // 信息
+ ALERT("alert"), // 告警
+ ERROR("error"); // 故障
+
+ public static final String[] ARRAYS = Arrays.stream(values()).map(IotThingModelServiceEventTypeEnum::getType).toArray(String[]::new);
+
+ private final String type;
+
+ @Override
+ public String[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelTypeEnum.java b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelTypeEnum.java
new file mode 100644
index 000000000..e0097cfe9
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-api/src/main/java/cn/iocoder/yudao/module/iot/enums/thingmodel/IotThingModelTypeEnum.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.iot.enums.thingmodel;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * IoT 产品功能（物模型）类型枚举类
+ *
+ * @author ahh
+ */
+@AllArgsConstructor
+@Getter
+public enum IotThingModelTypeEnum implements ArrayValuable {
+
+ PROPERTY(1, "属性"),
+ SERVICE(2, "服务"),
+ EVENT(3, "事件");
+
+ public static final Integer[] ARRAYS = Arrays.stream(values()).map(IotThingModelTypeEnum::getType).toArray(Integer[]::new);
+
+ /**
+ * 类型
+ */
+ private final Integer type;
+ /**
+ * 描述
+ */
+ private final String description;
+
+ @Override
+ public Integer[] array() {
+ return ARRAYS;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/pom.xml b/yudao-module-iot/yudao-module-iot-biz/pom.xml
new file mode 100644
index 000000000..6b4d09fd9
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/pom.xml
@@ -0,0 +1,145 @@
+
+
+
+ yudao-module-iot
+ cn.iocoder.cloud
+ ${revision}
+
+ 4.0.0
+ jar
+
+ yudao-module-iot-biz
+
+ ${project.artifactId}
+
+ 物联网 模块，主要实现 产品管理、设备管理、协议管理等功能。
+
+
+
+
+
+ cn.iocoder.cloud
+ yudao-module-iot-api
+ ${revision}
+
+
+
+ cn.iocoder.cloud
+ yudao-spring-boot-starter-biz-tenant
+
+
+
+
+ cn.iocoder.cloud
+ yudao-spring-boot-starter-web
+
+
+
+ cn.iocoder.cloud
+ yudao-spring-boot-starter-security
+
+
+
+
+ com.taosdata.jdbc
+ taos-jdbcdriver
+
+
+
+ cn.iocoder.cloud
+ yudao-spring-boot-starter-mybatis
+
+
+
+ cn.iocoder.cloud
+ yudao-spring-boot-starter-redis
+
+
+
+
+ cn.iocoder.cloud
+ yudao-spring-boot-starter-job
+
+
+
+
+ org.quartz-scheduler
+ quartz
+ 2.3.2
+
+
+
+
+ cn.iocoder.cloud
+ yudao-spring-boot-starter-test
+
+
+
+
+ cn.iocoder.cloud
+ yudao-spring-boot-starter-excel
+
+
+
+
+ org.apache.rocketmq
+ rocketmq-spring-boot-starter
+ true
+
+
+ org.springframework.kafka
+ spring-kafka
+ true
+
+
+ org.springframework.boot
+ spring-boot-starter-amqp
+ true
+
+
+
+ org.pf4j
+ pf4j-spring
+
+
+
+
+ org.apache.groovy
+ groovy-all
+ 4.0.25
+ pom
+
+
+
+
+ org.graalvm.js
+ js
+ 24.1.2
+ pom
+
+
+ org.graalvm.js
+ js-scriptengine
+ 24.1.2
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/IoTServerApplication.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/IoTServerApplication.java
new file mode 100644
index 000000000..237de169d
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/IoTServerApplication.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.iot;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * 项目的启动类
+ *
+ * 如果你碰到启动的问题，请认真阅读 https://cloud.iocoder.cn/quick-start/ 文章
+ * 如果你碰到启动的问题，请认真阅读 https://cloud.iocoder.cn/quick-start/ 文章
+ * 如果你碰到启动的问题，请认真阅读 https://cloud.iocoder.cn/quick-start/ 文章
+ *
+ * @author 芋道源码
+ */
+@SpringBootApplication
+public class IoTServerApplication {
+
+ public static void main(String[] args) {
+ // 如果你碰到启动的问题，请认真阅读 https://cloud.iocoder.cn/quick-start/ 文章
+ // 如果你碰到启动的问题，请认真阅读 https://cloud.iocoder.cn/quick-start/ 文章
+ // 如果你碰到启动的问题，请认真阅读 https://cloud.iocoder.cn/quick-start/ 文章
+
+ SpringApplication.run(IoTServerApplication.class, args);
+
+ // 如果你碰到启动的问题，请认真阅读 https://cloud.iocoder.cn/quick-start/ 文章
+ // 如果你碰到启动的问题，请认真阅读 https://cloud.iocoder.cn/quick-start/ 文章
+ // 如果你碰到启动的问题，请认真阅读 https://cloud.iocoder.cn/quick-start/ 文章
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/ScriptTest.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/ScriptTest.java
new file mode 100644
index 000000000..9f54d60e8
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/ScriptTest.java
@@ -0,0 +1,61 @@
+package cn.iocoder.yudao.module.iot;
+
+import cn.hutool.script.ScriptUtil;
+import javax.script.Bindings;
+import javax.script.ScriptEngine;
+import javax.script.ScriptException;
+
+/**
+ * TODO 芋艿：测试脚本的接入
+ */
+public class ScriptTest {
+
+ public static void main2(String[] args) {
+ // 创建一个 Groovy 脚本引擎
+ ScriptEngine engine = ScriptUtil.createGroovyEngine();
+
+ // 创建绑定参数
+ Bindings bindings = engine.createBindings();
+ bindings.put("name", "Alice");
+ bindings.put("age", 30);
+
+ // 定义一个稍微复杂的 Groovy 脚本
+ String script = "def greeting = 'Hello, ' + name + '!';\n" +
+ "def ageInFiveYears = age + 5;\n" +
+ "def message = greeting + ' In five years, you will be ' + ageInFiveYears + ' years old.';\n" +
+ "return message.toUpperCase();\n";
+
+ try {
+ // 执行脚本并获取结果
+ Object result = engine.eval(script, bindings);
+ System.out.println(result); // 输出: HELLO, ALICE! IN FIVE YEARS, YOU WILL BE 35 YEARS OLD.
+ } catch (ScriptException e) {
+ e.printStackTrace();
+ }
+ }
+
+ public static void main(String[] args) {
+ // 创建一个 JavaScript 脚本引擎
+ ScriptEngine jsEngine = ScriptUtil.createJsEngine();
+
+ // 创建绑定参数
+ Bindings jsBindings = jsEngine.createBindings();
+ jsBindings.put("name", "Bob");
+ jsBindings.put("age", 25);
+
+ // 定义一个简单的 JavaScript 脚本
+ String jsScript = "var greeting = 'Hello, ' + name + '!';\n" +
+ "var ageInTenYears = age + 10;\n" +
+ "var message = greeting + ' In ten years, you will be ' + ageInTenYears + ' years old.';\n" +
+ "message.toUpperCase();\n";
+
+ try {
+ // 执行脚本并获取结果
+ Object jsResult = jsEngine.eval(jsScript, jsBindings);
+ System.out.println(jsResult); // 输出: HELLO, BOB! IN TEN YEARS, YOU WILL BE 35 YEARS OLD.
+ } catch (ScriptException e) {
+ e.printStackTrace();
+ }
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/api/device/IoTDeviceUpstreamApiImpl.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/api/device/IoTDeviceUpstreamApiImpl.java
new file mode 100644
index 000000000..25faa1a6b
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/api/device/IoTDeviceUpstreamApiImpl.java
@@ -0,0 +1,77 @@
+package cn.iocoder.yudao.module.iot.api.device;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.iot.api.device.dto.control.upstream.*;
+import cn.iocoder.yudao.module.iot.service.device.control.IotDeviceUpstreamService;
+import cn.iocoder.yudao.module.iot.service.plugin.IotPluginInstanceService;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+/**
+ * * 设备数据 Upstream 上行 API 实现类
+ */
+@RestController
+@Validated
+public class IoTDeviceUpstreamApiImpl implements IotDeviceUpstreamApi {
+
+ @Resource
+ private IotDeviceUpstreamService deviceUpstreamService;
+ @Resource
+ private IotPluginInstanceService pluginInstanceService;
+
+ // ========== 设备相关 ==========
+
+ @Override
+ public CommonResult updateDeviceState(IotDeviceStateUpdateReqDTO updateReqDTO) {
+ deviceUpstreamService.updateDeviceState(updateReqDTO);
+ return success(true);
+ }
+
+ @Override
+ public CommonResult reportDeviceProperty(IotDevicePropertyReportReqDTO reportReqDTO) {
+ deviceUpstreamService.reportDeviceProperty(reportReqDTO);
+ return success(true);
+ }
+
+ @Override
+ public CommonResult reportDeviceEvent(IotDeviceEventReportReqDTO reportReqDTO) {
+ deviceUpstreamService.reportDeviceEvent(reportReqDTO);
+ return success(true);
+ }
+
+ @Override
+ public CommonResult registerDevice(IotDeviceRegisterReqDTO registerReqDTO) {
+ deviceUpstreamService.registerDevice(registerReqDTO);
+ return success(true);
+ }
+
+ @Override
+ public CommonResult registerSubDevice(IotDeviceRegisterSubReqDTO registerReqDTO) {
+ deviceUpstreamService.registerSubDevice(registerReqDTO);
+ return success(true);
+ }
+
+ @Override
+ public CommonResult addDeviceTopology(IotDeviceTopologyAddReqDTO addReqDTO) {
+ deviceUpstreamService.addDeviceTopology(addReqDTO);
+ return success(true);
+ }
+
+ @Override
+ public CommonResult authenticateEmqxConnection(IotDeviceEmqxAuthReqDTO authReqDTO) {
+ boolean result = deviceUpstreamService.authenticateEmqxConnection(authReqDTO);
+ return success(result);
+ }
+
+ // ========== 插件相关 ==========
+
+ @Override
+ public CommonResult heartbeatPluginInstance(IotPluginInstanceHeartbeatReqDTO heartbeatReqDTO) {
+ pluginInstanceService.heartbeatPluginInstance(heartbeatReqDTO);
+ return success(true);
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/api/package-info.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/api/package-info.java
new file mode 100644
index 000000000..07852180d
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/api/package-info.java
@@ -0,0 +1,6 @@
+/**
+ * 占位
+ *
+ * TODO 芋艿：后续删除
+ */
+package cn.iocoder.yudao.module.iot.api;
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceController.http b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceController.http
new file mode 100644
index 000000000..c1190cec1
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceController.http
@@ -0,0 +1,75 @@
+### 请求 /iot/device/downstream 接口（服务调用） => 成功
+POST {{baseUrl}}/iot/device/downstream
+Content-Type: application/json
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+{
+ "id": 25,
+ "type": "service",
+ "identifier": "temperature",
+ "data": {
+ "xx": "yy"
+ }
+}
+
+### 请求 /iot/device/downstream 接口（属性设置） => 成功
+POST {{baseUrl}}/iot/device/downstream
+Content-Type: application/json
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+{
+ "id": 25,
+ "type": "property",
+ "identifier": "set",
+ "data": {
+ "xx": "yy"
+ }
+}
+
+### 请求 /iot/device/downstream 接口（属性获取） => 成功
+POST {{baseUrl}}/iot/device/downstream
+Content-Type: application/json
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+{
+ "id": 25,
+ "type": "property",
+ "identifier": "get",
+ "data": ["xx", "yy"]
+}
+
+### 请求 /iot/device/downstream 接口（配置设置） => 成功
+POST {{baseUrl}}/iot/device/downstream
+Content-Type: application/json
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+{
+ "id": 25,
+ "type": "config",
+ "identifier": "set"
+}
+
+### 请求 /iot/device/downstream 接口（OTA 升级） => 成功
+POST {{baseUrl}}/iot/device/downstream
+Content-Type: application/json
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+{
+ "id": 25,
+ "type": "ota",
+ "identifier": "upgrade",
+ "data": {
+ "firmwareId": 1,
+ "version": "1.0.0",
+ "signMethod": "MD5",
+ "fileSign": "d41d8cd98f00b204e9800998ecf8427e",
+ "fileSize": 1024,
+ "fileUrl": "http://example.com/firmware.bin",
+ "information": "{\"desc\":\"升级到最新版本\"}"
+ }
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceController.java
new file mode 100644
index 000000000..08fc244b1
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceController.java
@@ -0,0 +1,188 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.control.IotDeviceDownstreamReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.control.IotDeviceUpstreamReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.device.*;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO;
+import cn.iocoder.yudao.module.iot.service.device.IotDeviceService;
+import cn.iocoder.yudao.module.iot.service.device.control.IotDeviceDownstreamService;
+import cn.iocoder.yudao.module.iot.service.device.control.IotDeviceUpstreamService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - IoT 设备")
+@RestController
+@RequestMapping("/iot/device")
+@Validated
+public class IotDeviceController {
+
+ @Resource
+ private IotDeviceService deviceService;
+ @Resource
+ private IotDeviceUpstreamService deviceUpstreamService;
+ @Resource
+ private IotDeviceDownstreamService deviceDownstreamService;
+
+ @PostMapping("/create")
+ @Operation(summary = "创建设备")
+ @PreAuthorize("@ss.hasPermission('iot:device:create')")
+ public CommonResult createDevice(@Valid @RequestBody IotDeviceSaveReqVO createReqVO) {
+ return success(deviceService.createDevice(createReqVO));
+ }
+
+ @PutMapping("/update")
+ @Operation(summary = "更新设备")
+ @PreAuthorize("@ss.hasPermission('iot:device:update')")
+ public CommonResult updateDevice(@Valid @RequestBody IotDeviceSaveReqVO updateReqVO) {
+ deviceService.updateDevice(updateReqVO);
+ return success(true);
+ }
+
+ // TODO @芋艿：参考阿里云：1）绑定网关；2）解绑网关
+
+ @PutMapping("/update-group")
+ @Operation(summary = "更新设备分组")
+ @PreAuthorize("@ss.hasPermission('iot:device:update')")
+ public CommonResult updateDeviceGroup(@Valid @RequestBody IotDeviceUpdateGroupReqVO updateReqVO) {
+ deviceService.updateDeviceGroup(updateReqVO);
+ return success(true);
+ }
+
+ @DeleteMapping("/delete")
+ @Operation(summary = "删除单个设备")
+ @Parameter(name = "id", description = "编号", required = true)
+ @PreAuthorize("@ss.hasPermission('iot:device:delete')")
+ public CommonResult deleteDevice(@RequestParam("id") Long id) {
+ deviceService.deleteDevice(id);
+ return success(true);
+ }
+
+ @DeleteMapping("/delete-list")
+ @Operation(summary = "删除多个设备")
+ @Parameter(name = "ids", description = "编号数组", required = true)
+ @PreAuthorize("@ss.hasPermission('iot:device:delete')")
+ public CommonResult deleteDeviceList(@RequestParam("ids") Collection ids) {
+ deviceService.deleteDeviceList(ids);
+ return success(true);
+ }
+
+ @GetMapping("/get")
+ @Operation(summary = "获得设备")
+ @Parameter(name = "id", description = "编号", required = true, example = "1024")
+ @PreAuthorize("@ss.hasPermission('iot:device:query')")
+ public CommonResult getDevice(@RequestParam("id") Long id) {
+ IotDeviceDO device = deviceService.getDevice(id);
+ return success(BeanUtils.toBean(device, IotDeviceRespVO.class));
+ }
+
+ @GetMapping("/page")
+ @Operation(summary = "获得设备分页")
+ @PreAuthorize("@ss.hasPermission('iot:device:query')")
+ public CommonResult> getDevicePage(@Valid IotDevicePageReqVO pageReqVO) {
+ PageResult pageResult = deviceService.getDevicePage(pageReqVO);
+ return success(BeanUtils.toBean(pageResult, IotDeviceRespVO.class));
+ }
+
+ @GetMapping("/export-excel")
+ @Operation(summary = "导出设备 Excel")
+ @PreAuthorize("@ss.hasPermission('iot:device:export')")
+ @ApiAccessLog(operateType = EXPORT)
+ public void exportDeviceExcel(@Valid IotDevicePageReqVO exportReqVO,
+ HttpServletResponse response) throws IOException {
+ exportReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+ CommonResult> result = getDevicePage(exportReqVO);
+ // 导出 Excel
+ ExcelUtils.write(response, "设备.xls", "数据", IotDeviceRespVO.class,
+ result.getData().getList());
+ }
+
+ @GetMapping("/count")
+ @Operation(summary = "获得设备数量")
+ @Parameter(name = "productId", description = "产品编号", example = "1")
+ @PreAuthorize("@ss.hasPermission('iot:device:query')")
+ public CommonResult getDeviceCount(@RequestParam("productId") Long productId) {
+ return success(deviceService.getDeviceCountByProductId(productId));
+ }
+
+ @GetMapping("/simple-list")
+ @Operation(summary = "获取设备的精简信息列表", description = "主要用于前端的下拉选项")
+ @Parameter(name = "deviceType", description = "设备类型", example = "1")
+ public CommonResult> getSimpleDeviceList(
+ @RequestParam(value = "deviceType", required = false) Integer deviceType) {
+ List list = deviceService.getDeviceListByDeviceType(deviceType);
+ return success(convertList(list, device -> // 只返回 id、name 字段
+ new IotDeviceRespVO().setId(device.getId()).setDeviceName(device.getDeviceName())));
+ }
+
+ @PostMapping("/import")
+ @Operation(summary = "导入设备")
+ @PreAuthorize("@ss.hasPermission('iot:device:import')")
+ public CommonResult importDevice(
+ @RequestParam("file") MultipartFile file,
+ @RequestParam(value = "updateSupport", required = false, defaultValue = "false") Boolean updateSupport)
+ throws Exception {
+ List list = ExcelUtils.read(file, IotDeviceImportExcelVO.class);
+ return success(deviceService.importDevice(list, updateSupport));
+ }
+
+ @GetMapping("/get-import-template")
+ @Operation(summary = "获得导入设备模板")
+ public void importTemplate(HttpServletResponse response) throws IOException {
+ // 手动创建导出 demo
+ List list = Arrays.asList(
+ IotDeviceImportExcelVO.builder().deviceName("温度传感器001").parentDeviceName("gateway110")
+ .productKey("1de24640dfe").groupNames("灰度分组,生产分组").build(),
+ IotDeviceImportExcelVO.builder().deviceName("biubiu")
+ .productKey("YzvHxd4r67sT4s2B").groupNames("").build());
+ // 输出
+ ExcelUtils.write(response, "设备导入模板.xls", "数据", IotDeviceImportExcelVO.class, list);
+ }
+
+ @PostMapping("/upstream")
+ @Operation(summary = "设备上行", description = "可用于设备模拟")
+ @PreAuthorize("@ss.hasPermission('iot:device:upstream')")
+ public CommonResult upstreamDevice(@Valid @RequestBody IotDeviceUpstreamReqVO upstreamReqVO) {
+ deviceUpstreamService.upstreamDevice(upstreamReqVO);
+ return success(true);
+ }
+
+ @PostMapping("/downstream")
+ @Operation(summary = "设备下行", description = "可用于设备模拟")
+ @PreAuthorize("@ss.hasPermission('iot:device:downstream')")
+ public CommonResult downstreamDevice(@Valid @RequestBody IotDeviceDownstreamReqVO downstreamReqVO) {
+ deviceDownstreamService.downstreamDevice(downstreamReqVO);
+ return success(true);
+ }
+
+ // TODO @haohao：是不是默认详情接口，不返回 secret，然后这个接口，用于统一返回。然后接口名可以更通用一点。
+ @GetMapping("/mqtt-connection-params")
+ @Operation(summary = "获取 MQTT 连接参数")
+ @PreAuthorize("@ss.hasPermission('iot:device:mqtt-connection-params')")
+ public CommonResult getMqttConnectionParams(@RequestParam("deviceId") Long deviceId) {
+ return success(deviceService.getMqttConnectionParams(deviceId));
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceGroupController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceGroupController.java
new file mode 100644
index 000000000..d19cf7fc9
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceGroupController.java
@@ -0,0 +1,88 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.group.IotDeviceGroupPageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.group.IotDeviceGroupRespVO;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.group.IotDeviceGroupSaveReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceGroupDO;
+import cn.iocoder.yudao.module.iot.service.device.IotDeviceGroupService;
+import cn.iocoder.yudao.module.iot.service.device.IotDeviceService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - IoT 设备分组")
+@RestController
+@RequestMapping("/iot/device-group")
+@Validated
+public class IotDeviceGroupController {
+
+ @Resource
+ private IotDeviceGroupService deviceGroupService;
+ @Resource
+ private IotDeviceService deviceService;
+
+ @PostMapping("/create")
+ @Operation(summary = "创建设备分组")
+ @PreAuthorize("@ss.hasPermission('iot:device-group:create')")
+ public CommonResult createDeviceGroup(@Valid @RequestBody IotDeviceGroupSaveReqVO createReqVO) {
+ return success(deviceGroupService.createDeviceGroup(createReqVO));
+ }
+
+ @PutMapping("/update")
+ @Operation(summary = "更新设备分组")
+ @PreAuthorize("@ss.hasPermission('iot:device-group:update')")
+ public CommonResult updateDeviceGroup(@Valid @RequestBody IotDeviceGroupSaveReqVO updateReqVO) {
+ deviceGroupService.updateDeviceGroup(updateReqVO);
+ return success(true);
+ }
+
+ @DeleteMapping("/delete")
+ @Operation(summary = "删除设备分组")
+ @Parameter(name = "id", description = "编号", required = true)
+ @PreAuthorize("@ss.hasPermission('iot:device-group:delete')")
+ public CommonResult deleteDeviceGroup(@RequestParam("id") Long id) {
+ deviceGroupService.deleteDeviceGroup(id);
+ return success(true);
+ }
+
+ @GetMapping("/get")
+ @Operation(summary = "获得设备分组")
+ @Parameter(name = "id", description = "编号", required = true, example = "1024")
+ @PreAuthorize("@ss.hasPermission('iot:device-group:query')")
+ public CommonResult getDeviceGroup(@RequestParam("id") Long id) {
+ IotDeviceGroupDO deviceGroup = deviceGroupService.getDeviceGroup(id);
+ return success(BeanUtils.toBean(deviceGroup, IotDeviceGroupRespVO.class));
+ }
+
+ @GetMapping("/page")
+ @Operation(summary = "获得设备分组分页")
+ @PreAuthorize("@ss.hasPermission('iot:device-group:query')")
+ public CommonResult> getDeviceGroupPage(@Valid IotDeviceGroupPageReqVO pageReqVO) {
+ PageResult pageResult = deviceGroupService.getDeviceGroupPage(pageReqVO);
+ return success(BeanUtils.toBean(pageResult, IotDeviceGroupRespVO.class,
+ group -> group.setDeviceCount(deviceService.getDeviceCountByGroupId(group.getId()))));
+ }
+
+ @GetMapping("/simple-list")
+ @Operation(summary = "获取设备分组的精简信息列表", description = "只包含被开启的分组，主要用于前端的下拉选项")
+ public CommonResult> getSimpleDeviceGroupList() {
+ List list = deviceGroupService.getDeviceGroupListByStatus(CommonStatusEnum.ENABLE.getStatus());
+ return success(convertList(list, group -> // 只返回 id、name 字段
+ new IotDeviceGroupRespVO().setId(group.getId()).setName(group.getName())));
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceLogController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceLogController.java
new file mode 100644
index 000000000..81d1bff94
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDeviceLogController.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.data.IotDeviceLogPageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.data.IotDeviceLogRespVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceLogDO;
+import cn.iocoder.yudao.module.iot.service.device.data.IotDeviceLogService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - IoT 设备日志")
+@RestController
+@RequestMapping("/iot/device/log")
+@Validated
+public class IotDeviceLogController {
+
+ @Resource
+ private IotDeviceLogService deviceLogService;
+
+ @GetMapping("/page")
+ @Operation(summary = "获得设备日志分页")
+ @PreAuthorize("@ss.hasPermission('iot:device:log-query')")
+ public CommonResult> getDeviceLogPage(@Valid IotDeviceLogPageReqVO pageReqVO) {
+ PageResult pageResult = deviceLogService.getDeviceLogPage(pageReqVO);
+ return success(BeanUtils.toBean(pageResult, IotDeviceLogRespVO.class));
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDevicePropertyController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDevicePropertyController.java
new file mode 100644
index 000000000..47bf325dd
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/IotDevicePropertyController.java
@@ -0,0 +1,95 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.date.LocalDateTimeUtil;
+import cn.hutool.core.lang.Assert;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.data.IotDevicePropertyHistoryPageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.data.IotDevicePropertyRespVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDevicePropertyDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.thingmodel.IotThingModelDO;
+import cn.iocoder.yudao.module.iot.service.device.IotDeviceService;
+import cn.iocoder.yudao.module.iot.service.device.data.IotDevicePropertyService;
+import cn.iocoder.yudao.module.iot.service.thingmodel.IotThingModelService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - IoT 设备属性")
+@RestController
+@RequestMapping("/iot/device/property")
+@Validated
+public class IotDevicePropertyController {
+
+ @Resource
+ private IotDevicePropertyService devicePropertyService;
+ @Resource
+ private IotThingModelService thingModelService;
+ @Resource
+ private IotDeviceService deviceService;
+
+ @GetMapping("/latest")
+ @Operation(summary = "获取设备属性最新属性")
+ @Parameters({
+ @Parameter(name = "deviceId", description = "设备编号", required = true),
+ @Parameter(name = "identifier", description = "标识符"),
+ @Parameter(name = "name", description = "名称")
+ })
+ @PreAuthorize("@ss.hasPermission('iot:device:property-query')")
+ public CommonResult> getLatestDeviceProperties(
+ @RequestParam("deviceId") Long deviceId,
+ @RequestParam(value = "identifier", required = false) String identifier,
+ @RequestParam(value = "name", required = false) String name) {
+ Map properties = devicePropertyService.getLatestDeviceProperties(deviceId);
+
+ // 拼接数据
+ IotDeviceDO device = deviceService.getDevice(deviceId);
+ Assert.notNull(device, "设备不存在");
+ List thingModels = thingModelService.getThingModelListByProductId(device.getProductId());
+ return success(convertList(properties.entrySet(), entry -> {
+ IotThingModelDO thingModel = CollUtil.findOne(thingModels,
+ item -> item.getIdentifier().equals(entry.getKey()));
+ if (thingModel == null || thingModel.getProperty() == null) {
+ return null;
+ }
+ if (StrUtil.isNotEmpty(identifier) && !StrUtil.contains(thingModel.getIdentifier(), identifier)) {
+ return null;
+ }
+ if (StrUtil.isNotEmpty(name) && !StrUtil.contains(thingModel.getName(), name)) {
+ return null;
+ }
+ // 构建对象
+ IotDevicePropertyDO property = entry.getValue();
+ return new IotDevicePropertyRespVO().setProperty(thingModel.getProperty())
+ .setValue(property.getValue()).setUpdateTime(LocalDateTimeUtil.toEpochMilli(property.getUpdateTime()));
+ }));
+ }
+
+ @GetMapping("/history-page")
+ @Operation(summary = "获取设备属性历史数据")
+ @PreAuthorize("@ss.hasPermission('iot:device:property-query')")
+ public CommonResult> getHistoryDevicePropertyPage(
+ @Valid IotDevicePropertyHistoryPageReqVO pageReqVO) {
+ Assert.notEmpty(pageReqVO.getIdentifier(), "标识符不能为空");
+ return success(devicePropertyService.getHistoryDevicePropertyPage(pageReqVO));
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/control/IotDeviceDownstreamReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/control/IotDeviceDownstreamReqVO.java
new file mode 100644
index 000000000..eefaeffeb
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/control/IotDeviceDownstreamReqVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.control;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.device.IotDeviceMessageTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 设备下行 Request VO") // 服务调用、属性设置、属性获取等
+@Data
+public class IotDeviceDownstreamReqVO {
+
+ @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "177")
+ @NotNull(message = "设备编号不能为空")
+ private Long id;
+
+ @Schema(description = "消息类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "property")
+ @NotEmpty(message = "消息类型不能为空")
+ @InEnum(IotDeviceMessageTypeEnum.class)
+ private String type;
+
+ @Schema(description = "标识符", requiredMode = Schema.RequiredMode.REQUIRED, example = "report")
+ @NotEmpty(message = "标识符不能为空")
+ private String identifier; // 参见 IotDeviceMessageIdentifierEnum 枚举类
+
+ @Schema(description = "请求参数", requiredMode = Schema.RequiredMode.REQUIRED)
+ private Object data; // 例如说：服务调用的 params、属性设置的 properties
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/control/IotDeviceUpstreamReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/control/IotDeviceUpstreamReqVO.java
new file mode 100644
index 000000000..778d75bba
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/control/IotDeviceUpstreamReqVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.control;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.device.IotDeviceMessageTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 设备上行 Request VO") // 属性上报、事件上报、状态变更等
+@Data
+public class IotDeviceUpstreamReqVO {
+
+ @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "177")
+ @NotNull(message = "设备编号不能为空")
+ private Long id;
+
+ @Schema(description = "消息类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "property")
+ @NotEmpty(message = "消息类型不能为空")
+ @InEnum(IotDeviceMessageTypeEnum.class)
+ private String type;
+
+ @Schema(description = "标识符", requiredMode = Schema.RequiredMode.REQUIRED, example = "report")
+ @NotEmpty(message = "标识符不能为空")
+ private String identifier; // 参见 IotDeviceMessageIdentifierEnum 枚举类
+
+ @Schema(description = "请求参数", requiredMode = Schema.RequiredMode.REQUIRED)
+ private Object data; // 例如说：属性上报的 properties、事件上报的 params
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDeviceLogPageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDeviceLogPageReqVO.java
new file mode 100644
index 000000000..fcf36994f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDeviceLogPageReqVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.data;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 设备日志分页查询 Request VO")
+@Data
+public class IotDeviceLogPageReqVO extends PageParam {
+
+ @Schema(description = "设备标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "device123")
+ @NotEmpty(message = "设备标识不能为空")
+ private String deviceKey;
+
+ @Schema(description = "消息类型", example = "property")
+ private String type; // 参见 IotDeviceMessageTypeEnum 枚举，精准匹配
+
+ @Schema(description = "标识符", example = "temperature")
+ private String identifier; // 参见 IotDeviceMessageIdentifierEnum 枚举，模糊匹配
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDeviceLogRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDeviceLogRespVO.java
new file mode 100644
index 000000000..6e6639ede
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDeviceLogRespVO.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.data;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - IoT 设备日志 Response VO")
+@Data
+public class IotDeviceLogRespVO {
+
+ @Schema(description = "日志编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+ private String id;
+
+ @Schema(description = "产品标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "product123")
+ private String productKey;
+
+ @Schema(description = "设备标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "device123")
+ private String deviceKey;
+
+ @Schema(description = "消息类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "property")
+ private String type;
+
+ @Schema(description = "标识符", requiredMode = Schema.RequiredMode.REQUIRED, example = "temperature")
+ private String identifier;
+
+ @Schema(description = "日志内容", requiredMode = Schema.RequiredMode.REQUIRED)
+ private String content;
+
+ @Schema(description = "上报时间", requiredMode = Schema.RequiredMode.REQUIRED)
+ private LocalDateTime reportTime;
+
+ @Schema(description = "记录时间戳", requiredMode = Schema.RequiredMode.REQUIRED)
+ private LocalDateTime ts;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDevicePropertyHistoryPageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDevicePropertyHistoryPageReqVO.java
new file mode 100644
index 000000000..0de45e4a7
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDevicePropertyHistoryPageReqVO.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.data;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - IoT 设备属性历史分页 Request VO")
+@Data
+public class IotDevicePropertyHistoryPageReqVO extends PageParam {
+
+ @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "177")
+ @NotNull(message = "设备编号不能为空")
+ private Long deviceId;
+
+ @Schema(description = "设备 Key", hidden = true)
+ private String deviceKey; // 非前端传递，后端自己查询设置
+
+ @Schema(description = "属性标识符", requiredMode = Schema.RequiredMode.REQUIRED)
+ @NotEmpty(message = "属性标识符不能为空")
+ private String identifier;
+
+ @Schema(description = "时间范围", requiredMode = Schema.RequiredMode.NOT_REQUIRED)
+ @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+ @Size(min = 2, max = 2, message = "请选择时间范围")
+ private LocalDateTime[] times;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDevicePropertyRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDevicePropertyRespVO.java
new file mode 100644
index 000000000..dd7a0d6ad
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/data/IotDevicePropertyRespVO.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.data;
+
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 设备属性 Response VO")
+@Data
+public class IotDevicePropertyRespVO {
+
+ @Schema(description = "属性定义", requiredMode = Schema.RequiredMode.REQUIRED)
+ private ThingModelProperty property;
+
+ @Schema(description = "最新值", requiredMode = Schema.RequiredMode.REQUIRED)
+ private Object value;
+
+ @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+ private Long updateTime; // 由于从 TDengine 查询出来的是 Long 类型，所以这里也使用 Long 类型
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceImportExcelVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceImportExcelVO.java
new file mode 100644
index 000000000..710e74263
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceImportExcelVO.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.device;
+
+import com.alibaba.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import lombok.experimental.Accessors;
+
+/**
+ * 设备 Excel 导入 VO
+ */
+@Data
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+@Accessors(chain = false) // 设置 chain = false，避免设备导入有问题
+public class IotDeviceImportExcelVO {
+
+ @ExcelProperty("设备名称")
+ @NotEmpty(message = "设备名称不能为空")
+ private String deviceName;
+
+ @ExcelProperty("父设备名称")
+ @Schema(description = "父设备名称", example = "网关001")
+ private String parentDeviceName;
+
+ @ExcelProperty("产品标识")
+ @NotEmpty(message = "产品标识不能为空")
+ private String productKey;
+
+ @ExcelProperty("设备分组")
+ private String groupNames;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceImportRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceImportRespVO.java
new file mode 100644
index 000000000..bf52b123f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceImportRespVO.java
@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.device;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+@Schema(description = "管理后台 - IoT 设备导入 Response VO")
+@Data
+@Builder
+public class IotDeviceImportRespVO {
+
+ @Schema(description = "创建成功的设备名称数组", requiredMode = Schema.RequiredMode.REQUIRED)
+ private List createDeviceNames;
+
+ @Schema(description = "更新成功的设备名称数组", requiredMode = Schema.RequiredMode.REQUIRED)
+ private List updateDeviceNames;
+
+ @Schema(description = "导入失败的设备集合,key为设备名称,value为失败原因", requiredMode = Schema.RequiredMode.REQUIRED)
+ private Map failureDeviceNames;
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceMqttConnectionParamsRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceMqttConnectionParamsRespVO.java
new file mode 100644
index 000000000..5ce68c0fe
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceMqttConnectionParamsRespVO.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.device;
+
+import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
+import com.alibaba.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 设备 MQTT 连接参数 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class IotDeviceMqttConnectionParamsRespVO {
+
+ @Schema(description = "MQTT 客户端 ID", example = "24602")
+ @ExcelProperty("MQTT 客户端 ID")
+ private String mqttClientId;
+
+ @Schema(description = "MQTT 用户名", example = "芋艿")
+ @ExcelProperty("MQTT 用户名")
+ private String mqttUsername;
+
+ @Schema(description = "MQTT 密码")
+ @ExcelProperty("MQTT 密码")
+ private String mqttPassword;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDevicePageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDevicePageReqVO.java
new file mode 100644
index 000000000..686267732
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDevicePageReqVO.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.device;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.device.IotDeviceStateEnum;
+import cn.iocoder.yudao.module.iot.enums.product.IotProductDeviceTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 设备分页 Request VO")
+@Data
+public class IotDevicePageReqVO extends PageParam {
+
+ @Schema(description = "设备名称", example = "王五")
+ private String deviceName;
+
+ @Schema(description = "备注名称", example = "张三")
+ private String nickname;
+
+ @Schema(description = "产品编号", example = "26202")
+ private Long productId;
+
+ @Schema(description = "设备类型", example = "1")
+ @InEnum(IotProductDeviceTypeEnum.class)
+ private Integer deviceType;
+
+ @Schema(description = "设备状态", example = "1")
+ @InEnum(IotDeviceStateEnum.class)
+ private Integer status;
+
+ @Schema(description = "设备分组编号", example = "1024")
+ private Long groupId;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceRespVO.java
new file mode 100644
index 000000000..8404ca922
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceRespVO.java
@@ -0,0 +1,93 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.device;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
+import com.alibaba.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.Set;
+
+import static cn.iocoder.yudao.module.iot.enums.DictTypeConstants.DEVICE_STATE;
+
+@Schema(description = "管理后台 - IoT 设备 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class IotDeviceRespVO {
+
+ @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "177")
+ private Long id;
+
+ @Schema(description = "设备唯一标识符", requiredMode = Schema.RequiredMode.REQUIRED)
+ @ExcelProperty("设备唯一标识符")
+ private String deviceKey;
+
+ @Schema(description = "设备名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "王五")
+ @ExcelProperty("设备名称")
+ private String deviceName;
+
+ @Schema(description = "设备备注名称", example = "张三")
+ @ExcelProperty("设备备注名称")
+ private String nickname;
+
+ @Schema(description = "设备序列号", example = "1024")
+ @ExcelProperty("设备序列号")
+ private String serialNumber;
+
+ @Schema(description = "设备图片", example = "我是一名码农")
+ @ExcelProperty("设备图片")
+ private String picUrl;
+
+ @Schema(description = "设备分组编号数组", example = "1,2")
+ private Set groupIds;
+
+ @Schema(description = "产品编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "26202")
+ @ExcelProperty("产品编号")
+ private Long productId;
+
+ @Schema(description = "产品标识", requiredMode = Schema.RequiredMode.REQUIRED)
+ @ExcelProperty("产品 Key")
+ private String productKey;
+
+ @Schema(description = "设备类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @ExcelProperty("设备类型")
+ private Integer deviceType;
+
+ @Schema(description = "网关设备 ID", example = "16380")
+ private Long gatewayId;
+
+ @Schema(description = "设备状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @ExcelProperty(value = "设备状态", converter = DictConvert.class)
+ @DictFormat(DEVICE_STATE)
+ private Integer state;
+
+ @Schema(description = "最后上线时间")
+ @ExcelProperty("最后上线时间")
+ private LocalDateTime onlineTime;
+
+ @Schema(description = "最后离线时间")
+ @ExcelProperty("最后离线时间")
+ private LocalDateTime offlineTime;
+
+ @Schema(description = "设备激活时间")
+ @ExcelProperty("设备激活时间")
+ private LocalDateTime activeTime;
+
+ @Schema(description = "设备密钥，用于设备认证")
+ @ExcelProperty("设备密钥")
+ private String deviceSecret;
+
+ @Schema(description = "认证类型（如一机一密、动态注册）", example = "2")
+ @ExcelProperty("认证类型（如一机一密、动态注册）")
+ private String authType;
+
+ @Schema(description = "设备配置", example = "{\"abc\": \"efg\"}")
+ private String config;
+
+ @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+ @ExcelProperty("创建时间")
+ private LocalDateTime createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceSaveReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceSaveReqVO.java
new file mode 100644
index 000000000..b9ea9b99f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceSaveReqVO.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.device;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.Set;
+
+@Schema(description = "管理后台 - IoT 设备新增/修改 Request VO")
+@Data
+public class IotDeviceSaveReqVO {
+
+ @Schema(description = "设备编号", example = "177")
+ private Long id;
+
+ @Schema(description = "设备编号", requiredMode = Schema.RequiredMode.AUTO, example = "177")
+ @Size(max = 50, message = "设备编号长度不能超过 50 个字符")
+ private String deviceKey;
+
+ @Schema(description = "设备名称", requiredMode = Schema.RequiredMode.AUTO, example = "王五")
+ private String deviceName;
+
+ @Schema(description = "备注名称", example = "张三")
+ private String nickname;
+
+ @Schema(description = "设备序列号", example = "123456")
+ private String serialNumber;
+
+ @Schema(description = "设备图片", example = "https://iocoder.cn/1.png")
+ private String picUrl;
+
+ @Schema(description = "设备分组编号数组", example = "1,2")
+ private Set groupIds;
+
+ @Schema(description = "产品编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "26202")
+ private Long productId;
+
+ @Schema(description = "网关设备 ID", example = "16380")
+ private Long gatewayId;
+
+ @Schema(description = "设备配置", example = "{\"abc\": \"efg\"}")
+ private String config;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceUpdateGroupReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceUpdateGroupReqVO.java
new file mode 100644
index 000000000..bf66fbf98
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/device/IotDeviceUpdateGroupReqVO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.device;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.Data;
+
+import java.util.Set;
+
+@Schema(description = "管理后台 - IoT 设备更新分组 Request VO")
+@Data
+public class IotDeviceUpdateGroupReqVO {
+
+ @Schema(description = "设备编号列表", requiredMode = Schema.RequiredMode.REQUIRED, example = "1,2,3")
+ @NotEmpty(message = "设备编号列表不能为空")
+ private Set ids;
+
+ @Schema(description = "分组编号列表", requiredMode = Schema.RequiredMode.REQUIRED, example = "1,2,3")
+ @NotEmpty(message = "分组编号列表不能为空")
+ private Set groupIds;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/group/IotDeviceGroupPageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/group/IotDeviceGroupPageReqVO.java
new file mode 100644
index 000000000..93b1a1ead
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/group/IotDeviceGroupPageReqVO.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.group;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - IoT 设备分组分页 Request VO")
+@Data
+public class IotDeviceGroupPageReqVO extends PageParam {
+
+ @Schema(description = "分组名字", example = "李四")
+ private String name;
+
+ @Schema(description = "创建时间")
+ @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+ private LocalDateTime[] createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/group/IotDeviceGroupRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/group/IotDeviceGroupRespVO.java
new file mode 100644
index 000000000..4fd541502
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/group/IotDeviceGroupRespVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.group;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - IoT 设备分组 Response VO")
+@Data
+public class IotDeviceGroupRespVO {
+
+ @Schema(description = "分组 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "3583")
+ private Long id;
+
+ @Schema(description = "分组名字", requiredMode = Schema.RequiredMode.REQUIRED, example = "李四")
+ private String name;
+
+ @Schema(description = "分组状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ private Integer status;
+
+ @Schema(description = "分组描述", example = "你说的对")
+ private String description;
+
+ @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+ private LocalDateTime createTime;
+
+ @Schema(description = "设备数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+ private Long deviceCount;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/group/IotDeviceGroupSaveReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/group/IotDeviceGroupSaveReqVO.java
new file mode 100644
index 000000000..491cd9366
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/device/vo/group/IotDeviceGroupSaveReqVO.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.iot.controller.admin.device.vo.group;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 设备分组新增/修改 Request VO")
+@Data
+public class IotDeviceGroupSaveReqVO {
+
+ @Schema(description = "分组 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "3583")
+ private Long id;
+
+ @Schema(description = "分组名字", requiredMode = Schema.RequiredMode.REQUIRED, example = "李四")
+ @NotEmpty(message = "分组名字不能为空")
+ private String name;
+
+ @Schema(description = "分组状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @NotNull(message = "分组状态不能为空")
+ private Integer status;
+
+ @Schema(description = "分组描述", example = "你说的对")
+ private String description;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/IotOtaFirmwareController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/IotOtaFirmwareController.java
new file mode 100644
index 000000000..6cc3918e8
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/IotOtaFirmwareController.java
@@ -0,0 +1,62 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware.IotOtaFirmwarePageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware.IotOtaFirmwareRespVO;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware.IotOtaFirmwareCreateReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware.IotOtaFirmwareUpdateReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaFirmwareDO;
+import cn.iocoder.yudao.module.iot.service.ota.IotOtaFirmwareService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - IoT OTA 固件")
+@RestController
+@RequestMapping("/iot/ota-firmware")
+@Validated
+public class IotOtaFirmwareController {
+
+ @Resource
+ private IotOtaFirmwareService otaFirmwareService;
+
+ @PostMapping("/create")
+ @Operation(summary = "创建 OTA 固件")
+ @PreAuthorize("@ss.hasPermission('iot:ota-firmware:create')")
+ public CommonResult createOtaFirmware(@Valid @RequestBody IotOtaFirmwareCreateReqVO createReqVO) {
+ return success(otaFirmwareService.createOtaFirmware(createReqVO));
+ }
+
+ @PutMapping("/update")
+ @Operation(summary = "更新 OTA 固件")
+ @PreAuthorize("@ss.hasPermission('iot:ota-firmware:update')")
+ public CommonResult updateOtaFirmware(@Valid @RequestBody IotOtaFirmwareUpdateReqVO updateReqVO) {
+ otaFirmwareService.updateOtaFirmware(updateReqVO);
+ return success(true);
+ }
+
+ @GetMapping("/get")
+ @Operation(summary = "获得 OTA 固件")
+ @PreAuthorize("@ss.hasPermission('iot:ota-firmware:query')")
+ public CommonResult getOtaFirmware(@RequestParam("id") Long id) {
+ IotOtaFirmwareDO otaFirmware = otaFirmwareService.getOtaFirmware(id);
+ return success(BeanUtils.toBean(otaFirmware, IotOtaFirmwareRespVO.class));
+ }
+
+ @GetMapping("/page")
+ @Operation(summary = "获得 OTA 固件分页")
+ @PreAuthorize("@ss.hasPermission('iot:ota-firmware:query')")
+ public CommonResult> getOtaFirmwarePage(@Valid IotOtaFirmwarePageReqVO pageReqVO) {
+ PageResult pageResult = otaFirmwareService.getOtaFirmwarePage(pageReqVO);
+ return success(BeanUtils.toBean(pageResult, IotOtaFirmwareRespVO.class));
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/IotOtaUpgradeRecordController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/IotOtaUpgradeRecordController.java
new file mode 100644
index 000000000..f6bc526ac
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/IotOtaUpgradeRecordController.java
@@ -0,0 +1,75 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.record.IotOtaUpgradeRecordPageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.record.IotOtaUpgradeRecordRespVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaUpgradeRecordDO;
+import cn.iocoder.yudao.module.iot.service.ota.IotOtaUpgradeRecordService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - IoT OTA 升级记录")
+@RestController
+@RequestMapping("/iot/ota-upgrade-record")
+@Validated
+public class IotOtaUpgradeRecordController {
+
+ @Resource
+ private IotOtaUpgradeRecordService upgradeRecordService;
+
+ @GetMapping("/get-statistics")
+ @Operation(summary = "固件升级设备统计")
+ @PreAuthorize("@ss.hasPermission('iot:ota-upgrade-record:query')")
+ @Parameter(name = "firmwareId", description = "固件编号", required = true, example = "1024")
+ public CommonResult> getOtaUpgradeRecordStatistics(@RequestParam(value = "firmwareId") Long firmwareId) {
+ return success(upgradeRecordService.getOtaUpgradeRecordStatistics(firmwareId));
+ }
+
+ @GetMapping("/get-count")
+ @Operation(summary = "获得升级记录分页 tab 数量")
+ @PreAuthorize("@ss.hasPermission('iot:ota-upgrade-record:query')")
+ public CommonResult> getOtaUpgradeRecordCount(
+ @Valid IotOtaUpgradeRecordPageReqVO pageReqVO) {
+ return success(upgradeRecordService.getOtaUpgradeRecordCount(pageReqVO));
+ }
+
+ @GetMapping("/page")
+ @Operation(summary = "获得升级记录分页")
+ @PreAuthorize("@ss.hasPermission('iot:ota-upgrade-record:query')")
+ public CommonResult> getUpgradeRecordPage(
+ @Valid IotOtaUpgradeRecordPageReqVO pageReqVO) {
+ PageResult pageResult = upgradeRecordService.getUpgradeRecordPage(pageReqVO);
+ return success(BeanUtils.toBean(pageResult, IotOtaUpgradeRecordRespVO.class));
+ }
+
+ @GetMapping("/get")
+ @Operation(summary = "获得升级记录")
+ @PreAuthorize("@ss.hasPermission('iot:ota-upgrade-record:query')")
+ @Parameter(name = "id", description = "升级记录编号", required = true, example = "1024")
+ public CommonResult getUpgradeRecord(@RequestParam("id") Long id) {
+ IotOtaUpgradeRecordDO upgradeRecord = upgradeRecordService.getUpgradeRecord(id);
+ return success(BeanUtils.toBean(upgradeRecord, IotOtaUpgradeRecordRespVO.class));
+ }
+
+ @PutMapping("/retry")
+ @Operation(summary = "重试升级记录")
+ @PreAuthorize("@ss.hasPermission('iot:ota-upgrade-record:retry')")
+ @Parameter(name = "id", description = "升级记录编号", required = true, example = "1024")
+ public CommonResult retryUpgradeRecord(@RequestParam("id") Long id) {
+ upgradeRecordService.retryUpgradeRecord(id);
+ return success(true);
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/IotOtaUpgradeTaskController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/IotOtaUpgradeTaskController.java
new file mode 100644
index 000000000..e248e8027
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/IotOtaUpgradeTaskController.java
@@ -0,0 +1,64 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.task.IotOtaUpgradeTaskPageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.task.IotOtaUpgradeTaskRespVO;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.task.IotOtaUpgradeTaskSaveReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaUpgradeTaskDO;
+import cn.iocoder.yudao.module.iot.service.ota.IotOtaUpgradeTaskService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - IoT OTA 升级任务")
+@RestController
+@RequestMapping("/iot/ota-upgrade-task")
+@Validated
+public class IotOtaUpgradeTaskController {
+
+ @Resource
+ private IotOtaUpgradeTaskService upgradeTaskService;
+
+ @PostMapping("/create")
+ @Operation(summary = "创建升级任务")
+ @PreAuthorize(value = "@ss.hasPermission('iot:ota-upgrade-task:create')")
+ public CommonResult createUpgradeTask(@Valid @RequestBody IotOtaUpgradeTaskSaveReqVO createReqVO) {
+ return success(upgradeTaskService.createUpgradeTask(createReqVO));
+ }
+
+ @PostMapping("/cancel")
+ @Operation(summary = "取消升级任务")
+ @Parameter(name = "id", description = "升级任务编号", required = true)
+ @PreAuthorize(value = "@ss.hasPermission('iot:ota-upgrade-task:cancel')")
+ public CommonResult cancelUpgradeTask(@RequestParam("id") Long id) {
+ upgradeTaskService.cancelUpgradeTask(id);
+ return success(true);
+ }
+
+ @GetMapping("/page")
+ @Operation(summary = "获得升级任务分页")
+ @PreAuthorize(value = "@ss.hasPermission('iot:ota-upgrade-task:query')")
+ public CommonResult> getUpgradeTaskPage(@Valid IotOtaUpgradeTaskPageReqVO pageReqVO) {
+ PageResult pageResult = upgradeTaskService.getUpgradeTaskPage(pageReqVO);
+ return success(BeanUtils.toBean(pageResult, IotOtaUpgradeTaskRespVO.class));
+ }
+
+ @GetMapping("/get")
+ @Operation(summary = "获得升级任务")
+ @Parameter(name = "id", description = "升级任务编号", required = true, example = "1024")
+ @PreAuthorize(value = "@ss.hasPermission('iot:ota-upgrade-task:query')")
+ public CommonResult getUpgradeTask(@RequestParam("id") Long id) {
+ IotOtaUpgradeTaskDO upgradeTask = upgradeTaskService.getUpgradeTask(id);
+ return success(BeanUtils.toBean(upgradeTask, IotOtaUpgradeTaskRespVO.class));
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwareCreateReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwareCreateReqVO.java
new file mode 100644
index 000000000..50c2ece15
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwareCreateReqVO.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+@Schema(description = "管理后台 - IoT OTA 固件创建 Request VO")
+@Data
+public class IotOtaFirmwareCreateReqVO {
+
+ @Schema(description = "固件名称", requiredMode = REQUIRED, example = "智能开关固件")
+ @NotEmpty(message = "固件名称不能为空")
+ private String name;
+
+ @Schema(description = "固件描述", example = "某品牌型号固件，测试用")
+ private String description;
+
+ @Schema(description = "版本号", requiredMode = REQUIRED, example = "1.0.0")
+ @NotEmpty(message = "版本号不能为空")
+ private String version;
+
+ @Schema(description = "产品编号", requiredMode = REQUIRED, example = "1024")
+ @NotNull(message = "产品编号不能为空")
+ private String productId;
+
+ @Schema(description = "签名方式", example = "MD5")
+ // TODO @li：是不是必传哈
+ private String signMethod;
+
+ @Schema(description = "固件文件 URL", requiredMode = REQUIRED, example = "https://www.iocoder.cn/yudao-firmware.zip")
+ @NotEmpty(message = "固件文件 URL 不能为空")
+ private String fileUrl;
+
+ @Schema(description = "自定义信息，建议使用 JSON 格式", example = "{\"key1\":\"value1\",\"key2\":\"value2\"}")
+ private String information;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwarePageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwarePageReqVO.java
new file mode 100644
index 000000000..baa741029
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwarePageReqVO.java
@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Data
+@Schema(description = "管理后台 - IoT OTA 固件分页 Request VO")
+public class IotOtaFirmwarePageReqVO extends PageParam {
+
+ /**
+ * 固件名称
+ */
+ @Schema(description = "固件名称", example = "智能开关固件")
+ private String name;
+
+ /**
+ * 产品标识
+ */
+ @Schema(description = "产品标识", example = "1024")
+ private String productId;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwareRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwareRespVO.java
new file mode 100644
index 000000000..735618781
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwareRespVO.java
@@ -0,0 +1,85 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware;
+
+import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO;
+import com.fhs.core.trans.anno.Trans;
+import com.fhs.core.trans.constant.TransType;
+import com.fhs.core.trans.vo.VO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+@Data
+@Schema(description = "管理后台 - IoT OTA 固件 Response VO")
+public class IotOtaFirmwareRespVO implements VO {
+
+ /**
+ * 固件编号
+ */
+ @Schema(description = "固件编号", requiredMode = REQUIRED, example = "1024")
+ private Long id;
+ /**
+ * 固件名称
+ */
+ @Schema(description = "固件名称", requiredMode = REQUIRED, example = "OTA固件")
+ private String name;
+ /**
+ * 固件描述
+ */
+ @Schema(description = "固件描述")
+ private String description;
+ /**
+ * 版本号
+ */
+ @Schema(description = "版本号", requiredMode = REQUIRED, example = "1.0.0")
+ private String version;
+
+ /**
+ * 产品编号
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO#getId()}
+ */
+ @Schema(description = "产品编号", requiredMode = REQUIRED, example = "1024")
+ @Trans(type = TransType.SIMPLE, target = IotProductDO.class, fields = {"name"}, refs = {"productName"})
+ private String productId;
+ /**
+ * 产品标识
+ *
+ * 冗余 {@link cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO#getProductKey()}
+ */
+ @Schema(description = "产品标识", requiredMode = REQUIRED, example = "iot-product-key")
+ private String productKey;
+ /**
+ * 产品名称
+ */
+ @Schema(description = "产品名称", requiredMode = REQUIRED, example = "OTA产品")
+ private String productName;
+ /**
+ * 签名方式
+ *
+ * 例如说：MD5、SHA256
+ */
+ @Schema(description = "签名方式", example = "MD5")
+ private String signMethod;
+ /**
+ * 固件文件签名
+ */
+ @Schema(description = "固件文件签名", example = "1024")
+ private String fileSign;
+ /**
+ * 固件文件大小
+ */
+ @Schema(description = "固件文件大小", requiredMode = REQUIRED, example = "1024")
+ private Long fileSize;
+ /**
+ * 固件文件 URL
+ */
+ @Schema(description = "固件文件 URL", requiredMode = REQUIRED, example = "https://www.iocoder.cn")
+ private String fileUrl;
+ /**
+ * 自定义信息，建议使用 JSON 格式
+ */
+ @Schema(description = "自定义信息，建议使用 JSON 格式")
+ private String information;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwareUpdateReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwareUpdateReqVO.java
new file mode 100644
index 000000000..aa134bcee
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/firmware/IotOtaFirmwareUpdateReqVO.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+@Schema(description = "管理后台 - IoT OTA 固件更新 Request VO")
+@Data
+public class IotOtaFirmwareUpdateReqVO {
+
+ @Schema(description = "固件编号", requiredMode = REQUIRED, example = "1024")
+ @NotNull(message = "固件编号不能为空")
+ private Long id;
+
+ // TODO @li：name 是不是可以飞必传哈
+ @Schema(description = "固件名称", requiredMode = REQUIRED, example = "智能开关固件")
+ @NotEmpty(message = "固件名称不能为空")
+ private String name;
+
+ @Schema(description = "固件描述", example = "某品牌型号固件，测试用")
+ private String description;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/record/IotOtaUpgradeRecordPageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/record/IotOtaUpgradeRecordPageReqVO.java
new file mode 100644
index 000000000..2b21b3079
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/record/IotOtaUpgradeRecordPageReqVO.java
@@ -0,0 +1,32 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.record;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+@Data
+@Schema(description = "管理后台 - IoT OTA 升级记录分页 Request VO")
+public class IotOtaUpgradeRecordPageReqVO extends PageParam {
+
+ // TODO @li：已经有注解，不用重复注释
+ /**
+ * 升级任务编号字段。
+ *
+ * 该字段用于标识升级任务的唯一编号，不能为空。
+ */
+ @Schema(description = "升级任务编号", requiredMode = REQUIRED, example = "1024")
+ @NotNull(message = "升级任务编号不能为空")
+ private Long taskId;
+
+ /**
+ * 设备标识字段。
+ *
+ * 该字段用于标识设备的名称，通常用于区分不同的设备。
+ */
+ @Schema(description = "设备标识", requiredMode = REQUIRED, example = "摄像头A1-1")
+ private String deviceName;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/record/IotOtaUpgradeRecordRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/record/IotOtaUpgradeRecordRespVO.java
new file mode 100644
index 000000000..db6737feb
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/record/IotOtaUpgradeRecordRespVO.java
@@ -0,0 +1,109 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.record;
+
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaFirmwareDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaUpgradeTaskDO;
+import com.fhs.core.trans.anno.Trans;
+import com.fhs.core.trans.constant.TransType;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+@Data
+@Schema(description = "管理后台 - IoT OTA 升级记录 Response VO")
+public class IotOtaUpgradeRecordRespVO {
+
+ /**
+ * 升级记录编号
+ */
+ @Schema(description = "升级记录编号", requiredMode = REQUIRED, example = "1024")
+ private Long id;
+ /**
+ * 固件编号
+ *
+ * 关联 {@link IotOtaFirmwareDO#getId()}
+ */
+ @Schema(description = "固件编号", requiredMode = REQUIRED, example = "1024")
+ @Trans(type = TransType.SIMPLE, target = IotOtaFirmwareDO.class, fields = {"version"}, refs = {"firmwareVersion"})
+ private Long firmwareId;
+ /**
+ * 固件版本
+ */
+ @Schema(description = "固件版本", requiredMode = REQUIRED, example = "v1.0.0")
+ private String firmwareVersion;
+ /**
+ * 任务编号
+ *
+ * 关联 {@link IotOtaUpgradeTaskDO#getId()}
+ */
+ @Schema(description = "任务编号", requiredMode = REQUIRED, example = "1024")
+ private Long taskId;
+ /**
+ * 产品标识
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO#getId()}
+ */
+ @Schema(description = "产品标识", requiredMode = REQUIRED, example = "iot")
+ private String productKey;
+ /**
+ * 设备名称
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO#getId()}
+ */
+ @Schema(description = "设备名称", requiredMode = REQUIRED, example = "iot")
+ private String deviceName;
+ /**
+ * 设备编号
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO#getId()}
+ */
+ @Schema(description = "设备编号", requiredMode = REQUIRED, example = "1024")
+ private String deviceId;
+ /**
+ * 来源的固件编号
+ *
+ * 关联 {@link IotDeviceDO#getFirmwareId()}
+ */
+ @Schema(description = "来源的固件编号", requiredMode = REQUIRED, example = "1024")
+ @Trans(type = TransType.SIMPLE, target = IotOtaFirmwareDO.class, fields = {"version"}, refs = {"fromFirmwareVersion"})
+ private Long fromFirmwareId;
+ /**
+ * 来源的固件版本
+ */
+ @Schema(description = "来源的固件版本", requiredMode = REQUIRED, example = "v1.0.0")
+ private String fromFirmwareVersion;
+ /**
+ * 升级状态
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.enums.ota.IotOtaUpgradeRecordStatusEnum}
+ */
+ @Schema(description = "升级状态", requiredMode = REQUIRED, allowableValues = {"0", "10", "20", "30", "40", "50"})
+ private Integer status;
+ /**
+ * 升级进度，百分比
+ */
+ @Schema(description = "升级进度，百分比", requiredMode = REQUIRED, example = "10")
+ private Integer progress;
+ /**
+ * 升级进度描述
+ *
+ * 注意，只记录设备最后一次的升级进度描述
+ * 如果想看历史记录，可以查看 {@link cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceLogDO} 设备日志
+ */
+ @Schema(description = "升级进度描述", requiredMode = REQUIRED, example = "10")
+ private String description;
+ /**
+ * 升级开始时间
+ */
+ @Schema(description = "升级开始时间", requiredMode = REQUIRED, example = "2022-07-08 07:30:00")
+ private LocalDateTime startTime;
+ /**
+ * 升级结束时间
+ */
+ @Schema(description = "升级结束时间", requiredMode = REQUIRED, example = "2022-07-08 07:30:00")
+ private LocalDateTime endTime;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/task/IotOtaUpgradeTaskPageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/task/IotOtaUpgradeTaskPageReqVO.java
new file mode 100644
index 000000000..d2b1926aa
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/task/IotOtaUpgradeTaskPageReqVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.task;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+@Data
+@Schema(description = "管理后台 - IoT OTA 升级任务分页 Request VO")
+public class IotOtaUpgradeTaskPageReqVO extends PageParam {
+
+ /**
+ * 任务名称字段，用于描述任务的名称
+ */
+ @Schema(description = "任务名称", example = "升级任务")
+ private String name;
+
+ /**
+ * 固件编号字段，用于唯一标识固件，不能为空
+ */
+ @NotNull(message = "固件编号不能为空")
+ @Schema(description = "固件编号", requiredMode = REQUIRED, example = "1024")
+ private Long firmwareId;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/task/IotOtaUpgradeTaskRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/task/IotOtaUpgradeTaskRespVO.java
new file mode 100644
index 000000000..dbc29618f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/task/IotOtaUpgradeTaskRespVO.java
@@ -0,0 +1,84 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.task;
+
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaFirmwareDO;
+import com.fhs.core.trans.vo.VO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+@Data
+@Schema(description = "管理后台 - IoT OTA 升级任务 Response VO")
+public class IotOtaUpgradeTaskRespVO implements VO {
+
+ /**
+ * 任务编号
+ */
+ @Schema(description = "任务编号", requiredMode = REQUIRED, example = "1024")
+ private Long id;
+ /**
+ * 任务名称
+ */
+ @Schema(description = "任务名称", requiredMode = REQUIRED, example = "升级任务")
+ private String name;
+ /**
+ * 任务描述
+ */
+ @Schema(description = "任务描述", example = "升级任务")
+ private String description;
+ /**
+ * 固件编号
+ *
+ * 关联 {@link IotOtaFirmwareDO#getId()}
+ */
+ @Schema(description = "固件编号", requiredMode = REQUIRED, example = "1024")
+ private Long firmwareId;
+ /**
+ * 任务状态
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.enums.ota.IotOtaUpgradeTaskStatusEnum}
+ */
+ @Schema(description = "任务状态", requiredMode = REQUIRED, allowableValues = {"10", "20", "21", "30"})
+ private Integer status;
+ /**
+ * 任务状态名称
+ */
+ @Schema(description = "任务状态名称", requiredMode = REQUIRED, example = "进行中")
+ private String statusName;
+ /**
+ * 升级范围
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.enums.ota.IotOtaUpgradeTaskScopeEnum}
+ */
+ @Schema(description = "升级范围", requiredMode = REQUIRED, allowableValues = {"1", "2"})
+ private Integer scope;
+ /**
+ * 设备数量
+ */
+ @Schema(description = "设备数量", requiredMode = REQUIRED, example = "1024")
+ private Long deviceCount;
+ /**
+ * 选中的设备编号数组
+ *
+ * 关联 {@link IotDeviceDO#getId()}
+ */
+ @Schema(description = "选中的设备编号数组", example = "1024")
+ private List deviceIds;
+ /**
+ * 选中的设备名字数组
+ *
+ * 关联 {@link IotDeviceDO#getDeviceName()}
+ */
+ @Schema(description = "选中的设备名字数组", example = "1024")
+ private List deviceNames;
+ /**
+ * 创建时间
+ */
+ @Schema(description = "创建时间", requiredMode = REQUIRED, example = "2022-07-08 07:30:00")
+ private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/task/IotOtaUpgradeTaskSaveReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/task/IotOtaUpgradeTaskSaveReqVO.java
new file mode 100644
index 000000000..0ace17a04
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/ota/vo/upgrade/task/IotOtaUpgradeTaskSaveReqVO.java
@@ -0,0 +1,63 @@
+package cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.task;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaFirmwareDO;
+import cn.iocoder.yudao.module.iot.enums.ota.IotOtaUpgradeTaskScopeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+@Data
+@Schema(description = "管理后台 - IoT OTA 升级任务创建/修改 Request VO")
+public class IotOtaUpgradeTaskSaveReqVO {
+
+ // TODO @li：已经有注解，不用重复注释
+ // TODO @li： @Schema 写在参数校验前面。先有定义；其他的，也检查下；
+
+ /**
+ * 任务名称
+ */
+ @NotEmpty(message = "任务名称不能为空")
+ @Schema(description = "任务名称", requiredMode = REQUIRED, example = "升级任务")
+ private String name;
+
+ /**
+ * 任务描述
+ */
+ @Schema(description = "任务描述", example = "升级任务")
+ private String description;
+
+ /**
+ * 固件编号
+ *
+ * 关联 {@link IotOtaFirmwareDO#getId()}
+ */
+ @NotNull(message = "固件编号不能为空")
+ @Schema(description = "固件编号", requiredMode = REQUIRED, example = "1024")
+ private Long firmwareId;
+
+ /**
+ * 升级范围
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.enums.ota.IotOtaUpgradeTaskScopeEnum}
+ */
+ @NotNull(message = "升级范围不能为空")
+ @InEnum(value = IotOtaUpgradeTaskScopeEnum.class)
+ @Schema(description = "升级范围", requiredMode = REQUIRED, example = "1")
+ private Integer scope;
+
+ /**
+ * 选中的设备编号数组
+ *
+ * 关联 {@link IotDeviceDO#getId()}
+ */
+ @Schema(description = "选中的设备编号数组", requiredMode = REQUIRED, example = "[1,2,3,4]")
+ private List deviceIds;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/PluginConfigController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/PluginConfigController.java
new file mode 100644
index 000000000..e21b10241
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/PluginConfigController.java
@@ -0,0 +1,90 @@
+package cn.iocoder.yudao.module.iot.controller.admin.plugin;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config.PluginConfigImportReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config.PluginConfigPageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config.PluginConfigRespVO;
+import cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config.PluginConfigSaveReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config.PluginConfigStatusReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.plugin.IotPluginConfigDO;
+import cn.iocoder.yudao.module.iot.service.plugin.IotPluginConfigService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - IoT 插件配置")
+@RestController
+@RequestMapping("/iot/plugin-config")
+@Validated
+public class PluginConfigController {
+
+ @Resource
+ private IotPluginConfigService pluginConfigService;
+
+ @PostMapping("/create")
+ @Operation(summary = "创建插件配置")
+ @PreAuthorize("@ss.hasPermission('iot:plugin-config:create')")
+ public CommonResult createPluginConfig(@Valid @RequestBody PluginConfigSaveReqVO createReqVO) {
+ return success(pluginConfigService.createPluginConfig(createReqVO));
+ }
+
+ @PutMapping("/update")
+ @Operation(summary = "更新插件配置")
+ @PreAuthorize("@ss.hasPermission('iot:plugin-config:update')")
+ public CommonResult updatePluginConfig(@Valid @RequestBody PluginConfigSaveReqVO updateReqVO) {
+ pluginConfigService.updatePluginConfig(updateReqVO);
+ return success(true);
+ }
+
+ @DeleteMapping("/delete")
+ @Operation(summary = "删除插件配置")
+ @Parameter(name = "id", description = "编号", required = true)
+ @PreAuthorize("@ss.hasPermission('iot:plugin-config:delete')")
+ public CommonResult deletePluginConfig(@RequestParam("id") Long id) {
+ pluginConfigService.deletePluginConfig(id);
+ return success(true);
+ }
+
+ @GetMapping("/get")
+ @Operation(summary = "获得插件配置")
+ @Parameter(name = "id", description = "编号", required = true, example = "1024")
+ @PreAuthorize("@ss.hasPermission('iot:plugin-config:query')")
+ public CommonResult getPluginConfig(@RequestParam("id") Long id) {
+ IotPluginConfigDO pluginConfig = pluginConfigService.getPluginConfig(id);
+ return success(BeanUtils.toBean(pluginConfig, PluginConfigRespVO.class));
+ }
+
+ @GetMapping("/page")
+ @Operation(summary = "获得插件配置分页")
+ @PreAuthorize("@ss.hasPermission('iot:plugin-config:query')")
+ public CommonResult> getPluginConfigPage(@Valid PluginConfigPageReqVO pageReqVO) {
+ PageResult pageResult = pluginConfigService.getPluginConfigPage(pageReqVO);
+ return success(BeanUtils.toBean(pageResult, PluginConfigRespVO.class));
+ }
+
+ @PostMapping("/upload-file")
+ @Operation(summary = "上传插件文件")
+ @PreAuthorize("@ss.hasPermission('iot:plugin-config:update')")
+ public CommonResult uploadFile(@Valid PluginConfigImportReqVO reqVO) {
+ pluginConfigService.uploadFile(reqVO.getId(), reqVO.getFile());
+ return success(true);
+ }
+
+ @PutMapping("/update-status")
+ @Operation(summary = "修改插件状态")
+ @PreAuthorize("@ss.hasPermission('iot:plugin-config:update')")
+ public CommonResult updatePluginConfigStatus(@Valid @RequestBody PluginConfigStatusReqVO reqVO) {
+ pluginConfigService.updatePluginStatus(reqVO.getId(), reqVO.getStatus());
+ return success(true);
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigImportReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigImportReqVO.java
new file mode 100644
index 000000000..b9b277a54
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigImportReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import org.springframework.web.multipart.MultipartFile;
+
+@Schema(description = "管理后台 - IoT 插件上传 Request VO")
+@Data
+public class PluginConfigImportReqVO {
+
+ @Schema(description = "主键 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "11546")
+ private Long id;
+
+ @Schema(description = "插件文件", requiredMode = Schema.RequiredMode.REQUIRED)
+ @NotNull(message = "插件文件不能为空")
+ private MultipartFile file;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigPageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigPageReqVO.java
new file mode 100644
index 000000000..1666d5d6b
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigPageReqVO.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.plugin.IotPluginStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 插件配置分页 Request VO")
+@Data
+public class PluginConfigPageReqVO extends PageParam {
+
+ @Schema(description = "插件名称", example = "http")
+ private String name;
+
+ @Schema(description = "状态", example = "1")
+ @InEnum(IotPluginStatusEnum.class)
+ private Integer status;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigRespVO.java
new file mode 100644
index 000000000..2b8c4dcde
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigRespVO.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - IoT 插件配置 Response VO")
+@Data
+public class PluginConfigRespVO {
+
+ @Schema(description = "主键 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "11546")
+ private Long id;
+
+ @Schema(description = "插件包标识符", requiredMode = Schema.RequiredMode.REQUIRED, example = "24627")
+ private String pluginKey;
+
+ @Schema(description = "插件名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "赵六")
+ private String name;
+
+ @Schema(description = "描述", example = "你猜")
+ private String description;
+
+ @Schema(description = "部署方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+ private Integer deployType;
+
+ @Schema(description = "插件包文件名", requiredMode = Schema.RequiredMode.REQUIRED)
+ private String fileName;
+
+ @Schema(description = "插件版本", requiredMode = Schema.RequiredMode.REQUIRED)
+ private String version;
+
+ @Schema(description = "插件类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+ private Integer type;
+
+ @Schema(description = "设备插件协议类型")
+ private String protocol;
+
+ @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED)
+ private Integer status;
+
+ @Schema(description = "插件配置项描述信息")
+ private String configSchema;
+
+ @Schema(description = "插件配置信息")
+ private String config;
+
+ @Schema(description = "插件脚本")
+ private String script;
+
+ @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+ private LocalDateTime createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigSaveReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigSaveReqVO.java
new file mode 100644
index 000000000..e48869d64
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigSaveReqVO.java
@@ -0,0 +1,56 @@
+package cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.plugin.IotPluginStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 插件配置新增/修改 Request VO")
+@Data
+public class PluginConfigSaveReqVO {
+
+ // TODO @haohao：新增的字段有点多，每个都需要哇？
+
+ // TODO @haohao：一些枚举字段，需要加枚举校验。例如说，deployType、status、type 等
+
+ @Schema(description = "主键编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "11546")
+ private Long id;
+
+ @Schema(description = "插件包标识符", requiredMode = Schema.RequiredMode.REQUIRED, example = "24627")
+ private String pluginKey;
+
+ @Schema(description = "插件名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "赵六")
+ private String name;
+
+ @Schema(description = "描述", example = "你猜")
+ private String description;
+
+ @Schema(description = "部署方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+ private Integer deployType;
+
+ @Schema(description = "插件包文件名", requiredMode = Schema.RequiredMode.REQUIRED)
+ private String fileName;
+
+ @Schema(description = "插件版本", requiredMode = Schema.RequiredMode.REQUIRED)
+ private String version;
+
+ @Schema(description = "插件类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+ private Integer type;
+
+ @Schema(description = "设备插件协议类型")
+ private String protocol;
+
+ @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED)
+ @InEnum(IotPluginStatusEnum.class)
+ private Integer status;
+
+ @Schema(description = "插件配置项描述信息")
+ private String configSchema;
+
+ @Schema(description = "插件配置信息")
+ private String config;
+
+ @Schema(description = "插件脚本")
+ private String script;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigStatusReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigStatusReqVO.java
new file mode 100644
index 000000000..eae4aa0a2
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/config/PluginConfigStatusReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.plugin.IotPluginStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 插件配置状态 Request VO")
+@Data
+public class PluginConfigStatusReqVO {
+
+ @Schema(description = "主键编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "11546")
+ private Long id;
+
+ @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED)
+ @InEnum(IotPluginStatusEnum.class)
+ private Integer status;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/instance/PluginInstancePageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/instance/PluginInstancePageReqVO.java
new file mode 100644
index 000000000..e58b88856
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/instance/PluginInstancePageReqVO.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.instance;
+
+import lombok.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+// TODO @haohao：后续需要使用下
+@Schema(description = "管理后台 - IoT 插件实例分页 Request VO")
+@Data
+public class PluginInstancePageReqVO extends PageParam {
+
+ @Schema(description = "插件主程序编号", example = "23738")
+ private String mainId;
+
+ @Schema(description = "插件id", example = "26498")
+ private Long pluginId;
+
+ @Schema(description = "插件主程序所在ip")
+ private String ip;
+
+ @Schema(description = "插件主程序端口")
+ private Integer port;
+
+ @Schema(description = "心跳时间，心路时间超过30秒需要剔除")
+ private Long heartbeatAt;
+
+ @Schema(description = "创建时间")
+ @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+ private LocalDateTime[] createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/instance/PluginInstanceRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/instance/PluginInstanceRespVO.java
new file mode 100644
index 000000000..cba59fdaf
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/plugin/vo/instance/PluginInstanceRespVO.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.instance;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+// TODO @haohao：后续需要使用下
+@Schema(description = "管理后台 - IoT 插件实例 Response VO")
+@Data
+public class PluginInstanceRespVO {
+
+ @Schema(description = "主键编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "23864")
+ private Long id;
+
+ @Schema(description = "插件主程序id", requiredMode = Schema.RequiredMode.REQUIRED, example = "23738")
+ private String mainId;
+
+ @Schema(description = "插件id", requiredMode = Schema.RequiredMode.REQUIRED, example = "26498")
+ private Long pluginId;
+
+ @Schema(description = "插件主程序所在ip", requiredMode = Schema.RequiredMode.REQUIRED)
+ private String ip;
+
+ @Schema(description = "插件主程序端口", requiredMode = Schema.RequiredMode.REQUIRED)
+ private Integer port;
+
+ @Schema(description = "心跳时间，心路时间超过30秒需要剔除", requiredMode = Schema.RequiredMode.REQUIRED)
+ private Long heartbeatAt;
+
+ @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+ private LocalDateTime createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/IotProductCategoryController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/IotProductCategoryController.java
new file mode 100644
index 000000000..bc1c1fbf2
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/IotProductCategoryController.java
@@ -0,0 +1,86 @@
+package cn.iocoder.yudao.module.iot.controller.admin.product;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.product.vo.category.IotProductCategoryPageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.product.vo.category.IotProductCategoryRespVO;
+import cn.iocoder.yudao.module.iot.controller.admin.product.vo.category.IotProductCategorySaveReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductCategoryDO;
+import cn.iocoder.yudao.module.iot.service.product.IotProductCategoryService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - IoT 产品分类")
+@RestController
+@RequestMapping("/iot/product-category")
+@Validated
+public class IotProductCategoryController {
+
+ @Resource
+ private IotProductCategoryService productCategoryService;
+
+ @PostMapping("/create")
+ @Operation(summary = "创建产品分类")
+ @PreAuthorize("@ss.hasPermission('iot:product-category:create')")
+ public CommonResult createProductCategory(@Valid @RequestBody IotProductCategorySaveReqVO createReqVO) {
+ return success(productCategoryService.createProductCategory(createReqVO));
+ }
+
+ @PutMapping("/update")
+ @Operation(summary = "更新产品分类")
+ @PreAuthorize("@ss.hasPermission('iot:product-category:update')")
+ public CommonResult updateProductCategory(@Valid @RequestBody IotProductCategorySaveReqVO updateReqVO) {
+ productCategoryService.updateProductCategory(updateReqVO);
+ return success(true);
+ }
+
+ @DeleteMapping("/delete")
+ @Operation(summary = "删除产品分类")
+ @Parameter(name = "id", description = "编号", required = true)
+ @PreAuthorize("@ss.hasPermission('iot:product-category:delete')")
+ public CommonResult deleteProductCategory(@RequestParam("id") Long id) {
+ productCategoryService.deleteProductCategory(id);
+ return success(true);
+ }
+
+ @GetMapping("/get")
+ @Operation(summary = "获得产品分类")
+ @Parameter(name = "id", description = "编号", required = true, example = "1024")
+ @PreAuthorize("@ss.hasPermission('iot:product-category:query')")
+ public CommonResult getProductCategory(@RequestParam("id") Long id) {
+ IotProductCategoryDO productCategory = productCategoryService.getProductCategory(id);
+ return success(BeanUtils.toBean(productCategory, IotProductCategoryRespVO.class));
+ }
+
+ @GetMapping("/page")
+ @Operation(summary = "获得产品分类分页")
+ @PreAuthorize("@ss.hasPermission('iot:product-category:query')")
+ public CommonResult> getProductCategoryPage(@Valid IotProductCategoryPageReqVO pageReqVO) {
+ PageResult pageResult = productCategoryService.getProductCategoryPage(pageReqVO);
+ return success(BeanUtils.toBean(pageResult, IotProductCategoryRespVO.class));
+ }
+
+ @GetMapping("/simple-list")
+ @Operation(summary = "获得所有产品分类列表")
+ @PreAuthorize("@ss.hasPermission('iot:product-category:query')")
+ public CommonResult> getSimpleProductCategoryList() {
+ List list = productCategoryService.getProductCategoryListByStatus(
+ CommonStatusEnum.ENABLE.getStatus());
+ return success(convertList(list, category ->
+ new IotProductCategoryRespVO().setId(category.getId()).setName(category.getName())));
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/IotProductController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/IotProductController.java
new file mode 100644
index 000000000..2d8c85640
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/IotProductController.java
@@ -0,0 +1,132 @@
+package cn.iocoder.yudao.module.iot.controller.admin.product;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.product.vo.product.IotProductPageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.product.vo.product.IotProductRespVO;
+import cn.iocoder.yudao.module.iot.controller.admin.product.vo.product.IotProductSaveReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductCategoryDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO;
+import cn.iocoder.yudao.module.iot.service.product.IotProductCategoryService;
+import cn.iocoder.yudao.module.iot.service.product.IotProductService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum.EXPORT;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - IoT 产品")
+@RestController
+@RequestMapping("/iot/product")
+@Validated
+public class IotProductController {
+
+ @Resource
+ private IotProductService productService;
+ @Resource
+ private IotProductCategoryService categoryService;
+
+ @PostMapping("/create")
+ @Operation(summary = "创建产品")
+ @PreAuthorize("@ss.hasPermission('iot:product:create')")
+ public CommonResult createProduct(@Valid @RequestBody IotProductSaveReqVO createReqVO) {
+ return success(productService.createProduct(createReqVO));
+ }
+
+ @PutMapping("/update")
+ @Operation(summary = "更新产品")
+ @PreAuthorize("@ss.hasPermission('iot:product:update')")
+ public CommonResult updateProduct(@Valid @RequestBody IotProductSaveReqVO updateReqVO) {
+ productService.updateProduct(updateReqVO);
+ return success(true);
+ }
+
+ @PutMapping("/update-status")
+ @Operation(summary = "更新产品状态")
+ @Parameter(name = "id", description = "编号", required = true)
+ @Parameter(name = "status", description = "状态", required = true)
+ @PreAuthorize("@ss.hasPermission('iot:product:update')")
+ public CommonResult updateProductStatus(@RequestParam("id") Long id,
+ @RequestParam("status") Integer status) {
+ productService.updateProductStatus(id, status);
+ return success(true);
+ }
+
+ @DeleteMapping("/delete")
+ @Operation(summary = "删除产品")
+ @Parameter(name = "id", description = "编号", required = true)
+ @PreAuthorize("@ss.hasPermission('iot:product:delete')")
+ public CommonResult deleteProduct(@RequestParam("id") Long id) {
+ productService.deleteProduct(id);
+ return success(true);
+ }
+
+ @GetMapping("/get")
+ @Operation(summary = "获得产品")
+ @Parameter(name = "id", description = "编号", required = true, example = "1024")
+ @PreAuthorize("@ss.hasPermission('iot:product:query')")
+ public CommonResult getProduct(@RequestParam("id") Long id) {
+ IotProductDO product = productService.getProduct(id);
+ // 拼接数据
+ IotProductCategoryDO category = categoryService.getProductCategory(product.getCategoryId());
+ return success(BeanUtils.toBean(product, IotProductRespVO.class, bean -> {
+ if (category != null) {
+ bean.setCategoryName(category.getName());
+ }
+ }));
+ }
+
+ @GetMapping("/page")
+ @Operation(summary = "获得产品分页")
+ @PreAuthorize("@ss.hasPermission('iot:product:query')")
+ public CommonResult> getProductPage(@Valid IotProductPageReqVO pageReqVO) {
+ PageResult pageResult = productService.getProductPage(pageReqVO);
+ // 拼接数据
+ Map categoryMap = categoryService.getProductCategoryMap(
+ convertList(pageResult.getList(), IotProductDO::getCategoryId));
+ return success(BeanUtils.toBean(pageResult, IotProductRespVO.class, bean -> {
+ MapUtils.findAndThen(categoryMap, bean.getCategoryId(),
+ category -> bean.setCategoryName(category.getName()));
+ }));
+ }
+
+ @GetMapping("/export-excel")
+ @Operation(summary = "导出产品 Excel")
+ @PreAuthorize("@ss.hasPermission('iot:product:export')")
+ @ApiAccessLog(operateType = EXPORT)
+ public void exportProductExcel(@Valid IotProductPageReqVO exportReqVO,
+ HttpServletResponse response) throws IOException {
+ exportReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+ CommonResult> result = getProductPage(exportReqVO);
+ // 导出 Excel
+ ExcelUtils.write(response, "产品.xls", "数据", IotProductRespVO.class,
+ result.getData().getList());
+ }
+
+ @GetMapping("/simple-list")
+ @Operation(summary = "获取产品的精简信息列表", description = "主要用于前端的下拉选项")
+ public CommonResult> getSimpleProductList() {
+ List list = productService.getProductList();
+ return success(convertList(list, product -> // 只返回 id、name 字段
+ new IotProductRespVO().setId(product.getId()).setName(product.getName())
+ .setDeviceType(product.getDeviceType())));
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/category/IotProductCategoryPageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/category/IotProductCategoryPageReqVO.java
new file mode 100644
index 000000000..f1c12bf7c
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/category/IotProductCategoryPageReqVO.java
@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.iot.controller.admin.product.vo.category;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - IoT 产品分类分页 Request VO")
+@Data
+public class IotProductCategoryPageReqVO extends PageParam {
+
+ @Schema(description = "分类名字", example = "王五")
+ private String name;
+
+ @Schema(description = "创建时间")
+ @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+ private LocalDateTime[] createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/category/IotProductCategoryRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/category/IotProductCategoryRespVO.java
new file mode 100644
index 000000000..d684b0215
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/category/IotProductCategoryRespVO.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.iot.controller.admin.product.vo.category;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.module.system.enums.DictTypeConstants;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - IoT 产品分类 Response VO")
+@Data
+public class IotProductCategoryRespVO {
+
+ @Schema(description = "分类 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "25284")
+ private Long id;
+
+ @Schema(description = "分类名字", requiredMode = Schema.RequiredMode.REQUIRED, example = "王五")
+ private String name;
+
+ @Schema(description = "分类排序")
+ private Integer sort;
+
+ @Schema(description = "分类状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @DictFormat(DictTypeConstants.COMMON_STATUS)
+ private Integer status;
+
+ @Schema(description = "分类描述", example = "随便")
+ private String description;
+
+ @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+ private LocalDateTime createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/category/IotProductCategorySaveReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/category/IotProductCategorySaveReqVO.java
new file mode 100644
index 000000000..a7b2fe427
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/category/IotProductCategorySaveReqVO.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.iot.controller.admin.product.vo.category;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 产品分类新增/修改 Request VO")
+@Data
+public class IotProductCategorySaveReqVO {
+
+ @Schema(description = "分类 ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "25284")
+ private Long id;
+
+ @Schema(description = "分类名字", requiredMode = Schema.RequiredMode.REQUIRED, example = "王五")
+ @NotEmpty(message = "分类名字不能为空")
+ private String name;
+
+ @Schema(description = "分类排序")
+ private Integer sort;
+
+ @Schema(description = "分类状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @NotNull(message = "分类状态不能为空")
+ private Integer status;
+
+ @Schema(description = "分类描述", example = "随便")
+ private String description;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/product/IotProductPageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/product/IotProductPageReqVO.java
new file mode 100644
index 000000000..18c69c4ce
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/product/IotProductPageReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.iot.controller.admin.product.vo.product;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - IoT 产品分页 Request VO")
+@Data
+public class IotProductPageReqVO extends PageParam {
+
+ @Schema(description = "产品名称", example = "李四")
+ private String name;
+
+ @Schema(description = "产品标识")
+ private String productKey;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/product/IotProductRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/product/IotProductRespVO.java
new file mode 100644
index 000000000..f674651d5
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/product/IotProductRespVO.java
@@ -0,0 +1,87 @@
+package cn.iocoder.yudao.module.iot.controller.admin.product.vo.product;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.iot.enums.DictTypeConstants;
+import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
+import com.alibaba.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - IoT 产品 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class IotProductRespVO {
+
+ @Schema(description = "产品编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "26087")
+ @ExcelProperty("产品编号")
+ private Long id;
+
+ @Schema(description = "产品名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "李四")
+ @ExcelProperty("产品名称")
+ private String name;
+
+ @Schema(description = "产品标识", requiredMode = Schema.RequiredMode.REQUIRED)
+ @ExcelProperty("产品标识")
+ private String productKey;
+
+ @Schema(description = "产品分类编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ private Long categoryId;
+
+ @Schema(description = "产品分类名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @ExcelProperty("产品分类")
+ private String categoryName;
+
+ @Schema(description = "产品图标", example = "https://iocoder.cn/1.svg")
+ @ExcelProperty("产品图标")
+ private String icon;
+
+ @Schema(description = "产品图片", example = "https://iocoder.cn/1.png")
+ @ExcelProperty("产品图片")
+ private String picUrl;
+
+ @Schema(description = "产品描述", example = "你猜")
+ @ExcelProperty("产品描述")
+ private String description;
+
+ @Schema(description = "产品状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @ExcelProperty(value = "产品状态", converter = DictConvert.class)
+ @DictFormat(DictTypeConstants.PRODUCT_STATUS)
+ private Integer status;
+
+ @Schema(description = "设备类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+ @ExcelProperty(value = "设备类型", converter = DictConvert.class)
+ @DictFormat(DictTypeConstants.PRODUCT_DEVICE_TYPE)
+ private Integer deviceType;
+
+ @Schema(description = "联网方式", example = "2")
+ @ExcelProperty(value = "联网方式", converter = DictConvert.class)
+ @DictFormat(DictTypeConstants.NET_TYPE)
+ private Integer netType;
+
+ @Schema(description = "接入网关协议", example = "2")
+ @ExcelProperty(value = "接入网关协议", converter = DictConvert.class)
+ @DictFormat(DictTypeConstants.PROTOCOL_TYPE)
+ private Integer protocolType;
+
+ @Schema(description = "协议编号（脚本解析 id）", requiredMode = Schema.RequiredMode.REQUIRED, example = "13177")
+ @ExcelProperty("协议编号（脚本解析 id）")
+ private Long protocolId;
+
+ @Schema(description = "数据格式")
+ @ExcelProperty(value = "数据格式", converter = DictConvert.class)
+ @DictFormat(DictTypeConstants.DATA_FORMAT)
+ private Integer dataFormat;
+
+ @Schema(description = "数据校验级别", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @ExcelProperty(value = "数据校验级别", converter = DictConvert.class)
+ @DictFormat(DictTypeConstants.VALIDATE_TYPE)
+ private Integer validateType;
+
+ @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+ @ExcelProperty("创建时间")
+ private LocalDateTime createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/product/IotProductSaveReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/product/IotProductSaveReqVO.java
new file mode 100644
index 000000000..268ab7c6f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/product/vo/product/IotProductSaveReqVO.java
@@ -0,0 +1,60 @@
+package cn.iocoder.yudao.module.iot.controller.admin.product.vo.product;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.product.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 产品新增/修改 Request VO")
+@Data
+public class IotProductSaveReqVO {
+
+ @Schema(description = "产品编号", requiredMode = Schema.RequiredMode.AUTO, example = "1")
+ private Long id;
+
+ @Schema(description = "产品名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "温湿度")
+ @NotEmpty(message = "产品名称不能为空")
+ private String name;
+
+ @Schema(description = "产品 Key", requiredMode = Schema.RequiredMode.AUTO, example = "12345abc")
+ private String productKey;
+
+ @Schema(description = "产品分类编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @NotNull(message = "产品分类编号不能为空")
+ private Long categoryId;
+
+ @Schema(description = "产品图标", example = "https://iocoder.cn/1.svg")
+ private String icon;
+
+ @Schema(description = "产品图片", example = "https://iocoder.cn/1.png")
+ private String picUrl;
+
+ @Schema(description = "产品描述", example = "描述")
+ private String description;
+
+ @Schema(description = "设备类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+ @InEnum(value = IotProductDeviceTypeEnum.class, message = "设备类型必须是 {value}")
+ @NotNull(message = "设备类型不能为空")
+ private Integer deviceType;
+
+ @Schema(description = "联网方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+ @InEnum(value = IotNetTypeEnum.class, message = "联网方式必须是 {value}")
+ private Integer netType;
+
+ @Schema(description = "接入网关协议", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+ @InEnum(value = IotProtocolTypeEnum.class, message = "接入网关协议必须是 {value}")
+ private Integer protocolType;
+
+ @Schema(description = "数据格式", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+ @InEnum(value = IotDataFormatEnum.class, message = "数据格式必须是 {value}")
+ @NotNull(message = "数据格式不能为空")
+ private Integer dataFormat;
+
+ @Schema(description = "数据校验级别", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+ @InEnum(value = IotValidateTypeEnum.class, message = "数据校验级别必须是 {value}")
+ @NotNull(message = "数据校验级别不能为空")
+ private Integer validateType;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/IotDataBridgeController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/IotDataBridgeController.java
new file mode 100644
index 000000000..95e50a4a2
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/IotDataBridgeController.java
@@ -0,0 +1,72 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.IotDataBridgePageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.IotDataBridgeRespVO;
+import cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.IotDataBridgeSaveReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.rule.IotDataBridgeDO;
+import cn.iocoder.yudao.module.iot.service.rule.IotDataBridgeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - IoT 数据桥梁")
+@RestController
+@RequestMapping("/iot/data-bridge")
+@Validated
+public class IotDataBridgeController {
+
+ @Resource
+ private IotDataBridgeService dataBridgeService;
+
+ @PostMapping("/create")
+ @Operation(summary = "创建数据桥梁")
+ @PreAuthorize("@ss.hasPermission('iot:data-bridge:create')")
+ public CommonResult createDataBridge(@Valid @RequestBody IotDataBridgeSaveReqVO createReqVO) {
+ return success(dataBridgeService.createDataBridge(createReqVO));
+ }
+
+ @PutMapping("/update")
+ @Operation(summary = "更新数据桥梁")
+ @PreAuthorize("@ss.hasPermission('iot:data-bridge:update')")
+ public CommonResult updateDataBridge(@Valid @RequestBody IotDataBridgeSaveReqVO updateReqVO) {
+ dataBridgeService.updateDataBridge(updateReqVO);
+ return success(true);
+ }
+
+ @DeleteMapping("/delete")
+ @Operation(summary = "删除数据桥梁")
+ @Parameter(name = "id", description = "编号", required = true)
+ @PreAuthorize("@ss.hasPermission('iot:data-bridge:delete')")
+ public CommonResult deleteDataBridge(@RequestParam("id") Long id) {
+ dataBridgeService.deleteDataBridge(id);
+ return success(true);
+ }
+
+ @GetMapping("/get")
+ @Operation(summary = "获得数据桥梁")
+ @Parameter(name = "id", description = "编号", required = true, example = "1024")
+ @PreAuthorize("@ss.hasPermission('iot:data-bridge:query')")
+ public CommonResult getDataBridge(@RequestParam("id") Long id) {
+ IotDataBridgeDO dataBridge = dataBridgeService.getDataBridge(id);
+ return success(BeanUtils.toBean(dataBridge, IotDataBridgeRespVO.class));
+ }
+
+ @GetMapping("/page")
+ @Operation(summary = "获得数据桥梁分页")
+ @PreAuthorize("@ss.hasPermission('iot:data-bridge:query')")
+ public CommonResult> getDataBridgePage(@Valid IotDataBridgePageReqVO pageReqVO) {
+ PageResult pageResult = dataBridgeService.getDataBridgePage(pageReqVO);
+ return success(BeanUtils.toBean(pageResult, IotDataBridgeRespVO.class));
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/IotRuleSceneController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/IotRuleSceneController.java
new file mode 100644
index 000000000..04e2f4570
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/IotRuleSceneController.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule;
+
+import cn.iocoder.yudao.module.iot.service.rule.IotRuleSceneService;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.annotation.security.PermitAll;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@Tag(name = "管理后台 - IoT 规则场景")
+@RestController
+@RequestMapping("/iot/rule-scene")
+@Validated
+public class IotRuleSceneController {
+
+ @Resource
+ private IotRuleSceneService ruleSceneService;
+
+ @GetMapping("/test")
+ @PermitAll
+ public void test() {
+ ruleSceneService.test();
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/IotDataBridgePageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/IotDataBridgePageReqVO.java
new file mode 100644
index 000000000..e4dc36ef9
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/IotDataBridgePageReqVO.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - IoT 数据桥梁分页 Request VO")
+@Data
+public class IotDataBridgePageReqVO extends PageParam {
+
+ @Schema(description = "桥梁名称", example = "赵六")
+ private String name;
+
+ @Schema(description = "桥梁状态", example = "1")
+ @InEnum(CommonStatusEnum.class)
+ private Integer status;
+
+ @Schema(description = "创建时间")
+ @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+ private LocalDateTime[] createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/IotDataBridgeRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/IotDataBridgeRespVO.java
new file mode 100644
index 000000000..38e04b2eb
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/IotDataBridgeRespVO.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge;
+
+import cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.config.IotDataBridgeAbstractConfig;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - IoT 数据桥梁 Response VO")
+@Data
+public class IotDataBridgeRespVO {
+
+ @Schema(description = "桥梁编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "18564")
+ private Long id;
+
+ @Schema(description = "桥梁名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "赵六")
+ private String name;
+
+ @Schema(description = "桥梁描述", example = "随便")
+ private String description;
+
+ @Schema(description = "桥梁状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ private Integer status;
+
+ @Schema(description = "桥梁方向", requiredMode = Schema.RequiredMode.REQUIRED)
+ private Integer direction;
+
+ @Schema(description = "桥梁类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ private Integer type;
+
+ @Schema(description = "桥梁配置")
+ private IotDataBridgeAbstractConfig config;
+
+ @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+ private LocalDateTime createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/IotDataBridgeSaveReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/IotDataBridgeSaveReqVO.java
new file mode 100644
index 000000000..8441701af
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/IotDataBridgeSaveReqVO.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.config.IotDataBridgeAbstractConfig;
+import cn.iocoder.yudao.module.iot.enums.rule.IotDataBridgeDirectionEnum;
+import cn.iocoder.yudao.module.iot.enums.rule.IotDataBridgeTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 数据桥梁新增/修改 Request VO")
+@Data
+public class IotDataBridgeSaveReqVO {
+
+ @Schema(description = "桥梁编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "18564")
+ private Long id;
+
+ @Schema(description = "桥梁名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "赵六")
+ @NotEmpty(message = "桥梁名称不能为空")
+ private String name;
+
+ @Schema(description = "桥梁描述", example = "随便")
+ private String description;
+
+ @Schema(description = "桥梁状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+ @NotNull(message = "桥梁状态不能为空")
+ @InEnum(CommonStatusEnum.class)
+ private Integer status;
+
+ @Schema(description = "桥梁方向", requiredMode = Schema.RequiredMode.REQUIRED)
+ @NotNull(message = "桥梁方向不能为空")
+ @InEnum(IotDataBridgeDirectionEnum.class)
+ private Integer direction;
+
+ @Schema(description = "桥梁类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @NotNull(message = "桥梁类型不能为空")
+ @InEnum(IotDataBridgeTypeEnum.class)
+ private Integer type;
+
+ @Schema(description = "桥梁配置")
+ @NotNull(message = "桥梁配置不能为空")
+ private IotDataBridgeAbstractConfig config;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeAbstractConfig.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeAbstractConfig.java
new file mode 100644
index 000000000..527e79b35
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeAbstractConfig.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.config;
+
+import cn.iocoder.yudao.module.iot.enums.rule.IotDataBridgeTypeEnum;
+import com.fasterxml.jackson.annotation.JsonSubTypes;
+import com.fasterxml.jackson.annotation.JsonTypeInfo;
+import lombok.Data;
+
+/**
+ * IoT IotDataBridgeConfig 抽象类
+ *
+ * 用于表示数据桥梁配置数据的通用类型，根据具体的 "type" 字段动态映射到对应的子类
+ * 提供多态支持，适用于不同类型的数据结构序列化和反序列化场景。
+ *
+ * @author HUIHUI
+ */
+@Data
+@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, property = "type", visible = true)
+@JsonSubTypes({
+ @JsonSubTypes.Type(value = IotDataBridgeHttpConfig.class, name = "1"),
+ @JsonSubTypes.Type(value = IotDataBridgeMqttConfig.class, name = "10"),
+ @JsonSubTypes.Type(value = IotDataBridgeRedisStreamMQConfig.class, name = "21"),
+ @JsonSubTypes.Type(value = IotDataBridgeRocketMQConfig.class, name = "30"),
+ @JsonSubTypes.Type(value = IotDataBridgeRabbitMQConfig.class, name = "31"),
+ @JsonSubTypes.Type(value = IotDataBridgeKafkaMQConfig.class, name = "32"),
+})
+public abstract class IotDataBridgeAbstractConfig {
+
+ /**
+ * 配置类型
+ *
+ * 枚举 {@link IotDataBridgeTypeEnum#getType()}
+ */
+ private String type;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeHttpConfig.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeHttpConfig.java
new file mode 100644
index 000000000..eca35c76e
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeHttpConfig.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.config;
+
+import lombok.Data;
+
+import java.util.Map;
+
+/**
+ * IoT HTTP 配置 {@link IotDataBridgeAbstractConfig} 实现类
+ *
+ * @author HUIHUI
+ */
+@Data
+public class IotDataBridgeHttpConfig extends IotDataBridgeAbstractConfig {
+
+ /**
+ * 请求 URL
+ */
+ private String url;
+ /**
+ * 请求方法
+ */
+ private String method;
+ /**
+ * 请求头
+ */
+ private Map headers;
+ /**
+ * 请求参数
+ */
+ private Map query;
+ /**
+ * 请求体
+ */
+ private String body;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeKafkaMQConfig.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeKafkaMQConfig.java
new file mode 100644
index 000000000..1201214d1
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeKafkaMQConfig.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.config;
+
+import lombok.Data;
+
+/**
+ * IoT Kafka 配置 {@link IotDataBridgeAbstractConfig} 实现类
+ *
+ * @author HUIHUI
+ */
+@Data
+public class IotDataBridgeKafkaMQConfig extends IotDataBridgeAbstractConfig {
+
+ /**
+ * Kafka 服务器地址
+ */
+ private String bootstrapServers;
+ /**
+ * 用户名
+ */
+ private String username;
+ /**
+ * 密码
+ */
+ private String password;
+ /**
+ * 是否启用 SSL
+ */
+ private Boolean ssl;
+
+ /**
+ * 主题
+ */
+ private String topic;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeMqttConfig.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeMqttConfig.java
new file mode 100644
index 000000000..448b21501
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeMqttConfig.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.config;
+
+import lombok.Data;
+
+/**
+ * IoT MQTT 配置 {@link IotDataBridgeAbstractConfig} 实现类
+ *
+ * @author HUIHUI
+ */
+@Data
+public class IotDataBridgeMqttConfig extends IotDataBridgeAbstractConfig {
+
+ /**
+ * MQTT 服务器地址
+ */
+ private String url;
+ /**
+ * 用户名
+ */
+ private String username;
+ /**
+ * 密码
+ */
+ private String password;
+ /**
+ * 客户端编号
+ */
+ private String clientId;
+ /**
+ * 主题
+ */
+ private String topic;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeRabbitMQConfig.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeRabbitMQConfig.java
new file mode 100644
index 000000000..2c247d1d5
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeRabbitMQConfig.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.config;
+
+import lombok.Data;
+
+/**
+ * IoT RabbitMQ 配置 {@link IotDataBridgeAbstractConfig} 实现类
+ *
+ * @author HUIHUI
+ */
+@Data
+public class IotDataBridgeRabbitMQConfig extends IotDataBridgeAbstractConfig {
+
+ /**
+ * RabbitMQ 服务器地址
+ */
+ private String host;
+ /**
+ * 端口
+ */
+ private Integer port;
+ /**
+ * 虚拟主机
+ */
+ private String virtualHost;
+ /**
+ * 用户名
+ */
+ private String username;
+ /**
+ * 密码
+ */
+ private String password;
+
+ /**
+ * 交换机名称
+ */
+ private String exchange;
+ /**
+ * 路由键
+ */
+ private String routingKey;
+ /**
+ * 队列名称
+ */
+ private String queue;
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeRedisStreamMQConfig.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeRedisStreamMQConfig.java
new file mode 100644
index 000000000..3c9bb330f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeRedisStreamMQConfig.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.config;
+
+import lombok.Data;
+
+// TODO @puhui999：MQ 可以去掉哈。stream 更精准
+/**
+ * IoT Redis Stream 配置 {@link IotDataBridgeAbstractConfig} 实现类
+ *
+ * @author HUIHUI
+ */
+@Data
+public class IotDataBridgeRedisStreamMQConfig extends IotDataBridgeAbstractConfig {
+
+ /**
+ * Redis 服务器地址
+ */
+ private String host;
+ /**
+ * 端口
+ */
+ private Integer port;
+ /**
+ * 密码
+ */
+ private String password;
+ /**
+ * 数据库索引
+ */
+ private Integer database;
+
+ /**
+ * 主题
+ */
+ private String topic;
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeRocketMQConfig.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeRocketMQConfig.java
new file mode 100644
index 000000000..e23e3061a
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/databridge/config/IotDataBridgeRocketMQConfig.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.config;
+
+import lombok.Data;
+
+/**
+ * IoT RocketMQ 配置 {@link IotDataBridgeAbstractConfig} 实现类
+ *
+ * @author HUIHUI
+ */
+@Data
+public class IotDataBridgeRocketMQConfig extends IotDataBridgeAbstractConfig {
+
+ /**
+ * RocketMQ 名称服务器地址
+ */
+ private String nameServer;
+ /**
+ * 访问密钥
+ */
+ private String accessKey;
+ /**
+ * 秘密钥匙
+ */
+ private String secretKey;
+
+ /**
+ * 生产者组
+ */
+ private String group;
+ /**
+ * 主题
+ */
+ private String topic;
+ /**
+ * 标签
+ */
+ private String tags;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/package-info.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/package-info.java
new file mode 100644
index 000000000..f397e0acd
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/rule/vo/package-info.java
@@ -0,0 +1,2 @@
+// TODO @芋艿：占位
+package cn.iocoder.yudao.module.iot.controller.admin.rule.vo;
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/IotStatisticsController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/IotStatisticsController.java
new file mode 100644
index 000000000..a9c195656
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/IotStatisticsController.java
@@ -0,0 +1,79 @@
+package cn.iocoder.yudao.module.iot.controller.admin.statistics;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.iot.controller.admin.statistics.vo.IotStatisticsDeviceMessageSummaryRespVO;
+import cn.iocoder.yudao.module.iot.controller.admin.statistics.vo.IotStatisticsReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.statistics.vo.IotStatisticsSummaryRespVO;
+import cn.iocoder.yudao.module.iot.enums.device.IotDeviceStateEnum;
+import cn.iocoder.yudao.module.iot.service.device.IotDeviceService;
+import cn.iocoder.yudao.module.iot.service.device.data.IotDeviceLogService;
+import cn.iocoder.yudao.module.iot.service.product.IotProductCategoryService;
+import cn.iocoder.yudao.module.iot.service.product.IotProductService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDateTime;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.*;
+
+@Tag(name = "管理后台 - IoT 数据统计")
+@RestController
+@RequestMapping("/iot/statistics")
+@Validated
+public class IotStatisticsController {
+
+ @Resource
+ private IotDeviceService deviceService;
+ @Resource
+ private IotProductCategoryService productCategoryService;
+ @Resource
+ private IotProductService productService;
+ @Resource
+ private IotDeviceLogService deviceLogService;
+
+ @GetMapping("/get-summary")
+ @Operation(summary = "获取 IoT 数据统计")
+ public CommonResult getIotStatisticsSummary(){
+ IotStatisticsSummaryRespVO respVO = new IotStatisticsSummaryRespVO();
+ // 1.1 获取总数
+ respVO.setProductCategoryCount(productCategoryService.getProductCategoryCount(null));
+ respVO.setProductCount(productService.getProductCount(null));
+ respVO.setDeviceCount(deviceService.getDeviceCount(null));
+ respVO.setDeviceMessageCount(deviceLogService.getDeviceLogCount(null));
+ // 1.2 获取今日新增数量
+ // TODO @super：使用 LocalDateTimeUtils.getToday()
+ LocalDateTime todayStart = LocalDateTime.now().withHour(0).withMinute(0).withSecond(0);
+ respVO.setProductCategoryTodayCount(productCategoryService.getProductCategoryCount(todayStart));
+ respVO.setProductTodayCount(productService.getProductCount(todayStart));
+ respVO.setDeviceTodayCount(deviceService.getDeviceCount(todayStart));
+ respVO.setDeviceMessageTodayCount(deviceLogService.getDeviceLogCount(todayStart));
+
+ // 2. 获取各个品类下设备数量统计
+ respVO.setProductCategoryDeviceCounts(productCategoryService.getProductCategoryDeviceCountMap());
+
+ // 3. 获取设备状态数量统计
+ Map deviceCountMap = deviceService.getDeviceCountMapByState();
+ respVO.setDeviceOnlineCount(deviceCountMap.getOrDefault(IotDeviceStateEnum.ONLINE.getState(), 0L));
+ respVO.setDeviceOfflineCount(deviceCountMap.getOrDefault(IotDeviceStateEnum.OFFLINE.getState(), 0L));
+ respVO.setDeviceInactiveCount(deviceCountMap.getOrDefault(IotDeviceStateEnum.INACTIVE.getState(), 0L));
+ return success(respVO);
+ }
+
+ // TODO @super：要不干掉 IotStatisticsReqVO 参数，直接使用 @RequestParam 接收，简单一些。
+ @GetMapping("/get-log-summary")
+ @Operation(summary = "获取 IoT 设备上下行消息数据统计")
+ public CommonResult getIotStatisticsDeviceMessageSummary(
+ @Valid IotStatisticsReqVO reqVO) {
+ return success(new IotStatisticsDeviceMessageSummaryRespVO()
+ .setDownstreamCounts(deviceLogService.getDeviceLogUpCountByHour(null, reqVO.getStartTime(), reqVO.getEndTime()))
+ .setDownstreamCounts((deviceLogService.getDeviceLogDownCountByHour(null, reqVO.getStartTime(), reqVO.getEndTime()))));
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/vo/IotStatisticsDeviceMessageSummaryRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/vo/IotStatisticsDeviceMessageSummaryRespVO.java
new file mode 100644
index 000000000..15d2abccc
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/vo/IotStatisticsDeviceMessageSummaryRespVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.iot.controller.admin.statistics.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+@Schema(description = "管理后台 - IoT 设备上下行消息数量统计 Response VO")
+@Data
+public class IotStatisticsDeviceMessageSummaryRespVO {
+
+ @Schema(description = "每小时上行数据数量统计")
+ private List> upstreamCounts;
+
+ @Schema(description = "每小时下行数据数量统计")
+ private List> downstreamCounts;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/vo/IotStatisticsReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/vo/IotStatisticsReqVO.java
new file mode 100644
index 000000000..741f77f3a
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/vo/IotStatisticsReqVO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.iot.controller.admin.statistics.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 统计 Request VO")
+@Data
+public class IotStatisticsReqVO {
+
+ // TODO @super：前端传递的时候，还是通过 startTime 和 endTime 传递。后端转成 Long
+
+ @Schema(description = "查询起始时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "1658486600000")
+ @NotNull(message = "查询起始时间不能为空")
+ private Long startTime;
+
+ @Schema(description = "查询结束时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "1758486600000")
+ @NotNull(message = "查询结束时间不能为空")
+ private Long endTime;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/vo/IotStatisticsSummaryRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/vo/IotStatisticsSummaryRespVO.java
new file mode 100644
index 000000000..21745c4ab
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/statistics/vo/IotStatisticsSummaryRespVO.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.iot.controller.admin.statistics.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.Map;
+
+/**
+ * 管理后台 - IoT 统计 Response VO
+ */
+@Schema(description = "管理后台 - IoT 统计 Response VO")
+@Data
+public class IotStatisticsSummaryRespVO {
+
+ @Schema(description = "品类数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+ private Long productCategoryCount;
+
+ @Schema(description = "产品数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "20")
+ private Long productCount;
+
+ @Schema(description = "设备数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+ private Long deviceCount;
+
+ @Schema(description = "上报数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1000")
+ private Long deviceMessageCount;
+
+ @Schema(description = "今日新增品类数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+ private Long productCategoryTodayCount;
+
+ @Schema(description = "今日新增产品数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "20")
+ private Long productTodayCount;
+
+ @Schema(description = "今日新增设备数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+ private Long deviceTodayCount;
+
+ @Schema(description = "今日新增上报数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1000")
+ private Long deviceMessageTodayCount;
+
+ @Schema(description = "在线数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "80")
+ private Long deviceOnlineCount;
+
+ @Schema(description = "离线数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "15")
+ private Long deviceOfflineCount;
+
+ @Schema(description = "待激活设备数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "5")
+ private Long deviceInactiveCount;
+
+ @Schema(description = "按品类统计的设备数量")
+ private Map productCategoryDeviceCounts;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/IotThingModelController.http b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/IotThingModelController.http
new file mode 100644
index 000000000..1e1f72103
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/IotThingModelController.http
@@ -0,0 +1,181 @@
+### 请求 /iot/product-thing-model/create 接口 => 成功
+POST {{baseUrl}}/iot/product-thing-model/create
+Content-Type: application/json
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+{
+ "productId": 12,
+ "productKey": "CJVS54fObwZJ9Qe5CJVS54fObwZJ9Qe5",
+ "identifier": "Temperature",
+ "name": "温度",
+ "description": "当前温度值",
+ "type": 1,
+ "property": {
+ "identifier": "Temperature",
+ "name": "温度",
+ "accessMode": "r",
+ "required": true,
+ "dataType": "int",
+ "dataSpecs": {
+ "dataType": "int",
+ "max": "200",
+ "min": "0",
+ "step": "10",
+ "defaultValue": "30",
+ "unit": "%",
+ "unitName": "百分比"
+ }
+ }
+}
+
+### 请求 /iot/product-thing-model/create 接口 => 成功
+POST {{baseUrl}}/iot/product-thing-model/create
+Content-Type: application/json
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+{
+ "productId": 12,
+ "productKey": "CJVS54fObwZJ9Qe5CJVS54fObwZJ9Qe5",
+ "identifier": "switch",
+ "name": "开关",
+ "description": "温度计开关",
+ "type": 1,
+ "property": {
+ "identifier": "switch",
+ "name": "开关",
+ "accessMode": "rw",
+ "required": true,
+ "dataType": "bool",
+ "dataSpecsList": [
+ {
+ "dataType": "bool",
+ "name": "关",
+ "value": 0
+ },
+ {
+ "dataType": "bool",
+ "name": "开",
+ "value": 1
+ }
+ ]
+ }
+}
+
+### 请求 /iot/product-thing-model/create 接口 => 成功
+POST {{baseUrl}}/iot/product-thing-model/create
+Content-Type: application/json
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+{
+ "productId": 12,
+ "productKey": "CJVS54fObwZJ9Qe5CJVS54fObwZJ9Qe5",
+ "identifier": "argb",
+ "name": "温度计 argb 颜色",
+ "description": "温度计 argb 颜色",
+ "type": 1,
+ "property": {
+ "identifier": "argb",
+ "name": "温度计 argb 颜色",
+ "accessMode": "rw",
+ "required": true,
+ "dataType": "array",
+ "dataSpecs": {
+ "dataType": "array",
+ "size": 10,
+ "childDataType": "struct",
+ "dataSpecsList": [
+ {
+ "identifier": "switch",
+ "name": "开关",
+ "accessMode": "rw",
+ "required": true,
+ "dataType": "struct",
+ "childDataType": "bool",
+ "dataSpecsList": [
+ {
+ "dataType": "bool",
+ "name": "关",
+ "value": 0
+ },
+ {
+ "dataType": "bool",
+ "name": "开",
+ "value": 1
+ }
+ ]
+ },
+ {
+ "identifier": "Temperature",
+ "name": "温度",
+ "accessMode": "r",
+ "required": true,
+ "dataType": "struct",
+ "childDataType": "int",
+ "dataSpecs": {
+ "dataType": "int",
+ "max": "200",
+ "min": "0",
+ "step": "10",
+ "defaultValue": "30",
+ "unit": "%",
+ "unitName": "百分比"
+ }
+ }
+ ]
+ }
+ }
+}
+
+### 请求 /iot/product-thing-model/update 接口 => 成功
+PUT {{baseUrl}}/iot/product-thing-model/update
+Content-Type: application/json
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+{
+ "id": 33,
+ "productId": 12,
+ "productKey": "CJVS54fObwZJ9Qe5CJVS54fObwZJ9Qe5",
+ "identifier": "switch",
+ "name": "开关",
+ "description": "温度计开关",
+ "type": 1,
+ "property": {
+ "identifier": "switch",
+ "name": "开关",
+ "accessMode": "r",
+ "required": true,
+ "dataType": "bool",
+ "dataSpecsList": [
+ {
+ "dataType": "bool",
+ "name": "关",
+ "value": 0
+ },
+ {
+ "dataType": "bool",
+ "name": "开",
+ "value": 1
+ }
+ ]
+ }
+}
+
+### 请求 /iot/product-thing-model/delete 接口 => 成功
+DELETE {{baseUrl}}/iot/product-thing-model/delete?id=36
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+### 请求 /iot/product-thing-model/get 接口 => 成功
+GET {{baseUrl}}/iot/product-thing-model/get?id=67
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
+
+
+### 请求 /iot/product-thing-model/list-by-product-id 接口 => 成功
+GET {{baseUrl}}/iot/product-thing-model/list-by-product-id?productId=1001
+tenant-id: {{adminTenentId}}
+Authorization: Bearer {{token}}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/IotThingModelController.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/IotThingModelController.java
new file mode 100644
index 000000000..382940fc4
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/IotThingModelController.java
@@ -0,0 +1,93 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.vo.IotThingModelListReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.vo.IotThingModelPageReqVO;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.vo.IotThingModelRespVO;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.vo.IotThingModelSaveReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.thingmodel.IotThingModelDO;
+import cn.iocoder.yudao.module.iot.service.thingmodel.IotThingModelService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - IoT 产品物模型")
+@RestController
+@RequestMapping("/iot/thing-model")
+@Validated
+public class IotThingModelController {
+
+ @Resource
+ private IotThingModelService thingModelService;
+
+ @PostMapping("/create")
+ @Operation(summary = "创建产品物模型")
+ @PreAuthorize("@ss.hasPermission('iot:thing-model:create')")
+ public CommonResult createThingModel(@Valid @RequestBody IotThingModelSaveReqVO createReqVO) {
+ return success(thingModelService.createThingModel(createReqVO));
+ }
+
+ @PutMapping("/update")
+ @Operation(summary = "更新产品物模型")
+ @PreAuthorize("@ss.hasPermission('iot:thing-model:update')")
+ public CommonResult updateThingModel(@Valid @RequestBody IotThingModelSaveReqVO updateReqVO) {
+ thingModelService.updateThingModel(updateReqVO);
+ return success(true);
+ }
+
+ @DeleteMapping("/delete")
+ @Operation(summary = "删除产品物模型")
+ @Parameter(name = "id", description = "编号", required = true)
+ @PreAuthorize("@ss.hasPermission('iot:thing-model:delete')")
+ public CommonResult deleteThingModel(@RequestParam("id") Long id) {
+ thingModelService.deleteThingModel(id);
+ return success(true);
+ }
+
+ @GetMapping("/get")
+ @Operation(summary = "获得产品物模型")
+ @Parameter(name = "id", description = "编号", required = true)
+ @PreAuthorize("@ss.hasPermission('iot:thing-model:query')")
+ public CommonResult getThingModel(@RequestParam("id") Long id) {
+ IotThingModelDO thingModel = thingModelService.getThingModel(id);
+ return success(BeanUtils.toBean(thingModel, IotThingModelRespVO.class));
+ }
+
+ @GetMapping("/list-by-product-id")
+ @Operation(summary = "获得产品物模型")
+ @Parameter(name = "productId", description = "产品ID", required = true, example = "1024")
+ @PreAuthorize("@ss.hasPermission('iot:thing-model:query')")
+ public CommonResult> getThingModelListByProductId(@RequestParam("productId") Long productId) {
+ List list = thingModelService.getThingModelListByProductId(productId);
+ return success(BeanUtils.toBean(list, IotThingModelRespVO.class));
+ }
+
+ // TODO @puhui @super：getThingModelListByProductId 和 getThingModelListByProductId 可以融合么？
+ @GetMapping("/list")
+ @Operation(summary = "获得产品物模型列表")
+ @PreAuthorize("@ss.hasPermission('iot:thing-model:query')")
+ public CommonResult> getThingModelListByProductId(@Valid IotThingModelListReqVO reqVO) {
+ List list = thingModelService.getThingModelList(reqVO);
+ return success(BeanUtils.toBean(list, IotThingModelRespVO.class));
+ }
+
+ @GetMapping("/page")
+ @Operation(summary = "获得产品物模型分页")
+ @PreAuthorize("@ss.hasPermission('iot:thing-model:query')")
+ public CommonResult> getThingModelPage(@Valid IotThingModelPageReqVO pageReqVO) {
+ PageResult pageResult = thingModelService.getProductThingModelPage(pageReqVO);
+ return success(BeanUtils.toBean(pageResult, IotThingModelRespVO.class));
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelEvent.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelEvent.java
new file mode 100644
index 000000000..06cc43809
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelEvent.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotThingModelServiceEventTypeEnum;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * IoT 物模型中的事件
+ *
+ * @author HUIHUI
+ */
+@Data
+public class ThingModelEvent {
+
+ /**
+ * 事件标识符
+ */
+ @NotEmpty(message = "事件标识符不能为空")
+ @Pattern(regexp = "^[a-zA-Z][a-zA-Z0-9_]{0,31}$", message = "事件标识符只能由字母、数字和下划线组成，必须以字母开头，长度不超过 32 个字符")
+ private String identifier;
+ /**
+ * 事件名称
+ */
+ @NotEmpty(message = "事件名称不能为空")
+ private String name;
+ /**
+ * 是否是标准品类的必选事件
+ */
+ private Boolean required;
+ /**
+ * 事件类型
+ *
+ * 枚举 {@link IotThingModelServiceEventTypeEnum}
+ */
+ @NotEmpty(message = "事件类型不能为空")
+ @InEnum(IotThingModelServiceEventTypeEnum.class)
+ private String type;
+ /**
+ * 事件的输出参数
+ *
+ * 输出参数定义事件调用后返回的结果或反馈信息，用于确认操作结果或提供额外的信息。
+ */
+ @Valid
+ private List outputParams;
+ /**
+ * 标识设备需要执行的具体操作
+ */
+ private String method;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelParam.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelParam.java
new file mode 100644
index 000000000..2afad898b
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelParam.java
@@ -0,0 +1,63 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.dataType.ThingModelDataSpecs;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotDataSpecsDataTypeEnum;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotThingModelParamDirectionEnum;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * IoT 产品物模型中的参数
+ *
+ * @author HUIHUI
+ */
+@Data
+public class ThingModelParam {
+
+ /**
+ * 参数标识符
+ */
+ @NotEmpty(message = "参数标识符不能为空")
+ @Pattern(regexp = "^[a-zA-Z][a-zA-Z0-9_]{0,31}$", message = "参数标识符只能由字母、数字和下划线组成，必须以字母开头，长度不超过 32 个字符")
+ private String identifier;
+ /**
+ * 参数名称
+ */
+ @NotEmpty(message = "参数名称不能为空")
+ private String name;
+ /**
+ * 用于区分输入或输出参数
+ *
+ * 枚举 {@link IotThingModelParamDirectionEnum}
+ */
+ @NotEmpty(message = "参数方向不能为空")
+ @InEnum(IotThingModelParamDirectionEnum.class)
+ private String direction;
+ /**
+ * 参数的序号。从 0 开始排序，且不能重复。
+ *
+ * TODO 考虑要不要序号，感觉是要的, 先留一手看看
+ */
+ private Integer paraOrder;
+ /**
+ * 参数值的数据类型，与 dataSpecs 的 dataType 保持一致
+ *
+ * 枚举 {@link IotDataSpecsDataTypeEnum}
+ */
+ @NotEmpty(message = "数据类型不能为空")
+ @InEnum(IotDataSpecsDataTypeEnum.class)
+ private String dataType;
+ /**
+ * 参数值的数据类型（dataType）为非列表型（int、float、double、text、date、array）的数据规范存储在 dataSpecs 中
+ */
+ private ThingModelDataSpecs dataSpecs;
+ /**
+ * 参数值的数据类型（dataType）为列表型（enum、bool、struct）的数据规范存储在 dataSpecsList 中
+ */
+ private List dataSpecsList;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelProperty.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelProperty.java
new file mode 100644
index 000000000..4b9a05a0e
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelProperty.java
@@ -0,0 +1,63 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.dataType.ThingModelDataSpecs;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotDataSpecsDataTypeEnum;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotThingModelAccessModeEnum;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * IoT 物模型中的属性
+ *
+ * dataSpecs 和 dataSpecsList 之中必须传入且只能传入一个
+ *
+ * @author HUIHUI
+ */
+@Data
+public class ThingModelProperty {
+
+ /**
+ * 属性标识符
+ */
+ @NotEmpty(message = "属性标识符不能为空")
+ @Pattern(regexp = "^[a-zA-Z][a-zA-Z0-9_]{0,31}$", message = "属性标识符只能由字母、数字和下划线组成，必须以字母开头，长度不超过 32 个字符")
+ private String identifier;
+ /**
+ * 属性名称
+ */
+ @NotEmpty(message = "属性名称不能为空")
+ private String name;
+ /**
+ * 云端可以对该属性进行的操作类型
+ *
+ * 枚举 {@link IotThingModelAccessModeEnum}
+ */
+ @NotEmpty(message = "操作类型不能为空")
+ @InEnum(IotThingModelAccessModeEnum.class)
+ private String accessMode;
+ /**
+ * 是否是标准品类的必选服务
+ */
+ private Boolean required;
+ /**
+ * 参数值的数据类型，与 dataSpecs 的 dataType 保持一致
+ *
+ * 枚举 {@link IotDataSpecsDataTypeEnum}
+ */
+ @NotEmpty(message = "数据类型不能为空")
+ @InEnum(IotDataSpecsDataTypeEnum.class)
+ private String dataType;
+ /**
+ * 数据类型（dataType）为非列表型（int、float、double、text、date、array）的数据规范存储在 dataSpecs 中
+ */
+ private ThingModelDataSpecs dataSpecs;
+ /**
+ * 数据类型（dataType）为列表型（enum、bool、struct）的数据规范存储在 dataSpecsList 中
+ */
+ private List dataSpecsList;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelService.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelService.java
new file mode 100644
index 000000000..c98acd824
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/ThingModelService.java
@@ -0,0 +1,62 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotThingModelServiceCallTypeEnum;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * IoT 物模型中的服务
+ *
+ * @author HUIHUI
+ */
+@Data
+public class ThingModelService {
+
+ /**
+ * 服务标识符
+ */
+ @NotEmpty(message = "服务标识符不能为空")
+ @Pattern(regexp = "^[a-zA-Z][a-zA-Z0-9_]{0,31}$", message = "服务标识符只能由字母、数字和下划线组成，必须以字母开头，长度不超过 32 个字符")
+ private String identifier;
+ /**
+ * 服务名称
+ */
+ @NotEmpty(message = "服务名称不能为空")
+ private String name;
+ /**
+ * 是否是标准品类的必选服务
+ */
+ private Boolean required;
+ /**
+ * 调用类型
+ *
+ * 枚举 {@link IotThingModelServiceCallTypeEnum}
+ */
+ @NotEmpty(message = "调用类型不能为空")
+ @InEnum(IotThingModelServiceCallTypeEnum.class)
+ private String callType;
+ /**
+ * 服务的输入参数
+ *
+ * 输入参数定义服务调用时所需提供的信息，用于控制设备行为或执行特定任务
+ */
+ @Valid
+ private List inputParams;
+ /**
+ * 服务的输出参数
+ *
+ * 输出参数定义服务调用后返回的结果或反馈信息，用于确认操作结果或提供额外的信息。
+ */
+ @Valid
+ private List outputParams;
+ /**
+ * 标识设备需要执行的具体操作
+ */
+ private String method;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelArrayDataSpecs.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelArrayDataSpecs.java
new file mode 100644
index 000000000..50011aabf
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelArrayDataSpecs.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.dataType;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+/**
+ * IoT 物模型数据类型为数组的 DataSpec 定义
+ *
+ * @author HUIHUI
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@JsonIgnoreProperties({"dataType"}) // 忽略子类中的 dataType 字段，从而避免重复
+public class ThingModelArrayDataSpecs extends ThingModelDataSpecs {
+
+ /**
+ * 数组中的元素个数
+ */
+ private Integer size;
+ /**
+ * 数组中的元素的数据类型。可选值：struct、int、float、double 或 text
+ */
+ private String childDataType;
+ /**
+ * 数据类型（childDataType）为列表型 struct 的数据规范存储在 dataSpecsList 中
+ * 此时 struct 取值范围为：int、float、double、text、date、enum、bool
+ */
+ private List dataSpecsList;
+
+}
+
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelBoolOrEnumDataSpecs.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelBoolOrEnumDataSpecs.java
new file mode 100644
index 000000000..925bc6719
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelBoolOrEnumDataSpecs.java
@@ -0,0 +1,31 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.dataType;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * IoT 物模型数据类型为布尔型或枚举型的 DataSpec 定义
+ *
+ * 数据类型，取值为 bool 或 enum。
+ *
+ * @author HUIHUI
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@JsonIgnoreProperties({"dataType"}) // 忽略子类中的 dataType 字段，从而避免重复
+public class ThingModelBoolOrEnumDataSpecs extends ThingModelDataSpecs {
+
+ // TODO @puhui999：要不写下参数校验？这样，注释可以简洁一点
+ /**
+ * 枚举项的名称。
+ * 可包含中文、大小写英文字母、数字、下划线（_）和短划线（-）
+ * 必须以中文、英文字母或数字开头，长度不超过 20 个字符
+ */
+ private String name;
+ /**
+ * 枚举值。
+ */
+ private Integer value;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelDataSpecs.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelDataSpecs.java
new file mode 100644
index 000000000..d9fc12dd9
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelDataSpecs.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.dataType;
+
+import com.fasterxml.jackson.annotation.JsonSubTypes;
+import com.fasterxml.jackson.annotation.JsonTypeInfo;
+import lombok.Data;
+
+/**
+ * IoT ThingModelDataSpecs 抽象类
+ *
+ * 用于表示物模型数据的通用类型，根据具体的 "dataType" 字段动态映射到对应的子类。
+ * 提供多态支持，适用于不同类型的数据结构序列化和反序列化场景。
+ *
+ * @author HUIHUI
+ */
+@Data
+@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, property = "dataType", visible = true)
+@JsonSubTypes({
+ @JsonSubTypes.Type(value = ThingModelNumericDataSpec.class, name = "int"),
+ @JsonSubTypes.Type(value = ThingModelNumericDataSpec.class, name = "float"),
+ @JsonSubTypes.Type(value = ThingModelNumericDataSpec.class, name = "double"),
+ @JsonSubTypes.Type(value = ThingModelDateOrTextDataSpecs.class, name = "text"),
+ @JsonSubTypes.Type(value = ThingModelDateOrTextDataSpecs.class, name = "date"),
+ @JsonSubTypes.Type(value = ThingModelBoolOrEnumDataSpecs.class, name = "bool"),
+ @JsonSubTypes.Type(value = ThingModelBoolOrEnumDataSpecs.class, name = "enum"),
+ @JsonSubTypes.Type(value = ThingModelArrayDataSpecs.class, name = "array"),
+ @JsonSubTypes.Type(value = ThingModelStructDataSpecs.class, name = "struct")
+})
+public abstract class ThingModelDataSpecs {
+
+ /**
+ * 数据类型
+ */
+ private String dataType;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelDateOrTextDataSpecs.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelDateOrTextDataSpecs.java
new file mode 100644
index 000000000..62500bc56
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelDateOrTextDataSpecs.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.dataType;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * IoT 物模型数据类型为时间型或文本型的 DataSpec 定义
+ *
+ * 数据类型，取值为 date 或 text。
+ *
+ * @author HUIHUI
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@JsonIgnoreProperties({"dataType"}) // 忽略子类中的 dataType 字段，从而避免重复
+public class ThingModelDateOrTextDataSpecs extends ThingModelDataSpecs {
+
+ /**
+ * 数据长度，单位为字节。取值不能超过 2048。
+ * 当 dataType 为 text 时，需传入该参数。
+ */
+ private Integer length;
+ /**
+ * 默认值，可选参数，用于存储默认值。
+ */
+ private String defaultValue;
+
+}
+
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelNumericDataSpec.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelNumericDataSpec.java
new file mode 100644
index 000000000..8d0827c01
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelNumericDataSpec.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.dataType;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * IoT 物模型数据类型为数值的 DataSpec 定义
+ *
+ * 数据类型，取值为 int、float 或 double。
+ *
+ * @author HUIHUI
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@JsonIgnoreProperties({"dataType"}) // 忽略子类中的 dataType 字段，从而避免重复
+public class ThingModelNumericDataSpec extends ThingModelDataSpecs {
+
+ /**
+ * 最大值，需转为字符串类型。值必须与 dataType 类型一致。
+ * 例如，当 dataType 为 int 时，取值为 "200"，而不是 200。
+ */
+ private String max;
+ /**
+ * 最小值，需转为字符串类型。值必须与 dataType 类型一致。
+ * 例如，当 dataType 为 int 时，取值为 "0"，而不是 0。
+ */
+ private String min;
+ /**
+ * 步长，需转为字符串类型。值必须与 dataType 类型一致。
+ * 例如，当 dataType 为 int 时，取值为 "10"，而不是 10。
+ */
+ private String step;
+ /**
+ * 精度。当 dataType 为 float 或 double 时可选传入。
+ */
+ private String precise;
+ /**
+ * 默认值，可传入用于存储的默认值。
+ */
+ private String defaultValue;
+ /**
+ * 单位的符号。
+ */
+ private String unit;
+ /**
+ * 单位的名称。
+ */
+ private String unitName;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelStructDataSpecs.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelStructDataSpecs.java
new file mode 100644
index 000000000..6d483eeaa
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/model/dataType/ThingModelStructDataSpecs.java
@@ -0,0 +1,52 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.dataType;
+
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotThingModelAccessModeEnum;
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+/**
+ * IoT 物模型数据类型为 struct 的 DataSpec 定义
+ *
+ * @author HUIHUI
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@JsonIgnoreProperties({"dataType"}) // 忽略子类中的 dataType 字段，从而避免重复
+public class ThingModelStructDataSpecs extends ThingModelDataSpecs {
+
+ /**
+ * 属性标识符
+ */
+ private String identifier;
+ /**
+ * 属性名称
+ */
+ private String name;
+ /**
+ * 云端可以对该属性进行的操作类型
+ *
+ * 枚举 {@link IotThingModelAccessModeEnum}
+ */
+ private String accessMode;
+ /**
+ * 是否是标准品类的必选服务
+ */
+ private Boolean required;
+ /**
+ * struct 数据的数据类型
+ */
+ private String childDataType;
+ /**
+ * 数据类型（dataType）为非列表型（int、float、double、text、date、array）的数据规范存储在 dataSpecs 中
+ */
+ private ThingModelDataSpecs dataSpecs;
+ /**
+ * 数据类型（dataType）为列表型（enum、bool、struct）的数据规范存储在 dataSpecsList 中
+ */
+ private List dataSpecsList;
+
+}
+
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelListReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelListReqVO.java
new file mode 100644
index 000000000..5b92256bb
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelListReqVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.vo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotThingModelTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 产品物模型 List Request VO")
+@Data
+public class IotThingModelListReqVO {
+
+ @Schema(description = "产品编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+ @NotNull(message = "产品编号不能为空")
+ private Long productId;
+
+ @Schema(description = "功能标识", example = "temperature")
+ private String identifier;
+
+ @Schema(description = "功能名称", example = "温度")
+ private String name;
+
+ @Schema(description = "功能类型", example = "1")
+ @InEnum(IotThingModelTypeEnum.class)
+ private Integer type;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelPageReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelPageReqVO.java
new file mode 100644
index 000000000..8064b10e5
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelPageReqVO.java
@@ -0,0 +1,28 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotThingModelTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 产品物模型分页 Request VO")
+@Data
+public class IotThingModelPageReqVO extends PageParam {
+
+ @Schema(description = "产品编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+ @NotNull(message = "产品编号不能为空")
+ private Long productId;
+
+ @Schema(description = "功能标识", example = "temperature")
+ private String identifier;
+
+ @Schema(description = "功能名称", example = "温度")
+ private String name;
+
+ @Schema(description = "功能类型", example = "1")
+ @InEnum(IotThingModelTypeEnum.class)
+ private Integer type;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelRespVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelRespVO.java
new file mode 100644
index 000000000..15a5b9f95
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelRespVO.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.vo;
+
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelEvent;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelProperty;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelService;
+import com.alibaba.excel.annotation.ExcelIgnoreUnannotated;
+import com.alibaba.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - IoT 产品物模型 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class IotThingModelRespVO {
+
+ @Schema(description = "产品编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "21816")
+ @ExcelProperty("产品ID")
+ private Long id;
+
+ @Schema(description = "产品标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+ private Long productId;
+
+ @Schema(description = "产品标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "temperature_sensor")
+ @ExcelProperty("产品标识")
+ private String productKey;
+
+ @Schema(description = "功能标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "temperature")
+ private String identifier;
+
+ @Schema(description = "功能名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "温度")
+ private String name;
+
+ @Schema(description = "功能描述", requiredMode = Schema.RequiredMode.REQUIRED, example = "测量当前环境温度")
+ private String description;
+
+ @Schema(description = "功能类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ private Integer type;
+
+ @Schema(description = "属性", requiredMode = Schema.RequiredMode.REQUIRED)
+ private ThingModelProperty property;
+
+ @Schema(description = "服务", requiredMode = Schema.RequiredMode.REQUIRED)
+ private ThingModelEvent event;
+
+ @Schema(description = "事件", requiredMode = Schema.RequiredMode.REQUIRED)
+ private ThingModelService service;
+
+ @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+ @ExcelProperty("创建时间")
+ private LocalDateTime createTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelSaveReqVO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelSaveReqVO.java
new file mode 100644
index 000000000..1e8564df4
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thingmodel/vo/IotThingModelSaveReqVO.java
@@ -0,0 +1,57 @@
+package cn.iocoder.yudao.module.iot.controller.admin.thingmodel.vo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelEvent;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelProperty;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelService;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotThingModelTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - IoT 产品物模型新增/修改 Request VO")
+@Data
+public class IotThingModelSaveReqVO {
+
+ @Schema(description = "编号", example = "1")
+ private Long id;
+
+ @Schema(description = "产品ID", requiredMode = Schema.RequiredMode.REQUIRED)
+ @NotNull(message = "产品ID不能为空")
+ private Long productId;
+
+ @Schema(description = "产品标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "temperature_001")
+ @NotEmpty(message = "产品标识不能为空")
+ private String productKey;
+
+ @Schema(description = "功能标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "temp_monitor")
+ @NotEmpty(message = "功能标识不能为空")
+ private String identifier;
+
+ @Schema(description = "功能名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "温度监测器")
+ @NotEmpty(message = "功能名称不能为空")
+ private String name;
+
+ @Schema(description = "功能描述", requiredMode = Schema.RequiredMode.REQUIRED, example = "用于监测环境温度的传感器")
+ private String description;
+
+ @Schema(description = "功能类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+ @NotNull(message = "功能类型不能为空")
+ @InEnum(IotThingModelTypeEnum.class)
+ private Integer type;
+
+ @Schema(description = "属性", requiredMode = Schema.RequiredMode.REQUIRED)
+ @Valid
+ private ThingModelProperty property;
+
+ @Schema(description = "服务", requiredMode = Schema.RequiredMode.REQUIRED)
+ @Valid
+ private ThingModelService service;
+
+ @Schema(description = "事件", requiredMode = Schema.RequiredMode.REQUIRED)
+ @Valid
+ private ThingModelEvent event;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thinkmodelfunction/IotThinkModelFunctionController.http b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thinkmodelfunction/IotThinkModelFunctionController.http
new file mode 100644
index 000000000..84446b0ce
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/admin/thinkmodelfunction/IotThinkModelFunctionController.http
@@ -0,0 +1,112 @@
+### 请求 /iot/think-model-function/create 接口 => 成功
+POST {{baseUrl}}/iot/think-model-function/create
+Content-Type: application/json
+tenant-id: {{adminTenantId}}
+Authorization: Bearer {{token}}
+
+{
+ "productId": 1001,
+ "productKey": "smart-sensor-001",
+ "identifier": "Temperature",
+ "name": "温度",
+ "description": "当前温度值",
+ "type": 1,
+ "property": {
+ "identifier": "Temperature",
+ "name": "温度",
+ "accessMode": "r",
+ "required": true,
+ "dataType": {
+ "type": "float",
+ "specs": {
+ "min": -10.0,
+ "max": 100.0,
+ "step": 0.1,
+ "unit": "℃"
+ }
+ },
+ "description": "当前温度值"
+ }
+}
+
+### 请求 /iot/think-model-function/create 接口 => 成功
+POST {{baseUrl}}/iot/think-model-function/create
+Content-Type: application/json
+tenant-id: {{adminTenantId}}
+Authorization: Bearer {{token}}
+
+{
+ "productId": 1001,
+ "productKey": "smart-sensor-001",
+ "identifier": "Humidity",
+ "name": "湿度",
+ "description": "当前湿度值",
+ "type": 1,
+ "property": {
+ "identifier": "Humidity",
+ "name": "湿度",
+ "accessMode": "r",
+ "required": true,
+ "dataType": {
+ "type": "float",
+ "specs": {
+ "min": 0.0,
+ "max": 100.0,
+ "step": 0.1,
+ "unit": "%"
+ }
+ },
+ "description": "当前湿度值"
+ }
+}
+
+
+
+
+### 请求 /iot/think-model-function/update 接口 => 成功
+PUT {{baseUrl}}/iot/think-model-function/update
+Content-Type: application/json
+tenant-id: {{adminTenantId}}
+Authorization: Bearer {{token}}
+
+{
+ "id": 11,
+ "productId": 1001,
+ "productKey": "smart-sensor-001",
+ "identifier": "Temperature",
+ "name": "温度",
+ "description": "当前温度值",
+ "type": 1,
+ "property": {
+ "identifier": "Temperature",
+ "name": "温度",
+ "accessMode": "r",
+ "required": true,
+ "dataType": {
+ "type": "float",
+ "specs": {
+ "min": -111.0,
+ "max": 222.0,
+ "step": 0.1,
+ "unit": "℃"
+ }
+ },
+ "description": "当前温度值"
+ }
+}
+
+### 请求 /iot/think-model-function/delete 接口 => 成功
+DELETE {{baseUrl}}/iot/think-model-function/delete?id=7
+tenant-id: {{adminTenantId}}
+Authorization: Bearer {{token}}
+
+### 请求 /iot/think-model-function/get 接口 => 成功
+GET {{baseUrl}}/iot/think-model-function/get?id=10
+tenant-id: {{adminTenantId}}
+Authorization: Bearer {{token}}
+
+
+### 请求 /iot/think-model-function/list-by-product-id 接口 => 成功
+GET {{baseUrl}}/iot/think-model-function/list-by-product-id?productId=1001
+tenant-id: {{adminTenantId}}
+Authorization: Bearer {{token}}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/package-info.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/package-info.java
new file mode 100644
index 000000000..5d2990e1b
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/controller/package-info.java
@@ -0,0 +1,6 @@
+/**
+ * 提供 RESTful API 给前端：
+ * 1. admin 包：提供给管理后台 yudao-ui-admin 前端项目
+ * 2. app 包：提供给用户 APP yudao-ui-app 前端项目，它的 Controller 和 VO 都要添加 App 前缀，用于和管理后台进行区分
+ */
+package cn.iocoder.yudao.module.iot.controller;
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/convert/package-info.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/convert/package-info.java
new file mode 100644
index 000000000..18d7ad21d
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/convert/package-info.java
@@ -0,0 +1,6 @@
+/**
+ * 提供 POJO 类的实体转换
+ *
+ * 目前使用 MapStruct 框架
+ */
+package cn.iocoder.yudao.module.iot.convert;
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/convert/thingmodel/IotThingModelConvert.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/convert/thingmodel/IotThingModelConvert.java
new file mode 100644
index 000000000..9577b18f7
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/convert/thingmodel/IotThingModelConvert.java
@@ -0,0 +1,50 @@
+package cn.iocoder.yudao.module.iot.convert.thingmodel;
+
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelEvent;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelProperty;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelService;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.vo.IotThingModelSaveReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.thingmodel.IotThingModelDO;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotThingModelTypeEnum;
+import org.mapstruct.Mapper;
+import org.mapstruct.Mapping;
+import org.mapstruct.Named;
+import org.mapstruct.factory.Mappers;
+
+import java.util.Objects;
+
+@Mapper
+public interface IotThingModelConvert {
+
+ IotThingModelConvert INSTANCE = Mappers.getMapper(IotThingModelConvert.class);
+
+ @Mapping(target = "property", expression = "java(convertToProperty(bean))")
+ @Mapping(target = "event", expression = "java(convertToEvent(bean))")
+ @Mapping(target = "service", expression = "java(convertToService(bean))")
+ IotThingModelDO convert(IotThingModelSaveReqVO bean);
+
+ @Named("convertToProperty")
+ default ThingModelProperty convertToProperty(IotThingModelSaveReqVO bean) {
+ if (Objects.equals(bean.getType(), IotThingModelTypeEnum.PROPERTY.getType())) {
+ return bean.getProperty();
+ }
+ return null;
+ }
+
+ @Named("convertToEvent")
+ default ThingModelEvent convertToEvent(IotThingModelSaveReqVO bean) {
+ if (Objects.equals(bean.getType(), IotThingModelTypeEnum.EVENT.getType())) {
+ return bean.getEvent();
+ }
+ return null;
+ }
+
+ @Named("convertToService")
+ default ThingModelService convertToService(IotThingModelSaveReqVO bean) {
+ if (Objects.equals(bean.getType(), IotThingModelTypeEnum.SERVICE.getType())) {
+ return bean.getService();
+ }
+ return null;
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDeviceDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDeviceDO.java
new file mode 100644
index 000000000..9633d2feb
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDeviceDO.java
@@ -0,0 +1,173 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.device;
+
+import cn.iocoder.yudao.framework.mybatis.core.type.LongSetTypeHandler;
+import cn.iocoder.yudao.framework.tenant.core.db.TenantBaseDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaFirmwareDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO;
+import cn.iocoder.yudao.module.iot.enums.device.IotDeviceStateEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Set;
+
+/**
+ * IoT 设备 DO
+ *
+ * @author haohao
+ */
+@TableName(value = "iot_device", autoResultMap = true)
+@KeySequence("iot_device_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotDeviceDO extends TenantBaseDO {
+
+ /**
+ * 设备 ID，主键，自增
+ */
+ @TableId
+ private Long id;
+ /**
+ * 设备唯一标识符，全局唯一，用于识别设备
+ *
+ * 类似阿里云 QueryDeviceInfo 的 IotInstanceId
+ */
+ private String deviceKey;
+ /**
+ * 设备名称，在产品内唯一，用于标识设备
+ */
+ private String deviceName;
+ /**
+ * 设备备注名称
+ */
+ private String nickname;
+ /**
+ * 设备序列号
+ */
+ private String serialNumber;
+ /**
+ * 设备图片
+ */
+ private String picUrl;
+ /**
+ * 设备分组编号集合
+ *
+ * 关联 {@link IotDeviceGroupDO#getId()}
+ */
+ @TableField(typeHandler = LongSetTypeHandler.class)
+ private Set groupIds;
+
+ /**
+ * 产品编号
+ *
+ * 关联 {@link IotProductDO#getId()}
+ */
+ private Long productId;
+ /**
+ * 产品标识
+ *
+ * 冗余 {@link IotProductDO#getProductKey()}
+ */
+ private String productKey;
+ /**
+ * 设备类型
+ *
+ * 冗余 {@link IotProductDO#getDeviceType()}
+ */
+ private Integer deviceType;
+ /**
+ * 网关设备编号
+ *
+ * 子设备需要关联的网关设备 ID
+ *
+ * 关联 {@link IotDeviceDO#getId()}
+ */
+ private Long gatewayId;
+
+ /**
+ * 设备状态
+ *
+ * 枚举 {@link IotDeviceStateEnum}
+ */
+ private Integer state;
+ /**
+ * 最后上线时间
+ */
+ private LocalDateTime onlineTime;
+ /**
+ * 最后离线时间
+ */
+ private LocalDateTime offlineTime;
+ /**
+ * 设备激活时间
+ */
+ private LocalDateTime activeTime;
+
+ /**
+ * 设备的 IP 地址
+ */
+ private String ip;
+ /**
+ * 固件编号
+ *
+ * 关联 {@link IotOtaFirmwareDO#getId()}
+ */
+ private String firmwareId;
+
+ // TODO @芋艿：【待定 003】：要不要增加 username？目前 tl 有，阿里云之类的没有
+ /**
+ * 设备密钥，用于设备认证，需安全存储
+ */
+ private String deviceSecret;
+ /**
+ * MQTT 客户端 ID
+ */
+ private String mqttClientId;
+ /**
+ * MQTT 用户名
+ */
+ private String mqttUsername;
+ /**
+ * MQTT 密码
+ */
+ private String mqttPassword;
+ /**
+ * 认证类型（如一机一密、动态注册）
+ */
+ // TODO @haohao：是不是要枚举哈
+ private String authType;
+
+ // TODO @芋艿：【待定 002】：1）设备维护的时候，设置位置？类似 tl？；2）设备上传的时候，设置位置，类似 it？
+ /**
+ * 设备位置的纬度
+ */
+ private BigDecimal latitude;
+ /**
+ * 设备位置的经度
+ */
+ private BigDecimal longitude;
+ /**
+ * 地区编码
+ *
+ * 关联 Area 的 id
+ */
+ private Integer areaId;
+ /**
+ * 设备详细地址
+ */
+ private String address;
+
+ /**
+ * 设备配置
+ *
+ * JSON 格式，可下发给 device 进行自定义配置
+ */
+ private String config;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDeviceGroupDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDeviceGroupDO.java
new file mode 100644
index 000000000..7865a4424
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDeviceGroupDO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.device;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+/**
+ * IoT 设备分组 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("iot_device_group")
+@KeySequence("iot_device_group_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotDeviceGroupDO extends BaseDO {
+
+ /**
+ * 分组 ID
+ */
+ @TableId
+ private Long id;
+ /**
+ * 分组名字
+ */
+ private String name;
+ /**
+ * 分组状态
+ *
+ * 枚举 {@link cn.iocoder.yudao.framework.common.enums.CommonStatusEnum}
+ */
+ private Integer status;
+ /**
+ * 分组描述
+ */
+ private String description;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDeviceLogDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDeviceLogDO.java
new file mode 100644
index 000000000..55cfb19d4
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDeviceLogDO.java
@@ -0,0 +1,95 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.device;
+
+import cn.hutool.core.util.IdUtil;
+import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO;
+import cn.iocoder.yudao.module.iot.enums.device.IotDeviceMessageIdentifierEnum;
+import cn.iocoder.yudao.module.iot.enums.device.IotDeviceMessageTypeEnum;
+import cn.iocoder.yudao.module.iot.mq.message.IotDeviceMessage;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * IoT 设备日志数据 DO
+ *
+ * 目前使用 TDengine 存储
+ *
+ * @author alwayssuper
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotDeviceLogDO {
+
+ /**
+ * 日志编号
+ *
+ * 通过 {@link IdUtil#fastSimpleUUID()} 生成
+ */
+ private String id;
+
+ /**
+ * 请求编号
+ *
+ * 对应 {@link IotDeviceMessage#getRequestId()} 字段
+ */
+ private String requestId;
+
+ /**
+ * 产品标识
+ *
+ * 关联 {@link IotProductDO#getProductKey()}
+ */
+ private String productKey;
+ /**
+ * 设备名称
+ *
+ * 关联 {@link IotDeviceDO#getDeviceName()}
+ */
+ private String deviceName;
+ /**
+ * 设备标识
+ *
+ * 关联 {@link IotDeviceDO#getDeviceKey()}}
+ */
+ private String deviceKey; // 非存储字段，用于 TDengine 的 TAG
+
+ /**
+ * 日志类型
+ *
+ * 枚举 {@link IotDeviceMessageTypeEnum}
+ */
+ private String type;
+ /**
+ * 标识符
+ *
+ * 枚举 {@link IotDeviceMessageIdentifierEnum}
+ */
+ private String identifier;
+
+ /**
+ * 数据内容
+ *
+ * 存储具体的消息数据内容，通常是 JSON 格式
+ */
+ private String content;
+ /**
+ * 响应码
+ *
+ * 目前只有 server 下行消息给 device 设备时，才会有响应码
+ */
+ private Integer code;
+
+ /**
+ * 上报时间戳
+ */
+ private Long reportTime;
+
+ /**
+ * 时序时间
+ */
+ private Long ts;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDevicePropertyDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDevicePropertyDO.java
new file mode 100644
index 000000000..afb328894
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/device/IotDevicePropertyDO.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.device;
+
+import cn.iocoder.yudao.module.iot.dal.redis.device.DevicePropertyRedisDAO;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+/**
+ * IoT 设备属性项 Redis DO
+ *
+ * @see cn.iocoder.yudao.module.iot.dal.redis.RedisKeyConstants#DEVICE_PROPERTY
+ * @see DevicePropertyRedisDAO
+ *
+ * @author haohao
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotDevicePropertyDO {
+
+ /**
+ * 属性值（最新）
+ */
+ private Object value;
+
+ /**
+ * 更新时间
+ */
+ private LocalDateTime updateTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/ota/IotOtaFirmwareDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/ota/IotOtaFirmwareDO.java
new file mode 100644
index 000000000..fa56f6938
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/ota/IotOtaFirmwareDO.java
@@ -0,0 +1,80 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.ota;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+/**
+ * IoT OTA 固件 DO
+ *
+ * @see https://help.aliyun.com/zh/iot/user-guide/ota-upgrade-overview
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "iot_ota_firmware", autoResultMap = true)
+@KeySequence("iot_ota_firmware_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotOtaFirmwareDO extends BaseDO {
+
+ /**
+ * 固件编号
+ */
+ @TableField
+ private Long id;
+ /**
+ * 固件名称
+ */
+ private String name;
+ /**
+ * 固件版本
+ */
+ private String description;
+ /**
+ * 版本号
+ */
+ private String version;
+
+ /**
+ * 产品编号
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO#getId()}
+ */
+ // TODO @li：帮我改成 Long 哈，写错了
+ private String productId;
+ /**
+ * 产品标识
+ *
+ * 冗余 {@link cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO#getProductKey()}
+ */
+ private String productKey;
+
+ /**
+ * 签名方式
+ *
+ * 例如说：MD5、SHA256
+ */
+ private String signMethod;
+ /**
+ * 固件文件签名
+ */
+ private String fileSign;
+ /**
+ * 固件文件大小
+ */
+ private Long fileSize;
+ /**
+ * 固件文件 URL
+ */
+ private String fileUrl;
+
+ /**
+ * 自定义信息，建议使用 JSON 格式
+ */
+ private String information;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/ota/IotOtaUpgradeRecordDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/ota/IotOtaUpgradeRecordDO.java
new file mode 100644
index 000000000..ff4f0e7a0
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/ota/IotOtaUpgradeRecordDO.java
@@ -0,0 +1,92 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.ota;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+/**
+ * IoT OTA 升级记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "iot_ota_upgrade_record", autoResultMap = true)
+@KeySequence("iot_ota_upgrade_record_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotOtaUpgradeRecordDO extends BaseDO {
+
+ @TableId
+ private Long id;
+
+ /**
+ * 固件编号
+ *
+ * 关联 {@link IotOtaFirmwareDO#getId()}
+ */
+ private Long firmwareId;
+ /**
+ * 任务编号
+ *
+ * 关联 {@link IotOtaUpgradeTaskDO#getId()}
+ */
+ private Long taskId;
+
+ /**
+ * 产品标识
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO#getId()}
+ */
+ private String productKey;
+ /**
+ * 设备名称
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO#getId()}
+ */
+ private String deviceName;
+ /**
+ * 设备编号
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO#getId()}
+ */
+ private String deviceId;
+ /**
+ * 来源的固件编号
+ *
+ * 关联 {@link IotDeviceDO#getFirmwareId()}
+ */
+ private Long fromFirmwareId;
+
+ /**
+ * 升级状态
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.enums.ota.IotOtaUpgradeRecordStatusEnum}
+ */
+ private Integer status;
+ /**
+ * 升级进度，百分比
+ */
+ private Integer progress;
+ /**
+ * 升级进度描述
+ *
+ * 注意，只记录设备最后一次的升级进度描述
+ * 如果想看历史记录，可以查看 {@link cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceLogDO} 设备日志
+ */
+ private String description;
+ /**
+ * 升级开始时间
+ */
+ private LocalDateTime startTime;
+ /**
+ * 升级结束时间
+ */
+ private LocalDateTime endTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/ota/IotOtaUpgradeTaskDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/ota/IotOtaUpgradeTaskDO.java
new file mode 100644
index 000000000..221bdc56c
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/ota/IotOtaUpgradeTaskDO.java
@@ -0,0 +1,72 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.ota;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.*;
+
+import java.util.List;
+
+/**
+ * IoT OTA 升级任务 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "iot_ota_upgrade_task", autoResultMap = true)
+@KeySequence("iot_ota_upgrade_task_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotOtaUpgradeTaskDO extends BaseDO {
+
+ /**
+ * 任务编号
+ */
+ @TableField
+ private Long id;
+ /**
+ * 任务名称
+ */
+ private String name;
+ /**
+ * 任务描述
+ */
+ private String description;
+
+ /**
+ * 固件编号
+ *
+ * 关联 {@link IotOtaFirmwareDO#getId()}
+ */
+ private Long firmwareId;
+
+ /**
+ * 任务状态
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.enums.ota.IotOtaUpgradeTaskStatusEnum}
+ */
+ private Integer status;
+
+ /**
+ * 升级范围
+ *
+ * 关联 {@link cn.iocoder.yudao.module.iot.enums.ota.IotOtaUpgradeTaskScopeEnum}
+ */
+ private Integer scope;
+ /**
+ * 设备数量
+ */
+ private Long deviceCount;
+ /**
+ * 选中的设备编号数组
+ *
+ * 关联 {@link IotDeviceDO#getId()}
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private List deviceIds;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/plugin/IotPluginConfigDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/plugin/IotPluginConfigDO.java
new file mode 100644
index 000000000..cb247fc30
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/plugin/IotPluginConfigDO.java
@@ -0,0 +1,93 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.plugin;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.tenant.core.db.TenantBaseDO;
+import cn.iocoder.yudao.module.iot.enums.plugin.IotPluginDeployTypeEnum;
+import cn.iocoder.yudao.module.iot.enums.plugin.IotPluginTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+/**
+ * IoT 插件配置 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("iot_plugin_config")
+@KeySequence("iot_plugin_config_seq")
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotPluginConfigDO extends TenantBaseDO {
+
+ /**
+ * 主键 ID
+ */
+ @TableId
+ private Long id;
+ /**
+ * 插件包标识符
+ */
+ private String pluginKey;
+ /**
+ * 插件名称
+ */
+ private String name;
+ /**
+ * 插件描述
+ */
+ private String description;
+ /**
+ * 部署方式
+ *
+ * 枚举 {@link IotPluginDeployTypeEnum}
+ */
+ private Integer deployType;
+ // TODO @芋艿：如果是外置的插件，fileName 和 version 的选择~
+ /**
+ * 插件包文件名
+ */
+ private String fileName;
+ /**
+ * 插件版本
+ */
+ private String version;
+ // TODO @芋艿：type 字典的定义
+ /**
+ * 插件类型
+ *
+ * 枚举 {@link IotPluginTypeEnum}
+ */
+ private Integer type;
+ /**
+ * 设备插件协议类型
+ */
+ // TODO @芋艿：枚举字段
+ private String protocol;
+ // TODO @haohao：这个字段，是不是直接用 CommonStatus，开启、禁用；然后插件实例那，online 是否在线
+ /**
+ * 状态
+ *
+ * 枚举 {@link CommonStatusEnum}
+ */
+ private Integer status;
+
+ // TODO @芋艿：configSchema、config 示例字段
+ /**
+ * 插件配置项描述信息
+ */
+ private String configSchema;
+ /**
+ * 插件配置信息
+ */
+ private String config;
+
+ // TODO @芋艿：script 后续的使用
+ /**
+ * 插件脚本
+ */
+ private String script;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/plugin/IotPluginInstanceDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/plugin/IotPluginInstanceDO.java
new file mode 100644
index 000000000..34abe893e
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/plugin/IotPluginInstanceDO.java
@@ -0,0 +1,70 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.plugin;
+
+import cn.iocoder.yudao.framework.tenant.core.db.TenantBaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+/**
+ * IoT 插件实例 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("iot_plugin_instance")
+@KeySequence("iot_plugin_instance_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotPluginInstanceDO extends TenantBaseDO {
+
+ /**
+ * 主键
+ */
+ @TableId
+ private Long id;
+ /**
+ * 插件编号
+ *
+ * 关联 {@link IotPluginConfigDO#getId()}
+ */
+ private Long pluginId;
+ /**
+ * 插件进程编号
+ *
+ * 一般格式是：hostIp@processId@${uuid}
+ */
+ private String processId;
+
+ /**
+ * 插件实例所在 IP
+ */
+ private String hostIp;
+ /**
+ * 设备下行端口
+ */
+ private Integer downstreamPort;
+
+ /**
+ * 是否在线
+ */
+ private Boolean online;
+ /**
+ * 在线时间
+ */
+ private LocalDateTime onlineTime;
+ /**
+ * 离线时间
+ */
+ private LocalDateTime offlineTime;
+ /**
+ * 心跳时间
+ *
+ * 目的：心路时间超过一定时间后，会被进行下线处理
+ */
+ private LocalDateTime heartbeatTime;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/product/IotProductCategoryDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/product/IotProductCategoryDO.java
new file mode 100644
index 000000000..174342afb
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/product/IotProductCategoryDO.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.product;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+/**
+ * IoT 产品分类 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("iot_product_category")
+@KeySequence("iot_product_category_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotProductCategoryDO extends BaseDO {
+
+ /**
+ * 分类 ID
+ */
+ @TableId
+ private Long id;
+ /**
+ * 分类名字
+ */
+ private String name;
+ /**
+ * 分类排序
+ */
+ private Integer sort;
+ /**
+ * 分类状态
+ *
+ * 枚举 {@link cn.iocoder.yudao.framework.common.enums.CommonStatusEnum}
+ */
+ private Integer status;
+ /**
+ * 分类描述
+ */
+ private String description;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/product/IotProductDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/product/IotProductDO.java
new file mode 100644
index 000000000..3caebbccb
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/product/IotProductDO.java
@@ -0,0 +1,98 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.product;
+
+import cn.iocoder.yudao.framework.tenant.core.db.TenantBaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+/**
+ * IoT 产品 DO
+ *
+ * @author ahh
+ */
+@TableName("iot_product")
+@KeySequence("iot_product_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotProductDO extends TenantBaseDO {
+
+ /**
+ * 产品 ID
+ */
+ @TableId
+ private Long id;
+ /**
+ * 产品名称
+ */
+ private String name;
+ /**
+ * 产品标识
+ */
+ private String productKey;
+ /**
+ * 产品分类编号
+ *
+ * 关联 {@link IotProductCategoryDO#getId()}
+ */
+ private Long categoryId;
+ /**
+ * 产品图标
+ */
+ private String icon;
+ /**
+ * 产品图片
+ */
+ private String picUrl;
+ /**
+ * 产品描述
+ */
+ private String description;
+
+ /**
+ * 产品状态
+ *
+ * 枚举 {@link cn.iocoder.yudao.module.iot.enums.product.IotProductStatusEnum}
+ */
+ private Integer status;
+ /**
+ * 设备类型
+ *
+ * 枚举 {@link cn.iocoder.yudao.module.iot.enums.product.IotProductDeviceTypeEnum}
+ */
+ private Integer deviceType;
+ /**
+ * 联网方式
+ *
+ * 枚举 {@link cn.iocoder.yudao.module.iot.enums.product.IotNetTypeEnum}
+ */
+ private Integer netType;
+
+ /**
+ * 接入网关协议
+ *
+ * 枚举 {@link cn.iocoder.yudao.module.iot.enums.product.IotProtocolTypeEnum}
+ */
+ private Integer protocolType;
+ /**
+ * 协议编号
+ *
+ * TODO 外键：后续加
+ */
+ private Long protocolId;
+ /**
+ * 数据格式
+ *
+ * 枚举 {@link cn.iocoder.yudao.module.iot.enums.product.IotDataFormatEnum}
+ */
+ private Integer dataFormat;
+ /**
+ * 数据校验级别
+ *
+ * 枚举 {@link cn.iocoder.yudao.module.iot.enums.product.IotValidateTypeEnum}
+ */
+ private Integer validateType;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotAlertConfig.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotAlertConfig.java
new file mode 100644
index 000000000..c6a2390ac
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotAlertConfig.java
@@ -0,0 +1,77 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.rule;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.iot.enums.rule.IotAlertConfigReceiveTypeEnum;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.*;
+
+import java.util.List;
+
+/**
+ * IoT 告警配置 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("iot_alert_config")
+@KeySequence("iot_alert_config_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotAlertConfig extends BaseDO {
+
+ /**
+ * 配置编号
+ */
+ @TableId
+ private Long id;
+ /**
+ * 配置名称
+ */
+ private String name;
+ /**
+ * 配置描述
+ */
+ private String description;
+ /**
+ * 配置状态
+ *
+ * TODO 数据字典
+ */
+ private Integer level;
+ /**
+ * 配置状态
+ *
+ * 枚举 {@link cn.iocoder.yudao.framework.common.enums.CommonStatusEnum}
+ */
+ private Integer status;
+
+ /**
+ * 关联的规则场景编号数组
+ *
+ * 关联 {@link IotRuleSceneDO#getId()}
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private List ruleSceneIds;
+
+ /**
+ * 接收的用户编号数组
+ *
+ * 关联 {@link AdminUserRespDTO#getId()}
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private List receiveUserIds;
+ /**
+ * 接收的类型数组
+ *
+ * 枚举 {@link IotAlertConfigReceiveTypeEnum}
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private List receiveTypes;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotAlertRecordDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotAlertRecordDO.java
new file mode 100644
index 000000000..840111078
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotAlertRecordDO.java
@@ -0,0 +1,77 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.rule;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO;
+import cn.iocoder.yudao.module.iot.mq.message.IotDeviceMessage;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.*;
+
+/**
+ * IoT 告警记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("iot_alert_record")
+@KeySequence("iot_alert_record_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotAlertRecordDO extends BaseDO {
+
+ /**
+ * 记录编号
+ */
+ @TableField
+ private Long id;
+ /**
+ * 告警名称
+ *
+ * 冗余 {@link IotAlertConfig#getName()}
+ */
+ private Long configId;
+ /**
+ * 告警名称
+ *
+ * 冗余 {@link IotAlertConfig#getName()}
+ */
+ private String name;
+
+ /**
+ * 产品标识
+ *
+ * 关联 {@link IotProductDO#getProductKey()} ()}
+ */
+ private String productKey;
+ /**
+ * 设备名称
+ *
+ * 冗余 {@link IotDeviceDO#getDeviceName()}
+ */
+ private String deviceName;
+
+ // TODO @芋艿：有没更好的方式
+ /**
+ * 触发的设备消息
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private IotDeviceMessage deviceMessage;
+
+ // TODO @芋艿：换成枚举，枚举对应 ApiErrorLogProcessStatusEnum
+ /**
+ * 处理状态
+ *
+ * true - 已处理
+ * false - 未处理
+ */
+ private Boolean processStatus;
+ /**
+ * 处理结果（备注）
+ */
+ private String processRemark;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotDataBridgeDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotDataBridgeDO.java
new file mode 100644
index 000000000..fed429872
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotDataBridgeDO.java
@@ -0,0 +1,67 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.rule;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.iot.controller.admin.rule.vo.databridge.config.IotDataBridgeAbstractConfig;
+import cn.iocoder.yudao.module.iot.enums.rule.IotDataBridgeDirectionEnum;
+import cn.iocoder.yudao.module.iot.enums.rule.IotDataBridgeTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.*;
+
+/**
+ * IoT 数据桥梁 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "iot_data_bridge", autoResultMap = true)
+@KeySequence("iot_data_bridge_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotDataBridgeDO extends BaseDO {
+
+ /**
+ * 桥梁编号
+ */
+ @TableId
+ private Long id;
+ /**
+ * 桥梁名称
+ */
+ private String name;
+ /**
+ * 桥梁描述
+ */
+ private String description;
+ /**
+ * 桥梁状态
+ *
+ * 枚举 {@link CommonStatusEnum}
+ */
+ private Integer status;
+ /**
+ * 桥梁方向
+ *
+ * 枚举 {@link IotDataBridgeDirectionEnum}
+ */
+ private Integer direction;
+
+ /**
+ * 桥梁类型
+ *
+ * 枚举 {@link IotDataBridgeTypeEnum}
+ */
+ private Integer type;
+
+ /**
+ * 桥梁配置
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private IotDataBridgeAbstractConfig config;
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotRuleSceneDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotRuleSceneDO.java
new file mode 100644
index 000000000..f50101a4e
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/rule/IotRuleSceneDO.java
@@ -0,0 +1,243 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.rule;
+
+import cn.iocoder.yudao.framework.tenant.core.db.TenantBaseDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.thingmodel.IotThingModelDO;
+import cn.iocoder.yudao.module.iot.enums.device.IotDeviceMessageIdentifierEnum;
+import cn.iocoder.yudao.module.iot.enums.device.IotDeviceMessageTypeEnum;
+import cn.iocoder.yudao.module.iot.enums.rule.IotRuleSceneActionTypeEnum;
+import cn.iocoder.yudao.module.iot.enums.rule.IotRuleSceneTriggerConditionParameterOperatorEnum;
+import cn.iocoder.yudao.module.iot.enums.rule.IotRuleSceneTriggerTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.*;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * IoT 规则场景（场景联动） DO
+ *
+ * @author 芋道源码
+ */
+@TableName("iot_rule_scene")
+@KeySequence("iot_rule_scene_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotRuleSceneDO extends TenantBaseDO {
+
+ /**
+ * 场景编号
+ */
+ @TableId
+ private Long id;
+ /**
+ * 场景名称
+ */
+ private String name;
+ /**
+ * 场景描述
+ */
+ private String description;
+ /**
+ * 场景状态
+ *
+ * 枚举 {@link cn.iocoder.yudao.framework.common.enums.CommonStatusEnum}
+ */
+ private Integer status;
+
+ /**
+ * 触发器数组
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private List triggers;
+
+ /**
+ * 执行器数组
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private List actions;
+
+ /**
+ * 触发器配置
+ */
+ @Data
+ public static class TriggerConfig {
+
+ /**
+ * 触发类型
+ *
+ * 枚举 {@link IotRuleSceneTriggerTypeEnum}
+ */
+ private Integer type;
+
+ /**
+ * 产品标识
+ *
+ * 关联 {@link IotProductDO#getProductKey()}
+ */
+ private String productKey;
+ /**
+ * 设备名称数组
+ *
+ * 关联 {@link IotDeviceDO#getDeviceName()}
+ */
+ private List deviceNames;
+
+ /**
+ * 触发条件数组
+ *
+ * 必填：当 {@link #type} 为 {@link IotRuleSceneTriggerTypeEnum#DEVICE} 时
+ * 条件与条件之间，是“或”的关系
+ */
+ private List conditions;
+
+ /**
+ * CRON 表达式
+ *
+ * 必填：当 {@link #type} 为 {@link IotRuleSceneTriggerTypeEnum#TIMER} 时
+ */
+ private String cronExpression;
+
+ }
+
+ /**
+ * 触发条件
+ */
+ @Data
+ public static class TriggerCondition {
+
+ /**
+ * 消息类型
+ *
+ * 枚举 {@link IotDeviceMessageTypeEnum}
+ */
+ private String type;
+ /**
+ * 消息标识符
+ *
+ * 枚举 {@link IotDeviceMessageIdentifierEnum}
+ */
+ private String identifier;
+
+ /**
+ * 参数数组
+ *
+ * 参数与参数之间，是“或”的关系
+ */
+ private List parameters;
+
+ }
+
+ /**
+ * 触发条件参数
+ */
+ @Data
+ public static class TriggerConditionParameter {
+
+ /**
+ * 标识符（属性、事件、服务）
+ *
+ * 关联 {@link IotThingModelDO#getIdentifier()}
+ */
+ private String identifier;
+
+ /**
+ * 操作符
+ *
+ * 枚举 {@link IotRuleSceneTriggerConditionParameterOperatorEnum}
+ */
+ private String operator;
+
+ /**
+ * 比较值
+ *
+ * 如果有多个值，则使用 "," 分隔，类似 "1,2,3"。
+ * 例如说，{@link IotRuleSceneTriggerConditionParameterOperatorEnum#IN}、{@link IotRuleSceneTriggerConditionParameterOperatorEnum#BETWEEN}
+ */
+ private String value;
+
+ }
+
+ /**
+ * 执行器配置
+ */
+ @Data
+ public static class ActionConfig {
+
+ /**
+ * 执行类型
+ *
+ * 枚举 {@link IotRuleSceneActionTypeEnum}
+ */
+ private Integer type;
+
+ /**
+ * 设备控制
+ *
+ * 必填：当 {@link #type} 为 {@link IotRuleSceneActionTypeEnum#DEVICE_CONTROL} 时
+ */
+ private ActionDeviceControl deviceControl;
+
+ /**
+ * 数据桥接编号
+ *
+ * 必填：当 {@link #type} 为 {@link IotRuleSceneActionTypeEnum#DATA_BRIDGE} 时
+ * 关联：{@link IotDataBridgeDO#getId()}
+ */
+ private Long dataBridgeId;
+
+ }
+
+ /**
+ * 执行设备控制
+ */
+ @Data
+ public static class ActionDeviceControl {
+
+ /**
+ * 产品标识
+ *
+ * 关联 {@link IotProductDO#getProductKey()}
+ */
+ private String productKey;
+ /**
+ * 设备名称数组
+ *
+ * 关联 {@link IotDeviceDO#getDeviceName()}
+ */
+ private List deviceNames;
+
+ /**
+ * 消息类型
+ *
+ * 枚举 {@link IotDeviceMessageTypeEnum#PROPERTY}、{@link IotDeviceMessageTypeEnum#SERVICE}
+ */
+ private String type;
+ /**
+ * 消息标识符
+ *
+ * 枚举 {@link IotDeviceMessageIdentifierEnum}
+ *
+ * 1. 属性设置：对应 {@link IotDeviceMessageIdentifierEnum#PROPERTY_SET}
+ * 2. 服务调用：对应 {@link IotDeviceMessageIdentifierEnum#SERVICE_INVOKE}
+ */
+ private String identifier;
+
+ /**
+ * 具体数据
+ *
+ * 1. 属性设置：在 {@link #type} 是 {@link IotDeviceMessageTypeEnum#PROPERTY} 时，对应 properties
+ * 2. 服务调用：在 {@link #type} 是 {@link IotDeviceMessageTypeEnum#SERVICE} 时，对应 params
+ */
+ private Map data;
+
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/thingmodel/IotThingModelDO.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/thingmodel/IotThingModelDO.java
new file mode 100644
index 000000000..e3b4a6d9a
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/dataobject/thingmodel/IotThingModelDO.java
@@ -0,0 +1,91 @@
+package cn.iocoder.yudao.module.iot.dal.dataobject.thingmodel;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelEvent;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelProperty;
+import cn.iocoder.yudao.module.iot.controller.admin.thingmodel.model.ThingModelService;
+import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO;
+import cn.iocoder.yudao.module.iot.enums.thingmodel.IotThingModelTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * IoT 产品物模型功能 DO
+ *
+ * 每个 {@link IotProductDO} 和 {@link IotThingModelDO} 是“一对多”的关系，它的每个属性、事件、服务都对应一条记录
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "iot_thing_model", autoResultMap = true)
+@KeySequence("iot_thing_model_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class IotThingModelDO extends BaseDO {
+
+ /**
+ * 物模型功能编号
+ */
+ @TableId
+ private Long id;
+
+ /**
+ * 功能标识
+ */
+ private String identifier;
+ /**
+ * 功能名称
+ */
+ private String name;
+ /**
+ * 功能描述
+ */
+ private String description;
+
+ /**
+ * 产品标识
+ *
+ * 关联 {@link IotProductDO#getId()}
+ */
+ private Long productId;
+ /**
+ * 产品标识
+ *
+ * 关联 {@link IotProductDO#getProductKey()}
+ */
+ private String productKey;
+
+ /**
+ * 功能类型
+ *
+ * 枚举 {@link IotThingModelTypeEnum}
+ */
+ private Integer type;
+
+ /**
+ * 属性
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private ThingModelProperty property;
+
+ /**
+ * 事件
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private ThingModelEvent event;
+
+ /**
+ * 服务
+ */
+ @TableField(typeHandler = JacksonTypeHandler.class)
+ private ThingModelService service;
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/device/IotDeviceGroupMapper.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/device/IotDeviceGroupMapper.java
new file mode 100644
index 000000000..1f80ae455
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/device/IotDeviceGroupMapper.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.iot.dal.mysql.device;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.group.IotDeviceGroupPageReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceGroupDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * IoT 设备分组 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface IotDeviceGroupMapper extends BaseMapperX {
+
+ default PageResult selectPage(IotDeviceGroupPageReqVO reqVO) {
+ return selectPage(reqVO, new LambdaQueryWrapperX()
+ .likeIfPresent(IotDeviceGroupDO::getName, reqVO.getName())
+ .betweenIfPresent(IotDeviceGroupDO::getCreateTime, reqVO.getCreateTime())
+ .orderByDesc(IotDeviceGroupDO::getId));
+ }
+
+ default List selectListByStatus(Integer status) {
+ return selectList(IotDeviceGroupDO::getStatus, status);
+ }
+
+ default IotDeviceGroupDO selectByName(String name) {
+ return selectOne(IotDeviceGroupDO::getName, name);
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/device/IotDeviceMapper.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/device/IotDeviceMapper.java
new file mode 100644
index 000000000..babbf29e7
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/device/IotDeviceMapper.java
@@ -0,0 +1,96 @@
+package cn.iocoder.yudao.module.iot.dal.mysql.device;
+
+import cn.hutool.core.util.ObjectUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.iot.controller.admin.device.vo.device.IotDevicePageReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.device.IotDeviceDO;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import javax.annotation.Nullable;
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * IoT 设备 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface IotDeviceMapper extends BaseMapperX {
+
+ default PageResult selectPage(IotDevicePageReqVO reqVO) {
+ return selectPage(reqVO, new LambdaQueryWrapperX()
+ .likeIfPresent(IotDeviceDO::getDeviceName, reqVO.getDeviceName())
+ .eqIfPresent(IotDeviceDO::getProductId, reqVO.getProductId())
+ .eqIfPresent(IotDeviceDO::getDeviceType, reqVO.getDeviceType())
+ .likeIfPresent(IotDeviceDO::getNickname, reqVO.getNickname())
+ .eqIfPresent(IotDeviceDO::getState, reqVO.getStatus())
+ .apply(ObjectUtil.isNotNull(reqVO.getGroupId()), "FIND_IN_SET(" + reqVO.getGroupId() + ",group_ids) > 0")
+ .orderByDesc(IotDeviceDO::getId));
+ }
+
+ default IotDeviceDO selectByDeviceName(String deviceName) {
+ return selectOne(IotDeviceDO::getDeviceName, deviceName);
+ }
+
+ default IotDeviceDO selectByProductKeyAndDeviceName(String productKey, String deviceName) {
+ return selectOne(IotDeviceDO::getProductKey, productKey,
+ IotDeviceDO::getDeviceName, deviceName);
+ }
+
+ default long selectCountByGatewayId(Long id) {
+ return selectCount(IotDeviceDO::getGatewayId, id);
+ }
+
+ default Long selectCountByProductId(Long productId) {
+ return selectCount(IotDeviceDO::getProductId, productId);
+ }
+
+ default IotDeviceDO selectByDeviceKey(String deviceKey) {
+ return selectOne(new LambdaQueryWrapper()
+ .apply("LOWER(device_key) = {0}", deviceKey.toLowerCase()));
+ }
+
+ default List selectListByDeviceType(Integer deviceType) {
+ return selectList(IotDeviceDO::getDeviceType, deviceType);
+ }
+
+ default List selectListByState(Integer state) {
+ return selectList(IotDeviceDO::getState, state);
+ }
+
+ default List selectListByProductId(Long productId) {
+ return selectList(IotDeviceDO::getProductId, productId);
+ }
+
+ default Long selectCountByGroupId(Long groupId) {
+ return selectCount(new LambdaQueryWrapperX()
+ .apply("FIND_IN_SET(" + groupId + ",group_ids) > 0"));
+ }
+
+ default Long selectCountByCreateTime(@Nullable LocalDateTime createTime) {
+ return selectCount(new LambdaQueryWrapperX()
+ .geIfPresent(IotDeviceDO::getCreateTime, createTime));
+ }
+
+ /**
+ * 查询指定产品下各状态的设备数量
+ *
+ * @return 设备数量统计列表
+ */
+ // TODO @super：通过 mybatis-plus 来写哈，然后返回 Map 貌似就行了？！
+ List> selectDeviceCountMapByProductId();
+
+ // TODO @super：通过 mybatis-plus 来写哈，然后返回 Map 貌似就行了？！
+ /**
+ * 查询各个状态下的设备数量
+ *
+ * @return 设备数量统计列表
+ */
+ List> selectDeviceCountGroupByState();
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/ota/IotOtaFirmwareMapper.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/ota/IotOtaFirmwareMapper.java
new file mode 100644
index 000000000..7adf79349
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/ota/IotOtaFirmwareMapper.java
@@ -0,0 +1,41 @@
+package cn.iocoder.yudao.module.iot.dal.mysql.ota;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.firmware.IotOtaFirmwarePageReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaFirmwareDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+// TODO @li：参考 IotOtaUpgradeRecordMapper 的写法
+@Mapper
+public interface IotOtaFirmwareMapper extends BaseMapperX {
+
+ /**
+ * 根据产品ID和固件版本号查询固件信息列表。
+ *
+ * @param productId 产品ID，用于筛选固件信息。
+ * @param version 固件版本号，用于筛选固件信息。
+ * @return 返回符合条件的固件信息列表。
+ */
+ default List selectByProductIdAndVersion(String productId, String version) {
+ return selectList(IotOtaFirmwareDO::getProductId, productId,
+ IotOtaFirmwareDO::getVersion, version);
+ }
+
+ /**
+ * 分页查询固件信息，支持根据名称和产品ID进行筛选，并按创建时间降序排列。
+ *
+ * @param pageReqVO 分页查询请求对象，包含分页参数和筛选条件。
+ * @return 返回分页查询结果，包含符合条件的固件信息列表。
+ */
+ default PageResult selectPage(IotOtaFirmwarePageReqVO pageReqVO) {
+ return selectPage(pageReqVO, new LambdaQueryWrapperX()
+ .likeIfPresent(IotOtaFirmwareDO::getName, pageReqVO.getName())
+ .eqIfPresent(IotOtaFirmwareDO::getProductId, pageReqVO.getProductId())
+ .orderByDesc(IotOtaFirmwareDO::getCreateTime));
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/ota/IotOtaUpgradeRecordMapper.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/ota/IotOtaUpgradeRecordMapper.java
new file mode 100644
index 000000000..5e5d8200f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/ota/IotOtaUpgradeRecordMapper.java
@@ -0,0 +1,159 @@
+package cn.iocoder.yudao.module.iot.dal.mysql.ota;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.record.IotOtaUpgradeRecordPageReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaUpgradeRecordDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+import org.apache.ibatis.annotations.Select;
+
+import java.util.List;
+import java.util.Map;
+
+@Mapper
+public interface IotOtaUpgradeRecordMapper extends BaseMapperX {
+
+ // TODO @li：selectByFirmwareIdAndTaskIdAndDeviceId；让方法自解释
+ /**
+ * 根据条件查询单个OTA升级记录
+ *
+ * @param firmwareId 固件ID，可选参数，用于筛选固件ID匹配的记录
+ * @param taskId 任务ID，可选参数，用于筛选任务ID匹配的记录
+ * @param deviceId 设备ID，可选参数，用于筛选设备ID匹配的记录
+ * @return 返回符合条件的单个OTA升级记录，如果不存在则返回null
+ */
+ default IotOtaUpgradeRecordDO selectByConditions(Long firmwareId, Long taskId, String deviceId) {
+ // 使用LambdaQueryWrapperX构建查询条件，根据传入的参数动态添加查询条件
+ return selectOne(new LambdaQueryWrapperX()
+ .eqIfPresent(IotOtaUpgradeRecordDO::getFirmwareId, firmwareId)
+ .eqIfPresent(IotOtaUpgradeRecordDO::getTaskId, taskId)
+ .eqIfPresent(IotOtaUpgradeRecordDO::getDeviceId, deviceId));
+ }
+
+ // TODO @li：这个是不是 groupby status 就 ok 拉？
+ /**
+ * 根据任务ID和设备名称查询OTA升级记录的状态统计信息。
+ * 该函数通过SQL查询统计不同状态（0到5）的记录数量，并返回一个包含统计结果的Map列表。
+ *
+ * @param taskId 任务ID，用于筛选特定任务的OTA升级记录。
+ * @param deviceName 设备名称，支持模糊查询，用于筛选特定设备的OTA升级记录。
+ * @return 返回一个Map列表，每个Map包含不同状态（0到5）的记录数量。
+ */
+ @Select("select count(case when status = 0 then 1 else 0) as `0` " +
+ "count(case when status = 1 then 1 else 0) as `1` " +
+ "count(case when status = 2 then 1 else 0) as `2` " +
+ "count(case when status = 3 then 1 else 0) as `3` " +
+ "count(case when status = 4 then 1 else 0) as `4` " +
+ "count(case when status = 5 then 1 else 0) as `5` " +
+ "from iot_ota_upgrade_record " +
+ "where task_id = #{taskId} " +
+ "and device_name like concat('%', #{deviceName}, '%') " +
+ "and status = #{status}")
+ List> selectOtaUpgradeRecordCount(@Param("taskId") Long taskId,
+ @Param("deviceName") String deviceName);
+
+ /**
+ * 根据固件ID查询OTA升级记录的状态统计信息。
+ * 该函数通过SQL查询统计不同状态（0到5）的记录数量，并返回一个包含统计结果的Map列表。
+ *
+ * @param firmwareId 固件ID，用于筛选特定固件的OTA升级记录。
+ * @return 返回一个Map列表，每个Map包含不同状态（0到5）的记录数量。
+ */
+ @Select("select count(case when status = 0 then 1 else 0) as `0` " +
+ "count(case when status = 1 then 1 else 0) as `1` " +
+ "count(case when status = 2 then 1 else 0) as `2` " +
+ "count(case when status = 3 then 1 else 0) as `3` " +
+ "count(case when status = 4 then 1 else 0) as `4` " +
+ "count(case when status = 5 then 1 else 0) as `5` " +
+ "from iot_ota_upgrade_record " +
+ "where firmware_id = #{firmwareId}")
+ List> selectOtaUpgradeRecordStatistics(Long firmwareId);
+
+ // TODO @li：这里的注释，可以去掉哈
+ /**
+ * 根据分页查询条件获取 OTA升级记录的分页结果
+ *
+ * @param pageReqVO 分页查询请求参数，包含设备名称、任务ID等查询条件
+ * @return 返回分页查询结果，包含符合条件的 OTA升级记录列表
+ */
+ // TODO @li：selectPage 就 ok 拉。
+ default PageResult selectUpgradeRecordPage(IotOtaUpgradeRecordPageReqVO pageReqVO) {
+ // TODO @li：这里的注释，可以去掉哈；然后下面的“如果”。。。也没必要注释
+ // 使用LambdaQueryWrapperX构建查询条件，并根据请求参数动态添加查询条件
+ return selectPage(pageReqVO, new LambdaQueryWrapperX()
+ .likeIfPresent(IotOtaUpgradeRecordDO::getDeviceName, pageReqVO.getDeviceName()) // 如果设备名称存在，则添加模糊查询条件
+ .eqIfPresent(IotOtaUpgradeRecordDO::getTaskId, pageReqVO.getTaskId())); // 如果任务ID存在，则添加等值查询条件
+ }
+
+ // TODO @li：这里的注释，可以去掉哈
+ /**
+ * 根据任务ID和状态更新升级记录的状态
+ *
+ * 该函数用于将符合指定任务ID和状态的升级记录的状态更新为新的状态。
+ *
+ * @param setStatus 要设置的新状态值，类型为Integer
+ * @param taskId 要更新的升级记录对应的任务ID，类型为Long
+ * @param whereStatus 用于筛选升级记录的当前状态值，类型为Integer
+ */
+ // TODO @li：改成 updateByTaskIdAndStatus(taskId, status, IotOtaUpgradeRecordDO) 更通用一些。
+ default void updateUpgradeRecordStatusByTaskIdAndStatus(Integer setStatus, Long taskId, Integer whereStatus) {
+ // 使用LambdaUpdateWrapper构建更新条件，将指定状态的记录更新为指定状态
+ update(new LambdaUpdateWrapper()
+ .set(IotOtaUpgradeRecordDO::getStatus, setStatus)
+ .eq(IotOtaUpgradeRecordDO::getTaskId, taskId)
+ .eq(IotOtaUpgradeRecordDO::getStatus, whereStatus)
+ );
+ }
+
+ // TODO @li：参考上面的建议，调整下这个方法
+ /**
+ * 根据状态查询符合条件的升级记录列表
+ *
+ * 该函数使用LambdaQueryWrapperX构建查询条件，查询指定状态的升级记录。
+ *
+ * @param state 升级记录的状态，用于筛选符合条件的记录
+ * @return 返回符合指定状态的升级记录列表，类型为List
+ */
+ default List selectUpgradeRecordListByState(Integer state) {
+ // 使用LambdaQueryWrapperX构建查询条件，根据状态查询符合条件的升级记录
+ return selectList(new LambdaQueryWrapperX()
+ .eq(IotOtaUpgradeRecordDO::getStatus, state));
+ }
+
+ // TODO @li：参考上面的建议，调整下这个方法
+ /**
+ * 更新升级记录状态
+ *
+ * 该函数用于批量更新指定ID列表中的升级记录状态。通过传入的ID列表和状态值，使用LambdaUpdateWrapper构建更新条件，
+ * 并执行更新操作。
+ *
+ * @param ids 需要更新的升级记录ID列表，类型为List。传入的ID列表中的记录将被更新。
+ * @param status 要更新的状态值，类型为Integer。该值将被设置到符合条件的升级记录中。
+ */
+ default void updateUpgradeRecordStatus(List ids, Integer status) {
+ // 使用LambdaUpdateWrapper构建更新条件，设置状态字段，并根据ID列表进行筛选
+ update(new LambdaUpdateWrapper()
+ .set(IotOtaUpgradeRecordDO::getStatus, status)
+ .in(IotOtaUpgradeRecordDO::getId, ids)
+ );
+ }
+
+ // TODO @li：参考上面的建议，调整下这个方法
+ /**
+ * 根据任务ID查询升级记录列表
+ *
+ * 该函数通过任务ID查询符合条件的升级记录，并返回查询结果列表。
+ *
+ * @param taskId 任务ID，用于筛选升级记录
+ * @return 返回符合条件的升级记录列表，若未找到则返回空列表
+ */
+ default List selectUpgradeRecordListByTaskId(Long taskId) {
+ // 使用LambdaQueryWrapperX构建查询条件，根据任务ID查询符合条件的升级记录
+ return selectList(new LambdaQueryWrapperX()
+ .eq(IotOtaUpgradeRecordDO::getTaskId, taskId));
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/ota/IotOtaUpgradeTaskMapper.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/ota/IotOtaUpgradeTaskMapper.java
new file mode 100644
index 000000000..d955b1361
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/ota/IotOtaUpgradeTaskMapper.java
@@ -0,0 +1,57 @@
+package cn.iocoder.yudao.module.iot.dal.mysql.ota;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.iot.controller.admin.ota.vo.upgrade.task.IotOtaUpgradeTaskPageReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.ota.IotOtaUpgradeTaskDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * OTA 升级任务Mapper
+ *
+ * @author Shelly
+ */
+@Mapper
+public interface IotOtaUpgradeTaskMapper extends BaseMapperX {
+
+ /**
+ * 根据固件ID和任务名称查询升级任务列表。
+ *
+ * @param firmwareId 固件ID，用于筛选升级任务
+ * @param name 任务名称，用于筛选升级任务
+ * @return 符合条件的升级任务列表
+ */
+ default List selectByFirmwareIdAndName(Long firmwareId, String name) {
+ return selectList(new LambdaQueryWrapperX()
+ .eqIfPresent(IotOtaUpgradeTaskDO::getFirmwareId, firmwareId)
+ .eqIfPresent(IotOtaUpgradeTaskDO::getName, name));
+ }
+
+ /**
+ * 分页查询升级任务列表，支持根据固件ID和任务名称进行筛选。
+ *
+ * @param pageReqVO 分页查询请求对象，包含分页参数和筛选条件
+ * @return 分页结果，包含符合条件的升级任务列表
+ */
+ default PageResult selectUpgradeTaskPage(IotOtaUpgradeTaskPageReqVO pageReqVO) {
+ return selectPage(pageReqVO, new LambdaQueryWrapperX()
+ .eqIfPresent(IotOtaUpgradeTaskDO::getFirmwareId, pageReqVO.getFirmwareId())
+ .likeIfPresent(IotOtaUpgradeTaskDO::getName, pageReqVO.getName()));
+ }
+
+ /**
+ * 根据任务状态查询升级任务列表
+ *
+ * 该函数通过传入的任务状态，查询数据库中符合条件的升级任务列表。
+ *
+ * @param status 任务状态，用于筛选升级任务的状态值
+ * @return 返回符合条件的升级任务列表，列表中的每个元素为 IotOtaUpgradeTaskDO 对象
+ */
+ default List selectUpgradeTaskByState(Integer status) {
+ return selectList(IotOtaUpgradeTaskDO::getStatus, status);
+ }
+
+}
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/plugin/IotPluginConfigMapper.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/plugin/IotPluginConfigMapper.java
new file mode 100644
index 000000000..0e2163a3f
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/plugin/IotPluginConfigMapper.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.iot.dal.mysql.plugin;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.iot.controller.admin.plugin.vo.config.PluginConfigPageReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.plugin.IotPluginConfigDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface IotPluginConfigMapper extends BaseMapperX {
+
+ default PageResult selectPage(PluginConfigPageReqVO reqVO) {
+ return selectPage(reqVO, new LambdaQueryWrapperX()
+ .likeIfPresent(IotPluginConfigDO::getName, reqVO.getName())
+ .eqIfPresent(IotPluginConfigDO::getStatus, reqVO.getStatus())
+ .orderByDesc(IotPluginConfigDO::getId));
+ }
+
+ default List selectListByStatusAndDeployType(Integer status, Integer deployType) {
+ return selectList(new LambdaQueryWrapperX()
+ .eq(IotPluginConfigDO::getStatus, status)
+ .eq(IotPluginConfigDO::getDeployType, deployType)
+ .orderByAsc(IotPluginConfigDO::getId));
+ }
+
+ default IotPluginConfigDO selectByPluginKey(String pluginKey) {
+ return selectOne(IotPluginConfigDO::getPluginKey, pluginKey);
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/plugin/IotPluginInstanceMapper.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/plugin/IotPluginInstanceMapper.java
new file mode 100644
index 000000000..93ffe8728
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/plugin/IotPluginInstanceMapper.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.iot.dal.mysql.plugin;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.module.iot.dal.dataobject.plugin.IotPluginInstanceDO;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+// TODO @li：参考 IotOtaUpgradeRecordMapper 的写法
+@Mapper
+public interface IotPluginInstanceMapper extends BaseMapperX {
+
+ default IotPluginInstanceDO selectByProcessId(String processId) {
+ return selectOne(IotPluginInstanceDO::getProcessId, processId);
+ }
+
+ default List selectListByHeartbeatTimeLt(LocalDateTime heartbeatTime) {
+ return selectList(new LambdaQueryWrapper()
+ .lt(IotPluginInstanceDO::getHeartbeatTime, heartbeatTime));
+ }
+
+}
\ No newline at end of file
diff --git a/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/product/IotProductCategoryMapper.java b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/product/IotProductCategoryMapper.java
new file mode 100644
index 000000000..dc9367bbd
--- /dev/null
+++ b/yudao-module-iot/yudao-module-iot-biz/src/main/java/cn/iocoder/yudao/module/iot/dal/mysql/product/IotProductCategoryMapper.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.iot.dal.mysql.product;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.iot.controller.admin.product.vo.category.IotProductCategoryPageReqVO;
+import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductCategoryDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import javax.annotation.Nullable;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * IoT 产品分类 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface IotProductCategoryMapper extends BaseMapperX {
+
+ default PageResult selectPage(IotProductCategoryPageReqVO reqVO) {
+ return selectPage(reqVO, new LambdaQueryWrapperX