refactor: rename ScadaLink → ZB.MOM.WW.ScadaBridge (code + projects + namespaces)

Solution + 23 src projects + 26 test projects renamed; folders, csproj, namespaces, and ScadaLinkDbContext/ScadaBridgeDbContext class updated. ActorSystem "scadalink" → "scadabridge", Akka seed-node URLs migrated. SQL roles/logins, LDAP domains, CLI command name, and CLI config dir (~/.scadalink → ~/.scadabridge) also renamed. Build green; 5 Host.Tests fail awaiting SQL login rename in next commit. Pre-existing StaleTagMonitor timing flakes unchanged. Rename script committed at tools/rename-to-scadabridge.sh.
2026-05-28 09:37:45 -04:00
parent 6d87ee3c3b
commit 7b0b9c7365
1531 changed files with 11180 additions and 11054 deletions
@@ -0,0 +1,59 @@
+using System.Security.Cryptography;
+using ZB.MOM.WW.ScadaBridge.Commons.Types.Transport;
+
+namespace ZB.MOM.WW.ScadaBridge.Transport.Serialization;
+
+/// <summary>
+/// Builds a <see cref="BundleManifest"/> for a freshly serialized bundle.
+/// Stamps the current format/schema version, captures the SHA-256 hash of the
+/// raw (post-encryption) content bytes, and copies through the supplied summary
+/// and content entries verbatim.
+/// </summary>
+public sealed class ManifestBuilder
+{
+    public const int CurrentBundleFormatVersion = 1;
+    public const string CurrentSchemaVersion = "1.0";
+
+    /// <summary>
+    /// Builds a <see cref="BundleManifest"/> with the current format version, a SHA-256 content hash,
+    /// and all supplied metadata.
+    /// </summary>
+    /// <param name="sourceEnvironment">Environment label identifying where the bundle was exported from.</param>
+    /// <param name="exportedBy">Username of the operator who performed the export.</param>
+    /// <param name="scadaLinkVersion">ScadaBridge version string stamped in the manifest.</param>
+    /// <param name="encryption">Encryption metadata when the content is encrypted; null for plain bundles.</param>
+    /// <param name="summary">High-level summary of artifact counts.</param>
+    /// <param name="contents">Per-entry content table describing each artifact in the bundle.</param>
+    /// <param name="contentBytes">Raw content bytes whose SHA-256 hash is computed and stamped.</param>
+    /// <returns>A fully populated <see cref="BundleManifest"/>.</returns>
+    public BundleManifest Build(
+        string sourceEnvironment,
+        string exportedBy,
+        string scadaLinkVersion,
+        EncryptionMetadata? encryption,
+        BundleSummary summary,
+        IReadOnlyList<ManifestContentEntry> contents,
+        byte[] contentBytes)
+    {
+        ArgumentNullException.ThrowIfNull(sourceEnvironment);
+        ArgumentNullException.ThrowIfNull(exportedBy);
+        ArgumentNullException.ThrowIfNull(scadaLinkVersion);
+        ArgumentNullException.ThrowIfNull(summary);
+        ArgumentNullException.ThrowIfNull(contents);
+        ArgumentNullException.ThrowIfNull(contentBytes);
+
+        var contentHash = "sha256:" + Convert.ToHexString(SHA256.HashData(contentBytes)).ToLowerInvariant();
+
+        return new BundleManifest(
+            BundleFormatVersion: CurrentBundleFormatVersion,
+            SchemaVersion: CurrentSchemaVersion,
+            CreatedAtUtc: DateTimeOffset.UtcNow,
+            SourceEnvironment: sourceEnvironment,
+            ExportedBy: exportedBy,
+            ScadaBridgeVersion: scadaLinkVersion,
+            ContentHash: contentHash,
+            Encryption: encryption,
+            Summary: summary,
+            Contents: contents);
+    }
+}