## 奖牌榜改名(主人要求)
「团体奖牌榜」→「单位奖牌榜」,界面 / 大屏渲染页 / 导出件(工作表名与
下载文件名 `单位奖牌明细.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)
- 使用手册 / 常见问题 / 部署指南 / 上线检查清单按实现同步
118 lines
5.9 KiB
TypeScript
118 lines
5.9 KiB
TypeScript
import { test } from 'node:test'
|
||
import assert from 'node:assert/strict'
|
||
import { readFileSync } from 'node:fs'
|
||
import type { ImportConflict } from '@/shared'
|
||
import { conflictLabel } from '../components/baseData/entrySelection'
|
||
|
||
/**
|
||
* 「从已有名单勾选报名」必须消费服务端返回的 conflicts(P2 A12)。
|
||
*
|
||
* 勾选报名复用的是 /entries/import:服务端把「命中了库里已有人员、但字段对不上」的行放进 conflicts,
|
||
* 这些行**既没建报名也没报错**。组件原本无条件 toast.success('报名已加入'),
|
||
* 于是勾过的行一条都没进去、界面却说已加入,用户也就不会去导入页处理冲突。
|
||
*
|
||
* .vue 组件跑不进 node --test(无 jsdom,见 entryGuards.ts:6),所以按既有做法读源码断言:
|
||
* 成功提示只许长在 conflicts 为空的分支里,冲突条数要带进提示与页内明细,并说清去哪确认。
|
||
*/
|
||
|
||
const PICKER_SOURCE = readFileSync(new URL('../components/baseData/EntryPicker.vue', import.meta.url), 'utf8')
|
||
const IMPORT_SOURCE = readFileSync(new URL('../components/baseData/ImportSection.vue', import.meta.url), 'utf8')
|
||
|
||
/** 截出 importSelection 的函数体(到下一个顶格 `}` 为止),断言都限定在这段里。 */
|
||
function importSelectionBody(): string {
|
||
const start = PICKER_SOURCE.indexOf('async function importSelection')
|
||
assert.notEqual(start, -1, 'EntryPicker.vue 里找不到 importSelection')
|
||
const end = PICKER_SOURCE.indexOf('\n}', start)
|
||
assert.notEqual(end, -1, 'importSelection 没有正常闭合')
|
||
return PICKER_SOURCE.slice(start, end)
|
||
}
|
||
|
||
/** 取出 `if (result.conflicts.length === 0) { … }` 这一对花括号内的源码。 */
|
||
function emptyConflictsBranch(body: string): string {
|
||
const marker = 'if (result.conflicts.length === 0) {'
|
||
const start = body.indexOf(marker)
|
||
assert.notEqual(start, -1, 'importSelection 里没有「conflicts 为空才算成功」的分支')
|
||
let depth = 0
|
||
for (let i = start + marker.length - 1; i < body.length; i += 1) {
|
||
if (body[i] === '{') depth += 1
|
||
else if (body[i] === '}') {
|
||
depth -= 1
|
||
if (depth === 0) return body.slice(start + marker.length, i)
|
||
}
|
||
}
|
||
assert.fail('conflicts 为空的分支没有闭合')
|
||
}
|
||
|
||
test('有冲突时不出现成功提示:toast.success 只长在 conflicts 为空的分支里', () => {
|
||
const body = importSelectionBody()
|
||
const successIndex = body.indexOf('toast.success')
|
||
assert.notEqual(successIndex, -1, '全成功时仍要提示成功')
|
||
|
||
const branch = emptyConflictsBranch(body)
|
||
const branchStart = body.indexOf(branch)
|
||
assert.ok(
|
||
successIndex > branchStart && successIndex < branchStart + branch.length,
|
||
'toast.success 跑到了 conflicts 非空的路径上——冲突行没建报名却提示「已加入」',
|
||
)
|
||
// 页面里只该有这一处成功提示,避免别处又无条件说「已加入」。
|
||
assert.equal([...PICKER_SOURCE.matchAll(/toast\.success\(/g)].length, 1)
|
||
})
|
||
|
||
test('全成功时仍提示成功,且带上服务端的计数', () => {
|
||
const branch = emptyConflictsBranch(importSelectionBody())
|
||
assert.match(branch, /toast\.success\('报名已加入'/)
|
||
assert.match(branch, /新增 \$\{result\.created\} · 更新 \$\{result\.updated\} · 跳过 \$\{result\.skipped\}/)
|
||
})
|
||
|
||
test('冲突条数被正确传递:收下 conflicts 并写进失败提示', () => {
|
||
const body = importSelectionBody()
|
||
assert.match(body, /conflicts\.value = result\.conflicts/, '要把服务端给的冲突行收进界面状态')
|
||
assert.match(body, /有 \$\{result\.conflicts\.length\} 行没有加入,需要逐条确认/)
|
||
})
|
||
|
||
test('冲突明细显示在页内,逐条给出服务端的行号与决策键', () => {
|
||
assert.match(PICKER_SOURCE, /v-if="conflicts\.length > 0"/)
|
||
assert.match(PICKER_SOURCE, /v-for="conflict in conflicts"/)
|
||
assert.match(PICKER_SOURCE, /\{\{ conflict\.row \}\}/)
|
||
assert.match(PICKER_SOURCE, /conflictLabel\(conflict\)/)
|
||
})
|
||
|
||
test('页内明细复用冲突面板的决策键标签(键为空时不留空白)', () => {
|
||
const conflict: ImportConflict = {
|
||
row: 3,
|
||
idCard: '',
|
||
bib: '101',
|
||
athleteId: 7,
|
||
duplicate: false,
|
||
existing: { name: '张伟', gender: null, age: null, teamCode: 'F1', employeeNo: null, idCard: null, bib: null },
|
||
incoming: { name: '张伟', gender: null, age: null, teamCode: 'F1', employeeNo: null, idCard: null, bib: null },
|
||
changedFields: [],
|
||
}
|
||
assert.equal(conflictLabel(conflict), '101', '证件号为空时用号码布')
|
||
assert.equal(conflictLabel({ ...conflict, idCard: '110101199001011234' }), '110101199001011234')
|
||
})
|
||
|
||
test('提示说清去哪确认:本页「报名导入」分区的冲突面板 / resolve 接口', () => {
|
||
const body = importSelectionBody()
|
||
// 面板在同一个页面(ImportSection.vue 里先渲染 <EntryPicker />、再是「报名导入」卡片),
|
||
// 所以文案必须点名卡片标题,否则用户不知道去哪找。
|
||
assert.match(body, /本页「报名导入」分区的冲突面板/)
|
||
assert.match(IMPORT_SOURCE, /<span class="mx-card-title">报名导入<\/span>/)
|
||
assert.match(body, /POST \/api\/entries\/import\/resolve/)
|
||
})
|
||
|
||
test('复用 EntryImportResult.conflicts 的类型,不另立一套', () => {
|
||
assert.match(PICKER_SOURCE, /import type \{ Athlete, EntryWithResult, ImportConflict \} from '@\/shared'/)
|
||
})
|
||
|
||
test('冲突明细照抄 ImportSection.vue 的渲染范式,没有自创样式', () => {
|
||
for (const className of ['.errors-head', '.error-list']) {
|
||
assert.ok(IMPORT_SOURCE.includes(className), `ImportSection.vue 里应有 ${className}`)
|
||
assert.ok(PICKER_SOURCE.includes(className), `EntryPicker.vue 里应照抄 ${className}`)
|
||
}
|
||
assert.match(PICKER_SOURCE, /class="mx-badge mx-badge-warning">有 \{\{ conflicts\.length \}\} 行没有加入,需要逐条确认/)
|
||
// 列冲突用的还是那一套 class,不是新造的面板。
|
||
assert.match(PICKER_SOURCE, /<ul class="error-list">/)
|
||
assert.match(IMPORT_SOURCE, /<ul class="error-list">/)
|
||
})
|