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
@@ -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 ?? ''}）`,