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/IAlarmCommandHandler.cs

@@ -14,12 +14,20 @@ namespace ZB.MOM.WW.MxGateway.Worker.MxAccess;
 public interface IAlarmCommandHandler : IDisposable
 {
     /// <summary>Begin a subscription against the supplied AVEVA alarm-provider expression.</summary>
+    /// <param name="subscription">The AVEVA alarm-provider subscription expression.</param>
+    /// <param name="sessionId">The session identifier.</param>
     void Subscribe(string subscription, string sessionId);
 
     /// <summary>Tear down the active subscription. No-op if not subscribed.</summary>
     void Unsubscribe();
 
     /// <summary>Acknowledge a single alarm by GUID. Returns AVEVA's native status (0 = success).</summary>
+    /// <param name="alarmGuid">The alarm GUID.</param>
+    /// <param name="comment">The acknowledgment comment.</param>
+    /// <param name="operatorUser">The operator user name.</param>
+    /// <param name="operatorNode">The operator node name.</param>
+    /// <param name="operatorDomain">The operator domain name.</param>
+    /// <param name="operatorFullName">The operator full name.</param>
     int Acknowledge(
         Guid alarmGuid,
         string comment,
@@ -32,6 +40,14 @@ public interface IAlarmCommandHandler : IDisposable
     ///     Acknowledge a single alarm by (name, provider, group) — used when
     ///     the caller has the human-readable reference but not the GUID.
     /// </summary>
+    /// <param name="alarmName">The alarm name.</param>
+    /// <param name="providerName">The provider name.</param>
+    /// <param name="groupName">The group name.</param>
+    /// <param name="comment">The acknowledgment comment.</param>
+    /// <param name="operatorUser">The operator user name.</param>
+    /// <param name="operatorNode">The operator node name.</param>
+    /// <param name="operatorDomain">The operator domain name.</param>
+    /// <param name="operatorFullName">The operator full name.</param>
     int AcknowledgeByName(
         string alarmName,
         string providerName,
@@ -46,6 +62,7 @@ public interface IAlarmCommandHandler : IDisposable
     ///     Snapshot the currently-active alarm set, optionally scoped to a
     ///     prefix matched against <c>AlarmFullReference</c>.
     /// </summary>
+    /// <param name="alarmFilterPrefix">Optional prefix to filter alarms by.</param>
     IReadOnlyList<ActiveAlarmSnapshot> QueryActive(string? alarmFilterPrefix);
 
     /// <summary>