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
1 parent
b74768b7d5
commit
1b8a37ff8c
32 files changed
+3302
-233
No files matched your search
@@ -0,0 +1,82 @@
|
||||
package rules
|
||||
|
||||
import (
|
||||
"errors"
|
||||
"strings"
|
||||
"testing"
|
||||
)
|
||||
|
||||
// 规则包里的小项名（eventOverrides[].name）不许含 @。
|
||||
//
|
||||
// @ 是分工作表报名模板里「小项名称@组别名称」的分隔符（见 httpapi/entries_sheet_template.go）。
|
||||
// 规则包会被现场复用到别的赛事，而这个名字正是表名的一半：带 @ 的名字复制过去，
|
||||
// 那个赛事的分工作表模板就生成不出来，现场只看得到一句与规则毫无关系的报错。
|
||||
//
|
||||
// 检查放在 ValidateForImport 而不是 Validate：导出的规则包（GET /api/rules/export、赛事项目包里的
|
||||
// rules.yaml）是现场备份与排障的入口，历史库里已经存在的名字必须照样能导出来。
|
||||
|
||||
// atSignPackYAML 是「小项名里带 @」的规则包；名字由用例替换。
|
||||
func atSignPackYAML(name string) string {
|
||||
return `format: scoreboard-rules
|
||||
formatVersion: 1
|
||||
meta: { code: demo, name: 带 @ 的小项名 }
|
||||
profiles:
|
||||
- code: p6
|
||||
name: 前六名
|
||||
awardRanks: 6
|
||||
tieMode: skip
|
||||
rules:
|
||||
- { rank: 1, points: 10 }
|
||||
- { rank: 2, points: 8 }
|
||||
channelTemplates:
|
||||
- match: { eventType: individual }
|
||||
channels:
|
||||
- { scope: athlete, basis: result, profile: p6 }
|
||||
eventOverrides:
|
||||
- eventCode: M100
|
||||
name: "` + name + `"
|
||||
`
|
||||
}
|
||||
|
||||
func TestParseRejectsAtSignInOverrideName(t *testing.T) {
|
||||
_, err := Parse([]byte(atSignPackYAML("100米@跑")))
|
||||
if !errors.Is(err, ErrValidation) {
|
||||
t.Fatalf("小项名含 @ 应报 ErrValidation，实际 %v", err)
|
||||
}
|
||||
var ve *ValidationError
|
||||
if !errors.As(err, &ve) {
|
||||
t.Fatalf("应返回 *ValidationError，实际 %T", err)
|
||||
}
|
||||
var found bool
|
||||
for _, is := range ve.Issues {
|
||||
if is.Path != "eventOverrides[0].name" {
|
||||
continue
|
||||
}
|
||||
found = true
|
||||
// 文案要说清三件事：哪个名字、@ 是什么、怎么办。
|
||||
for _, want := range []string{"100米@跑", "分隔符", "小项名称@组别名称", "改成"} {
|
||||
if !strings.Contains(is.Msg, want) {
|
||||
t.Fatalf("说明里缺少 %q：%s", want, is.Msg)
|
||||
}
|
||||
}
|
||||
}
|
||||
if !found {
|
||||
t.Fatalf("应把问题指到 eventOverrides[0].name，得到 %+v", ve.Issues)
|
||||
}
|
||||
}
|
||||
|
||||
// 全角 ＠ 与半角 @ 在表名里肉眼分不出，一并拦下。
|
||||
func TestParseRejectsFullWidthAtSignInOverrideName(t *testing.T) {
|
||||
if _, err := Parse([]byte(atSignPackYAML("100米＠跑"))); !errors.Is(err, ErrValidation) {
|
||||
t.Fatalf("全角 ＠ 也应被拦下，实际 %v", err)
|
||||
}
|
||||
}
|
||||
|
||||
// 没写 name（可选字段）与正常名字照样放行：不能因为这条新检查把规则包导入弄坏。
|
||||
func TestParseAcceptsOverrideWithoutAtSign(t *testing.T) {
|
||||
for _, name := range []string{"", "团体引体向上", "100米跑-决赛"} {
|
||||
if _, err := Parse([]byte(atSignPackYAML(name))); err != nil {
|
||||
t.Fatalf("小项名 %q 应照常导入，得到 %v", name, err)
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -101,9 +101,11 @@ func (p *RulePack) Validate() error {
|
||||
|
||||
// ValidateForImport 是导入侧在 Validate 之外额外拦下的「这份配置根本算不出分」检查。
|
||||
//
|
||||
// 目前只有一条：分值表的档位超出录取档位数（awardRanks）。见 AwardRanksOverflow。
|
||||
// 两条：分值表的档位超出录取档位数（awardRanks，见 AwardRanksOverflow），
|
||||
// 以及小项名里出现分工作表模板的分隔符 @（见 eventOverrides[].name）。
|
||||
// 单独成一个方法而不是塞进 Validate，是因为 Validate 同时被导出路径用着——历史库里已经存在的
|
||||
// 越档模板必须照样能导出（否则备份与规则导出会 500），但绝不能再从导入这条路进来。
|
||||
// 越档模板必须照样能导出（否则备份与规则导出会 500），但绝不能再从导入这条路进来；
|
||||
// 名字里带 @ 的历史规则包同理：还能导出、还能留在库里，但不许再导进来。
|
||||
func (p *RulePack) ValidateForImport() error {
|
||||
var l issueList
|
||||
for i, prof := range p.Profiles {
|
||||
@@ -118,12 +120,29 @@ func (p *RulePack) ValidateForImport() error {
|
||||
l.addf(fmt.Sprintf("profiles[%d].awardRanks", i), "%s", msg)
|
||||
}
|
||||
}
|
||||
// 规则包里的小项名（eventOverrides[].name）会随规则包一起被现场复用到别的赛事，
|
||||
// 而它正是「小项名称@组别名称」的一半：名字里带 @，那个赛事的分工作表模板就生成不出来。
|
||||
for i, ov := range p.EventOverrides {
|
||||
if strings.IndexAny(ov.Name, "@＠") < 0 {
|
||||
continue
|
||||
}
|
||||
l.addf(fmt.Sprintf("eventOverrides[%d].name", i), "%s", ruleNameSeparatorMessage(ov.Name))
|
||||
}
|
||||
if len(l.issues) > 0 {
|
||||
return &ValidationError{Issues: l.issues}
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// ruleNameSeparatorMessage 与 httpapi 的 atSignNameMessage 是同一件事的同一句话
|
||||
// （规则包属于 rules 包、接口层属于 httpapi 包，两边不互相 import，只能各写一份）。
|
||||
// 改这里必须同步改 server/internal/httpapi/entries_sheet_template.go 的那份。
|
||||
func ruleNameSeparatorMessage(name string) string {
|
||||
return fmt.Sprintf("小项名称「%s」里不能有 @（也不能有全角 ＠）：@ 是分工作表报名模板里"+
|
||||
"「小项名称@组别名称」的分隔符，写进名字会让工作表名拆不开、模板生成不出来。"+
|
||||
"请把规则包里这个名字改成与现场一致、且不含 @ 的写法", name)
|
||||
}
|
||||
|
||||
func validateTieBreak(l *issueList, tieBreak []string) {
|
||||
seen := make(map[string]bool, len(tieBreak))
|
||||
for i, key := range tieBreak {
|
||||
|
||||
Reference in new issue
Block a user