Files
Scoreboard/server/internal/export/event.go
T
AskaEth 631c8dd8e1 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

188 lines
5.8 KiB
Go

package export
import (
"database/sql"
"io"
"strings"
"github.com/xuri/excelize/v2"
)
// EventResultRow 是分项成绩表的一行。
// Rank 用字符串是为了承载「1(并列)」这种展示值。
type EventResultRow struct {
Rank string
Bib string
TeamName string
Participant string
ResultText string
Unit string
Points float64
Status string
Remark string
// Unpublished 表示这行有草稿成绩但还没发布:成绩值不写出来,
// 名次与积分对未发布成绩没有意义,一并换成占位符,见 eventRows。
Unpublished bool
// NoResult 表示这行连成绩行都还没有(还没录):三个成绩格子一律占位符。
// 与 Unpublished 互斥——有成绩行才会有发布状态。
NoResult bool
}
// EventSheet 是一个小项的一个组别(无组别时 Category 为空)对应的一张表。
type EventSheet struct {
SportName string
EventName string
Category string
Rows []EventResultRow
}
// EventsWorkbook 是「分项成绩表」的内容:一个小项可含多个组别 sheet,
// 也可承载全部小项(ExportAllXLSX 用)。
type EventsWorkbook struct {
Meta Meta
Sheets []EventSheet
}
// eventColumns 的列宽按「最长实际内容」预留:名次并列时写成「3(并列)」,
// 列宽 8 且这一类列不折行,右边又紧挨非空的「号码」,在 Excel 里会被硬裁;取 11 才能连
// 「10(并列)」这种两位数并列一起放下。运动员/队 是接力队名单(「王磊、赵雷、陈刚2、郑凯」
// 约 23 个显示宽度),18 会折成两行,24 够放 4~6 人名单。加宽只影响 fitToWidth=1 的打印
// 缩放比例(整表总宽 105→114,A4 横向仍是一页),不会把表推到第二页;再宽就得重新权衡。
var eventColumns = []column{
{"名次", 11, kindCenter},
{"号码", 9, kindCenter},
{"单位", 22, kindText},
{"运动员/队", 24, kindText},
{"成绩", 12, kindCenter},
{"积分", 8, kindNumber},
{"状态", 8, kindCenter},
{"备注", 20, kindText},
}
// ExportEventXLSX 导出单个小项的成绩表;eventID 为 0 时导出全部小项。
func ExportEventXLSX(db *sql.DB, eventID int64, dst string, opts Options) error {
wb, err := LoadEventWorkbook(db, eventID, opts)
if err != nil {
return err
}
f, err := eventFile(wb)
if err != nil {
return err
}
return saveWorkbook(f, dst)
}
// WriteEventXLSX 把分项成绩表写成 xlsx 流。
func WriteEventXLSX(w io.Writer, wb EventsWorkbook) error {
f, err := eventFile(wb)
if err != nil {
return err
}
return f.Write(w)
}
func eventFile(wb EventsWorkbook) (*excelize.File, error) {
return buildWorkbook("成绩表", func(f *excelize.File, st *styleSet) error {
return writeEventSheets(f, st, wb.Meta, wb.Sheets, &sheetNamer{})
})
}
func writeEventSheets(f *excelize.File, st *styleSet, meta Meta, sheets []EventSheet, namer *sheetNamer) error {
meta = meta.normalized()
for _, sh := range sheets {
name := namer.add(eventSheetBase(sh))
if err := addSheet(f, name); err != nil {
return err
}
if err := writeSheet(f, st, name, meta, eventSheetTitle(meta, sh), eventColumns, eventRows(sh.Rows)); err != nil {
return err
}
}
return nil
}
// eventSheetBase 是工作表名:大项·小项·组别,够短且能区分。
func eventSheetBase(sh EventSheet) string {
parts := make([]string, 0, 3)
if sh.SportName != "" {
parts = append(parts, sh.SportName)
}
parts = append(parts, sh.EventName)
if sh.Category != "" {
parts = append(parts, sh.Category)
}
return strings.Join(parts, "·")
}
// eventSheetTitle 是表内大标题,带赛事名。
func eventSheetTitle(meta Meta, sh EventSheet) string {
base := eventSheetBase(sh)
if base == "" {
base = "成绩表"
}
return sheetTitle(meta, base)
}
// eventCellBlank 是「这一格还没有数值」的占位符。留着空格子会让整行读起来像缺数据,
// 占位符才读得出「这是一条完整记录,只是还没发布 / 还没录」。
const eventCellBlank = "—"
// eventCellUnpublished 是未发布成绩行的成绩列文案(用户指定的字面文案)。
const eventCellUnpublished = "分数未录入"
// eventRows 把行铺成单元格。单页版与多 sheet 版都走这里,两种切法逐格一致。
//
// 还没数值的格子统一写占位符:名次、成绩、积分在未发布 / 未录入时都没有可比的值,
// 半空半 0 反而像填错。已发布行原样写出(未发布与未录入这两种行都不带 r.Points 的 0)。
func eventRows(rows []EventResultRow) [][]any {
out := make([][]any, 0, len(rows))
for _, r := range rows {
var (
rank any = r.Rank
result any = displayResult(r.ResultText, r.Unit)
points any = r.Points
)
switch {
case r.NoResult:
// 连成绩行都没有:三格都没值,状态列才是「未录入」。
rank, result, points = eventCellBlank, eventCellBlank, eventCellBlank
case r.Unpublished:
// 有草稿没发布:成绩值不对外,名次与积分对未发布成绩也没有意义。
rank, result, points = eventCellBlank, eventCellUnpublished, eventCellBlank
}
out = append(out, []any{
rank, r.Bib, r.TeamName, r.Participant,
result, points, r.Status, r.Remark,
})
}
return out
}
// displayResult 把成绩与单位拼成「11.58 秒」;单位已含在文本里时不重复拼接。
func displayResult(text, unit string) string {
text = strings.TrimSpace(text)
unit = strings.TrimSpace(unit)
if text == "" {
return ""
}
if unit == "" || strings.HasSuffix(text, unit) {
return text
}
return text + " " + unitLabel(unit)
}
func unitLabel(unit string) string {
switch unit {
case "s":
return "秒"
case "m":
return "米"
case "pts":
return "分"
case "次":
return "次"
default:
return unit
}
}