From b78295e8da96c3e5e76befeef9582ce5273dbb74 Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期二, 29 九月 2026 13:10:23 +0800
Subject: [PATCH] 按代码规范检查整改实体注释、Service Javadoc 与分层边界

---
 battery-business/src/main/java/com/battery/business/domain/TTestChannelBinding.java |   21 ++++++++++++++++++++-
 1 files changed, 20 insertions(+), 1 deletions(-)

diff --git a/battery-business/src/main/java/com/battery/business/domain/TTestChannelBinding.java b/battery-business/src/main/java/com/battery/business/domain/TTestChannelBinding.java
index 17013e3..190ee05 100644
--- a/battery-business/src/main/java/com/battery/business/domain/TTestChannelBinding.java
+++ b/battery-business/src/main/java/com/battery/business/domain/TTestChannelBinding.java
@@ -4,30 +4,49 @@
 import jakarta.validation.constraints.NotNull;
 import jakarta.validation.constraints.Size;
 
-/** 测试电池号与主要检测柜通道的绑定。 */
+/** 测试电池号与主要检测柜通道的绑定,对应表 t_test_channel_binding。 */
 public class TTestChannelBinding implements Serializable
 {
     private static final long serialVersionUID = 1L;
 
+    /** 通道绑定主键。 */
     private Long bindingId;
+    /** 所属测试主键。 */
     private Long testId;
+    /** 旧页面入参别名,仅用于兼容;数据库列以 testBatteryId 为准。 */
     private Long batteryRelationId;
     /** 最终数据库列名对应的测试电池主键。 */
     private Long testBatteryId;
+    /** 绑定的检测柜通道主键,同一次开始接收不允许重复绑定同一通道。 */
     @NotNull(message = "检测柜通道不能为空")
     private Long channelId;
+    /** 操作员填写的预期条码,用于人工核对,不参与数据归属判定。 */
     @Size(max = 100, message = "预期条码长度不能超过100个字符")
     private String expectedBarcode;
+    /**
+     * 通道认领状态,数据库约束只允许四个取值:PENDING 待认领、CLAIMED 已认领、
+     * RELEASED 已释放、CONFLICT 冲突;数据归属只按绑定关系判定,不依赖该值。
+     */
     private String claimStatus;
+    /** 通道所属检测柜主键,由通道查询带出。 */
     private Long cabinetId;
+    /** 检测柜编码,仅供列表展示。 */
     private String cabinetCode;
+    /** 检测柜名称,仅供列表展示。 */
     private String cabinetName;
+    /** 设备适配器实例编码,与下方厂商字段共同构成通道身份。 */
     private String adapterCode;
+    /** 厂商设备类型。 */
     private Integer devtype;
+    /** 厂商设备号。 */
     private Integer devid;
+    /** 厂商单元号。 */
     private Integer subdevid;
+    /** 厂商通道号。 */
     private Integer chlid;
+    /** 通道展示编号,仅供界面展示,不能代替通道身份。 */
     private String displayNo;
+    /** 适配器时区标识,用于解释设备时间;缺省按 Asia/Hong_Kong 处理。 */
     private String adapterTimezoneId;
 
     public Long getBindingId() { return bindingId; }

--
Gitblit v1.7.1