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

@@ -23,6 +23,7 @@ public static class AlarmRecordTransitionMapper
     ///     <see cref="MxAlarmStateKind"/>. Unknown values map to
     ///     <see cref="MxAlarmStateKind.Unspecified"/>.
     /// </summary>
+    /// <param name="stateXml">The state XML string from AVEVA (e.g., UNACK_ALM, ACK_RTN).</param>
     public static MxAlarmStateKind ParseStateKind(string? stateXml)
     {
         if (string.IsNullOrWhiteSpace(stateXml)) return MxAlarmStateKind.Unspecified;
@@ -48,6 +49,8 @@ public static class AlarmRecordTransitionMapper
     ///         <item><description>Anything else → Unspecified (no proto kind to emit).</description></item>
     ///     </list>
     /// </summary>
+    /// <param name="previous">The previous alarm state kind.</param>
+    /// <param name="current">The current alarm state kind.</param>
     public static AlarmTransitionKind MapTransition(
         MxAlarmStateKind previous,
         MxAlarmStateKind current)
@@ -81,6 +84,9 @@ public static class AlarmRecordTransitionMapper
     ///     AcknowledgeAlarm RPC echoing a reference back as a GUID lookup)
     ///     don't need translation.
     /// </summary>
+    /// <param name="providerName">The provider name, or null.</param>
+    /// <param name="groupName">The group name, or null.</param>
+    /// <param name="alarmName">The alarm name, or null.</param>
     public static string ComposeFullReference(string? providerName, string? groupName, string? alarmName)
     {
         string provider = providerName ?? string.Empty;