Files
Scoreboard/server/internal/export/team.go
T
AskaEth 782a38f82f feat: 大屏控制可看局域网设备并逐台切页 + 两种新导出(单页成绩 / 单位积分总明细)
## 大屏控制(用户:管理面板只能看到本机显示器,看不到局域网设备;也不能给某块屏单独切页)
- 服务端:`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 与两轮进度记录)。
2026-09-11 00:44:03 +08:00

119 lines
3.4 KiB
Go

package export
import (
"database/sql"
"io"
"strconv"
"github.com/xuri/excelize/v2"
"git.yeij.top/AskaEth/Scoreboard/server/internal/domain"
)
// TeamDetailRow 是单位积分明细的一行:一分一行的得分来源。
type TeamDetailRow struct {
SportName string
EventName string
Category string
AthleteName string
Rank int
ResultText string
Source string
Points float64
Remark string
// individual 标记该条流水记到个人:合计要按 individual_to_team_weight 折算。
individual bool
}
// TeamDetailWorkbook 是「单位积分明细」的内容。
type TeamDetailWorkbook struct {
Meta Meta
Team domain.Team
Rows []TeamDetailRow
// IndividualToTeamWeight 与总积分榜同源,用于把个人分折算进「合计」。
IndividualToTeamWeight float64
}
var teamDetailColumns = []column{
{"序号", 6, kindInt},
{"大项", 14, kindText},
{"小项", 18, kindText},
{"组别", 14, kindText},
{"运动员", 14, kindText},
{"名次", 7, kindCenter},
{"成绩", 12, kindCenter},
{"来源", 12, kindCenter},
{"积分", 8, kindNumber},
{"备注", 20, kindText},
}
// ExportTeamDetailXLSX 导出某单位的积分明细(逐项列出得分来源)。
func ExportTeamDetailXLSX(db *sql.DB, teamID int64, dst string, opts Options) error {
wb, err := LoadTeamDetailWorkbook(db, teamID, opts)
if err != nil {
return err
}
f, err := teamDetailFile(wb)
if err != nil {
return err
}
return saveWorkbook(f, dst)
}
// WriteTeamDetailXLSX 把单位积分明细写成 xlsx 流。
func WriteTeamDetailXLSX(w io.Writer, wb TeamDetailWorkbook) error {
f, err := teamDetailFile(wb)
if err != nil {
return err
}
return f.Write(w)
}
func teamDetailFile(wb TeamDetailWorkbook) (*excelize.File, error) {
return buildWorkbook("积分明细", func(f *excelize.File, st *styleSet) error {
meta := wb.Meta.normalized()
name := sanitizeSheetName(displayName(wb.Team.Name, wb.Team.ShortName) + "积分明细")
if err := addSheet(f, name); err != nil {
return err
}
title := sheetTitle(meta, displayName(wb.Team.Name, wb.Team.ShortName)+" · 积分明细")
return writeSheet(f, st, name, meta, title, teamDetailColumns, teamDetailRows(wb.Rows, wb.IndividualToTeamWeight))
})
}
// teamDetailDataRows 生成明细的数据行(不含「合计」)并返回合计值。与 REST 的单位积分明细同口径:
// 记到个人的流水按 individual_to_team_weight 折算后展示,合计即各行之和。
// 总明细表复用它拼各单位的数据行,保证单表与总表逐格一致。
func teamDetailDataRows(rows []TeamDetailRow, weight float64) ([][]any, float64) {
if weight <= 0 {
weight = 1
}
out := make([][]any, 0, len(rows))
var total float64
for i, r := range rows {
points := r.Points
if r.individual {
points *= weight
}
total += points
rank := ""
if r.Rank > 0 {
rank = strconv.Itoa(r.Rank)
}
out = append(out, []any{
i + 1, r.SportName, r.EventName, r.Category, r.AthleteName,
rank, r.ResultText, r.Source, points, r.Remark,
})
}
return out, total
}
// teamDetailRows 把明细行排成表格:数据行后跟一行「合计」;没有流水时不加合计行。
func teamDetailRows(rows []TeamDetailRow, weight float64) [][]any {
data, total := teamDetailDataRows(rows, weight)
if len(data) == 0 {
return data
}
return append(data, []any{"合计", "", "", "", "", "", "", "", total, ""})
}