 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
|
631c8dd8e1
|
feat: 8 条功能 + 身份口径改为号码布为准（含批量退赛/移出、基础数据导入导出、登录有效期）
用户给出的 8 条功能 + 一条口径变更，全部带真机/真浏览器验证：
① 录入页姓名后直接显示号码布（原「号码」列保留）
② 录入页批次进度条：`第 2 批 已录 5/8 · 3 条有错`，录完变绿；已录判据复用
entryGuards.judgeEntryRow（与发布防呆同源，不会出现"进度条说录完、发布说缺 8 条"）
⑦ 小项列表双击 → 跳到该小项的组别（编辑/删除按钮不误触）
③ 赛事开关 `standings.live_on_publish`（默认开＝保持原行为）：关闭后分批发布只上屏成绩，
名次/流水/榜单一起等该组录完再结算 —— 代理实读代码后纠正了我的前提：
奖牌榜读的是 results.rank（buildRanked）而非流水汇总，只延迟流水会出现
「有金牌但 0 分」。另提供 POST /api/results/settle 人工兜底 + GET /api/results/settlement 未结算清单
④ 组别「就地更新」PUT /api/events/{id}/categories/{categoryId}：有报名数据时也能改名/改年龄/
改性别/改权重（旧路径是整表替换，一改就被 409 拦下）；改名不动报名/成绩/流水（真机逐字节比对）；
权重真的变了才触发该组重算（容差 1e-9）
④辅 运动员列表多选+全选，POST /api/athletes/batch 一次请求完成整批停用/彻底删除（逐条回报，
dryRun 预览走同一段 SQL 但不提交、不写审计）——这才是绕开限流的正解
新增 报名项批量：POST /api/entries/batch（scratch/restore/remove）。退赛只动 registered、
跳过 dq/dns 并说明原因；移出是物理删除，必须显式清 score_ledger（该表 entry_id 是
ON DELETE SET NULL，不显式删会留下"人没了分还在"的孤儿流水，验证基线 orphan=0）；
退赛同时清 results.rank（否则出现"0 分还挂着金牌"）
⑤ GET /api/export/entries.xlsx 报名名单导出（13 列含批次，状态中文与录入页逐字一致）
⑥ 基础数据包：GET /api/export/basedata.xlsx + POST /api/export/basedata/import
（四张表、表头只有一份定义、表头行自动定位、列缺席≠写空、按编码 upsert、绝不删除、
行级中文错误带真实 Excel 行号、枚举走既有校验、新增单位一定是启用）
⑧ 登录有效期面板可配：系统设置新页签，1–720 小时，默认 12h → 24h；滑动续期 +
Cookie 同步刷新（只服务端续期是假的，浏览器侧的 Max-Age 到点仍会丢 Cookie）
身份口径：号码布为唯一标识、证件号退出匹配（号码布不同=同名的两个人，新建并单独报告）；
同一份表重复证件号不再报错；两个不同的人共用证件号仍报行级错误（唯一索引保留）
其它对齐：分项成绩表草稿行不再消失（成绩列「分数未录入」、名次/积分 `—`，没成绩的行同占位）；
大屏实时赛况单栏铺满（留白 370→78px）、字号上限 56→96px、≥7 行自动拆左右两块；
删除报名项/退赛/权重等改动都会重算并推榜单。
测试：服务端 13 包（连跑两遍）、前端 335 例、vue-tsc + build、Console 18 文件 —— 全绿。
文档：README、docs/ 四份（含 debug/使用说明 副本）、devdocs 05/08/04/13。
版本号 dev_0.1.5 → dev_0.1.6。
|
2026-09-11 17:14:02 +08:00 |
|
|
AskaEth
|
08a5740fb2
|
feat: 分批发布 + 实时赛况页 + 显式批次层 + 成绩框实时提示 + 窄屏适配 + 版本号单一真相
## 分批发布（现场：100 米跑道只有 8 条，不能等所有人跑完才发）
- 空成绩从"错误"降级为"提示"，不再阻塞发布；真会算错（写法无法识别、秒位 ≥ 60、
手动名次缺名次）仍挡住。发布确认框说明"只发已填的 M 人，其余保持未发布"。
- 服务端核实：publishResults/computeEventScore 本就不会因缺成绩报错
（collectCandidates 直接跳过没有 results 的报名项），根因在前端防呆。
## 实时赛况（新大屏页 + 定向接口）
- 新增 `GET /api/display/live`（guest 可读）：返回「当前项目」判定 + 该项目**全量**已发布成绩
（不受快照 latestResults 的 20 行截断）。回退链：manual 指定 > 排期命中 > 最近发布。
设置键 display.live_events / display.live_source。
- 大屏新页 `live`「实时赛况」：1 个项目单栏、2 个自动左右分栏；失败保留上一次画面
（下一场开始前持续显示上一场）；30s 轮询（判定依赖当前时间）+ 快照变更触发。
- 管理端「大屏控制」新增「实时赛况」卡；该卡走 PUT /api/settings（admin-only），
故对非管理员整组置灰 + 提示条（不新增角色）。
## 显式批次层（组别之下）
- 迁移 0019 `entries.heat`；批次仅是录入/展示分组，**不参与算分**（有"分批与不分批结果
完全一致"的断言守住）。批量设置接口 + 导入 CSV 可选列 heat + 录入页批次下拉 +
一键均分（按 N 人切片，已有批次号接着往后排）。
## 成绩输入框实时悬浮提示
- 聚焦格旁的浮动气泡：pointer-events:none、不占布局不改行高、贴底自动上翻；
合法显示解析结果（1:06 → = 66 秒）、可疑/不合法显示原因并带那一格原文；
与发布防呆共用同一套纯函数（entryGuards.ts），口径不会分叉。
## 窄屏 / 手机端布局
- 真浏览器（Playwright + chromium）在 1440/1024/768/390 四宽度逐页审计 + 溢出探针，
四轮迭代修复；桌面端 1440 前后像素差异 < 0.25%（无回归）；修掉如「修改密码」输入框
塌成 22px 这类真问题。
## 版本号单一真相
- 新增仓库根 `VERSION`：构建时注入二进制（-X main.version）并同步 console/package.json
的版本（产物名跟随）。源码里不再有人工维护的版本号（兜底值改为 `dev`，故意不写数字）。
测试：服务端 13 包全绿；前端 vue-tsc 通过、249 例全过；Console 18 文件。
docs/ 与 devdocs/ 同步（FAQ 到 Q80、新增 devdocs/16 自定义大屏模板设计文档）。
|
2026-09-11 04:05:02 +08:00 |
|