docs+ui: backfill XML doc comments and finish dashboard layout pass

Adds missing <summary>/<param> XML docs across 99 server, worker, and test
files so CommentChecker reports zero issues (TreatWarningsAsErrors needs the
analyzer clean). Bundles in WIP dashboard work: NavSection extraction,
MainLayout/site.css/js styling alignment, and DashboardOptions/Auth tweaks.

src/ZB.MOM.WW.MxGateway.Worker/MxAccess/AlarmDispatcher.cs

@@ -38,6 +38,10 @@ public sealed class AlarmDispatcher : IDisposable
     private readonly EventHandler<MxAlarmTransitionEvent> handler;
     private bool disposed;
 
+    /// <summary>Initializes a new alarm dispatcher for the given consumer, sink, and session ID.</summary>
+    /// <param name="consumer">The alarm consumer.</param>
+    /// <param name="sink">The alarm event sink.</param>
+    /// <param name="sessionId">The session identifier.</param>
     public AlarmDispatcher(
         IMxAccessAlarmConsumer consumer,
         MxAccessAlarmEventSink sink,
@@ -61,6 +65,7 @@ public sealed class AlarmDispatcher : IDisposable
     ///     transitions. The supplied subscription expression follows the
     ///     canonical <c>\\&lt;machine&gt;\Galaxy!&lt;area&gt;</c> format.
     /// </summary>
+    /// <param name="subscription">The subscription expression (e.g., <c>\\HOST\Galaxy!Area</c>).</param>
     public void Subscribe(string subscription)
     {
         if (disposed) throw new ObjectDisposedException(nameof(AlarmDispatcher));
@@ -72,6 +77,13 @@ public sealed class AlarmDispatcher : IDisposable
     ///     consumer's <c>AlarmAckByGUID</c>. Returns the AVEVA-native
     ///     status code (0 = success).
     /// </summary>
+    /// <param name="alarmGuid">The alarm GUID.</param>
+    /// <param name="ackComment">The acknowledgment comment.</param>
+    /// <param name="ackOperatorName">The operator name.</param>
+    /// <param name="ackOperatorNode">The operator node.</param>
+    /// <param name="ackOperatorDomain">The operator domain.</param>
+    /// <param name="ackOperatorFullName">The operator full name.</param>
+    /// <returns>The AVEVA-native status code.</returns>
     public int Acknowledge(
         Guid alarmGuid,
         string ackComment,
@@ -95,6 +107,15 @@ public sealed class AlarmDispatcher : IDisposable
     ///     Routes to the consumer's <c>AcknowledgeByName</c> path which
     ///     maps to <c>wwAlarmConsumerClass.AlarmAckByName</c>.
     /// </summary>
+    /// <param name="alarmName">The alarm name.</param>
+    /// <param name="providerName">The provider name.</param>
+    /// <param name="groupName">The group name.</param>
+    /// <param name="ackComment">The acknowledgment comment.</param>
+    /// <param name="ackOperatorName">The operator name.</param>
+    /// <param name="ackOperatorNode">The operator node.</param>
+    /// <param name="ackOperatorDomain">The operator domain.</param>
+    /// <param name="ackOperatorFullName">The operator full name.</param>
+    /// <returns>The AVEVA-native status code.</returns>
     public int AcknowledgeByName(
         string alarmName,
         string providerName,
@@ -213,8 +234,10 @@ public sealed class AlarmDispatcher : IDisposable
         };
     }
 
+    /// <summary>Gets the session ID.</summary>
     public string SessionId => sessionId;
 
+    /// <inheritdoc />
     public void Dispose()
     {
         if (disposed) return;