feat(controlplane): AdminOperationsActor + ConfigComposer + StartDeployment flow

2026-05-26 04:53:28 -04:00
parent 9f61cd5989
commit ef683f5073
4 changed files with 330 additions and 0 deletions
@@ -0,0 +1,54 @@
+using System.Security.Cryptography;
+using System.Text.Json;
+using Microsoft.EntityFrameworkCore;
+using ZB.MOM.WW.OtOpcUa.Configuration;
+using ZB.MOM.WW.OtOpcUa.Configuration.Entities;
+
+namespace ZB.MOM.WW.OtOpcUa.ControlPlane.AdminOperations;
+
+/// <summary>
+/// Pure snapshot composer: reads the current live-edit state from <see cref="OtOpcUaConfigDbContext"/>
+/// and serialises it into a deterministic byte[] artifact + SHA-256 hex revision hash. Determinism
+/// comes from sorting every collection by its natural key before serialising, so two snapshots over
+/// the same DB state always produce the same hash regardless of EF row ordering.
+/// </summary>
+public static class ConfigComposer
+{
+    public sealed record ConfigArtifact(byte[] Blob, string RevisionHash);
+
+    private static readonly JsonSerializerOptions JsonOptions = new()
+    {
+        WriteIndented = false,
+        DefaultIgnoreCondition = System.Text.Json.Serialization.JsonIgnoreCondition.Never,
+    };
+
+    public static async Task<ConfigArtifact> SnapshotAndFlattenAsync(
+        OtOpcUaConfigDbContext db, CancellationToken ct = default)
+    {
+        var snapshot = new
+        {
+            Clusters = await db.ServerClusters.AsNoTracking().OrderBy(x => x.ClusterId).ToListAsync(ct),
+            Nodes = await db.ClusterNodes.AsNoTracking().OrderBy(x => x.NodeId).ToListAsync(ct),
+            DriverInstances = await db.DriverInstances.AsNoTracking().OrderBy(x => x.DriverInstanceId).ToListAsync(ct),
+            Devices = await db.Devices.AsNoTracking().OrderBy(x => x.DeviceId).ToListAsync(ct),
+            Equipment = await db.Equipment.AsNoTracking().OrderBy(x => x.EquipmentId).ToListAsync(ct),
+            Tags = await db.Tags.AsNoTracking().OrderBy(x => x.TagId).ToListAsync(ct),
+            PollGroups = await db.PollGroups.AsNoTracking().OrderBy(x => x.PollGroupId).ToListAsync(ct),
+            Namespaces = await db.Namespaces.AsNoTracking().OrderBy(x => x.NamespaceId).ToListAsync(ct),
+            UnsAreas = await db.UnsAreas.AsNoTracking().OrderBy(x => x.UnsAreaId).ToListAsync(ct),
+            UnsLines = await db.UnsLines.AsNoTracking().OrderBy(x => x.UnsLineId).ToListAsync(ct),
+            NodeAcls = await db.NodeAcls.AsNoTracking().OrderBy(x => x.NodeAclId).ToListAsync(ct),
+            Scripts = await db.Scripts.AsNoTracking().OrderBy(x => x.ScriptId).ToListAsync(ct),
+            VirtualTags = await db.VirtualTags.AsNoTracking().OrderBy(x => x.VirtualTagId).ToListAsync(ct),
+            ScriptedAlarms = await db.ScriptedAlarms.AsNoTracking().OrderBy(x => x.ScriptedAlarmId).ToListAsync(ct),
+        };
+
+        var blob = JsonSerializer.SerializeToUtf8Bytes(snapshot, JsonOptions);
+        var hash = Convert.ToHexStringLower(SHA256.HashData(blob));
+        return new ConfigArtifact(blob, hash);
+    }
+
+    /// <summary>Returns the SHA-256 hex digest of the supplied artifact bytes (lowercase, no prefix).</summary>
+    public static string HashOf(ReadOnlySpan<byte> blob) =>
+        Convert.ToHexStringLower(SHA256.HashData(blob));
+}