feat(import): 报名模板按「小项 × 组别」分工作表；号码布判重改认证件号；备份改原子落盘

三件事合成一次提交（其中两件都落在 handlers_config.go，无法按文件拆开）：

一、分工作表报名模板（新增能力）
- 新增 GET /api/entries/template.xlsx：按当前赛事的「小项 × 组别」生成模板，
  一个小项组别一张工作表，工作表名 = <小项>@<组别>（31 字符上限、重名自动去重）。
- 导入解析器认工作表名还原小项 + 组别；若与表内列冲突则报错，不静默取其一。
- 小项名与组别名禁用 @，基础数据界面 / 规则包导入 / 服务端校验三处一并拦截。
- 单表 CSV/XLSX 导入路径不回归。

二、号码布判重（修误判）
- 旧逻辑依赖证件号本身，而证件号是可选字段 → 同一个人报多个项目会被整块拦下。
- 改为：号码布相同且证件号相同 → 判定为同一人报多项，放行；
  号码布相同且证件号都能填且不同 → 仍报错（真抢号）；一方证件号为空 → 放行并给提示。
- 团体行的号码布一并纳入查重。

三、自动备份的关停与落盘（修数据安全隐患）
- export.Service 增加 Wait()：StartAuto 的协程进 WaitGroup，关停时 join（10 秒上限，
  超时只记 WARN 不拖死关闭），不再在备份写到一半时退出。
- vacuumInto 改为先写 <最终名>.tmp-<随机> 再 rename，失败则删临时文件；
  Backup / SafetySnapshot / ExportProjectZip 三个调用方一并受益。
- 新增 isFinalBackupName，ListBackups / safetyCopies / KindOfBackupName 统一过滤中间文件，
  避免半截 .db 被列进备份列表、进而被「一键恢复」选中。

文档：docs/ 五份（使用手册 / 报名名单导入规范 / 升级说明 / 部署指南 / 上线检查清单）同步。

web/src/admin/tests/entry-selection.test.ts

@@ -390,15 +390,29 @@ test('缺列提示中英并列，且点到表头行', () => {
   assert.match(message, /中文与英文表头都认/)
 })
 
-// ImportSection 的两个下载按钮：现场人多手快，文案必须一眼能分（SFC 跑不进 node --test，
+// ImportSection 的四个下载按钮：现场人多手快，文案必须一眼能分（SFC 跑不进 node --test，
 // 这里用源码契约断言接线：按钮确实在、点了确实按语言下载）。
-test('ImportSection 有两个模板下载按钮，分别下载中英表头', () => {
+//
+// 两种模板：单表 CSV（「中文表头 / 英文表头」，前端本地拼）与分工作表 XLSX
+// （「分工作表 · 中文表头 / 分工作表 · 英文表头」，由服务端按当前小项与组别生成）。
+test('ImportSection 有四个模板下载按钮：单表两套表头 + 分工作表两套表头', () => {
   const source = readFileSync(new URL('../components/baseData/ImportSection.vue', import.meta.url), 'utf8')
   assert.match(source, />\s*<MxIcon name="export"[^<]*\/>\s*中文表头\s*</, '有「中文表头」按钮')
   assert.match(source, />\s*<MxIcon name="export"[^<]*\/>\s*英文表头\s*</, '有「英文表头」按钮')
+  assert.match(source, />\s*<MxIcon name="export"[^<]*\/>\s*分工作表 · 中文表头\s*</, '有「分工作表 · 中文表头」按钮')
+  assert.match(source, />\s*<MxIcon name="export"[^<]*\/>\s*分工作表 · 英文表头\s*</, '有「分工作表 · 英文表头」按钮')
   assert.match(source, /downloadTemplate\('zh'\)/)
   assert.match(source, /downloadTemplate\('en'\)/)
-  assert.match(source, /anchor\.download = templateFileName\(language\)/, '文件名按语言取，两个文件不重名')
+  assert.match(source, /downloadSheetTemplate\('zh'\)/)
+  assert.match(source, /downloadSheetTemplate\('en'\)/)
+  assert.match(source, /saveBlob\(blob, templateFileName\(language\)\)/, '单表文件名按语言取，两个文件不重名')
+  assert.match(source, /saveBlob\(blob, templateSheetFileName\(language\)\)/, '分工作表文件名按语言取')
   assert.match(source, /buildTemplateCsv\(language\)/)
+  // 分工作表模板必须走服务端（浏览器里造不出多工作表 xlsx），且失败时要把服务端那句话显示出来。
+  assert.match(source, /data\.downloadEntriesTemplate\(language\)/)
+  assert.match(source, /templateError\.value = caught instanceof Error \? caught\.message : /)
   assert.doesNotMatch(source, /entries-template\.csv/, '不再用不分语言的老文件名')
+  // 分工作表模板由服务端生成、以 Blob 交回本地存盘：不能把接口地址直接塞进 <a href>
+  // （服务端拒绝时回的是 JSON 错误体，浏览器会把那份 JSON 存成一个「下载成功」的文件）。
+  assert.match(source, /URL\.createObjectURL\(blob\)/)
 })

web/src/admin/tests/entry-template-sheet.test.ts

@@ -0,0 +1,156 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import {
+  atSignNameError,
+  templateFileName,
+  templateSheetFileName,
+} from '../components/baseData/entrySelection'
+
+/**
+ * 分工作表模板（一个小项 × 一个组别一张工作表）在前端这一侧的三件事：
+ * 表名里的 @ 为什么不能出现在小项 / 组别名里（界面校验的文案）、下载文件名、
+ * 以及下载走的是哪个接口、服务端拒绝时错误怎么回到页面。
+ *
+ * 服务端那一半（生成工作簿、按表名解析）在 server/internal/httpapi 的
+ * entries_sheet_template_test.go 里钉着；这里钉的是「界面拦住 + 请求发对」。
+ */
+
+// 必须在导入被测模块之前装好 fetch：ApiClient 构造时就把当时的 fetch 绑进实例。
+function jsonResponse(body: unknown, status = 200): Response {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { 'Content-Type': 'application/json' },
+  })
+}
+
+let calls: string[] = []
+let reply: () => Response = () => jsonResponse({ ok: true, data: null })
+
+globalThis.fetch = (async (input: unknown) => {
+  calls.push(String(input))
+  return reply()
+}) as typeof fetch
+
+const { ApiError } = await import('@/shared')
+const { createApiClient } = await import('@/shared')
+const { baseDataApi, baseDataFallback } = await import('../components/baseData/baseDataApi')
+const { mockMode, mockReason } = await import('../api/client')
+const { TEMPLATE_SHEET_MOCK_HINT } = await import('../components/baseData/entrySelection')
+
+test('小项名 / 组别名里出现 @ 时给出带理由的提示；没有 @ 时不拦', () => {
+  assert.equal(atSignNameError('小项名称', '100米跑'), null)
+  assert.equal(atSignNameError('组别名称', ''), null)
+
+  const event = atSignNameError('小项名称', '100米@跑')
+  assert.ok(event !== null)
+  assert.match(event, /小项名称「100米@跑」/)
+  // 「为什么」必须写出来：只说「不能含 @」现场会以为是输入法问题。
+  assert.match(event, /分隔符/)
+  assert.match(event, /小项名称@组别名称/)
+
+  const category = atSignNameError('组别名称', '男子@甲组')
+  assert.ok(category !== null)
+  assert.match(category, /组别名称「男子@甲组」/)
+  assert.match(category, /分隔符/)
+
+  // 全角 ＠ 与半角 @ 在表名里肉眼分不出，一并拦。
+  assert.ok(atSignNameError('小项名称', '男子＠甲组') !== null)
+})
+
+test('两种模板的文件名分得清：csv 是单表模板、xlsx 是分工作表模板', () => {
+  assert.equal(templateFileName('zh'), 'entries-template-zh.csv')
+  assert.equal(templateFileName('en'), 'entries-template-en.csv')
+  assert.equal(templateSheetFileName('zh'), 'entries-template-zh.xlsx')
+  assert.equal(templateSheetFileName('en'), 'entries-template-en.xlsx')
+})
+
+test('下载分工作表模板走 GET /entries/template.xlsx 并带 lang', async () => {
+  const client = createApiClient({
+    baseUrl: '/api',
+    fetchImpl: async (input) => {
+      calls.push(String(input))
+      return new Response(new Blob([new Uint8Array([0x50, 0x4b, 0x03, 0x04])]), {
+        status: 200,
+        headers: { 'Content-Type': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' },
+      })
+    },
+  })
+
+  calls = []
+  const blob = await client.entries.downloadTemplate('en')
+
+  assert.deepEqual(calls, ['/api/entries/template.xlsx?lang=en'])
+  assert.equal(blob.size, 4)
+})
+
+test('服务端拒绝生成时，错误文案原样回到页面（不是一份存下来的报错文件）', async () => {
+  const client = createApiClient({
+    baseUrl: '/api',
+    fetchImpl: async () =>
+      jsonResponse(
+        {
+          ok: false,
+          error: {
+            code: 'CONFLICT',
+            message: '当前赛事有 1 处小项 / 组别的名字里带 @（或全角 ＠）……请先改名，再重新下载模板',
+          },
+        },
+        409,
+      ),
+  })
+
+  await assert.rejects(
+    () => client.entries.downloadTemplate('zh'),
+    (error: unknown) => {
+      assert.ok(error instanceof ApiError)
+      assert.equal(error.status, 409)
+      assert.match(error.message, /带 @/)
+      assert.match(error.message, /改名/)
+      return true
+    },
+  )
+})
+
+test('服务端不可达时不产出假模板：回一句「连上服务端再试」，并切到示例数据模式', async () => {
+  mockMode.value = false
+  mockReason.value = null
+  baseDataFallback.value = false
+  calls = []
+  reply = () => {
+    throw new TypeError('fetch failed')
+  }
+
+  await assert.rejects(
+    () => baseDataApi.entries.downloadTemplate('zh'),
+    (error: unknown) => {
+      assert.ok(error instanceof Error)
+      assert.equal(error.message, TEMPLATE_SHEET_MOCK_HINT)
+      assert.match(error.message, /示例数据/)
+      assert.match(error.message, /服务端/)
+      return true
+    },
+  )
+  assert.equal(baseDataFallback.value, true, '连不上时应切到示例数据模式')
+
+  mockMode.value = false
+  mockReason.value = null
+  baseDataFallback.value = false
+})
+
+test('服务端接口尚未实现（404）时同样不产出假模板，提示与上面同一句', async () => {
+  mockMode.value = false
+  baseDataFallback.value = false
+  reply = () => jsonResponse({ ok: false, error: { code: 'NOT_FOUND', message: '接口不存在' } }, 404)
+
+  await assert.rejects(
+    () => baseDataApi.entries.downloadTemplate('en'),
+    (error: unknown) => {
+      assert.ok(error instanceof Error)
+      assert.equal(error.message, TEMPLATE_SHEET_MOCK_HINT)
+      return true
+    },
+  )
+  assert.equal(baseDataFallback.value, true, '接口未实现时页面应切到示例数据模式')
+
+  baseDataFallback.value = false
+})