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,65 @@
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.DependencyInjection.Extensions;
+using Microsoft.Extensions.Options;
+
+namespace ZB.MOM.WW.ScadaBridge.HealthMonitoring;
+
+public static class ServiceCollectionExtensions
+{
+    /// <summary>
+    /// Register site-side health monitoring services (metric collection + periodic reporting).
+    /// Call this on site nodes only. For central, call AddCentralHealthAggregation() instead.
+    /// </summary>
+    /// <param name="services">The DI service collection to register into.</param>
+    public static IServiceCollection AddSiteHealthMonitoring(this IServiceCollection services)
+    {
+        AddOptionsValidation(services);
+        services.AddSingleton<ISiteHealthCollector, SiteHealthCollector>();
+        services.AddHostedService<HealthReportSender>();
+        return services;
+    }
+
+    /// <summary>
+    /// Register shared health monitoring services (safe for both central and site).
+    /// Does not start the HealthReportSender — call AddSiteHealthMonitoring() on site nodes for that.
+    /// </summary>
+    /// <param name="services">The DI service collection to register into.</param>
+    public static IServiceCollection AddHealthMonitoring(this IServiceCollection services)
+    {
+        AddOptionsValidation(services);
+        services.AddSingleton<ISiteHealthCollector, SiteHealthCollector>();
+        return services;
+    }
+
+    /// <summary>
+    /// Register central-side health aggregation services. Includes the
+    /// <see cref="CentralHealthReportLoop"/> that generates a self-report
+    /// for the central cluster so it appears on /monitoring/health.
+    /// </summary>
+    /// <param name="services">The DI service collection to register into.</param>
+    public static IServiceCollection AddCentralHealthAggregation(this IServiceCollection services)
+    {
+        AddOptionsValidation(services);
+        services.AddSingleton<CentralHealthAggregator>();
+        services.AddSingleton<ICentralHealthAggregator>(sp => sp.GetRequiredService<CentralHealthAggregator>());
+        services.AddHostedService(sp => sp.GetRequiredService<CentralHealthAggregator>());
+        services.AddHostedService<CentralHealthReportLoop>();
+        return services;
+    }
+
+    /// <summary>
+    /// HealthMonitoring-014: register the <see cref="HealthMonitoringOptionsValidator"/>
+    /// so a misconfigured <c>ScadaBridge:HealthMonitoring</c> section (zero/negative
+    /// intervals, or a <c>CentralOfflineTimeout</c> shorter than
+    /// <c>OfflineTimeout</c>) is rejected with a clear, key-naming message when the
+    /// hosted services resolve their options at startup — rather than crashing
+    /// later inside a <see cref="PeriodicTimer"/> constructor with an opaque
+    /// <see cref="ArgumentOutOfRangeException"/>. Idempotent so it is safe when
+    /// more than one of the registration methods above is called.
+    /// </summary>
+    private static void AddOptionsValidation(IServiceCollection services)
+    {
+        services.TryAddEnumerable(
+            ServiceDescriptor.Singleton<IValidateOptions<HealthMonitoringOptions>, HealthMonitoringOptionsValidator>());
+    }
+}