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,594 @@
|
||||
package httpapi
|
||||
|
||||
import (
|
||||
"context"
|
||||
"errors"
|
||||
"fmt"
|
||||
"io"
|
||||
"net/http"
|
||||
"strings"
|
||||
|
||||
"github.com/xuri/excelize/v2"
|
||||
)
|
||||
|
||||
// 分工作表报名模板：**一张工作表 = 一个小项 × 一个组别**，表名即「小项名称@组别名称」。
|
||||
//
|
||||
// 现场把 40 个小项 × 2 个组别塞进同一张表时，填表人得自己在「项目编码 / 组别」两列里反复抄，
|
||||
// 抄错一个字这一行就报「小项 XXX 不存在」。拆成一张表一个组合后，范围由**表名**承担，
|
||||
// 数据区只剩「谁、哪个单位」这些真正要人填的东西。
|
||||
//
|
||||
// 命名与识别是**同一份实现**，生成端（下载模板）与解析端（导入报名表）都走 newEntrySheetPlan：
|
||||
// 双方各自把当前赛事的 (小项, 组别) 组合算成「工作表名 → 范围」的映射，导入时按表名查这张映射表。
|
||||
// 好处是解析永远是**精确命中**——没有前缀匹配、没有猜名字的启发式：改过名的小项或组别会让旧模板
|
||||
// 对不上号，这时宁可报错让现场重新下载，也不能把两张表的数据并到一起。
|
||||
//
|
||||
// 表名必须落进 Excel 的限制里（最长 31 个 UTF-16 单元、禁用 : \ / ? * [ ]、同簿内不能重名），
|
||||
// 所以下面每一处截断与去重都必须是确定性的：同一份基础数据算出来的表名，任何时候都完全一样。
|
||||
|
||||
const (
|
||||
// entrySheetMaxUnits 是 Excel 对工作表名的硬限制（UTF-16 编码单元数，汉字算 1 个）。
|
||||
entrySheetMaxUnits = 31
|
||||
// entrySheetMinPartUnits 是截断时一侧至少保留的字符数：再短就认不出是哪一项了。
|
||||
entrySheetMinPartUnits = 8
|
||||
// entrySheetSeparator 是小项与组别的分隔符。小项名与组别名里都不准出现它。
|
||||
entrySheetSeparator = "@"
|
||||
// entrySheetSuffixLimit 是撞名去重后缀的编号上限，纯粹是防死循环的兜底。
|
||||
entrySheetSuffixLimit = 9999
|
||||
)
|
||||
|
||||
// atSignNameMessage 是「名字里含 @」的统一理由文案。
|
||||
//
|
||||
// 三处拦截（基础数据界面、规则包 YAML、服务端接口）说的必须是同一件事：@ 是分工作表模板里
|
||||
// 小项与组别的分隔符，写进名字会让「小项@组别」拆不开。只回一句「不能含 @」现场只会换个位置再撞。
|
||||
func atSignNameMessage(kind, name string) string {
|
||||
return fmt.Sprintf("%s「%s」里不能有 @（也不能有全角 ＠）：%s 是分工作表报名模板里「小项名称%s组别名称」的分隔符，"+
|
||||
"写进名字会让工作表名拆不开、模板生成不出来。请换成别的字符（例如 - 或 ·）", kind, name,
|
||||
entrySheetSeparator, entrySheetSeparator)
|
||||
}
|
||||
|
||||
// nameSeparatorProblem 返回名字里的 @ 问题说明；没问题时返回空串。
|
||||
//
|
||||
// 返回字符串而不是 error，是为了让两条调用路径共用同一份判据：接口层要 badRequest（打回请求），
|
||||
// 基础数据包导入要行级报错（其余行照常导入）。校验层写两遍是历史伤疤的来源——
|
||||
// 只改一处就会出现「界面上拦住了、导 Excel 却能塞进去」。
|
||||
func nameSeparatorProblem(kind, name string) string {
|
||||
// 全角 ＠ 与半角 @ 在表名里肉眼几乎分不出，一并拦下：现场没有正当理由用它。
|
||||
idx := strings.IndexAny(name, "@＠")
|
||||
if idx < 0 {
|
||||
return ""
|
||||
}
|
||||
return atSignNameMessage(kind, name)
|
||||
}
|
||||
|
||||
// checkNameSeparator 是接口层的 @ 校验：小项名、组别名都走它。
|
||||
func checkNameSeparator(kind, name string) error {
|
||||
if msg := nameSeparatorProblem(kind, name); msg != "" {
|
||||
return badRequest(msg, nil)
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// entrySheetScope 是一个 (小项, 组别) 组合，即生成端要建的一张工作表。
|
||||
type entrySheetScope struct {
|
||||
EventID int64 `json:"eventId"`
|
||||
EventCode string `json:"eventCode"`
|
||||
EventName string `json:"eventName"`
|
||||
CategoryID int64 `json:"categoryId"`
|
||||
CategoryName string `json:"categoryName"`
|
||||
}
|
||||
|
||||
// entrySheetPlanned 是一张待生成的工作表：名字 + 它代表的范围。
|
||||
type entrySheetPlanned struct {
|
||||
Name string
|
||||
Scope entrySheetScope
|
||||
}
|
||||
|
||||
// entrySheetPlan 是「工作表名 → 范围」的确定性映射，下载与导入共用。
|
||||
type entrySheetPlan struct {
|
||||
sheets []entrySheetPlanned
|
||||
// byKey 的键是 entrySheetKey(工作表名)，值是它代表的范围。
|
||||
byKey map[string]entrySheetScope
|
||||
// eventByKey 是「小项名归一化键 → 该小项的组别组合」，只在表名对不上时给现场一句能照着改的诊断。
|
||||
eventByKey map[string][]entrySheetScope
|
||||
// excluded 是名字里含 @（或全角 ＠）而**没法**写进工作表名的小项 / 组别。
|
||||
// 生成端据此拒绝下载并点名让人先改名；解析端不把它们放进映射（这些组合本来就表达不出来）。
|
||||
excluded []string
|
||||
}
|
||||
|
||||
// loadEntrySheetScopes 读出当前赛事的全部 (小项, 组别) 组合。
|
||||
//
|
||||
// 排序即工作表的先后与撞名去重的先后，必须是确定的：现场从上到下就是基础数据里的顺序
|
||||
// （小项按排序值 + 编码，组别按排序值 + id）；换个顺序会让「(2)」后缀落到另一张表上，
|
||||
// 解析端也就跟着错位。
|
||||
func (s *server) loadEntrySheetScopes(ctx context.Context) ([]entrySheetScope, error) {
|
||||
rows, err := s.ev.QueryContext(ctx,
|
||||
`SELECT e.id, COALESCE(e.code, ''), e.name, c.id, c.name
|
||||
FROM events e
|
||||
JOIN event_categories c ON c.event_id = e.id
|
||||
ORDER BY e.sort_order, e.code, c.sort_order, c.id`)
|
||||
if err != nil {
|
||||
return nil, internal(err)
|
||||
}
|
||||
defer func() { _ = rows.Close() }()
|
||||
|
||||
out := make([]entrySheetScope, 0, 16)
|
||||
for rows.Next() {
|
||||
var scope entrySheetScope
|
||||
if err := rows.Scan(&scope.EventID, &scope.EventCode, &scope.EventName,
|
||||
&scope.CategoryID, &scope.CategoryName); err != nil {
|
||||
return nil, internal(err)
|
||||
}
|
||||
out = append(out, scope)
|
||||
}
|
||||
if err := rows.Err(); err != nil {
|
||||
return nil, internal(err)
|
||||
}
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// newEntrySheetPlan 给每个组合定一个工作表名。scopes 必须按确定顺序传入（见 loadEntrySheetScopes）。
|
||||
//
|
||||
// 撞名去重：Excel 一个工作簿里不允许两张同名工作表，重名的后果是**后一张把前一张覆盖掉**，
|
||||
// 数据无声消失。所以名字重复时在尾部追加 (2)、(3)…，并把名字再截短以塞进 31 字符；
|
||||
// 去重比的是归一化后的键（entrySheetKey），半角 / 全角、空格、大小写不同不算两张表的区别。
|
||||
func newEntrySheetPlan(scopes []entrySheetScope) entrySheetPlan {
|
||||
plan := entrySheetPlan{
|
||||
sheets: make([]entrySheetPlanned, 0, len(scopes)),
|
||||
byKey: make(map[string]entrySheetScope, len(scopes)),
|
||||
eventByKey: make(map[string][]entrySheetScope, len(scopes)),
|
||||
}
|
||||
used := make(map[string]bool, len(scopes))
|
||||
seenPair := make(map[[2]int64]bool, len(scopes))
|
||||
|
||||
for _, scope := range scopes {
|
||||
// 同一对小项 + 组别只出一张表：重复的组合只会多一张内容一样的表，还会挤掉别人的名字。
|
||||
pair := [2]int64{scope.EventID, scope.CategoryID}
|
||||
if seenPair[pair] {
|
||||
continue
|
||||
}
|
||||
seenPair[pair] = true
|
||||
|
||||
if problem := nameSeparatorProblem("小项名称", scope.EventName); problem != "" {
|
||||
plan.excluded = append(plan.excluded, problem)
|
||||
continue
|
||||
}
|
||||
if problem := nameSeparatorProblem("组别名称", scope.CategoryName); problem != "" {
|
||||
plan.excluded = append(plan.excluded, problem)
|
||||
continue
|
||||
}
|
||||
|
||||
name := entrySheetName(scope.EventName, scope.CategoryName)
|
||||
key := entrySheetKey(name)
|
||||
for n := 2; used[key] && n <= entrySheetSuffixLimit; n++ {
|
||||
// 加后缀会让名字变长，先把尾部截掉凑出空间：后缀甩到 31 字符外，Excel 直接拒绝建表。
|
||||
suffix := fmt.Sprintf("(%d)", n)
|
||||
name = headWithinUnits(name, entrySheetMaxUnits-unitsOf(suffix)) + suffix
|
||||
key = entrySheetKey(name)
|
||||
}
|
||||
used[key] = true
|
||||
|
||||
plan.sheets = append(plan.sheets, entrySheetPlanned{Name: name, Scope: scope})
|
||||
plan.byKey[key] = scope
|
||||
eventKey := entrySheetKey(scope.EventName)
|
||||
plan.eventByKey[eventKey] = append(plan.eventByKey[eventKey], scope)
|
||||
}
|
||||
return plan
|
||||
}
|
||||
|
||||
// entrySheetName 拼一张工作表的名字：<小项名称>@<组别名称>。
|
||||
//
|
||||
// 截断策略（确定性，两侧都从**尾部**截，保留开头——人一眼能认出是哪一项）：
|
||||
// 1. 小项名优先保留，但至少给组别名留下 8 个字符（组别名太短就分不出是哪一组）；
|
||||
// 2. 小项名先截到自己那份额度，剩下的全给组别名；
|
||||
// 3. 预算按 UTF-16 单元算（汉字 1、emoji 2），与 Excel 的计数口径一致。
|
||||
//
|
||||
// 截断后名字仍是原名的一段前缀——这是解析端「重新算一遍映射」能对上的前提。
|
||||
func entrySheetName(eventName, categoryName string) string {
|
||||
ev := entrySheetPart(eventName)
|
||||
if ev == "" {
|
||||
ev = "未命名小项"
|
||||
}
|
||||
cat := entrySheetPart(categoryName)
|
||||
if cat == "" {
|
||||
cat = "未命名组别"
|
||||
}
|
||||
|
||||
budget := entrySheetMaxUnits - unitsOf(entrySheetSeparator)
|
||||
// 给组别名留的额度不超过它自己的长度：组别名本来就短时，没必要白白砍掉小项名的字。
|
||||
reserve := entrySheetMinPartUnits
|
||||
if catUnits := unitsOf(cat); catUnits < reserve {
|
||||
reserve = catUnits
|
||||
}
|
||||
evKeep := unitsOf(ev)
|
||||
if room := budget - reserve; evKeep > room {
|
||||
evKeep = room
|
||||
}
|
||||
if evKeep < 1 {
|
||||
evKeep = 1
|
||||
}
|
||||
|
||||
ev = headWithinUnits(ev, evKeep)
|
||||
cat = headWithinUnits(cat, budget-unitsOf(ev))
|
||||
return ev + entrySheetSeparator + cat
|
||||
}
|
||||
|
||||
// entrySheetPart 归一化名字的一侧：去首尾空白，Excel 禁用字符换成同形全角字符。
|
||||
//
|
||||
// 换字符而不是删字符：删掉会改变名字的长相（「100 米/200 米」变成「100 米200 米」），
|
||||
// 现场对着表名找小项就找不到了；换成本表用的全角写法（与 export.sanitizeSheetName 同一张表），
|
||||
// 肉眼看上去还是原来那个名字。
|
||||
func entrySheetPart(raw string) string {
|
||||
name := strings.TrimSpace(raw)
|
||||
return strings.NewReplacer(
|
||||
"[", "（", "]", "）", ":", "：", "*", "＊",
|
||||
"?", "？", "/", "／", "\\", "＼",
|
||||
).Replace(name)
|
||||
}
|
||||
|
||||
// entrySheetKey 把工作表名归一化成可比对的键：全角 ASCII 转半角、丢掉 BOM、去掉全部空白、转小写。
|
||||
//
|
||||
// 生成端与解析端都要过它，两边算出来的键必然一致；现场手写的表名只要「字对得上」也能命中
|
||||
// （多打一个空格、输入法打成了全角字母都不算错）。
|
||||
func entrySheetKey(raw string) string {
|
||||
var builder strings.Builder
|
||||
builder.Grow(len(raw))
|
||||
for _, r := range raw {
|
||||
switch {
|
||||
case r == '\uFEFF':
|
||||
// BOM 粘在表名上是「表名对不上」的经典成因，直接丢掉。
|
||||
case r == '\u3000':
|
||||
// 全角空格与半角空格一样，比较时都忽略。
|
||||
case r >= '\uFF01' && r <= '\uFF5E':
|
||||
builder.WriteRune(r - 0xFEE0)
|
||||
case r == ' ' || r == '\t' || r == '\n' || r == '\r':
|
||||
default:
|
||||
builder.WriteRune(r)
|
||||
}
|
||||
}
|
||||
return strings.ToLower(builder.String())
|
||||
}
|
||||
|
||||
// unitsOf 按 Excel 的口径数长度：UTF-16 编码单元数（汉字 1、emoji 2）。
|
||||
func unitsOf(raw string) int {
|
||||
units := 0
|
||||
for _, r := range raw {
|
||||
if r > 0xFFFF {
|
||||
units += 2
|
||||
continue
|
||||
}
|
||||
units++
|
||||
}
|
||||
return units
|
||||
}
|
||||
|
||||
// headWithinUnits 取前若干编码单元，且不切开代理对（emoji 只会整只丢）。
|
||||
func headWithinUnits(raw string, budget int) string {
|
||||
if budget <= 0 {
|
||||
return ""
|
||||
}
|
||||
var out []rune
|
||||
used := 0
|
||||
for _, r := range raw {
|
||||
size := 1
|
||||
if r > 0xFFFF {
|
||||
size = 2
|
||||
}
|
||||
if used+size > budget {
|
||||
break
|
||||
}
|
||||
used += size
|
||||
out = append(out, r)
|
||||
}
|
||||
if out == nil {
|
||||
return ""
|
||||
}
|
||||
return string(out)
|
||||
}
|
||||
|
||||
// ---------- 导入：把上传的工作表定成待导入的表 ----------
|
||||
|
||||
// sameImportScopeName 比较表里的组别名与工作表名里的组别名：大小写、全角、首尾空白不算差异
|
||||
// （与表头识别同一把尺子），差一个字就是不一致。
|
||||
func sameImportScopeName(cell, scoped string) bool {
|
||||
return normalizeImportHeader(cell) == normalizeImportHeader(scoped)
|
||||
}
|
||||
|
||||
// withSheetPrefix 给工作表级的报错加上表名。单表口径的表名为空串，原样返回——老文案一字不改。
|
||||
//
|
||||
// 复制一份 apiError 而不是重建：status / code / detail / 拦截点都要保住，
|
||||
// 尤其是 origin——重建会让拦截日志指到本函数，现场拿着它找不到真正的校验代码。
|
||||
func withSheetPrefix(sheet string, err error) error {
|
||||
if sheet == "" {
|
||||
return err
|
||||
}
|
||||
var api *apiError
|
||||
if !errors.As(err, &api) {
|
||||
return err
|
||||
}
|
||||
clone := *api
|
||||
clone.message = fmt.Sprintf("[工作表 %s] %s", sheet, api.message)
|
||||
return &clone
|
||||
}
|
||||
|
||||
// prepareImportTables 把上传的工作表定成「待导入的表」：分工作表口径下每张表都要能从工作表名
|
||||
// 定出 (小项, 组别)。
|
||||
//
|
||||
// 口径判定只看一件事：**有没有哪张工作表的名字里带 @**。
|
||||
// - 有 → 分工作表口径：每张表都必须能定出范围，定不出来的整份拒绝；
|
||||
// - 没有 → 单表口径：只导第一张可见表，其余工作表给一条提示（与升级前的行为一致，
|
||||
// 那时 xlsx 只读第一张，只是没说出口）。
|
||||
//
|
||||
// 为什么不「定不出来就跳过那张表」：跳过意味着用户填在第 3 张表里的几十行数据无声消失，
|
||||
// 而结果面板上的「新增 / 更新」看着还是成功的。宁可整份拒绝，让人当场知道要改哪张表。
|
||||
func (s *server) prepareImportTables(ctx context.Context, sheets []importSheet) ([]importTable, []string, error) {
|
||||
notices := make([]string, 0, 2)
|
||||
visible := make([]importSheet, 0, len(sheets))
|
||||
for _, sheet := range sheets {
|
||||
if sheet.hidden {
|
||||
notices = append(notices, fmt.Sprintf("工作表「%s」是隐藏表，按约定不参与导入", sheet.name))
|
||||
continue
|
||||
}
|
||||
visible = append(visible, sheet)
|
||||
}
|
||||
if len(visible) == 0 {
|
||||
return nil, notices, badRequest("报名表里没有可导入的工作表", nil)
|
||||
}
|
||||
if !hasEntrySheetName(visible) {
|
||||
// 单表口径：整份文件就是第一张表，范围由表内的「项目编码 / 组别」两列决定，
|
||||
// 解析结果与升级前完全一样。
|
||||
if len(visible) > 1 {
|
||||
ignored := make([]string, 0, len(visible)-1)
|
||||
for _, sheet := range visible[1:] {
|
||||
ignored = append(ignored, sheet.name)
|
||||
}
|
||||
notices = append(notices, fmt.Sprintf(
|
||||
"本工作簿有 %d 张工作表，按单表模板只导入了第一张「%s」，其余（%s）没有读。"+
|
||||
"如果这是一份「一个小项组别一张表」的模板，工作表名要写成「小项名称%s组别名称」（例如「100 米跑%s男子组」），"+
|
||||
"否则请把要导入的那张表放到第一张、或单独存成一个文件",
|
||||
len(visible), visible[0].name, strings.Join(ignored, "、"),
|
||||
entrySheetSeparator, entrySheetSeparator))
|
||||
}
|
||||
if len(visible[0].rows) < 2 {
|
||||
return nil, notices, badRequest("报名表为空", nil)
|
||||
}
|
||||
return []importTable{{rows: visible[0].rows}}, notices, nil
|
||||
}
|
||||
|
||||
scopes, err := s.loadEntrySheetScopes(ctx)
|
||||
if err != nil {
|
||||
return nil, notices, err
|
||||
}
|
||||
plan := newEntrySheetPlan(scopes)
|
||||
if len(plan.byKey) == 0 {
|
||||
return nil, notices, badRequest("这份表看起来是「分工作表模板」（有工作表名里带 "+entrySheetSeparator+"），"+
|
||||
"但当前赛事还没有任何「小项 + 组别」组合，没法把工作表名对回小项与组别。"+
|
||||
"请先到「基础数据 → 大项 / 小项」「组别」把基础数据配好再导入；"+
|
||||
"如果数据本来就都在一张表里，请改用单表模板（表内要有「项目编码」与「组别」两列）", nil)
|
||||
}
|
||||
|
||||
tables := make([]importTable, 0, len(visible))
|
||||
for _, sheet := range visible {
|
||||
scope, ok := plan.byKey[entrySheetKey(sheet.name)]
|
||||
if !ok {
|
||||
return nil, notices, badRequest(entrySheetMismatchMessage(sheet.name, plan), nil)
|
||||
}
|
||||
if len(sheet.rows) < 2 {
|
||||
// 只有表头（或者整张表是空的）= 这个小项组别这次没人报名：不报错，但要说一句。
|
||||
notices = append(notices, fmt.Sprintf("工作表「%s」没有数据行，已跳过", sheet.name))
|
||||
continue
|
||||
}
|
||||
tables = append(tables, importTable{sheet: sheet.name, rows: sheet.rows, scope: &scope})
|
||||
}
|
||||
if len(tables) == 0 {
|
||||
return nil, notices, badRequest("报名表为空：几张工作表都只有表头，没有要导入的数据行", nil)
|
||||
}
|
||||
return tables, notices, nil
|
||||
}
|
||||
|
||||
// hasEntrySheetName 判断这份上传是不是「分工作表模板」：只要有一张工作表名里带分隔符就算。
|
||||
func hasEntrySheetName(sheets []importSheet) bool {
|
||||
for _, sheet := range sheets {
|
||||
if strings.Contains(sheet.name, entrySheetSeparator) {
|
||||
return true
|
||||
}
|
||||
}
|
||||
return false
|
||||
}
|
||||
|
||||
// entrySheetMismatchMessage 是「工作表名对不上任何小项 + 组别」时的报错。
|
||||
//
|
||||
// 必须说清三件事：哪个表名、为什么对不上、怎么改。现场手上只有 Excel，只说「工作表名非法」
|
||||
// 等于让他猜——这个名字是自己手写的、还是被 Excel 改过、还是模板从别的赛事下载的，
|
||||
// 三种情况的改法完全不同。
|
||||
func entrySheetMismatchMessage(name string, plan entrySheetPlan) string {
|
||||
head := fmt.Sprintf("工作表「%s」没能定出是哪个小项、哪个组别：", name)
|
||||
if !strings.Contains(name, entrySheetSeparator) {
|
||||
return head + "工作表名里没有 " + entrySheetSeparator +
|
||||
"。分工作表模板的表名必须是「小项名称" + entrySheetSeparator + "组别名称」（例如「100 米跑" +
|
||||
entrySheetSeparator + "男子组」）。本工作簿里已经有一张表名带 " + entrySheetSeparator +
|
||||
" 了，整份文件按分工作表模板处理，每张表都要能定出小项与组别：" +
|
||||
"请把这张表删掉，或把它改名成「小项名称" + entrySheetSeparator + "组别名称」"
|
||||
}
|
||||
left, right, _ := strings.Cut(name, entrySheetSeparator)
|
||||
if _, ok := plan.eventByKey[entrySheetKey(left)]; !ok {
|
||||
return head + fmt.Sprintf("当前赛事里没有小项「%s」。请核对名字是否一字不差——"+
|
||||
"小项或组别改过名、名字太长被截断、模板不是从本赛事下载的，都会对不上；最稳的做法是重新下载分工作表模板", left)
|
||||
}
|
||||
return head + fmt.Sprintf("小项「%s」下没有组别「%s」。请核对组别名称，或重新下载分工作表模板", left, right)
|
||||
}
|
||||
|
||||
// entryTemplateHeader 是模板的表头：en 用英文规范名，zh 用中文首选别名。
|
||||
//
|
||||
// 与 download 的两个按钮、与 importColumns 逐列对应，也和单表 CSV 模板共用同一份列顺序——
|
||||
// 现场换模板不用重新数格子。改 importColumns 必须同步改这里（本函数就是从它算出来的）。
|
||||
func entryTemplateHeader(language string) []string {
|
||||
out := make([]string, 0, len(importColumns))
|
||||
for _, column := range importColumns {
|
||||
if language == "en" || len(column.aliases) == 0 {
|
||||
out = append(out, column.name)
|
||||
continue
|
||||
}
|
||||
out = append(out, column.aliases[0])
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
// entryTemplateFilename 是两种表头语言的下载文件名，前端按同一份口径拼文件名。
|
||||
func entryTemplateFilename(language string) string {
|
||||
if language == "en" {
|
||||
return "报名模板（分工作表·英文表头）.xlsx"
|
||||
}
|
||||
return "报名模板（分工作表·中文表头）.xlsx"
|
||||
}
|
||||
|
||||
// 模板里每列的展示宽度；没列的按 defaultEntryTemplateWidth 走。
|
||||
var entryTemplateWidths = map[string]float64{
|
||||
"event_code": 14,
|
||||
"category": 18,
|
||||
"team_code": 14,
|
||||
"athlete_name": 12,
|
||||
"id_card": 22,
|
||||
"gender": 8,
|
||||
"age": 8,
|
||||
"bib": 10,
|
||||
"seed": 12,
|
||||
"heat": 8,
|
||||
"status": 12,
|
||||
"member_names": 26,
|
||||
}
|
||||
|
||||
const defaultEntryTemplateWidth = 14
|
||||
|
||||
// entriesTemplateXLSX 生成「按小项 × 组别分工作表」的报名模板（GET /api/entries/template.xlsx?lang=zh|en）。
|
||||
//
|
||||
// 表头语言由 lang 决定（zh 缺省），与单表 CSV 模板的两个下载按钮是同一套口径：中文 / 英文各一份，
|
||||
// 列数与列顺序完全一样，只有表头语言不同。
|
||||
func (s *server) entriesTemplateXLSX(w http.ResponseWriter, r *http.Request) (any, error) {
|
||||
language := strings.ToLower(strings.TrimSpace(r.URL.Query().Get("lang")))
|
||||
if language == "" {
|
||||
language = "zh"
|
||||
}
|
||||
if language != "zh" && language != "en" {
|
||||
return nil, badRequest("lang 只能是 zh 或 en（缺省 zh）", language)
|
||||
}
|
||||
|
||||
scopes, err := s.loadEntrySheetScopes(r.Context())
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
plan := newEntrySheetPlan(scopes)
|
||||
// 名字里带 @ 的历史数据没法写进工作表名：整次拒绝并点名，让人先改名。
|
||||
// 静默跳过会让现场拿到一份「少了几张表」的模板而毫不知情——那比报错危险得多。
|
||||
if len(plan.excluded) > 0 {
|
||||
return nil, conflict(entrySheetExcludedMessage(plan.excluded))
|
||||
}
|
||||
if len(plan.sheets) == 0 {
|
||||
return nil, badRequest("当前赛事还没有「小项 + 组别」的组合，分工作表模板没有可生成的表。"+
|
||||
"请先到「基础数据 → 大项 / 小项」建好小项，再到「组别」里给它配上组别", nil)
|
||||
}
|
||||
|
||||
headers := entryTemplateHeader(language)
|
||||
sheets := make([]entriesTemplateSheet, 0, len(plan.sheets))
|
||||
for _, planned := range plan.sheets {
|
||||
sheets = append(sheets, entriesTemplateSheet{Name: planned.Name, Headers: headers})
|
||||
}
|
||||
name := entryTemplateFilename(language)
|
||||
ascii := "entries-template-" + language + ".xlsx"
|
||||
return s.streamDownload(w, ascii, name, xlsxMIME, func(out io.Writer) error {
|
||||
return writeEntriesTemplateXLSX(out, sheets)
|
||||
})
|
||||
}
|
||||
|
||||
// entrySheetExcludedMessage 把「哪些名字挡住了模板生成」拼成能照着做的一句话。
|
||||
// 最多点 5 个名字，其余的报个数——几十个名字堆在提示里，现场反而看不到重点。
|
||||
func entrySheetExcludedMessage(problems []string) string {
|
||||
const show = 5
|
||||
head := problems
|
||||
tail := ""
|
||||
if len(head) > show {
|
||||
head = head[:show]
|
||||
tail = fmt.Sprintf("等 %d 处", len(problems))
|
||||
}
|
||||
return fmt.Sprintf("当前赛事有 %d 处小项 / 组别的名字里带 @（或全角 ＠），没法做成「小项名称@组别名称」的工作表名：%s%s。"+
|
||||
"请先到「基础数据 → 大项 / 小项」「组别」把它们改名（去掉 @），再重新下载模板；"+
|
||||
"改名不影响任何报名、成绩与积分", len(problems), strings.Join(head, "；"), tail)
|
||||
}
|
||||
|
||||
// entriesTemplateSheet 是一张待写的工作表。
|
||||
type entriesTemplateSheet struct {
|
||||
Name string
|
||||
Headers []string
|
||||
}
|
||||
|
||||
// writeEntriesTemplateXLSX 写整份模板工作簿。
|
||||
//
|
||||
// 版式与导出件刻意不同：**表头就在第 1 行**，没有标题行 / 副标题行。
|
||||
// 导入器认第 1 行为表头（见 importColumnIndex 与「表头上方不要加标题行」的现场约定），
|
||||
// 模板自己先摆两行标题，用户照着填回来的文件就会被判成「缺少列」。宁可朴素，也要能往返。
|
||||
func writeEntriesTemplateXLSX(out io.Writer, sheets []entriesTemplateSheet) error {
|
||||
f := excelize.NewFile()
|
||||
defer func() { _ = f.Close() }()
|
||||
|
||||
headerStyle, err := f.NewStyle(&excelize.Style{
|
||||
Font: &excelize.Font{Bold: true, Size: 11, Family: "微软雅黑", Color: "FFFFFF"},
|
||||
Fill: excelize.Fill{Type: "pattern", Pattern: 1, Color: []string{"3482FF"}},
|
||||
Alignment: &excelize.Alignment{Horizontal: "center", Vertical: "center", WrapText: true},
|
||||
})
|
||||
if err != nil {
|
||||
return fmt.Errorf("httpapi: 创建模板表头样式: %w", err)
|
||||
}
|
||||
|
||||
for i, sheet := range sheets {
|
||||
if i == 0 {
|
||||
if err := f.SetSheetName("Sheet1", sheet.Name); err != nil {
|
||||
return fmt.Errorf("httpapi: 重命名模板工作表 %s: %w", sheet.Name, err)
|
||||
}
|
||||
} else if _, err := f.NewSheet(sheet.Name); err != nil {
|
||||
return fmt.Errorf("httpapi: 新建模板工作表 %s: %w", sheet.Name, err)
|
||||
}
|
||||
for column, title := range sheet.Headers {
|
||||
cell, err := excelize.CoordinatesToCellName(column+1, 1)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if err := f.SetCellValue(sheet.Name, cell, title); err != nil {
|
||||
return err
|
||||
}
|
||||
name, err := excelize.ColumnNumberToName(column + 1)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
width := float64(defaultEntryTemplateWidth)
|
||||
if column < len(importColumns) {
|
||||
if custom, ok := entryTemplateWidths[importColumns[column].name]; ok {
|
||||
width = custom
|
||||
}
|
||||
}
|
||||
if err := f.SetColWidth(sheet.Name, name, name, width); err != nil {
|
||||
return err
|
||||
}
|
||||
}
|
||||
if len(sheet.Headers) > 0 {
|
||||
last, err := excelize.ColumnNumberToName(len(sheet.Headers))
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if err := f.SetCellStyle(sheet.Name, "A1", last+"1", headerStyle); err != nil {
|
||||
return err
|
||||
}
|
||||
}
|
||||
if err := f.SetRowHeight(sheet.Name, 1, 24); err != nil {
|
||||
return err
|
||||
}
|
||||
// 冻结表头：一张表几十行，往下翻的时候列名得一直看得见。
|
||||
if err := f.SetPanes(sheet.Name, &excelize.Panes{
|
||||
Freeze: true, YSplit: 1, TopLeftCell: "A2", ActivePane: "bottomLeft",
|
||||
}); err != nil {
|
||||
return err
|
||||
}
|
||||
}
|
||||
if err := f.Write(out); err != nil {
|
||||
return fmt.Errorf("httpapi: 写出模板: %w", err)
|
||||
}
|
||||
return nil
|
||||
}
|
||||
Reference in new issue
Block a user