## 大屏控制(用户:管理面板只能看到本机显示器,看不到局域网设备;也不能给某块屏单独切页) - 服务端:`POST /api/display/command` 新增可选 `targets []string` —— 空 = 广播(公告语义不变), 非空 = 只发给点名的实例并返回命中数;命中 0 个返回 404 +「目标大屏已离线,请刷新在线列表」 (不落审计、公告也不落库)。`DisplaySender` 签名随之扩展,新增 `Hub.SendCommandToInstances`(与按房间的 SendCommand 并存)。 - 服务端:WS `hello` 新增可选 `screen`,`realtime.Instance` 新增 `Screen`(不带 omitempty, 局域网浏览器恒为空串),这样管理端能把「本机显示器」与「在线实例」精确对上。 - 管理端「大屏控制」:写死的「在线看板」占位换成真实列表(5 秒轮询、页面隐藏停表), 列出实例 id / 在线离线 / 落后 / 屏号或「局域网浏览器」/ 当前页 / 来源 / 心跳; 每行可单独切页;本机显示器卡片补「当前页」与逐屏切页;离线时控件置灰并说明原因。 页面下拉改为共用大屏那份页名清单(管理端两处标签随之变为「个人积分奖牌榜」「分项成绩」)。 ## 导出(用户:保留多页工作簿的同时,再要一种全平铺单页;积分榜明细也要能导出) - 新增 `GET /api/export/all-flat.xlsx` → `赛事成绩总表(单页).xlsx`:一个工作簿一张表, 列 = 大项/小项/组别/名次/号码/单位/运动员-队/成绩/积分/状态/备注;前三列取 `EventSheet` 的结构化字段(不解析标题),后 8 列就是 `eventColumns` 本身(append 拼出, 两处不可能漂移)。**既有「全部」(all.xlsx,多 sheet)一字未动。** - 新增 `GET /api/export/teams.xlsx` → `单位积分总明细.xlsx`:一张带「单位」列的总表 + 每个有明细行的单位一张分表;**无明细行的单位不出分表**(空表没信息量,且会把假删除的 隐藏单位名字重新印进导出件);已隐藏但有流水的单位照常出表(它在榜单上)。 - 积分榜页:页头「导出总明细」、单位明细面板「导出该单位明细」;导出页新增「全部(单页)」。 测试:服务端 12 包全绿 / 347 个测试函数;前端 vue-tsc 通过、184 例全过;Console 18 文件。 docs/ 与 devdocs/ 同步(含新增 Q65–Q70 与两轮进度记录)。
174 lines
6.0 KiB
Go
174 lines
6.0 KiB
Go
package export
|
|
|
|
import (
|
|
"database/sql"
|
|
"io"
|
|
"sort"
|
|
|
|
"github.com/xuri/excelize/v2"
|
|
|
|
"git.yeij.top/AskaEth/Scoreboard/server/internal/domain"
|
|
)
|
|
|
|
// allTeamDetailsSheet 是总明细工作簿第一张总表的表名。
|
|
const allTeamDetailsSheet = "积分总明细"
|
|
|
|
// TeamDetailSheet 是总明细里某个单位的一张分表:列定义与单位明细完全一致。
|
|
// 只有有明细行的单位才会有分表(Rows 恒非空)。
|
|
type TeamDetailSheet struct {
|
|
Team domain.Team
|
|
Rows []TeamDetailRow
|
|
}
|
|
|
|
// AllTeamDetailsWorkbook 是「所有单位积分明细」(总明细)的内容:
|
|
// 第一张总表把所有单位的明细合在一起,其后每个有明细行的单位一张分表。
|
|
type AllTeamDetailsWorkbook struct {
|
|
Meta Meta
|
|
Sheets []TeamDetailSheet
|
|
IndividualToTeamWeight float64
|
|
}
|
|
|
|
// allTeamDetailColumns 是总表的列:在单位明细列的最前面加一列「单位」。
|
|
var allTeamDetailColumns = append([]column{{"单位", 22, kindText}}, teamDetailColumns...)
|
|
|
|
// ExportAllTeamDetailsXLSX 导出所有单位的积分明细(总表 + 每单位一张分表),落盘到 dst。
|
|
func ExportAllTeamDetailsXLSX(db *sql.DB, dst string, opts Options) error {
|
|
wb, err := LoadAllTeamDetailsWorkbook(db, opts)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
f, err := allTeamDetailsFile(wb)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return saveWorkbook(f, dst)
|
|
}
|
|
|
|
// WriteAllTeamDetailsXLSX 把总明细写成 xlsx 流,供 HTTP 直接响应下载。
|
|
func WriteAllTeamDetailsXLSX(w io.Writer, wb AllTeamDetailsWorkbook) error {
|
|
f, err := allTeamDetailsFile(wb)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return f.Write(w)
|
|
}
|
|
|
|
func allTeamDetailsFile(wb AllTeamDetailsWorkbook) (*excelize.File, error) {
|
|
return buildWorkbook(allTeamDetailsSheet, func(f *excelize.File, st *styleSet) error {
|
|
meta := wb.Meta.normalized()
|
|
// 先登记总表名:分表即使和总表同名也会自动补后缀,不会撞名覆盖。
|
|
namer := &sheetNamer{}
|
|
master := namer.add(allTeamDetailsSheet)
|
|
if err := addSheet(f, master); err != nil {
|
|
return err
|
|
}
|
|
if err := writeSheet(f, st, master, meta, sheetTitle(meta, allTeamDetailsSheet),
|
|
allTeamDetailColumns, allTeamDetailRows(wb.Sheets, wb.IndividualToTeamWeight)); err != nil {
|
|
return err
|
|
}
|
|
|
|
for _, s := range wb.Sheets {
|
|
unit := displayName(s.Team.Name, s.Team.ShortName)
|
|
name := namer.add(unit + "积分明细")
|
|
if err := addSheet(f, name); err != nil {
|
|
return err
|
|
}
|
|
title := sheetTitle(meta, unit+" · 积分明细")
|
|
if err := writeSheet(f, st, name, meta, title, teamDetailColumns,
|
|
teamDetailRows(s.Rows, wb.IndividualToTeamWeight)); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
return nil
|
|
})
|
|
}
|
|
|
|
// allTeamDetailRows 把各单位明细拼成一张总表。
|
|
// 逐单位复用 teamDetailDataRows(因此序号在每个单位内重新从 1 开始,折算口径与单位明细完全一致),
|
|
// 末尾补一行跨单位合计;即使一条流水都没有也保留合计行,保持版式一致。
|
|
func allTeamDetailRows(sheets []TeamDetailSheet, weight float64) [][]any {
|
|
var out [][]any
|
|
var total float64
|
|
for _, s := range sheets {
|
|
unit := displayName(s.Team.Name, s.Team.ShortName)
|
|
rows, sub := teamDetailDataRows(s.Rows, weight)
|
|
total += sub
|
|
for _, row := range rows {
|
|
out = append(out, append([]any{unit}, row...))
|
|
}
|
|
}
|
|
// 列序:单位 / 序号 / 大项 / 小项 / 组别 / 运动员 / 名次 / 成绩 / 来源 / 积分 / 备注。
|
|
return append(out, []any{"合计", "", "", "", "", "", "", "", "", total, ""})
|
|
}
|
|
|
|
// LoadAllTeamDetailsWorkbook 读取全量单位的积分流水。
|
|
// 单位顺序沿用「单位总分榜」(得分高的在前),与管理面板上看到的顺序一致;
|
|
// 榜上没有的单位(例如停用且没有任何流水/奖牌)按 teams.sort_order 排在其后。
|
|
// 只有真正有明细行的单位才进 Sheets:没有流水的单位既没有信息量,
|
|
// 也不能把「彻底删除」(假删除)后无流水的单位名字重新印进导出件。
|
|
func LoadAllTeamDetailsWorkbook(db *sql.DB, opts Options) (AllTeamDetailsWorkbook, error) {
|
|
if db == nil {
|
|
return AllTeamDetailsWorkbook{}, ErrNoDatabase
|
|
}
|
|
meta, settings, err := resolveMeta(db, opts.Meta)
|
|
if err != nil {
|
|
return AllTeamDetailsWorkbook{}, err
|
|
}
|
|
// 全量单位表:停用的单位也可能有历史流水,明细要能查到。
|
|
teams, err := loadTeams(db, false)
|
|
if err != nil {
|
|
return AllTeamDetailsWorkbook{}, err
|
|
}
|
|
order, err := teamStandingsOrder(db, opts)
|
|
if err != nil {
|
|
return AllTeamDetailsWorkbook{}, err
|
|
}
|
|
sort.SliceStable(teams, func(i, j int) bool {
|
|
oi, iok := order[teams[i].ID]
|
|
oj, jok := order[teams[j].ID]
|
|
if iok != jok {
|
|
return iok
|
|
}
|
|
if iok {
|
|
return oi < oj
|
|
}
|
|
// 都不在榜上时保持 loadTeams 的 sort_order, code 顺序。
|
|
return false
|
|
})
|
|
|
|
sheets := make([]TeamDetailSheet, 0, len(teams))
|
|
for _, t := range teams {
|
|
rows, err := loadTeamDetailRows(db, t.ID)
|
|
if err != nil {
|
|
return AllTeamDetailsWorkbook{}, err
|
|
}
|
|
// 没有明细行就不出分表。已隐藏(deleted_at 非空)但有流水的单位仍在榜单上,
|
|
// 照常出表;隐藏且无流水的单位不出表,否则等于把藏起来的条目印在导出件里。
|
|
if len(rows) == 0 {
|
|
continue
|
|
}
|
|
sheets = append(sheets, TeamDetailSheet{Team: t, Rows: rows})
|
|
}
|
|
return AllTeamDetailsWorkbook{
|
|
Meta: meta,
|
|
Sheets: sheets,
|
|
IndividualToTeamWeight: parseFloatDefault(settings["standings.individual_to_team_weight"], 1),
|
|
}, nil
|
|
}
|
|
|
|
// teamStandingsOrder 返回 单位ID → 总积分榜名次(0 起)。
|
|
// 名次规则只在 domain 里有一份,这里直接复用总积分榜的结果,不另算一套排序。
|
|
func teamStandingsOrder(db *sql.DB, opts Options) (map[int64]int, error) {
|
|
wb, err := LoadStandingsWorkbook(db, opts)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
order := make(map[int64]int, len(wb.Team))
|
|
for i, r := range wb.Team {
|
|
if _, ok := order[r.TeamID]; !ok {
|
|
order[r.TeamID] = i
|
|
}
|
|
}
|
|
return order, nil
|
|
}
|