按代码规范检查整改实体注释、Service Javadoc 与分层边界

yeg

2026-09-29 b78295e8da96c3e5e76befeef9582ce5273dbb74

 battery-business/src/main/java/com/battery/business/domain/TTestStepRecord.java

@@ -4,15 +4,56 @@
import java.math.BigDecimal;
import java.util.Date;

/** 检测柜直接返回的一条实际工步统计记录。 */
/**
 * 检测柜直接返回的一条实际工步统计记录，对应表 t_test_step_record。
 *
 * <p>只保存设备给出的实际工步，逻辑工步合并仅用于派生视图，不回写本表。</p>
 */
public class TTestStepRecord implements Serializable
{
    private Long stepRecordId, testId, testBatteryId, bindingId;
    private String adapterCode, sourceIdentity, sourceRecordId, adapterTimezoneId, dedupeKey, stepType, stepName, extensionMeasurementsJson;
    private Date deviceTimeUtc, serverReceivedAtUtc;
    /** 工步记录主键。 */
    private Long stepRecordId;
    /** 所属测试主键。 */
    private Long testId;
    /** 所属测试电池主键。 */
    private Long testBatteryId;
    /** 本次观测使用的通道绑定主键。 */
    private Long bindingId;
    /** 设备适配器实例编码。 */
    private String adapterCode;
    /** 来源身份，由适配器实例与厂商通道字段拼接。 */
    private String sourceIdentity;
    /** 来源记录编号，设备未提供时为空并回落到时间组合去重。 */
    private String sourceRecordId;
    /** 解释设备时间所用的适配器时区标识。 */
    private String adapterTimezoneId;
    /** 幂等键：优先取来源记录编号，缺失时按结束时间、循环号、工步号组合。 */
    private String dedupeKey;
    /** 设备工步类型，未知取值原样保留，不按电流或容量猜测方向。 */
    private String stepType;
    /** 设备工步名称。 */
    private String stepName;
    /** 扩展测量记录 JSON，保存设备提供的充电/放电中值电压等额外指标。 */
    private String extensionMeasurementsJson;
    /** 工步结束时间，按适配器时区解释后以 UTC 保存。 */
    private Date deviceTimeUtc;
    /** 服务器接收时间。 */
    private Date serverReceivedAtUtc;
    /** 设备时间原始文本，保留厂家原值供核对。 */
    private String deviceTimeRaw;
    private Integer cycleNo, stepNo;
    private BigDecimal voltageV, currentA, capacityAh, energyWh;
    /** 设备实际循环号。 */
    private Integer cycleNo;
    /** 设备实际工步号。 */
    private Integer stepNo;
    /** 工步结束电压，业务单位 V。 */
    private BigDecimal voltageV;
    /** 工步结束电流，业务单位 A。 */
    private BigDecimal currentA;
    /** 工步容量，业务单位 Ah；设备未提供时为空，不写成零。 */
    private BigDecimal capacityAh;
    /** 工步能量，业务单位 Wh；设备未提供时为空，不写成零。 */
    private BigDecimal energyWh;
    /** 记录内容摘要，用于重复观测的幂等与冲突判定。 */
    private byte[] contentSha256;
    public Long getStepRecordId(){return stepRecordId;} public void setStepRecordId(Long v){stepRecordId=v;}
    public Long getTestId(){return testId;} public void setTestId(Long v){testId=v;} public Long getTestBatteryId(){return testBatteryId;} public void setTestBatteryId(Long v){testBatteryId=v;}