rename: prefix gateway projects/namespaces with ZB.MOM.WW + sln→slnx

Apply the ZB.MOM.WW. prefix to all gateway-side projects, folders, .csproj/.sln contents, C# namespaces, using directives, generated proto C# (csharp_namespace + checked-in generated files), InternalsVisibleTo attributes, project-name string literals (LoadProject, .sln lookups, worker exe paths, staticwebassets manifest), and the install/script/doc references that point at any of the above. Migrate the solution from .sln to .slnx via `dotnet sln migrate` and delete the old file. External-runtime identifiers are intentionally NOT prefixed so external configuration keeps working: - GatewayMetrics.cs MeterName ("MxGateway.Server") - DashboardAuthenticationDefaults Scheme/Policy ("MxGateway.Dashboard") - GatewayRequestLoggingMiddleware logger category ("MxGateway.Request") - StaRuntime thread name ("MxGateway.Worker.STA") - appsettings.json root section "MxGateway" + env-var prefix MxGateway__... and secret-name MxGateway:ApiKeyPepper - C:\ProgramData\MxGateway\ data dir paths Also fixes two tests that were not rename-related but became visible while validating the rename: - WorkerLiveMxAccessSmokeTests.ShutDownAsync: cancellation that the gateway service correctly maps to RpcException(Cancelled) per gRPC convention was being misclassified as a stream fault. Added a sibling catch on RpcException with StatusCode.Cancelled. - IntegrationTestEnvironment.ResolveRepositoryRoot: extracted IsRepositoryRoot and made it accept either a .git marker OR a .sln/.slnx next to src/ so the worker-exe walker works in non-git working copies. clients/proto/proto-inputs.json's protoRoot updated to point at src/ZB.MOM.WW.MxGateway.Contracts/Protos. Verified by `dotnet build` and a full `dotnet test` of the .slnx with MXGATEWAY_RUN_LIVE_{MXACCESS,LDAP,GALAXY}_TESTS=1: Tests: 472/472 pass Worker.Tests: 280/280 pass (4 dev-rig [Fact(Skip=...)] skipped) IntegrationTests: 18/18 pass Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-23 16:22:23 -04:00
parent 867bf18116
commit dc9c0c950c
491 changed files with 32854 additions and 8414 deletions
@@ -0,0 +1,122 @@
+using System;
+using ZB.MOM.WW.MxGateway.Contracts.Proto;
+using ZB.MOM.WW.MxGateway.Worker.MxAccess;
+
+namespace ZB.MOM.WW.MxGateway.Worker.Tests.MxAccess;
+
+/// <summary>
+///     Pins the pure helpers used to translate AVEVA's wnwrapConsumer XML
+///     payloads into proto-friendly fields. The COM-side I/O on
+///     <see cref="WnWrapAlarmConsumer"/> needs an AVEVA install and is
+///     covered by the Skip-gated probe (<c>WnWrapConsumerProbeTests</c>);
+///     these unit tests cover everything that doesn't touch the live COM
+///     surface.
+/// </summary>
+public sealed class AlarmRecordTransitionMapperTests
+{
+    [Fact]
+    public void ComposeFullReference_WithProviderAndGroup_UsesProviderBangGroupDotNameFormat()
+    {
+        string reference = AlarmRecordTransitionMapper.ComposeFullReference(
+            providerName: "GalaxyAlarmProvider",
+            groupName: "Tank01",
+            alarmName: "Level.HiHi");
+        Assert.Equal("GalaxyAlarmProvider!Tank01.Level.HiHi", reference);
+    }
+
+    [Fact]
+    public void ComposeFullReference_WithEmptyProvider_DropsProvider()
+    {
+        string reference = AlarmRecordTransitionMapper.ComposeFullReference(
+            providerName: null, groupName: "Tank01", alarmName: "Level.HiHi");
+        Assert.Equal("Tank01.Level.HiHi", reference);
+    }
+
+    [Fact]
+    public void ComposeFullReference_WithEmptyGroup_DropsGroup()
+    {
+        string reference = AlarmRecordTransitionMapper.ComposeFullReference(
+            providerName: "GalaxyAlarmProvider", groupName: null, alarmName: "GlobalAlarm");
+        Assert.Equal("GalaxyAlarmProvider!GlobalAlarm", reference);
+    }
+
+    [Fact]
+    public void ComposeFullReference_WithEmptyProviderAndGroup_ReturnsAlarmName()
+    {
+        string reference = AlarmRecordTransitionMapper.ComposeFullReference(
+            providerName: null, groupName: null, alarmName: "Bare");
+        Assert.Equal("Bare", reference);
+    }
+
+    [Theory]
+    [InlineData("UNACK_ALM", MxAlarmStateKind.UnackAlm)]
+    [InlineData("ACK_ALM", MxAlarmStateKind.AckAlm)]
+    [InlineData("UNACK_RTN", MxAlarmStateKind.UnackRtn)]
+    [InlineData("ACK_RTN", MxAlarmStateKind.AckRtn)]
+    [InlineData("unack_alm", MxAlarmStateKind.UnackAlm)] // case-insensitive
+    [InlineData("  ACK_ALM  ", MxAlarmStateKind.AckAlm)] // trim
+    [InlineData("UNKNOWN", MxAlarmStateKind.Unspecified)]
+    [InlineData("", MxAlarmStateKind.Unspecified)]
+    [InlineData(null, MxAlarmStateKind.Unspecified)]
+    public void ParseStateKind_ForEachStateString_DecodesStateKind(string? input, MxAlarmStateKind expected)
+    {
+        Assert.Equal(expected, AlarmRecordTransitionMapper.ParseStateKind(input));
+    }
+
+    [Theory]
+    // First sighting: new alarm in *_ALM → Raise.
+    [InlineData(MxAlarmStateKind.Unspecified, MxAlarmStateKind.UnackAlm, AlarmTransitionKind.Raise)]
+    [InlineData(MxAlarmStateKind.Unspecified, MxAlarmStateKind.AckAlm, AlarmTransitionKind.Raise)]
+    // First sighting in *_RTN → Clear (unusual; missed the original raise).
+    [InlineData(MxAlarmStateKind.Unspecified, MxAlarmStateKind.UnackRtn, AlarmTransitionKind.Clear)]
+    [InlineData(MxAlarmStateKind.Unspecified, MxAlarmStateKind.AckRtn, AlarmTransitionKind.Clear)]
+    // Active → Cleared.
+    [InlineData(MxAlarmStateKind.UnackAlm, MxAlarmStateKind.UnackRtn, AlarmTransitionKind.Clear)]
+    [InlineData(MxAlarmStateKind.AckAlm, MxAlarmStateKind.AckRtn, AlarmTransitionKind.Clear)]
+    // Cleared → Active (re-trigger).
+    [InlineData(MxAlarmStateKind.UnackRtn, MxAlarmStateKind.UnackAlm, AlarmTransitionKind.Raise)]
+    [InlineData(MxAlarmStateKind.AckRtn, MxAlarmStateKind.UnackAlm, AlarmTransitionKind.Raise)]
+    // Unacked → Acked (operator ack).
+    [InlineData(MxAlarmStateKind.UnackAlm, MxAlarmStateKind.AckAlm, AlarmTransitionKind.Acknowledge)]
+    [InlineData(MxAlarmStateKind.UnackRtn, MxAlarmStateKind.AckRtn, AlarmTransitionKind.Acknowledge)]
+    // No-op (state unchanged) — caller is supposed to filter these out.
+    [InlineData(MxAlarmStateKind.UnackAlm, MxAlarmStateKind.UnackAlm, AlarmTransitionKind.Unspecified)]
+    // Current=Unspecified → Unspecified.
+    [InlineData(MxAlarmStateKind.UnackAlm, MxAlarmStateKind.Unspecified, AlarmTransitionKind.Unspecified)]
+    public void MapTransition_ForEachStatePair_DecidesProtoKind(
+        MxAlarmStateKind previous,
+        MxAlarmStateKind current,
+        AlarmTransitionKind expected)
+    {
+        Assert.Equal(expected, AlarmRecordTransitionMapper.MapTransition(previous, current));
+    }
+
+    [Fact]
+    public void ParseTransitionTimestampUtc_WithValidXmlFields_AssemblesUtc()
+    {
+        // Captured payload from probe (2026-05-01): EDT producer, GMTOFFSET=240, DSTADJUST=0.
+        // Local 13:26:14.709 + 240 minutes (4h) = 17:26:14.709 UTC.
+        DateTime utc = AlarmRecordTransitionMapper.ParseTransitionTimestampUtc(
+            "2026/5/1", "13:26:14.709", gmtOffsetMinutes: 240, dstAdjustMinutes: 0);
+
+        Assert.Equal(DateTimeKind.Utc, utc.Kind);
+        Assert.Equal(2026, utc.Year);
+        Assert.Equal(5, utc.Month);
+        Assert.Equal(1, utc.Day);
+        Assert.Equal(17, utc.Hour);
+        Assert.Equal(26, utc.Minute);
+        Assert.Equal(14, utc.Second);
+        Assert.Equal(709, utc.Millisecond);
+    }
+
+    [Fact]
+    public void ParseTransitionTimestampUtc_WithUnparseableInputs_ReturnsMinValue()
+    {
+        Assert.Equal(DateTime.MinValue,
+            AlarmRecordTransitionMapper.ParseTransitionTimestampUtc(null, null, 0, 0));
+        Assert.Equal(DateTime.MinValue,
+            AlarmRecordTransitionMapper.ParseTransitionTimestampUtc("not a date", "13:00:00", 0, 0));
+        Assert.Equal(DateTime.MinValue,
+            AlarmRecordTransitionMapper.ParseTransitionTimestampUtc("2026/5/1", "not a time", 0, 0));
+    }
+}