AskaEth/Scoreboard
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
127 Commits 1 Branch 1 Tag
main
Commit Graph
10 Commits
Author SHA1 Message Date
AskaEth 9c52dc4b38 feat(display): 大屏「赛事日程侧边栏」（手填日程 + 竖向进度轴 + 热开关 + 每屏覆盖）；版本 dev_0.5.16 
主人点名要的功能：大屏控制页加一个**可热开关**的侧边栏，在**指定的屏幕**上（不管它当前在哪一页）叠一个
**手填的赛事日程列表**，带**竖向进度条**；日程**不与登记的小项时间关联**、完全手填；竖向时间轴要好看，
**字多时字号自动缩放与换行**要做到位（不能过小、不能过大）。

设计口径（主人逐条拍板）：放不下时**围绕当前项开窗**；进度条是**一条竖向时间轴 + 三态节点**；
**深色半透明 + 毛玻璃**；已完成的项**淡化保留**；备注**默认上屏 + 一个总开关**；
明细覆盖层 / 全屏公告期间**自动收起**、结束后自动回来；编辑权限**录入员及以上**；单屏覆盖按**实例 id**。

服务端（走大屏公告那条路 —— PUT /api/settings 是 admin-only，会与「录入员可改」冲突）
- 新增 `schedule` 动作 + 白名单；`POST /api/display/command` 同一个 handler：**先校验 → 再转发 → 最后落库**
  （校验排在转发前，非法配置不会在大屏上闪一帧）
- 落库到赛事库 settings 的 `display.schedule`（**不新建表、不写迁移**，随赛事包走）；
  与公告共用那份「写设置键 + bumpVersion」的实现
- **读写不对称容错**：写侧严格 400（含中文提示与第几条），读侧坏数据一律静默当空 —— 老数据 / 手改库不会炸大屏
- 上限：40 条；time ≤20 / title ≤40 / note ≤60（按字符，清洗控制字符）；宽度夹 15–40；覆盖 ≤50 条
- 口径收口三处：**时间允许为空**（与管理端同口径）、**showNote 缺键 = true**（区分「键不存在」与「显式 false」）、
  **`inherit` 不落库**（不再白占覆盖预算）

大屏端
- 新增 `ScheduleSidebar.vue` + `schedulePanel.ts`（纯函数：开窗 / 三态 / 整体进度 / 字号与行数 / 按显示宽度截断 /
  单屏覆盖 / 抑制 / 指纹去重）
- 字号是**舞台设计坐标**（1920×1080），靠 `.stage` 的 `transform: scale()` 整体缩放，**不做二次缩放**
  （wiring 断言禁止出现 `window.`/`innerWidth`/`vh`）；复用既有的 `fitRowFontPx`（**16–56px 硬上下限**）与 `textEm`；
  固定点迭代 ≤4 轮；**贴下限时宁可行数少也不缩字**；标题 ≤3 行、备注 ≤2 行，超出截断
- 容器 `position:absolute; inset:0; z-index:50`（**不用 fixed** —— `.stage` 带 transform，是 fixed 后代的包含块）；
  **独立于 detail 状态机**（goto 会关明细、明细会停轮播，侧边栏必须不受影响）
- 深色半透明 + `backdrop-filter`，并带 `@supports not (backdrop-filter: blur(1px))` 退化为更不透明的深底
- 关着时**不留任何 DOM**（逐字节等同于没有这个功能）；`prefers-reduced-motion` 下不做动效

管理端
- 大屏控制页（左列、公告之后）新增「赛事日程」卡片：条目表格（时间/标题/备注/已完成 + 上移/下移/删除）、
  总开关、备注上屏、位置与宽度、**每块屏三态覆盖**（跟随 / 强制开 / 强制关；切回「跟随」会真删掉那条键）
- 保存走 `adminApi.displayCommand`（**不走 admin-only 的设置接口**）；本地校验不过**一个请求都不发**
- 排序只有上移 / 下移（该页面禁止挂 pointerdown/mousedown 监听，有既有测试钉着）

测试
- 服务端 16 个包全绿；前端 **1174 例**全过（基线 1096，本批 +78：大屏端 44 + 管理端 34）
- 大屏端另有 **40 项 playwright 实机**（用 `page.routeWebSocket` 假造实时通道）：开/关后 DOM 无残留、
  五个页面下都在、`lock=0` 真等轮播翻页且侧边栏不掉、明细与公告期间自动收起并自动回来、
  **1080p 与 4K 字号完全相同**、`reducedMotion` 下无动画；并钉住两条硬指标（真机列表高度 ≥ 纯函数预算、
  容量×行高 ≤ 真机高度）

文档：`docs/升级说明` 新增 `dev_0.5.16`；`使用手册` 9.2 + 17.6；`常见问题` Q108–Q111；`上线检查清单`/`部署指南`
各一条；`devdocs/05·07·13` 同步。

⚠️ 一条**既有边界**（本版故意没改，按主人「兼容性最大化」的要求）：导出的名次口径是「通道名次优先」、
屏幕是「成绩行名次优先」，只在「先按决赛计分发布、之后又只更新名次发布一次」这种序列下分叉
（导出显示上次计分的名次）。正常赛程遇不到；遇到时对该组再「按决赛成绩发布」一次即恢复一致。
已写进《升级说明》④ 与《常见问题》Q111。
 2026-09-17 20:04:50 +08:00
AskaEth 56ed90ff8b fix(display,entry): 修大屏团体名次显示「-」与分项成绩第 3 栏缺第 1 名；发布改弹窗选口径；会话设备名与重命名；录分搜索框；版本 dev_0.5.15 
本批七项（三处是现场报的 bug，四处是新功能）：

① 大屏上「纯团体项目」（如团体 4x100 接力）的名次全是「-」
   根因不在算分：纯团体名次只落在 channel_ranks，而 results.rank 被有意收窄成
   「个人名次」、对团体主体一直是 NULL；大屏的两个读者只读 results.rank、没有兜底
   （导出件与积分明细下钻早就有兜底，所以当时是「导出有、屏幕没有」）。
   改成读侧回落：results.rank 优先、为空时用通道名次。算分与写回一行未动。
   ⚠️ 优先级的理由：只更新名次的发布只更新 results.rank、不重建通道名次，
   若通道名次优先，个人项目会在那种发布之后显示旧名次。
   ⚠️ 已发布的数据不需要重发或重算，升级后大屏下一次刷新即显示。
   ⚠️ 仍未覆盖：只在「团体名次」卡片里按单位录名次、成绩行上没填的那类（无成绩行可挂）。

② 分项成绩页第 3 栏看不到第 1 名
   根因：快照 latestResults 的窗口原来按「行」截断（LIMIT 20），而屏上是一组一栏，
   切口只能落在最旧那一栏（通常是第 3 栏）内部，把该组建号最早的行挤掉
   （手录项目从第 1 名往下录 → 第 1 名建号最早）。
   改成「最近 8 组 × 每组 10 行」（先按每组最新发布时间取 8 组，再每组按名次取前 10 行）；
   组的 publishedAt 改为组内最新一条。底栏「最新完成项目」一起吃这个修复。
   ⚠️ 取舍：单组超过 10 行的部分不再下发（前端每栏只画 6 行、实时赛况上限 10 行）；
   将来把每栏行数上限调到 10 以上时，必须同步调这里的 R。

③ 录分列表「运动员 / 队」列可限宽 + 逐行展开收起
   多人团体名单以前把整列撑宽。收起限宽 14em（省略号）、超过 24 个显示宽度
   （中文算 2）出现「展开 / 收起」；个人项目不出现按钮；展开状态只在本机内存。
   取舍：展开那一行会把列略微撑宽（成绩列右移约 80px），收起即恢复。

④ 录入页「以决赛成绩发布」从常驻勾选框改成发布弹窗里二选一
   默认「只更新名次（不计分、不发奖牌）」；每次打开都复位、不吃上一次；
   Alt+Enter 走同一个入口；取消 = 什么都不发生。
   审核页保持原样的常驻勾选框（两个页面口径一样、形态不同）。

⑤ 大屏控制页「在线大屏」列表：可读设备名 + 手动重命名 + 修重复条目
   - 自动设备标签（系统 · 浏览器 · 分辨率 · 手机/平板/桌面），由大屏端在握手时上报，
     服务端截断到 80/300 字符并清掉控制字符；老客户端不报时列表与升级前逐字一致。
     ⚠️ 浏览器没有读主机名/设备名的 API，自动标签只是辅助区分。
   - 手动重命名（录入员及以上，与切页同档）：存在系统库 settings 的
     display.instance_aliases（机器级、重启与切赛事都不丢），清除即回到自动标签；
     显示优先级 alias → device → id（id 降级成小字）。上限 200 条，满了拒绝新增并提示，
     不静默顶掉别的设备。设备离线过久条目被清理后别名仍留着。
   - 修：以前给局域网设备切页后列表底部会多出一条该设备的离线条目
     （翻页会补发握手，而浏览器没有稳定 id、服务端每次新开一条实例）。
     现在浏览器本机记住实例 id（localStorage），服务端也复用同一条连接已有的 id。

⑥ 局域网地址条目都能出二维码
   以前只有第一条常驻出码；现在其余每条多一个「二维码」按钮：点一下临时显示，
   再点一次 / Esc / 点空白处收起，同一时刻只留一个，且只为当前打开的那条懒生成 SVG
   （不在渲染时为每条地址都算一遍）。第一条的常驻码与「复制链接」未变。

⑦ 录分列表加「搜姓名 / 号码布」搜索框（人多项目找人不费劲）
   复用既有的「姓名 / 工号 / 号码布」匹配口径（未新增第三份），支持模糊、大小写不敏感、
   全角空格、号码布数字口径（007 搜 7、7 搜 007）；命中高亮；提示「找到 N 条 / 共 M 条」；
   × / Esc / 清除三种清空方式；搜不到给明确空状态。
   ⚠️ 搜索只影响表格显示：发布范围、进度条（仍是该批次总人数）、勾选、清空范围、
      预览算分一律不受影响，界面上也写明了这一点。
   ⚠️ 搜索状态下粘贴跟随「屏幕上看到的顺序」（隐藏的行不会被写到）——避免第二条成绩
      静默写到看不见的人身上。

测试：四套自检 ×2 全绿（finalcheck_0515*.log：前端 1096 例 / Console 96 例 / 服务端 14 条 ok，
EXIT=0）。①②都做了红/绿对照（改回旧实现，新用例当场变红；②的失败信息即现场形状
「第 3 栏应从第 1 名开始，实际名次 [5 6 7 8]」）。⑥⑦用真浏览器（playwright + chromium）
实机跑过（24 项 / 29 项全过，含「进度条数字不变」「搜索框里按 Alt+Enter 什么也不发生」）。

无数据库迁移；已有成绩、名次、积分与榜单不变。
文档：《升级说明》新增 dev_0.5.15；《使用手册》发布/录入/大屏控制三块与批量订正过期说法；
《常见问题》新增 Q105–Q107；《部署指南》《上线检查清单》同步；
devdocs/05（hello 新字段 + 别名接口）、13（第五十五轮）、16/06/07/18 与两处前端注释的旧窗口说法一并订正。
 2026-09-17 18:19:38 +08:00
AskaEth 877ff15823 feat(0.5.1): 业务逻辑审查 9 条 P0 全修 + 自绘安装器 + 现场反馈四项 
## 算分正确性（6 份只读审查 → 收敛成 5 个病根，均先复现失败再修）
- 「人工名次」与「自动名次回写」互斥：原来同一份成绩**发布两次分数不同**
  （团体报名项 dual 通道 10/8/6 → 25/18/14），现在连发多次逐字节一致
- 删小项时在同一事务作废旧流水并推榜：原来分数**永久残留**在总榜、任何重算都打不到
- 规则包导入整体事务化：原来中途失败会清空名次表且补不回（奖牌全丢）；
  另加守卫「compare=none 的小项不得配 basis=result/aggregate」
- 末位归零只抹真正落在末位的那一档：原来跨末位的并列组会被整组抹 0
  （7 人三人并列第 5 时第 5、6 名的分也一起没了）
- 模板「分值表档位超出录取名次」现在拒绝保存：原来静默截断成 0 分

## 现场反馈（主人实测报的）
- 已发布成绩可改：行内「修改本条」+ 成绩格/状态格可点（退回草稿→改→重新发布本组），
  与「作废」语义分开；取消路径不产生任何副作用
- 单位积分明细补「运动员 / 来源」列，并显示「已修订 ×N（时间·原因）」：
  管理端、大屏覆盖层、xlsx 备注列三处同源
- 单位奖牌榜改为按奖牌独立排名（金→银→铜→单位编码），与积分榜解耦
- 历史孤儿积分流水清理（迁移 0022，只动 result/record_bonus，人工调整分不受影响）

## 新功能
- 团体项目聚合口径二选一：平均（默认）/ 总和（迁移 0023，通道编辑器可切）

## 安装器
- 自绘五页安装界面：无边框、自绘标题栏、DPI 自适应（4K@200% 实测）、
  安装/卸载逻辑复用 electron-builder 宏不变；默认「为所有用户安装」并自动放行防火墙 19540
- 构建期校验：安装器素材里的版本号必须与 VERSION 一致，否则构建失败

自检：服务端 14 包 ×2 / 前端 vue-tsc + build + 742 例 ×2 / Console 20 文件 + 68 例 ×2，全绿。
端到端对拍：修前 vs 修后，纯团体 / 双计 / 普通个人三形态**逐字节一致**，仅出 bug 的双通道形态按要求改变。
 2026-09-13 15:20:18 +08:00
AskaEth 6841cf49aa 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）
- 使用手册 / 常见问题 / 部署指南 / 上线检查清单按实现同步
 2026-09-11 23:46:59 +08:00
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 8c74a82da4 feat(display): 分项成绩与个人榜也显示单位 logo（个人榜在姓名前） 
- 服务端补下发：dto.EventResultRow 与 athleteStandingDTO 各加 logoPath，
  分别取「该行单位」与「该运动员所属单位」的 teams.logo_path；空串统一收敛为 null
- 大屏抽出 TeamLogo.vue（1em / object-fit:contain / 加载失败保留占位、@load 复原），
  原先在积分榜与团体奖牌榜各写一遍的逻辑收敛成一份，四处复用
- 分项成绩页：单位列名字前显示 logo；个人积分榜：运动员姓名前显示其单位 logo
- guards/mock 同步解析与补字段；补 11 条测试（类型解析 + SFC 模板断言）

顺带修：管理端示例数据 athleteStandings 缺新必填字段导致的 vue-tsc 报错。

自检：服务端 11 包全绿；前端 vue-tsc + build、node --test 80/80。
 2026-09-10 10:32:19 +08:00
AskaEth 27bddefaad fix: 上线前快修（大屏自愈 / 奖牌口径 / 聚合作废 / 密码可发现性） 
- P0 慢客户端关闭码 1008 → 4000：前端把所有 1008 当「登录失效」并永久停止重连，
  大屏被踢后再也不自愈（服务端 markSlow 改用自定义码，前端逻辑不动）
- P1 REST 与 WS 的奖牌榜补 events.scored = 1 过滤，与导出成绩册口径一致
  （否则「只排名不计分」项目只要挂着通道就会在大屏凭空出奖牌）
- P1 聚合流水作废去掉 source_id 子查询：改通道会重建通道 id，旧聚合流水
  永远匹配不上 → 再插一份 → 分数翻倍
- P1 审核页/历史页的折算系数兜底由 ?? 1 改为 >0 ? : 1：/ws 快照对非 admin
  会把 individualToTeamWeight 置 0，recorder 看到的个人折算分全是 0
- P2 删掉 signature.local.txt 后清理残留的 signature.build.txt，避免继续注入旧署名
- 初始管理员密码：banner 加纯 ASCII 锚 INITIAL ADMIN CREATED，文档改为搜它
  （原来教的 findstr "password=" 已经失效，且中文 findstr 本身不可靠）

自检：服务端 12 包全绿；前端 vue-tsc + build 通过、node --test 24/24；console 语法通过。
 2026-09-09 23:13:20 +08:00
AskaEth 13f1f03cd0 fix: 修掉十路审查发现的 9 个 P0 与一批 P1（数据正确性 / 越权 / 现场可用性） 
P0（9 条全修）：
- 多通道项目奖牌重复计数：domain 层按 (EventID,CategoryID,EntryID/Subject) 去重，
  通道优先级 athlete→team→id
- 「只排名不计分」项目（scored:false）不再进奖牌榜，REST/WS/导出口径统一
- aggregate 流水 entry_id 恒 NULL 导致重算后分数翻倍：作废范围改按 event+category 定位
- 已发布成绩仍可被「存草稿」覆盖并清空 rank：服务端 409 STATE_INVALID + 前端禁编辑
- voidResult / 规则导入重算后名次不回写：接住 Ranked 调 applyComputedRanks
- 赛事包覆盖导入可能「旧项目已删、新项目没成」：先改名成功再清理，失败回滚
- 导入赛事包可覆盖正在运行的赛事目录：name==当前项目直接 400
- Console spawn 失败后守护器永久卡死：清 child/pid + 调度重启 + stop 超时兜底
- /ws 快照向非 admin 下发 admin-only 配置：按角色裁剪 settings

P1（计分口径 / 契约 / 现场）：
- standings.tieBreak 三处接线；profiles[].recordBonusMode 生效；破纪录校验
  RecordEligible 与 entry 归属；破纪录登记校验已发布成绩
- export.loadRanked 与主路径对齐；ListBackups reason 解析；CLI backup 前缀修正
  （原来只增不减会撑爆磁盘）；单位积分明细/导出统一权重折算；停用单位展示
- 规则导入原子化（重算并入同一事务）+ 返回 compatible/affectedEventCount/
  recalculatedLedgerRows；登录审计 user_id 修正
- WS 策略性断开用 Close(code,reason)；HelloMessage 补 page/instanceId；
  实例注册表清理；settings/单位/项目写操作补 change_log 触发大屏刷新
- 大屏：全量快照不再被版本守卫丢弃；个人积分榜刷新；公告返回页/轮播；行数截断；
  REST 竞态；1008 停止重连；握手超时；时区补 Z；401 仅 AUTH_REQUIRED 才登出
- 管理端：published 行禁编辑；saveDraft 补 unit（1:06.33 显示）；前端预览改用服务端
  points；空成绩行不再恒「已修改」；修订详情按 id 拉取；切项目请求序号与 dirty 保护；
  发布后刷新项目状态；NAV/路由按角色过滤；recorder 不再打 admin-only 接口
- Console：大屏窗口销毁后重建；大屏 URL 复用 host 归一化；backup.bat 改纯 ASCII
  （已在 Meowhome 实跑验证）

自检：服务端 gofmt/build/vet 通过、12 包测试全绿；前端 vue-tsc + build 通过、
node --test 24/24；console check-syntax 12 文件通过。
 2026-09-09 22:16:58 +08:00
AskaEth 7f9701c465 fix: 审查修复波次（P0x4 + P1x30+） 
- domain/rules: 计分与排名解耦、破纪录按组别、tieBreak 生效、调整分不丢、移除 aggregate 假能力
- realtime: 新建 internal/dto，快照三项契约对齐，/ws 只认会话身份
- httpapi: 流水幂等、standings 整表载荷、广播接线、强制改密、XFF 防伪造、records 写入、审计、赛事包内容、发布前备份、result.points、实例列表
- web: FormData 上传、YAML 解析、快照归一化、大屏解析层、bootstrap 降级、访客判定、主题切换
- console: 优雅关闭握手、中文化、免验证改管理员账号、选屏与日志轮转修复
- docs: 用户文档三份 + README
- 主代理: 破纪录加分接线（levels 未加载导致恒 0）
 2026-09-09 21:06:40 +08:00
AskaEth bc8b1ee6c0 feat: M3-M7 全模块落地 + 集成接线 
- M3 认证/权限/审计/限流 + 全部 REST 接口
- M4 管理面板（MIUIx + 成绩录入/积分榜下钻/大屏控制）
- M5a 大屏页面（六页 + 明细覆盖层 + 缩放适配）
- M6 WebSocket 实时同步中心
- M7 xlsx 导出 + 赛事包 zip + 备份
- 规则包 YAML 导入导出（差异预览）
- 字体 vendor 子集化（4 套 x2 字重）
- 集成：realtime/export/rules 接入 main+httpapi；backup 子命令
- 修复：中间件包装 ResponseWriter 丢失 Hijacker，导致 WS 握手 501
 2026-09-09 19:02:24 +08:00