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:
1 parent
db94d9c119
commit
6841cf49aa
147 files changed
+8141
-423
No files matched your search
@@ -1,11 +1,15 @@
|
||||
package main
|
||||
|
||||
import (
|
||||
"bytes"
|
||||
"log/slog"
|
||||
"os"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"testing"
|
||||
"time"
|
||||
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/export"
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/httpapi"
|
||||
)
|
||||
|
||||
@@ -253,3 +257,99 @@ func TestInitialAdminBannerAsciiAnchor(t *testing.T) {
|
||||
t.Fatalf("ASCII 锚应在密码行之后:\n%s", banner)
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- C35:恢复标记的启动告警 ----------
|
||||
|
||||
// writeRestoreMarker 用真实写入路径(export.WritePendingRestore)造一份恢复标记,
|
||||
// 字段名与落盘格式都跟「一键恢复」写下的那份一模一样。
|
||||
func writeRestoreMarker(t *testing.T, dataDir string, p export.PendingRestore) string {
|
||||
t.Helper()
|
||||
path, err := export.WritePendingRestore(dataDir, p)
|
||||
if err != nil {
|
||||
t.Fatalf("写恢复标记: %v", err)
|
||||
}
|
||||
return path
|
||||
}
|
||||
|
||||
// sampleRestoreMarker 是一份典型的「恢复写到一半进程没了」的标记。
|
||||
func sampleRestoreMarker() export.PendingRestore {
|
||||
return export.PendingRestore{
|
||||
Kind: export.RestoreKindEvent,
|
||||
Backup: "/data/backups/event-manual-20260911-201500.db",
|
||||
BackupName: "event-manual-20260911-201500.db",
|
||||
Target: "/data/event_projs/autumn/event.db",
|
||||
SafetyCopy: "/data/backups/pre-restore-event-20260911-201503.db",
|
||||
Operator: "admin#1",
|
||||
RequestedAt: time.Date(2026, 9, 11, 20, 15, 3, 0, time.UTC),
|
||||
}
|
||||
}
|
||||
|
||||
// 恢复标记留在数据目录里 = 上一次恢复没走完。启动时必须读到它并告警,
|
||||
// 且告警要带上「盖的是哪个库、用哪份备份、退回用的安全副本是哪份、谁点的」——
|
||||
// 只说一句「有残留文件」,现场还是不知道该怎么办。
|
||||
func TestWarnPendingRestoreReportsMarker(t *testing.T) {
|
||||
dataDir := t.TempDir()
|
||||
marker := writeRestoreMarker(t, dataDir, sampleRestoreMarker())
|
||||
|
||||
buf := &bytes.Buffer{}
|
||||
logger := slog.New(slog.NewJSONHandler(buf, nil))
|
||||
warnPendingRestore(logger, dataDir)
|
||||
|
||||
logs := buf.String()
|
||||
for _, want := range []string{
|
||||
`"level":"WARN"`,
|
||||
"未收尾",
|
||||
sampleRestoreMarker().BackupName,
|
||||
sampleRestoreMarker().Target,
|
||||
sampleRestoreMarker().SafetyCopy,
|
||||
sampleRestoreMarker().Operator,
|
||||
"2026-09-11T20:15:03Z",
|
||||
} {
|
||||
if !strings.Contains(logs, want) {
|
||||
t.Fatalf("启动告警应含 %q,得到:\n%s", want, logs)
|
||||
}
|
||||
}
|
||||
// 只告警、不删:这份标记是那次未收尾恢复的唯一记录,删不删该由操作员决定。
|
||||
if _, err := os.Stat(marker); err != nil {
|
||||
t.Fatalf("告警不该动这份标记(它是唯一线索): %v", err)
|
||||
}
|
||||
}
|
||||
|
||||
// 没有标记时一个字都不许刷:正常启动的日志里出现「未收尾」会把人引向不存在的事故。
|
||||
func TestWarnPendingRestoreSilentWithoutMarker(t *testing.T) {
|
||||
buf := &bytes.Buffer{}
|
||||
logger := slog.New(slog.NewJSONHandler(buf, nil))
|
||||
warnPendingRestore(logger, t.TempDir())
|
||||
if buf.Len() != 0 {
|
||||
t.Fatalf("没有恢复标记时不该产生任何日志,得到:\n%s", buf.String())
|
||||
}
|
||||
}
|
||||
|
||||
// 标记内容坏了(写了一半 / 被人手工改坏)不能拦启动、也不能静默:要告警说明这个文件有问题。
|
||||
func TestWarnPendingRestoreToleratesBrokenMarker(t *testing.T) {
|
||||
dataDir := t.TempDir()
|
||||
path := filepath.Join(dataDir, export.PendingRestoreFile)
|
||||
if err := os.WriteFile(path, []byte("{不是 JSON"), 0o644); err != nil {
|
||||
t.Fatalf("写坏标记: %v", err)
|
||||
}
|
||||
|
||||
buf := &bytes.Buffer{}
|
||||
logger := slog.New(slog.NewJSONHandler(buf, nil))
|
||||
warnPendingRestore(logger, dataDir)
|
||||
|
||||
if !strings.Contains(buf.String(), "无法解析") || !strings.Contains(buf.String(), path) {
|
||||
t.Fatalf("坏标记应告警并指出文件路径,得到:\n%s", buf.String())
|
||||
}
|
||||
}
|
||||
|
||||
// 光测上面那几个函数还不够:漏掉 main 里那一行调用,标记照样没人读(这正是 C35 的原状——
|
||||
// 写入方齐全、读取方为零)。这里连同调用点一起钉住,参考网页侧「模板契约断言」的做法。
|
||||
func TestMainReadsPendingRestoreMarkerAtStartup(t *testing.T) {
|
||||
raw, err := os.ReadFile("main.go")
|
||||
if err != nil {
|
||||
t.Fatalf("读 main.go: %v", err)
|
||||
}
|
||||
if !strings.Contains(string(raw), "warnPendingRestore(logger, cfg.DataDir)") {
|
||||
t.Fatalf("main.go 里找不到启动时读恢复标记的调用:标记又会变回没人读的孤儿文件")
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user