Expand XML docs across bridge and test code

tests/ZB.MOM.WW.LmxOpcUa.Tests/Helpers/OpcUaServerFixture.cs

@@ -21,8 +21,19 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
     {
         private static int _nextPort = 16000;
 
+        /// <summary>
+        /// Gets the started service instance managed by the fixture.
+        /// </summary>
         public OpcUaService Service { get; private set; } = null!;
+
+        /// <summary>
+        /// Gets the OPC UA port assigned to this fixture instance.
+        /// </summary>
         public int OpcUaPort { get; }
+
+        /// <summary>
+        /// Gets the OPC UA endpoint URL exposed by the fixture.
+        /// </summary>
         public string EndpointUrl => $"opc.tcp://localhost:{OpcUaPort}/LmxOpcUa";
 
         /// <summary>
@@ -44,6 +55,13 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
         private readonly OpcUaServiceBuilder _builder;
         private bool _started;
 
+        /// <summary>
+        /// Initializes a fixture around a prepared service builder and optional fake dependencies.
+        /// </summary>
+        /// <param name="builder">The builder used to construct the service under test.</param>
+        /// <param name="repo">The optional fake Galaxy repository exposed to tests.</param>
+        /// <param name="mxClient">The optional fake MXAccess client exposed to tests.</param>
+        /// <param name="mxProxy">The optional fake MXAccess proxy exposed to tests.</param>
         private OpcUaServerFixture(OpcUaServiceBuilder builder,
             FakeGalaxyRepository? repo = null,
             FakeMxAccessClient? mxClient = null,
@@ -62,6 +80,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
         /// Creates fixture with FakeMxProxy + FakeGalaxyRepository (standard test data).
         /// The STA thread and COM interop run against FakeMxProxy.
         /// </summary>
+        /// <param name="proxy">An optional fake proxy to inject; otherwise a default fake is created.</param>
+        /// <param name="repo">An optional fake repository to inject; otherwise standard test data is used.</param>
+        /// <returns>A fixture configured to exercise the COM-style runtime path.</returns>
         public static OpcUaServerFixture WithFakes(
             FakeMxProxy? proxy = null,
             FakeGalaxyRepository? repo = null)
@@ -85,6 +106,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
         /// Creates fixture using FakeMxAccessClient directly — skips STA thread + COM entirely.
         /// Fastest option for tests that don't need real COM interop.
         /// </summary>
+        /// <param name="mxClient">An optional fake MXAccess client to inject; otherwise a default fake is created.</param>
+        /// <param name="repo">An optional fake repository to inject; otherwise standard test data is used.</param>
+        /// <returns>A fixture configured to exercise the direct fake-client path.</returns>
         public static OpcUaServerFixture WithFakeMxAccessClient(
             FakeMxAccessClient? mxClient = null,
             FakeGalaxyRepository? repo = null)
@@ -104,6 +128,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
             return new OpcUaServerFixture(builder, repo: r, mxClient: client);
         }
 
+        /// <summary>
+        /// Builds and starts the OPC UA service for the current fixture.
+        /// </summary>
         public Task InitializeAsync()
         {
             Service = _builder.Build();
@@ -112,6 +139,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Helpers
             return Task.CompletedTask;
         }
 
+        /// <summary>
+        /// Stops the OPC UA service when the fixture had previously been started.
+        /// </summary>
         public Task DisposeAsync()
         {
             if (_started)