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/ 五份(使用手册 / 报名名单导入规范 / 升级说明 / 部署指南 / 上线检查清单)同步。
This commit is contained in:
AskaEth committed 2026-09-14 01:10:16 +08:00
1 parent b74768b7d5
commit 1b8a37ff8c
32 files changed
+3302 -233

No files matched your search

+17 -3
View File
@@ -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\)/)
})