Expand XML docs across bridge and test code

tests/ZB.MOM.WW.LmxOpcUa.Tests/Status/StatusWebServerTests.cs

@@ -9,12 +9,18 @@ using ZB.MOM.WW.LmxOpcUa.Tests.Helpers;
 
 namespace ZB.MOM.WW.LmxOpcUa.Tests.Status
 {
+    /// <summary>
+    /// Verifies the lightweight HTTP dashboard host that exposes bridge status to operators.
+    /// </summary>
     public class StatusWebServerTests : IDisposable
     {
         private readonly StatusWebServer _server;
         private readonly HttpClient _client;
         private readonly int _port;
 
+        /// <summary>
+        /// Starts a status web server on a random test port and prepares an HTTP client for endpoint assertions.
+        /// </summary>
         public StatusWebServerTests()
         {
             _port = new Random().Next(18000, 19000);
@@ -26,12 +32,18 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Status
             _client = new HttpClient { BaseAddress = new Uri($"http://localhost:{_port}") };
         }
 
+        /// <summary>
+        /// Disposes the test HTTP client and stops the status web server.
+        /// </summary>
         public void Dispose()
         {
             _client.Dispose();
             _server.Dispose();
         }
 
+        /// <summary>
+        /// Confirms that the dashboard root responds with HTML content.
+        /// </summary>
         [Fact]
         public async Task Root_ReturnsHtml200()
         {
@@ -40,6 +52,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Status
             response.Content.Headers.ContentType?.MediaType.ShouldBe("text/html");
         }
 
+        /// <summary>
+        /// Confirms that the JSON status endpoint responds successfully.
+        /// </summary>
         [Fact]
         public async Task ApiStatus_ReturnsJson200()
         {
@@ -48,6 +63,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Status
             response.Content.Headers.ContentType?.MediaType.ShouldBe("application/json");
         }
 
+        /// <summary>
+        /// Confirms that the health endpoint returns HTTP 200 when the bridge is healthy.
+        /// </summary>
         [Fact]
         public async Task ApiHealth_Returns200WhenHealthy()
         {
@@ -58,6 +76,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Status
             body.ShouldContain("healthy");
         }
 
+        /// <summary>
+        /// Confirms that unknown dashboard routes return HTTP 404.
+        /// </summary>
         [Fact]
         public async Task UnknownPath_Returns404()
         {
@@ -65,6 +86,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Status
             response.StatusCode.ShouldBe(HttpStatusCode.NotFound);
         }
 
+        /// <summary>
+        /// Confirms that unsupported HTTP methods are rejected with HTTP 405.
+        /// </summary>
         [Fact]
         public async Task PostMethod_Returns405()
         {
@@ -72,6 +96,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Status
             response.StatusCode.ShouldBe(HttpStatusCode.MethodNotAllowed);
         }
 
+        /// <summary>
+        /// Confirms that cache-control headers disable caching for dashboard responses.
+        /// </summary>
         [Fact]
         public async Task CacheHeaders_Present()
         {
@@ -80,6 +107,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.Status
             response.Headers.CacheControl?.NoStore.ShouldBe(true);
         }
 
+        /// <summary>
+        /// Confirms that the server can be started and stopped cleanly.
+        /// </summary>
         [Fact]
         public void StartStop_DoesNotThrow()
         {