package com.ruoyi.device.contract; import static org.junit.jupiter.api.Assertions.assertEquals; import static org.junit.jupiter.api.Assertions.assertFalse; import static org.junit.jupiter.api.Assertions.assertTrue; import static org.junit.jupiter.api.Assertions.assertThrows; import java.math.BigDecimal; import java.time.Duration; import java.time.Instant; import java.time.ZoneId; import java.util.List; import java.util.Set; import org.junit.jupiter.api.Test; import com.ruoyi.device.api.DeviceAdapter; import com.ruoyi.device.bts.BtsDevelopmentSimulator; import com.ruoyi.device.bts.BtsDeviceAdapter; import com.ruoyi.device.bts.BtsXmlCodec; import com.ruoyi.device.bts.BtsTcpTransport; import com.ruoyi.device.bts.ScriptedBtsTcpSimulator; import com.ruoyi.device.model.DetectedChannel; import com.ruoyi.device.model.DeviceWorkStatus; import com.ruoyi.device.simulator.BtsSimulatorStateStore; import com.ruoyi.device.simulator.BtsSimulatorStateStore.ChannelState; import com.ruoyi.device.simulator.BtsSimulatorStateStore.CollectorChannelState; import com.ruoyi.device.simulator.BtsSimulatorStateStore.CollectorHistoryFaults; import com.ruoyi.device.simulator.BtsSimulatorStateStore.CollectorMeasurementRecord; import com.ruoyi.device.simulator.BtsSimulatorStateStore.CollectorMetricState; import com.ruoyi.device.simulator.BtsSimulatorStateStore.CollectorState; import com.ruoyi.device.simulator.BtsSimulatorStateStore.DeviceState; import com.ruoyi.device.simulator.BtsSimulatorStateStore.SimulatorState; import com.ruoyi.device.simulator.InMemoryBtsSimulatorStateStore; class SimulatorPublicContractTest { @Test void collectorGeneratesIndependentRealtimeAndHistoricalMeasurements() throws Exception { Instant startedAt = Instant.parse("2026-08-29T01:00:00Z"); try (BtsDevelopmentSimulator simulator = new BtsDevelopmentSimulator(0)) { simulator.configureCollectorSampling(1, 200, CollectorHistoryFaults.none()); simulator.configureCollectorChannel(1, "S-01", List.of( new CollectorMetricState("temperature", new BigDecimal("26.5"), "℃"), new CollectorMetricState("positive_potential", new BigDecimal("3.801"), "V"), new CollectorMetricState("negative_potential", new BigDecimal("-0.120"), "V"), new CollectorMetricState("pressure", new BigDecimal("101.2"), "kPa"))); simulator.advanceCollectors(startedAt); simulator.advanceCollectors(startedAt.plusMillis(400)); var realtime = simulator.snapshot().collectors().get(0).latestMeasurements(); var history = simulator.collectorHistory(1, 0, 1000); assertEquals(13, realtime.size()); assertTrue(realtime.stream().allMatch(item -> item.sequenceId() == 3)); assertTrue(realtime.stream().anyMatch(item -> item.channelCode().equals("S-01") && item.metricCode().equals("pressure") && item.unit().equals("kPa"))); assertEquals(39, history.total()); assertEquals("dev-sim", history.records().get(0).adapterCode()); assertEquals("dev-sim-collector-1", history.records().get(0).collectorCode()); assertEquals(startedAt, history.records().get(0).deviceTime()); assertTrue(history.records().get(0).deviceTimeRaw().startsWith("2026-08-29 09:00:00")); assertEquals(startedAt, history.records().get(0).serverReceivedAt()); } } @Test void collectorHistorySupportsPagingAndRepeatableFaultScenarios() throws Exception { Instant startedAt = Instant.parse("2026-08-29T02:00:00Z"); try (BtsDevelopmentSimulator simulator = new BtsDevelopmentSimulator(0)) { simulator.configureCollectorSampling(1, 100, new CollectorHistoryFaults(List.of(2L), 1L, 3L, true)); simulator.advanceCollectors(startedAt); simulator.advanceCollectors(startedAt.plusMillis(200)); var first = simulator.collectorHistory(1, 0, 17); var second = simulator.collectorHistory(1, first.nextOffset(), 1000); List records = new java.util.ArrayList<>(first.records()); records.addAll(second.records()); assertEquals(48, first.total()); assertTrue(first.hasMore()); assertFalse(second.hasMore()); assertTrue(records.stream().noneMatch(item -> item.sequenceId() == 2)); assertEquals(24, records.stream().filter(item -> item.sequenceId() == 1).count()); assertEquals(2, records.stream().filter(item -> item.sequenceId() == 3 && item.channelCode().equals("S-01") && item.metricCode().equals("temperature")).count()); assertTrue(records.get(0).sequenceId() >= records.get(records.size() - 1).sequenceId()); } } @Test void collectorStopsWhileOfflineAndResumesFromPersistedSequence() throws Exception { InMemoryBtsSimulatorStateStore store = new InMemoryBtsSimulatorStateStore(); Instant now = Instant.now(); try (BtsDevelopmentSimulator simulator = new BtsDevelopmentSimulator(0, store)) { simulator.advanceCollectors(now); simulator.updateCollector(1, "127.0.1.2", 4, false); simulator.advanceCollectors(now.plusSeconds(10)); assertEquals(1, simulator.snapshot().collectors().get(0).latestMeasurements().get(0).sequenceId()); } try (BtsDevelopmentSimulator restored = new BtsDevelopmentSimulator(0, store)) { restored.updateCollector(1, "127.0.1.2", 4, true); restored.advanceCollectors(Instant.now().plusSeconds(2)); assertTrue(restored.snapshot().collectors().get(0).latestMeasurements().get(0).sequenceId() >= 2); assertEquals(List.of("S-01", "S-02", "S-03", "S-04"), restored.snapshot().collectors().get(0).channels().stream() .map(channel -> channel.channelCode()).toList()); } } @Test void collectorKeepsAppendOnlyHistoryBeyondPreviousDisplayLimit() throws Exception { Instant startedAt = Instant.parse("2026-08-29T03:00:00Z"); try (BtsDevelopmentSimulator simulator = new BtsDevelopmentSimulator(0)) { simulator.configureCollectorSampling(1, 100, CollectorHistoryFaults.none()); simulator.advanceCollectors(startedAt); for (int batch = 1; batch <= 5; batch++) simulator.advanceCollectors(startedAt.plusMillis(batch * 100_000L)); assertEquals(60_012, simulator.collectorHistory(1, 0, 1).total()); assertEquals(1, simulator.collectorHistory(1, 0, 1).records().get(0).sequenceId()); } } @Test void collectorRealtimeDropsMeasurementsRemovedFromCurrentConfiguration() throws Exception { Instant startedAt = Instant.parse("2026-08-29T04:00:00Z"); InMemoryBtsSimulatorStateStore store = new InMemoryBtsSimulatorStateStore(); try (BtsDevelopmentSimulator simulator = new BtsDevelopmentSimulator(0, store)) { simulator.advanceCollectors(startedAt); assertEquals(12, simulator.snapshot().collectors().get(0).latestMeasurements().size()); simulator.configureCollectorChannel(1, "S-01", List.of( new CollectorMetricState("temperature", new BigDecimal("27.0"), "℃"))); simulator.updateCollector(1, "127.0.1.2", 2, true); var snapshot = simulator.snapshot().collectors().get(0); assertEquals(4, snapshot.latestMeasurements().size()); assertTrue(snapshot.latestMeasurements().stream() .noneMatch(item -> item.channelCode().equals("S-03") || item.channelCode().equals("S-04") || item.channelCode().equals("S-01") && item.metricCode().equals("positive_potential"))); assertEquals(12, simulator.collectorHistory(1, 0, 100).total()); } try (BtsDevelopmentSimulator restored = new BtsDevelopmentSimulator(0, store)) { assertEquals(4, restored.snapshot().collectors().get(0).latestMeasurements().size()); assertEquals(12, restored.collectorHistory(1, 0, 100).total()); } } @Test void simulatorIsReusableOutsideTheBtsPackage() throws Exception { try (ScriptedBtsTcpSimulator simulator = new ScriptedBtsTcpSimulator(); BtsTcpTransport transport = new BtsTcpTransport("127.0.0.1", simulator.port(), Duration.ofSeconds(1), Duration.ofSeconds(1))) { simulator.enqueue("getdevinfo_resp"); assertEquals("getdevinfo_resp", transport.exchange("getdevinfo")); assertEquals(1, simulator.requests().size()); } } @Test void simulatorPreservesRequestEndingWithDelimiterPrefix() throws Exception { try (ScriptedBtsTcpSimulator simulator = new ScriptedBtsTcpSimulator(); BtsTcpTransport transport = new BtsTcpTransport("127.0.0.1", simulator.port(), Duration.ofSeconds(1), Duration.ofSeconds(1))) { simulator.enqueue("ok"); assertEquals("ok", transport.exchange("payload#")); assertEquals("payload#", simulator.requests().get(0)); } } @Test void developmentSimulatorSupportsRepeatedDiscoveryAndObservation() throws Exception { try (BtsDevelopmentSimulator simulator = new BtsDevelopmentSimulator(0); BtsTcpTransport transport = new BtsTcpTransport("127.0.0.1", simulator.port(), Duration.ofSeconds(1), Duration.ofSeconds(1)); DeviceAdapter adapter = new BtsDeviceAdapter("development-bts", transport, new BtsXmlCodec("development-bts", ZoneId.of("Asia/Hong_Kong")))) { var firstDiscovery = adapter.discoverChannels(); var secondDiscovery = adapter.discoverChannels(); assertEquals(4, firstDiscovery.size()); assertEquals(firstDiscovery, secondDiscovery); assertEquals("开发模拟器", firstDiscovery.get(0).deviceMetadata().manufacturer()); assertEquals("BTS Virtual Cabinet", firstDiscovery.get(0).deviceMetadata().model()); assertEquals(1, firstDiscovery.stream().map(channel -> channel.identity().devid()).distinct().count()); assertEquals(4, firstDiscovery.stream().filter(channel -> channel.available()).count()); Set channels = firstDiscovery.stream() .map(channel -> channel.identity()) .collect(java.util.stream.Collectors.toSet()); var firstObservation = adapter.inquire(channels); var secondObservation = adapter.inquire(channels); assertEquals(4, firstObservation.size()); assertEquals(DeviceWorkStatus.STOPPED, firstObservation.values().iterator().next().workStatus()); assertEquals(firstObservation.keySet(), secondObservation.keySet()); } } @Test void developmentSimulatorPublishesOperatorControlledChannelFacts() throws Exception { try (BtsDevelopmentSimulator simulator = new BtsDevelopmentSimulator(0); BtsTcpTransport transport = new BtsTcpTransport("127.0.0.1", simulator.port(), Duration.ofSeconds(1), Duration.ofSeconds(1)); DeviceAdapter adapter = new BtsDeviceAdapter("dev-sim", transport, new BtsXmlCodec("dev-sim", ZoneId.of("Asia/Hong_Kong")))) { simulator.updateChannel(1, 1, true, DeviceWorkStatus.WORKING); simulator.updateChannel(1, 2, false, DeviceWorkStatus.PAUSED); var discovered = adapter.discoverChannels(); Set available = discovered.stream() .filter(channel -> channel.available()) .map(channel -> channel.identity()) .collect(java.util.stream.Collectors.toSet()); var observed = adapter.inquire(available); assertEquals(4, discovered.size()); assertEquals(3, available.size()); assertEquals(DeviceWorkStatus.WORKING, observed.entrySet().stream() .filter(entry -> entry.getKey().chlid() == 1) .findFirst().orElseThrow().getValue().workStatus()); simulator.updateDevice(1, "127.0.0.2", 4, false); assertEquals(0, adapter.discoverChannels().stream().filter(channel -> channel.available()).count()); assertEquals(4, simulator.snapshot().devices().get(0).channels().size()); assertEquals(3, simulator.snapshot().recentRequests().size()); } } @Test void developmentSimulatorSupportsMultipleConfigurableDevices() throws Exception { try (BtsDevelopmentSimulator simulator = new BtsDevelopmentSimulator(0); BtsTcpTransport transport = new BtsTcpTransport("127.0.0.1", simulator.port(), Duration.ofSeconds(1), Duration.ofSeconds(1)); DeviceAdapter adapter = new BtsDeviceAdapter("dev-sim", transport, new BtsXmlCodec("dev-sim", ZoneId.of("Asia/Hong_Kong")))) { int secondDeviceId = simulator.addDevice("127.0.0.3", 2); simulator.updateDevice(1, "127.0.0.2", 4, true); var discovered = adapter.discoverChannels(); assertEquals(6, discovered.size()); assertEquals(2, discovered.stream().map(channel -> channel.identity().devid()).distinct().count()); assertEquals(4, discovered.stream().filter(channel -> channel.serverIp().equals("127.0.0.2")).count()); assertEquals(2, discovered.stream().filter(channel -> channel.serverIp().equals("127.0.0.3")).count()); simulator.deleteDevice(secondDeviceId); for (int index = 0; index < 3; index++) { var withTombstone = adapter.discoverChannels(); assertEquals(6, withTombstone.size()); assertEquals(4, withTombstone.stream().filter(DetectedChannel::available).count()); } assertEquals(4, adapter.discoverChannels().size()); } } @Test void developmentCollectorsNeverEnterBtsCabinetDiscovery() throws Exception { try (BtsDevelopmentSimulator simulator = new BtsDevelopmentSimulator(0); BtsTcpTransport transport = new BtsTcpTransport("127.0.0.1", simulator.port(), Duration.ofSeconds(1), Duration.ofSeconds(1)); DeviceAdapter adapter = new BtsDeviceAdapter("dev-sim", transport, new BtsXmlCodec("dev-sim", ZoneId.of("Asia/Hong_Kong")))) { assertEquals(4, adapter.discoverChannels().size()); simulator.addCollector("127.0.1.8", 12); assertEquals(4, adapter.discoverChannels().size()); assertEquals(2, simulator.snapshot().collectors().size()); } } @Test void developmentSimulatorRestoresConfigurationNumberingAndStatus() throws Exception { InMemoryBtsSimulatorStateStore store = new InMemoryBtsSimulatorStateStore(); try (BtsDevelopmentSimulator first = new BtsDevelopmentSimulator(0, store)) { first.updateDevice(1, "127.0.0.9", 2, false); first.addDevice("127.0.0.10", 3); first.updateCollector(1, "127.0.1.9", 7, false); } try (BtsDevelopmentSimulator restored = new BtsDevelopmentSimulator(0, store)) { assertEquals(2, restored.snapshot().devices().size()); assertEquals("127.0.0.9", restored.snapshot().devices().get(0).ip()); assertEquals(false, restored.snapshot().devices().get(0).online()); assertEquals(7, restored.snapshot().collectors().get(0).channelCount()); assertEquals(3, restored.addDevice("127.0.0.11", 1)); } } @Test void developmentSimulatorDoesNotExposeWriteThroughFailureInMemory() throws Exception { InMemoryBtsSimulatorStateStore delegate = new InMemoryBtsSimulatorStateStore(); BtsSimulatorStateStore failing = new BtsSimulatorStateStore() { @Override public SimulatorState loadOrInitialize(SimulatorState value) { return delegate.loadOrInitialize(value); } @Override public void save(SimulatorState value) { throw new IllegalStateException("redis unavailable"); } @Override public java.util.List loadRecentRequests() { return delegate.loadRecentRequests(); } @Override public void saveRecentRequests(java.util.List requests) { delegate.saveRecentRequests(requests); } @Override public void reset(SimulatorState value) { delegate.reset(value); } }; try (BtsDevelopmentSimulator simulator = new BtsDevelopmentSimulator(0, failing)) { assertThrows(IllegalStateException.class, () -> simulator.addDevice("127.0.0.3", 2)); assertEquals(1, simulator.snapshot().devices().size()); } } @Test void developmentSimulatorRestoresUnfinishedTombstones() throws Exception { InMemoryBtsSimulatorStateStore store = new InMemoryBtsSimulatorStateStore(); try (BtsDevelopmentSimulator first = new BtsDevelopmentSimulator(0, store); BtsTcpTransport transport = new BtsTcpTransport("127.0.0.1", first.port(), Duration.ofSeconds(1), Duration.ofSeconds(1)); DeviceAdapter adapter = new BtsDeviceAdapter("dev-sim", transport, new BtsXmlCodec("dev-sim", ZoneId.of("Asia/Hong_Kong")))) { first.deleteDevice(1); assertEquals(4, adapter.discoverChannels().size()); } try (BtsDevelopmentSimulator restored = new BtsDevelopmentSimulator(0, store); BtsTcpTransport transport = new BtsTcpTransport("127.0.0.1", restored.port(), Duration.ofSeconds(1), Duration.ofSeconds(1)); DeviceAdapter adapter = new BtsDeviceAdapter("dev-sim", transport, new BtsXmlCodec("dev-sim", ZoneId.of("Asia/Hong_Kong")))) { assertEquals(4, adapter.discoverChannels().size()); assertEquals(4, adapter.discoverChannels().size()); assertEquals(0, adapter.discoverChannels().size()); } } @Test void developmentSimulatorRejectsNonContiguousRestoredChannelTopology() { SimulatorState damaged = new SimulatorState(BtsSimulatorStateStore.CURRENT_VERSION, java.util.List.of(new DeviceState(1, "127.0.0.2", true, java.util.List.of(new ChannelState(2, true, DeviceWorkStatus.STOPPED)))), java.util.List.of(), 2, 1, java.util.List.of()); assertThrows(IllegalStateException.class, () -> new BtsDevelopmentSimulator(0, new InMemoryBtsSimulatorStateStore(damaged))); } @Test void developmentSimulatorRejectsDamagedCollectorHistoryIdentity() { Instant observedAt = Instant.parse("2026-08-29T05:00:00Z"); List channels = List.of(new CollectorChannelState("S-01", List.of( new CollectorMetricState("temperature", new BigDecimal("25.0"), "℃")))); CollectorState collector = new CollectorState(1, "dev-sim-collector-1", "127.0.1.2", "02:43:00:00:00:01", "模拟采集器", "开发模拟器", "Virtual Collector", 1, true, 1000, 2L, observedAt, channels, List.of(), List.of(new CollectorMeasurementRecord( "dev-sim", "wrong-collector", "S-01", 1L, observedAt, "2026-08-29 13:00:00.000", observedAt, "temperature", new BigDecimal("25.0"), "℃")), CollectorHistoryFaults.none()); SimulatorState damaged = new SimulatorState(BtsSimulatorStateStore.CURRENT_VERSION, List.of(), List.of(collector), 1, 2, List.of()); assertThrows(IllegalStateException.class, () -> new BtsDevelopmentSimulator(0, new InMemoryBtsSimulatorStateStore(damaged))); } @Test void developmentSimulatorRejectsCollectorSequenceBehindPersistedHistory() { Instant observedAt = Instant.parse("2026-08-29T06:00:00Z"); List channels = List.of(new CollectorChannelState("S-01", List.of( new CollectorMetricState("temperature", new BigDecimal("25.0"), "℃")))); CollectorState collector = new CollectorState(1, "dev-sim-collector-1", "127.0.1.2", "02:43:00:00:00:01", "模拟采集器", "开发模拟器", "Virtual Collector", 1, true, 1000, 1L, observedAt, channels, List.of(), List.of(new CollectorMeasurementRecord( "dev-sim", "dev-sim-collector-1", "S-01", 1L, observedAt, "2026-08-29 14:00:00.000", observedAt, "temperature", new BigDecimal("25.0"), "℃")), CollectorHistoryFaults.none()); SimulatorState damaged = new SimulatorState(BtsSimulatorStateStore.CURRENT_VERSION, List.of(), List.of(collector), 1, 2, List.of()); assertThrows(IllegalStateException.class, () -> new BtsDevelopmentSimulator(0, new InMemoryBtsSimulatorStateStore(damaged))); } }