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,156 @@
+using Akka.Actor;
+using Akka.Event;
+using ZB.MOM.WW.ScadaBridge.Commons.Interfaces.Protocol;
+using ZB.MOM.WW.ScadaBridge.Commons.Messages.DataConnection;
+using ZB.MOM.WW.ScadaBridge.HealthMonitoring;
+using ZB.MOM.WW.ScadaBridge.SiteEventLogging;
+
+namespace ZB.MOM.WW.ScadaBridge.DataConnectionLayer.Actors;
+
+/// <summary>
+/// WP-34: Protocol extensibility — manages DataConnectionActor instances.
+/// Routes messages to the correct connection actor based on connection name.
+/// Adding a new protocol = implement IDataConnection + register with IDataConnectionFactory.
+/// </summary>
+public class DataConnectionManagerActor : ReceiveActor
+{
+    private readonly ILoggingAdapter _log = Context.GetLogger();
+    private readonly IDataConnectionFactory _factory;
+    private readonly DataConnectionOptions _options;
+    private readonly ISiteHealthCollector _healthCollector;
+    private readonly ISiteEventLogger? _siteEventLogger;
+    private readonly Dictionary<string, IActorRef> _connectionActors = new();
+
+    /// <summary>
+    /// Initializes a new <see cref="DataConnectionManagerActor"/> with the required dependencies.
+    /// </summary>
+    /// <param name="factory">Factory used to create protocol-specific data connection adapters.</param>
+    /// <param name="options">Configuration options for data connections.</param>
+    /// <param name="healthCollector">Collector for site health metrics reported by connection actors.</param>
+    /// <param name="siteEventLogger">Optional logger for site event entries; null disables site event logging.</param>
+    public DataConnectionManagerActor(
+        IDataConnectionFactory factory,
+        DataConnectionOptions options,
+        ISiteHealthCollector healthCollector,
+        ISiteEventLogger? siteEventLogger = null)
+    {
+        _factory = factory;
+        _options = options;
+        _healthCollector = healthCollector;
+        _siteEventLogger = siteEventLogger;
+
+        Receive<CreateConnectionCommand>(HandleCreateConnection);
+        Receive<SubscribeTagsRequest>(HandleRoute);
+        Receive<UnsubscribeTagsRequest>(HandleRoute);
+        Receive<WriteTagRequest>(HandleRouteWrite);
+        Receive<RemoveConnectionCommand>(HandleRemoveConnection);
+        Receive<GetAllHealthReports>(HandleGetAllHealthReports);
+    }
+
+    private void HandleCreateConnection(CreateConnectionCommand command)
+    {
+        if (_connectionActors.ContainsKey(command.ConnectionName))
+        {
+            _log.Warning("Connection {0} already exists", command.ConnectionName);
+            return;
+        }
+
+        // WP-34: Factory creates the correct adapter based on protocol type
+        var adapter = _factory.Create(command.ProtocolType, command.PrimaryConnectionDetails);
+
+        var props = Props.Create(() => new DataConnectionActor(
+            command.ConnectionName, adapter, _options, _healthCollector,
+            _factory, command.ProtocolType,
+            command.PrimaryConnectionDetails,
+            command.BackupConnectionDetails,
+            command.FailoverRetryCount,
+            _siteEventLogger));
+
+        // Sanitize name for Akka actor path (replace spaces and invalid chars)
+        var actorName = new string(command.ConnectionName
+            .Select(c => char.IsLetterOrDigit(c) || "-_.*$+:@&=,!~';()".Contains(c) ? c : '-')
+            .ToArray());
+        var actorRef = Context.ActorOf(props, actorName);
+        _connectionActors[command.ConnectionName] = actorRef;
+
+        _log.Info("Created DataConnectionActor for {0} (protocol={1})",
+            command.ConnectionName, command.ProtocolType);
+    }
+
+    private void HandleRoute(SubscribeTagsRequest request)
+    {
+        if (_connectionActors.TryGetValue(request.ConnectionName, out var actor))
+            actor.Forward(request);
+        else
+        {
+            _log.Warning("No connection actor for {0}", request.ConnectionName);
+            Sender.Tell(new SubscribeTagsResponse(
+                request.CorrelationId, request.InstanceUniqueName, false,
+                $"Unknown connection: {request.ConnectionName}", DateTimeOffset.UtcNow));
+        }
+    }
+
+    private void HandleRoute(UnsubscribeTagsRequest request)
+    {
+        if (_connectionActors.TryGetValue(request.ConnectionName, out var actor))
+            actor.Forward(request);
+        else
+            _log.Warning("No connection actor for {0} during unsubscribe", request.ConnectionName);
+    }
+
+    private void HandleRouteWrite(WriteTagRequest request)
+    {
+        if (_connectionActors.TryGetValue(request.ConnectionName, out var actor))
+            actor.Forward(request);
+        else
+        {
+            _log.Warning("No connection actor for {0}", request.ConnectionName);
+            Sender.Tell(new WriteTagResponse(
+                request.CorrelationId, false,
+                $"Unknown connection: {request.ConnectionName}", DateTimeOffset.UtcNow));
+        }
+    }
+
+    private void HandleRemoveConnection(RemoveConnectionCommand command)
+    {
+        if (_connectionActors.TryGetValue(command.ConnectionName, out var actor))
+        {
+            Context.Stop(actor);
+            _connectionActors.Remove(command.ConnectionName);
+            _healthCollector.RemoveConnection(command.ConnectionName);
+            _log.Info("Removed DataConnectionActor for {0}", command.ConnectionName);
+        }
+    }
+
+    private void HandleGetAllHealthReports(GetAllHealthReports _)
+    {
+        // Forward health report requests to all connection actors
+        foreach (var actor in _connectionActors.Values)
+        {
+            actor.Forward(new DataConnectionActor.GetHealthReport());
+        }
+    }
+
+    /// <inheritdoc />
+    protected override SupervisorStrategy SupervisorStrategy()
+    {
+        return new OneForOneStrategy(
+            maxNrOfRetries: 10,
+            withinTimeRange: TimeSpan.FromMinutes(1),
+            decider: Decider.From(ex =>
+            {
+                _log.Warning(ex, "DataConnectionActor threw exception, resuming (subscription state preserved)");
+                return Directive.Resume;
+            }));
+    }
+}
+
+/// <summary>
+/// Command to remove a data connection actor.
+/// </summary>
+public record RemoveConnectionCommand(string ConnectionName);
+
+/// <summary>
+/// Request for health reports from all active connections.
+/// </summary>
+public record GetAllHealthReports;