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/TTestWarningException.java | 25 ++++++++++++++++++++++++-
1 files changed, 24 insertions(+), 1 deletions(-)
diff --git a/battery-business/src/main/java/com/battery/business/domain/TTestWarningException.java b/battery-business/src/main/java/com/battery/business/domain/TTestWarningException.java
index d152392..9ad9348 100644
--- a/battery-business/src/main/java/com/battery/business/domain/TTestWarningException.java
+++ b/battery-business/src/main/java/com/battery/business/domain/TTestWarningException.java
@@ -4,27 +4,50 @@
import java.math.BigDecimal;
import java.util.Date;
-/** 测试阈值超限或接收期间设备离线的异常事实。 */
+/**
+ * 测试阈值超限或接收期间设备离线的异常事实，对应表 t_test_warning_exception。
+ *
+ * <p>它只是本系统的观测提醒，不能表述或实现成设备安全保护的替代品。</p>
+ */
public class TTestWarningException implements Serializable {
private static final long serialVersionUID = 1L;
+ /** 异常主键。 */
private Long exceptionId;
+ /** 所属测试主键。 */
private Long testId;
+ /** 异常类型：THRESHOLD 阈值超限、DEVICE_OFFLINE 接收期间设备离线。 */
private String exceptionType = "THRESHOLD";
+ /** 所属测试名称，查询时带出，仅供展示。 */
private String testName;
+ /** 来源类型：CABINET 检测柜通道、CABINET_CHANNEL 绑定来源离线、COLLECTOR 采集器。 */
private String sourceType;
+ /** 来源身份：检测柜按适配器实例与厂商通道字段拼接，采集器按设备 ID。 */
private String sourceIdentity;
+ /** 指标编码；离线异常固定为 DEVICE_ONLINE。 */
private String metricCode;
+ /** 触发异常时的测量值；离线异常不伪造测量值，保持为空。 */
private BigDecimal abnormalValue;
+ /** 测量值单位；离线异常为空字符串。 */
private String unit;
+ /** 触发时阈值规则的内容快照 JSON，规则后续修改不回写历史异常。 */
private String ruleSnapshot;
+ /** 严重程度：WARNING 警告；离线异常固定为 WARNING。 */
private String severity;
+ /** 异常状态：OPEN 开放、CLOSED 已关闭；同一聚合键人工关闭前只保留一条开放异常。 */
private String exceptionStatus;
+ /** 首次触发时间，以 UTC 保存。 */
private Date firstOccurredAtUtc;
+ /** 最近一次触发时间，以 UTC 保存；正常观测不会自动关闭异常。 */
private Date lastOccurredAtUtc;
+ /** 累计触发次数。 */
private Long occurrenceCount;
+ /** 处理人用户 ID，由测试负责人关闭时写入。 */
private Long handledBy;
+ /** 处理人显示名称，随异常事实保存。 */
private String handledByName;
+ /** 关闭时间，以 UTC 保存。 */
private Date handledAtUtc;
+ /** 负责人填写的处理结果，关闭时必填。 */
private String handlingNote;
public Long getExceptionId(){return exceptionId;} public void setExceptionId(Long v){exceptionId=v;}
public Long getTestId(){return testId;} public void setTestId(Long v){testId=v;}
--
Gitblit v1.7.1