using Microsoft.Extensions.DependencyInjection; using NSubstitute; using ZB.MOM.WW.ScadaBridge.CentralUI.Services; using ZB.MOM.WW.ScadaBridge.Commons.Entities.Instances; using ZB.MOM.WW.ScadaBridge.Commons.Entities.Sites; using ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Repositories; using ZB.MOM.WW.ScadaBridge.Commons.Messages.DebugView; using ZB.MOM.WW.ScadaBridge.Commons.Messages.Streaming; using ZB.MOM.WW.ScadaBridge.Commons.Types.Enums; using ZB.MOM.WW.ScadaBridge.Communication; namespace ZB.MOM.WW.ScadaBridge.CentralUI.Tests.Services; /// /// Unit tests for (arch-review WP2.4). The Alarm /// Summary page polls per circuit; the shared façade must collapse those into ONE per-site /// fan-out per freshness window, and must widen that window while the live alarm cache is /// serving the site (where the poll only still supplies the not-reporting list). /// public class SharedAlarmSummaryServiceTests : IDisposable { private const int SiteId = 7; private const string SiteIdentifier = "plant-a"; private static readonly DateTimeOffset T0 = new(2026, 8, 14, 9, 0, 0, TimeSpan.Zero); private readonly ITemplateEngineRepository _instanceRepo = Substitute.For(); private readonly ISiteRepository _siteRepo = Substitute.For(); private readonly IInstanceSnapshotClient _snapshotClient = Substitute.For(); private readonly FakeLiveCache _liveCache = new(); private readonly ServiceProvider _provider; private DateTimeOffset _now = T0; public SharedAlarmSummaryServiceTests() { _siteRepo.GetSiteByIdAsync(SiteId, Arg.Any()) .Returns(new Site("Plant A", SiteIdentifier) { Id = SiteId }); _instanceRepo.GetInstancesBySiteIdAsync(SiteId, Arg.Any()) .Returns(new List { new("inst-a") { Id = 1, SiteId = SiteId, State = InstanceState.Enabled }, }); _snapshotClient.GetSnapshotAsync(SiteIdentifier, "inst-a", Arg.Any()) .Returns(new DebugViewSnapshot( "inst-a", Array.Empty(), new[] { new AlarmStateChanged("inst-a", "A-alarm", AlarmState.Active, 500, T0) }, T0)); var services = new ServiceCollection(); services.AddSingleton(_instanceRepo); services.AddSingleton(_siteRepo); services.AddSingleton(_snapshotClient); services.AddScoped(); _provider = services.BuildServiceProvider(); } private SharedAlarmSummaryService CreateSut(TimeSpan liveCacheTtl) => new(_provider.GetRequiredService(), _liveCache, liveCacheTtl, () => _now); [Fact] public async Task ConcurrentCircuits_ShareOneFanOut() { var sut = CreateSut(TimeSpan.FromSeconds(60)); var results = await Task.WhenAll(Enumerable.Range(0, 8).Select(_ => sut.GetSiteAlarmsAsync(SiteId))); await _instanceRepo.Received(1).GetInstancesBySiteIdAsync(SiteId, Arg.Any()); Assert.All(results, r => Assert.Single(r.Alarms)); } [Fact] public async Task ColdLiveCache_RefreshesWithinThePageTick() { var sut = CreateSut(TimeSpan.FromSeconds(60)); _liveCache.Live = false; await sut.GetSiteAlarmsAsync(SiteId); // The page polls every 15s and, while the cache is cold, the poll is its // authoritative rebuild — so the memo must have expired by then. _now = T0.AddSeconds(15); await sut.GetSiteAlarmsAsync(SiteId); await _instanceRepo.Received(2).GetInstancesBySiteIdAsync(SiteId, Arg.Any()); } [Fact] public async Task LiveCacheServing_WidensTheWindowToTheReconcileInterval() { var sut = CreateSut(TimeSpan.FromSeconds(60)); _liveCache.Live = true; await sut.GetSiteAlarmsAsync(SiteId); _now = T0.AddSeconds(30); await sut.GetSiteAlarmsAsync(SiteId); // Live deltas own the rows; only the not-reporting list still comes from the // fan-out, so a 30s-old answer is fine and costs no second fan-out. await _instanceRepo.Received(1).GetInstancesBySiteIdAsync(SiteId, Arg.Any()); _now = T0.AddSeconds(61); await sut.GetSiteAlarmsAsync(SiteId); await _instanceRepo.Received(2).GetInstancesBySiteIdAsync(SiteId, Arg.Any()); } [Fact] public async Task DifferentSites_DoNotShareAMemoSlot() { const int otherSite = 8; _siteRepo.GetSiteByIdAsync(otherSite, Arg.Any()) .Returns(new Site("Plant B", "plant-b") { Id = otherSite }); _instanceRepo.GetInstancesBySiteIdAsync(otherSite, Arg.Any()) .Returns(new List()); var sut = CreateSut(TimeSpan.FromSeconds(60)); await sut.GetSiteAlarmsAsync(SiteId); await sut.GetSiteAlarmsAsync(otherSite); await _instanceRepo.Received(1).GetInstancesBySiteIdAsync(SiteId, Arg.Any()); await _instanceRepo.Received(1).GetInstancesBySiteIdAsync(otherSite, Arg.Any()); } [Fact] public void PureMethods_MatchTheDirectImplementation() { var sut = CreateSut(TimeSpan.FromSeconds(60)); var direct = new AlarmSummaryService(_instanceRepo, _siteRepo, _snapshotClient); var alarms = new List { new("inst-b", "B-alarm", AlarmState.Active, 900, T0), new("inst-a", "A-alarm", AlarmState.Normal, 100, T0), }; var shared = sut.BuildFromLiveAlarms(alarms); var expected = direct.BuildFromLiveAlarms(alarms); Assert.Equal( expected.Alarms.Select(r => r.Alarm.AlarmName), shared.Alarms.Select(r => r.Alarm.AlarmName)); var expectedRollup = direct.ComputeRollup(expected.Alarms); var sharedRollup = sut.ComputeRollup(shared.Alarms); Assert.Equal(expectedRollup.TotalActive, sharedRollup.TotalActive); Assert.Equal(expectedRollup.WorstSeverity, sharedRollup.WorstSeverity); Assert.Equal(expectedRollup.UnackedCount, sharedRollup.UnackedCount); Assert.Equal(expectedRollup.CountsByKind, sharedRollup.CountsByKind); } public void Dispose() => _provider.Dispose(); /// Liveness-only stub — the façade consults nothing else on the live cache. private sealed class FakeLiveCache : ISiteAlarmLiveCache { public bool Live { get; set; } public IDisposable Subscribe(int siteId, Action onChanged) => new NoOp(); public IReadOnlyList GetCurrentAlarms(int siteId) => Array.Empty(); public bool IsLive(int siteId) => Live; private sealed class NoOp : IDisposable { public void Dispose() { } } } }