package com.ruoyi.device.simulator; import java.math.BigDecimal; import java.time.Instant; import java.util.List; import com.ruoyi.device.model.DeviceWorkStatus; /** 持久化开发模拟器配置;实现必须在返回前确认写入成功。 */ public interface BtsSimulatorStateStore { int CURRENT_VERSION = 1; /** 读取已有状态;仅在状态不存在时原子写入并返回默认状态。 */ SimulatorState loadOrInitialize(SimulatorState defaultState); /** 完整保存下一版模拟器状态。 */ void save(SimulatorState state); /** 状态和独立历史全部校验通过后,提交兼容旧格式所需的迁移。 */ default void completeValidatedRestore(SimulatorState state) { } /** 原子保存主状态并追加本轮新产生的原始历史。 */ default void save(SimulatorState state, List historyAppends) { if (!historyAppends.isEmpty()) throw new UnsupportedOperationException("Collector history append is not supported"); save(state); } /** 读取指定采集器的只追加原始历史。 */ default List loadCollectorHistory(String collectorCode) { return List.of(); } /** 原子保存删除采集器后的主状态,并删除该采集器的独立历史。 */ default void saveAndDeleteCollectorHistory(SimulatorState state, String collectorCode) { throw new UnsupportedOperationException("Atomic collector deletion is not supported"); } /** 读取短期保留的最近请求。 */ List loadRecentRequests(); /** 保存短期保留的最近请求。 */ void saveRecentRequests(List requests); /** 人工重置主状态和最近请求。 */ void reset(SimulatorState defaultState); record SimulatorState(int version, List devices, List collectors, int nextDeviceId, int nextCollectorId, List tombstones) { public SimulatorState { if (version != CURRENT_VERSION) throw new IllegalStateException("Unsupported BTS simulator state version: " + version); devices = List.copyOf(devices); collectors = List.copyOf(collectors); tombstones = List.copyOf(tombstones); } } record DeviceState(int deviceId, String ip, boolean online, List channels) { public DeviceState { channels = List.copyOf(channels); } } record CollectorState(int collectorId, String deviceCode, String ip, String mac, String name, String manufacturer, String model, int channelCount, boolean online, int sampleIntervalMs, long nextSequence, Instant lastSampledAt, List channels, List latestMeasurements, long historyRecordCount, CollectorHistoryFaults historyFaults) { public CollectorState { channels = List.copyOf(channels); latestMeasurements = List.copyOf(latestMeasurements); historyFaults = historyFaults == null ? CollectorHistoryFaults.none() : historyFaults; } /** 兼容只包含发现配置的旧模拟状态;Redis 读取边界会补齐采样合同。 */ public CollectorState(int collectorId, String deviceCode, String ip, String mac, String name, String manufacturer, String model, int channelCount, boolean online) { this(collectorId, deviceCode, ip, mac, name, manufacturer, model, channelCount, online, DevelopmentCollectorSimulation.DEFAULT_SAMPLE_INTERVAL_MS, 1L, null, DevelopmentCollectorSimulation.defaultChannels(channelCount), List.of(), 0L, CollectorHistoryFaults.none()); } } record CollectorChannelState(String channelCode, List metrics) { public CollectorChannelState { metrics = List.copyOf(metrics); } } record CollectorMetricState(String metricCode, BigDecimal value, String unit) { } record CollectorRealtimeMeasurement(String adapterCode, String collectorCode, String channelCode, long sequenceId, Instant deviceTime, String deviceTimeRaw, Instant serverReceivedAt, String metricCode, BigDecimal value, String unit) { } record CollectorMeasurementRecord(String adapterCode, String collectorCode, String channelCode, long sequenceId, Instant deviceTime, String deviceTimeRaw, Instant serverReceivedAt, String metricCode, BigDecimal value, String unit) { } record CollectorHistoryAppend(String collectorCode, List records) { public CollectorHistoryAppend { records = List.copyOf(records); } } record CollectorHistoryFaults(List missingSequences, Long duplicateSequence, Long conflictingSequence, boolean outOfOrder) { public CollectorHistoryFaults { missingSequences = missingSequences == null ? List.of() : List.copyOf(missingSequences); } public static CollectorHistoryFaults none() { return new CollectorHistoryFaults(List.of(), null, null, false); } } record ChannelState(int channelId, boolean online, DeviceWorkStatus workStatus) { } record ChannelTombstone(int deviceId, String ip, int channelId, int remainingDiscoveries) { } record RecentRequest(Instant receivedAt, String command, String request) { } }