feat(site-call-audit): additive TrackedOperationId query filter for ?correlationId= deep links

Claude-Session: https://claude.ai/code/session_01NcMG6xXdsJbmD2wYAgkK29

src/ZB.MOM.WW.ScadaBridge.Commons/Messages/Audit/SiteCallQueries.cs

@@ -22,6 +22,11 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.Audit;
 /// Requested page size. The actor clamps this to the <c>[1, 200]</c> range, so
 /// the effective ceiling is 200 rows per page regardless of the value sent.
 /// </param>
+/// <param name="TrackedOperationIdFilter">
+/// Exact-match on one operation (the <c>?correlationId=</c> deep link from the
+/// Flow Debugger / Audit Log); <c>null</c> = no filter. Additive, trailing
+/// optional so existing positional callers are unaffected.
+/// </param>
 public sealed record SiteCallQueryRequest(
     string CorrelationId,
     string? StatusFilter,
@@ -34,7 +39,8 @@ public sealed record SiteCallQueryRequest(
     DateTime? AfterCreatedAtUtc,
     Guid? AfterId,
     int PageSize,
-    string? SourceNodeFilter = null);
+    string? SourceNodeFilter = null,
+    Guid? TrackedOperationIdFilter = null);
 
 /// <summary>
 /// A single <c>SiteCalls</c> row summarised for the Site Calls UI grid. Carries

src/ZB.MOM.WW.ScadaBridge.Commons/Types/Audit/SiteCallQueryFilter.cs

@@ -31,6 +31,12 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Types.Audit;
 /// <c>"site-plant-a-node-a"</c>). Exact match; <c>null</c> means "do not
 /// constrain". Rows with NULL <c>SourceNode</c> are excluded when set.
 /// </param>
+/// <param name="TrackedOperationId">
+/// Restrict to exactly one cached call by its primary key — the
+/// <c>?correlationId=</c> deep link from the Flow Debugger / Audit Log.
+/// <c>null</c> means "do not constrain". AND-combined with every other field,
+/// so a mismatching <see cref="SourceSite"/> (etc.) still yields no rows.
+/// </param>
 public sealed record SiteCallQueryFilter(
     string? Channel = null,
     string? SourceSite = null,
@@ -39,4 +45,5 @@ public sealed record SiteCallQueryFilter(
     DateTime? FromUtc = null,
     DateTime? ToUtc = null,
     DateTime? StuckCutoffUtc = null,
-    string? SourceNode = null);
+    string? SourceNode = null,
+    Guid? TrackedOperationId = null);

src/ZB.MOM.WW.ScadaBridge.ConfigurationDatabase/Repositories/SiteCallAuditRepository.cs

@@ -294,6 +294,12 @@ WHERE TrackedOperationId = @Id
         var fromUtc = filter.FromUtc;
         var toUtc = filter.ToUtc;
         var stuckCutoff = filter.StuckCutoffUtc;
+        // TrackedOperationId is a varchar(36) column holding the "D"-format GUID
+        // string (see SiteCallEntityTypeConfiguration), so the exact-match filter
+        // is compared as a string — same shape as the @AfterId cursor below. A
+        // uniqueidentifier parameter would make SQL Server convert the COLUMN side
+        // (higher type precedence) and lose the PK seek.
+        var trackedOperationIdString = filter.TrackedOperationId?.ToString("D");
 
         // The stuck predicate (TerminalAtUtc IS NULL AND CreatedAtUtc < cutoff)
         // is pushed into SQL here — both columns are plain (no value converter)
@@ -315,6 +321,7 @@ WHERE (@Channel IS NULL OR Channel = @Channel)
   AND (@SourceNode IS NULL OR SourceNode = @SourceNode)
   AND (@Status IS NULL OR Status = @Status)
   AND (@Target IS NULL OR Target = @Target)
+  AND (@TrackedOperationId IS NULL OR TrackedOperationId = @TrackedOperationId)
   AND (@FromUtc IS NULL OR CreatedAtUtc >= @FromUtc)
   AND (@ToUtc IS NULL OR CreatedAtUtc <= @ToUtc)
   AND (@StuckCutoff IS NULL OR (TerminalAtUtc IS NULL AND CreatedAtUtc < @StuckCutoff))
@@ -338,6 +345,7 @@ OPTION (RECOMPILE);";
             Param("@SourceNode", SqlDbType.VarChar, filter.SourceNode),
             Param("@Status", SqlDbType.VarChar, filter.Status),
             Param("@Target", SqlDbType.VarChar, filter.Target),
+            Param("@TrackedOperationId", SqlDbType.VarChar, trackedOperationIdString),
             Param("@FromUtc", SqlDbType.DateTime2, fromUtc),
             Param("@ToUtc", SqlDbType.DateTime2, toUtc),
             Param("@StuckCutoff", SqlDbType.DateTime2, stuckCutoff),

src/ZB.MOM.WW.ScadaBridge.SiteCallAudit/SiteCallAuditActor.cs

@@ -832,7 +832,8 @@ public class SiteCallAuditActor : ReceiveActor
             // keyset cursor, so the page is always honest (full pages, no empty
             // pages with a non-null next cursor).
             StuckCutoffUtc: request.StuckOnly ? stuckCutoff : null,
-            SourceNode: NullIfBlank(request.SourceNodeFilter));
+            SourceNode: NullIfBlank(request.SourceNodeFilter),
+            TrackedOperationId: request.TrackedOperationIdFilter);
 
         var pageSize = Math.Clamp(request.PageSize, 1, MaxPageSize);
         var paging = new SiteCallPaging(