## 奖牌榜改名(主人要求)
「团体奖牌榜」→「单位奖牌榜」,界面 / 大屏渲染页 / 导出件(工作表名与
下载文件名 `单位奖牌明细.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)
- 使用手册 / 常见问题 / 部署指南 / 上线检查清单按实现同步
304 lines
9.1 KiB
TypeScript
304 lines
9.1 KiB
TypeScript
import type {
|
||
AthleteStanding,
|
||
Event,
|
||
EventResultGroup,
|
||
EventResultRow,
|
||
SnapshotMessage,
|
||
StandingRow,
|
||
Team,
|
||
} from '@/shared'
|
||
import type { DisplaySettings } from './guards'
|
||
import { DEFAULT_ROTATE_SECONDS } from './guards'
|
||
|
||
/**
|
||
* 后端未就绪时的降级数据(任务要求:降级 mock 并标注「示例数据」)。
|
||
*
|
||
* 数值是手写的固定值而不是随机数:现场调试时截图对比不会因为每次刷新而变。
|
||
*/
|
||
|
||
const TEAM_NAMES: readonly string[] = [
|
||
'第一分公司',
|
||
'机关本部',
|
||
'第二分公司',
|
||
'第三分公司',
|
||
'第四分公司',
|
||
'第五分公司',
|
||
'第六分公司',
|
||
]
|
||
|
||
function team(index: number, code: string): Team {
|
||
const name = TEAM_NAMES[index] ?? `单位${index + 1}`
|
||
return {
|
||
id: index + 1,
|
||
code,
|
||
name,
|
||
shortName: null,
|
||
logoPath: null,
|
||
color: null,
|
||
sortOrder: index,
|
||
active: true,
|
||
}
|
||
}
|
||
|
||
const MOCK_TEAMS: Team[] = [
|
||
team(0, 'T01'),
|
||
team(1, 'T02'),
|
||
team(2, 'T03'),
|
||
team(3, 'T04'),
|
||
team(4, 'T05'),
|
||
team(5, 'T06'),
|
||
team(6, 'T07'),
|
||
]
|
||
|
||
interface StandingSeed {
|
||
rank: number
|
||
totalPoints: number
|
||
gold: number
|
||
silver: number
|
||
bronze: number
|
||
rankChange: number | null
|
||
}
|
||
|
||
const STANDING_SEEDS: readonly StandingSeed[] = [
|
||
{ rank: 1, totalPoints: 186, gold: 8, silver: 5, bronze: 3, rankChange: 1 },
|
||
{ rank: 2, totalPoints: 172, gold: 6, silver: 7, bronze: 4, rankChange: -1 },
|
||
{ rank: 3, totalPoints: 158, gold: 5, silver: 4, bronze: 8, rankChange: 0 },
|
||
{ rank: 4, totalPoints: 141, gold: 4, silver: 5, bronze: 6, rankChange: 2 },
|
||
{ rank: 5, totalPoints: 127, gold: 3, silver: 4, bronze: 5, rankChange: null },
|
||
{ rank: 6, totalPoints: 103, gold: 2, silver: 3, bronze: 4, rankChange: 0 },
|
||
{ rank: 7, totalPoints: 95, gold: 2, silver: 2, bronze: 2, rankChange: -2 },
|
||
]
|
||
|
||
function buildStandings(): StandingRow[] {
|
||
return MOCK_TEAMS.map((item, index) => {
|
||
const seed = STANDING_SEEDS[index] ?? STANDING_SEEDS[STANDING_SEEDS.length - 1]
|
||
const row = seed ?? { rank: index + 1, totalPoints: 0, gold: 0, silver: 0, bronze: 0, rankChange: null }
|
||
return {
|
||
teamId: item.id,
|
||
teamCode: item.code,
|
||
teamName: item.name,
|
||
shortName: item.shortName,
|
||
color: item.color,
|
||
logoPath: item.logoPath,
|
||
rank: row.rank,
|
||
gold: row.gold,
|
||
silver: row.silver,
|
||
bronze: row.bronze,
|
||
medalTotal: row.gold + row.silver + row.bronze,
|
||
totalPoints: row.totalPoints,
|
||
rankChange: row.rankChange,
|
||
}
|
||
})
|
||
}
|
||
|
||
function buildEvents(): Event[] {
|
||
const seeds: readonly [string, string, Event['resultType'], Event['compare']][] = [
|
||
['E1001', '男子 100 米', 'time', 'asc'],
|
||
['E1002', '女子 100 米', 'time', 'asc'],
|
||
['E2001', '男子跳远', 'distance', 'desc'],
|
||
['E3001', '女子 4×100 米接力', 'time', 'asc'],
|
||
['E4001', '拔河', 'count', 'desc'],
|
||
]
|
||
return seeds.map(([code, name, resultType, compare], index) => ({
|
||
id: index + 1,
|
||
sportId: 1,
|
||
code,
|
||
name,
|
||
eventType: index === 3 || index === 4 ? 'team' : 'individual',
|
||
resultMode: 'auto',
|
||
resultType,
|
||
compare,
|
||
recordEligible: index < 3,
|
||
scored: true,
|
||
// 示例大屏里每个小项都正常结算奖牌(缺字段时 guards 也按 true 处理)。
|
||
awardMedals: true,
|
||
multiplier: 1,
|
||
status: index < 3 ? 'published' : 'finished',
|
||
scheduledAt: null,
|
||
venue: null,
|
||
sortOrder: index,
|
||
remark: null,
|
||
avgMode: 'valid',
|
||
}))
|
||
}
|
||
|
||
interface ResultSeed {
|
||
rank: number
|
||
teamIndex: number
|
||
athlete: string
|
||
resultText: string
|
||
resultValue: number
|
||
}
|
||
|
||
function buildRows(seeds: readonly ResultSeed[], unit: string): EventResultRow[] {
|
||
return seeds.map((seed, index) => {
|
||
const team = MOCK_TEAMS[seed.teamIndex]
|
||
return {
|
||
entryId: (seed.rank + 1) * 100 + index,
|
||
rank: seed.rank,
|
||
teamId: team?.id ?? 0,
|
||
teamCode: team?.code ?? '',
|
||
teamName: team?.name ?? '',
|
||
shortName: team?.shortName ?? null,
|
||
logoPath: team?.logoPath ?? null,
|
||
athleteId: index + 1,
|
||
athleteName: seed.athlete,
|
||
memberNames: null,
|
||
resultText: seed.resultText,
|
||
resultValue: seed.resultValue,
|
||
unit,
|
||
isTie: false,
|
||
status: 'ok',
|
||
}
|
||
})
|
||
}
|
||
|
||
function buildLatestResults(): EventResultGroup[] {
|
||
return [
|
||
{
|
||
eventId: 1,
|
||
eventCode: 'E1001',
|
||
eventName: '男子 100 米',
|
||
categoryId: 1,
|
||
categoryName: '青年组',
|
||
publishedAt: '2026-09-09T15:42:00+08:00',
|
||
rows: buildRows(
|
||
[
|
||
{ rank: 1, teamIndex: 0, athlete: '张伟', resultText: '11.58', resultValue: 11.58 },
|
||
{ rank: 2, teamIndex: 2, athlete: '李强', resultText: '11.72', resultValue: 11.72 },
|
||
{ rank: 3, teamIndex: 1, athlete: '王磊', resultText: '11.85', resultValue: 11.85 },
|
||
{ rank: 4, teamIndex: 4, athlete: '刘洋', resultText: '11.94', resultValue: 11.94 },
|
||
{ rank: 5, teamIndex: 3, athlete: '陈晨', resultText: '12.03', resultValue: 12.03 },
|
||
{ rank: 6, teamIndex: 5, athlete: '赵鹏', resultText: '12.15', resultValue: 12.15 },
|
||
],
|
||
's',
|
||
),
|
||
},
|
||
{
|
||
eventId: 2,
|
||
eventCode: 'E1002',
|
||
eventName: '女子 100 米',
|
||
categoryId: 2,
|
||
categoryName: '青年组',
|
||
publishedAt: '2026-09-09T15:10:00+08:00',
|
||
rows: buildRows(
|
||
[
|
||
{ rank: 1, teamIndex: 1, athlete: '李娜', resultText: '13.04', resultValue: 13.04 },
|
||
{ rank: 2, teamIndex: 0, athlete: '孙悦', resultText: '13.21', resultValue: 13.21 },
|
||
{ rank: 3, teamIndex: 3, athlete: '周敏', resultText: '13.36', resultValue: 13.36 },
|
||
{ rank: 4, teamIndex: 6, athlete: '吴倩', resultText: '13.48', resultValue: 13.48 },
|
||
{ rank: 5, teamIndex: 2, athlete: '郑爽', resultText: '13.55', resultValue: 13.55 },
|
||
{ rank: 6, teamIndex: 6, athlete: '冯雪', resultText: '13.62', resultValue: 13.62 },
|
||
],
|
||
's',
|
||
),
|
||
},
|
||
{
|
||
eventId: 3,
|
||
eventCode: 'E2001',
|
||
eventName: '男子跳远',
|
||
categoryId: 3,
|
||
categoryName: '中年组',
|
||
publishedAt: '2026-09-09T14:35:00+08:00',
|
||
rows: buildRows(
|
||
[
|
||
{ rank: 1, teamIndex: 2, athlete: '黄涛', resultText: '6.42', resultValue: 6.42 },
|
||
{ rank: 2, teamIndex: 5, athlete: '徐斌', resultText: '6.18', resultValue: 6.18 },
|
||
{ rank: 3, teamIndex: 0, athlete: '马超', resultText: '6.05', resultValue: 6.05 },
|
||
{ rank: 4, teamIndex: 3, athlete: '朱峰', resultText: '5.96', resultValue: 5.96 },
|
||
{ rank: 5, teamIndex: 1, athlete: '胡军', resultText: '5.88', resultValue: 5.88 },
|
||
{ rank: 6, teamIndex: 4, athlete: '林凯', resultText: '5.71', resultValue: 5.71 },
|
||
],
|
||
'm',
|
||
),
|
||
},
|
||
]
|
||
}
|
||
|
||
const ATHLETE_SEEDS: readonly [string, number, number, number, number, number][] = [
|
||
['张伟', 0, 42, 2, 1, 0],
|
||
['李娜', 1, 38, 2, 0, 1],
|
||
['李强', 2, 34, 1, 2, 0],
|
||
['孙悦', 0, 30, 1, 1, 1],
|
||
['黄涛', 2, 28, 1, 0, 2],
|
||
['王磊', 1, 26, 1, 1, 0],
|
||
['周敏', 3, 24, 1, 0, 1],
|
||
['刘洋', 4, 22, 0, 2, 1],
|
||
['徐斌', 5, 20, 1, 0, 1],
|
||
['陈晨', 3, 18, 0, 1, 2],
|
||
['马超', 0, 16, 0, 1, 1],
|
||
['吴倩', 6, 14, 0, 0, 2],
|
||
]
|
||
|
||
function buildAthletes(): AthleteStanding[] {
|
||
return ATHLETE_SEEDS.map(([name, teamIndex, totalPoints, gold, silver, bronze], index) => {
|
||
const item = MOCK_TEAMS[teamIndex]
|
||
return {
|
||
rank: index + 1,
|
||
athleteId: index + 1,
|
||
athleteName: name,
|
||
gender: null,
|
||
teamId: item?.id ?? 0,
|
||
teamCode: item?.code ?? '',
|
||
teamName: item?.name ?? '',
|
||
shortName: item?.shortName ?? null,
|
||
logoPath: item?.logoPath ?? null,
|
||
totalPoints,
|
||
gold,
|
||
silver,
|
||
bronze,
|
||
}
|
||
})
|
||
}
|
||
|
||
/**
|
||
* 示例配置。单列出来是因为它比共享契约多「实时赛况」两个键(后端未就绪时也要能演示):
|
||
* 直接写在 SnapshotMessage 字面量里会被多余属性检查拦下。
|
||
*/
|
||
const MOCK_SETTINGS: DisplaySettings = {
|
||
event: {
|
||
name: '2026 职工运动会',
|
||
subtitle: null,
|
||
host: '示例组委会',
|
||
logoPath: null,
|
||
primaryColor: '#4fd8ff',
|
||
},
|
||
display: {
|
||
background: null,
|
||
logo: null,
|
||
title: '2026 职工运动会',
|
||
subtitle: '积分榜 · 示例数据',
|
||
primaryColor: '#4fd8ff',
|
||
// 与服务端默认一致(dto/settings.go 的 display.rotate_seconds 兜底 15)。
|
||
rotateSeconds: DEFAULT_ROTATE_SECONDS,
|
||
// 示例数据里有 3 个已完成项目,取前两个演示双栏分栏。
|
||
liveEvents: [1, 2],
|
||
liveSource: 'manual',
|
||
},
|
||
standings: {
|
||
individualToTeamWeight: 1,
|
||
rankingMode: 'points',
|
||
showIndividualBoard: true,
|
||
showIndividualMedals: true,
|
||
},
|
||
defaultProfileId: null,
|
||
requireApproval: false,
|
||
}
|
||
|
||
export function createMockSnapshot(): SnapshotMessage {
|
||
return {
|
||
// version 固定 0 且不写入缓存:真实快照一到就能直接覆盖,不会因为版本号更大而被丢弃。
|
||
version: 0,
|
||
settings: MOCK_SETTINGS,
|
||
teams: MOCK_TEAMS,
|
||
events: buildEvents(),
|
||
standings: buildStandings(),
|
||
records: [],
|
||
latestResults: buildLatestResults(),
|
||
}
|
||
}
|
||
|
||
export function createMockAthletes(): AthleteStanding[] {
|
||
return buildAthletes()
|
||
}
|