fix(p2): 按审查清单修 103 条「建议修」+ 奖牌榜改名 + 两个守卫（dev_0.2.0）
## 奖牌榜改名（主人要求）
「团体奖牌榜」→「单位奖牌榜」，界面 / 大屏渲染页 / 导出件（工作表名与
下载文件名 `单位奖牌明细.xlsx`）/ 用户文档 全部统一；`DISPLAY_PAGES` 是
大屏控制页与大屏页的共同来源，改一处两边同时生效。旧名保留为别名，
老链接与老配置（`display.pages`）照常有效。真 Chromium 验证：14 个管理端
路由 + 7 个基础数据分区 0 报错，大屏页标题已是「单位奖牌榜」。
## P2 清单（123 条，103 条标「建议修」）
按 A/B/C/D 分组、以「文件所有权互斥」分 10 个代理并行推进，另有独立复核
代理逐条核对：61 条声称已修 / 55 条证实 / 4 条部分 / 0 条不成立 / 0 垃圾。
主要交付（按风险从高到低）：
- 写入侧校验：update 路径补必填与 TrimSpace、模板 rules 重复 rank、
「小项不存在」的四种回答、`defaultProfileId` 外键、decodeJSON 的 8MB
上限与 413（A01–A06、D02、D03 批量上限 500）
- 危险操作：一键恢复加互斥（第二个请求当场 409）、恢复超时不再说
「未执行」、`ConfirmDialog` pending 时锁死 ESC/遮罩/关闭
- 认证：改密与撤会话进同一事务、滑动续期写库失败不再假装成功、
CSRF Cookie 丢失自动补发、密码长度按字符（原按字节）、
反代 403 只在可信代理透传原 Host 时采信 `X-Forwarded-Host`（全等比较）、
过期会话定期清理、登出补审计、登录限流可配
- 数据可见性：导出「已发布未结算」行改为 `名次 — / 积分 — / 状态未结算`、
单位积分明细成绩列与其它导出件逐字一致、空单位也打合计行、
基础数据包命中「已彻底删除的单位」整行跳过并报界面路径、
报名导入换单位给明确提示、勾选报名有冲突不再假报成功
- 导入/导出：赛事包上限 512MB（**它是唯一带字体/图片的包**，字体上限
20MB）而 multipart 内存档位独立钉在 16MB、工作簿表名尾随空格、
导出件路由与文件名契约补全
- 前端：一次写请求只生成一个 requestId（幂等缓存此前从未命中）、
基础数据包补 `X-Request-Id`、示例数据模式禁写扩到撤销发布/存草稿、
访客 401 不再是裸错误、模板 `{{else if}}` 不再静默吞内容
- Console：按设计退出（切赛事/恢复）不再判成崩溃、旧数据目录读不出来
会记日志、渲染层日志按上限截断、`service.js` 补 17 例测试
## 测试
服务端用例 610 → 674（13 包全绿，新增老库跨九条迁移升级、panic 形状、
429 落 interceptions、三态对照、avg_mode 分母、会话失效、请求体上限等）
前端 449 → 531（vue-tsc + build 通过）；Console 28 → 54（19 个文件）。
另修复一条会让整包挂死 600s 的用例（测试主协程堵在 client.Do，defer
轮不到执行 → 改为可取消 + 探针超时，改坏也 7.5s 快速失败）。
## 两个新守卫（防止再出现「组件 setup 抛异常」这类盲区）
- `web/scripts/check-declaration-order.mjs` 已进测试命令：沿 watch/
watchEffect 的 const 依赖链查 TDZ（正是「运动员页整块空白」的根因）
- `web/scripts/smoke-admin.mjs`（`pnpm smoke`）：真 Chromium 点遍 14 个
管理端路由 + 7 个基础数据分区 + 大屏页，任何 console 错误即失败
## 文档
- `docs/升级说明.md` 新增 dev_0.2.0 一节（三件升级必知：改名、审计前缀
与历史记录、密码口径；现场变化；赛事包上限；反代与 CSRF）
- 使用手册 / 常见问题 / 部署指南 / 上线检查清单按实现同步
This commit is contained in:
AskaEth committed
1 parent
db94d9c119
commit
6841cf49aa
147 files changed
+8141
-423
No files matched your search
@@ -1,6 +1,7 @@
|
||||
package realtime
|
||||
|
||||
import (
|
||||
"bytes"
|
||||
"context"
|
||||
"database/sql"
|
||||
"encoding/json"
|
||||
@@ -13,6 +14,7 @@ import (
|
||||
"path/filepath"
|
||||
"reflect"
|
||||
"strings"
|
||||
"sync"
|
||||
"sync/atomic"
|
||||
"testing"
|
||||
"time"
|
||||
@@ -50,9 +52,17 @@ func newTestEnvAs(t *testing.T, u *auth.User) *testEnv {
|
||||
// *auth.Session：会话复查（撤销即断开）要按会话 id 判定，测试必须能给出这一条。
|
||||
func newTestEnvAsSession(t *testing.T, u *auth.User, sessionID string) *testEnv {
|
||||
t.Helper()
|
||||
return newTestEnvFull(t, u, sessionID, io.Discard)
|
||||
}
|
||||
|
||||
// newTestEnvFull 与 newTestEnvAsSession 相同，但把实时层的日志写进调用方给的 writer，
|
||||
// 且放行 Debug：需要断言「这条路径不该刷 WARN/ERROR」的用例（如恢复窗口降级）用它。
|
||||
// 其余用例传 io.Discard，行为与以前一致。
|
||||
func newTestEnvFull(t *testing.T, u *auth.User, sessionID string, logw io.Writer) *testEnv {
|
||||
t.Helper()
|
||||
|
||||
db := newTestDB(t)
|
||||
h := NewHub(db, slog.New(slog.NewTextHandler(io.Discard, &slog.HandlerOptions{Level: slog.LevelError})))
|
||||
h := NewHub(db, slog.New(slog.NewTextHandler(logw, &slog.HandlerOptions{Level: slog.LevelDebug})))
|
||||
handler := h.Handler()
|
||||
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
||||
ctx := middleware.WithUser(r.Context(), u)
|
||||
@@ -934,6 +944,40 @@ func TestSendCommandTargetsMixedOnlineOffline(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// targets 里带空白（管理端从表格/粘贴里带过来的 id）时，匹配与「当前页」写入必须用
|
||||
// 同一个归一化后的值：以前匹配走 TrimSpace、写注册表用原值，结果是指令真的发到了那块屏，
|
||||
// 注册表里的当前页却停在旧值上，管理端下一次轮询又把界面上刚切过去的页显示回来。
|
||||
func TestSendCommandTargetsTrimsWhitespaceForPageRegistry(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
a := env.dial(t, &helloPayload{Role: RoleDisplay, InstanceID: "screen-a", Page: "standings"})
|
||||
b := env.dial(t, &helloPayload{Role: RoleDisplay, InstanceID: "screen-b", Page: "standings"})
|
||||
a.recvEvent(EventSnapshot)
|
||||
b.recvEvent(EventSnapshot)
|
||||
|
||||
cmd, err := NewDisplayCommand(CmdGoto, map[string]string{"page": "medals"})
|
||||
if err != nil {
|
||||
t.Fatalf("构造 goto: %v", err)
|
||||
}
|
||||
matched, err := env.hub.SendCommandToInstances([]string{" screen-a \n"}, cmd)
|
||||
if err != nil {
|
||||
t.Fatalf("定向下发: %v", err)
|
||||
}
|
||||
if matched != 1 {
|
||||
t.Fatalf("带空白的 id 应命中 1 个实例，得到 %d", matched)
|
||||
}
|
||||
if got := decode[DisplayCommand](t, a.recvEvent(EventDisplayCommand)); got.Action != CmdGoto {
|
||||
t.Fatalf("被点名的实例应收到 goto，得到 %s", got.Action)
|
||||
}
|
||||
|
||||
insts := env.hub.Instances()
|
||||
if got := instancePage(insts, "screen-a"); got != "medals" {
|
||||
t.Fatalf("被点名实例的当前页应更新为 medals，得到 %q", got)
|
||||
}
|
||||
if got := instancePage(insts, "screen-b"); got != "standings" {
|
||||
t.Fatalf("未被点名实例的当前页不该变，得到 %q", got)
|
||||
}
|
||||
}
|
||||
|
||||
// 非法 action 走定向通道要报错，不能静默丢掉。
|
||||
func TestSendCommandTargetsRejectsUnknownAction(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
@@ -1399,3 +1443,237 @@ func TestPendingSnapshotFlushIsPerConnection(t *testing.T) {
|
||||
a.noSnapshotWithin(300 * time.Millisecond)
|
||||
b.noSnapshotWithin(300 * time.Millisecond)
|
||||
}
|
||||
|
||||
// ---------- 在线判定 / 握手期限 / 恢复窗口降级 ----------
|
||||
|
||||
// syncBuffer 是带锁的日志缓冲：日志由实时层的多条 goroutine 写、用例在主 goroutine 读。
|
||||
type syncBuffer struct {
|
||||
mu sync.Mutex
|
||||
buf bytes.Buffer
|
||||
}
|
||||
|
||||
func (b *syncBuffer) Write(p []byte) (int, error) {
|
||||
b.mu.Lock()
|
||||
defer b.mu.Unlock()
|
||||
return b.buf.Write(p)
|
||||
}
|
||||
|
||||
func (b *syncBuffer) String() string {
|
||||
b.mu.Lock()
|
||||
defer b.mu.Unlock()
|
||||
return b.buf.String()
|
||||
}
|
||||
|
||||
// tune 直接改内部参数：这些值只影响超时，用例需要的是毫秒级跑完，
|
||||
// 而 Set* 那一族是留给现场调优的（且本包不该再为测试多开一个导出 API）。
|
||||
func (e *testEnv) tune(fn func(h *Hub)) {
|
||||
e.hub.mu.Lock()
|
||||
defer e.hub.mu.Unlock()
|
||||
fn(e.hub)
|
||||
}
|
||||
|
||||
// waitForWithin 与 waitFor 相同，只是等待窗口由调用方给：有的用例要等一次完整的
|
||||
// 服务端关闭握手（serve 里最多 2s）。
|
||||
func waitForWithin(t *testing.T, what string, d time.Duration, cond func() bool) {
|
||||
t.Helper()
|
||||
deadline := time.Now().Add(d)
|
||||
for time.Now().Before(deadline) {
|
||||
if cond() {
|
||||
return
|
||||
}
|
||||
time.Sleep(5 * time.Millisecond)
|
||||
}
|
||||
t.Fatalf("等待条件超时: %s", what)
|
||||
}
|
||||
|
||||
func instanceOnline(insts []Instance, id string) bool {
|
||||
for _, st := range insts {
|
||||
if st.ID == id {
|
||||
return st.Online
|
||||
}
|
||||
}
|
||||
return false
|
||||
}
|
||||
|
||||
// trySend 发送一帧并在失败时返回错误：用例要靠它判断「服务端已经关掉这条连接」
|
||||
// （普通 send 会直接 Fatal，那条路径在这里是预期结果而不是失败）。
|
||||
func (c *wsClient) trySend(event string, data any) error {
|
||||
msg, err := encode(event, data)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
ctx, cancel := context.WithTimeout(c.ctx, 2*time.Second)
|
||||
defer cancel()
|
||||
return c.conn.Write(ctx, websocket.MessageText, msg)
|
||||
}
|
||||
|
||||
// muteConn 是一条「连上就不再读」的客户端：它的 TCP 连接还在，但永远不会回应 pong——
|
||||
// 这正是拔网线 / 断电 / 机器休眠之后，服务端那一侧看到的样子。
|
||||
type muteConn struct {
|
||||
t *testing.T
|
||||
ctx context.Context
|
||||
conn *websocket.Conn
|
||||
}
|
||||
|
||||
func dialMute(t *testing.T, env *testEnv, hello helloPayload) *muteConn {
|
||||
t.Helper()
|
||||
|
||||
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
|
||||
conn, _, err := websocket.Dial(ctx, "ws"+strings.TrimPrefix(env.srv.URL, "http")+"/ws", nil)
|
||||
if err != nil {
|
||||
cancel()
|
||||
t.Fatalf("连接 /ws: %v", err)
|
||||
}
|
||||
t.Cleanup(func() {
|
||||
_ = conn.CloseNow()
|
||||
cancel()
|
||||
})
|
||||
|
||||
c := &muteConn{t: t, ctx: ctx, conn: conn}
|
||||
if err := c.send(EventHello, hello); err != nil {
|
||||
t.Fatalf("发送 hello: %v", err)
|
||||
}
|
||||
return c
|
||||
}
|
||||
|
||||
func (c *muteConn) send(event string, data any) error {
|
||||
msg, err := encode(event, data)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
ctx, cancel := context.WithTimeout(c.ctx, 5*time.Second)
|
||||
defer cancel()
|
||||
return c.conn.Write(ctx, websocket.MessageText, msg)
|
||||
}
|
||||
|
||||
// 「在线」必须反映真的还活着：连接对象还在、但对端已经不应答的屏不能一直算命中。
|
||||
// 判据是真实的 ping/pong 往返，不是服务端自己刷的时间戳。
|
||||
func TestInstanceGoesOfflineWhenPeerStopsAnswering(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
env.tune(func(h *Hub) {
|
||||
h.livenessInterval = 80 * time.Millisecond
|
||||
h.pongTimeout = 60 * time.Millisecond
|
||||
})
|
||||
|
||||
// 失联的屏：握手正常，之后一个字节都不回。
|
||||
dialMute(t, env, helloPayload{Role: RoleDisplay, InstanceID: "mute-1", Page: "standings"})
|
||||
waitFor(t, "失联实例登记在线", func() bool {
|
||||
insts := env.hub.Instances()
|
||||
return len(insts) == 1 && insts[0].Online
|
||||
})
|
||||
|
||||
// 正常的大屏同时挂着：它一直在收（于是自动回 pong），绝不能被误判成离线。
|
||||
alive := env.dial(t, &helloPayload{Role: RoleDisplay, InstanceID: "alive-1", Page: "standings"})
|
||||
alive.recvEvent(EventSnapshot)
|
||||
|
||||
waitForWithin(t, "失联实例被判离线", 5*time.Second, func() bool {
|
||||
return !instanceOnline(env.hub.Instances(), "mute-1")
|
||||
})
|
||||
if !instanceOnline(env.hub.Instances(), "alive-1") {
|
||||
t.Fatal("正常应答的实例不该被判离线")
|
||||
}
|
||||
|
||||
cmd, err := NewDisplayCommand(CmdReload, nil)
|
||||
if err != nil {
|
||||
t.Fatalf("构造 reload: %v", err)
|
||||
}
|
||||
if matched, err := env.hub.SendCommandToInstances([]string{"mute-1"}, cmd); err != nil || matched != 0 {
|
||||
t.Fatalf("失联实例不该再计入命中，得到 %d err=%v", matched, err)
|
||||
}
|
||||
// 在线的屏不受影响：它的连接与服务端之间一切照旧。
|
||||
if ev, _, ok := alive.recvWithin(200 * time.Millisecond); ok {
|
||||
t.Fatalf("正常实例不该收到额外消息，得到 %q", ev)
|
||||
}
|
||||
}
|
||||
|
||||
// 握手超时是**绝对** deadline：以前每轮 Read 都重开一个 helloTimeout 窗口，
|
||||
// 没握手的连接只要在窗口内随便发一帧就能无限期挂着（脚本重连能堆出一片空连接）。
|
||||
func TestHelloDeadlineIsAbsolute(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
env.tune(func(h *Hub) { h.helloTO = 300 * time.Millisecond })
|
||||
|
||||
// 不 hello，只反复喂合法但无关的帧（ack）。
|
||||
c := env.dial(t, nil)
|
||||
|
||||
closed := false
|
||||
deadline := time.Now().Add(1500 * time.Millisecond)
|
||||
for time.Now().Before(deadline) && !closed {
|
||||
select {
|
||||
case msg, ok := <-c.msgs:
|
||||
if !ok || msg.err != nil {
|
||||
closed = true
|
||||
}
|
||||
case <-time.After(60 * time.Millisecond):
|
||||
// 写失败说明服务端已经关了这条连接，同样算「已断开」。
|
||||
closed = c.trySend(EventAck, ackPayload{}) != nil
|
||||
}
|
||||
}
|
||||
if !closed {
|
||||
t.Fatal("未握手的连接必须在绝对 deadline（300ms）后被断开，而不是每收一帧就重置计时")
|
||||
}
|
||||
}
|
||||
|
||||
// 心跳循环不能替客户端盖「最后活跃」的章：一块不发任何上行帧的大屏，它的
|
||||
// LastHeartbeat 必须停在真实收到帧的那一刻，否则注册表里的「在线/最后活跃」
|
||||
// 全是服务端自己说的，拔了网线的屏也会显示成刚刚活跃（这正是 A24 的根因）。
|
||||
func TestHeartbeatDoesNotRefreshActivityByItself(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
env.hub.SetHeartbeatInterval(30 * time.Millisecond)
|
||||
// 关掉存活探测：这条用例只验证「时间戳的口径」，探测本身另有用例。
|
||||
env.tune(func(h *Hub) { h.livenessInterval = 0 })
|
||||
|
||||
c := env.dial(t, &helloPayload{Role: RoleDisplay, InstanceID: "d1"})
|
||||
c.recvEvent(EventSnapshot)
|
||||
|
||||
insts := env.hub.Instances()
|
||||
if len(insts) != 1 {
|
||||
t.Fatalf("实例数应为 1，得到 %d", len(insts))
|
||||
}
|
||||
before := insts[0].LastHeartbeat
|
||||
|
||||
// 连收 5 个心跳，期间客户端一个上行帧都不发（它只读）。
|
||||
for i := 0; i < 5; i++ {
|
||||
c.recvEvent(EventHeartbeat)
|
||||
}
|
||||
if got := env.hub.Instances()[0].LastHeartbeat; !got.Equal(before) {
|
||||
t.Fatalf("服务端自己发心跳不能把「最后活跃」往前推：%v → %v", before, got)
|
||||
}
|
||||
}
|
||||
|
||||
// 恢复窗口（库已经关掉、文件还没换完）里实时层必须安静下来：不刷 WARN/ERROR，
|
||||
// 也不拿 1011 把刚连上或正在重连的屏踢回去——现场会把那读成「恢复把系统搞坏了」。
|
||||
// 降级口径与 httpapi/realtime.go 的 dbClosed 一致：只记 Debug，连接留着、心跳照发。
|
||||
func TestRecoveryWindowDegradesQuietly(t *testing.T) {
|
||||
logs := &syncBuffer{}
|
||||
env := newTestEnvFull(t, &auth.User{Role: auth.RoleGuest}, "", logs)
|
||||
env.hub.SetHeartbeatInterval(40 * time.Millisecond)
|
||||
env.hub.SetSnapshotMinInterval(0)
|
||||
|
||||
c := env.dial(t, &helloPayload{Role: RoleDisplay, InstanceID: "d1"})
|
||||
c.recvEvent(EventSnapshot)
|
||||
|
||||
// 模拟恢复动作的中间状态：目标库被关掉（换文件前的一刻）。
|
||||
if err := env.db.Close(); err != nil {
|
||||
t.Fatalf("关闭赛事库: %v", err)
|
||||
}
|
||||
|
||||
// 大屏想补数据（resync）：这条路径在恢复窗口里必然读不到库。
|
||||
c.send(EventResync, struct{}{})
|
||||
// 连接必须留着，心跳照常下发（被 1011 打回时 recvWithin 会直接 Fatal）。
|
||||
if ev, _, ok := c.recvWithin(2 * time.Second); !ok || ev != EventHeartbeat {
|
||||
t.Fatalf("恢复窗口里已连接的屏应保持在线并继续收心跳，得到 %q ok=%v", ev, ok)
|
||||
}
|
||||
// 恢复窗口里新连上的屏同理：首包拿不到也不能被踢。
|
||||
fresh := env.dial(t, &helloPayload{Role: RoleDisplay, InstanceID: "d2"})
|
||||
if ev, _, ok := fresh.recvWithin(2 * time.Second); !ok || ev != EventHeartbeat {
|
||||
t.Fatalf("恢复窗口里新连接应保持并收到心跳，得到 %q ok=%v", ev, ok)
|
||||
}
|
||||
|
||||
got := logs.String()
|
||||
if strings.Contains(got, "level=ERROR") || strings.Contains(got, "level=WARN") {
|
||||
t.Fatalf("恢复窗口里不该出现 WARN/ERROR 日志:\n%s", got)
|
||||
}
|
||||
if !strings.Contains(got, "库已关闭") {
|
||||
t.Fatalf("恢复窗口应留下 Debug 级的降级记录（否则真出问题时无从查起）:\n%s", got)
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user