fix(display,entry): 修大屏团体名次显示「-」与分项成绩第 3 栏缺第 1 名；发布改弹窗选口径；会话设备名与重命名；录分搜索框；版本 dev_0.5.15
本批七项（三处是现场报的 bug，四处是新功能）： ① 大屏上「纯团体项目」（如团体 4x100 接力）的名次全是「-」 根因不在算分：纯团体名次只落在 channel_ranks，而 results.rank 被有意收窄成 「个人名次」、对团体主体一直是 NULL；大屏的两个读者只读 results.rank、没有兜底 （导出件与积分明细下钻早就有兜底，所以当时是「导出有、屏幕没有」）。 改成读侧回落：results.rank 优先、为空时用通道名次。算分与写回一行未动。 ⚠️ 优先级的理由：只更新名次的发布只更新 results.rank、不重建通道名次， 若通道名次优先，个人项目会在那种发布之后显示旧名次。 ⚠️ 已发布的数据不需要重发或重算，升级后大屏下一次刷新即显示。 ⚠️ 仍未覆盖：只在「团体名次」卡片里按单位录名次、成绩行上没填的那类（无成绩行可挂）。 ② 分项成绩页第 3 栏看不到第 1 名 根因：快照 latestResults 的窗口原来按「行」截断（LIMIT 20），而屏上是一组一栏， 切口只能落在最旧那一栏（通常是第 3 栏）内部，把该组建号最早的行挤掉 （手录项目从第 1 名往下录 → 第 1 名建号最早）。 改成「最近 8 组 × 每组 10 行」（先按每组最新发布时间取 8 组，再每组按名次取前 10 行）； 组的 publishedAt 改为组内最新一条。底栏「最新完成项目」一起吃这个修复。 ⚠️ 取舍：单组超过 10 行的部分不再下发（前端每栏只画 6 行、实时赛况上限 10 行）； 将来把每栏行数上限调到 10 以上时，必须同步调这里的 R。 ③ 录分列表「运动员 / 队」列可限宽 + 逐行展开收起 多人团体名单以前把整列撑宽。收起限宽 14em（省略号）、超过 24 个显示宽度 （中文算 2）出现「展开 / 收起」；个人项目不出现按钮；展开状态只在本机内存。 取舍：展开那一行会把列略微撑宽（成绩列右移约 80px），收起即恢复。 ④ 录入页「以决赛成绩发布」从常驻勾选框改成发布弹窗里二选一 默认「只更新名次（不计分、不发奖牌）」；每次打开都复位、不吃上一次； Alt+Enter 走同一个入口；取消 = 什么都不发生。 审核页保持原样的常驻勾选框（两个页面口径一样、形态不同）。 ⑤ 大屏控制页「在线大屏」列表：可读设备名 + 手动重命名 + 修重复条目 - 自动设备标签（系统 · 浏览器 · 分辨率 · 手机/平板/桌面），由大屏端在握手时上报， 服务端截断到 80/300 字符并清掉控制字符；老客户端不报时列表与升级前逐字一致。 ⚠️ 浏览器没有读主机名/设备名的 API，自动标签只是辅助区分。 - 手动重命名（录入员及以上，与切页同档）：存在系统库 settings 的 display.instance_aliases（机器级、重启与切赛事都不丢），清除即回到自动标签； 显示优先级 alias → device → id（id 降级成小字）。上限 200 条，满了拒绝新增并提示， 不静默顶掉别的设备。设备离线过久条目被清理后别名仍留着。 - 修：以前给局域网设备切页后列表底部会多出一条该设备的离线条目 （翻页会补发握手，而浏览器没有稳定 id、服务端每次新开一条实例）。 现在浏览器本机记住实例 id（localStorage），服务端也复用同一条连接已有的 id。 ⑥ 局域网地址条目都能出二维码 以前只有第一条常驻出码；现在其余每条多一个「二维码」按钮：点一下临时显示， 再点一次 / Esc / 点空白处收起，同一时刻只留一个，且只为当前打开的那条懒生成 SVG （不在渲染时为每条地址都算一遍）。第一条的常驻码与「复制链接」未变。 ⑦ 录分列表加「搜姓名 / 号码布」搜索框（人多项目找人不费劲） 复用既有的「姓名 / 工号 / 号码布」匹配口径（未新增第三份），支持模糊、大小写不敏感、 全角空格、号码布数字口径（007 搜 7、7 搜 007）；命中高亮；提示「找到 N 条 / 共 M 条」； × / Esc / 清除三种清空方式；搜不到给明确空状态。 ⚠️ 搜索只影响表格显示：发布范围、进度条（仍是该批次总人数）、勾选、清空范围、 预览算分一律不受影响，界面上也写明了这一点。 ⚠️ 搜索状态下粘贴跟随「屏幕上看到的顺序」（隐藏的行不会被写到）——避免第二条成绩 静默写到看不见的人身上。 测试：四套自检 ×2 全绿（finalcheck_0515*.log：前端 1096 例 / Console 96 例 / 服务端 14 条 ok， EXIT=0）。①②都做了红/绿对照（改回旧实现，新用例当场变红；②的失败信息即现场形状 「第 3 栏应从第 1 名开始，实际名次 [5 6 7 8]」）。⑥⑦用真浏览器（playwright + chromium） 实机跑过（24 项 / 29 项全过，含「进度条数字不变」「搜索框里按 Alt+Enter 什么也不发生」）。 无数据库迁移；已有成绩、名次、积分与榜单不变。 文档：《升级说明》新增 dev_0.5.15；《使用手册》发布/录入/大屏控制三块与批量订正过期说法； 《常见问题》新增 Q105–Q107；《部署指南》《上线检查清单》同步； devdocs/05（hello 新字段 + 别名接口）、13（第五十五轮）、16/06/07/18 与两处前端注释的旧窗口说法一并订正。
This commit is contained in:
AskaEth committed
1 parent
ee19b92182
commit
56ed90ff8b
53 files changed
+5675
-221
No files matched your search
@@ -551,6 +551,11 @@ func loadEventRowsWithMembers(db *sql.DB, eventID, categoryID int64, includeDraf
|
||||
// channel_ranks 是发布 / 重算才重建的派生数据，还没有它时（老库刚升级、只排名不计分项目的合成通道
|
||||
// 落不了库）回落到 results.rank，保持名次列不空白。
|
||||
//
|
||||
// ⚠️ 这段子查询与 realtime/snapshot.go 的 mainChannelRankJoin、httpapi/live_events.go 的同名常量
|
||||
// 同源（大屏两个读者），改一处要改三处。优先级**故意不同**：导出这里是 cr 优先（既有口径，
|
||||
// 由 TestEventRowsUseMainChannelRank 钉住），大屏那边是 results.rank 优先——「只更新名次」的发布
|
||||
// 只写 results.rank、不重建 channel_ranks，大屏 cr 一优先就会显示上一次的旧名次。
|
||||
//
|
||||
// 关联用「cr.id = 该报名在该通道下的最小 id」而不是直接按 (通道, 报名, 组别) JOIN：
|
||||
// 团体报名挂上队员之后（devdocs/20），一条报名在同一通道下有 1 + N 行名次（报名项自己那份
|
||||
// 加每个队员一份个人副本），直接 JOIN 会把这条报名在成绩表里印 N+1 遍。
|
||||
|
||||
@@ -0,0 +1,706 @@
|
||||
package httpapi_test
|
||||
|
||||
import (
|
||||
"context"
|
||||
"database/sql"
|
||||
"encoding/json"
|
||||
"fmt"
|
||||
"io"
|
||||
"log/slog"
|
||||
"net/http"
|
||||
"net/http/httptest"
|
||||
"strings"
|
||||
"sync"
|
||||
"testing"
|
||||
"time"
|
||||
|
||||
"github.com/coder/websocket"
|
||||
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/httpapi"
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/realtime"
|
||||
)
|
||||
|
||||
// ---------- 别名用例的实时层替身 ----------
|
||||
//
|
||||
// 不用 review_fixes_test.go 里那个 fakeRealtime：这些用例要在两次请求**之间**改写实例列表
|
||||
// （模拟「那台设备被 TTL 清理掉了」），而它的 instances 字段没有并发保护。这里给列表加锁，
|
||||
// 写入与读取之间才有确定的同步关系。
|
||||
type aliasFakeRealtime struct {
|
||||
mu sync.Mutex
|
||||
instances []realtime.Instance
|
||||
}
|
||||
|
||||
func (f *aliasFakeRealtime) Broadcast(changes []realtime.Change) {}
|
||||
|
||||
func (f *aliasFakeRealtime) LoadChanges(ctx context.Context, sinceVersion int64, limit int) ([]realtime.Change, error) {
|
||||
return nil, nil
|
||||
}
|
||||
|
||||
func (f *aliasFakeRealtime) Instances() []realtime.Instance {
|
||||
f.mu.Lock()
|
||||
defer f.mu.Unlock()
|
||||
return append([]realtime.Instance(nil), f.instances...)
|
||||
}
|
||||
|
||||
// set 整批替换实例列表（用例在请求之间调用）。
|
||||
func (f *aliasFakeRealtime) set(list ...realtime.Instance) {
|
||||
f.mu.Lock()
|
||||
defer f.mu.Unlock()
|
||||
f.instances = list
|
||||
}
|
||||
|
||||
// aliasRef 是别名用例专用的测试环境：recorder / admin 两个账号已建好。
|
||||
type aliasRef struct {
|
||||
env *testEnv
|
||||
fake *aliasFakeRealtime
|
||||
}
|
||||
|
||||
func newAliasEnv(t *testing.T) *aliasRef {
|
||||
t.Helper()
|
||||
fake := &aliasFakeRealtime{}
|
||||
env := newTestEnvWith(t, func(o *httpapi.Options) { o.Realtime = fake })
|
||||
env.createUser("recorder", "recorder-pass", "recorder")
|
||||
env.createUser("boss", "boss-pass", "admin")
|
||||
return &aliasRef{env: env, fake: fake}
|
||||
}
|
||||
|
||||
func (r *aliasRef) login(t *testing.T, username, password string) *http.Client {
|
||||
t.Helper()
|
||||
client, _ := r.env.client()
|
||||
r.env.login(client, username, password)
|
||||
return client
|
||||
}
|
||||
|
||||
// putAlias 打一次改名接口。
|
||||
func (r *aliasRef) putAlias(t *testing.T, client *http.Client, id, alias string) (int, envelope) {
|
||||
t.Helper()
|
||||
return r.env.do(client, http.MethodPut,
|
||||
"/api/display/instances/"+id+"/alias", map[string]any{"alias": alias}, true)
|
||||
}
|
||||
|
||||
// rawAliasSetting 直接读系统库里的原始设置值（绕开接口，验证「真的落盘了」）。
|
||||
func rawAliasSetting(t *testing.T, db *sql.DB) string {
|
||||
t.Helper()
|
||||
var raw string
|
||||
err := db.QueryRow(`SELECT value FROM settings WHERE key = 'display.instance_aliases'`).Scan(&raw)
|
||||
if err == sql.ErrNoRows {
|
||||
return ""
|
||||
}
|
||||
if err != nil {
|
||||
t.Fatalf("读取别名设置: %v", err)
|
||||
}
|
||||
return raw
|
||||
}
|
||||
|
||||
// ---------- 设置 / 覆盖 / 清除 ----------
|
||||
|
||||
func TestDisplayAliasSetReturnsInstance(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{
|
||||
ID: "browser-1", Online: true, Page: "standings",
|
||||
Device: "安卓 13 · Chrome 120 · 手机", DeviceRaw: "Mozilla/5.0 (Linux; Android 13)",
|
||||
})
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
|
||||
status, env := r.putAlias(t, client, "browser-1", "二号楼平板")
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("改名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
got := decodeData[map[string]any](t, env)
|
||||
if got["id"] != "browser-1" || got["alias"] != "二号楼平板" {
|
||||
t.Fatalf("响应应是该实例的最新记录（含新别名）: %+v", got)
|
||||
}
|
||||
// 设备字段与老字段一并返回：形状与列表元素一致。
|
||||
if got["device"] != "安卓 13 · Chrome 120 · 手机" || got["deviceRaw"] != "Mozilla/5.0 (Linux; Android 13)" {
|
||||
t.Fatalf("响应应带上设备字段: %+v", got)
|
||||
}
|
||||
for _, key := range []string{"online", "lastHeartbeat", "connectedAt", "ackVersion", "slow", "screen"} {
|
||||
if _, ok := got[key]; !ok {
|
||||
t.Fatalf("响应缺少老字段 %s: %+v", key, got)
|
||||
}
|
||||
}
|
||||
|
||||
// 列表里也看得到：别名是列表这一层与实例合并的。
|
||||
list := decodeData[[]map[string]any](t, mustDo(t, r.env, client, http.MethodGet, "/api/display/instances"))
|
||||
if len(list) != 1 || list[0]["alias"] != "二号楼平板" {
|
||||
t.Fatalf("列表应带别名: %+v", list)
|
||||
}
|
||||
}
|
||||
|
||||
func TestDisplayAliasOverwriteAndTrim(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{ID: "browser-1", Online: true})
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
|
||||
// 粘贴来的名字几乎都带首尾空白，服务端统一 trim 后再存。
|
||||
if status, env := r.putAlias(t, client, "browser-1", " 二号楼平板 "); status != http.StatusOK {
|
||||
t.Fatalf("首次改名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
if status, env := r.putAlias(t, client, "browser-1", "三楼平板"); status != http.StatusOK {
|
||||
t.Fatalf("覆盖改名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
if got := decodeData[[]map[string]any](t, mustDo(t, r.env, client, http.MethodGet, "/api/display/instances")); len(got) != 1 || got[0]["alias"] != "三楼平板" {
|
||||
t.Fatalf("列表应只剩最新别名: %+v", got)
|
||||
}
|
||||
|
||||
var stored map[string]string
|
||||
if err := json.Unmarshal([]byte(rawAliasSetting(t, r.env.sys)), &stored); err != nil {
|
||||
t.Fatalf("别名设置应是 JSON 映射: %v", err)
|
||||
}
|
||||
if len(stored) != 1 || stored["browser-1"] != "三楼平板" {
|
||||
t.Fatalf("覆盖后映射里应只剩最新别名: %+v", stored)
|
||||
}
|
||||
}
|
||||
|
||||
// 清除别名必须真把这条从映射里删掉（不是存空串），否则映射只会一路涨。
|
||||
func TestDisplayAliasClearRemovesEntry(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{ID: "browser-1", Online: true}, realtime.Instance{ID: "browser-2", Online: true})
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
|
||||
if status, _ := r.putAlias(t, client, "browser-1", "二号楼平板"); status != http.StatusOK {
|
||||
t.Fatalf("首次改名应 200，得到 %d", status)
|
||||
}
|
||||
if status, _ := r.putAlias(t, client, "browser-2", "三楼平板"); status != http.StatusOK {
|
||||
t.Fatalf("另一台改名应 200，得到 %d", status)
|
||||
}
|
||||
|
||||
// 只空白 = 清除（与前端同口径）。
|
||||
status, env := r.putAlias(t, client, "browser-1", " ")
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("清除别名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
got := decodeData[map[string]any](t, env)
|
||||
if _, ok := got["alias"]; ok {
|
||||
t.Fatalf("清除后响应里不该再有 alias 键（omitempty）: %+v", got)
|
||||
}
|
||||
|
||||
var stored map[string]string
|
||||
if err := json.Unmarshal([]byte(rawAliasSetting(t, r.env.sys)), &stored); err != nil {
|
||||
t.Fatalf("别名设置应是 JSON 映射: %v", err)
|
||||
}
|
||||
if _, ok := stored["browser-1"]; ok {
|
||||
t.Fatalf("清除后映射里不该还留着这一条: %+v", stored)
|
||||
}
|
||||
if stored["browser-2"] != "三楼平板" {
|
||||
t.Fatalf("别的设备的别名不该被连带清掉: %+v", stored)
|
||||
}
|
||||
|
||||
list := decodeData[[]map[string]any](t, mustDo(t, r.env, client, http.MethodGet, "/api/display/instances"))
|
||||
for _, item := range list {
|
||||
if item["id"] == "browser-1" {
|
||||
if _, ok := item["alias"]; ok {
|
||||
t.Fatalf("清除别名后列表应回到自动标签: %+v", item)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 落盘：换连接 + 换服务端都还在 ----------
|
||||
|
||||
func TestDisplayAliasSurvivesServerRestart(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{
|
||||
ID: "browser-1", Online: true, Device: "安卓 13 · 手机",
|
||||
})
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
if status, env := r.putAlias(t, client, "browser-1", "二号楼平板"); status != http.StatusOK {
|
||||
t.Fatalf("改名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
|
||||
// 1) 换一条全新的系统库连接读（绕开任何进程内状态）：别名在库里。
|
||||
path := sysDBPath(t, r.env.sys)
|
||||
fresh, err := sql.Open("sqlite", "file:"+path+"?_pragma=busy_timeout(5000)")
|
||||
if err != nil {
|
||||
t.Fatalf("重新打开系统库: %v", err)
|
||||
}
|
||||
defer func() { _ = fresh.Close() }()
|
||||
var stored map[string]string
|
||||
if err := json.Unmarshal([]byte(rawAliasSetting(t, fresh)), &stored); err != nil {
|
||||
t.Fatalf("重开系统库后别名设置应是 JSON 映射: %v", err)
|
||||
}
|
||||
if stored["browser-1"] != "二号楼平板" {
|
||||
t.Fatalf("重开系统库后别名应还在: %+v", stored)
|
||||
}
|
||||
|
||||
// 2) 再起一个全新的服务端（新的 handler、新的实时层替身），同一份系统库 / 赛事库。
|
||||
logger := slog.New(slog.NewTextHandler(io.Discard, nil))
|
||||
restarted := &aliasFakeRealtime{}
|
||||
restarted.set(realtime.Instance{ID: "browser-1", Online: true, Device: "安卓 13 · 手机"})
|
||||
srv := httptest.NewServer(httpapi.New(httpapi.Options{
|
||||
Logger: logger,
|
||||
Version: "test",
|
||||
System: r.env.sys,
|
||||
Event: r.env.ev,
|
||||
Auth: r.env.auth,
|
||||
DataDir: t.TempDir(),
|
||||
Realtime: restarted,
|
||||
}))
|
||||
defer srv.Close()
|
||||
|
||||
restartEnv := &testEnv{t: t, server: srv, sys: r.env.sys, ev: r.env.ev, auth: r.env.auth}
|
||||
restartClient, _ := restartEnv.client()
|
||||
restartEnv.login(restartClient, "recorder", "recorder-pass")
|
||||
list := decodeData[[]map[string]any](t, mustDo(t, restartEnv, restartClient, http.MethodGet, "/api/display/instances"))
|
||||
if len(list) != 1 || list[0]["alias"] != "二号楼平板" {
|
||||
t.Fatalf("重开服务端后列表里应仍有别名: %+v", list)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 实例过期后别名留着 ----------
|
||||
|
||||
func TestDisplayAliasKeptAfterInstancePruned(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{ID: "browser-1", Online: true})
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
if status, env := r.putAlias(t, client, "browser-1", "二号楼平板"); status != http.StatusOK {
|
||||
t.Fatalf("改名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
|
||||
// 实例被 TTL 清理（注册表里没有它了）：列表里当然没有条目，别名也不能跟着被删。
|
||||
r.fake.set()
|
||||
if list := decodeData[[]map[string]any](t, mustDo(t, r.env, client, http.MethodGet, "/api/display/instances")); len(list) != 0 {
|
||||
t.Fatalf("实例被清理后列表应为空: %+v", list)
|
||||
}
|
||||
if status, env := r.putAlias(t, client, "browser-1", "x"); status != http.StatusNotFound {
|
||||
t.Fatalf("给已不在注册表里的实例改名应 404，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
var stored map[string]string
|
||||
if err := json.Unmarshal([]byte(rawAliasSetting(t, r.env.sys)), &stored); err != nil {
|
||||
t.Fatalf("别名设置应是 JSON 映射: %v", err)
|
||||
}
|
||||
if stored["browser-1"] != "二号楼平板" {
|
||||
t.Fatalf("实例被清理不该牵连别名: %+v", stored)
|
||||
}
|
||||
|
||||
// 那台设备再连上来：同一个实例 id，别名自动认回来。
|
||||
r.fake.set(realtime.Instance{ID: "browser-1", Online: true, Device: "安卓 13 · 手机"})
|
||||
list := decodeData[[]map[string]any](t, mustDo(t, r.env, client, http.MethodGet, "/api/display/instances"))
|
||||
if len(list) != 1 || list[0]["alias"] != "二号楼平板" {
|
||||
t.Fatalf("设备重连后应自动认回别名: %+v", list)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 权限 ----------
|
||||
|
||||
// 权限与大屏切页同档（recorder）：未登录与切页接口得到同一个状态码，录入员能改名、管理员同样能。
|
||||
func TestDisplayAliasPermissionMatchesDisplayCommand(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{ID: "browser-1", Online: true})
|
||||
|
||||
anon, _ := r.env.client()
|
||||
// 未登录请求不带 CSRF（中间件对 guest 请求直接放行，由 RequireWrite 判权限）。
|
||||
aliasStatus, aliasEnv := r.env.do(anon, http.MethodPut,
|
||||
"/api/display/instances/browser-1/alias", map[string]any{"alias": "x"}, false)
|
||||
cmdStatus, _ := r.env.do(anon, http.MethodPost, "/api/display/command",
|
||||
map[string]any{"action": "goto", "payload": map[string]any{"page": "standings"}}, false)
|
||||
if aliasStatus != cmdStatus {
|
||||
t.Fatalf("改名与大屏切页应同档：匿名访客改名 %d，切页 %d", aliasStatus, cmdStatus)
|
||||
}
|
||||
if aliasStatus != http.StatusUnauthorized {
|
||||
t.Fatalf("匿名访客应被挡下（写接口未登录一律 401），得到 %d %+v", aliasStatus, aliasEnv.Error)
|
||||
}
|
||||
|
||||
recorder := r.login(t, "recorder", "recorder-pass")
|
||||
if status, env := r.putAlias(t, recorder, "browser-1", "二号楼平板"); status != http.StatusOK {
|
||||
t.Fatalf("录入员改名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
|
||||
boss := r.login(t, "boss", "boss-pass")
|
||||
if status, env := r.putAlias(t, boss, "browser-1", "一号楼大屏"); status != http.StatusOK {
|
||||
t.Fatalf("管理员改名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 404 / 超长 / 超量 ----------
|
||||
|
||||
// 实例 id 走路径，前端会先 encodeURIComponent：服务端必须按**解码后**的 id 去认实例。
|
||||
func TestDisplayAliasAcceptsURLEncodedID(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{ID: "browser 1", Online: true})
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
|
||||
status, env := r.env.do(client, http.MethodPut,
|
||||
"/api/display/instances/browser%201/alias", map[string]any{"alias": "二号楼平板"}, true)
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("URL 编码的实例 id 应能认出来，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
var stored map[string]string
|
||||
if err := json.Unmarshal([]byte(rawAliasSetting(t, r.env.sys)), &stored); err != nil {
|
||||
t.Fatalf("别名设置应是 JSON 映射: %v", err)
|
||||
}
|
||||
if stored["browser 1"] != "二号楼平板" {
|
||||
t.Fatalf("别名应按解码后的 id 存: %+v", stored)
|
||||
}
|
||||
}
|
||||
|
||||
func TestDisplayAliasUnknownInstanceNotFound(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{ID: "browser-1", Online: true})
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
|
||||
status, env := r.putAlias(t, client, "gone-1", "二号楼平板")
|
||||
if status != http.StatusNotFound {
|
||||
t.Fatalf("给不存在的实例改名应 404，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
if env.Error == nil || !strings.Contains(env.Error.Message, "离线") {
|
||||
t.Fatalf("404 提示里应说清「可能已经离线久了」: %+v", env.Error)
|
||||
}
|
||||
// 失败的请求不该留下任何东西。
|
||||
if got := rawAliasSetting(t, r.env.sys); strings.Contains(got, "gone-1") {
|
||||
t.Fatalf("404 不该写库: %s", got)
|
||||
}
|
||||
}
|
||||
|
||||
func TestDisplayAliasLengthLimit(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{ID: "browser-1", Online: true})
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
|
||||
// 上限按**字符**算：40 个汉字正好合法（按字节算早就超了）。
|
||||
if status, env := r.putAlias(t, client, "browser-1", strings.Repeat("平", 40)); status != http.StatusOK {
|
||||
t.Fatalf("40 个字符的别名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
status, env := r.putAlias(t, client, "browser-1", strings.Repeat("平", 41))
|
||||
if status != http.StatusBadRequest {
|
||||
t.Fatalf("超长别名应 400，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
if env.Error == nil || !strings.Contains(env.Error.Message, "40") {
|
||||
t.Fatalf("超长提示应说清上限: %+v", env.Error)
|
||||
}
|
||||
// 被拒绝的请求不该改动已存的值。
|
||||
var stored map[string]string
|
||||
if err := json.Unmarshal([]byte(rawAliasSetting(t, r.env.sys)), &stored); err != nil {
|
||||
t.Fatalf("别名设置应是 JSON 映射: %v", err)
|
||||
}
|
||||
if stored["browser-1"] != strings.Repeat("平", 40) {
|
||||
t.Fatalf("超长请求不该覆盖已存别名: %+v", stored)
|
||||
}
|
||||
|
||||
// 带控制字符的别名同样要清干净再存（否则列表排版会被搞乱）。
|
||||
if status, _ := r.putAlias(t, client, "browser-1", "二号楼\n平板\t"); status != http.StatusOK {
|
||||
t.Fatalf("带控制字符的别名应 200，得到 %d", status)
|
||||
}
|
||||
if err := json.Unmarshal([]byte(rawAliasSetting(t, r.env.sys)), &stored); err != nil {
|
||||
t.Fatalf("别名设置应是 JSON 映射: %v", err)
|
||||
}
|
||||
if stored["browser-1"] != "二号楼平板" {
|
||||
t.Fatalf("别名里的控制字符应被清掉: %q", stored["browser-1"])
|
||||
}
|
||||
}
|
||||
|
||||
func TestDisplayAliasCapacityLimit(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{ID: "new-dev", Online: true}, realtime.Instance{ID: "dev-0", Online: true})
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
|
||||
// 直接种满 200 条（逐条打接口太慢，这里要验的是上限判定本身）。
|
||||
seed := make(map[string]string, 200)
|
||||
for i := 0; i < 200; i++ {
|
||||
seed[fmt.Sprintf("dev-%d", i)] = fmt.Sprintf("设备 %d", i)
|
||||
}
|
||||
raw, err := json.Marshal(seed)
|
||||
if err != nil {
|
||||
t.Fatalf("构造种入数据: %v", err)
|
||||
}
|
||||
r.env.execSys(t, `INSERT INTO settings (key, value, updated_at) VALUES ('display.instance_aliases', ?, datetime('now'))`,
|
||||
string(raw))
|
||||
|
||||
status, env := r.putAlias(t, client, "new-dev", "二号楼平板")
|
||||
if status != http.StatusConflict {
|
||||
t.Fatalf("映射已满时新增应 409，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
if env.Error == nil || !strings.Contains(env.Error.Message, "清除") {
|
||||
t.Fatalf("拒绝提示应告诉操作员怎么办: %+v", env.Error)
|
||||
}
|
||||
|
||||
// 已存在的条目仍然可以改名（覆盖不涨条数），也可以清除（腾位置）。
|
||||
if status, env := r.putAlias(t, client, "dev-0", "换一个名字"); status != http.StatusOK {
|
||||
t.Fatalf("已存在的条目改名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
if status, env := r.putAlias(t, client, "dev-0", ""); status != http.StatusOK {
|
||||
t.Fatalf("清除应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
if status, env := r.putAlias(t, client, "new-dev", "二号楼平板"); status != http.StatusOK {
|
||||
t.Fatalf("腾出位置后新增应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
}
|
||||
|
||||
// 两个人同时给不同设备改名：一个都不许被另一个覆盖掉（读—改—写必须在同一个事务里）。
|
||||
func TestDisplayAliasConcurrentRenamesKeepAll(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
const n = 8
|
||||
instances := make([]realtime.Instance, 0, n)
|
||||
for i := 0; i < n; i++ {
|
||||
instances = append(instances, realtime.Instance{ID: fmt.Sprintf("browser-%d", i), Online: true})
|
||||
}
|
||||
r.fake.set(instances...)
|
||||
|
||||
// 只登录一次：登录接口有按 IP 的频控，每个 goroutine 各登一次会被 429 挡下。
|
||||
// Cookie jar 自身并发安全，同一个 client 可以并发发起写请求。
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
|
||||
var wg sync.WaitGroup
|
||||
for i := 0; i < n; i++ {
|
||||
wg.Add(1)
|
||||
go func(i int) {
|
||||
defer wg.Done()
|
||||
status, env := r.putAlias(t, client, fmt.Sprintf("browser-%d", i), fmt.Sprintf("设备 %d", i))
|
||||
if status != http.StatusOK {
|
||||
t.Errorf("并发改名应 200，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
}(i)
|
||||
}
|
||||
wg.Wait()
|
||||
|
||||
var stored map[string]string
|
||||
if err := json.Unmarshal([]byte(rawAliasSetting(t, r.env.sys)), &stored); err != nil {
|
||||
t.Fatalf("别名设置应是 JSON 映射: %v", err)
|
||||
}
|
||||
if len(stored) != n {
|
||||
t.Fatalf("并发改名后应保留全部 %d 条，得到 %d 条: %+v", n, len(stored), stored)
|
||||
}
|
||||
for i := 0; i < n; i++ {
|
||||
if stored[fmt.Sprintf("browser-%d", i)] != fmt.Sprintf("设备 %d", i) {
|
||||
t.Fatalf("browser-%d 的别名不对: %+v", i, stored)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 老字段一个不少 / 老客户端不受影响 ----------
|
||||
|
||||
// 三个新字段都是 omitempty：老客户端（不上报设备）的列表元素**形状与升级前逐字一致**，
|
||||
// 管理端不会因为多出空串键而被判成回归；有值时才出现。
|
||||
func TestDisplayInstancesKeepsLegacyShape(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(
|
||||
realtime.Instance{ID: "old-1", Online: true, Page: "standings", Screen: "screen-a", RemoteAddr: "10.0.0.5:1234"},
|
||||
realtime.Instance{ID: "new-1", Online: true, Device: "安卓 13 · 手机", DeviceRaw: "Mozilla/5.0"},
|
||||
)
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
|
||||
raw := mustDo(t, r.env, client, http.MethodGet, "/api/display/instances")
|
||||
var list []map[string]any
|
||||
if err := json.Unmarshal(raw.Data, &list); err != nil {
|
||||
t.Fatalf("解析列表: %v", err)
|
||||
}
|
||||
if len(list) != 2 {
|
||||
t.Fatalf("列表应有两项: %+v", list)
|
||||
}
|
||||
legacyKeys := []string{"id", "online", "lastHeartbeat", "connectedAt", "ackVersion", "slow", "screen"}
|
||||
for _, item := range list {
|
||||
for _, key := range legacyKeys {
|
||||
if _, ok := item[key]; !ok {
|
||||
t.Fatalf("老字段 %s 必须一个不少: %+v", key, item)
|
||||
}
|
||||
}
|
||||
}
|
||||
for _, item := range list {
|
||||
if item["id"] != "old-1" {
|
||||
continue
|
||||
}
|
||||
for _, key := range []string{"device", "deviceRaw", "alias"} {
|
||||
if _, ok := item[key]; ok {
|
||||
t.Fatalf("老客户端（没报设备）不该出现新键 %s: %+v", key, item)
|
||||
}
|
||||
}
|
||||
}
|
||||
for _, item := range list {
|
||||
if item["id"] != "new-1" {
|
||||
continue
|
||||
}
|
||||
if item["device"] != "安卓 13 · 手机" || item["deviceRaw"] != "Mozilla/5.0" {
|
||||
t.Fatalf("报了设备字段的实例应带上它们: %+v", item)
|
||||
}
|
||||
if _, ok := item["alias"]; ok {
|
||||
t.Fatalf("没设过别名时不该出现 alias 键: %+v", item)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 设置值被改坏时（手工改库 / 别的版本写的）列表照常可用，只是退回显示实例 id。
|
||||
func TestDisplayInstancesToleratesCorruptAliasSetting(t *testing.T) {
|
||||
r := newAliasEnv(t)
|
||||
r.fake.set(realtime.Instance{ID: "browser-1", Online: true})
|
||||
client := r.login(t, "recorder", "recorder-pass")
|
||||
|
||||
r.env.execSys(t, `INSERT INTO settings (key, value, updated_at) VALUES ('display.instance_aliases', '不是 JSON', datetime('now'))`)
|
||||
|
||||
status, env := r.env.do(client, http.MethodGet, "/api/display/instances", nil, false)
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("坏设置不该让列表打不开，得到 %d %+v", status, env.Error)
|
||||
}
|
||||
list := decodeData[[]map[string]any](t, env)
|
||||
if len(list) != 1 || list[0]["id"] != "browser-1" {
|
||||
t.Fatalf("列表应照常返回实例: %+v", list)
|
||||
}
|
||||
if _, ok := list[0]["alias"]; ok {
|
||||
t.Fatalf("坏设置下不该有别名: %+v", list[0])
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 端到端：真 Hub + 真 /ws + 真 HTTP ----------
|
||||
|
||||
// 现场原场景：局域网浏览器（URL 没有 instance，hello 不带 instanceId）连上来，
|
||||
// 翻页让前端补发第二条 hello；管理端看到的应当是**一条**带设备标签的实例，且能给它改名。
|
||||
//
|
||||
// 这里不用替身：真的 realtime.Hub、真的 WebSocket、真的 HTTP 链路，只有浏览器那一端是
|
||||
// 测试里手写的帧。
|
||||
func TestDisplayAliasEndToEndWithRealHub(t *testing.T) {
|
||||
var hub *realtime.Hub
|
||||
env := newTestEnvWith(t, func(o *httpapi.Options) {
|
||||
hub = realtime.NewHub(o.Event, o.Logger)
|
||||
o.Realtime = hub
|
||||
o.WS = hub.Handler()
|
||||
})
|
||||
t.Cleanup(func() { _ = hub.Close() })
|
||||
env.createUser("recorder", "recorder-pass", "recorder")
|
||||
|
||||
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
|
||||
defer cancel()
|
||||
wsURL := "ws" + strings.TrimPrefix(env.server.URL, "http") + "/ws"
|
||||
conn, _, err := websocket.Dial(ctx, wsURL, nil)
|
||||
if err != nil {
|
||||
t.Fatalf("连接 /ws: %v", err)
|
||||
}
|
||||
defer func() { _ = conn.CloseNow() }()
|
||||
|
||||
// hello 不带 instanceId / displayKey：局域网浏览器的真实形状。
|
||||
hello := func(page string) {
|
||||
t.Helper()
|
||||
msg, err := json.Marshal(map[string]any{
|
||||
"event": "hello",
|
||||
"data": map[string]any{
|
||||
"role": "display",
|
||||
"page": page,
|
||||
"device": "安卓 13 · Chrome 120 · 1080×2400 @3x · 手机",
|
||||
"deviceRaw": "Mozilla/5.0 (Linux; Android 13) Chrome/120.0.0.0 Mobile Safari/537.36",
|
||||
},
|
||||
})
|
||||
if err != nil {
|
||||
t.Fatalf("编码 hello: %v", err)
|
||||
}
|
||||
if err := conn.Write(ctx, websocket.MessageText, msg); err != nil {
|
||||
t.Fatalf("发送 hello: %v", err)
|
||||
}
|
||||
}
|
||||
|
||||
client := func() *http.Client {
|
||||
t.Helper()
|
||||
c, _ := env.client()
|
||||
env.login(c, "recorder", "recorder-pass")
|
||||
return c
|
||||
}
|
||||
admin := client()
|
||||
|
||||
list := func() []map[string]any {
|
||||
t.Helper()
|
||||
return decodeData[[]map[string]any](t, mustDo(t, env, admin, http.MethodGet, "/api/display/instances"))
|
||||
}
|
||||
waitList := func(what string, cond func([]map[string]any) bool) []map[string]any {
|
||||
t.Helper()
|
||||
deadline := time.Now().Add(5 * time.Second)
|
||||
var last []map[string]any
|
||||
for time.Now().Before(deadline) {
|
||||
last = list()
|
||||
if cond(last) {
|
||||
return last
|
||||
}
|
||||
time.Sleep(20 * time.Millisecond)
|
||||
}
|
||||
t.Fatalf("等待「%s」超时，最后的列表: %+v", what, last)
|
||||
return nil
|
||||
}
|
||||
|
||||
hello("standings")
|
||||
first := waitList("第一条 hello 被登记", func(l []map[string]any) bool {
|
||||
return len(l) == 1 && l[0]["page"] == "standings"
|
||||
})
|
||||
id, _ := first[0]["id"].(string)
|
||||
if !strings.HasPrefix(id, "display-") {
|
||||
t.Fatalf("不带 instanceId 时实例 id 应由服务端生成，得到 %q", id)
|
||||
}
|
||||
if first[0]["device"] != "安卓 13 · Chrome 120 · 1080×2400 @3x · 手机" {
|
||||
t.Fatalf("列表应带上设备标签: %+v", first[0])
|
||||
}
|
||||
|
||||
// 翻页：前端 setPage 会再发一条同样不带 instanceId 的 hello——这正是那个 bug 的引信。
|
||||
hello("medals")
|
||||
second := waitList("翻页后的 hello 被登记", func(l []map[string]any) bool {
|
||||
return len(l) == 1 && l[0]["page"] == "medals"
|
||||
})
|
||||
if second[0]["id"] != id {
|
||||
t.Fatalf("同一条连接重复 hello 不该换实例：首次 %v，翻页后 %v", id, second[0]["id"])
|
||||
}
|
||||
|
||||
// 改名：返回该实例的最新记录，列表里也立刻带上别名。
|
||||
status, env2 := env.do(admin, http.MethodPut,
|
||||
"/api/display/instances/"+id+"/alias", map[string]any{"alias": "二号楼平板"}, true)
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("改名应 200，得到 %d %+v", status, env2.Error)
|
||||
}
|
||||
if got := decodeData[map[string]any](t, env2); got["alias"] != "二号楼平板" || got["id"] != id {
|
||||
t.Fatalf("改名应返回该实例的最新记录: %+v", got)
|
||||
}
|
||||
after := waitList("别名出现在列表里", func(l []map[string]any) bool {
|
||||
return len(l) == 1 && l[0]["alias"] == "二号楼平板"
|
||||
})
|
||||
if after[0]["device"] == "" {
|
||||
t.Fatalf("别名不该顶掉设备标签（两者各有各的用处）: %+v", after[0])
|
||||
}
|
||||
|
||||
// 清除：回到自动设备标签，注册表里仍然只有这一条。
|
||||
status, env3 := env.do(admin, http.MethodPut,
|
||||
"/api/display/instances/"+id+"/alias", map[string]any{"alias": " "}, true)
|
||||
if status != http.StatusOK {
|
||||
t.Fatalf("清除别名应 200，得到 %d %+v", status, env3.Error)
|
||||
}
|
||||
if _, ok := decodeData[map[string]any](t, env3)["alias"]; ok {
|
||||
t.Fatalf("清除后响应不该再有 alias: %s", env3.Data)
|
||||
}
|
||||
if l := list(); len(l) != 1 || l[0]["device"] == "" {
|
||||
t.Fatalf("清除后应回到自动设备标签且实例仍只有一条: %+v", l)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 小工具 ----------
|
||||
|
||||
// execSys 在系统库上直接执行 SQL：别名的设置在 system.db 的 settings 表里，
|
||||
// 而 testEnv.exec 写的是赛事库（种数据 / 改坏设置这两个场景都要用系统库）。
|
||||
func (e *testEnv) execSys(t *testing.T, query string, args ...any) {
|
||||
t.Helper()
|
||||
if _, err := e.sys.Exec(query, args...); err != nil {
|
||||
t.Fatalf("执行系统库 SQL 失败: %v\n%s", err, query)
|
||||
}
|
||||
}
|
||||
|
||||
func mustDo(t *testing.T, env *testEnv, client *http.Client, method, path string) envelope {
|
||||
t.Helper()
|
||||
status, body := env.do(client, method, path, nil, false)
|
||||
if status != http.StatusOK || !body.OK {
|
||||
t.Fatalf("%s %s 应 200，得到 %d %+v", method, path, status, body.Error)
|
||||
}
|
||||
return body
|
||||
}
|
||||
|
||||
// sysDBPath 取系统库的文件路径：用它另开一条连接读，绕开进程内可能存在的任何缓存。
|
||||
func sysDBPath(t *testing.T, db *sql.DB) string {
|
||||
t.Helper()
|
||||
rows, err := db.Query(`PRAGMA database_list`)
|
||||
if err != nil {
|
||||
t.Fatalf("读取系统库路径: %v", err)
|
||||
}
|
||||
defer func() { _ = rows.Close() }()
|
||||
for rows.Next() {
|
||||
var seq int
|
||||
var name, file string
|
||||
if err := rows.Scan(&seq, &name, &file); err != nil {
|
||||
t.Fatalf("扫描系统库路径: %v", err)
|
||||
}
|
||||
if name == "main" {
|
||||
return file
|
||||
}
|
||||
}
|
||||
t.Fatal("系统库路径为空")
|
||||
return ""
|
||||
}
|
||||
@@ -271,16 +271,45 @@ func (s *server) liveEventsHandler(w http.ResponseWriter, r *http.Request) (any,
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// mainChannelRankJoin 是大屏成绩行上名次列的「主通道 + 通道名次」两段关联，
|
||||
// 与 realtime 侧 snapshot.go 的同名常量逐字一致（那边是 WS 快照的最新成绩，这里是实时赛况），
|
||||
// 两处必须一起改，否则分项成绩页与实时赛况的名次会打架。
|
||||
//
|
||||
// 名次取「主通道」口径（devdocs 17 §11.3）：主通道 = scope=athlete 优先，其次通道 sort_order 小者，
|
||||
// 与 export/load.go 的分项成绩表同一条规则。优先级是 **results.rank 优先、channel_ranks 兜底**
|
||||
// （见下面查询里的 COALESCE(r.rank, cr.rank)），不能照抄导出侧的 cr 优先：results.rank 是这条报名项
|
||||
// 自己的名次，而「只更新名次」的发布（rankOnly，scoring.go）只写 results.rank、不重建 channel_ranks
|
||||
// ——cr 一优先，个人项目在这种发布之后会显示上一次的旧名次。r 为空时才回落到 cr，
|
||||
// 正好补上团体主体名次：团体名次有意不写 results.rank（applyComputedRanks 只认个人主体），
|
||||
// 不回落到 channel_ranks 的话，团体项目发布之后大屏上这一行就是一个「-」。
|
||||
//
|
||||
// 关联用 cr.entry_id = e.id，覆盖 basis=result 的名次（含纯团体项目，subject_key='e:<报名项id>'）。
|
||||
// 覆盖不到聚合 / 团体手工名次：那类 channel_ranks 行的 entry_id / result_id 都是 NULL，
|
||||
// 主体是 t:<单位id> / a:<运动员id>，而这类主体在分项成绩表里本来就没有对应的一行
|
||||
// （导出侧同一段子查询、同一处口径，见 export/load.go 的 loadEventRowsWithMembers）。
|
||||
// 取 MIN(cr2.id) = 报名项自己那一份名次：团体报名挂上队员后同一通道下还有每个队员的个人副本，
|
||||
// 直接按 entry_id JOIN 会把这一行印 N+1 遍（与导出侧同一处理）。
|
||||
const mainChannelRankJoin = `
|
||||
LEFT JOIN event_score_channels mc ON mc.id = (
|
||||
SELECT c2.id FROM event_score_channels c2
|
||||
WHERE c2.event_id = r.event_id
|
||||
ORDER BY CASE WHEN c2.scope = 'athlete' THEN 0 ELSE 1 END, c2.sort_order, c2.id
|
||||
LIMIT 1)
|
||||
LEFT JOIN channel_ranks cr ON cr.id = (
|
||||
SELECT MIN(cr2.id) FROM channel_ranks cr2
|
||||
WHERE cr2.channel_id = mc.id AND cr2.entry_id = e.id AND cr2.category_id = e.category_id)`
|
||||
|
||||
// liveResultGroups 取某个小项已发布的成绩，按「小项 + 组别」聚合成组。
|
||||
//
|
||||
// 与实时层 snapshot.latestResults 的口径一致（排除 withdrawn、组内按名次排序），
|
||||
// 但范围固定在这一个小项、且不设条数上限——当前项目要显示完整名单，不能被 20 条截断。
|
||||
// 与实时层 snapshot.latestResults 的口径一致（排除 withdrawn、组内按名次排序、名次同样是
|
||||
// results.rank 优先 + channel_ranks 兜底），但范围固定在这一个小项、且不设条数上限——
|
||||
// 当前项目要显示完整名单，不能被 20 条截断。
|
||||
func (s *server) liveResultGroups(ctx context.Context, eventID int64) ([]dto.EventResultGroup, error) {
|
||||
rows, err := s.ev.QueryContext(ctx, `
|
||||
SELECT COALESCE(ev.code, ''), COALESCE(ev.name, ''),
|
||||
e.category_id, COALESCE(cat.name, ''),
|
||||
COALESCE(r.verified_at, r.recorded_at, r.updated_at, r.created_at, ''),
|
||||
r.entry_id, r.rank, e.team_id,
|
||||
r.entry_id, COALESCE(r.rank, cr.rank), e.team_id,
|
||||
COALESCE(t.code, ''), COALESCE(t.name, ''), COALESCE(t.short_name, ''), t.logo_path,
|
||||
e.athlete_id, COALESCE(a.name, ''), COALESCE(e.member_names, ''),
|
||||
COALESCE(r.result_text, ''), r.result_value, COALESCE(r.unit, ''), r.is_tie, r.status
|
||||
@@ -289,7 +318,7 @@ func (s *server) liveResultGroups(ctx context.Context, eventID int64) ([]dto.Eve
|
||||
JOIN events ev ON ev.id = r.event_id
|
||||
LEFT JOIN event_categories cat ON cat.id = e.category_id
|
||||
LEFT JOIN teams t ON t.id = e.team_id
|
||||
LEFT JOIN athletes a ON a.id = e.athlete_id
|
||||
LEFT JOIN athletes a ON a.id = e.athlete_id`+mainChannelRankJoin+`
|
||||
WHERE r.event_id = ? AND r.state = 'published' AND r.status <> 'withdrawn'
|
||||
ORDER BY COALESCE(r.verified_at, r.recorded_at, r.updated_at, r.created_at) DESC, r.id DESC`, eventID)
|
||||
if err != nil {
|
||||
|
||||
@@ -1,32 +1,42 @@
|
||||
package httpapi_test
|
||||
|
||||
import (
|
||||
"context"
|
||||
"database/sql"
|
||||
"net/http"
|
||||
"strconv"
|
||||
"testing"
|
||||
"time"
|
||||
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/realtime"
|
||||
)
|
||||
|
||||
type liveEventsBody struct {
|
||||
Source string `json:"source"`
|
||||
EventIDs []int64 `json:"eventIds"`
|
||||
Events []struct {
|
||||
Event struct {
|
||||
ID int64 `json:"id"`
|
||||
Name string `json:"name"`
|
||||
} `json:"event"`
|
||||
Reason string `json:"reason"`
|
||||
Groups []struct {
|
||||
EventID int64 `json:"eventId"`
|
||||
CategoryID int64 `json:"categoryId"`
|
||||
CategoryName string
|
||||
Rows []struct {
|
||||
EntryID int64 `json:"entryId"`
|
||||
Rank *int `json:"rank"`
|
||||
ResultText string `json:"resultText"`
|
||||
} `json:"rows"`
|
||||
} `json:"groups"`
|
||||
} `json:"events"`
|
||||
Source string `json:"source"`
|
||||
EventIDs []int64 `json:"eventIds"`
|
||||
Events []liveEventBody `json:"events"`
|
||||
}
|
||||
|
||||
type liveEventBody struct {
|
||||
Event struct {
|
||||
ID int64 `json:"id"`
|
||||
Name string `json:"name"`
|
||||
} `json:"event"`
|
||||
Reason string `json:"reason"`
|
||||
Groups []liveGroupBody `json:"groups"`
|
||||
}
|
||||
|
||||
type liveGroupBody struct {
|
||||
EventID int64 `json:"eventId"`
|
||||
CategoryID int64 `json:"categoryId"`
|
||||
CategoryName string `json:"categoryName"`
|
||||
Rows []liveRowBody `json:"rows"`
|
||||
}
|
||||
|
||||
type liveRowBody struct {
|
||||
EntryID int64 `json:"entryId"`
|
||||
Rank *int `json:"rank"`
|
||||
ResultText string `json:"resultText"`
|
||||
}
|
||||
|
||||
type settingsBody struct {
|
||||
@@ -203,3 +213,154 @@ func TestDisplayLiveEmptyEvent(t *testing.T) {
|
||||
t.Fatalf("未配置时默认 auto，得到 %q", got.Source)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 大屏名次：团体项目回落 channel_ranks / 个人项目仍以 results.rank 为准 ----------
|
||||
|
||||
// latestResultsRank 取 WS 快照 latestResults 里某条报名项的名次——大屏的分项成绩页与底栏读的就是它。
|
||||
func latestResultsRank(t *testing.T, env *testEnv, entryID int64) *int {
|
||||
t.Helper()
|
||||
hub := realtime.NewHub(env.ev, nil)
|
||||
t.Cleanup(func() { _ = hub.Close() })
|
||||
snap, err := hub.Snapshot(context.Background())
|
||||
if err != nil {
|
||||
t.Fatalf("构建快照: %v", err)
|
||||
}
|
||||
for _, group := range snap.LatestResults {
|
||||
for _, row := range group.Rows {
|
||||
if row.EntryID == entryID {
|
||||
return row.Rank
|
||||
}
|
||||
}
|
||||
}
|
||||
t.Fatalf("快照最新成绩里没有报名项 %d 的行：%+v", entryID, snap.LatestResults)
|
||||
return nil
|
||||
}
|
||||
|
||||
// liveRanksForEvent 取实时赛况（GET /api/display/live）里某小项各报名项的名次。
|
||||
// 该小项没被选中时直接失败——这类用例验证的正是它必须出现在大屏上。
|
||||
func liveRanksForEvent(t *testing.T, env *testEnv, eventID int64) map[int64]*int {
|
||||
t.Helper()
|
||||
guest, _ := env.client()
|
||||
status, resp := env.do(guest, http.MethodGet, "/api/display/live", nil, false)
|
||||
if status != http.StatusOK || !resp.OK {
|
||||
t.Fatalf("读取实时赛况应 200，得到 %d %+v", status, resp.Error)
|
||||
}
|
||||
body := decodeData[liveEventsBody](t, resp)
|
||||
for _, ev := range body.Events {
|
||||
if ev.Event.ID != eventID {
|
||||
continue
|
||||
}
|
||||
out := make(map[int64]*int)
|
||||
for _, group := range ev.Groups {
|
||||
for _, row := range group.Rows {
|
||||
out[row.EntryID] = row.Rank
|
||||
}
|
||||
}
|
||||
return out
|
||||
}
|
||||
t.Fatalf("实时赛况里没有小项 %d（已选中 %+v）", eventID, body.EventIDs)
|
||||
return nil
|
||||
}
|
||||
|
||||
// fmtRank 把可空名次转成可读文本：为空就是现场那个「-」。
|
||||
func fmtRank(rank *int) string {
|
||||
if rank == nil {
|
||||
return "空（大屏上就是「-」）"
|
||||
}
|
||||
return strconv.Itoa(*rank)
|
||||
}
|
||||
|
||||
// 现场回归：纯团体小项（event_type=team、通道 scope=team + basis=result，即「按成绩自动排名」的
|
||||
// 团体 4x100 接力）发布之后，大屏上显示该项目名次的地方都必须给出真实名次，不能是「-」。
|
||||
//
|
||||
// 团体名次只落 channel_ranks、results.rank 有意留空（applyComputedRanks 只认个人主体，工单 A-1/A-2），
|
||||
// 所以大屏两个读者都得回落到 channel_ranks：WS 快照的 latestResults（分项成绩页 + 底栏）
|
||||
// 与实时赛况的 liveResultGroups（/api/display/live）。
|
||||
func TestDisplayShowsTeamRankForTeamEvent(t *testing.T) {
|
||||
env, ids, client := recorderWithSeed(t)
|
||||
eventID, categoryID, firstEntry := seedTeamEvent(t, env, ids)
|
||||
// seedTeamEvent 只建了一个单位的报名项，再补一个单位，名次才排得出来。
|
||||
secondEntry := env.insert(t, `INSERT INTO entries (event_id, category_id, team_id, athlete_id, status)
|
||||
VALUES (?, ?, ?, NULL, 'registered')`, eventID, categoryID, ids.teamB)
|
||||
publishResults(t, env, client, eventID, "team-rank",
|
||||
map[string]any{"entryId": firstEntry, "resultValue": 45.20, "resultText": "45.20", "unit": "s", "status": "ok"},
|
||||
map[string]any{"entryId": secondEntry, "resultValue": 46.10, "resultText": "46.10", "unit": "s", "status": "ok"},
|
||||
)
|
||||
|
||||
// 1) 写侧不变：团体名次仍然不写 results.rank。
|
||||
if n := countRows(t, env, `SELECT COUNT(*) FROM results WHERE event_id = ? AND rank IS NOT NULL`, eventID); n != 0 {
|
||||
t.Fatalf("团体名次不该写回 results.rank，得到 %d 行", n)
|
||||
}
|
||||
|
||||
// 2) 名次落在 channel_ranks 上，且 entry_id / result_id 都有值（下钻与导出靠它关联）。
|
||||
var (
|
||||
rank int
|
||||
resultID sql.NullInt64
|
||||
)
|
||||
if err := env.ev.QueryRow(`SELECT rank, result_id FROM channel_ranks
|
||||
WHERE event_id = ? AND category_id = ? AND scope = 'team' AND basis = 'result'
|
||||
AND entry_id = ?`, eventID, categoryID, firstEntry).Scan(&rank, &resultID); err != nil {
|
||||
t.Fatalf("读团体名次: %v", err)
|
||||
}
|
||||
if rank != 1 || !resultID.Valid {
|
||||
t.Fatalf("channel_ranks 应有一行 rank=1 且挂 result_id，得到 rank=%d resultID=%+v", rank, resultID)
|
||||
}
|
||||
|
||||
// 3) / 4) 大屏两个读者都带上名次。
|
||||
for entryID, want := range map[int64]int{firstEntry: 1, secondEntry: 2} {
|
||||
if got := latestResultsRank(t, env, entryID); got == nil || *got != want {
|
||||
t.Fatalf("快照（分项成绩页 + 底栏）里报名项 %d 的名次 = %s，期望 %d", entryID, fmtRank(got), want)
|
||||
}
|
||||
}
|
||||
live := liveRanksForEvent(t, env, eventID)
|
||||
for entryID, want := range map[int64]int{firstEntry: 1, secondEntry: 2} {
|
||||
if got := live[entryID]; got == nil || *got != want {
|
||||
t.Fatalf("实时赛况里报名项 %d 的名次 = %s，期望 %d（完整：%+v）", entryID, fmtRank(got), want, live)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 不回归：个人项目的名次以 results.rank 为准，channel_ranks 只是空值兜底。
|
||||
//
|
||||
// 「只更新名次」的发布（rankOnly）只写 results.rank、不重建 channel_ranks：这里先把决赛计分发布，
|
||||
// 再改成绩按「只更新名次」发布——results.rank 换成新名次，channel_ranks 停在决赛那一版。
|
||||
// 大屏若改成 channel_ranks 优先，这种发布之后就会显示上一次的旧名次。
|
||||
func TestDisplayPrefersResultRankAfterRankOnlyPublish(t *testing.T) {
|
||||
env, ids, client := recorderWithSeed(t)
|
||||
publishResults(t, env, client, ids.event, "rank-pref-final",
|
||||
map[string]any{"entryId": ids.entryA, "resultValue": 11.58, "resultText": "11.58", "unit": "s", "status": "ok"},
|
||||
map[string]any{"entryId": ids.entryB, "resultValue": 11.92, "resultText": "11.92", "unit": "s", "status": "ok"},
|
||||
)
|
||||
assertRanksBothReaders(t, env, ids.event, map[int64]int{ids.entryA: 1, ids.entryB: 2})
|
||||
|
||||
// 改成绩（现场是退回草稿改完再发布），按「只更新名次」发布：名次换位。
|
||||
env.exec(t, `UPDATE results SET result_value = 11.92, result_text = '11.92' WHERE entry_id = ?`, ids.entryA)
|
||||
env.exec(t, `UPDATE results SET result_value = 11.58, result_text = '11.58' WHERE entry_id = ?`, ids.entryB)
|
||||
publishWith(t, env, client, ids.event, "rank-pref-rankonly", rankOnlyTrue)
|
||||
|
||||
// 前提：results.rank 是新名次，channel_ranks 还是旧名次（这种发布不重建它）。
|
||||
if got := resultRank(t, env, ids.entryA); got != 2 {
|
||||
t.Fatalf("只更新名次的发布应把 A 写成第 2 名，得到 %d", got)
|
||||
}
|
||||
if n := countRows(t, env, `SELECT COUNT(*) FROM channel_ranks WHERE event_id = ? AND entry_id = ? AND rank = 1`,
|
||||
ids.event, ids.entryA); n != 1 {
|
||||
t.Fatalf("前提不成立：channel_ranks 应停在旧名次（A 第 1 名），得到 %d 行", n)
|
||||
}
|
||||
|
||||
// 大屏必须跟着 results.rank 走，不能退回 channel_ranks 的旧名次。
|
||||
assertRanksBothReaders(t, env, ids.event, map[int64]int{ids.entryA: 2, ids.entryB: 1})
|
||||
}
|
||||
|
||||
// assertRanksBothReaders 断言一组报名项在大屏两个读者上的名次（快照 + 实时赛况）。
|
||||
func assertRanksBothReaders(t *testing.T, env *testEnv, eventID int64, want map[int64]int) {
|
||||
t.Helper()
|
||||
live := liveRanksForEvent(t, env, eventID)
|
||||
for entryID, rank := range want {
|
||||
if got := latestResultsRank(t, env, entryID); got == nil || *got != rank {
|
||||
t.Fatalf("快照（分项成绩页 + 底栏）里报名项 %d 的名次 = %s，期望 %d", entryID, fmtRank(got), rank)
|
||||
}
|
||||
if got := live[entryID]; got == nil || *got != rank {
|
||||
t.Fatalf("实时赛况里报名项 %d 的名次 = %s，期望 %d（完整：%+v）", entryID, fmtRank(got), rank, live)
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -3,8 +3,13 @@ package httpapi
|
||||
import (
|
||||
"context"
|
||||
"database/sql"
|
||||
"encoding/json"
|
||||
"errors"
|
||||
"fmt"
|
||||
"log/slog"
|
||||
"net/http"
|
||||
"strings"
|
||||
"unicode/utf8"
|
||||
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/realtime"
|
||||
)
|
||||
@@ -16,6 +21,193 @@ type Realtime interface {
|
||||
Instances() []realtime.Instance
|
||||
}
|
||||
|
||||
// ---------- 大屏别名（机器级设置） ----------
|
||||
//
|
||||
// 别名与实例注册表是两套生命周期：
|
||||
// - 实例注册表在**内存**里，连接断开后只留 TTL（十分钟）供排查；
|
||||
// - 别名是操作员给「这台设备」起的名字，必须活过重启、活过实例过期。
|
||||
//
|
||||
// 所以别名存系统库 system.db 的 settings 表（与 PUT /api/system/session 的登录有效期同一套
|
||||
// 读写机制，见 repo_misc.go 的 writeSessionHours），不新建表、不写迁移。
|
||||
const (
|
||||
// instanceAliasKey 下存一个 JSON 映射：{"<instanceId>": "<别名>"}。
|
||||
instanceAliasKey = "display.instance_aliases"
|
||||
// maxInstanceAliases 是映射条数上限：别名会在实例过期后继续留着（下次那台设备连上来
|
||||
// 还认得出），只增不减会一路涨下去，必须有封顶。
|
||||
maxInstanceAliases = 200
|
||||
// maxAliasChars 是单个别名的字符数上限（按字符不是字节，中文名才存得下）。
|
||||
maxAliasChars = 40
|
||||
)
|
||||
|
||||
// displayAliasPatch 是 PUT /api/display/instances/{id}/alias 的请求体。
|
||||
type displayAliasPatch struct {
|
||||
// Alias 为空串或只空白 = 清除别名、回到自动设备标签。
|
||||
Alias string `json:"alias"`
|
||||
RequestID string `json:"requestId"`
|
||||
}
|
||||
|
||||
// displayInstancesHandler 返回在线大屏实例列表（在线看板）。
|
||||
func (s *server) displayInstancesHandler(w http.ResponseWriter, r *http.Request) (any, error) {
|
||||
if s.realtime == nil {
|
||||
return []realtime.Instance{}, nil
|
||||
}
|
||||
list := s.realtime.Instances()
|
||||
if list == nil {
|
||||
list = []realtime.Instance{}
|
||||
}
|
||||
// 别名在这里与实例合并：注册表里只剩在线的与刚离线的，而别名可能属于一台早就
|
||||
// 被清理掉的设备——那种别名留着不填（没有对应实例），等它连上来自然就填上了。
|
||||
aliases, err := s.loadInstanceAliases(r.Context())
|
||||
if err != nil {
|
||||
// 读别名失败不该让「在线大屏」列表整个打不开：现场靠它切页、排查。
|
||||
// 降级成「没有别名」（列表退回显示实例 id）并留下警告，其余字段照常返回。
|
||||
s.logger.Warn("读取大屏别名失败，列表按无别名返回", "err", err)
|
||||
return list, nil
|
||||
}
|
||||
for i := range list {
|
||||
if alias := aliases[list[i].ID]; alias != "" {
|
||||
list[i].Alias = alias
|
||||
}
|
||||
}
|
||||
return list, nil
|
||||
}
|
||||
|
||||
// updateDisplayInstanceAliasHandler 处理 PUT /api/display/instances/{id}/alias：
|
||||
// 给一台设备设 / 清别名，返回该实例的最新记录（形状与列表元素一致，即 Instance DTO）。
|
||||
// 权限与大屏切页同档（recorder 及以上），见 server.go 的路由注册。
|
||||
func (s *server) updateDisplayInstanceAliasHandler(w http.ResponseWriter, r *http.Request) (any, error) {
|
||||
id := strings.TrimSpace(r.PathValue("id"))
|
||||
var in displayAliasPatch
|
||||
if err := decodeJSON(r, &in); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
alias := realtime.CleanUserText(in.Alias)
|
||||
if utf8.RuneCountInString(alias) > maxAliasChars {
|
||||
return nil, badRequest(
|
||||
fmt.Sprintf("别名最长 %d 个字符（当前 %d 个）", maxAliasChars, utf8.RuneCountInString(alias)),
|
||||
nil)
|
||||
}
|
||||
|
||||
inst, ok := s.findDisplayInstance(id)
|
||||
if !ok {
|
||||
return nil, notFound("这台大屏当前不在注册表里：它可能已经离线很久、超过了保留时间。请刷新在线列表后重试。")
|
||||
}
|
||||
|
||||
return nil, s.idempotent(w, r, in.RequestID, func() (any, error) {
|
||||
if err := s.saveInstanceAlias(r.Context(), id, alias); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
s.audit(r.Context(), "display.instance_alias", "display", 0, nil,
|
||||
map[string]any{"instanceId": id, "alias": alias})
|
||||
inst.Alias = alias
|
||||
return inst, nil
|
||||
})
|
||||
}
|
||||
|
||||
// findDisplayInstance 在注册表快照里按 id 找实例；找不到说明它已被清理（或压根没连过）。
|
||||
func (s *server) findDisplayInstance(id string) (realtime.Instance, bool) {
|
||||
if id == "" || s.realtime == nil {
|
||||
return realtime.Instance{}, false
|
||||
}
|
||||
for _, inst := range s.realtime.Instances() {
|
||||
if inst.ID == id {
|
||||
return inst, true
|
||||
}
|
||||
}
|
||||
return realtime.Instance{}, false
|
||||
}
|
||||
|
||||
// loadInstanceAliases 读「实例 id → 别名」映射。
|
||||
//
|
||||
// 存量值可能被手工改过、或是别的版本写的，所以读出来还要过一遍清洗：空 id / 空别名等于
|
||||
// 「没设」，直接丢掉（避免死条目一直占着条数上限），别名本身按同一个口径去控制字符与截断。
|
||||
func (s *server) loadInstanceAliases(ctx context.Context) (map[string]string, error) {
|
||||
return loadInstanceAliasesQ(ctx, s.sys, s.logger)
|
||||
}
|
||||
|
||||
// loadInstanceAliasesQ 与 loadInstanceAliases 相同，但可以在给定连接 / 事务上读：
|
||||
// saveInstanceAlias 要在同一个事务里「先读后写」，否则两个人同时改不同设备时，
|
||||
// 后写的那个会把前一个的改动覆盖掉（两边各自读到旧映射，谁也看不见谁）。
|
||||
func loadInstanceAliasesQ(ctx context.Context, q queryer, logger *slog.Logger) (map[string]string, error) {
|
||||
var raw string
|
||||
err := q.QueryRowContext(ctx, `SELECT value FROM settings WHERE key = ?`, instanceAliasKey).Scan(&raw)
|
||||
switch {
|
||||
case errors.Is(err, sql.ErrNoRows):
|
||||
return map[string]string{}, nil
|
||||
case err != nil:
|
||||
return nil, internal(err)
|
||||
}
|
||||
if strings.TrimSpace(raw) == "" {
|
||||
return map[string]string{}, nil
|
||||
}
|
||||
var stored map[string]string
|
||||
if err := json.Unmarshal([]byte(raw), &stored); err != nil {
|
||||
// 值被改坏时按「没有别名」处理并留下警告：一条脏设置不该把「在线大屏」列表打不开。
|
||||
logger.Warn("大屏别名设置不是合法 JSON，按无别名处理", "key", instanceAliasKey, "err", err)
|
||||
return map[string]string{}, nil
|
||||
}
|
||||
out := make(map[string]string, len(stored))
|
||||
for id, alias := range stored {
|
||||
id = strings.TrimSpace(id)
|
||||
alias = realtime.TruncateChars(realtime.CleanUserText(alias), maxAliasChars)
|
||||
if id == "" || alias == "" {
|
||||
continue
|
||||
}
|
||||
out[id] = alias
|
||||
}
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// saveInstanceAlias 写入 / 清除一个实例的别名。
|
||||
//
|
||||
// 清除是真的把那条**删掉**（不是存空串）：实例过期后别名会一直留着，只增不减的映射会一路
|
||||
// 顶到 maxInstanceAliases，之后所有设备都改不了名。
|
||||
//
|
||||
// 超过条数上限时**拒绝**而不是淘汰最旧的：别名是按 id 存的、没有时间戳，淘汰谁都是猜；
|
||||
// 而悄悄弄丢一台设备的命名比让操作员先清几条更难查。拒绝会带中文提示（409）。
|
||||
func (s *server) saveInstanceAlias(ctx context.Context, id, alias string) error {
|
||||
// 读—改—写必须在一个事务里（系统库只有一条连接，事务把并发改名串起来）。
|
||||
tx, err := s.sys.BeginTx(ctx, nil)
|
||||
if err != nil {
|
||||
return internal(err)
|
||||
}
|
||||
defer func() { _ = tx.Rollback() }()
|
||||
|
||||
aliases, err := loadInstanceAliasesQ(ctx, tx, s.logger)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if alias == "" {
|
||||
if _, ok := aliases[id]; !ok {
|
||||
return nil // 本来就没有别名：不必写库
|
||||
}
|
||||
delete(aliases, id)
|
||||
} else {
|
||||
if _, exists := aliases[id]; !exists && len(aliases) >= maxInstanceAliases {
|
||||
s.logger.Warn("大屏别名数量已达上限，拒绝新增",
|
||||
"max", maxInstanceAliases, "instanceId", id)
|
||||
return conflict(fmt.Sprintf(
|
||||
"大屏别名最多 %d 条，已经存满。请先给不再使用的设备清除别名后重试。", maxInstanceAliases))
|
||||
}
|
||||
aliases[id] = alias
|
||||
}
|
||||
|
||||
raw, err := json.Marshal(aliases)
|
||||
if err != nil {
|
||||
return internal(err)
|
||||
}
|
||||
if _, err := tx.ExecContext(ctx,
|
||||
`INSERT INTO settings (key, value, updated_at) VALUES (?, ?, datetime('now'))
|
||||
ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = datetime('now')`,
|
||||
instanceAliasKey, string(raw)); err != nil {
|
||||
return internal(err)
|
||||
}
|
||||
if err := tx.Commit(); err != nil {
|
||||
return internal(err)
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// broadcastChanges 在写请求成功返回后，把本次请求写入 change_log 的变更推给实时层。
|
||||
// 版本号取请求开始时的最大 id，因此只推送本次写入，不会重复补发历史变更。
|
||||
func (s *server) broadcastChanges(next http.Handler) http.Handler {
|
||||
@@ -121,15 +313,3 @@ func (w *statusRecorder) Write(b []byte) (int, error) {
|
||||
}
|
||||
return w.ResponseWriter.Write(b)
|
||||
}
|
||||
|
||||
// displayInstancesHandler 返回在线大屏实例列表（在线看板）。
|
||||
func (s *server) displayInstancesHandler(w http.ResponseWriter, r *http.Request) (any, error) {
|
||||
if s.realtime == nil {
|
||||
return []realtime.Instance{}, nil
|
||||
}
|
||||
list := s.realtime.Instances()
|
||||
if list == nil {
|
||||
list = []realtime.Instance{}
|
||||
}
|
||||
return list, nil
|
||||
}
|
||||
@@ -324,6 +324,10 @@ func (s *server) routes(mux *http.ServeMux) {
|
||||
// 大屏控制与运维
|
||||
mux.HandleFunc("POST /api/display/command", s.write(auth.RoleRecorder, s.displayCommandHandler))
|
||||
mux.HandleFunc("GET /api/display/instances", s.read(auth.RoleRecorder, s.displayInstancesHandler))
|
||||
// 给某台大屏设 / 清手动别名。**与切页同档（recorder）**：它改的是这台设备的显示名，
|
||||
// 与「谁能在控制页下发指令」是同一批人，不该更严。别名是机器级设置（系统库），
|
||||
// 实例注册表只在内存里，两者的合并见 displayInstancesHandler。
|
||||
mux.HandleFunc("PUT /api/display/instances/{id}/alias", s.write(auth.RoleRecorder, s.updateDisplayInstanceAliasHandler))
|
||||
// 「实时赛况」页的当前项目与已发布成绩；大屏（guest）要能直接拉，故对外只读开放。
|
||||
mux.HandleFunc("GET /api/display/live", s.public(s.liveEventsHandler))
|
||||
mux.HandleFunc("GET /api/audit-logs", s.read(auth.RoleAdmin, s.listAuditLogsHandler))
|
||||
|
||||
@@ -511,7 +511,12 @@ func (h *Hub) handleHello(ctx context.Context, c *client, p helloPayload) {
|
||||
if id == "" {
|
||||
id = p.DisplayKey
|
||||
}
|
||||
h.registerDisplay(c, id, p.Page, p.Screen)
|
||||
h.registerDisplay(c, id, displayRegistration{
|
||||
page: p.Page,
|
||||
screen: p.Screen,
|
||||
device: p.Device,
|
||||
deviceRaw: p.DeviceRaw,
|
||||
})
|
||||
h.join(c, RoomDisplay)
|
||||
}
|
||||
|
||||
|
||||
@@ -30,6 +30,14 @@ type Instance struct {
|
||||
// 管理端靠它把「本机显示器」与「在线实例」对上；局域网浏览器直接开 /display 时为空串。
|
||||
// 用字符串而不是数字：显示器的 id 由 Electron 给，不保证是小的正整数。
|
||||
Screen string `json:"screen"`
|
||||
// Device 是浏览器报上来的设备标签（`安卓 13 · Chrome 120 · 1080×2400 @3x · 手机`），
|
||||
// DeviceRaw 是原始 UA。老客户端不报时**整个键不出现**（omitempty），管理端列表退回显示 id。
|
||||
Device string `json:"device,omitempty"`
|
||||
DeviceRaw string `json:"deviceRaw,omitempty"`
|
||||
// Alias 是操作员手动起的名字。它**不住在注册表里**：注册表是内存的、实例过期即清理，
|
||||
// 而别名是机器级的、必须活过重启与实例过期，所以由 httpapi 从系统库设置里读出来，
|
||||
// 在返回列表时按实例 id 填进来（见 httpapi 的 loadInstanceAliases）。
|
||||
Alias string `json:"alias,omitempty"`
|
||||
}
|
||||
|
||||
// instanceState 是注册表的内部记录；同一 instanceId 的多条连接合并成一个实例。
|
||||
@@ -37,6 +45,8 @@ type instanceState struct {
|
||||
id string
|
||||
page string
|
||||
screen string
|
||||
device string
|
||||
deviceRaw string
|
||||
connectedAt time.Time
|
||||
lastHeartbeat time.Time
|
||||
remoteAddr string
|
||||
@@ -45,24 +55,45 @@ type instanceState struct {
|
||||
conns int
|
||||
}
|
||||
|
||||
// registerDisplay 把连接挂到大屏实例上；未带 instanceId 时由服务端生成，
|
||||
// 保证「刷新页面 = 同一实例」之外的连接也能被登记和查询。
|
||||
func (h *Hub) registerDisplay(c *client, id, page, screen string) string {
|
||||
// displayRegistration 是登记一个实例要用的 hello 字段。
|
||||
// 单独一个结构体而不是直接传 helloPayload：注册表只关心「在哪一页、哪块屏、什么设备」，
|
||||
// role / lastVersion 那些与它无关。
|
||||
type displayRegistration struct {
|
||||
page string
|
||||
screen string
|
||||
device string
|
||||
deviceRaw string
|
||||
}
|
||||
|
||||
// registerDisplay 把连接挂到大屏实例上。
|
||||
//
|
||||
// id 为空（局域网浏览器直接开 /display，URL 上没有 instance / screen）时**优先复用这条连接
|
||||
// 已经在用的实例 id**，只有从没用过才现生成一个：客户端翻页（setPage）与补齐设备标签都会
|
||||
// 再发一次 hello，而每次 hello 都现生成 `display-<随机>` 的话，老实例会永远留在注册表里
|
||||
// 变成一条「离线条目」（TTL 十分钟才清理），管理端「在线大屏」底下就凭空多出一条同一台
|
||||
// 设备的离线记录。刷新页面等新连接仍然各自登记，不会因此查不到。
|
||||
func (h *Hub) registerDisplay(c *client, id string, reg displayRegistration) string {
|
||||
c.mu.Lock()
|
||||
if id == "" {
|
||||
id = c.instanceID
|
||||
}
|
||||
if id == "" {
|
||||
id = "display-" + randomID()
|
||||
}
|
||||
now := time.Now()
|
||||
|
||||
c.mu.Lock()
|
||||
prev := c.instanceID
|
||||
c.instanceID = id
|
||||
c.mu.Unlock()
|
||||
|
||||
// 同一连接重复 hello 或换了 instanceId 时，先归还旧实例的引用，避免计数虚高。
|
||||
// 复用同一条 id 时 prev == id，引用计数不动——这正是「重复 hello 不许产生新实例」的一半。
|
||||
if prev != "" && prev != id {
|
||||
h.releaseDisplayID(prev, c)
|
||||
}
|
||||
|
||||
device := sanitizeDeviceText(reg.device, maxDeviceChars)
|
||||
deviceRaw := sanitizeDeviceText(reg.deviceRaw, maxDeviceRawChars)
|
||||
|
||||
now := time.Now()
|
||||
h.mu.Lock()
|
||||
defer h.mu.Unlock()
|
||||
h.pruneInstancesLocked(now)
|
||||
@@ -74,11 +105,19 @@ func (h *Hub) registerDisplay(c *client, id, page, screen string) string {
|
||||
if prev != id {
|
||||
st.conns++
|
||||
}
|
||||
if page != "" {
|
||||
st.page = page
|
||||
if reg.page != "" {
|
||||
st.page = reg.page
|
||||
}
|
||||
if screen != "" {
|
||||
st.screen = screen
|
||||
if reg.screen != "" {
|
||||
st.screen = reg.screen
|
||||
}
|
||||
// 设备标签只在这次报了非空值时覆盖：老客户端（以及 localStorage 不可用的客户端）
|
||||
// 不带这两个字段，不该把上一次 hello 报上来的标签抹掉。
|
||||
if device != "" {
|
||||
st.device = device
|
||||
}
|
||||
if deviceRaw != "" {
|
||||
st.deviceRaw = deviceRaw
|
||||
}
|
||||
st.lastHeartbeat = now
|
||||
st.remoteAddr = c.remoteAddr
|
||||
@@ -234,6 +273,8 @@ func (h *Hub) Instances() []Instance {
|
||||
AckVersion: st.ackVersion,
|
||||
Slow: st.slow,
|
||||
Screen: st.screen,
|
||||
Device: st.device,
|
||||
DeviceRaw: st.deviceRaw,
|
||||
})
|
||||
}
|
||||
sort.Slice(out, func(i, j int) bool { return out[i].ID < out[j].ID })
|
||||
|
||||
@@ -0,0 +1,173 @@
|
||||
package realtime
|
||||
|
||||
import (
|
||||
"strings"
|
||||
"testing"
|
||||
)
|
||||
|
||||
// ---------- 设备字段的清洗与截断 ----------
|
||||
|
||||
func TestSanitizeDeviceText(t *testing.T) {
|
||||
longUA := strings.Repeat("汉", 400)
|
||||
cases := []struct {
|
||||
name string
|
||||
in string
|
||||
limit int
|
||||
want string
|
||||
}{
|
||||
{"原样保留可读标签", "安卓 13 · Chrome 120 · 1080×2400 @3x · 手机", maxDeviceChars,
|
||||
"安卓 13 · Chrome 120 · 1080×2400 @3x · 手机"},
|
||||
// 控制字符是能把管理端列表排版搞乱的东西（换行 / 制表 / 退格 / DEL），一律清掉。
|
||||
{"换行与制表被清掉", " 安卓 13\n\tChrome 120 \r\n", maxDeviceChars, "安卓 13Chrome 120"},
|
||||
{"DEL 与 C0 控制字符被清掉", "安卓\x00\x1b[31m 13\x7f", maxDeviceChars, "安卓[31m 13"},
|
||||
{"首尾空白去掉", " 平板 ", maxDeviceChars, "平板"},
|
||||
{"只空白视作没报", " \t\n ", maxDeviceChars, ""},
|
||||
{"空串保持空串", "", maxDeviceChars, ""},
|
||||
// 长度按**字符**不是字节：按字节截会把中文腰斩成半个字。
|
||||
{"按字符截断（中文）", strings.Repeat("汉", 81), maxDeviceChars, strings.Repeat("汉", 80)},
|
||||
{"恰好等于上限不截断", strings.Repeat("x", maxDeviceChars), maxDeviceChars, strings.Repeat("x", maxDeviceChars)},
|
||||
{"超长 UA 截到 300 字符", longUA, maxDeviceRawChars, strings.Repeat("汉", maxDeviceRawChars)},
|
||||
{"limit <= 0 不截断", strings.Repeat("x", 10), 0, strings.Repeat("x", 10)},
|
||||
}
|
||||
for _, tc := range cases {
|
||||
t.Run(tc.name, func(t *testing.T) {
|
||||
got := sanitizeDeviceText(tc.in, tc.limit)
|
||||
if got != tc.want {
|
||||
t.Fatalf("清洗结果不符:\n得到 %q\n期望 %q", got, tc.want)
|
||||
}
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
// 截断结果必须是合法 UTF-8（半个汉字会显示成替换方块）。
|
||||
func TestSanitizeDeviceTextKeepsValidUTF8(t *testing.T) {
|
||||
got := sanitizeDeviceText(strings.Repeat("平板", 100), 5)
|
||||
if got != "平板平板平" {
|
||||
t.Fatalf("按字符截断结果应为 %q，得到 %q", "平板平板平", got)
|
||||
}
|
||||
for _, r := range got {
|
||||
if r == '\uFFFD' {
|
||||
t.Fatalf("截断后出现无效 UTF-8 字节: %q", got)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 同一条连接重复 hello 不许产生新实例 ----------
|
||||
|
||||
// 局域网浏览器（hello 不带 instanceId）翻页后 setPage 会再补一条 hello，
|
||||
// 第二次 hello 必须落在**同一个**实例上，否则注册表里会多出一条该设备的离线条目。
|
||||
func TestRegisterDisplayReusesInstanceForRepeatHelloWithoutID(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
env.hub.SetSnapshotMinInterval(0)
|
||||
|
||||
c := env.dial(t, &helloPayload{Role: RoleDisplay, Page: "standings"})
|
||||
c.recvEvent(EventSnapshot)
|
||||
|
||||
first := env.hub.Instances()
|
||||
if len(first) != 1 {
|
||||
t.Fatalf("首次 hello 后应只有一个实例，得到 %d 个: %+v", len(first), first)
|
||||
}
|
||||
if !strings.HasPrefix(first[0].ID, "display-") {
|
||||
t.Fatalf("不带 instanceId 时实例 id 应由服务端生成，得到 %s", first[0].ID)
|
||||
}
|
||||
|
||||
// 第二次仍不带 instanceId（真实场景：翻页补发的 hello，端上没有本机 id）。
|
||||
c.send(EventHello, helloPayload{Role: RoleDisplay, Page: "medals"})
|
||||
c.recvEvent(EventSnapshot)
|
||||
|
||||
got := env.hub.Instances()
|
||||
if len(got) != 1 {
|
||||
t.Fatalf("重复 hello 后注册表里应仍只有一个实例（旧实现会多出一条离线条目），得到 %d 个: %+v",
|
||||
len(got), got)
|
||||
}
|
||||
if got[0].ID != first[0].ID {
|
||||
t.Fatalf("重复 hello 应复用同一个实例 id：首次 %s，第二次 %s", first[0].ID, got[0].ID)
|
||||
}
|
||||
if !got[0].Online {
|
||||
t.Fatalf("重复 hello 后实例应仍在线: %+v", got[0])
|
||||
}
|
||||
if got[0].Page != "medals" {
|
||||
t.Fatalf("重复 hello 应刷新当前页为 medals，得到 %s", got[0].Page)
|
||||
}
|
||||
|
||||
// 引用计数不能虚高：连接断开后实例必须立刻变成离线（虚高会显示成「还挂着一条连接」）。
|
||||
c.close()
|
||||
waitFor(t, "重复 hello 后实例仍能正确离线", func() bool {
|
||||
insts := env.hub.Instances()
|
||||
return len(insts) == 1 && !insts[0].Online
|
||||
})
|
||||
}
|
||||
|
||||
// 换了 instanceId 的连接仍然各自登记：复用只针对「这次没带 id」，不能把显式换 id 吃掉。
|
||||
func TestRegisterDisplaySwitchesInstanceWhenIDChanges(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
env.hub.SetSnapshotMinInterval(0)
|
||||
|
||||
c := env.dial(t, &helloPayload{Role: RoleDisplay, InstanceID: "screen-1"})
|
||||
c.recvEvent(EventSnapshot)
|
||||
c.send(EventHello, helloPayload{Role: RoleDisplay, InstanceID: "screen-2"})
|
||||
c.recvEvent(EventSnapshot)
|
||||
|
||||
insts := env.hub.Instances()
|
||||
if len(insts) != 2 {
|
||||
t.Fatalf("换 id 后应有两个实例，得到 %d 个: %+v", len(insts), insts)
|
||||
}
|
||||
if !instanceOnline(insts, "screen-2") {
|
||||
t.Fatalf("新 id 应在线: %+v", insts)
|
||||
}
|
||||
// 旧实例的连接引用已归还，只剩「离线」的排查记录。
|
||||
if instanceOnline(insts, "screen-1") {
|
||||
t.Fatalf("旧 id 的连接引用应已归还，不该仍显示在线: %+v", insts)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 设备字段进注册表 ----------
|
||||
|
||||
func TestRegisterDisplayStoresSanitizedDevice(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
env.hub.SetSnapshotMinInterval(0)
|
||||
|
||||
c := env.dial(t, &helloPayload{
|
||||
Role: RoleDisplay,
|
||||
InstanceID: "pc-1",
|
||||
Device: "安卓 13\n · Chrome 120\t",
|
||||
DeviceRaw: "Mozilla/5.0 (Linux; Android 13)" + strings.Repeat("x", 400),
|
||||
})
|
||||
c.recvEvent(EventSnapshot)
|
||||
|
||||
insts := env.hub.Instances()
|
||||
if len(insts) != 1 {
|
||||
t.Fatalf("实例数应为 1，得到 %d", len(insts))
|
||||
}
|
||||
if insts[0].Device != "安卓 13 · Chrome 120" {
|
||||
t.Fatalf("设备标签应清洗掉换行与制表，得到 %q", insts[0].Device)
|
||||
}
|
||||
if n := len([]rune(insts[0].DeviceRaw)); n != maxDeviceRawChars {
|
||||
t.Fatalf("原始 UA 应按字符截到 %d，得到 %d 个字符", maxDeviceRawChars, n)
|
||||
}
|
||||
if strings.ContainsAny(insts[0].DeviceRaw, "\n\t") {
|
||||
t.Fatalf("原始 UA 不该含控制字符: %q", insts[0].DeviceRaw)
|
||||
}
|
||||
|
||||
// 老客户端（不带这两个字段）重连：不该把已经报上来的标签抹掉。
|
||||
c.send(EventHello, helloPayload{Role: RoleDisplay, InstanceID: "pc-1"})
|
||||
c.recvEvent(EventSnapshot)
|
||||
if got := env.hub.Instances()[0]; got.Device == "" || got.DeviceRaw == "" {
|
||||
t.Fatalf("不带设备字段的重复 hello 不该清空已有标签: %+v", got)
|
||||
}
|
||||
}
|
||||
|
||||
// 老客户端（不带 device / deviceRaw）行为与今天一致：字段留空，注册表照常登记。
|
||||
func TestRegisterDisplayWithoutDeviceFields(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
c := env.dial(t, &helloPayload{Role: RoleDisplay, InstanceID: "old-1"})
|
||||
c.recvEvent(EventSnapshot)
|
||||
|
||||
insts := env.hub.Instances()
|
||||
if len(insts) != 1 || insts[0].ID != "old-1" || !insts[0].Online {
|
||||
t.Fatalf("老客户端应照常登记: %+v", insts)
|
||||
}
|
||||
if insts[0].Device != "" || insts[0].DeviceRaw != "" {
|
||||
t.Fatalf("老客户端没报设备字段时应留空: %+v", insts[0])
|
||||
}
|
||||
}
|
||||
@@ -7,7 +7,9 @@ package realtime
|
||||
import (
|
||||
"encoding/json"
|
||||
"fmt"
|
||||
"strings"
|
||||
"time"
|
||||
"unicode"
|
||||
)
|
||||
|
||||
// 事件名与协议第 3 节的表格一一对应。
|
||||
@@ -107,6 +109,64 @@ type helloPayload struct {
|
||||
Page string `json:"page,omitempty"`
|
||||
// Screen 是 Console 从 URL 带下来的屏号（screen=<display.id>），局域网浏览器留空。
|
||||
Screen string `json:"screen,omitempty"`
|
||||
// Device 是浏览器自己拼好的设备标签（`安卓 13 · Chrome 120 · 1080×2400 @3x · 手机`），
|
||||
// DeviceRaw 是原始 UA（排障用）。两者都 omitempty：**老客户端不带这两个字段，服务端行为
|
||||
// 与今天逐字一致**（管理端列表退回显示实例 id）。
|
||||
//
|
||||
// 服务端不解析 UA，但也不能全信这两个值：它们是客户端自报的自由文本，会直接进管理端列表。
|
||||
// 长度按**字符**截断、控制字符一律清掉，收口在 sanitizeDeviceText（registerDisplay 调用）。
|
||||
Device string `json:"device,omitempty"`
|
||||
DeviceRaw string `json:"deviceRaw,omitempty"`
|
||||
}
|
||||
|
||||
// 客户端自报文本的长度上限，按**字符**（rune）不是字节算：
|
||||
// `安卓 13 · Chrome 120` 这种标签按字节截会切出半个汉字，显示成乱码方框。
|
||||
const (
|
||||
maxDeviceChars = 80
|
||||
maxDeviceRawChars = 300
|
||||
)
|
||||
|
||||
// CleanUserText 清洗客户端自报的自由文本：去掉全部控制字符（换行、制表、退格、DEL…）与首尾空白。
|
||||
//
|
||||
// 这些值最终要显示在管理端「在线大屏」列表里，一个带换行的 device 能把整行排版顶歪；
|
||||
// 服务端是唯一的收口处，不能指望每个客户端都干净。TrimSpace 之后为空即视作「没报」，返回空串。
|
||||
//
|
||||
// 保留字符间的普通空格与各种可见符号：设备标签本来就长这样，不该被服务端改写。
|
||||
func CleanUserText(s string) string {
|
||||
if s == "" {
|
||||
return ""
|
||||
}
|
||||
var b strings.Builder
|
||||
b.Grow(len(s))
|
||||
for _, r := range s {
|
||||
if unicode.IsControl(r) {
|
||||
continue
|
||||
}
|
||||
b.WriteRune(r)
|
||||
}
|
||||
return strings.TrimSpace(b.String())
|
||||
}
|
||||
|
||||
// TruncateChars 按字符（rune）截断到 maxChars 个；maxChars <= 0 表示不截断。
|
||||
// 会切断代理对时以整字符为界（Go 的 range 只落在字符起始字节上），不会切出半个 UTF-8 序列。
|
||||
func TruncateChars(s string, maxChars int) string {
|
||||
if maxChars <= 0 {
|
||||
return s
|
||||
}
|
||||
count := 0
|
||||
for i := range s {
|
||||
if count == maxChars {
|
||||
return s[:i]
|
||||
}
|
||||
count++
|
||||
}
|
||||
return s
|
||||
}
|
||||
|
||||
// sanitizeDeviceText 是 hello 里设备字段的收口：先清洗再截断。
|
||||
// 没有这两个字段的老客户端拿到的是空串，注册表按「没报」处理。
|
||||
func sanitizeDeviceText(s string, maxChars int) string {
|
||||
return TruncateChars(CleanUserText(s), maxChars)
|
||||
}
|
||||
|
||||
// ackPayload 是 C→S 的 ack 载荷；服务端据此识别慢客户端。
|
||||
|
||||
@@ -14,9 +14,28 @@ import (
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/dto"
|
||||
)
|
||||
|
||||
// latestResultsLimit 控制快照里「最新成绩」的行数上限，避免大屏首包过大。
|
||||
// 行会按「小项 + 组别」聚合后再下发，因此组数只会比这个值更少。
|
||||
const latestResultsLimit = 20
|
||||
// 快照「最新成绩」的窗口口径：先取最近发布的 K 组，再每组保底取前 R 行。
|
||||
//
|
||||
// 不能按「总行数」截断：行是按发布时间倒序取的，而组是按「首次出现」建号的，
|
||||
// 于是组数组的顺序 = 发布时间倒序——**屏上最旧的那一栏站在窗口尾部**，行数截断的切口
|
||||
// 只会落进那一组里，把「建号最早的行」切掉。手录名次的项目通常从第 1 名往下录，
|
||||
// 第 1 名的 results.id 最小 → 现场表现就是「最旧那一栏看不到第 1 名、从第 2 名开始」，
|
||||
// 且症状跟着**栏位**走（同一批项目挪到前面几栏就正常）。
|
||||
//
|
||||
// 最坏情况下快照下发 8 × 10 = 80 行（旧口径是全局 20 行），首包因此变大；
|
||||
// 换来的是每一组都从第 1 名开始，不再有「最旧一栏少一行」。
|
||||
const (
|
||||
// latestResultsGroupLimit 保留的**组数**上限。一组 = 一个小项 + 一个组别，即大屏的一栏。
|
||||
// 前端单屏最多 4 栏（web/src/display/useScoreboard.ts 把 resultsCount 夹在 1..4），
|
||||
// 底栏只需最新一组；留一倍余量给「刚发布、还没轮到显示」的组，取 8。
|
||||
latestResultsGroupLimit = 8
|
||||
|
||||
// latestResultsRowsPerGroup 每组保留的**行数**上限，按名次取前 R 行。
|
||||
// 前端每栏只画 6 行（web/src/display/results.ts 的 RESULT_ROWS_PER_COLUMN），
|
||||
// 并列名次会让一栏超过 6 行；实时赛况页的同一批数据上限是 10 行
|
||||
// （web/src/display/live.ts 的 MAX_LIVE_ROWS），兜底取 10。
|
||||
latestResultsRowsPerGroup = 10
|
||||
)
|
||||
|
||||
// Snapshot 是 snapshot 事件的 data，也是客户端冷启动的完整状态。
|
||||
// 字段名与协议第 3 节一致；settings/standings/latestResults 的形状必须与 REST 同构，
|
||||
@@ -423,15 +442,82 @@ func loadRecords(ctx context.Context, tx *sql.Tx, snap *Snapshot) error {
|
||||
return rows.Err()
|
||||
}
|
||||
|
||||
// mainChannelRankJoin 是大屏成绩行上名次列的「主通道 + 通道名次」两段关联，供 loadLatestResults
|
||||
// 与 httpapi 的 liveResultGroups 使用（两边必须逐字相同，否则分项成绩页与实时赛况的名次会打架）。
|
||||
//
|
||||
// 名次取「主通道」口径（devdocs 17 §11.3）：一行成绩只能出一个名次，主通道 = scope=athlete 优先，
|
||||
// 其次通道 sort_order 小者，与 export/load.go 的分项成绩表同一条规则。优先级是
|
||||
// **results.rank 优先、channel_ranks 兜底**（见下面各查询里的 COALESCE(r.rank, cr.rank)），
|
||||
// 不能照抄导出侧的 cr 优先：results.rank 是这条报名项自己的名次，而「只更新名次」的发布
|
||||
// （rankOnly，httpapi/scoring.go）只写 results.rank、不重建 channel_ranks——cr 一优先，
|
||||
// 个人项目在这种发布之后会显示上一次的旧名次。反过来 r 为空时才回落到 cr，
|
||||
// 正好补上团体主体名次：团体名次有意不写 results.rank（applyComputedRanks 只认个人主体）。
|
||||
//
|
||||
// 关联用 cr.entry_id = e.id，覆盖 basis=result 的名次（含纯团体项目，subject_key='e:<报名项id>'）。
|
||||
// 覆盖不到聚合 / 团体手工名次：那类 channel_ranks 行的 entry_id / result_id 都是 NULL，
|
||||
// 主体是 t:<单位id> / a:<运动员id>，而这类主体在分项成绩表里本来就没有对应的一行
|
||||
// （导出侧同一段子查询、同一处口径，见 export/load.go 的 loadEventRowsWithMembers）。
|
||||
// 取 MIN(cr2.id) = 报名项自己那一份名次：团体报名挂上队员后同一通道下还有每个队员的个人副本，
|
||||
// 直接按 entry_id JOIN 会把这一行印 N+1 遍（与导出侧同一处理）。
|
||||
//
|
||||
// ⚠️ 与 export/load.go（loadEventRowsWithMembers 的 cr 子查询）、httpapi/live_events.go（liveResultGroups）
|
||||
// 同源，改一处要改三处。
|
||||
const mainChannelRankJoin = `
|
||||
LEFT JOIN event_score_channels mc ON mc.id = (
|
||||
SELECT c2.id FROM event_score_channels c2
|
||||
WHERE c2.event_id = r.event_id
|
||||
ORDER BY CASE WHEN c2.scope = 'athlete' THEN 0 ELSE 1 END, c2.sort_order, c2.id
|
||||
LIMIT 1)
|
||||
LEFT JOIN channel_ranks cr ON cr.id = (
|
||||
SELECT MIN(cr2.id) FROM channel_ranks cr2
|
||||
WHERE cr2.channel_id = mc.id AND cr2.entry_id = e.id AND cr2.category_id = e.category_id)`
|
||||
|
||||
// latestResultsScopedSelect 是窗口函数的输入：已发布、未作废的成绩行，每行只带分组键、
|
||||
// 发布时间与名次。时间表达式与主查询逐字相同——这里少一个兜底列，组的发布时间就会漂到别的列上。
|
||||
// 名次口径也必须与主查询一致（results.rank 优先、channel_ranks 兜底），
|
||||
// 否则「每组取前 R 行」和「组内展示顺序」会各按一套名次排。
|
||||
const latestResultsScopedSelect = `
|
||||
SELECT r.id AS rid, r.event_id AS event_id, e.category_id AS category_id,
|
||||
COALESCE(r.verified_at, r.recorded_at, r.updated_at, r.created_at, '') AS ts,
|
||||
COALESCE(r.rank, cr.rank) AS rank_value
|
||||
FROM results r
|
||||
JOIN entries e ON e.id = r.entry_id` + mainChannelRankJoin + `
|
||||
WHERE r.state = 'published' AND r.status <> 'withdrawn'`
|
||||
|
||||
// loadLatestResults 取最近发布的成绩，按「小项 + 组别」聚合成组后下发。
|
||||
// 已作废（status=withdrawn）的成绩必须排除，否则大屏会继续展示被作废的行；
|
||||
// 前端按组渲染（TickerBar 取最新一组、EventResultsPage 取前 N 组），平铺行会让它拿到 undefined。
|
||||
//
|
||||
// 窗口是「K 组 × 每组 R 行」而不是「总 N 行」，理由见上面那组常量的注释。三件事都在 SQL 里定死：
|
||||
//
|
||||
// 1. recent_groups：先按**组的发布时间**（= 组内最新一条的时间）倒序取前 K 组。并列时间按
|
||||
// 「该组最新那一行的 r.id」倒序决出——与旧实现「行按 ts DESC, r.id DESC 取回、组按首次出现建号」
|
||||
// 的顺序**逐位相同**，组数组的顺序不变（`Snapshot.LatestResults` 是 WS 契约）。
|
||||
// 2. bounded：每组按名次升序编号（无名次排最后，与下面 Go 侧那次 sort 同口径），只留前 R 行。
|
||||
// ⚠️ 必须是「先定组、再每组截断」；退化成「取 N 行再分组」就还是同一个 bug，只是阈值变大。
|
||||
// 3. 组的时间取 anchors 定的 group_ts（组内最新一条），不是「这一组碰巧先被取回的那一行」——
|
||||
// 组内按名次截断之后，第一行的发布时间不再等于组的最新发布时间。
|
||||
func loadLatestResults(ctx context.Context, tx *sql.Tx, snap *Snapshot) error {
|
||||
rows, err := tx.QueryContext(ctx, `
|
||||
WITH scoped AS (`+latestResultsScopedSelect+`),
|
||||
anchors AS (
|
||||
SELECT event_id, category_id, ts AS group_ts, rid,
|
||||
ROW_NUMBER() OVER (PARTITION BY event_id, category_id ORDER BY ts DESC, rid DESC) AS anchor_no
|
||||
FROM scoped),
|
||||
recent_groups AS (
|
||||
SELECT event_id, category_id, group_ts
|
||||
FROM anchors WHERE anchor_no = 1
|
||||
ORDER BY group_ts DESC, rid DESC
|
||||
LIMIT ?),
|
||||
bounded AS (
|
||||
SELECT rid, event_id, category_id,
|
||||
ROW_NUMBER() OVER (PARTITION BY event_id, category_id
|
||||
ORDER BY rank_value IS NULL, rank_value, rid) AS row_no
|
||||
FROM scoped)
|
||||
SELECT r.event_id, COALESCE(ev.code, ''), COALESCE(ev.name, ''),
|
||||
e.category_id, COALESCE(cat.name, ''),
|
||||
COALESCE(r.verified_at, r.recorded_at, r.updated_at, r.created_at, ''),
|
||||
r.entry_id, r.rank, e.team_id,
|
||||
rg.group_ts,
|
||||
r.entry_id, COALESCE(r.rank, cr.rank), e.team_id,
|
||||
COALESCE(t.code, ''), COALESCE(t.name, ''), COALESCE(t.short_name, ''), t.logo_path,
|
||||
e.athlete_id, COALESCE(a.name, ''), COALESCE(e.member_names, ''),
|
||||
COALESCE(r.result_text, ''), r.result_value, COALESCE(r.unit, ''), r.is_tie, r.status
|
||||
@@ -440,10 +526,13 @@ func loadLatestResults(ctx context.Context, tx *sql.Tx, snap *Snapshot) error {
|
||||
JOIN events ev ON ev.id = r.event_id
|
||||
LEFT JOIN event_categories cat ON cat.id = e.category_id
|
||||
LEFT JOIN teams t ON t.id = e.team_id
|
||||
LEFT JOIN athletes a ON a.id = e.athlete_id
|
||||
WHERE r.state = 'published' AND r.status <> 'withdrawn'
|
||||
ORDER BY COALESCE(r.verified_at, r.recorded_at, r.updated_at, r.created_at) DESC, r.id DESC
|
||||
LIMIT ?`, latestResultsLimit)
|
||||
LEFT JOIN athletes a ON a.id = e.athlete_id`+mainChannelRankJoin+`
|
||||
JOIN bounded b ON b.rid = r.id
|
||||
JOIN recent_groups rg ON rg.event_id = b.event_id AND rg.category_id = b.category_id
|
||||
WHERE r.state = 'published' AND r.status <> 'withdrawn' AND b.row_no <= ?
|
||||
ORDER BY rg.group_ts DESC,
|
||||
COALESCE(r.verified_at, r.recorded_at, r.updated_at, r.created_at) DESC, r.id DESC`,
|
||||
latestResultsGroupLimit, latestResultsRowsPerGroup)
|
||||
if err != nil {
|
||||
return fmt.Errorf("读取最新成绩: %w", err)
|
||||
}
|
||||
@@ -460,18 +549,20 @@ func loadLatestResults(ctx context.Context, tx *sql.Tx, snap *Snapshot) error {
|
||||
eventID, categoryID int64
|
||||
eventCode, eventName string
|
||||
categoryName string
|
||||
publishedAt string
|
||||
row dto.EventResultRow
|
||||
rank sql.NullInt64
|
||||
value sql.NullFloat64
|
||||
athleteID sql.NullInt64
|
||||
athleteName string
|
||||
shortName string
|
||||
logoPath sql.NullString
|
||||
memberNames string
|
||||
isTie int
|
||||
// groupPublishedAt 是这一**组**的发布时间（组内最新一条），来自 SQL 的 group_ts，
|
||||
// 不是这一行自己的时间——组内按名次截断后，第一行的时间不再等于组的最新时间。
|
||||
groupPublishedAt string
|
||||
row dto.EventResultRow
|
||||
rank sql.NullInt64
|
||||
value sql.NullFloat64
|
||||
athleteID sql.NullInt64
|
||||
athleteName string
|
||||
shortName string
|
||||
logoPath sql.NullString
|
||||
memberNames string
|
||||
isTie int
|
||||
)
|
||||
if err := rows.Scan(&eventID, &eventCode, &eventName, &categoryID, &categoryName, &publishedAt,
|
||||
if err := rows.Scan(&eventID, &eventCode, &eventName, &categoryID, &categoryName, &groupPublishedAt,
|
||||
&row.EntryID, &rank, &row.TeamID, &row.TeamCode, &row.TeamName, &shortName, &logoPath,
|
||||
&athleteID, &athleteName, &memberNames,
|
||||
&row.ResultText, &value, &row.Unit, &isTie, &row.Status); err != nil {
|
||||
@@ -506,7 +597,7 @@ func loadLatestResults(ctx context.Context, tx *sql.Tx, snap *Snapshot) error {
|
||||
EventName: eventName,
|
||||
CategoryID: categoryID,
|
||||
CategoryName: categoryName,
|
||||
PublishedAt: nilIfEmpty(publishedAt),
|
||||
PublishedAt: nilIfEmpty(groupPublishedAt),
|
||||
Rows: []dto.EventResultRow{},
|
||||
})
|
||||
}
|
||||
|
||||
@@ -7,6 +7,7 @@ import (
|
||||
"fmt"
|
||||
"strings"
|
||||
"testing"
|
||||
"time"
|
||||
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/dto"
|
||||
)
|
||||
@@ -722,3 +723,375 @@ func TestSnapshotTeamsEventsWireFieldsPresent(t *testing.T) {
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// insertTeamEvent 建一个纯团体小项（event_type=team），与现场「团体 4x100 接力」同形。
|
||||
func insertTeamEvent(t *testing.T, db *sql.DB, code, name string) int64 {
|
||||
t.Helper()
|
||||
if _, err := db.Exec(`INSERT OR IGNORE INTO sports(code, name) VALUES ('S1', '田径')`); err != nil {
|
||||
t.Fatalf("插入大项: %v", err)
|
||||
}
|
||||
res, err := db.Exec(`INSERT INTO events(sport_id, code, name, event_type, result_mode, result_type, compare, status)
|
||||
VALUES (1, ?, ?, 'team', 'auto', 'time', 'asc', 'published')`, code, name)
|
||||
if err != nil {
|
||||
t.Fatalf("插入团体小项 %s: %v", code, err)
|
||||
}
|
||||
return lastID(t, res)
|
||||
}
|
||||
|
||||
// insertTeamResult 写一条团体成绩：rank 列保持 NULL。
|
||||
// 团体名次有意不写 results.rank（applyComputedRanks 只认个人主体），发布后的真实形状就是这样。
|
||||
func insertTeamResult(t *testing.T, db *sql.DB, eventID, entryID int64, text string, value float64, verifiedAt string) int64 {
|
||||
t.Helper()
|
||||
res, err := db.Exec(`INSERT INTO results(event_id, entry_id, rank, result_text, result_value, unit, state, status, verified_at)
|
||||
VALUES (?, ?, NULL, ?, ?, 's', 'published', 'ok', ?)`, eventID, entryID, text, value, verifiedAt)
|
||||
if err != nil {
|
||||
t.Fatalf("插入团体成绩: %v", err)
|
||||
}
|
||||
return lastID(t, res)
|
||||
}
|
||||
|
||||
// latestRowsByEntry 把快照「最新成绩」摊成 entryID -> 名次，便于逐条断言。
|
||||
func latestRowsByEntry(t *testing.T, snap *Snapshot) map[int64]*int {
|
||||
t.Helper()
|
||||
out := make(map[int64]*int)
|
||||
for _, group := range snap.LatestResults {
|
||||
for _, row := range group.Rows {
|
||||
out[row.EntryID] = row.Rank
|
||||
}
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
// 团体项目的名次只落 channel_ranks、results.rank 有意留空，快照的 latestResults 必须回落到
|
||||
// channel_ranks：不回落的现场表现就是「团体 4x100 接力」发布之后，大屏分项成绩页与底栏上的
|
||||
// 名次整列都是「-」。库形态与发布后的真实落库一致（发布链路端到端钉在 httpapi 侧：
|
||||
// TestDisplayShowsTeamRankForTeamEvent）。
|
||||
func TestSnapshotLatestResultsFallsBackToChannelRanks(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
db := env.db
|
||||
|
||||
team1 := insertTeam(t, db, "T1", "第一单位", "一队")
|
||||
team2 := insertTeam(t, db, "T2", "第二单位", "二队")
|
||||
eventID := insertTeamEvent(t, db, "T4X100", "4x100 米接力")
|
||||
catID := insertCategory(t, db, eventID, "男子")
|
||||
entry1 := insertEntry(t, db, eventID, catID, team1, 0)
|
||||
entry2 := insertEntry(t, db, eventID, catID, team2, 0)
|
||||
channelID := insertChannel(t, db, eventID, "team")
|
||||
// 故意先写名次靠后的那条，验证组内按名次重排。
|
||||
result2 := insertTeamResult(t, db, eventID, entry2, "46.10", 46.10, "2026-09-09T10:00:02Z")
|
||||
result1 := insertTeamResult(t, db, eventID, entry1, "45.20", 45.20, "2026-09-09T10:00:01Z")
|
||||
insertChannelRank(t, db, eventID, catID, channelID, entry1, result1, team1, 0, "team", "result", 1, 45.20)
|
||||
insertChannelRank(t, db, eventID, catID, channelID, entry2, result2, team2, 0, "team", "result", 2, 46.10)
|
||||
|
||||
var ranked int
|
||||
if err := db.QueryRow(`SELECT COUNT(*) FROM results WHERE event_id = ? AND rank IS NOT NULL`, eventID).Scan(&ranked); err != nil {
|
||||
t.Fatalf("统计团体名次写回: %v", err)
|
||||
}
|
||||
if ranked != 0 {
|
||||
t.Fatalf("前提不成立：团体名次不该写回 results.rank，得到 %d 行", ranked)
|
||||
}
|
||||
|
||||
snap, err := env.hub.Snapshot(context.Background())
|
||||
if err != nil {
|
||||
t.Fatalf("构建快照: %v", err)
|
||||
}
|
||||
if len(snap.LatestResults) != 1 || len(snap.LatestResults[0].Rows) != 2 {
|
||||
t.Fatalf("应有 1 组 2 行，得到 %+v", snap.LatestResults)
|
||||
}
|
||||
ranks := latestRowsByEntry(t, snap)
|
||||
for entryID, want := range map[int64]int{entry1: 1, entry2: 2} {
|
||||
got := ranks[entryID]
|
||||
if got == nil {
|
||||
t.Fatalf("报名项 %d 的名次为空（大屏上就是「-」，得到 %+v）", entryID, snap.LatestResults)
|
||||
}
|
||||
if *got != want {
|
||||
t.Fatalf("报名项 %d 的名次 = %d，期望 %d（来自 channel_ranks）", entryID, *got, want)
|
||||
}
|
||||
}
|
||||
if snap.LatestResults[0].Rows[0].EntryID != entry1 {
|
||||
t.Fatalf("组内应按名次排序（第一条应是第 1 名的报名项 %d），得到 %+v",
|
||||
entry1, snap.LatestResults[0].Rows)
|
||||
}
|
||||
}
|
||||
|
||||
// 名次优先级必须是 results.rank 优先、channel_ranks 兜底：
|
||||
// 「只更新名次」的发布（rankOnly）只写 results.rank、不重建 channel_ranks，
|
||||
// 若 cr 优先，个人项目在这种发布之后会退回上一次的旧名次（从「正常」变成「显示旧名次」）。
|
||||
func TestSnapshotLatestResultsPrefersResultRank(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
db := env.db
|
||||
|
||||
team1 := insertTeam(t, db, "T1", "第一单位", "")
|
||||
eventID := insertEvent(t, db, "E1", "100米")
|
||||
catID := insertCategory(t, db, eventID, "男子")
|
||||
athlete1 := insertAthlete(t, db, "张三", team1)
|
||||
entry1 := insertEntry(t, db, eventID, catID, team1, athlete1)
|
||||
channelID := insertChannel(t, db, eventID, "athlete")
|
||||
// results.rank = 2 是「只更新名次」那次发布写下的新名次；channel_ranks 还是上一次发布的 1。
|
||||
result1 := insertResult(t, db, eventID, entry1, 2, "11.72", 11.72, "2026-09-09T10:00:01Z")
|
||||
insertChannelRank(t, db, eventID, catID, channelID, entry1, result1, team1, athlete1, "athlete", "result", 1, 11.72)
|
||||
|
||||
snap, err := env.hub.Snapshot(context.Background())
|
||||
if err != nil {
|
||||
t.Fatalf("构建快照: %v", err)
|
||||
}
|
||||
got := latestRowsByEntry(t, snap)[entry1]
|
||||
if got == nil {
|
||||
t.Fatalf("名次为空（大屏上就是「-」），期望 results.rank 的 2")
|
||||
}
|
||||
if *got != 2 {
|
||||
t.Fatalf("名次应是 results.rank 的 2（新名次），得到 %d", *got)
|
||||
}
|
||||
}
|
||||
|
||||
// shiftTS 把 ISO 时间往后推 n 秒，造数里用来让「名次越靠后、发布时间越晚」（= 从第 1 名往下发）。
|
||||
func shiftTS(t *testing.T, base string, seconds int) string {
|
||||
t.Helper()
|
||||
ts, err := time.Parse(time.RFC3339, base)
|
||||
if err != nil {
|
||||
t.Fatalf("解析时间 %s: %v", base, err)
|
||||
}
|
||||
return ts.Add(time.Duration(seconds) * time.Second).Format(time.RFC3339)
|
||||
}
|
||||
|
||||
// insertRankedGroup 造一组「小项 + 组别」：rows 条已发布成绩，名次 1..rows **按顺序录入**
|
||||
// （results.id 随名次递增，第 1 名建号最早），返回小项 id。
|
||||
// tsOf 给出每一行的发布时间：现场「从第 1 名往下录/往下发」时它随名次变晚，
|
||||
// 而一次发布刷同一时间戳时它是常量（并列靠 r.id 决先后）。
|
||||
func insertRankedGroup(t *testing.T, db *sql.DB, code, name string, teamID int64, rows int, tsOf func(rank int) string) int64 {
|
||||
t.Helper()
|
||||
eventID := insertEvent(t, db, code, name)
|
||||
catID := insertCategory(t, db, eventID, "男子")
|
||||
for rank := 1; rank <= rows; rank++ {
|
||||
athlete := insertAthlete(t, db, fmt.Sprintf("%s-第%d名", code, rank), teamID)
|
||||
entry := insertEntry(t, db, eventID, catID, teamID, athlete)
|
||||
insertResult(t, db, eventID, entry, rank,
|
||||
fmt.Sprintf("11.%02d", rank), 11+float64(rank)/100, tsOf(rank))
|
||||
}
|
||||
return eventID
|
||||
}
|
||||
|
||||
// ranksOf 把一组的名次摊平成列表，只用于失败信息：直接 `%+v` 一整组行会打出一串指针地址。
|
||||
func ranksOf(group dto.EventResultGroup) []string {
|
||||
out := make([]string, 0, len(group.Rows))
|
||||
for _, row := range group.Rows {
|
||||
if row.Rank == nil {
|
||||
out = append(out, "—")
|
||||
continue
|
||||
}
|
||||
out = append(out, fmt.Sprint(*row.Rank))
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
// 快照「最新成绩」的窗口是「最近 K 组 × 每组前 R 行」，不是「总 N 行」。
|
||||
//
|
||||
// 这条用例钉的是现场那个 bug：行按发布时间倒序取、组按「首次出现」建号 → **屏上最旧的那一栏
|
||||
// 站在窗口尾部**，按总行数截断时切口只会落进那一组里，把「建号最早、也就是第 1 名」的行切掉。
|
||||
// 现场表现就是「第 3 栏看不到第 1 名、从第 2 名开始」，而且症状跟着**栏位**走、不跟着项目走。
|
||||
//
|
||||
// 旧实现（全局 20 行窗口）在这里必然失败：24 行里最旧的 4 行（第 3 栏的第 1–4 名）被切掉，
|
||||
// 第 3 栏第一行的名次是 5 而不是 1。既有用例拦不住它——那些用例每组最多 2 行、总量远小于 20。
|
||||
func TestSnapshotLatestResultsKeepsRankOneInEveryGroup(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
db := env.db
|
||||
|
||||
team1 := insertTeam(t, db, "T1", "第一单位", "")
|
||||
const rowsPerGroup = 8
|
||||
// 三栏的发布时间：第 3 栏（下标 2）最早发布、建号也最早，旧实现下正是它站在窗口尾部。
|
||||
publishedBases := [3]string{"2026-09-09T10:00:00Z", "2026-09-09T11:00:00Z", "2026-09-09T09:00:00Z"}
|
||||
|
||||
events := make([]int64, len(publishedBases))
|
||||
// 造数顺序刻意与栏位顺序相反：先发布「最终落在第 3 栏」的那一组，再发另外两组。
|
||||
for _, col := range []int{2, 0, 1} {
|
||||
base := publishedBases[col]
|
||||
events[col] = insertRankedGroup(t, db, fmt.Sprintf("E%d", col+1),
|
||||
fmt.Sprintf("大屏第 %d 栏的小项", col+1), team1, rowsPerGroup,
|
||||
func(rank int) string { return shiftTS(t, base, rank) })
|
||||
}
|
||||
|
||||
snap, err := env.hub.Snapshot(context.Background())
|
||||
if err != nil {
|
||||
t.Fatalf("构建快照: %v", err)
|
||||
}
|
||||
|
||||
byEvent := make(map[int64]dto.EventResultGroup, len(snap.LatestResults))
|
||||
totalRows := 0
|
||||
for _, group := range snap.LatestResults {
|
||||
byEvent[group.EventID] = group
|
||||
totalRows += len(group.Rows)
|
||||
}
|
||||
if len(snap.LatestResults) < 3 {
|
||||
t.Fatalf("三栏都应下发，得到 %d 组: %+v", len(snap.LatestResults), snap.LatestResults)
|
||||
}
|
||||
// 组数组的顺序不变（WS 契约）：发布时间倒序，最旧的那一组在最尾部 = 屏上最后一栏。
|
||||
if snap.LatestResults[len(snap.LatestResults)-1].EventID != events[2] {
|
||||
t.Fatalf("最旧发布的组应排在组数组尾部（第 3 栏），得到 %+v",
|
||||
[]int64{snap.LatestResults[0].EventID, snap.LatestResults[1].EventID, snap.LatestResults[2].EventID})
|
||||
}
|
||||
|
||||
wantRows := min(rowsPerGroup, latestResultsRowsPerGroup)
|
||||
for col, eventID := range events {
|
||||
group, ok := byEvent[eventID]
|
||||
if !ok {
|
||||
t.Fatalf("第 %d 栏（小项 %d）整组都没下发: %+v", col+1, eventID, snap.LatestResults)
|
||||
}
|
||||
// 断言顺序有讲究：先看第 1 名在不在，失败信息才是这个 bug 的原始形状。
|
||||
if group.Rows[0].Rank == nil || *group.Rows[0].Rank != 1 {
|
||||
t.Fatalf("第 %d 栏应从第 1 名开始，实际名次 %v（整组行数 %d）", col+1, ranksOf(group), len(group.Rows))
|
||||
}
|
||||
for i, row := range group.Rows {
|
||||
if row.Rank == nil || *row.Rank != i+1 {
|
||||
t.Fatalf("第 %d 栏的名次应连续升序，实际 %v", col+1, ranksOf(group))
|
||||
}
|
||||
}
|
||||
if len(group.Rows) != wantRows {
|
||||
t.Fatalf("第 %d 栏应有 %d 行（每组上限 R=%d），实际名次 %v",
|
||||
col+1, wantRows, latestResultsRowsPerGroup, ranksOf(group))
|
||||
}
|
||||
}
|
||||
// 总行数 > 20 是用例的前提（旧口径正是从这里翻车），放最后断言：
|
||||
// 失败信息才优先说清「是哪一栏少了第 1 名」。
|
||||
if totalRows <= 20 {
|
||||
t.Fatalf("用例前提不成立：总行数必须 > 20（旧实现翻车的条件），得到 %d", totalRows)
|
||||
}
|
||||
}
|
||||
|
||||
// 每组只保留**名次最靠前**的 R 行，且组的发布时间取组内最新一条（哪怕那一行被 R 截掉）。
|
||||
//
|
||||
// 这一条同时挡住两种退化：①「先按总行数截断再分组」（会留下 12 行、超过 R）；
|
||||
// ②「组内取发布时间最新的 R 行」（会少掉第 1 名）。旧实现在这里也是红的（12 行一条不落地留下）。
|
||||
func TestSnapshotLatestResultsCapsRowsPerGroupByRank(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
db := env.db
|
||||
|
||||
team1 := insertTeam(t, db, "T1", "第一单位", "")
|
||||
base := "2026-09-09T10:00:00Z"
|
||||
// 比 R 多 2 行：名次最靠后的两行必须被丢掉，第 1 名必须在。
|
||||
rows := latestResultsRowsPerGroup + 2
|
||||
eventID := insertRankedGroup(t, db, "E1", "男子 100 米", team1, rows,
|
||||
func(rank int) string { return shiftTS(t, base, rank) })
|
||||
|
||||
snap, err := env.hub.Snapshot(context.Background())
|
||||
if err != nil {
|
||||
t.Fatalf("构建快照: %v", err)
|
||||
}
|
||||
if len(snap.LatestResults) != 1 {
|
||||
t.Fatalf("应只有 1 组，得到 %d: %+v", len(snap.LatestResults), snap.LatestResults)
|
||||
}
|
||||
group := snap.LatestResults[0]
|
||||
if group.EventID != eventID {
|
||||
t.Fatalf("组的小项应是 %d，得到 %d", eventID, group.EventID)
|
||||
}
|
||||
if len(group.Rows) != latestResultsRowsPerGroup {
|
||||
t.Fatalf("一组最多 %d 行，实际名次 %v", latestResultsRowsPerGroup, ranksOf(group))
|
||||
}
|
||||
for i, row := range group.Rows {
|
||||
if row.Rank == nil || *row.Rank != i+1 {
|
||||
t.Fatalf("留下的必须是名次最靠前的 %d 行，实际名次 %v", latestResultsRowsPerGroup, ranksOf(group))
|
||||
}
|
||||
}
|
||||
// 组的发布时间 = 组内最新一条（第 12 名那行的 base+12s），不是「留下的第一行」的 base+1s。
|
||||
wantPublishedAt := shiftTS(t, base, rows)
|
||||
if group.PublishedAt == nil || *group.PublishedAt != wantPublishedAt {
|
||||
t.Fatalf("组的发布时间应取组内最新一条 %s，得到 %v", wantPublishedAt, group.PublishedAt)
|
||||
}
|
||||
}
|
||||
|
||||
// 组数超过 K 时只保留**最近发布**的 K 组：组数组尾部（屏上最后一栏）先被丢掉。
|
||||
func TestSnapshotLatestResultsCapsGroupCount(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
db := env.db
|
||||
|
||||
team1 := insertTeam(t, db, "T1", "第一单位", "")
|
||||
base := "2026-09-09T10:00:00Z"
|
||||
const groupCount = latestResultsGroupLimit + 1
|
||||
|
||||
events := make([]int64, groupCount)
|
||||
for i := 0; i < groupCount; i++ {
|
||||
// 每组 1 行，发布时间依次变新：下标越大越新。
|
||||
ts := shiftTS(t, base, i*60)
|
||||
events[i] = insertRankedGroup(t, db, fmt.Sprintf("E%02d", i+1),
|
||||
fmt.Sprintf("第 %d 个小项", i+1), team1, 1,
|
||||
func(int) string { return ts })
|
||||
}
|
||||
|
||||
snap, err := env.hub.Snapshot(context.Background())
|
||||
if err != nil {
|
||||
t.Fatalf("构建快照: %v", err)
|
||||
}
|
||||
if len(snap.LatestResults) != latestResultsGroupLimit {
|
||||
t.Fatalf("组数应封顶在 K=%d，得到 %d", latestResultsGroupLimit, len(snap.LatestResults))
|
||||
}
|
||||
if snap.LatestResults[0].EventID != events[groupCount-1] {
|
||||
t.Fatalf("最新发布的组应排在最前，得到小项 %d，期望 %d", snap.LatestResults[0].EventID, events[groupCount-1])
|
||||
}
|
||||
kept := make(map[int64]bool, len(snap.LatestResults))
|
||||
for _, group := range snap.LatestResults {
|
||||
kept[group.EventID] = true
|
||||
}
|
||||
if kept[events[0]] {
|
||||
t.Fatalf("最旧的那一组应被丢掉: %+v", snap.LatestResults)
|
||||
}
|
||||
for i := 1; i < groupCount; i++ {
|
||||
if !kept[events[i]] {
|
||||
t.Fatalf("最近发布的 %d 组都应保留，缺少小项 %d: %+v", latestResultsGroupLimit, events[i], snap.LatestResults)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 一次发布会把范围内的行刷成**同一个** verified_at（httpapi/scoring.go 的 setPublished 用
|
||||
// datetime('now')），所以现场最常见的形态是「组内行时间全并列、跨组也可能并列」。
|
||||
// 并列时按 r.id 决先后，组的顺序必须与旧实现逐位相同（行按 ts DESC, r.id DESC 取回、
|
||||
// 组按首次出现建号 → 时间并列时等于「组内最大 r.id」倒序），否则大屏的栏位会换位置。
|
||||
func TestSnapshotLatestResultsTiedPublishTimestamps(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
db := env.db
|
||||
|
||||
team1 := insertTeam(t, db, "T1", "第一单位", "")
|
||||
// 三组同一次发布：9:30:00 那一秒。
|
||||
const sameTS = "2026-09-09T09:30:00Z"
|
||||
const rowsPerGroup = 8
|
||||
|
||||
events := make([]int64, 3)
|
||||
// 造数顺序 = 发布顺序：先发第 3 栏那一组（建号最早），再发第 1、2 栏。
|
||||
insertOrder := []int{2, 0, 1}
|
||||
for _, col := range insertOrder {
|
||||
events[col] = insertRankedGroup(t, db, fmt.Sprintf("E%d", col+1),
|
||||
fmt.Sprintf("大屏第 %d 栏的小项", col+1), team1, rowsPerGroup,
|
||||
func(int) string { return sameTS })
|
||||
}
|
||||
|
||||
snap, err := env.hub.Snapshot(context.Background())
|
||||
if err != nil {
|
||||
t.Fatalf("构建快照: %v", err)
|
||||
}
|
||||
if len(snap.LatestResults) != 3 {
|
||||
t.Fatalf("三组都应下发，得到 %d 组", len(snap.LatestResults))
|
||||
}
|
||||
// 时间并列 → 靠 r.id 决先后：最后发布的那一组（第 2 栏）在最前，最先发布的（第 3 栏）在最后。
|
||||
wantOrder := []int{1, 0, 2}
|
||||
for i, col := range wantOrder {
|
||||
if snap.LatestResults[i].EventID != events[col] {
|
||||
t.Fatalf("并列时间的组顺序应与发布顺序相反，第 %d 位应是第 %d 栏的小项 %d，得到 %d",
|
||||
i+1, col+1, events[col], snap.LatestResults[i].EventID)
|
||||
}
|
||||
}
|
||||
byEvent := make(map[int64]dto.EventResultGroup, len(snap.LatestResults))
|
||||
for _, group := range snap.LatestResults {
|
||||
byEvent[group.EventID] = group
|
||||
}
|
||||
for col, eventID := range events {
|
||||
group := byEvent[eventID]
|
||||
if group.Rows[0].Rank == nil || *group.Rows[0].Rank != 1 {
|
||||
t.Fatalf("第 %d 栏应从第 1 名开始，实际名次 %v", col+1, ranksOf(group))
|
||||
}
|
||||
if len(group.Rows) != rowsPerGroup {
|
||||
t.Fatalf("第 %d 栏应有 %d 行，实际名次 %v", col+1, rowsPerGroup, ranksOf(group))
|
||||
}
|
||||
// 并列时间下组的发布时间也是同一条，不能变成「某一行的时间」以外的值。
|
||||
if group.PublishedAt == nil || *group.PublishedAt != sameTS {
|
||||
t.Fatalf("第 %d 栏的发布时间应是 %s，得到 %v", col+1, sameTS, group.PublishedAt)
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user