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
@@ -5,6 +5,7 @@ import (
|
||||
"database/sql"
|
||||
"encoding/json"
|
||||
"errors"
|
||||
"fmt"
|
||||
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/domain"
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/dto"
|
||||
@@ -583,6 +584,10 @@ func preferComputedRank(a, b domain.RankedResult) bool {
|
||||
// 空且状态为 ok 的行只是「还没跑 / 还没录」，发布时必须留在 draft：
|
||||
// 分批比赛时若把没跑的人一起置为 published，大屏的最新成绩会出现空行，
|
||||
// 而且编辑页会把整组当成「已发布」锁死，补录无门。
|
||||
//
|
||||
// 落在这一档里的还有「填了文本却没有成绩值」的草稿（客户端没算出 resultValue）：
|
||||
// 同样发不出去，但外表上像是录过了，所以发布时要单独计数并写进修订（countTextOnlyDrafts），
|
||||
// 不能让它静默消失。
|
||||
const publishableResultCond = `(result_value IS NOT NULL OR rank IS NOT NULL OR status <> 'ok')`
|
||||
|
||||
// publishableResult 是 publishableResultCond 的 Go 版判据，供分批结算的纯函数使用。
|
||||
@@ -675,6 +680,51 @@ func scopeSettled(ctx context.Context, q queryer, eventID, categoryID int64) (bo
|
||||
return published == total, nil
|
||||
}
|
||||
|
||||
// eventFullyPublished 判断整小项是否「所有该出成绩的报名项都已发布」。
|
||||
//
|
||||
// 判据与结算同源（scopeStats）：退赛 / 缺赛 / 失格的报名项不进分母，因为它们本来就不等成绩。
|
||||
// 必须要求 total > 0——一条报名项都没有的小项没有任何成绩可发，标成「已发布」是假信息。
|
||||
func eventFullyPublished(ctx context.Context, q queryer, eventID int64) (bool, error) {
|
||||
total, published, err := scopeStats(ctx, q, eventID, 0)
|
||||
if err != nil {
|
||||
return false, err
|
||||
}
|
||||
return total > 0 && published == total, nil
|
||||
}
|
||||
|
||||
// countTextOnlyDrafts 数出「这次发布带不上、看起来却已经录过」的草稿：
|
||||
// 有成绩文本，却没有成绩值、没有手工名次、状态也还是 ok。
|
||||
//
|
||||
// 这批行按 publishableResultCond 永远发不出去（缺的正是那个比较值），而发布接口照回 200：
|
||||
// 客户端只送 resultText 时成绩就这样静默漏掉。纯空行（连文本都没有）不算——
|
||||
// 分批比赛里「还没跑」是正常状态，一起数进去只会淹没真正的问题。
|
||||
func countTextOnlyDrafts(ctx context.Context, q queryer, eventID, categoryID int64) (int, error) {
|
||||
query := `SELECT COUNT(*) FROM results r
|
||||
JOIN entries e ON e.id = r.entry_id
|
||||
WHERE r.event_id = ? AND r.state = 'draft'
|
||||
AND r.result_value IS NULL AND r.rank IS NULL AND r.status = 'ok'
|
||||
AND TRIM(COALESCE(r.result_text, '')) <> ''`
|
||||
args := []any{eventID}
|
||||
if categoryID > 0 {
|
||||
query += ` AND e.category_id = ?`
|
||||
args = append(args, categoryID)
|
||||
}
|
||||
var n int
|
||||
if err := q.QueryRowContext(ctx, query, args...).Scan(&n); err != nil {
|
||||
return 0, internal(err)
|
||||
}
|
||||
return n, nil
|
||||
}
|
||||
|
||||
// skipNote 把「跳过多少条只填了文本的草稿」写成给现场看的一句话，没有跳过时为空串
|
||||
// （空串不落显眼文案，变更历史里也不会多出一行无用说明）。
|
||||
func skipNote(skipped int) string {
|
||||
if skipped == 0 {
|
||||
return ""
|
||||
}
|
||||
return fmt.Sprintf("跳过 %d 条只填了成绩文本、没有成绩值的草稿（本次未上屏，补上成绩值后重新发布）", skipped)
|
||||
}
|
||||
|
||||
// liveOnPublishQ 读「发布后是否立即结算」：缺键 / 脏值一律按开启处理，保证历史行为。
|
||||
func liveOnPublishQ(ctx context.Context, q queryer) (bool, error) {
|
||||
var raw string
|
||||
@@ -723,6 +773,18 @@ func (s *server) publishResults(ctx context.Context, in publishPayload, userID i
|
||||
if _, err := tx.ExecContext(ctx, setPublished, args...); err != nil {
|
||||
return nil, internal(err)
|
||||
}
|
||||
// 没被带上的「只有成绩文本」的草稿要报出来：它们按 publishableResultCond 永远发不出去
|
||||
// （既没有成绩值、也没有手工名次、状态还是 ok），而接口照样回 200。
|
||||
// 客户端只送 resultText 时成绩就这样静默漏掉，现场几乎发现不了；数出来写进本次修订
|
||||
// （变更历史会显示），并留一条服务端日志。纯空行不算——分批比赛里「还没跑」是正常状态。
|
||||
skipped, err := countTextOnlyDrafts(ctx, tx, in.EventID, catID)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
if skipped > 0 {
|
||||
s.logger.Warn("发布跳过了只填成绩文本的草稿",
|
||||
"eventId", in.EventID, "categoryId", catID, "count", skipped)
|
||||
}
|
||||
|
||||
live, err := liveOnPublishQ(ctx, tx)
|
||||
if err != nil {
|
||||
@@ -752,7 +814,20 @@ func (s *server) publishResults(ctx context.Context, in publishPayload, userID i
|
||||
return nil, err
|
||||
}
|
||||
}
|
||||
if catID == 0 {
|
||||
// 小项进度（events.status）里的 published 只有一种含义：整项都发完了。
|
||||
// 整项发布（catID == 0）由调用方明确声明，照旧直接写；按组别发布则要先确认整项所有
|
||||
// 该出成绩的报名项都已发布——录入页永远带 categoryId，少了这一步，「一组一组发完」的
|
||||
// 小项在界面上会一直停在「待录入」，侧栏与仪表盘的已发布计数也永远漏掉它。
|
||||
// 还没发完时一个字符都不写：一组发布 ≠ 整项已发布，把状态写成 published 只会制造
|
||||
// 「已发布」的假象（大屏 / 导出虽然不读这一列，人读）。
|
||||
done := catID == 0
|
||||
if !done {
|
||||
done, err = eventFullyPublished(ctx, tx, in.EventID)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
}
|
||||
if done {
|
||||
if _, err := tx.ExecContext(ctx, `UPDATE events SET status = 'published' WHERE id = ?`, in.EventID); err != nil {
|
||||
return nil, internal(err)
|
||||
}
|
||||
@@ -762,7 +837,7 @@ func (s *server) publishResults(ctx context.Context, in publishPayload, userID i
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
if err := recordRevision(ctx, tx, in.EventID, "publish", after, userID, ""); err != nil {
|
||||
if err := recordRevision(ctx, tx, in.EventID, "publish", after, userID, skipNote(skipped)); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
if err := recordChanges(ctx, tx, "result", after, "upsert", userID); err != nil {
|
||||
@@ -834,10 +909,16 @@ func (s *server) unpublishResults(ctx context.Context, in publishPayload, userID
|
||||
if _, err := recomputeLedgerTx(ctx, tx, in.EventID, catID, userID, "撤销发布"); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
if catID == 0 {
|
||||
if _, err := tx.ExecContext(ctx, `UPDATE events SET status = 'finished' WHERE id = ?`, in.EventID); err != nil {
|
||||
return nil, internal(err)
|
||||
}
|
||||
// 小项进度与发布对称地退回：整项撤销到 finished（与既有行为一致）；
|
||||
// 按组别撤销只在整项此前被标成 published 时降级——这次撤销让整项不再是「全部已发布」，
|
||||
// 状态不跟着退，界面就会写着「已发布」而其中一组其实已经撤回。
|
||||
// pending / ongoing 是人工设的进度，这里不覆盖。
|
||||
revert := `UPDATE events SET status = 'finished' WHERE id = ?`
|
||||
if catID > 0 {
|
||||
revert += ` AND status = 'published'`
|
||||
}
|
||||
if _, err := tx.ExecContext(ctx, revert, in.EventID); err != nil {
|
||||
return nil, internal(err)
|
||||
}
|
||||
|
||||
after, err := queryResults(ctx, tx, `SELECT `+resultColumns+` FROM results WHERE event_id = ?`, in.EventID)
|
||||
@@ -1071,15 +1152,21 @@ func recordRevision(ctx context.Context, tx *sql.Tx, eventID int64, action strin
|
||||
if err != nil {
|
||||
return internal(err)
|
||||
}
|
||||
// 父节点 = 该小项最近一次版本，串成一条主线；撤销后再发布会自然从撤销点分出新分支。
|
||||
// 父节点 = 该小项当前的 MAX(id)，即上一条版本：一个小项串成**一条链**。
|
||||
// 撤销后再发布也是接在链尾（新行 id 最大，就是上一条），**不会从撤销点分出分支**——
|
||||
// result_revisions 实际不是 DAG（P2-C06）。每个小项的第一条版本 parent_id 为 NULL。
|
||||
var parentID sql.NullInt64
|
||||
if err := tx.QueryRowContext(ctx,
|
||||
`SELECT MAX(id) FROM result_revisions WHERE event_id = ?`, eventID).Scan(&parentID); err != nil {
|
||||
return internal(err)
|
||||
}
|
||||
// 这条 INSERT 不再写 ledger_ids：该列从来没有读取侧（变更历史只读 snapshot / action /
|
||||
// message），前端却按它渲染「积分流水 N 条」，于是每次发布都在变更历史里显示 0 条——
|
||||
// 一句对用户可见的错信息。收口方向是连同前端那一栏一起删掉，写入侧先与它脱钩：
|
||||
// 列上有 NOT NULL DEFAULT '[]'，不写照样满足约束，删列迁移落地后这条语句也依然成立。
|
||||
_, err = tx.ExecContext(ctx,
|
||||
`INSERT INTO result_revisions (parent_id, event_id, action, snapshot_json, ledger_ids, actor_id, message)
|
||||
VALUES (?, ?, ?, ?, '[]', ?, ?)`,
|
||||
`INSERT INTO result_revisions (parent_id, event_id, action, snapshot_json, actor_id, message)
|
||||
VALUES (?, ?, ?, ?, ?, ?)`,
|
||||
parentID, eventID, action, string(snapshot), nullID(actorID), message)
|
||||
if err != nil {
|
||||
return internal(err)
|
||||
|
||||
Reference in new issue
Block a user