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/TTestStepRecord.java | 53 +++++++++++++++++++++++++++++++++++++++++++++++------
1 files changed, 47 insertions(+), 6 deletions(-)
diff --git a/battery-business/src/main/java/com/battery/business/domain/TTestStepRecord.java b/battery-business/src/main/java/com/battery/business/domain/TTestStepRecord.java
index 627fe93..317d5af 100644
--- a/battery-business/src/main/java/com/battery/business/domain/TTestStepRecord.java
+++ b/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;}
--
Gitblit v1.7.1