docs(device): document adapter service contracts

yeg

2026-08-26 a9e3435464f86a50ffa81a16ef92e47734adef6e

 ruoyi-system/src/main/java/com/ruoyi/system/domain/TDetectionCabinet.java

@@ -2,6 +2,7 @@

import java.math.BigDecimal;
import java.util.Date;
import java.time.Instant;
import com.fasterxml.jackson.annotation.JsonFormat;
import jakarta.validation.constraints.Max;
import jakarta.validation.constraints.Min;
@@ -22,6 +23,13 @@

    /** 检测柜主键。 */
    private Long cabinetId;

    /** 所属设备适配器实例。 */
    private Long adapterId;

    private Integer vendorDeviceType;
    private Integer vendorDeviceId;
    private Instant lastSeenAtUtc;

    /** 全局唯一的设备编码。 */
    @NotBlank(message = "设备编码不能为空")
@@ -91,6 +99,15 @@
        return cabinetId;
    }

    public Long getAdapterId() { return adapterId; }
    public void setAdapterId(Long adapterId) { this.adapterId = adapterId; }
    public Integer getVendorDeviceType() { return vendorDeviceType; }
    public void setVendorDeviceType(Integer value) { vendorDeviceType = value; }
    public Integer getVendorDeviceId() { return vendorDeviceId; }
    public void setVendorDeviceId(Integer value) { vendorDeviceId = value; }
    public Instant getLastSeenAtUtc() { return lastSeenAtUtc; }
    public void setLastSeenAtUtc(Instant value) { lastSeenAtUtc = value; }

    public void setCabinetId(Long cabinetId)
    {
        this.cabinetId = cabinetId;