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,19 @@
+namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.RemoteQuery;
+
+/// <summary>
+/// Request to query site event logs from central.
+/// Supports filtering by event type, severity, instance, time range, and keyword search.
+/// Uses keyset pagination via continuation token (last event ID).
+/// </summary>
+public record EventLogQueryRequest(
+    string CorrelationId,
+    string SiteId,
+    DateTimeOffset? From,
+    DateTimeOffset? To,
+    string? EventType,
+    string? Severity,
+    string? InstanceId,
+    string? KeywordFilter,
+    long? ContinuationToken,
+    int PageSize,
+    DateTimeOffset Timestamp);
@@ -0,0 +1,28 @@
+namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.RemoteQuery;
+
+/// <summary>
+/// A single event log entry returned from a site query.
+/// </summary>
+public record EventLogEntry(
+    long Id,
+    DateTimeOffset Timestamp,
+    string EventType,
+    string Severity,
+    string? InstanceId,
+    string Source,
+    string Message,
+    string? Details);
+
+/// <summary>
+/// Response containing paginated event log entries from a site.
+/// Uses keyset pagination: ContinuationToken is the last event ID in the result set.
+/// </summary>
+public record EventLogQueryResponse(
+    string CorrelationId,
+    string SiteId,
+    IReadOnlyList<EventLogEntry> Entries,
+    long? ContinuationToken,
+    bool HasMore,
+    bool Success,
+    string? ErrorMessage,
+    DateTimeOffset Timestamp);
@@ -0,0 +1,18 @@
+namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.RemoteQuery;
+
+/// <summary>
+/// Request to permanently discard a parked message at a site.
+/// </summary>
+public record ParkedMessageDiscardRequest(
+    string CorrelationId,
+    string SiteId,
+    string MessageId,
+    DateTimeOffset Timestamp);
+
+/// <summary>
+/// Response from discarding a parked message.
+/// </summary>
+public record ParkedMessageDiscardResponse(
+    string CorrelationId,
+    bool Success,
+    string? ErrorMessage = null);
@@ -0,0 +1,11 @@
+namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.RemoteQuery;
+
+/// <summary>
+/// Request to query parked (permanently failed) store-and-forward messages at a site.
+/// </summary>
+public record ParkedMessageQueryRequest(
+    string CorrelationId,
+    string SiteId,
+    int PageNumber,
+    int PageSize,
+    DateTimeOffset Timestamp);
@@ -0,0 +1,29 @@
+using ZB.MOM.WW.ScadaBridge.Commons.Types.Enums;
+
+namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.RemoteQuery;
+
+/// <summary>
+/// Response containing parked store-and-forward messages from a site.
+/// </summary>
+public record ParkedMessageEntry(
+    string MessageId,
+    string TargetSystem,
+    string MethodName,
+    string ErrorMessage,
+    int AttemptCount,
+    DateTimeOffset OriginalTimestamp,
+    DateTimeOffset LastAttemptTimestamp,
+    int MaxAttempts = 0,
+    StoreAndForwardCategory Category = StoreAndForwardCategory.ExternalSystem,
+    string? OriginInstance = null);
+
+public record ParkedMessageQueryResponse(
+    string CorrelationId,
+    string SiteId,
+    IReadOnlyList<ParkedMessageEntry> Messages,
+    int TotalCount,
+    int PageNumber,
+    int PageSize,
+    bool Success,
+    string? ErrorMessage,
+    DateTimeOffset Timestamp);
@@ -0,0 +1,18 @@
+namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.RemoteQuery;
+
+/// <summary>
+/// Request to retry a parked message at a site (move back to pending queue).
+/// </summary>
+public record ParkedMessageRetryRequest(
+    string CorrelationId,
+    string SiteId,
+    string MessageId,
+    DateTimeOffset Timestamp);
+
+/// <summary>
+/// Response from retrying a parked message.
+/// </summary>
+public record ParkedMessageRetryResponse(
+    string CorrelationId,
+    bool Success,
+    string? ErrorMessage = null);
@@ -0,0 +1,75 @@
+using ZB.MOM.WW.ScadaBridge.Commons.Types;
+
+namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.RemoteQuery;
+
+/// <summary>
+/// Central → site relay command: retry a parked cached operation
+/// (<c>ExternalSystem.CachedCall</c> / <c>Database.CachedWrite</c>) on the
+/// owning site's Store-and-Forward buffer. Sent over the command/control
+/// channel by <c>SiteCallAuditActor</c> when an operator clicks Retry on a
+/// <c>Parked</c> Site Call row in the Central UI.
+/// </summary>
+/// <remarks>
+/// <para>
+/// The site is the source of truth for cached-call status — central never
+/// mutates the central <c>SiteCalls</c> mirror row directly. This command asks
+/// the site to reset its own parked row back to <c>Pending</c> so the S&amp;F
+/// retry sweep attempts delivery again; the corrected state then flows back to
+/// central via the normal cached-call telemetry path.
+/// </para>
+/// <para>
+/// The cached call's S&amp;F buffer message id is the
+/// <see cref="TrackedOperationId"/> itself (the tracked id is supplied as the
+/// buffered row's id at enqueue time), so the site can resolve the parked row
+/// directly from <see cref="TrackedOperationId"/>. A retry on a row that is not
+/// actually <c>Parked</c> is a safe no-op at the site — the ack reports
+/// <c>Applied=false</c> rather than corrupting a non-parked row.
+/// </para>
+/// <para>
+/// This is a plain record carrying only ids, so it lives in Commons (no
+/// <c>IActorRef</c> field). It mirrors <see cref="ParkedMessageRetryRequest"/>
+/// but keys on <see cref="TrackedOperationId"/> rather than the opaque S&amp;F
+/// message-id string.
+/// </para>
+/// </remarks>
+public sealed record RetryParkedOperation(
+    string CorrelationId,
+    TrackedOperationId TrackedOperationId);
+
+/// <summary>
+/// Central → site relay command: discard a parked cached operation on the
+/// owning site's Store-and-Forward buffer. Sent over the command/control
+/// channel by <c>SiteCallAuditActor</c> when an operator clicks Discard on a
+/// <c>Parked</c> Site Call row in the Central UI. See
+/// <see cref="RetryParkedOperation"/> for the source-of-truth and message-id
+/// rationale; Discard marks the operation terminally <c>Discarded</c> at the
+/// site by removing the parked S&amp;F buffer row.
+/// </summary>
+public sealed record DiscardParkedOperation(
+    string CorrelationId,
+    TrackedOperationId TrackedOperationId);
+
+/// <summary>
+/// Site → central ack for a <see cref="RetryParkedOperation"/> /
+/// <see cref="DiscardParkedOperation"/> relay command. The site replies this
+/// after applying (or safely no-op-ing) the action against its own
+/// Store-and-Forward buffer.
+/// </summary>
+/// <param name="CorrelationId">Correlation id of the originating relay command.</param>
+/// <param name="Applied">
+/// <c>true</c> when the parked operation was found and the action was applied;
+/// <c>false</c> when no parked row matched the <see cref="RetryParkedOperation.TrackedOperationId"/>
+/// (already delivered, discarded, never cached, or not in a <c>Parked</c>
+/// state). A <c>false</c> ack is a definitive "nothing to do" answer from the
+/// site — it is NOT a transport failure, so the relay must distinguish it from
+/// a site-unreachable timeout.
+/// </param>
+/// <param name="ErrorMessage">
+/// Populated only when the site could not apply the action (e.g. the parked
+/// message handler is not available, or the S&amp;F store faulted); <c>null</c>
+/// on a clean <c>Applied=true</c>/<c>Applied=false</c> outcome.
+/// </param>
+public sealed record ParkedOperationActionAck(
+    string CorrelationId,
+    bool Applied,
+    string? ErrorMessage = null);