AskaEth
6841cf49aa
## 奖牌榜改名（主人要求）
「团体奖牌榜」→「单位奖牌榜」，界面 / 大屏渲染页 / 导出件（工作表名与
下载文件名 `单位奖牌明细.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）
- 使用手册 / 常见问题 / 部署指南 / 上线检查清单按实现同步
83 lines
3.7 KiB
TypeScript
83 lines
3.7 KiB
TypeScript
import { test } from 'node:test'
|
||
import assert from 'node:assert/strict'
|
||
import { readFileSync } from 'node:fs'
|
||
import { ApiError } from '@/shared'
|
||
import { restoreFailureNotice } from '../components/system/systemApi'
|
||
|
||
/**
|
||
* 恢复失败时的提示口径（P2 A29）。
|
||
*
|
||
* 服务端的恢复是很长一串：校验备份 → 拍恢复前安全副本 → 断连接 → 换库文件 → 复核新库 → 写审计，
|
||
* **回执在这之后才发出**。所以「没收到回执」与「没执行」是两件事：
|
||
* 前者可能库已经换掉了。这里钉住这两类失败必须给出不同的说法，
|
||
* 免得操作员看到「当前库未被覆盖」就再点一次恢复，把刚恢复好的库再覆盖一遍。
|
||
*/
|
||
|
||
test('超时按「没收到回执、可能已生效」定性，并给出确认步骤', () => {
|
||
const notice = restoreFailureNotice(new ApiError('TIMEOUT', '请求超时（60000ms）', 0))
|
||
|
||
assert.equal(notice.title, '没收到恢复回执，恢复可能已经生效')
|
||
assert.match(notice.detail, /请求超时/)
|
||
assert.match(notice.detail, /刷新页面确认/)
|
||
assert.match(notice.detail, /不要直接再点一次恢复/)
|
||
assert.doesNotMatch(notice.title, /未被覆盖/)
|
||
})
|
||
|
||
test('断连同样按「没收到回执、可能已生效」定性', () => {
|
||
const notice = restoreFailureNotice(new ApiError('NETWORK', '无法连接服务端', 0))
|
||
assert.equal(notice.title, '没收到恢复回执，恢复可能已经生效')
|
||
assert.match(notice.detail, /刷新页面确认/)
|
||
})
|
||
|
||
// 拿到了 2xx 却读不出约定结构：服务端已经做完并回了响应，同样不能宣称「库没动」。
|
||
test('响应读不出结构（PARSE_FAILED）也算「没拿到回执」', () => {
|
||
const notice = restoreFailureNotice(
|
||
new ApiError('PARSE_FAILED', '服务端响应不是约定的 {ok,data} 结构', 200),
|
||
)
|
||
assert.equal(notice.title, '没收到恢复回执，恢复可能已经生效')
|
||
})
|
||
|
||
test('服务端在动库之前给出的业务错误照旧说「未执行、库未被覆盖」', () => {
|
||
const notice = restoreFailureNotice(
|
||
new ApiError('VALIDATION_FAILED', '备份文件不可用：缺少关键表 teams', 400),
|
||
)
|
||
|
||
assert.equal(notice.title, '恢复未执行，当前库未被覆盖')
|
||
assert.equal(notice.detail, '备份文件不可用：缺少关键表 teams')
|
||
})
|
||
|
||
test('回滚类错误把服务端原文带上（它的说明比笼统措辞更准）', () => {
|
||
const notice = restoreFailureNotice(
|
||
new ApiError('INTERNAL', '恢复后校验失败，已自动回滚到恢复前状态', 500, 'pre-restore-event.db'),
|
||
)
|
||
|
||
assert.equal(notice.title, '恢复未执行，当前库未被覆盖')
|
||
assert.match(notice.detail, /已自动回滚/)
|
||
})
|
||
|
||
test('非 ApiError 的异常不让页面白屏，仍给出可读文案', () => {
|
||
const notice = restoreFailureNotice(new Error('boom'))
|
||
assert.equal(notice.detail, 'boom')
|
||
|
||
const unknown = restoreFailureNotice(undefined)
|
||
assert.equal(unknown.detail, '未知错误')
|
||
})
|
||
|
||
// 页面必须走这个函数（而不是自己拼一句「当前库未被覆盖」），否则口径会再次分叉。
|
||
const BACKUP_PANEL_SOURCE = readSource('../components/system/BackupPanel.vue')
|
||
|
||
function readSource(relative: string): string {
|
||
return readFileSync(new URL(relative, import.meta.url), 'utf8')
|
||
}
|
||
|
||
test('BackupPanel 的失败分支用 restoreFailureNotice 定性', () => {
|
||
assert.match(BACKUP_PANEL_SOURCE, /restoreFailureNotice\(caught\)/)
|
||
assert.match(BACKUP_PANEL_SOURCE, /toast\.error\(notice\.title, notice\.detail\)/)
|
||
})
|
||
|
||
test('恢复请求走的是放大过超时的那条客户端路径', () => {
|
||
const apiSource = readSource('../../shared/api.ts')
|
||
assert.match(apiSource, /timeoutMs: RESTORE_TIMEOUT_MS/)
|
||
assert.match(apiSource, /export const RESTORE_TIMEOUT_MS = 60_000/)
|
||
})
|