feat: 8 条功能 + 身份口径改为号码布为准（含批量退赛/移出、基础数据导入导出、登录有效期）

用户给出的 8 条功能 + 一条口径变更，全部带真机/真浏览器验证： ① 录入页姓名后直接显示号码布（原「号码」列保留） ② 录入页批次进度条：`第 2 批已录 5/8 · 3 条有错`，录完变绿；已录判据复用 entryGuards.judgeEntryRow（与发布防呆同源，不会出现"进度条说录完、发布说缺 8 条"） ⑦ 小项列表双击 → 跳到该小项的组别（编辑/删除按钮不误触） ③ 赛事开关 `standings.live_on_publish`（默认开＝保持原行为）：关闭后分批发布只上屏成绩，名次/流水/榜单一起等该组录完再结算 —— 代理实读代码后纠正了我的前提：奖牌榜读的是 results.rank（buildRanked）而非流水汇总，只延迟流水会出现「有金牌但 0 分」。另提供 POST /api/results/settle 人工兜底 + GET /api/results/settlement 未结算清单 ④ 组别「就地更新」PUT /api/events/{id}/categories/{categoryId}：有报名数据时也能改名/改年龄/ 改性别/改权重（旧路径是整表替换，一改就被 409 拦下）；改名不动报名/成绩/流水（真机逐字节比对）；权重真的变了才触发该组重算（容差 1e-9） ④辅运动员列表多选+全选，POST /api/athletes/batch 一次请求完成整批停用/彻底删除（逐条回报， dryRun 预览走同一段 SQL 但不提交、不写审计）——这才是绕开限流的正解新增报名项批量：POST /api/entries/batch（scratch/restore/remove）。退赛只动 registered、跳过 dq/dns 并说明原因；移出是物理删除，必须显式清 score_ledger（该表 entry_id 是 ON DELETE SET NULL，不显式删会留下"人没了分还在"的孤儿流水，验证基线 orphan=0）；退赛同时清 results.rank（否则出现"0 分还挂着金牌"） ⑤ GET /api/export/entries.xlsx 报名名单导出（13 列含批次，状态中文与录入页逐字一致） ⑥ 基础数据包：GET /api/export/basedata.xlsx + POST /api/export/basedata/import （四张表、表头只有一份定义、表头行自动定位、列缺席≠写空、按编码 upsert、绝不删除、行级中文错误带真实 Excel 行号、枚举走既有校验、新增单位一定是启用） ⑧ 登录有效期面板可配：系统设置新页签，1–720 小时，默认 12h → 24h；滑动续期 + Cookie 同步刷新（只服务端续期是假的，浏览器侧的 Max-Age 到点仍会丢 Cookie）身份口径：号码布为唯一标识、证件号退出匹配（号码布不同=同名的两个人，新建并单独报告）；同一份表重复证件号不再报错；两个不同的人共用证件号仍报行级错误（唯一索引保留）其它对齐：分项成绩表草稿行不再消失（成绩列「分数未录入」、名次/积分 `—`，没成绩的行同占位）；大屏实时赛况单栏铺满（留白 370→78px）、字号上限 56→96px、≥7 行自动拆左右两块；删除报名项/退赛/权重等改动都会重算并推榜单。测试：服务端 13 包（连跑两遍）、前端 335 例、vue-tsc + build、Console 18 文件 —— 全绿。文档：README、docs/ 四份（含 debug/使用说明副本）、devdocs 05/08/04/13。版本号 dev_0.1.5 → dev_0.1.6。
2026-09-11 17:14:02 +08:00
1 parent 8dd599bd97
commit 631c8dd8e1
@@ -21,6 +21,13 @@ import { adminApi } from '../api/client'
 import { useAuthStore } from '../stores/auth'
 import { useEventStore } from '../stores/event'
 import { useToastStore } from '../stores/toast'
+import {
+  downloadBaseDataXLSX,
+  downloadEntriesXLSX,
+  importBaseDataXLSX,
+  type BaseDataImportResult,
+} from '@/shared/basedata'
+import type { EventCategory } from '@/shared'

 /**
 * 导出与赛事包（devdocs/07 第 5 节）。
@@ -32,10 +39,11 @@ import { useToastStore } from '../stores/toast'
 * 因此导入完成后还要在项目列表里切换，页面才看得到导入的数据。
 */

-type TabKey = 'results' | 'project' | 'rules'
+type TabKey = 'results' | 'basedata' | 'project' | 'rules'

 const TABS: ReadonlyArray<{ key: TabKey; label: string }> = [
  { key: 'results', label: '结果导出' },
+  { key: 'basedata', label: '基础数据' },
  { key: 'project', label: '赛事项目包' },
  { key: 'rules', label: '规则包' },
 ]
@@ -119,6 +127,147 @@ const rulesPreview = ref<RulePreview | null>(null)
 const rulesApplyResult = ref<RuleApplyResult | null>(null)
 const confirmRulesApply = ref(false)

+// ── 报名名单（xlsx，可按小项 / 组别 / 单位 / 批次筛） ────────────────────────
+const entryEventId = ref<number | null>(null)
+const entryCategoryId = ref<number | null>(null)
+const entryTeamId = ref<number | null>(null)
+/** 批次用字符串存：空串 = 不筛，交给后端时再转成数字。 */
+const entryHeat = ref('')
+const entryCategories = ref<EventCategory[]>([])
+const entryExporting = ref(false)
+
+/**
+ * 换小项就把组别重置并重新拉取：组别 id 只在小项内有意义，
+ * 沿用上一个小项的组别会把筛选条件悄悄变成「没有数据」。
+ */
+watch(entryEventId, async (id) => {
+  entryCategoryId.value = null
+  entryCategories.value = []
+  if (id === null) return
+  try {
+    entryCategories.value = await adminApi.client.events.categories(id)
+  } catch (caught) {
+    toast.error('读取组别失败', describeError(caught))
+  }
+})
+
+async function exportEntries(): Promise<void> {
+  let heat: number | undefined
+  const rawHeat = entryHeat.value.trim()
+  if (rawHeat !== '') {
+    const parsed = Number(rawHeat)
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+      toast.warning('批次需要是正整数（留空表示不筛）')
+      return
+    }
+    heat = parsed
+  }
+  entryExporting.value = true
+  try {
+    const file = await downloadEntriesXLSX({
+      eventId: entryEventId.value ?? undefined,
+      categoryId: entryCategoryId.value ?? undefined,
+      teamId: entryTeamId.value ?? undefined,
+      heat,
+    })
+    adminApi.client.exports.save(file.blob, file.filename)
+    toast.success(`已导出 ${file.filename}`)
+  } catch (caught) {
+    toast.error('导出失败', describeError(caught))
+  } finally {
+    entryExporting.value = false
+  }
+}
+
+// ── 基础数据包（单位 / 大项 / 小项 / 组别） ──────────────────────────────────
+const baseDataFile = ref<File | null>(null)
+const baseDataInput = ref<HTMLInputElement | null>(null)
+const baseDataExporting = ref(false)
+const baseDataPreviewing = ref(false)
+const baseDataApplying = ref(false)
+const baseDataError = ref<string | null>(null)
+const baseDataResult = ref<BaseDataImportResult | null>(null)
+const confirmBaseDataApply = ref(false)
+
+async function exportBaseData(): Promise<void> {
+  baseDataExporting.value = true
+  baseDataError.value = null
+  try {
+    const file = await downloadBaseDataXLSX()
+    adminApi.client.exports.save(file.blob, file.filename)
+    toast.success('基础数据包已导出', '含 单位 / 大项 / 小项 / 组别 四张工作表，可原样导回')
+  } catch (caught) {
+    baseDataError.value = describeError(caught)
+  } finally {
+    baseDataExporting.value = false
+  }
+}
+
+function pickBaseDataFile(event: Event): void {
+  const input = event.target as HTMLInputElement
+  const file = input.files?.[0] ?? null
+  baseDataResult.value = null
+  baseDataError.value = null
+  if (file === null) {
+    baseDataFile.value = null
+    return
+  }
+  if (!/\.xlsx$/i.test(file.name)) {
+    baseDataError.value = '基础数据包必须是 .xlsx 文件：单位 / 大项 / 小项 / 组别分在四张工作表里'
+    baseDataFile.value = null
+    input.value = ''
+    return
+  }
+  baseDataFile.value = file
+}
+
+/** 第一步：只算差异不写库。用户看清了再点确认写入。 */
+async function previewBaseData(): Promise<void> {
+  const file = baseDataFile.value
+  if (file === null) {
+    baseDataError.value = '请先选择 .xlsx 基础数据包'
+    return
+  }
+  baseDataPreviewing.value = true
+  baseDataError.value = null
+  baseDataResult.value = null
+  try {
+    baseDataResult.value = await importBaseDataXLSX(file, { dryRun: true })
+  } catch (caught) {
+    baseDataError.value = describeError(caught)
+  } finally {
+    baseDataPreviewing.value = false
+  }
+}
+
+function requestBaseDataApply(): void {
+  if (baseDataResult.value === null) return
+  confirmBaseDataApply.value = true
+}
+
+async function applyBaseData(): Promise<void> {
+  const file = baseDataFile.value
+  if (file === null) return
+  confirmBaseDataApply.value = false
+  baseDataApplying.value = true
+  baseDataError.value = null
+  try {
+    const result = await importBaseDataXLSX(file, { dryRun: false })
+    baseDataResult.value = result
+    toast.success(
+      '基础数据已写入',
+      `新增 ${result.added} 条 / 更新 ${result.updated} 条` +
+        (result.errorCount > 0 ? ` / ${result.errorCount} 行出错未写入` : ''),
+    )
+    // 导入会新增单位 / 大项 / 小项，页面上的下拉与基础数据页都要跟着刷新。
+    void data.load()
+  } catch (caught) {
+    baseDataError.value = describeError(caught)
+  } finally {
+    baseDataApplying.value = false
+  }
+}
+
 const isAdmin = computed(() => auth.user?.role === 'admin')

 const activeProjectName = computed(() => projects.value.find((item) => item.active)?.name ?? null)
@@ -484,8 +633,203 @@ async function applyRules(): Promise<void> {
      </div>
    </section>

+    <!-- 报名名单：同样是 xlsx 导出，但读的是报名数据（批次、号码布、状态都在这一侧） -->
+    <section v-if="activeTab === 'results'" class="mx-card entries-card">
+      <div class="mx-card-head">
+        <span class="mx-card-title">报名名单（xlsx）</span>
+      </div>
+      <div class="mx-card-body">
+        <p class="hint">
+          按小项 / 组别 / 单位 / 批次筛选，留空表示该维度不筛。表里含小项编码与名称、组别、单位、姓名、证件号、号码布、<strong>批次</strong>、性别、年龄、状态与备注；号码布按文本导出，前导零不会丢。
+        </p>
+        <div class="form-grid">
+          <div class="field">
+            <label class="mx-label" for="entries-event">小项</label>
+            <div class="mx-input-wrap">
+              <select id="entries-event" v-model="entryEventId" class="mx-input">
+                <option :value="null">全部小项</option>
+                <option v-for="item in eventOptions" :key="item.id" :value="item.id">{{ item.label }}</option>
+              </select>
+            </div>
+          </div>
+          <div class="field">
+            <label class="mx-label" for="entries-category">组别</label>
+            <div class="mx-input-wrap">
+              <select
+                id="entries-category"
+                v-model="entryCategoryId"
+                class="mx-input"
+                :disabled="entryEventId === null || entryCategories.length === 0"
+              >
+                <option :value="null">全部组别</option>
+                <option v-for="item in entryCategories" :key="item.id" :value="item.id">{{ item.name }}</option>
+              </select>
+            </div>
+          </div>
+          <div class="field">
+            <label class="mx-label" for="entries-team">单位</label>
+            <div class="mx-input-wrap">
+              <select id="entries-team" v-model="entryTeamId" class="mx-input">
+                <option :value="null">全部单位</option>
+                <option v-for="team in data.teams" :key="team.id" :value="team.id">
+                  {{ team.name }}（{{ team.code }}）
+                </option>
+              </select>
+            </div>
+          </div>
+          <div class="field">
+            <label class="mx-label" for="entries-heat">批次</label>
+            <div class="mx-input-wrap">
+              <input
+                id="entries-heat"
+                v-model="entryHeat"
+                class="mx-input"
+                inputmode="numeric"
+                placeholder="全部批次（留空）"
+              />
+            </div>
+          </div>
+        </div>
+        <button
+          class="mx-btn mx-btn-primary full"
+          type="button"
+          :disabled="entryExporting"
+          @click="exportEntries"
+        >
+          <MxIcon name="export" :size="15" />
+          {{ entryExporting ? '导出中…' : '导出报名名单' }}
+        </button>
+      </div>
+    </section>
+
+    <!-- 基础数据包：导出可原样导回；导入按编码 upsert，先预览差异再写入 -->
+    <div v-if="activeTab === 'basedata'" class="basedata-grid">
+      <section class="mx-card">
+        <div class="mx-card-head">
+          <span class="mx-card-title">导出基础数据包</span>
+        </div>
+        <div class="mx-card-body">
+          <p class="hint">
+            一个工作簿含四张工作表：单位 / 大项 / 小项 / 组别（组别带所属小项编码）。列名是中文表头，导出的文件可以直接原样导回来，识别到的差异为 0。
+          </p>
+          <button
+            class="mx-btn mx-btn-primary full"
+            type="button"
+            :disabled="baseDataExporting"
+            @click="exportBaseData"
+          >
+            <MxIcon name="export" :size="15" />
+            {{ baseDataExporting ? '导出中…' : '导出 xlsx' }}
+          </button>
+        </div>
+      </section>
+
+      <section class="mx-card">
+        <div class="mx-card-head"><span class="mx-card-title">导入基础数据包</span></div>
+        <div class="mx-card-body">
+          <p v-if="!isAdmin" class="notice">导入基础数据会批量写入单位 / 大项 / 小项 / 组别，只有管理员可操作。</p>
+
+          <div class="file-row">
+            <input
+              ref="baseDataInput"
+              class="file-input"
+              type="file"
+              accept=".xlsx,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+              @change="pickBaseDataFile"
+            />
+            <button class="mx-btn mx-btn-secondary" type="button" @click="baseDataInput?.click()">
+              <MxIcon name="database" :size="15" /> 选择 .xlsx
+            </button>
+            <span class="file-name mono">{{ baseDataFile?.name ?? '未选择文件' }}</span>
+          </div>
+
+          <p class="hint">
+            按编码 upsert：单位 / 大项按编码，小项按编码，组别按「小项编码 + 组别名」；存在就更新、不存在就新建。
+            文件里没写的数据一条都不会删。
+          </p>
+          <p class="hint">导入分两步：先「预览差异」，确认无误后再写入。</p>
+
+          <p v-if="baseDataError !== null" class="notice error">{{ baseDataError }}</p>
+
+          <button
+            class="mx-btn mx-btn-secondary full"
+            type="button"
+            :disabled="!isAdmin || baseDataPreviewing || baseDataFile === null"
+            @click="previewBaseData"
+          >
+            {{ baseDataPreviewing ? '比对中…' : '预览差异' }}
+          </button>
+
+          <div v-if="baseDataResult !== null" class="preview-box">
+            <div class="preview-head">
+              <span class="mx-badge mx-badge-neutral">新增 {{ baseDataResult.added }} 条</span>
+              <span class="mx-badge mx-badge-warning">更新 {{ baseDataResult.updated }} 条</span>
+              <span class="mx-badge" :class="baseDataResult.errorCount > 0 ? 'mx-badge-error' : 'mx-badge-neutral'">
+                错误 {{ baseDataResult.errorCount }} 条
+              </span>
+              <span class="preview-meta">
+                {{ baseDataResult.dryRun ? '预览（未写库）' : '已写入' }}
+                <template v-if="baseDataResult.unchanged > 0">· 无变化 {{ baseDataResult.unchanged }} 条</template>
+              </span>
+            </div>
+
+            <div v-if="baseDataResult.errors.length > 0" class="error-list">
+              <div v-for="(message, index) in baseDataResult.errors" :key="index" class="error-line">
+                {{ message }}
+              </div>
+            </div>
+
+            <div v-if="baseDataResult.changes.length === 0" class="mx-empty">
+              <div class="mx-empty-title">没有差异</div>
+              <div class="mx-empty-desc">文件内容与库里一致，无需写入</div>
+            </div>
+            <div v-else class="mx-table-wrap">
+              <table class="mx-table mx-table-compact">
+                <thead>
+                  <tr>
+                    <th>工作表</th>
+                    <th>行</th>
+                    <th>变化</th>
+                    <th>对象</th>
+                    <th>字段差异</th>
+                  </tr>
+                </thead>
+                <tbody>
+                  <tr v-for="(row, index) in baseDataResult.changes" :key="`${row.sheet}-${row.line}-${index}`">
+                    <td>{{ row.sheet }}</td>
+                    <td class="mono">第 {{ row.line }} 行</td>
+                    <td>
+                      <span class="mx-badge" :class="row.action === 'added' ? 'mx-badge-success' : 'mx-badge-warning'">
+                        {{ row.action === 'added' ? '新增' : '更新' }}
+                      </span>
+                    </td>
+                    <td class="mono">{{ row.key }}</td>
+                    <td class="detail">
+                      <span v-for="f in row.fields" :key="f.field" class="field-diff">
+                        {{ f.field }}：{{ f.from === '' ? '（空）' : f.from }} → {{ f.to === '' ? '（空）' : f.to }}
+                      </span>
+                    </td>
+                  </tr>
+                </tbody>
+              </table>
+            </div>
+
+            <button
+              v-if="baseDataResult.dryRun"
+              class="mx-btn mx-btn-danger full"
+              type="button"
+              :disabled="!isAdmin || baseDataApplying"
+              @click="requestBaseDataApply"
+            >
+              {{ baseDataApplying ? '写入中…' : '确认写入' }}
+            </button>
+          </div>
+        </div>
+      </section>
+    </div>
+
    <!-- 赛事项目包 -->
-    <div v-else-if="activeTab === 'project'" class="project-grid">
+    <div v-if="activeTab === 'project'" class="project-grid">
      <section class="mx-card wide">
        <div class="mx-card-head">
          <span class="mx-card-title">赛事项目列表</span>
@@ -676,7 +1020,7 @@ async function applyRules(): Promise<void> {
    </div>

    <!-- 规则包 -->
-    <div v-else class="rules-grid">
+    <div v-if="activeTab === 'rules'" class="rules-grid">
      <section class="mx-card">
        <div class="mx-card-head">
          <span class="mx-card-title">导出规则包</span>
@@ -815,6 +1159,24 @@ async function applyRules(): Promise<void> {
      @cancel="confirmRulesApply = false"
    />

+    <ConfirmDialog
+      :open="confirmBaseDataApply"
+      tone="danger"
+      title="写入基础数据？"
+      :message="`将按文件内容新增 ${baseDataResult?.added ?? 0} 条、更新 ${baseDataResult?.updated ?? 0} 条单位 / 大项 / 小项 / 组别。`"
+      :details="[
+        '按编码 upsert：存在就更新、不存在就新建',
+        '文件里没写的既有数据不会被删除',
+        baseDataResult !== null && baseDataResult.errorCount > 0
+          ? `${baseDataResult.errorCount} 行有错误，这些行会被跳过，其余行照常写入`
+          : '本次预览没有行级错误',
+      ]"
+      confirm-text="确认写入"
+      :pending="baseDataApplying"
+      @confirm="applyBaseData"
+      @cancel="confirmBaseDataApply = false"
+    />
+
    <p class="footer-note">当前数据更新于 {{ formatDateTime(data.lastRefreshAt) }}</p>
  </div>
 </template>
@@ -879,6 +1241,33 @@ async function applyRules(): Promise<void> {
  gap: 16px;
  align-items: start;
 }
+/* 报名名单排在结果导出卡片下方，同样占满整行。 */
+.entries-card {
+  margin-top: 16px;
+}
+/* 基础数据包：导出与导入各一张卡，宽度与赛事包一致。 */
+.basedata-grid {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) minmax(0, 1.2fr);
+  gap: 16px;
+  align-items: start;
+}
+.error-list {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 8px 10px;
+  border-radius: var(--mx-r-xs);
+  background: rgba(248, 113, 113, 0.1);
+}
+.error-line {
+  font-size: 12px;
+  color: var(--mx-error);
+  line-height: 1.6;
+}
+.field-diff {
+  display: block;
+}
 /* 项目列表与导出 / 导入卡片不同，是整行的总览表。 */
 .project-grid > .wide {
  grid-column: 1 / -1;
@@ -993,7 +1382,8 @@ async function applyRules(): Promise<void> {
 }
@media (max-width: 1279px) {
  .project-grid,
-  .rules-grid {
+  .rules-grid,
+  .basedata-grid {
    grid-template-columns: 1fr;
  }
 }