Scoreboard

92 Commits 1 Branch 1 Tag

2 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	45edfbeb71	fix: P0 计分根因 + 奖牌结算/奖牌通道 + 身份口径改回证件号 + 19 条 P1（dev_0.1.8） ## P0：双通道项目重复发布跳分（45→85→收敛） results.rank 一列同时充当「个人名次输出」「手工名次输入」「榜单数据源」，团体手工通道把个人名次当团体名次又按团体表发一遍分。 - 新增 channel_ranks（每个计分通道各自持久化名次，发布时全量重建）与 channel_manual_ranks（按单位录入的团体手工名次，故意不挂通道外键，避免规则包重导时级联删掉录入数据） - results.rank 语义收窄为「只表示个人名次」，只由 scope=athlete 通道写回；团体手工名次的来源改为 TeamRanks 优先、团体报名项兜底，个人报名项的名次绝不进团体通道 - writeLedgerTx 内重建 channel_ranks；buildRanked / export.loadRanked / realtime.loadRanked 三份同源 SQL 一起改读新表 - 回归：发布两次流水与名次逐字节一致（domain + httpapi 各一条，含变异验证） ## 奖牌结算开关与奖牌通道（P1(5)，新功能） - events.award_medals + 通道 count_to_medals / count_to_team_medals （迁移默认 1，升级不改变既有榜单） - 单位榜入选 = 小项结算奖牌 && 通道发奖牌 && 前三名 &&（团体项目 \|\| 个人奖牌并入单位） - 个人榜只取个人通道；金牌榜与积分榜同源同数据、按通道过滤独立计算 - 前端：小项「该项启用奖牌结算」、通道「发奖牌/个人奖牌并入单位金牌榜」、录入页新增「团体名次」区块（含新接口 GET/PUT .../team-ranks） ## 身份口径改回证件号（P1(15)，推翻第三十六轮） - 匹配顺序恢复证件号 → 号码布 → 姓名+单位；新增 athleteByIDCard - 同表重复证件号 = 同一人报多个组别（notices 提示，不报错）；只有「同证件号 + 同小项同组别」才是真重复（conflicts[].duplicate） - 补齐后端缺失但前端/文档已在依赖的三处契约 ## 其余 P1 - 安全：会话撤销断开 ws、实时层按角色裁剪、整库快照限流（含 hello 路径，被限流的请求挂起并由心跳兜底补发，不丢刷新） - 错误分级：手填名次非正数 / gender / 组别年龄 / 导出不存在的小项与单位 / 积分模板 awardRanks → 400 或 404，不再 500 - 算分一致性：破纪录加分看得失状态；批量退赛·恢复·移出、作废成绩、报名导入改状态一律无条件重算推榜（不受延迟结算约束，与实时模式逐字节等价） - 配置改动触发重算：通道 / 小项参数 / 积分模板 - 升级自愈：channel_ranks 空而已有已发布成绩时，启动时一次性全量重算（服务对外监听之前完成，避免升级后奖牌榜全 0） - 示例数据模式下破坏性操作被阻断，不再假成功 - Console：修复「只剩一块屏」后屏幕监听器被永久摘掉 - 大屏模板引擎：嵌套深度与体积安全阀，任何输入都不抛异常 ## 文档 - docs/：使用手册（奖牌开关、奖牌通道、团体名次、枚举列留空口径）、常见问题（奖牌排查、升级后奖牌榜为 0、历史重放已知限制）、部署指南、上线检查清单 - 版本 dev_0.1.7 → dev_0.1.8（console/package.json 同步）自检：服务端 13 包 ×2 全绿；前端 vue-tsc + 449 例 ×2 + pnpm build； Console 35 例 + 语法检查。	2026-09-11 21:47:07 +08:00
AskaEth	793d2ac064	fix(console): 修「全屏时反而画标题栏」——窗口模式必须与 URL 的 windowed 一致用户实机反馈：单屏窗口化窗口按 F11 全屏后标题栏不消失，退回窗口化反而没标题栏，表现与预期完全相反。根因不在标题栏，而在 Console 侧的窗口模式管理：entry 没记录窗口是以什么模式建的， layout() 每次排布都拿「整机是否单屏」的 single 去覆盖每个已存在窗口的几何与模式（!single 时会 win.setKiosk(true) + 铺满），而页面 URL 里的 windowed=1 是建窗时定死的、 loadPage 只在页码变化时才重载 —— 于是窗口的真实模式与页面认知脱钩：窗口化窗口被改成 kiosk 全屏而 URL 仍带 windowed=1（全屏却画标题栏），反向亦然。修复：建立并保证「窗口几何/模式 ↔ URL 的 windowed 必须永远一致」 - entry 记 { win, page, single, manual, reloadTimer } - createWindow(..., manual=false)；openOn() 传 manual=true（手动开的窗口不被排布改模式） - layout() 的 existing 分支：target = manual ? entry.single : single，applyGeometry 与 loadPage 都用同一个 target，且 modeChanged \|\| page 变了都要重载 URL - 删掉 isKioskWindow()（用 isFullScreen() 反推会把「窗口化窗口被 F11 全屏」误报成 kiosk），换成 modeOf(entry) - F11 通信时序：enter/leave-full-screen 回调里不再回读 win.isFullScreen()（切换瞬间可能读到旧值，页面会收到相反状态），改为下发事件本身的确定值；F11 直接下发算出来的 next 回归测试 console/main/displays.test.js（8 例，assertModeConsistent 四处自洽）。反向对照：修复前的 displays.js 跑同一份测试是 1 pass / 7 fail。 Console 语法检查 18 个文件、node --test 28 例全过。	2026-09-11 00:13:09 +08:00

Author

SHA1

Message

Date

AskaEth

45edfbeb71

fix: P0 计分根因 + 奖牌结算/奖牌通道 + 身份口径改回证件号 + 19 条 P1（dev_0.1.8）

## P0：双通道项目重复发布跳分（45→85→收敛）
results.rank 一列同时充当「个人名次输出」「手工名次输入」「榜单数据源」，
团体手工通道把个人名次当团体名次又按团体表发一遍分。
- 新增 channel_ranks（每个计分通道各自持久化名次，发布时全量重建）
  与 channel_manual_ranks（按单位录入的团体手工名次，故意不挂通道外键，
  避免规则包重导时级联删掉录入数据）
- results.rank 语义收窄为「只表示个人名次」，只由 scope=athlete 通道写回；
  团体手工名次的来源改为 TeamRanks 优先、团体报名项兜底，
  个人报名项的名次绝不进团体通道
- writeLedgerTx 内重建 channel_ranks；buildRanked / export.loadRanked /
  realtime.loadRanked 三份同源 SQL 一起改读新表
- 回归：发布两次流水与名次逐字节一致（domain + httpapi 各一条，含变异验证）

## 奖牌结算开关与奖牌通道（P1(5)，新功能）
- events.award_medals + 通道 count_to_medals / count_to_team_medals
  （迁移默认 1，升级不改变既有榜单）
- 单位榜入选 = 小项结算奖牌 && 通道发奖牌 && 前三名 &&（团体项目 || 个人奖牌并入单位）
- 个人榜只取个人通道；金牌榜与积分榜同源同数据、按通道过滤独立计算
- 前端：小项「该项启用奖牌结算」、通道「发奖牌/个人奖牌并入单位金牌榜」、
  录入页新增「团体名次」区块（含新接口 GET/PUT .../team-ranks）

## 身份口径改回证件号（P1(15)，推翻第三十六轮）
- 匹配顺序恢复 证件号 → 号码布 → 姓名+单位；新增 athleteByIDCard
- 同表重复证件号 = 同一人报多个组别（notices 提示，不报错）；
  只有「同证件号 + 同小项同组别」才是真重复（conflicts[].duplicate）
- 补齐后端缺失但前端/文档已在依赖的三处契约

## 其余 P1
- 安全：会话撤销断开 ws、实时层按角色裁剪、整库快照限流（含 hello 路径，
  被限流的请求挂起并由心跳兜底补发，不丢刷新）
- 错误分级：手填名次非正数 / gender / 组别年龄 / 导出不存在的小项与单位 /
  积分模板 awardRanks → 400 或 404，不再 500
- 算分一致性：破纪录加分看得失状态；批量退赛·恢复·移出、作废成绩、
  报名导入改状态一律无条件重算推榜（不受延迟结算约束，与实时模式逐字节等价）
- 配置改动触发重算：通道 / 小项参数 / 积分模板
- 升级自愈：channel_ranks 空而已有已发布成绩时，启动时一次性全量重算
  （服务对外监听之前完成，避免升级后奖牌榜全 0）
- 示例数据模式下破坏性操作被阻断，不再假成功
- Console：修复「只剩一块屏」后屏幕监听器被永久摘掉
- 大屏模板引擎：嵌套深度与体积安全阀，任何输入都不抛异常

## 文档
- docs/：使用手册（奖牌开关、奖牌通道、团体名次、枚举列留空口径）、
  常见问题（奖牌排查、升级后奖牌榜为 0、历史重放已知限制）、
  部署指南、上线检查清单
- 版本 dev_0.1.7 → dev_0.1.8（console/package.json 同步）

自检：服务端 13 包 ×2 全绿；前端 vue-tsc + 449 例 ×2 + pnpm build；
Console 35 例 + 语法检查。

2026-09-11 21:47:07 +08:00

AskaEth

793d2ac064

fix(console): 修「全屏时反而画标题栏」——窗口模式必须与 URL 的 windowed 一致

用户实机反馈：单屏窗口化窗口按 F11 全屏后标题栏不消失，退回窗口化反而没标题栏，
表现与预期完全相反。

根因不在标题栏，而在 Console 侧的窗口模式管理：entry 没记录窗口是以什么模式建的，
layout() 每次排布都拿「整机是否单屏」的 single 去覆盖每个已存在窗口的几何与模式
（!single 时会 win.setKiosk(true) + 铺满），而页面 URL 里的 windowed=1 是建窗时定死的、
loadPage 只在页码变化时才重载 —— 于是窗口的真实模式与页面认知脱钩：
窗口化窗口被改成 kiosk 全屏而 URL 仍带 windowed=1（全屏却画标题栏），反向亦然。

修复：建立并保证「窗口几何/模式 ↔ URL 的 windowed 必须永远一致」
- entry 记 { win, page, single, manual, reloadTimer }
- createWindow(..., manual=false)；openOn() 传 manual=true（手动开的窗口不被排布改模式）
- layout() 的 existing 分支：target = manual ? entry.single : single，applyGeometry 与
  loadPage 都用同一个 target，且 modeChanged || page 变了都要重载 URL
- 删掉 isKioskWindow()（用 isFullScreen() 反推会把「窗口化窗口被 F11 全屏」误报成 kiosk），
  换成 modeOf(entry)
- F11 通信时序：enter/leave-full-screen 回调里不再回读 win.isFullScreen()（切换瞬间可能读到
  旧值，页面会收到相反状态），改为下发事件本身的确定值；F11 直接下发算出来的 next

回归测试 console/main/displays.test.js（8 例，assertModeConsistent 四处自洽）。
反向对照：修复前的 displays.js 跑同一份测试是 1 pass / 7 fail。
Console 语法检查 18 个文件、node --test 28 例全过。

2026-09-11 00:13:09 +08:00