 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
|
53a0cb225c
|
feat: 备份恢复 / 图片清理 / 单位恢复 / 审计过滤 / 模板引擎 M1 + 两个导入缺陷修复
用户点名的三件事（模板功能、删死代码、剩余缺口）这一批全部落地，另修掉两个刚暴露的导入缺陷：
**新增能力**
- 备份恢复：`POST /api/backup/restore`（admin）。先把校验做在拍快照之前（只读打开 + integrity_check +
关键表校验 + 异类库标志表互斥），再用 VACUUM INTO 拍「恢复前安全副本」，然后关连接、整文件替换、
触发优雅重启；`-wal` 还在时直接拒绝（宁可失败也不让旧库 WAL 套到新库上）；恢复后审计直写"恢复之后
还在的那份库"（不走通用 Auditor，否则记录只会落在被替换掉的旧文件上）。顺带修掉：裸服务端连续恢复
第二次会在拍副本处崩出一句看不懂的 500，现在回 503「上次恢复后尚未重启，请先重启服务端」。
- 安全副本保留策略：每类库保留最近 5 份，独立于 .db 的 20 份滚动清理。
- 图片管理：`DELETE /api/uploads/{name}`（被引用 409 并列出引用点）、`GET /api/uploads/orphans`、
`POST /api/uploads/orphans/delete`（只删列出的孤儿，宁漏勿误），全部 admin（与字体删除同档）；
`deploy/backup.bat` 补上 uploads/ 归档（logs 不归档：可再生的诊断且会无上限增长）。
- 已彻底删除单位的恢复：`POST /api/teams/{id}/restore`（与 hideTeam 同档）。幂等；恢复不会把「停用」
变成「启用」；真机确认恢复前后榜单逐字节一致、change_log 最大值不变（数据一行没动，不需要重算）。
界面加「显示已彻底删除的单位」（仅 admin）与恢复按钮；非 admin 的删除确认框里写明"本账号无法自行恢复"。
- 审计日志按 `action` 过滤（子串模糊，输入里的 %/_/\ 转义成字面量）。
- 删除死表 recent_projects（新增 system 迁移 0006，未动已应用的迁移）。
- points_override 不再"设了没效果"：写入侧 400 + 引擎侧守卫，提示改用「积分调整」。
- 联队份额空壳清理（UnionAttribution/UnionSplit/Entry.TeamShares/resolvedShares 等；TeamShare 类型保留，
因为 export/realtime/奖牌流水三处在生产路径上构造它）。
- 自定义大屏模板 M1：插值引擎（parseTemplate/renderTemplate），任何情况都不抛异常、未定义→空串+警告、
警告按 (code,path) 合并计数、无 eval/innerHTML，57 个新用例。
**两个真缺陷（前两个已随 0.1.6 出包）**
- 基础数据包导入「排序」列口径不一致：小项/组别留空保持原值，单位/大项留空被写成 0（plan 没从库里
现值起手）→ 四张表统一为「留空保持原值」。
- 同类第二处：布尔列「整列被删掉」被当成"取默认值"，会把库里所有停用的单位/大项静默改回启用 →
改为「缺列 = 不动」（写侧与解析侧都收口，补了"缺列保持/空格子=是/显式否=停用"三组对照用例）。
**删死代码**
- createEntry / updateEntry / deleteEntry / entryEventID / checkCategoryInEvent / getEntry /
normalizeEntryStatus / ExportBaseDataXLSX（全仓 grep 零引用）。⚠️ 随之记入文档：「组别必须属于该小项」
这道校验现在只由导入路径"按小项+组别名解析"天然保证，将来若新增从请求体接收 categoryId 的接口，
必须自己补校验（库层没有复合外键）。
**文档**
- devdocs 全面同步（01/02/03/04/05/06/07/09/11/12/13/README；含身份口径、延迟结算、大屏单栏新版式、
新增路由与设置键、R18/R19 风险）；docs 复核 + 第二轮（身份口径三个易写反的分支、图片删除、备份覆盖、
审计过滤、单位恢复、去掉硬编码版本号、上线检查清单 +5 项）；debug/使用说明 6 份逐份 diff 一致。
测试：服务端 13 包（连跑两遍）、前端 406 例、Console 28 例 + 18 文件语法检查 —— 全绿。
版本号 dev_0.1.6 → dev_0.1.7。
|
2026-09-11 19:26:36 +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 |
|