fix: 审查修复波次（P0x4 + P1x30+）

- domain/rules: 计分与排名解耦、破纪录按组别、tieBreak 生效、调整分不丢、移除 aggregate 假能力 - realtime: 新建 internal/dto，快照三项契约对齐，/ws 只认会话身份 - httpapi: 流水幂等、standings 整表载荷、广播接线、强制改密、XFF 防伪造、records 写入、审计、赛事包内容、发布前备份、result.points、实例列表 - web: FormData 上传、YAML 解析、快照归一化、大屏解析层、bootstrap 降级、访客判定、主题切换 - console: 优雅关闭握手、中文化、免验证改管理员账号、选屏与日志轮转修复 - docs: 用户文档三份 + README - 主代理: 破纪录加分接线（levels 未加载导致恒 0）
2026-09-09 21:06:40 +08:00
1 parent 8dae63ee70
commit 7f9701c465
@@ -97,7 +97,7 @@ async function bootstrap(): Promise<Bootstrap> {
          client.scoringProfiles.list(),
          client.standings.teams(),
          client.standings.athletes(),
-        ])
+        ] as const)
      // GET /api/settings 是 admin-only，guest/recorder 必然 403。
      // 这是权限边界而非服务不可用，不能让整页数据跟着失败，所以 settings 单独降级为 null。
      return {
@@ -90,11 +90,10 @@ function handleDoubleClick(event: MouseEvent): void {
  min-width: 0;
 }
 .desktop-titlebar-mark {
-  width: 8px;
-  height: 22px;
-  flex: 0 0 auto;
-  border-radius: 4px;
-  background: linear-gradient(180deg, var(--mx-primary), var(--mx-primary-active));
+  width: 20px;
+  height: 20px;
+  flex: none;
+  border-radius: 5px;
 }
 .desktop-titlebar-title {
  font-size: 14px;
@@ -4,6 +4,7 @@ import { RouterLink, RouterView, useRoute, useRouter } from 'vue-router'
 import MxIcon from '../components/MxIcon.vue'
 import ToastHost from '../components/ToastHost.vue'
 import type { IconName } from '../components/icons'
+import { theme, toggleTheme } from '../theme'
 import { useAuthStore } from '../stores/auth'
 import { useEventStore } from '../stores/event'
 import { useToastStore } from '../stores/toast'
@@ -65,6 +66,7 @@ const refreshing = ref(false)

 const currentTitle = computed(() => (typeof route.meta.title === 'string' ? route.meta.title : '管理面板'))
 const pendingCount = computed(() => data.events.filter((event) => event.status === 'pending').length)
+const themeToggleLabel = computed(() => (theme.value === 'dark' ? '切换到浅色模式' : '切换到深色模式'))

 const connection = computed(() => {
  if (data.isMock) return { tone: 'warning', text: '示例数据', hint: data.mockLabel ?? '' }
@@ -153,6 +155,16 @@ onMounted(async () => {
            {{ connection.text }}
          </span>
          <span v-if="data.serverHealth" class="version mono">v{{ data.serverHealth }}</span>
+          <button
+            class="mx-btn mx-btn-ghost mx-btn-icon"
+            type="button"
+            :title="themeToggleLabel"
+            :aria-label="themeToggleLabel"
+            :aria-pressed="theme === 'light'"
+            @click="toggleTheme()"
+          >
+            <MxIcon name="display" :size="17" />
+          </button>
          <button
            class="mx-btn mx-btn-ghost mx-btn-icon"
            type="button"
@@ -2,7 +2,10 @@ import { createApp } from 'vue'
 import { createPinia } from 'pinia'
 import App from './App.vue'
 import { router } from './router'
+import { initTheme } from './theme'
 import '@/shared/styles/base.css'
 import './styles/miuix.css'

+initTheme()
+
 createApp(App).use(createPinia()).use(router).mount('#app')
@@ -108,14 +108,7 @@ onMounted(async () => {
      <img class="app-icon" src="/scoreboard.png" alt="" width="56" height="56" />
      <div style="display: flex; flex-direction: column; gap: 2px">
        <strong style="font-size: 18px">{{ SYSTEM_NAME }}</strong>
-        <span style="font-size: 12px; color: var(--mx-t3)">{{ SYSTEM_EN }} · v{{ versionText }}</span>
-      </div>
-    </div>
-
-    <div v-if="internalSignature" class="mx-card" style="margin-bottom: 16px">
-      <div class="mx-card-body" style="display: flex; flex-direction: column; gap: 4px">
-        <span style="font-size: 12px; color: var(--mx-t3)">内部署名</span>
-        <strong style="font-size: 15px">{{ internalSignature }}</strong>
+        <span style="font-size: 12px; color: var(--mx-t3)">{{ SYSTEM_EN }} · {{ versionText }}</span>
      </div>
    </div>

@@ -272,6 +265,17 @@ onMounted(async () => {
    <p class="foot-hint">
      本系统为内部赛事使用；MiSans 字体授权仅限内部赛事，对外分发前请替换为 OFL-1.1 字体。
    </p>
+
+    <!-- 值来自构建期注入的内部配置（GET /api/system/about 的 internalSignature），不是用户输入，
+         因此允许用 v-html 渲染其中的标签；为空时整张卡片不渲染。 -->
+    <section v-if="internalSignature" class="mx-card">
+      <div class="mx-card-head">
+        <span class="mx-card-title">开发者</span>
+      </div>
+      <div class="mx-card-body">
+        <div class="signature" v-html="internalSignature"></div>
+      </div>
+    </section>
  </div>
 </template>

@@ -340,4 +344,9 @@ kbd {
  font-size: 12px;
  color: var(--mx-t3);
 }
+.signature {
+  font-size: 14px;
+  line-height: 1.6;
+  color: var(--mx-text);
+}
 </style>
@@ -54,7 +54,15 @@ const localItems = ref<PointAdjustment[]>([])
 let nextLocalId = -1

 const canWrite = computed(() => !auth.readOnly && data.canWrite)
-const adjustmentEnabled = computed(() => rulePack.value?.manualAdjustment.enabled ?? false)
+/**
+ * 人工调整开关：true / false / null（未知）。
+ *
+ * 规则包只有 admin 能读（GET /api/rules/export 是 admin-only），录入员必然 403——
+ * 不能据此断言「已关闭」，那会把已启用的功能谎报成关闭。读不到时为 null，
+ * 界面如实显示「未知」，最终由服务端校验决定是否受理。
+ * 后端补一个 recorder 可读的只读开关端点后，把 loadRules 换成读该端点即可。
+ */
+const adjustmentEnabled = computed<boolean | null>(() => rulePack.value?.manualAdjustment.enabled ?? null)

 const items = computed(() => [...localItems.value, ...serverItems.value])

@@ -132,7 +140,7 @@ async function load(pageNumber = page.value): Promise<void> {
 }

 function openCreate(): void {
-  if (!adjustmentEnabled.value) {
+  if (adjustmentEnabled.value === false) {
    toast.error('本期人工调整已关闭', '规则包 manualAdjustment.enabled = false')
    return
  }
@@ -254,7 +262,12 @@ onMounted(() => {
        <button class="mx-btn mx-btn-secondary" type="button" :disabled="loading" @click="load()">
          <MxIcon name="refresh" :size="15" /> 刷新
        </button>
-        <button class="mx-btn mx-btn-primary" type="button" :disabled="!adjustmentEnabled || !canWrite" @click="openCreate">
+        <button
+          class="mx-btn mx-btn-primary"
+          type="button"
+          :disabled="adjustmentEnabled === false || !canWrite"
+          @click="openCreate"
+        >
          <MxIcon name="adjust" :size="15" /> 新增调整
        </button>
      </template>
@@ -265,22 +278,41 @@ onMounted(() => {
        <span class="notice-icon"><MxIcon name="warning" :size="18" /></span>
        <div>
          <div class="notice-title">
-            {{ adjustmentEnabled ? '人工调整已启用' : '本期人工调整已关闭' }}
-            <span class="mx-badge" :class="adjustmentEnabled ? 'mx-badge-success' : 'mx-badge-warning'">
-              manualAdjustment.enabled = {{ adjustmentEnabled ? 'true' : 'false' }}
+            {{
+              adjustmentEnabled === null
+                ? '人工调整开关未知'
+                : adjustmentEnabled
+                  ? '人工调整已启用'
+                  : '本期人工调整已关闭'
+            }}
+            <span
+              class="mx-badge"
+              :class="
+                adjustmentEnabled === true
+                  ? 'mx-badge-success'
+                  : adjustmentEnabled === false
+                    ? 'mx-badge-warning'
+                    : 'mx-badge-neutral'
+              "
+            >
+              manualAdjustment.enabled = {{ adjustmentEnabled === null ? '未知' : adjustmentEnabled ? 'true' : 'false' }}
            </span>
          </div>
          <p class="notice-desc">
-            <template v-if="adjustmentEnabled">
+            <template v-if="adjustmentEnabled === true">
              分值可正可负，类别为处罚 / 补分 / 更正，理由必填；作废会同时作废对应积分流水。
            </template>
-            <template v-else>
+            <template v-else-if="adjustmentEnabled === false">
              本次运动会扣分 / 处罚完全在系统外处理，系统只负责成绩分（02 第 4 节）。
              功能与数据表已保留，以后赛事开一个开关即可启用。
            </template>
+            <template v-else>
+              当前角色读不到规则包（/api/rules/export 仅管理员可读），无法判断开关状态，不再按「关闭」显示；
+              「新增调整」提交后由服务端校验决定是否受理。
+            </template>
          </p>
          <p v-if="ruleError !== null" class="notice-error">
-            读取规则包失败：{{ ruleError }}，当前按「关闭」处理。
+            读取规则包失败：{{ ruleError }}；开关状态未知，不再按「关闭」处理。
          </p>
        </div>
      </div>
@@ -323,7 +355,11 @@ onMounted(() => {
          <div class="mx-empty-icon"><MxIcon name="adjust" :size="26" /></div>
          <div class="mx-empty-title">没有调整记录</div>
          <div class="mx-empty-desc">
-            {{ adjustmentEnabled ? '点击「新增调整」录入第一条' : '本期人工调整关闭，故为空' }}
+            {{
+              adjustmentEnabled === false
+                ? '本期人工调整关闭，故为空'
+                : '点击「新增调整」录入第一条'
+            }}
          </div>
        </div>
        <template v-else>
@@ -254,13 +254,14 @@ async function loadSuspected(): Promise<void> {
  }
 }

-function bonusFor(level: RecordLevel): number {
-  const definition = rulePack.value?.recordBonus.levels.find((item) => item.code === level)
-  return definition?.points ?? 0
+function bonusFor(level: RecordLevel): number | null {
+  if (rulePack.value === null) return null
+  const definition = rulePack.value.recordBonus.levels.find((item) => item.code === level)
+  return definition?.points ?? null
 }

 function requestApprove(item: SuspectedBreak): void {
-  if (!recordBonusEnabled.value) {
+  if (recordBonusEnabled.value === false) {
    toast.error('本期破纪录加分已关闭', '规则包 recordBonus.enabled = false，确认后不会生成加分流水')
    return
  }
@@ -268,6 +269,9 @@ function requestApprove(item: SuspectedBreak): void {
    toast.error('当前不可写入', auth.readOnly ? '请先登录' : '服务端未连接')
    return
  }
+  if (recordBonusEnabled.value === null) {
+    toast.info('加分开关状态未知', '当前角色读不到规则包，将由服务端校验后决定是否加分')
+  }
  approveTarget.value = item
 }

@@ -286,7 +290,12 @@ async function confirmApprove(): Promise<void> {
    await adminApi.client.records.approveBreak(created.id)
    approvedKeys.value = [...approvedKeys.value, item.key]
    approveTarget.value = null
-    toast.success('已确认破纪录', `+${formatPoints(item.bonusPoints)} 分（${LEVEL_LABELS[item.level]}）`)
+    toast.success(
+      '已确认破纪录',
+      item.bonusPoints === null
+        ? `${LEVEL_LABELS[item.level]}纪录，加分分值以服务端结果为准`
+        : `+${formatPoints(item.bonusPoints)} 分（${LEVEL_LABELS[item.level]}）`,
+    )
    await Promise.all([loadRecords(), data.refreshStandings()])
  } catch (caught) {
    if (isFallback(caught)) {
@@ -343,22 +352,41 @@ watch(
        <span class="notice-icon"><MxIcon name="warning" :size="18" /></span>
        <div>
          <div class="notice-title">
-            {{ recordBonusEnabled ? '破纪录加分已启用' : '本期破纪录加分已关闭' }}
-            <span class="mx-badge" :class="recordBonusEnabled ? 'mx-badge-success' : 'mx-badge-warning'">
-              recordBonus.enabled = {{ recordBonusEnabled ? 'true' : 'false' }}
+            {{
+              recordBonusEnabled === null
+                ? '破纪录加分开关未知'
+                : recordBonusEnabled
+                  ? '破纪录加分已启用'
+                  : '本期破纪录加分已关闭'
+            }}
+            <span
+              class="mx-badge"
+              :class="
+                recordBonusEnabled === true
+                  ? 'mx-badge-success'
+                  : recordBonusEnabled === false
+                    ? 'mx-badge-warning'
+                    : 'mx-badge-neutral'
+              "
+            >
+              recordBonus.enabled = {{ recordBonusEnabled === null ? '未知' : recordBonusEnabled ? 'true' : 'false' }}
            </span>
          </div>
          <p class="notice-desc">
-            <template v-if="recordBonusEnabled">
+            <template v-if="recordBonusEnabled === true">
              确认破纪录会生成加分流水并更新纪录库；加分档位 {{ bonusMode }}，与成绩积分相互独立（不随权重翻倍）。
            </template>
-            <template v-else>
+            <template v-else-if="recordBonusEnabled === false">
              规则包 `recordBonus.enabled = false`（02 第 3 节）。疑似破纪录仍会列出，但「确认加分」不会生成加分流水；
              以后开一个开关即可启用，档位与分值已预置。
            </template>
+            <template v-else>
+              当前角色读不到规则包（/api/rules/export 仅管理员可读），无法判断开关状态，不再按「关闭」显示；
+              疑似破纪录仍会列出，「确认加分」提交后由服务端校验决定是否生成加分流水。
+            </template>
          </p>
          <p v-if="ruleError !== null" class="notice-error">
-            读取规则包失败：{{ ruleError }}，当前按「关闭」处理。
+            读取规则包失败：{{ ruleError }}；开关状态未知，不再按「关闭」处理。
          </p>
        </div>
      </div>
@@ -411,12 +439,14 @@ watch(
                <td class="mono highlight">{{ item.resultText }}</td>
                <td class="mono">{{ item.recordText }}</td>
                <td><span class="mx-tag mx-tag-primary">{{ LEVEL_LABELS[item.level] }}</span></td>
-                <td class="right mono points">+{{ formatPoints(item.bonusPoints) }}</td>
+                <td class="right mono points">
+                  {{ item.bonusPoints === null ? '—' : `+${formatPoints(item.bonusPoints)}` }}
+                </td>
                <td class="right actions">
                  <button
                    class="mx-btn mx-btn-primary mx-btn-sm"
                    type="button"
-                    :disabled="!recordBonusEnabled || !canWrite || approving"
+                    :disabled="recordBonusEnabled === false || !canWrite || approving"
                    @click="requestApprove(item)"
                  >
                    确认加分
@@ -427,9 +457,12 @@ watch(
            </tbody>
          </table>
        </div>
-        <p v-if="!recordBonusEnabled && pendingBreaks.length > 0" class="hint">
+        <p v-if="recordBonusEnabled === false && pendingBreaks.length > 0" class="hint">
          「确认加分」在 recordBonus 关闭时不可用，避免生成无规则的积分流水。
        </p>
+        <p v-else-if="recordBonusEnabled === null && pendingBreaks.length > 0" class="hint">
+          当前角色读不到规则包，加分开关状态未知；「确认加分」可提交，由服务端校验决定。
+        </p>
      </div>
    </section>

@@ -519,7 +552,9 @@ watch(
      :message="
        approveTarget === null
          ? ''
-          : `将登记「${approveTarget.eventName} · ${approveTarget.athleteName}」的 ${LEVEL_LABELS[approveTarget.level]}纪录，并生成 +${formatPoints(approveTarget.bonusPoints)} 分加分流水。`
+          : approveTarget.bonusPoints === null
+            ? `将登记「${approveTarget.eventName} · ${approveTarget.athleteName}」的 ${LEVEL_LABELS[approveTarget.level]}纪录；加分分值未知，以服务端结果为准。`
+            : `将登记「${approveTarget.eventName} · ${approveTarget.athleteName}」的 ${LEVEL_LABELS[approveTarget.level]}纪录，并生成 +${formatPoints(approveTarget.bonusPoints)} 分加分流水。`
      "
      :details="[
        `成绩：${approveTarget?.resultText ?? ''}（原纪录 ${approveTarget?.recordText ?? ''}）`,
@@ -0,0 +1,37 @@
+import { ref } from 'vue'
+
+export type Theme = 'light' | 'dark'
+
+const STORAGE_KEY = 'scoreboard.admin.theme'
+
+function readStored(): Theme {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY)
+    if (raw === 'light' || raw === 'dark') return raw
+  } catch {
+    // 隐私模式等场景 localStorage 会抛错，退回 admin.html 里的静态默认值
+  }
+  return document.documentElement.dataset.theme === 'light' ? 'light' : 'dark'
+}
+
+/** 当前主题；MIUIx 的浅色令牌挂在 :root，深色令牌挂在 [data-theme="dark"]。 */
+export const theme = ref<Theme>(readStored())
+
+export function applyTheme(next: Theme): void {
+  theme.value = next
+  document.documentElement.dataset.theme = next
+  try {
+    localStorage.setItem(STORAGE_KEY, next)
+  } catch {
+    // 持久化失败不影响本次会话内的切换
+  }
+}
+
+export function toggleTheme(): void {
+  applyTheme(theme.value === 'dark' ? 'light' : 'dark')
+}
+
+/** 在应用挂载前调用，避免首屏先渲染静态默认值再跳变。 */
+export function initTheme(): void {
+  document.documentElement.dataset.theme = theme.value
+}