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
@@ -10,6 +10,8 @@ import type {
|
||||
StandingRow,
|
||||
} from '@/shared'
|
||||
import {
|
||||
DEFAULT_ROTATE_SECONDS,
|
||||
parseAthleteStandings,
|
||||
parseLiveFeed,
|
||||
parseSettings,
|
||||
parseSnapshot,
|
||||
@@ -32,8 +34,8 @@ import type {
|
||||
} from './types'
|
||||
import { prefersReducedMotion } from './useReducedMotion'
|
||||
|
||||
/** 整页轮播间隔(06 第 4 节:后台可切换为整页轮播,每页 20s)。 */
|
||||
const PAGE_ROTATE_MS = 20_000
|
||||
/** 轮播间隔下限(秒):配置成 0 或负数时按 2 秒兜底,不然会疯狂翻页。 */
|
||||
const MIN_ROTATE_SECONDS = 2
|
||||
/** 名次升降箭头保留时长(06 第 7 节:2s 后淡出)。 */
|
||||
const RANK_DELTA_MS = 2_000
|
||||
|
||||
@@ -114,6 +116,22 @@ const rotationPages = computed<DisplayPageKey[]>(() =>
|
||||
),
|
||||
)
|
||||
|
||||
/**
|
||||
* 整页轮播间隔:与服务端 `display.rotateSeconds` 同源(06 第 4 节「与底栏同间隔」)。
|
||||
*
|
||||
* 以前写死 20s,管理员把轮播改成 15s 或 30s 只影响底栏,整页轮播毫无反应。
|
||||
* 缺配置 / 配置非法时按服务端默认值兜底(`dto/settings.go` 的 rotate_seconds 兜底 15),
|
||||
* 并结合下限,避免配成 0 时疯狂翻页。
|
||||
*/
|
||||
const pageRotateMs = computed(() => {
|
||||
const seconds = settings.value?.display?.rotateSeconds
|
||||
const safe =
|
||||
typeof seconds === 'number' && Number.isFinite(seconds) && seconds > 0
|
||||
? seconds
|
||||
: DEFAULT_ROTATE_SECONDS
|
||||
return Math.max(MIN_ROTATE_SECONDS, safe) * 1000
|
||||
})
|
||||
|
||||
function compareStanding(a: StandingRow, b: StandingRow): number {
|
||||
return a.rank - b.rank || b.totalPoints - a.totalPoints
|
||||
}
|
||||
@@ -305,6 +323,10 @@ function hydrateFromCache(): void {
|
||||
* 大屏不请求 /api/settings(admin-only,guest 必然 403),配置只认 WS 快照与本地缓存;
|
||||
* 快照比 REST 权威(REST 没有 version),且请求飞行途中可能已有快照到达,
|
||||
* 所以是否套用 REST 必须在 await 之后重新判断,不能沿用发请求前的结论。
|
||||
*
|
||||
* 两条路都必须过 guards:`api.standings.*` 只做了 JSON 解析(`{ok,data}` 拆包),
|
||||
* 字段缺失 / 类型不对时它照样把裸值交出来,而大屏是无人值守的——
|
||||
* 少一个字段就可能让整页模板渲染成空。WS 快照那条路一直是过 guards 的,两边口径要一致。
|
||||
*/
|
||||
async function loadRest(): Promise<boolean> {
|
||||
const [standingsResult, athletesResult] = await Promise.allSettled([
|
||||
@@ -315,11 +337,11 @@ async function loadRest(): Promise<boolean> {
|
||||
|
||||
let ok = false
|
||||
if (standingsResult.status === 'fulfilled' && !hasSnapshot) {
|
||||
applyStandings(standingsResult.value)
|
||||
applyStandings(parseStandingRows(standingsResult.value))
|
||||
ok = true
|
||||
}
|
||||
if (athletesResult.status === 'fulfilled') {
|
||||
athletes.value = athletesResult.value
|
||||
athletes.value = parseAthleteStandings(athletesResult.value)
|
||||
ok = true
|
||||
}
|
||||
return ok
|
||||
@@ -390,7 +412,7 @@ function startPageRotation(): void {
|
||||
const current = order.indexOf(page.value)
|
||||
const next = order[(current + 1) % order.length]
|
||||
if (next !== undefined) page.value = next
|
||||
}, PAGE_ROTATE_MS)
|
||||
}, pageRotateMs.value)
|
||||
}
|
||||
|
||||
function setLocked(value: boolean): void {
|
||||
@@ -492,6 +514,13 @@ watch(
|
||||
{ immediate: true },
|
||||
)
|
||||
|
||||
// 轮播间隔也来自 settings(display.rotateSeconds),而 setInterval 的周期在建表时就固定了:
|
||||
// 设置到达 / 被改后必须重排计时器,否则首屏(快照还没到)会一直按兜底间隔翻。
|
||||
// 只在轮播真在跑时才动它——锁定、全屏公告、明细覆盖期间本来就该停着。
|
||||
watch(pageRotateMs, () => {
|
||||
if (pageTimer !== null) startPageRotation()
|
||||
})
|
||||
|
||||
/**
|
||||
* 服务端把当前公告持久化在设置里(display.announce),快照与设置接口都带它。
|
||||
*
|
||||
|
||||
Reference in new issue
Block a user