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; int MAX_HISTORY_BATCH_SIZE = 1000; /** 读取已有状态;仅在状态不存在时原子写入并返回默认状态。 */ 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 CollectorHistoryBatch loadCollectorHistoryPage(String collectorCode, long offset, int limit, boolean reverse) { if (offset < 0) throw new IllegalArgumentException("offset must not be negative"); if (limit < 1 || limit > MAX_HISTORY_BATCH_SIZE) throw new IllegalArgumentException("limit must be between 1 and " + MAX_HISTORY_BATCH_SIZE); return new CollectorHistoryBatch(offset, 0, false, 0, 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, BtsDeviceProfile profile) { public DeviceState { channels = List.copyOf(channels); profile = profile == null ? BtsDeviceProfile.virtual(channels.size()) : profile; } /** 兼容旧版只保存拓扑和通道状态的模拟设备。 */ public DeviceState(int deviceId, String ip, boolean online, List channels) { this(deviceId, ip, online, channels, BtsDeviceProfile.virtual(channels.size())); } } 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 CollectorHistoryBatch(long offset, long nextOffset, boolean hasMore, long total, List records) { public CollectorHistoryBatch { 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) { } /** BTS 检测柜的可配置厂商 profile;参数用于发现展示和边界内的演示数据生成。 */ record BtsDeviceProfile(int devtype, int subDeviceId, String name, String manufacturer, String model, String serialNumber, String firmwareVersion, int channelCount, BigDecimal currentMinA, BigDecimal currentMaxA, BigDecimal voltageMinV, BigDecimal voltageMaxV, int sampleIntervalMs) { public BtsDeviceProfile { if (devtype < 0 || subDeviceId < 0 || channelCount < 1 || sampleIntervalMs < 1) throw new IllegalArgumentException("Invalid BTS device profile limits"); if (name == null || name.isBlank() || manufacturer == null || manufacturer.isBlank() || model == null || model.isBlank() || serialNumber == null || serialNumber.isBlank() || firmwareVersion == null || firmwareVersion.isBlank()) throw new IllegalArgumentException("BTS device profile metadata must not be blank"); if (currentMinA == null || currentMaxA == null || voltageMinV == null || voltageMaxV == null || currentMinA.compareTo(currentMaxA) > 0 || voltageMinV.compareTo(voltageMaxV) > 0) throw new IllegalArgumentException("Invalid BTS device profile ranges"); } public static BtsDeviceProfile virtual(int channelCount) { return new BtsDeviceProfile(22, 1, "dev-sim 设备", "开发模拟器", "BTS Virtual Cabinet", "SIM-VIRTUAL", "dev-sim", channelCount, new BigDecimal("-6.000"), new BigDecimal("6.000"), BigDecimal.ZERO, new BigDecimal("5.000"), 100); } } record ChannelTombstone(int deviceId, String ip, int channelId, int remainingDiscoveries) { } record RecentRequest(Instant receivedAt, String command, String request) { } }