feat(auditlog): multi-value AuditLogQueryFilter dimensions

src/ScadaLink.Commons/Types/Audit/AuditLogQueryFilter.cs

@@ -4,16 +4,20 @@ namespace ScadaLink.Commons.Types.Audit;
 
 /// <summary>
 /// Filter predicate for <see cref="ScadaLink.Commons.Interfaces.Repositories.IAuditLogRepository.QueryAsync"/>.
-/// Any field left <c>null</c> means "do not constrain on that column". Time bounds
-/// are half-open in the spec sense — <see cref="FromUtc"/> is inclusive and
-/// <see cref="ToUtc"/> is inclusive of the upper bound; the repository SQL uses
-/// <c>&gt;=</c> / <c>&lt;=</c> respectively. All filter fields are AND-combined.
+/// Any field left <c>null</c> means "do not constrain on that column". The
+/// <see cref="Channels"/>, <see cref="Kinds"/>, <see cref="Statuses"/> and
+/// <see cref="SourceSiteIds"/> dimensions are multi-value: a <c>null</c> OR empty
+/// list means "do not constrain", and a non-empty list is OR-combined within the
+/// dimension (translated to a SQL <c>IN (…)</c>). Time bounds are half-open in
+/// the spec sense — <see cref="FromUtc"/> is inclusive and <see cref="ToUtc"/> is
+/// inclusive of the upper bound; the repository SQL uses <c>&gt;=</c> / <c>&lt;=</c>
+/// respectively. All filter dimensions are AND-combined with one another.
 /// </summary>
 public sealed record AuditLogQueryFilter(
-    AuditChannel? Channel = null,
-    AuditKind? Kind = null,
-    AuditStatus? Status = null,
-    string? SourceSiteId = null,
+    IReadOnlyList<AuditChannel>? Channels = null,
+    IReadOnlyList<AuditKind>? Kinds = null,
+    IReadOnlyList<AuditStatus>? Statuses = null,
+    IReadOnlyList<string>? SourceSiteIds = null,
     string? Target = null,
     string? Actor = null,
     Guid? CorrelationId = null,