feat(adminui): driver-snapshot GetAll() + pure Hosts driver-view builder (#8)

2026-06-18 11:40:37 -04:00
parent d203f31cb7
commit cb062fce90
4 changed files with 287 additions and 0 deletions
@@ -0,0 +1,157 @@
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.AdminUI.Hosts;
+using ZB.MOM.WW.OtOpcUa.Commons.Messages.Drivers;
+
+namespace ZB.MOM.WW.OtOpcUa.AdminUI.Tests.Hosts;
+
+/// <summary>
+///     Covers <see cref="HostsDriverView.Build"/>: the pure, DB-agnostic view-model builder that
+///     groups driver-health snapshots by cluster, attaches each cluster's nodes, and enriches each
+///     driver row with the configured name + type. The builder is null-safe and stable-ordered so
+///     the (later) <c>/hosts</c> Razor section renders deterministically.
+/// </summary>
+public sealed class HostsDriverViewTests
+{
+    private static readonly DateTime When = new(2026, 6, 18, 0, 0, 0, DateTimeKind.Utc);
+
+    private static DriverHealthChanged Snap(string cluster, string instance, string state = "Healthy") =>
+        new(cluster, instance, state, null, null, 0, When);
+
+    private static HostsNodeInfo Node(string cluster, string node, string host = "h", int port = 4840) =>
+        new(cluster, node, host, port);
+
+    private static HostsDriverInstanceInfo Instance(string instance, string cluster, string name, string type) =>
+        new(instance, cluster, name, type);
+
+    [Fact]
+    public void Build_groups_two_clusters_with_their_nodes_and_snapshots()
+    {
+        var snaps = new[]
+        {
+            Snap("MAIN", "drv-a"),
+            Snap("EDGE", "drv-b"),
+        };
+        var nodes = new[]
+        {
+            Node("MAIN", "MAIN-1"),
+            Node("EDGE", "EDGE-1"),
+        };
+
+        var groups = HostsDriverView.Build(snaps, nodes, instances: null);
+
+        groups.Count.ShouldBe(2);
+        var main = groups.Single(g => g.ClusterId == "MAIN");
+        var edge = groups.Single(g => g.ClusterId == "EDGE");
+
+        main.Nodes.Select(n => n.NodeId).ShouldBe(new[] { "MAIN-1" });
+        main.Drivers.Select(d => d.DriverInstanceId).ShouldBe(new[] { "drv-a" });
+        edge.Nodes.Select(n => n.NodeId).ShouldBe(new[] { "EDGE-1" });
+        edge.Drivers.Select(d => d.DriverInstanceId).ShouldBe(new[] { "drv-b" });
+    }
+
+    [Fact]
+    public void Build_enriches_driver_row_from_matching_instance()
+    {
+        var groups = HostsDriverView.Build(
+            new[] { Snap("MAIN", "drv-a", "Faulted") },
+            nodes: null,
+            new[] { Instance("drv-a", "MAIN", "Pump House Modbus", "Modbus") });
+
+        var row = groups.Single().Drivers.Single();
+        row.DriverInstanceId.ShouldBe("drv-a");
+        row.Name.ShouldBe("Pump House Modbus");
+        row.DriverType.ShouldBe("Modbus");
+        row.State.ShouldBe("Faulted");
+    }
+
+    [Fact]
+    public void Build_leaves_name_and_type_null_for_unknown_driver()
+    {
+        var groups = HostsDriverView.Build(
+            new[] { Snap("MAIN", "orphan") },
+            nodes: null,
+            new[] { Instance("drv-a", "MAIN", "Known", "Modbus") });
+
+        var row = groups.Single().Drivers.Single(d => d.DriverInstanceId == "orphan");
+        row.Name.ShouldBeNull();
+        row.DriverType.ShouldBeNull();
+    }
+
+    [Fact]
+    public void Build_includes_cluster_with_nodes_but_no_snapshots()
+    {
+        var groups = HostsDriverView.Build(
+            snapshots: null,
+            new[] { Node("MAIN", "MAIN-1") },
+            instances: null);
+
+        var group = groups.Single();
+        group.ClusterId.ShouldBe("MAIN");
+        group.Nodes.Count.ShouldBe(1);
+        group.Drivers.ShouldBeEmpty();
+    }
+
+    [Fact]
+    public void Build_with_empty_inputs_returns_empty_list()
+    {
+        HostsDriverView.Build(
+            Array.Empty<DriverHealthChanged>(),
+            Array.Empty<HostsNodeInfo>(),
+            Array.Empty<HostsDriverInstanceInfo>()).ShouldBeEmpty();
+    }
+
+    [Fact]
+    public void Build_with_all_null_inputs_returns_empty_list_without_throwing()
+    {
+        HostsDriverView.Build(snapshots: null, nodes: null, instances: null).ShouldBeEmpty();
+    }
+
+    [Fact]
+    public void Build_orders_drivers_by_name_then_instance_id()
+    {
+        var snaps = new[]
+        {
+            Snap("MAIN", "drv-z"),  // no instance -> null name -> sorts by id "drv-z"
+            Snap("MAIN", "drv-a"),  // no instance -> null name -> sorts by id "drv-a"
+            Snap("MAIN", "drv-m"),  // named "Alpha"
+        };
+        var instances = new[]
+        {
+            Instance("drv-m", "MAIN", "Alpha", "Modbus"),
+        };
+
+        var drivers = HostsDriverView.Build(snaps, nodes: null, instances).Single().Drivers;
+
+        // Sort key is (Name ?? DriverInstanceId): "Alpha"(drv-m), "drv-a", "drv-z".
+        drivers.Select(d => d.DriverInstanceId).ShouldBe(new[] { "drv-m", "drv-a", "drv-z" });
+    }
+
+    [Fact]
+    public void Build_takes_first_when_instance_id_appears_twice()
+    {
+        var groups = HostsDriverView.Build(
+            new[] { Snap("MAIN", "drv-a") },
+            nodes: null,
+            new[]
+            {
+                Instance("drv-a", "MAIN", "First", "Modbus"),
+                Instance("drv-a", "MAIN", "Second", "S7"),
+            });
+
+        var row = groups.Single().Drivers.Single();
+        row.Name.ShouldBe("First");
+        row.DriverType.ShouldBe("Modbus");
+    }
+
+    [Fact]
+    public void Build_orders_clusters_case_insensitively()
+    {
+        var groups = HostsDriverView.Build(
+            new[] { Snap("zeta", "d1"), Snap("Alpha", "d2") },
+            new[] { Node("Beta", "b1") },
+            instances: null);
+
+        groups.Select(g => g.ClusterId).ShouldBe(new[] { "Alpha", "Beta", "zeta" });
+    }
+}