From a5487f4ce3594611eaffed5ed14bb2ec6b88adf0 Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期六, 05 九月 2026 11:05:24 +0800
Subject: [PATCH] 整理Ticket08验收后注释

---
 battery-device-api/src/main/java/com/battery/device/api/TestDataObservationAdapter.java |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)

diff --git a/battery-device-api/src/main/java/com/battery/device/api/TestDataObservationAdapter.java b/battery-device-api/src/main/java/com/battery/device/api/TestDataObservationAdapter.java
index 849ad5a..cee3010 100644
--- a/battery-device-api/src/main/java/com/battery/device/api/TestDataObservationAdapter.java
+++ b/battery-device-api/src/main/java/com/battery/device/api/TestDataObservationAdapter.java
@@ -9,14 +9,19 @@
 /** 供业务持久化使用的厂商无关测试数据观测扩展。 */
 public interface TestDataObservationAdapter extends DeviceObservationAdapter
 {
+    /** 返回指定检测柜通道最近一次实时观测;没有成功观测时返回空值。 */
     CabinetRealtime latestCabinet(ChannelIdentity channel);
 
+    /** 返回采集器独立实时快照;不得通过历史下载补采。 */
     CollectorRealtime latestCollector(long collectorId);
 
+    /** 返回设备直接提供的工步统计,不从实时采样推导。 */
     List<StepRecord> stepRecords(ChannelIdentity channel);
 
+    /** 返回设备直接提供的循环统计,不补齐设备未返回的记录。 */
     List<CycleRecord> cycleRecords(ChannelIdentity channel);
 
+    /** 返回适配器定义的实时持久化槽位间隔。 */
     long persistenceIntervalMillis(ChannelIdentity channel);
 
     record CabinetRealtime(long sequenceId, Instant deviceTime, double currentA, double voltageV,

--
Gitblit v1.7.1