From ce0d2e3c328bd694b8323216e96c722ecab83f57 Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期六, 05 九月 2026 14:56:25 +0800
Subject: [PATCH] 整理架构重构验收后的业务注释
---
battery-device-simulator/src/main/java/com/battery/device/simulator/BtsSimulatorStateStore.java | 4 ++--
ruoyi-admin/src/main/java/com/battery/business/web/TTestWarningExceptionController.java | 2 +-
battery-device-simulator/src/main/java/com/battery/device/simulator/BtsDevelopmentSimulator.java | 2 +-
ruoyi-admin/src/main/java/com/battery/business/runtime/RedisBtsSimulatorStateStore.java | 6 +++---
ruoyi-admin/src/main/java/com/battery/business/runtime/DevelopmentRealtimeSnapshotScheduler.java | 2 +-
ruoyi-admin/src/main/java/com/battery/business/runtime/FlywayMigrationConfig.java | 2 +-
battery-business/src/main/java/com/battery/business/service/impl/TTestLiveServiceImpl.java | 2 +-
7 files changed, 10 insertions(+), 10 deletions(-)
diff --git a/battery-business/src/main/java/com/battery/business/service/impl/TTestLiveServiceImpl.java b/battery-business/src/main/java/com/battery/business/service/impl/TTestLiveServiceImpl.java
index ceedeb7..9878255 100644
--- a/battery-business/src/main/java/com/battery/business/service/impl/TTestLiveServiceImpl.java
+++ b/battery-business/src/main/java/com/battery/business/service/impl/TTestLiveServiceImpl.java
@@ -23,7 +23,7 @@
import com.battery.business.service.ITTestService;
import com.battery.business.mapper.TTestMapper;
-/** 将设备最新快照转换为测试视角，并托管 SSE 连接生命周期。 */
+/** 将设备最新快照转换为测试视角，按测试接收状态决定是否展示采集参数。 */
@Service
public class TTestLiveServiceImpl implements ITestLiveService
{
diff --git a/battery-device-simulator/src/main/java/com/battery/device/simulator/BtsDevelopmentSimulator.java b/battery-device-simulator/src/main/java/com/battery/device/simulator/BtsDevelopmentSimulator.java
index cc4a142..c4e597b 100644
--- a/battery-device-simulator/src/main/java/com/battery/device/simulator/BtsDevelopmentSimulator.java
+++ b/battery-device-simulator/src/main/java/com/battery/device/simulator/BtsDevelopmentSimulator.java
@@ -144,7 +144,7 @@
{
this.stateStore = stateStore;
state = stateStore.loadOrInitialize(defaultState());
- // 仅清理 Ticket13 之前嵌在主状态中的旧演示历史；独立历史由模拟器存储保留。
+ // 仅清理嵌在主状态中的旧演示历史；独立历史由模拟器存储保留。
state = stateStore.resetHistoryForDemoStartup(state);
restoreBtsHistory();
validateRestoredState();
diff --git a/battery-device-simulator/src/main/java/com/battery/device/simulator/BtsSimulatorStateStore.java b/battery-device-simulator/src/main/java/com/battery/device/simulator/BtsSimulatorStateStore.java
index 1bdefed..7252757 100644
--- a/battery-device-simulator/src/main/java/com/battery/device/simulator/BtsSimulatorStateStore.java
+++ b/battery-device-simulator/src/main/java/com/battery/device/simulator/BtsSimulatorStateStore.java
@@ -16,7 +16,7 @@
/** 读取已有状态；仅在状态不存在时原子写入并返回默认状态。 */
SimulatorState loadOrInitialize(SimulatorState defaultState);
- /** 开发模拟器启动时清理上一轮演示历史；正式业务存储不需要实现该动作。 */
+ /** 开发模拟器启动时清理主状态中的旧内嵌历史，保留独立存储的历史。 */
default SimulatorState resetHistoryForDemoStartup(SimulatorState state) { return state; }
/** 完整保存下一版模拟器状态。 */
@@ -178,7 +178,7 @@
stepName, stepType, Instant.now());
}
- /** 兼容 Ticket13 之前仅包含核心测量值的历史记录。 */
+ /** 为仅包含核心测量值的历史记录补齐默认工步信息。 */
public BtsHistoryRecord(long sequenceId, Instant deviceTime, double currentA, double voltageV,
double capacityAh, double energyWh)
{
diff --git a/ruoyi-admin/src/main/java/com/battery/business/runtime/DevelopmentRealtimeSnapshotScheduler.java b/ruoyi-admin/src/main/java/com/battery/business/runtime/DevelopmentRealtimeSnapshotScheduler.java
index 0166281..b9be79a 100644
--- a/ruoyi-admin/src/main/java/com/battery/business/runtime/DevelopmentRealtimeSnapshotScheduler.java
+++ b/ruoyi-admin/src/main/java/com/battery/business/runtime/DevelopmentRealtimeSnapshotScheduler.java
@@ -5,7 +5,7 @@
import org.springframework.context.annotation.Profile;
import com.battery.business.service.ITestDataReceptionService;
-/** 开发环境按模拟器槽位主动形成完整实时采集快照；生产轮询周期由真实设备调度器决定。 */
+/** 开发环境触发数据接收，由业务服务按测试接收状态和采样槽位保存成功观测。 */
@Component
@Profile("dev-simulator")
public class DevelopmentRealtimeSnapshotScheduler
diff --git a/ruoyi-admin/src/main/java/com/battery/business/runtime/FlywayMigrationConfig.java b/ruoyi-admin/src/main/java/com/battery/business/runtime/FlywayMigrationConfig.java
index 4d0f536..a0555ae 100644
--- a/ruoyi-admin/src/main/java/com/battery/business/runtime/FlywayMigrationConfig.java
+++ b/ruoyi-admin/src/main/java/com/battery/business/runtime/FlywayMigrationConfig.java
@@ -9,7 +9,7 @@
import org.springframework.context.annotation.Configuration;
/**
- * 在 MyBatis 使用的主数据源上执行版本化迁移。
+ * 使用主数据源的连接参数建立独立 JDBC 连接，在业务数据源就绪前执行版本化迁移。
*
* <p>项目使用自定义 Druid 数据源，因此不使用 Spring Boot 默认 Flyway 自动装配。</p>
*/
diff --git a/ruoyi-admin/src/main/java/com/battery/business/runtime/RedisBtsSimulatorStateStore.java b/ruoyi-admin/src/main/java/com/battery/business/runtime/RedisBtsSimulatorStateStore.java
index 848b0e9..f407c87 100644
--- a/ruoyi-admin/src/main/java/com/battery/business/runtime/RedisBtsSimulatorStateStore.java
+++ b/ruoyi-admin/src/main/java/com/battery/business/runtime/RedisBtsSimulatorStateStore.java
@@ -30,7 +30,7 @@
static final String RECENT_REQUESTS_KEY = "dev:bts-simulator:recent-requests:v1";
static final String HISTORY_KEYS_KEY = "dev:bts-simulator:collector-history-keys:v1";
static final String HISTORY_KEY_PREFIX = "dev:bts-simulator:collector-history:v1:";
- // Ticket21 fixture 变更后切换独立 key 版本，避免把旧的 3 循环演示历史恢复到新时间轴。
+ // 历史与播放位置使用独立键版本，避免把旧的三循环演示历史恢复到当前时间轴。
static final String BTS_HISTORY_KEYS_KEY = "dev:bts-simulator:bts-history-keys:v2";
static final String BTS_HISTORY_KEY_PREFIX = "dev:bts-simulator:bts-history:v2:";
static final String BTS_PLAYBACK_KEY_PREFIX = "dev:bts-simulator:bts-playback:v2:";
@@ -426,7 +426,7 @@
String model = object.getString("model");
int channelCount = requiredInteger(object, "channelCount");
boolean online = object.getBooleanValue("online");
- // Ticket04 状态只包含发现配置；首次恢复时以演示默认值补齐采样状态。
+ // 仅含发现配置的旧状态首次恢复时，以演示默认值补齐采样状态。
if (!object.containsKey("sampleIntervalMs"))
return new CollectorState(collectorId, deviceCode, ip, mac, name, manufacturer, model,
channelCount, online);
@@ -488,7 +488,7 @@
measurement, object.getString("unit"));
}
- /** 兼容 Ticket06 开发期间已写入但尚未拆分快照模型的状态。 */
+ /** 从尚未拆分快照模型的旧状态中提取最新测量值。 */
private List<CollectorRealtimeMeasurement> latestMeasurementsFromLegacyHistory(
List<CollectorMeasurementRecord> history, List<CollectorChannelState> channels)
{
diff --git a/ruoyi-admin/src/main/java/com/battery/business/web/TTestWarningExceptionController.java b/ruoyi-admin/src/main/java/com/battery/business/web/TTestWarningExceptionController.java
index 79f6f96..54c4b98 100644
--- a/ruoyi-admin/src/main/java/com/battery/business/web/TTestWarningExceptionController.java
+++ b/ruoyi-admin/src/main/java/com/battery/business/web/TTestWarningExceptionController.java
@@ -29,7 +29,7 @@
List<TTestWarningException> rows = mapper.selectWarningExceptions(testId, status);
return getDataTable(rows);
}
- /** 校验测试负责人身份并关闭异常，同时追加测试审计事实。 */
+ /** 校验测试负责人身份并关闭异常，通过应用操作日志记录处理动作。 */
@PreAuthorize("@ss.hasPermi('system:exception:handle')")
@Log(title = "测试预警异常", businessType = BusinessType.UPDATE)
@PutMapping("/{exceptionId}/close")
--
Gitblit v1.7.1