mbproxy: replace status page with a live SignalR web dashboard

The single auto-refreshing zero-JS status page gave operators a 25-column wall and no way to drill into one connection. This adds a Bootstrap fleet dashboard (filterable/sortable KPI table) and a per-PLC detail page with a real-time debug view of raw PLC-side BCD vs. decoded client-side values, streamed live over a SignalR feed. The debug view is fed by an on-demand per-tag value capture, armed only while a detail page is open. All assets (Bootstrap, SignalR client, fonts) are embedded so the UI works unchanged on firewalled networks; GET /status.json is untouched for scrapers. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-15 10:40:21 -04:00
parent b330faff03
commit e719dd51c1
49 changed files with 3539 additions and 424 deletions
@@ -0,0 +1,120 @@
+using Mbproxy.Admin;
+using Mbproxy.Bcd;
+using Mbproxy.Options;
+using Mbproxy.Proxy;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Logging.Abstractions;
+using Microsoft.Extensions.Options;
+using Serilog;
+using Shouldly;
+using Xunit;
+
+namespace Mbproxy.Tests.Admin;
+
+/// <summary>
+/// Unit tests for <see cref="StatusBroadcaster"/>'s push-cycle logic — fleet always
+/// pushed, per-PLC pushed only for PLCs with a detail-page subscriber, and every
+/// capture disarmed on stop. The SignalR sink is faked; a real
+/// <see cref="StatusSnapshotBuilder"/> is resolved from a minimal in-process host.
+/// </summary>
+[Trait("Category", "Unit")]
+public sealed class StatusBroadcasterTests
+{
+    private sealed record Harness(
+        IHost Host,
+        StatusBroadcaster Broadcaster,
+        FakeStatusPushSink Sink,
+        StatusSnapshotBuilder Builder,
+        TagCaptureRegistry Registry,
+        PlcSubscriptionTracker Tracker) : IAsyncDisposable
+    {
+        public async ValueTask DisposeAsync()
+        {
+            await Broadcaster.DisposeAsync();
+            using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
+            try { await Host.StopAsync(cts.Token); } catch { }
+            Host.Dispose();
+        }
+    }
+
+    private static async Task<Harness> BuildAsync()
+    {
+        var hostBuilder = Host.CreateApplicationBuilder();
+        hostBuilder.Configuration.AddInMemoryCollection(new Dictionary<string, string?>
+        {
+            ["Mbproxy:AdminPort"] = "0",
+        });
+        hostBuilder.Services.AddSerilog(
+            new LoggerConfiguration().MinimumLevel.Fatal().CreateLogger(), dispose: false);
+        hostBuilder.AddMbproxyOptions();
+        hostBuilder.Services.AddSingleton<IPduPipeline, NoopPduPipeline>();
+        hostBuilder.Services.AddSingleton<ProxyWorker>();
+        hostBuilder.Services.AddHostedService(sp => sp.GetRequiredService<ProxyWorker>());
+        hostBuilder.Services.AddSingleton<AssemblyVersionAccessor>();
+        hostBuilder.Services.AddSingleton<StatusSnapshotBuilder>();
+
+        var host = hostBuilder.Build();
+        using var startCts = new CancellationTokenSource(TimeSpan.FromSeconds(15));
+        await host.StartAsync(startCts.Token);
+
+        var builder  = host.Services.GetRequiredService<StatusSnapshotBuilder>();
+        var registry = host.Services.GetRequiredService<TagCaptureRegistry>();
+        var options  = host.Services.GetRequiredService<IOptionsMonitor<MbproxyOptions>>();
+        var tracker  = new PlcSubscriptionTracker();
+        var sink     = new FakeStatusPushSink();
+
+        var broadcaster = new StatusBroadcaster(
+            sink, builder, tracker, registry, options, NullLogger.Instance);
+
+        return new Harness(host, broadcaster, sink, builder, registry, tracker);
+    }
+
+    [Fact]
+    public async Task PushOnce_AlwaysPushesFleet()
+    {
+        await using var h = await BuildAsync();
+
+        await h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken);
+
+        h.Sink.FleetPushes.Count.ShouldBe(1);
+    }
+
+    [Fact]
+    public async Task PushOnce_NoActivePlcs_SkipsPerPlcPush()
+    {
+        await using var h = await BuildAsync();
+
+        await h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken);
+
+        h.Sink.PlcPushes.ShouldBeEmpty();
+    }
+
+    [Fact]
+    public async Task PushOnce_ActivePlc_PushesDetailWithDebugSnapshot()
+    {
+        await using var h = await BuildAsync();
+        h.Registry.GetOrCreate("plc-x", BcdTagMap.Empty);
+        h.Tracker.Add("conn-1", "plc-x");
+
+        await h.Broadcaster.PushOnceAsync(TestContext.Current.CancellationToken);
+
+        var push = h.Sink.PlcPushes.ShouldHaveSingleItem();
+        push.Plc.ShouldBe("plc-x");
+        push.Detail.Debug.ShouldNotBeNull();
+    }
+
+    [Fact]
+    public async Task StopAsync_DisarmsEveryCapture()
+    {
+        await using var h = await BuildAsync();
+        h.Registry.GetOrCreate("plc-x", BcdTagMap.Empty);
+        h.Registry.Arm("plc-x");
+
+        await h.Broadcaster.StopAsync();
+
+        h.Registry.TryGet("plc-x", out var capture).ShouldBeTrue();
+        capture.IsArmed.ShouldBeFalse();
+    }
+}