9bf1497f03
Wires Bundle E of the M2 site-sync pipeline: - AddAuditLog extended to register the site writer chain (SqliteAuditWriter singleton + ISiteAuditQueue forward + RingBufferFallback + FallbackAuditWriter composing them) and the telemetry collaborators (SiteAuditTelemetryOptions, SqliteAuditWriterOptions, IAuditWriteFailureCounter NoOp default, ISiteStreamAuditClient NoOp default). - AkkaHostedService central role: AuditLogIngestActor as ClusterSingletonManager (singleton name 'audit-log-ingest') + ClusterSingletonProxy, mirroring the Notification Outbox pattern. Proxy is offered to SiteStreamGrpcServer if it resolves (Site path only today; M6 reconciliation will host gRPC on central). - AkkaHostedService site role: SiteAuditTelemetryActor (per-site, NOT a singleton because each site is its own cluster), bound to a dedicated audit-telemetry-dispatcher (ForkJoinDispatcher, 2 dedicated threads). - Program.cs + SiteServiceRegistration.Configure call AddAuditLog on both roles. - AuditLogIngestActor gains a second constructor that takes IServiceProvider so the cluster singleton can create a fresh scope per message — IAuditLogRepository is a scoped EF Core service and cannot be pre-resolved from the root. The IAuditLogRepository constructor remains for Bundle D's MSSQL-fixture tests. NoOp ISiteStreamAuditClient is deliberate: no site→central gRPC channel exists in M2 (sites talk to central via Akka ClusterClient; gRPC SiteStreamService is hosted on sites for central→site streaming). M6 reconciliation introduces the real gRPC site→central client + central-hosted gRPC server. Bundle H's integration test substitutes a stub client directly via the actor's Props. Tests: - tests/ScadaLink.AuditLog.Tests/AddAuditLogTests.cs — 11 tests (was 3): writer singleton, IAuditWriter as FallbackAuditWriter, ISiteAuditQueue same-instance as SqliteAuditWriter, options bind round-trip, NoOp default assertions. - tests/ScadaLink.Host.Tests/AkkaHostedServiceAuditWiringTests.cs (new) — 13 tests: BuildHocon emits audit-telemetry-dispatcher block with the expected type/throughput/thread-count; Central composition root resolves the writer chain + options; Site composition root resolves the writer chain + options + NoOp client. Verified: dotnet build clean, 23 test suites green (Host 194 + AuditLog 54).
42 lines
1.7 KiB
C#
42 lines
1.7 KiB
C#
using ScadaLink.Communication.Grpc;
|
|
|
|
namespace ScadaLink.AuditLog.Site.Telemetry;
|
|
|
|
/// <summary>
|
|
/// Default <see cref="ISiteStreamAuditClient"/> registered by
|
|
/// <see cref="ScadaLink.AuditLog.ServiceCollectionExtensions.AddAuditLog"/>.
|
|
/// Ships with M2 site-sync-pipeline wiring; the real gRPC-backed
|
|
/// implementation is deferred to M6 reconciliation, where a site→central gRPC
|
|
/// channel will be introduced (no such channel exists today — sites talk to
|
|
/// central exclusively via Akka ClusterClient, while the gRPC SiteStreamService
|
|
/// is hosted on the SITE side for central→site streaming).
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// <para>
|
|
/// Returns an empty <see cref="IngestAck"/> so the
|
|
/// <see cref="SiteAuditTelemetryActor"/> doesn't flip any rows to
|
|
/// <c>Forwarded</c> when this NoOp is in effect — Bundle H's integration test
|
|
/// substitutes a stub client that routes directly to the central
|
|
/// <c>AuditLogIngestActor</c> in-process. Production wiring (M6) will replace
|
|
/// this binding with a real client.
|
|
/// </para>
|
|
/// <para>
|
|
/// Audit-write paths are best-effort by contract: a NoOp client keeps the
|
|
/// host running cleanly and is consistent with "audit-write failures never
|
|
/// abort the user-facing action".
|
|
/// </para>
|
|
/// </remarks>
|
|
public sealed class NoOpSiteStreamAuditClient : ISiteStreamAuditClient
|
|
{
|
|
private static readonly IngestAck EmptyAck = new();
|
|
|
|
/// <inheritdoc/>
|
|
public Task<IngestAck> IngestAuditEventsAsync(AuditEventBatch batch, CancellationToken ct)
|
|
{
|
|
ArgumentNullException.ThrowIfNull(batch);
|
|
// Empty ack — no EventIds will be flipped to Forwarded, so rows stay
|
|
// Pending until M6's real client (or a Bundle H test stub) takes over.
|
|
return Task.FromResult(EmptyAck);
|
|
}
|
|
}
|