AskaEth
56ed90ff8b
本批七项（三处是现场报的 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 与两处前端注释的旧窗口说法一并订正。
Scoreboard · 赛事积分榜系统
一套局域网内部署的赛事成绩与积分系统：一个服务端 + 两个界面，后台一改数据，前台大屏实时跟着变。
| 界面 | 地址 | 用途 |
|---|---|---|
| 实时积分大屏 | /display |
只读、无人值守；成绩发布后 1 秒内更新 |
| 管理面板 | /admin |
录入、发布成绩，控制大屏；未登录可只读查看全部赛事数据 |
功能概览
- 四个榜：总积分榜、团体奖牌榜、个人积分奖牌榜、分项成绩表
- 录入即上屏：成绩录入 → 发布 → 大屏即时更新
- 可追溯、可撤销：草稿不上屏；发布后纠错走「撤销发布 → 改 → 重新发布」，全程留痕
- 变更历史：仿 Git 图谱，一眼看清成绩是怎么变成现在这样的
- 现场公开：积分明细可下钻，争议时一键推送到大屏
- 全屏公告：推送后先全屏显示（5–120 秒），随即常驻大屏底部公告栏，直到替换或清除
- 分批发布：一个项目分多场跑（如跑道 8 条、30 人分 4 场）时，每跑完一批就能先发布一批——空成绩只是提示、不再挡发布，未录的行自动跳过，补录后再发一次即自动重算；名次与积分先按已发布的那部分算，大屏立刻有内容
- 实时赛况大屏页：新增「实时赛况」页，显示当前进行中项目的实时排名（名次 / 运动员·队 / 单位 / 成绩）；1 个项目单栏、2 个自动左右分栏；当前项目按「人工指定 → 排期命中（开始时间前后 30 分钟）→ 最近发布过成绩的项目」判定，下一场开始前持续显示上一场；可在「大屏控制 → 实时赛况」卡片配置
- 显式批次层：组别之下可再分批（
第 1 批、第 2 批…），录入页按批筛选、只在自己这一批里找人；支持手动勾选设置批次、报名表可选列heat、以及按人数「一键均分」。批次只是录入 / 展示分组，不参与算分——名次与积分仍按「小项 + 组别」计算 - 成绩框实时提示：聚焦成绩格打字时旁边浮出小气泡——合法显示解析结果（
1:06→= 66 秒）、可疑 / 不合法直接说原因并带出那一格原文；不挡输入、不改行高，与发布前防呆同一套口径 - 窄屏 / 手机可用：管理面板适配窄窗口与手机浏览器（局域网访问
/admin）：侧栏收成抽屉、宽表格横向滑动、对话框不超出屏幕、触控目标放大 - 小项类型齐全：个人 / 团体 / 对抗比赛 / 个人+团体（同一个项目同时按个人与团体通道记分）
- 多显示器：支持多屏各锁一页（kiosk 全屏），也能在管理端为指定显示器单独开窗或收窗；「大屏控制」页的「在线大屏」列表实时显示每个在线实例（含局域网浏览器打开的
/display）当前在哪一页，可逐屏 / 逐设备单独切页 - 规则可配置：积分规则以规则包（YAML）描述，可导入导出、跨赛事复用
- 运动员名册：启用 / 停用 / 彻底删除三档——「停用」保留全部历史数据、随时可启用；「彻底删除」把人员档案连同他名下的报名、成绩与积分流水一起删掉且不可恢复，并自动按新排序重算受影响小项的排名与积分（大屏同步更新）
- 参赛单位名册：启用 / 停用 / 彻底删除三档——「停用」保留全部历史数据、随时可启用；「彻底删除」是假删除，只把单位从列表里移除（界面上没有恢复入口），它的报名、成绩、积分流水与名下运动员全部保留，积分榜不会变化；报名表里再次用到该单位编码会让它自动恢复
- 赛事独立存档：每个赛事一个独立项目目录，整包可导出/导入（含会标、背景图、单位 logo 与上传的字体），并可在管理端页内一键切换当前赛事
- 结果导出：Excel 总表、全部（多 sheet）、全部（单页）、分项成绩表、单位积分明细可分别导出；「积分榜」页三个榜单的卡片头各有自己的明细导出——单位总分榜导出总明细（总表 + 每个有数据的单位一张分表）、团体奖牌榜导出奖牌明细（逐枚奖牌列出来源）、个人积分榜导出个人明细（逐条得分来源，与个人榜一致且不受折算系数影响），展开单位还能导出该单位明细
- 日志可复盘：服务端在数据目录
logs\下按「放行 / 拦截」两类分目录落盘——operations\记放行的写操作与常规运行日志，interceptions\记我们主动拦下的报错与服务端异常；拦截日志带中文原因与拦截点文件:行 函数名、操作人与 requestId，两类都按天 + 按大小轮转并自动清理旧文件（见部署指南第 10 节） - 成绩写法容错：时间类接受
66、66.33、1:06、1:06.33、1分06秒、1小时2分3秒等写法（全角冒号 / 全角数字也认），秒位 ≥ 60 会被拒但报错写明原因；成绩格里的示例是带「例」字的淡色斜体灰字，不会和已填内容混淆 - 单位 logo：大屏端的积分榜、奖牌榜、分项成绩表与个人榜都会显示参赛单位 logo（个人榜显示在姓名前；管理端页面只负责上传与配置，不显示 logo）
- 大屏字体可配：标题字体与正文字体可在「系统设置 → 赛事信息 → 字体」里从四款内置字体中选，或上传自己的字体（ttf / otf / woff / woff2，单个不超过 20 MiB）；只作用于大屏，加载失败自动回落默认字体，字体文件随赛事项目包一起导出/导入
快速开始
- 解压部署包
- 双击
Scoreboard_Console.exe（现场推荐：守护服务端、把大屏投到扩展屏、防熄屏、开机自启） - 浏览器打开终端提示的地址
大屏 http://<主机IP>:19540/display
管理面板 http://<主机IP>:19540/admin
也可以直接双击
scoreboard.exe（Linux 下执行./scoreboard）只跑服务端，大屏投放与进程守护需自行接管。完全离线运行，不依赖外网，不需要安装任何运行时。
文档
- 升级说明：每次升级前先看——这一版改了什么、升级后要补做什么、分数/奖牌为什么变化、5 分钟核对清单
- 上线检查清单：比赛当天照着走一遍的核对表（含交付物、目标机、首次启动、赛事项目包与规则包导入、大屏与公告、备份与回退）
- 部署指南：运行环境、安装与首次启动、端口与配置、大屏接线、赛事项目包导入/切换、备份恢复、故障排查
- 使用手册：角色权限、各功能页面的操作步骤、大屏端使用、常见操作问题
- 报名名单导入规范：报名表该用什么格式、11 列逐列怎么填、个人/团体/「个人+团体」三种项目的填法、常见报错对照（可直接发给各单位填表人）
- 常见问题（FAQ）：账号、成绩与积分、大屏、数据备份、导出导入
- 规则包格式：见 rules/README.md
许可证
MIT