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 与两轮进度记录）。
This commit is contained in:
AskaEth committed
1 parent
793d2ac064
commit
782a38f82f
33 files changed
+2473
-119
No files matched your search
@@ -0,0 +1,208 @@
|
||||
package httpapi_test
|
||||
|
||||
import (
|
||||
"database/sql"
|
||||
"errors"
|
||||
"net/http"
|
||||
"strings"
|
||||
"testing"
|
||||
"time"
|
||||
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/httpapi"
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/realtime"
|
||||
)
|
||||
|
||||
// waitDisplayAudit 取最后一条 display.command 审计的 after_json。
|
||||
// 审计中间件在响应写完之后才落库，所以这里给一小段重试窗口。
|
||||
func waitDisplayAudit(t *testing.T, env *testEnv) string {
|
||||
t.Helper()
|
||||
for i := 0; i < 100; i++ {
|
||||
var after sql.NullString
|
||||
err := env.ev.QueryRow(
|
||||
`SELECT after_json FROM audit_logs WHERE action = 'display.command' ORDER BY id DESC LIMIT 1`).Scan(&after)
|
||||
switch {
|
||||
case err == nil:
|
||||
return after.String
|
||||
case errors.Is(err, sql.ErrNoRows):
|
||||
time.Sleep(10 * time.Millisecond)
|
||||
default:
|
||||
t.Fatalf("查询审计: %v", err)
|
||||
}
|
||||
}
|
||||
t.Fatal("等不到 display.command 的审计记录")
|
||||
return ""
|
||||
}
|
||||
|
||||
// settingOrEmpty 读 settings 表里的点号键，缺行返回空串（没写过公告时就没有这一行）。
|
||||
func settingOrEmpty(t *testing.T, env *testEnv, key string) string {
|
||||
t.Helper()
|
||||
var v sql.NullString
|
||||
err := env.ev.QueryRow(`SELECT value FROM settings WHERE key = ?`, key).Scan(&v)
|
||||
switch {
|
||||
case err == nil:
|
||||
return v.String
|
||||
case errors.Is(err, sql.ErrNoRows):
|
||||
return ""
|
||||
default:
|
||||
t.Fatalf("读取配置 %s: %v", key, err)
|
||||
}
|
||||
return ""
|
||||
}
|
||||
|
||||
// newDisplayEnv 建一个带 recorder 客户端与指令桩的环境。
|
||||
func newDisplayEnv(t *testing.T, sender *strictDisplaySender) (*testEnv, *http.Client) {
|
||||
t.Helper()
|
||||
env := newTestEnvWith(t, func(o *httpapi.Options) { o.Display = sender })
|
||||
env.createUser("recorder", "recorder-pass", "recorder")
|
||||
client, _ := env.client()
|
||||
env.login(client, "recorder", "recorder-pass")
|
||||
return env, client
|
||||
}
|
||||
|
||||
// 带 targets 的指令只发给点名的实例，命中数与目标一并进审计。
|
||||
func TestDisplayCommandTargetsInstances(t *testing.T) {
|
||||
sender := &strictDisplaySender{}
|
||||
env, client := newDisplayEnv(t, sender)
|
||||
|
||||
status, env2 := env.do(client, http.MethodPost, "/api/display/command", map[string]any{
|
||||
"action": "goto",
|
||||
"payload": map[string]any{"page": "medals"},
|
||||
"targets": []string{"screen-a", "screen-b"},
|
||||
}, true)
|
||||
if status != http.StatusOK || !env2.OK {
|
||||
t.Fatalf("定向下发应 200，得到 %d %+v", status, env2.Error)
|
||||
}
|
||||
if len(sender.targets) != 1 || len(sender.targets[0]) != 2 ||
|
||||
sender.targets[0][0] != "screen-a" || sender.targets[0][1] != "screen-b" {
|
||||
t.Fatalf("targets 应原样传给实时层，得到 %+v", sender.targets)
|
||||
}
|
||||
|
||||
after := waitDisplayAudit(t, env)
|
||||
for _, want := range []string{`"action":"goto"`, `"targets":["screen-a","screen-b"]`, `"matched":2`} {
|
||||
if !strings.Contains(after, want) {
|
||||
t.Fatalf("审计应含 %s，得到 %s", want, after)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 不带 targets = 广播：实时层收到空 targets，公告这条链路照旧。
|
||||
func TestDisplayCommandBroadcastKeepsWorking(t *testing.T) {
|
||||
sender := &strictDisplaySender{}
|
||||
env, client := newDisplayEnv(t, sender)
|
||||
|
||||
status, env2 := env.do(client, http.MethodPost, "/api/display/command", map[string]any{
|
||||
"action": "announce",
|
||||
"payload": map[string]any{"text": "决赛推迟到 15:00", "seconds": 30},
|
||||
}, true)
|
||||
if status != http.StatusOK || !env2.OK {
|
||||
t.Fatalf("广播公告应 200，得到 %d %+v", status, env2.Error)
|
||||
}
|
||||
if len(sender.targets) != 1 || sender.targets[0] != nil {
|
||||
t.Fatalf("不带 targets 时应按广播下发（nil），得到 %+v", sender.targets)
|
||||
}
|
||||
if got := settingValue(t, env, "display.announce_text"); got != "决赛推迟到 15:00" {
|
||||
t.Fatalf("广播公告仍应落库，得到 %q", got)
|
||||
}
|
||||
if after := waitDisplayAudit(t, env); !strings.Contains(after, `"matched":1`) {
|
||||
t.Fatalf("广播也要记命中数，得到 %s", after)
|
||||
}
|
||||
}
|
||||
|
||||
// 目标全部离线：返回可读的 404，且公告不落库、不产生新的 settings 变更。
|
||||
func TestDisplayCommandOfflineTargetReturns404(t *testing.T) {
|
||||
matched := 0
|
||||
sender := &strictDisplaySender{matched: &matched}
|
||||
env, client := newDisplayEnv(t, sender)
|
||||
|
||||
status, env2 := env.do(client, http.MethodPost, "/api/display/command", map[string]any{
|
||||
"action": "announce",
|
||||
"payload": map[string]any{"text": "这条不该落库", "seconds": 30},
|
||||
"targets": []string{"gone-screen"},
|
||||
}, true)
|
||||
if status != http.StatusNotFound || env2.Error == nil {
|
||||
t.Fatalf("目标离线应 404，得到 %d %+v", status, env2.Error)
|
||||
}
|
||||
if env2.Error.Message != "目标大屏已离线，请刷新在线列表" {
|
||||
t.Fatalf("404 消息应为可读中文，得到 %q", env2.Error.Message)
|
||||
}
|
||||
if got := settingOrEmpty(t, env, "display.announce_text"); got != "" {
|
||||
t.Fatalf("没命中任何屏时公告不该落库，得到 %q", got)
|
||||
}
|
||||
// 定向失败的请求没有成功审计（审计只记 2xx）。
|
||||
var n int
|
||||
if err := env.ev.QueryRow(`SELECT COUNT(*) FROM audit_logs WHERE action = 'display.command'`).Scan(&n); err != nil {
|
||||
t.Fatalf("统计审计: %v", err)
|
||||
}
|
||||
if n != 0 {
|
||||
t.Fatalf("失败的指令不该留 display.command 审计，得到 %d 条", n)
|
||||
}
|
||||
}
|
||||
|
||||
// GET /api/display/instances 要把屏号带出来，方便面板把本机显示器与在线实例对上。
|
||||
func TestDisplayInstancesExposeScreen(t *testing.T) {
|
||||
fake := &fakeRealtime{}
|
||||
env := newTestEnvWith(t, func(o *httpapi.Options) { o.Realtime = fake })
|
||||
fake.db = env.ev
|
||||
env.createUser("recorder", "recorder-pass", "recorder")
|
||||
client, _ := env.client()
|
||||
env.login(client, "recorder", "recorder-pass")
|
||||
|
||||
fake.instances = []realtime.Instance{
|
||||
{ID: "console-1", Online: true, Page: "standings", Screen: "2", RemoteAddr: "192.168.1.9:51000"},
|
||||
{ID: "lan-1", Online: true, Page: "medals"},
|
||||
}
|
||||
status, env2 := env.do(client, http.MethodGet, "/api/display/instances", nil, false)
|
||||
if status != http.StatusOK || !env2.OK {
|
||||
t.Fatalf("读取大屏实例应 200，得到 %d %+v", status, env2.Error)
|
||||
}
|
||||
rows := decodeData[[]map[string]any](t, env2)
|
||||
if len(rows) != 2 {
|
||||
t.Fatalf("应返回 2 个实例，得到 %+v", rows)
|
||||
}
|
||||
if rows[0]["screen"] != "2" || rows[1]["screen"] != "" {
|
||||
t.Fatalf("屏号字段应原样带出（无屏号为空串），得到 %+v", rows)
|
||||
}
|
||||
if rows[0]["page"] != "standings" || rows[1]["page"] != "medals" {
|
||||
t.Fatalf("当前页字段应原样带出，得到 %+v", rows)
|
||||
}
|
||||
}
|
||||
|
||||
// 权限：指令与实例列表都要求 recorder 及以上，guest 一律拒绝。
|
||||
func TestDisplayEndpointsRequireRecorder(t *testing.T) {
|
||||
sender := &strictDisplaySender{}
|
||||
env := newTestEnvWith(t, func(o *httpapi.Options) { o.Display = sender })
|
||||
guest, _ := env.client()
|
||||
|
||||
if status, _ := env.do(guest, http.MethodPost, "/api/display/command",
|
||||
map[string]any{"action": "goto", "payload": map[string]any{"page": "medals"}}, false); status == http.StatusOK {
|
||||
t.Fatalf("guest 下发指令不该成功，得到 %d", status)
|
||||
}
|
||||
if status, _ := env.do(guest, http.MethodGet, "/api/display/instances", nil, false); status != http.StatusForbidden {
|
||||
t.Fatalf("guest 读实例列表应 403，得到 %d", status)
|
||||
}
|
||||
|
||||
env, client := newDisplayEnv(t, sender)
|
||||
if status, env2 := env.do(client, http.MethodPost, "/api/display/command", map[string]any{
|
||||
"action": "goto", "payload": map[string]any{"page": "medals"},
|
||||
}, true); status != http.StatusOK {
|
||||
t.Fatalf("recorder 下发指令应 200，得到 %d %+v", status, env2.Error)
|
||||
}
|
||||
if status, env2 := env.do(client, http.MethodGet, "/api/display/instances", nil, false); status != http.StatusOK || !env2.OK {
|
||||
t.Fatalf("recorder 读实例列表应 200，得到 %d %+v", status, env2.Error)
|
||||
}
|
||||
}
|
||||
|
||||
// 未知 action 仍要被实时层拒收（走 strictDisplaySender 的同口径校验）。
|
||||
func TestDisplayCommandRejectsUnknownAction(t *testing.T) {
|
||||
sender := &strictDisplaySender{}
|
||||
env, client := newDisplayEnv(t, sender)
|
||||
|
||||
status, env2 := env.do(client, http.MethodPost, "/api/display/command",
|
||||
map[string]any{"action": "nope"}, true)
|
||||
if status != http.StatusInternalServerError || env2.Error == nil {
|
||||
t.Fatalf("未知 action 应被拒收，得到 %d %+v", status, env2.Error)
|
||||
}
|
||||
if len(sender.sent) != 0 {
|
||||
t.Fatalf("未知 action 不该下发，得到 %v", sender.sent)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,123 @@
|
||||
package httpapi_test
|
||||
|
||||
import (
|
||||
"net/http"
|
||||
"net/url"
|
||||
"testing"
|
||||
)
|
||||
|
||||
// 未登录（guest）能下载单页平铺总表：文件名、单 sheet、逐格与 all.xlsx 的分项 sheet 一致。
|
||||
func TestExportAllFlatXLSXGuest(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
env.seed(t)
|
||||
client, _ := env.client()
|
||||
|
||||
status, header, body := env.getRaw(t, client, "/api/export/all-flat.xlsx")
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("guest 下载单页总表应 200，得到 %d %s", status, body)
|
||||
}
|
||||
if got := header.Get("Content-Type"); got != xlsxContentType {
|
||||
t.Errorf("Content-Type = %q", got)
|
||||
}
|
||||
wantCD := "attachment; filename*=UTF-8''" + url.PathEscape("赛事成绩总表（单页）.xlsx")
|
||||
if got := header.Get("Content-Disposition"); got != wantCD {
|
||||
t.Errorf("Content-Disposition = %q，期望 %q", got, wantCD)
|
||||
}
|
||||
|
||||
f := openWorkbook(t, body)
|
||||
defer func() { _ = f.Close() }()
|
||||
if got := f.GetSheetList(); !equalSheetList(got, []string{"全部成绩"}) {
|
||||
t.Fatalf("sheet 列表 = %v，期望只有一张「全部成绩」", got)
|
||||
}
|
||||
flat, err := f.GetRows("全部成绩")
|
||||
if err != nil {
|
||||
t.Fatalf("读取单页总表: %v", err)
|
||||
}
|
||||
// 4 行版式 + 2 条报名（seed 造了 2 个单位各 1 条报名）
|
||||
if len(flat) != 6 {
|
||||
t.Fatalf("单页总表行数 = %d，期望 6", len(flat))
|
||||
}
|
||||
for i, want := range []string{"大项", "小项", "组别", "名次", "号码", "单位", "运动员/队", "成绩", "积分", "状态", "备注"} {
|
||||
if got := masterCell(flat, 3, i); got != want {
|
||||
t.Errorf("表头第 %d 列 = %q，期望 %q", i, got, want)
|
||||
}
|
||||
}
|
||||
if got := masterCell(flat, 4, 0); got != "田径" {
|
||||
t.Errorf("首行大项 = %q，期望 田径", got)
|
||||
}
|
||||
if got := masterCell(flat, 4, 1); got != "100米跑" {
|
||||
t.Errorf("首行小项 = %q，期望 100米跑", got)
|
||||
}
|
||||
if got := masterCell(flat, 4, 2); got != "男子" {
|
||||
t.Errorf("首行组别 = %q，期望 男子", got)
|
||||
}
|
||||
if got := masterCell(flat, 4, 5); got != "第一分公司" {
|
||||
t.Errorf("首行单位 = %q，期望 第一分公司", got)
|
||||
}
|
||||
|
||||
// 与 all.xlsx 的分项 sheet 逐格一致（除新增三列）。
|
||||
status, _, allBody := env.getRaw(t, client, "/api/export/all.xlsx")
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("下载全部导出应 200，得到 %d", status)
|
||||
}
|
||||
allF := openWorkbook(t, allBody)
|
||||
defer func() { _ = allF.Close() }()
|
||||
sheets := allF.GetSheetList()
|
||||
if len(sheets) != 4 { // 3 张总表 + 1 个分项
|
||||
t.Fatalf("全部导出 sheet 列表 = %v", sheets)
|
||||
}
|
||||
flatRow, rows := 4, 0
|
||||
for _, name := range sheets[3:] {
|
||||
eventRows, err := allF.GetRows(name)
|
||||
if err != nil {
|
||||
t.Fatalf("读取分项 %s: %v", name, err)
|
||||
}
|
||||
for i := 0; i < len(eventRows)-4; i++ {
|
||||
for c := 0; c < 8; c++ {
|
||||
if got, want := masterCell(flat, flatRow+i, c+3), masterCell(eventRows, 4+i, c); got != want {
|
||||
t.Errorf("分项 %s 第 %d 行第 %d 列：单页 %q，全部 %q", name, i, c, got, want)
|
||||
}
|
||||
}
|
||||
rows++
|
||||
}
|
||||
flatRow += len(eventRows) - 4
|
||||
}
|
||||
if rows != len(flat)-4 {
|
||||
t.Errorf("比对行数 = %d，单页数据行 = %d", rows, len(flat)-4)
|
||||
}
|
||||
}
|
||||
|
||||
// 新增导出不能带坏既有导出：权限与 sheet 结构全部保原样。
|
||||
func TestExistingExportsUnchanged(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
env.seed(t)
|
||||
client, _ := env.client()
|
||||
|
||||
cases := []struct {
|
||||
path string
|
||||
file string
|
||||
sheets []string
|
||||
}{
|
||||
{"/api/export/standings.xlsx", "总积分榜.xlsx", []string{"总积分榜", "团体奖牌榜", "个人积分奖牌榜"}},
|
||||
{"/api/export/all.xlsx", "赛事成绩总表.xlsx", []string{"总积分榜", "团体奖牌榜", "个人积分奖牌榜", "田径·100米跑·男子"}},
|
||||
{"/api/export/events/1", "分项成绩表.xlsx", []string{"田径·100米跑·男子"}},
|
||||
{"/api/export/teams.xlsx", "单位积分总明细.xlsx", []string{"积分总明细"}},
|
||||
{"/api/export/teams/1", "单位积分明细.xlsx", []string{"第一分公司积分明细"}},
|
||||
}
|
||||
for _, tc := range cases {
|
||||
status, header, body := env.getRaw(t, client, tc.path)
|
||||
if status != http.StatusOK {
|
||||
t.Errorf("%s 应 200，得到 %d %s", tc.path, status, body)
|
||||
continue
|
||||
}
|
||||
wantCD := "attachment; filename*=UTF-8''" + url.PathEscape(tc.file)
|
||||
if got := header.Get("Content-Disposition"); got != wantCD {
|
||||
t.Errorf("%s 文件名 = %q，期望 %q", tc.path, got, wantCD)
|
||||
}
|
||||
f := openWorkbook(t, body)
|
||||
if got := f.GetSheetList(); !equalSheetList(got, tc.sheets) {
|
||||
t.Errorf("%s sheet 列表 = %v，期望 %v", tc.path, got, tc.sheets)
|
||||
}
|
||||
_ = f.Close()
|
||||
}
|
||||
}
|
||||
@@ -26,8 +26,11 @@ const maxProjectImportBytes = 512 << 20
|
||||
func (s *server) exportRoutes(mux *http.ServeMux) {
|
||||
mux.HandleFunc("GET /api/export/standings.xlsx", s.read(auth.RoleGuest, s.exportStandingsXLSX))
|
||||
mux.HandleFunc("GET /api/export/all.xlsx", s.read(auth.RoleGuest, s.exportAllXLSX))
|
||||
mux.HandleFunc("GET /api/export/all-flat.xlsx", s.read(auth.RoleGuest, s.exportAllFlatXLSX))
|
||||
// Go 1.22 ServeMux 的通配段必须独占一段，所以分项/单位导出用 /{id}，文件名由响应头给出。
|
||||
mux.HandleFunc("GET /api/export/events/{id}", s.read(auth.RoleGuest, s.exportEventXLSX))
|
||||
// teams.xlsx 与 teams/{id} 段数不同，ServeMux 不会冲突。
|
||||
mux.HandleFunc("GET /api/export/teams.xlsx", s.read(auth.RoleGuest, s.exportAllTeamsXLSX))
|
||||
mux.HandleFunc("GET /api/export/teams/{id}", s.read(auth.RoleGuest, s.exportTeamXLSX))
|
||||
|
||||
mux.HandleFunc("GET /api/export/project.zip", s.read(auth.RoleAdmin, s.exportProjectZip))
|
||||
@@ -79,6 +82,29 @@ func (s *server) exportAllXLSX(w http.ResponseWriter, r *http.Request) (any, err
|
||||
})
|
||||
}
|
||||
|
||||
// exportAllFlatXLSX 导出全部成绩的单页平铺版：一个工作簿只含一张表，
|
||||
// 每行 = 某个单位某个人的某个项目。与「全部」（all.xlsx，多 sheet）内容同源。
|
||||
func (s *server) exportAllFlatXLSX(w http.ResponseWriter, r *http.Request) (any, error) {
|
||||
wb, err := export.LoadFlatWorkbook(s.ev, export.Options{})
|
||||
if err != nil {
|
||||
return nil, internal(err)
|
||||
}
|
||||
return s.streamDownload(w, "赛事成绩总表（单页）.xlsx", xlsxMIME, func(out io.Writer) error {
|
||||
return export.WriteFlatXLSX(out, wb)
|
||||
})
|
||||
}
|
||||
|
||||
// exportAllTeamsXLSX 导出所有单位的积分明细：第一张总表 + 每个单位一张分表。
|
||||
func (s *server) exportAllTeamsXLSX(w http.ResponseWriter, r *http.Request) (any, error) {
|
||||
wb, err := export.LoadAllTeamDetailsWorkbook(s.ev, export.Options{})
|
||||
if err != nil {
|
||||
return nil, internal(err)
|
||||
}
|
||||
return s.streamDownload(w, "单位积分总明细.xlsx", xlsxMIME, func(out io.Writer) error {
|
||||
return export.WriteAllTeamDetailsXLSX(out, wb)
|
||||
})
|
||||
}
|
||||
|
||||
func (s *server) exportTeamXLSX(w http.ResponseWriter, r *http.Request) (any, error) {
|
||||
id, err := pathID(r, "id")
|
||||
if err != nil {
|
||||
|
||||
@@ -0,0 +1,152 @@
|
||||
package httpapi_test
|
||||
|
||||
import (
|
||||
"bytes"
|
||||
"io"
|
||||
"net/http"
|
||||
"net/url"
|
||||
"strings"
|
||||
"testing"
|
||||
|
||||
"github.com/xuri/excelize/v2"
|
||||
)
|
||||
|
||||
const xlsxContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
|
||||
|
||||
// getRaw 取原始响应体：xlsx 是二进制，不能走会把响应体按 JSON 解析的 do()。
|
||||
func (e *testEnv) getRaw(t *testing.T, client *http.Client, path string) (int, http.Header, []byte) {
|
||||
t.Helper()
|
||||
resp, err := client.Get(e.server.URL + path)
|
||||
if err != nil {
|
||||
t.Fatalf("请求 %s: %v", path, err)
|
||||
}
|
||||
defer func() { _ = resp.Body.Close() }()
|
||||
body, err := io.ReadAll(resp.Body)
|
||||
if err != nil {
|
||||
t.Fatalf("读取 %s 响应: %v", path, err)
|
||||
}
|
||||
return resp.StatusCode, resp.Header, body
|
||||
}
|
||||
|
||||
func openWorkbook(t *testing.T, body []byte) *excelize.File {
|
||||
t.Helper()
|
||||
f, err := excelize.OpenReader(bytes.NewReader(body))
|
||||
if err != nil {
|
||||
t.Fatalf("解析 xlsx: %v", err)
|
||||
}
|
||||
return f
|
||||
}
|
||||
|
||||
// 未登录（guest）能下载总明细，文件名与 sheet 结构符合约定；顺带确认 teams/{id} 没被改坏。
|
||||
func TestExportAllTeamDetailsXLSXGuest(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
ids := env.seed(t)
|
||||
env.exec(t, `INSERT INTO score_ledger (team_id, athlete_id, event_id, entry_id, source_type, source_id, points)
|
||||
VALUES (?, ?, ?, ?, 'result', 1, 10)`, ids.teamA, ids.athleteA, ids.event, ids.entryA)
|
||||
env.exec(t, `INSERT INTO score_ledger (team_id, athlete_id, event_id, entry_id, source_type, source_id, points)
|
||||
VALUES (?, ?, ?, ?, 'result', 2, 8)`, ids.teamB, ids.athB, ids.event, ids.entryB)
|
||||
// 已「彻底删除」（假删除的隐藏单位）且无流水：不能出现在导出件的任何一张表里。
|
||||
env.exec(t, `INSERT INTO teams (code, name, short_name, sort_order, active, deleted_at)
|
||||
VALUES ('HID', '被隐藏单位', '隐藏', 9, 0, datetime('now'))`)
|
||||
|
||||
// 不带登录态 = guest，与 standings.xlsx 同权限。
|
||||
client, _ := env.client()
|
||||
status, header, body := env.getRaw(t, client, "/api/export/teams.xlsx")
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("guest 下载总明细应 200，得到 %d %s", status, body)
|
||||
}
|
||||
if got := header.Get("Content-Type"); got != xlsxContentType {
|
||||
t.Errorf("Content-Type = %q", got)
|
||||
}
|
||||
wantCD := "attachment; filename*=UTF-8''" + url.PathEscape("单位积分总明细.xlsx")
|
||||
if got := header.Get("Content-Disposition"); got != wantCD {
|
||||
t.Errorf("Content-Disposition = %q，期望 %q", got, wantCD)
|
||||
}
|
||||
|
||||
f := openWorkbook(t, body)
|
||||
defer func() { _ = f.Close() }()
|
||||
want := []string{"积分总明细", "第一分公司积分明细", "第二分公司积分明细"}
|
||||
if got := f.GetSheetList(); !equalSheetList(got, want) {
|
||||
t.Fatalf("sheet 列表 = %v，期望 %v", got, want)
|
||||
}
|
||||
// 无流水的隐藏单位不得以任何形式出现在工作簿里（不在 sheet 名列表里就是全部证据）。
|
||||
for _, name := range f.GetSheetList() {
|
||||
if strings.Contains(name, "隐藏") {
|
||||
t.Errorf("无流水的隐藏单位不应出分表，却看到 %q", name)
|
||||
}
|
||||
}
|
||||
master, err := f.GetRows("积分总明细")
|
||||
if err != nil {
|
||||
t.Fatalf("读取总表: %v", err)
|
||||
}
|
||||
if len(master) != 7 { // 4 行版式 + 2 条明细 + 合计
|
||||
t.Fatalf("总表行数 = %d，期望 7", len(master))
|
||||
}
|
||||
if got := masterCell(master, 3, 0); got != "单位" {
|
||||
t.Errorf("总表表头首列 = %q", got)
|
||||
}
|
||||
if got := masterCell(master, 6, 9); got != "18" {
|
||||
t.Errorf("总表合计 = %q，期望 18", got)
|
||||
}
|
||||
|
||||
// 既有 teams/{id} 导出：权限、文件名、内容都不能被这次改动带坏。
|
||||
status, header, singleBody := env.getRaw(t, client, "/api/export/teams/1")
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("guest 下载单位明细应 200，得到 %d %s", status, singleBody)
|
||||
}
|
||||
wantSingle := "attachment; filename*=UTF-8''" + url.PathEscape("单位积分明细.xlsx")
|
||||
if got := header.Get("Content-Disposition"); got != wantSingle {
|
||||
t.Errorf("单位明细文件名 = %q，期望 %q", got, wantSingle)
|
||||
}
|
||||
sf := openWorkbook(t, singleBody)
|
||||
defer func() { _ = sf.Close() }()
|
||||
if got := sf.GetSheetList(); !equalSheetList(got, []string{"第一分公司积分明细"}) {
|
||||
t.Fatalf("单位明细 sheet 列表 = %v", got)
|
||||
}
|
||||
|
||||
// 两个端点出的同一单位数字必须一致。
|
||||
singleRows, err := sf.GetRows("第一分公司积分明细")
|
||||
if err != nil {
|
||||
t.Fatalf("读取单位明细: %v", err)
|
||||
}
|
||||
allRows, err := f.GetRows("第一分公司积分明细")
|
||||
if err != nil {
|
||||
t.Fatalf("读取总明细分表: %v", err)
|
||||
}
|
||||
if len(singleRows) != len(allRows) {
|
||||
t.Fatalf("行数不一致：单位明细 %d，总明细 %d", len(singleRows), len(allRows))
|
||||
}
|
||||
for r := range singleRows {
|
||||
for c := 0; c < 10; c++ {
|
||||
if got, want := masterCell(allRows, r, c), masterCell(singleRows, r, c); got != want {
|
||||
t.Errorf("第 %d 行第 %d 列不一致：总明细 %q，单位明细 %q", r, c, got, want)
|
||||
}
|
||||
}
|
||||
}
|
||||
// 折算口径也一致：10 分（个人流水，系数默认 1）。
|
||||
if got := masterCell(singleRows, 4, 8); got != "10" {
|
||||
t.Errorf("单位明细首行积分 = %q，期望 10", got)
|
||||
}
|
||||
}
|
||||
|
||||
func masterCell(rows [][]string, r, c int) string {
|
||||
if r < 0 || r >= len(rows) {
|
||||
return ""
|
||||
}
|
||||
if c < 0 || c >= len(rows[r]) {
|
||||
return ""
|
||||
}
|
||||
return rows[r][c]
|
||||
}
|
||||
|
||||
func equalSheetList(a, b []string) bool {
|
||||
if len(a) != len(b) {
|
||||
return false
|
||||
}
|
||||
for i := range a {
|
||||
if a[i] != b[i] {
|
||||
return false
|
||||
}
|
||||
}
|
||||
return true
|
||||
}
|
||||
@@ -214,6 +214,13 @@ func announceFromPayload(payload any) (string, int) {
|
||||
return text, int(seconds)
|
||||
}
|
||||
|
||||
// displayCommandAudit 是 display.command 的审计载荷：指令内容原样保留（现场按 action 检索的
|
||||
// 既有查询不受影响），另外记上定向目标与实际命中的实例数。
|
||||
type displayCommandAudit struct {
|
||||
displayCommandInput
|
||||
Matched int `json:"matched"`
|
||||
}
|
||||
|
||||
func (s *server) displayCommandHandler(w http.ResponseWriter, r *http.Request) (any, error) {
|
||||
var in displayCommandInput
|
||||
if err := decodeJSON(r, &in); err != nil {
|
||||
@@ -222,12 +229,19 @@ func (s *server) displayCommandHandler(w http.ResponseWriter, r *http.Request) (
|
||||
if in.Action == "" {
|
||||
return nil, badRequest("action 必填", nil)
|
||||
}
|
||||
matched := 0
|
||||
// 清空公告必须落库，即使实时层尚不认这个 action（转发会被 NewDisplayCommand 拒收），
|
||||
// 否则「撤销公告」会整体失败；协议登记后这里的转发自动生效。
|
||||
if s.display != nil && (in.Action != cmdAnnounceClear || realtime.ValidDisplayAction(in.Action)) {
|
||||
if err := s.display.SendDisplayCommand(in.Action, in.Payload); err != nil {
|
||||
n, err := s.display.SendDisplayCommand(in.Action, in.Payload, in.Targets)
|
||||
if err != nil {
|
||||
return nil, internal(err)
|
||||
}
|
||||
matched = n
|
||||
// 点了名却一块屏都没命中（已离线或 id 写错）时明确报错，别让现场以为指令发出去了。
|
||||
if len(in.Targets) > 0 && n == 0 {
|
||||
return nil, notFound("目标大屏已离线，请刷新在线列表")
|
||||
}
|
||||
}
|
||||
// 公告要落库：只转发不落库的话，全屏推送结束（seconds 秒）后底栏会回落到「暂无公告」，
|
||||
// 新连上的大屏也拿不到当前公告。
|
||||
@@ -244,8 +258,9 @@ func (s *server) displayCommandHandler(w http.ResponseWriter, r *http.Request) (
|
||||
}
|
||||
}
|
||||
// 审计沿用同一条 action：现场按 action=display.command 检索的既有查询不受影响，
|
||||
// after 里已经带了这次的具体 action 与公告正文。
|
||||
s.audit(r.Context(), "display.command", "display", 0, nil, in)
|
||||
// after 里带了这次的具体 action、公告正文、定向目标与命中数。
|
||||
s.audit(r.Context(), "display.command", "display", 0, nil,
|
||||
displayCommandAudit{displayCommandInput: in, Matched: matched})
|
||||
return nil, nil
|
||||
}
|
||||
|
||||
|
||||
@@ -9,14 +9,27 @@ import (
|
||||
)
|
||||
|
||||
// strictDisplaySender 与 main.go 的 displaySender 同口径：经实时层校验 action，未知 action 直接报错。
|
||||
type strictDisplaySender struct{ sent []string }
|
||||
// matched 为 nil 时按「广播算命中一块屏、定向一条算命中一块」返回，便于断言正常路径；
|
||||
// 需要模拟「目标已离线」时把它设成 0。
|
||||
type strictDisplaySender struct {
|
||||
sent []string
|
||||
targets [][]string
|
||||
matched *int
|
||||
}
|
||||
|
||||
func (d *strictDisplaySender) SendDisplayCommand(action string, payload any) error {
|
||||
func (d *strictDisplaySender) SendDisplayCommand(action string, payload any, targets []string) (int, error) {
|
||||
if _, err := realtime.NewDisplayCommand(action, payload); err != nil {
|
||||
return err
|
||||
return 0, err
|
||||
}
|
||||
d.sent = append(d.sent, action)
|
||||
return nil
|
||||
d.targets = append(d.targets, targets)
|
||||
if d.matched != nil {
|
||||
return *d.matched, nil
|
||||
}
|
||||
if len(targets) == 0 {
|
||||
return 1, nil
|
||||
}
|
||||
return len(targets), nil
|
||||
}
|
||||
|
||||
// settingValue 读取 settings 表里的点号键。
|
||||
|
||||
@@ -56,10 +56,14 @@ type recordBreakInput struct {
|
||||
RequestID string `json:"requestId"`
|
||||
}
|
||||
|
||||
// displayCommandInput 是大屏控制指令的请求体。
|
||||
type displayCommandInput struct {
|
||||
Action string `json:"action"`
|
||||
Payload any `json:"payload"`
|
||||
RequestID string `json:"requestId"`
|
||||
Action string `json:"action"`
|
||||
Payload any `json:"payload"`
|
||||
// Targets 是要定向控制的大屏实例 id（GET /api/display/instances 的 id）；
|
||||
// 留空表示广播给所有大屏——公告这类全屏指令走的就是广播。
|
||||
Targets []string `json:"targets"`
|
||||
RequestID string `json:"requestId"`
|
||||
}
|
||||
|
||||
type voidAdjustmentPayload struct {
|
||||
|
||||
@@ -18,7 +18,9 @@ import (
|
||||
|
||||
// DisplaySender 把大屏控制命令推给实时层；未接入时命令只记审计、不影响接口可用性。
|
||||
type DisplaySender interface {
|
||||
SendDisplayCommand(action string, payload any) error
|
||||
// SendDisplayCommand 下发一条大屏指令。targets 为空表示广播给所有大屏（公告靠它），
|
||||
// 否则只发给这些实例 id（GET /api/display/instances 里的 id），并返回命中的实例数。
|
||||
SendDisplayCommand(action string, payload any, targets []string) (matched int, err error)
|
||||
}
|
||||
|
||||
// Options 是构建路由所需的依赖。
|
||||
|
||||
Reference in new issue
Block a user