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,6 +1,7 @@
|
||||
package httpapi_test
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
"net/http"
|
||||
"testing"
|
||||
"time"
|
||||
@@ -224,6 +225,98 @@ func TestBatchRejectsBadInput(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// batchLimit 是服务端单次批量动作的人数上限(`maxAthleteBatch`,与 `entries/batch` 的
|
||||
// `maxEntryBatch` 刻意同值 500)。用例在 httpapi 包外,拿不到那个常量,只能写字面量:
|
||||
// 上限一旦改动,这里与 devdocs/05 会一起变红,正好逼着同步改口径与文档。
|
||||
const batchLimit = 500
|
||||
|
||||
// 超限(上限 + 1):400,响应体与同一个接口上既有的 400 同构,且一个人都不动。
|
||||
//
|
||||
// 用「上限 + 1」构造,不真发几万条:拦的是条数,与 id 具体是什么无关;
|
||||
// 但条数是真做满的(全是库里存在的人),删掉上限检查后这一批会被真的停用,
|
||||
// 用例只能靠状态码与文案变红,不会靠「id 不存在」之类的旁证蒙对。
|
||||
func TestBatchRejectsOverLimit(t *testing.T) {
|
||||
env, ids, client := recorderWithSeed(t)
|
||||
|
||||
targets := []int64{ids.athleteA, ids.athB}
|
||||
targets = append(targets, seedAthleteBatch(t, env, ids.teamA, batchLimit+1-len(targets))...)
|
||||
|
||||
status, env2 := env.do(client, http.MethodPost, "/api/athletes/batch",
|
||||
map[string]any{"action": "disable", "ids": targets}, true)
|
||||
if status != http.StatusBadRequest {
|
||||
t.Fatalf("超限应 400,得到 %d %+v", status, env2.Error)
|
||||
}
|
||||
if env2.OK || env2.Error == nil {
|
||||
t.Fatalf("超限应回 {ok:false,error},得到 %+v", env2)
|
||||
}
|
||||
want := fmt.Sprintf("一次最多处理 %d 名运动员,请分批提交", batchLimit)
|
||||
if env2.Error.Message != want {
|
||||
t.Fatalf("超限文案应为 %q,得到 %q", want, env2.Error.Message)
|
||||
}
|
||||
|
||||
// 「与既有 400 同构」:拿同一个接口上既有的入参错误逐字段比,只允许 message 不同。
|
||||
// 对照用「ids 不能为空」(detail 为 nil),与超限同为「只给一句话」的校验。
|
||||
refStatus, ref := env.do(client, http.MethodPost, "/api/athletes/batch",
|
||||
map[string]any{"action": "disable", "ids": []int64{}}, true)
|
||||
if refStatus != http.StatusBadRequest || ref.Error == nil {
|
||||
t.Fatalf("对照组(ids 为空)应 400,得到 %d %+v", refStatus, ref)
|
||||
}
|
||||
if env2.OK != ref.OK || env2.Error.Code != ref.Error.Code ||
|
||||
(env2.Error.Detail == nil) != (ref.Error.Detail == nil) {
|
||||
t.Fatalf("超限的 400 应与既有 400 同构,得到 %+v / %+v", env2.Error, ref.Error)
|
||||
}
|
||||
|
||||
// 先校验、后动作:被拒的请求一个人都不能停用。
|
||||
if n := countRows(t, env, `SELECT COUNT(*) FROM athletes WHERE active = 0`); n != 0 {
|
||||
t.Fatalf("超限被拒后不该停用任何人,得到 %d 人", n)
|
||||
}
|
||||
}
|
||||
|
||||
// 正好等于上限必须放行:边界是「超过」才拒,500 条一次全部停用。
|
||||
func TestBatchAllowsExactlyAtLimit(t *testing.T) {
|
||||
env, ids, client := recorderWithSeed(t)
|
||||
|
||||
targets := []int64{ids.athleteA, ids.athB}
|
||||
targets = append(targets, seedAthleteBatch(t, env, ids.teamA, batchLimit-len(targets))...)
|
||||
|
||||
result := doBatch(t, env, client, map[string]any{"action": "disable", "ids": targets})
|
||||
if result.Requested != batchLimit || result.Succeeded != batchLimit || result.Failed != 0 {
|
||||
t.Fatalf("正好 %d 条应全部成功,得到 %+v", batchLimit, result)
|
||||
}
|
||||
if n := countRows(t, env, `SELECT COUNT(*) FROM athletes WHERE active = 0`); n != batchLimit {
|
||||
t.Fatalf("应停用 %d 人,得到 %d", batchLimit, n)
|
||||
}
|
||||
}
|
||||
|
||||
// seedAthleteBatch 建 count 个运动员并返回其 id,供「正好等于上限」这类要凑够条数的用例使用。
|
||||
// 整批放在一个事务里:单连接库上逐条提交会把用例拖成几百次提交。
|
||||
func seedAthleteBatch(t *testing.T, env *testEnv, teamID int64, count int) []int64 {
|
||||
t.Helper()
|
||||
tx, err := env.ev.Begin()
|
||||
if err != nil {
|
||||
t.Fatalf("开事务: %v", err)
|
||||
}
|
||||
defer func() { _ = tx.Rollback() }()
|
||||
|
||||
out := make([]int64, 0, count)
|
||||
for i := 0; i < count; i++ {
|
||||
res, err := tx.Exec(`INSERT INTO athletes (name, gender, team_id, active) VALUES (?, '男', ?, 1)`,
|
||||
fmt.Sprintf("批量%03d", i), teamID)
|
||||
if err != nil {
|
||||
t.Fatalf("建运动员: %v", err)
|
||||
}
|
||||
id, err := res.LastInsertId()
|
||||
if err != nil {
|
||||
t.Fatalf("取运动员 id: %v", err)
|
||||
}
|
||||
out = append(out, id)
|
||||
}
|
||||
if err := tx.Commit(); err != nil {
|
||||
t.Fatalf("提交: %v", err)
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
// 未登录的写操作一律 401,且不改动任何数据。
|
||||
func TestBatchRequiresLogin(t *testing.T) {
|
||||
env := newTestEnv(t)
|
||||
|
||||
Reference in new issue
Block a user