AskaEth/Scoreboard
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
82 Commits 1 Branch 1 Tag
2c983bcfdf09f67db4f623b884c3ed82d860679d
Commit Graph
13 Commits
Author SHA1 Message Date
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
AskaEth e5e0944d26 feat: 分级拦截日志 + 两类日志文件；成绩录入防呆/解析/宽度修复 
## 日志（用户要求：分级 + 每个拦截都要有指出代码行的调试日志 + 两类文件）
- 新增 internal/logging：拦截点捕获（file:line + 函数名，相对路径）、两类文件轮转、
  按级别/类别分流。httpapi 与 middleware 各自薄封装，无循环依赖。
- 两类目录（数据目录下）：
  operations/     放行类（INFO「操作已放行」+ 常规运行日志，按 log.level）
  interceptions/  拦截类（WARN 中文原因 + 拦截点 + method/path/actor/role/requestId、
                  DEBUG 上下文、ERROR 服务端异常）—— **固定 debug 采集**，
                  否则默认 info 下"每次拦截的调试日志"根本看不见
- 命名 operations-YYYYMMDD[.N].log，按天+按大小轮转，每类保留 keepFiles 份；写盘失败
  降级只写控制台且只 Warn 一次。
- 所有业务错误统一走 newAPIError 捕获拦截点（11 处内联 &apiError{} 已收进构造函数，
  防止绕过）；中间件层拦截（401/403/CSRF/未改初始密码/429）也留痕，响应体与状态码一字未变。
- config.yaml 的 log 段新增 dir / maxSizeMB / keepFiles（留空即默认）。
- 服务端包数 12 → 13（新增 internal/logging）。

## 成绩录入（用户实机踩坑）
- 真因一：成绩格 placeholder 是光秃秃的 `1:06.33`，而全仓库没有任何 ::placeholder 样式，
  示例文本与真实输入长得一样 → 用户把灰字当成已填内容，那 13 格其实是空的。
- 真因二：2 条报错是秒位 ≥ 60（1:70）或全角冒号（1：06）；1:06 与 1:06.00 在解析器里
  本来就等价（都 = 66），格式不是问题。
- 真因三：成绩格没有宽度定义（旁边名次 72px、状态 110px 都有），被挤到第 4 位数字看不见。

修复：parseSecondsDetail 区分 empty/seconds-overflow/unrecognized；新增 entryGuards.ts
纯函数（录入页与审核页共用），报错**打出那一格的实际内容**并说明原因；解析器新认全角
冒号/全角数字/1分06秒 等写法；成绩格 min-width 112px（按 fontTools 实测文本宽度定）；
示例文本改 `例 1:06.33` 等并给录入表格内的 ::placeholder 加淡色斜体；新增
onBeforeRouteLeave 离开守卫（原来切菜单会静默丢未保存成绩）。

测试：服务端 13 包全绿（372 个测试函数）；前端 vue-tsc 通过、205 例全过；Console 18 文件。
docs/ 与 devdocs/ 同步（FAQ 到 Q76，部署指南新增第 10 节「服务端日志与拦截复盘」）。
 2026-09-11 01:59:58 +08:00
AskaEth 8e707e1e9b feat: 团体奖牌 / 个人积分两个榜单的专属明细导出 
用户答复「允许细化」——给另外两个榜单各做一份逐项来源导出（此前它们的「明细」共用
单位积分明细、个人榜连明细列都没有）。

- `GET /api/export/medals.xlsx` → `团体奖牌明细.xlsx`：总表 单位/大项/小项/组别/名次/奖牌/运动员-队
  + 每个有奖牌的单位一张分表（末尾小计 金X/银Y/铜Z）；无奖牌的单位不出分表。
  去重与牌色判定**完全交给 domain**（每组调 domain.BuildMedalStandings），导出侧只做
  「同一报名项归一组」，不复制任何计奖规则——双计通道只记一枚奖牌因此自动成立。
- `GET /api/export/athletes.xlsx` → `个人积分总明细.xlsx`：总表 单位/运动员/大项/小项/组别/
  名次/成绩/得分/来源 + 每个有得分的单位一张分表（按单位分，不按人分）。
  得分取**记到个人的原始分**（与个人积分榜同一口径，不看 count_to_team、不乘折算系数）。
- 管理端三个榜单的卡片头各一个导出入口（导出总明细 / 导出奖牌明细 / 导出个人明细），
  展开单位时明细卡头是「导出该单位明细」；导出页仍是 5 项，两个新导出只在积分榜页触发。

护栏（跨端点一致性，都有实测断言）：
- 奖牌明细逐单位与「团体奖牌榜」对齐，双计项目只出一行；
- 个人明细合计与「个人积分榜」一致，且把折算系数改成 0.5 后个人明细一分不变、单位总分变 5。

测试：服务端 12 包全绿（358 个测试函数）；前端 vue-tsc 通过、190 例全过；Console 18 文件。
docs/ 与 devdocs/ 同步（FAQ 到 Q72，含上一轮"个人积分榜不能导出"的修正）。
 2026-09-11 01:17:14 +08:00
AskaEth 782a38f82f feat: 大屏控制可看局域网设备并逐台切页 + 两种新导出（单页成绩 / 单位积分总明细） 
## 大屏控制（用户：管理面板只能看到本机显示器，看不到局域网设备；也不能给某块屏单独切页）
- 服务端：`POST /api/display/command` 新增可选 `targets []string` —— 空 = 广播（公告语义不变），
  非空 = 只发给点名的实例并返回命中数；命中 0 个返回 404 +「目标大屏已离线，请刷新在线列表」
  （不落审计、公告也不落库）。`DisplaySender` 签名随之扩展，新增
  `Hub.SendCommandToInstances`（与按房间的 SendCommand 并存）。
- 服务端：WS `hello` 新增可选 `screen`，`realtime.Instance` 新增 `Screen`（不带 omitempty，
  局域网浏览器恒为空串），这样管理端能把「本机显示器」与「在线实例」精确对上。
- 管理端「大屏控制」：写死的「在线看板」占位换成真实列表（5 秒轮询、页面隐藏停表），
  列出实例 id / 在线离线 / 落后 / 屏号或「局域网浏览器」/ 当前页 / 来源 / 心跳；
  每行可单独切页；本机显示器卡片补「当前页」与逐屏切页；离线时控件置灰并说明原因。
  页面下拉改为共用大屏那份页名清单（管理端两处标签随之变为「个人积分奖牌榜」「分项成绩」）。

## 导出（用户：保留多页工作簿的同时，再要一种全平铺单页；积分榜明细也要能导出）
- 新增 `GET /api/export/all-flat.xlsx` → `赛事成绩总表（单页）.xlsx`：一个工作簿一张表，
  列 = 大项/小项/组别/名次/号码/单位/运动员-队/成绩/积分/状态/备注；前三列取
  `EventSheet` 的结构化字段（不解析标题），后 8 列就是 `eventColumns` 本身（append 拼出，
  两处不可能漂移）。**既有「全部」（all.xlsx，多 sheet）一字未动。**
- 新增 `GET /api/export/teams.xlsx` → `单位积分总明细.xlsx`：一张带「单位」列的总表 +
  每个有明细行的单位一张分表；**无明细行的单位不出分表**（空表没信息量，且会把假删除的
  隐藏单位名字重新印进导出件）；已隐藏但有流水的单位照常出表（它在榜单上）。
- 积分榜页：页头「导出总明细」、单位明细面板「导出该单位明细」；导出页新增「全部（单页）」。

测试：服务端 12 包全绿 / 347 个测试函数；前端 vue-tsc 通过、184 例全过；Console 18 文件。
docs/ 与 devdocs/ 同步（含新增 Q65–Q70 与两轮进度记录）。
 2026-09-11 00:44:03 +08:00
AskaEth 5ae49b001c feat: 参赛单位「彻底删除」= 假删除（界面隐藏，数据与榜单全保留） 
与运动员的真物理删除是**两套相反口径**，有意如此（两个按钮同名，代码与
文档里都做了显著区分）：

- 运动员 `?purge=1`：真删人员+报名+成绩+流水并重算积分（上一版 `9d4ee09`）
- 参赛单位 `?purge=1`：只置 `teams.deleted_at` + `active = 0`，让单位从列表里
  消失；报名、成绩、积分流水、人工调整、纪录、名下运动员全部原样，
  **不触发重算、积分榜不变**（单位下挂着几十号人，真删代价太大）

实现：
- 迁移 0018 `ALTER TABLE teams ADD COLUMN deleted_at TEXT`
- `listTeams` 默认排除已隐藏单位；`?includeDeleted=1` 仅 admin；
  `GET /api/teams/{id}` 对已隐藏单位：admin 200 / 非 admin 404
- 审计 `team.purge`（detail 标明是隐藏）；成功走 `writeVoid`（无统计对象）
- 报名导入按 `team_code` 命中已隐藏单位时复活（清 deleted_at、置 active=1）
- 故意不过滤的地方都加了注释：榜单补单位名、写路径与审计、导入按 code 查、
  赛事包导出、大屏快照、按 team_id JOIN 取历史单位名——过滤会让历史成绩的
  单位名变空白或让包的引用悬挂

管理端「参赛单位」行加「彻底删除」按钮 + 危险确认框（如实写明"从列表移除、
数据不受影响、积分榜不会变化"），失败原文展示、404 不降级。

顺带修一处界面文案与行为不符：单位页原写「停用后新报名不再可选该单位」，
但报名选择器其实仍会列出已停用单位供手动勾选（只有「全选」跳过它们），
已按真实行为改写（两处）。

测试：服务端 12 包全绿（新增 team_purge_test.go 与 0018 迁移用例）；
前端 172 例全过（新增 team-purge-api.test.ts 6 例）。docs/ 与 devdocs/ 同步。
 2026-09-10 23:48:28 +08:00
AskaEth fc96d17660 feat: 字体可配并随赛事包打包 + 大屏调试标识收敛 + 报名表 CSV 编码兼容 
三块改动，均为现场反馈：

一、字体配置与随包打包（此前「没有入口可以配置字体」，导出包也不带字体）
- 服务端新增 httpapi/fonts.go 与 4 条路由：GET /api/fonts（recorder）、
  POST /api/fonts（admin，multipart file）、DELETE /api/fonts/{name}（admin）、
  GET /uploads/fonts/{name}（匿名——大屏 @font-face 不带会话）
- 上传限 ttf/otf/woff/woff2、单个 20 MiB；文件名经 safeFontName 收敛且需与
  fontContentType 往返一致，挡住路径穿越；重名 409、删除被引用字体 409
- 新增设置键 display.font_title / display.font_body（DTO fontTitle/fontBody，
  随快照下发给大屏），写入时校验取值合法
- 导出：接上一直没被赋值的 IncludeFonts/FontsDir；包内落点用 uploads/fonts/
  （运行时只读这里，落顶层 fonts/ 等于没人读）
- 大屏按配置动态注册字体并挂 --display-font-title/body，加载失败静默回落默认字体
- 管理端「赛事信息」新增字体区块：标题/正文字体下拉、上传、字体库、实时预览

二、大屏显示收敛
- 数据版本号角标 vN 彻底移除（原先只有窗口化窗口会显示，两处显隐口径不一致）
- 窗口化窗口按 F11 全屏后自绘标题栏不让位：根因是 Console 用 win.setFullScreen()
  做窗口级全屏，而页面用 document.fullscreenElement 判断，后者恒为 null；
  新增 display-preload.js 下发窗口级全屏状态，页面侧 shell.ts 把两级全屏取或，
  无 preload 时（浏览器直连 /display）回落到文档级监听

三、报名表 CSV 编码兼容（用户报「解析中文字符遇到编码问题」）
- 服务端不再把原始字节直接喂给 csv.Reader：先摘 UTF-8 BOM，再认 UTF-16 LE/BE
  BOM，其余非合法 UTF-8 按 GB18030 解（GBK 是其子集）
- 修复前症状：GBK 文件（Excel 另存为 CSV 的默认编码）中文变乱码；带 BOM 的文件
  （Excel「CSV UTF-8」，也正是我们自己模板的格式）把 BOM 拼进第一列表头，
  报「报名表缺少列 event_code」——连「下载模板→填→传回来」都走不通
- golang.org/x/text 由 indirect 提升为直接依赖，未新增外部依赖

测试：服务端 12 包全绿（新增 fonts_test.go / fonts_internal_test.go /
handlers_import_encoding_test.go）；前端 vue-tsc 通过、pnpm build 通过、157 例全过；
Console 语法检查 17 个文件通过。docs/ 与 devdocs/ 同步更新。
 2026-09-10 17:45:11 +08:00
AskaEth 9c6d0bd3b3 docs: 用户文档补齐「个人+团体」等新功能，修正切换赛事与账号存储位置的说法 
按 407abec 之后落地的功能，对照代码逐条更新四份用户文档与 README：

- 使用手册：补「个人+团体」是什么与完整配置链路、平均值口径两种分母、
  榜单口径（全局）折算系数、公告（全屏→底栏常驻）、报名导入两个页签、
  单位 logo 显示位置、17.5 调试标识；修正「账号存在各个赛事库里」的错误说法
  （账号与会话在数据目录的 system.db），在线看板改为指向服务管理窗口的实例卡片
- 部署指南：新增 7.5 显示器菜单 / 7.6 公告 / 7.7 调试标识与单位 logo；
  重写 8.5 赛事项目包（导入 ≠ 切换、包内四类内容、不能覆盖运行中的项目），
  并把 -project 启动参数明确标为「不要用来切赛事」
- 上线检查清单：补当前赛事、显示器菜单、单位 logo、公告四项现场核对，
  修正「切换后登录状态失效」
- 常见问题：重编号 Q1–Q48，新增个人+团体算分、平均值口径、只报单位、
  折算系数、公告底栏、单位 logo、调试标识 8 条；切换赛事与数据迁移按实测重写
- README：功能概览与文档索引同步
 2026-09-10 15:16:17 +08:00
AskaEth 407abec3b0 fix: 大屏背景图被兜底渐变盖住 + 配置/规则也搬到用户数据目录 
1) 大屏背景图不生效：App.vue 里 .bg 与 .bg-fallback 都是 absolute inset:0，
   而兜底渐变是不透明的且在图片之后绘制 → 配了背景图也只看得到渐变。
   改成 v-if/v-else 互斥（用无头 Chromium 真渲染对照验证：修复后取到图片像素，
   回退版本只剩渐变）。新增 background-layer.test.ts 锁住层次关系。

2) 规则/config 仍在安装目录，覆盖安装/卸载会连配置一起删：现在三样都落在
   %LOCALAPPDATA%\ScoreboardConsole\（与数据目录同一基座）：
   - console\config.json（Console 读写都用这份）
   - config.yaml（Console 用绝对路径 -config 传给服务端与 passwd）
   - rules\（首次从安装目录复制过去，之后只认用户目录那份）
   首次运行复制迁移、已存在不覆盖、不可写则回落安装目录并记日志（不影响启动）；
   开发态行为不变。备份脚本与文档同步。
   注意 resolveExecutable 必须显式传部署包根目录，否则会去用户目录找 scoreboard.exe。

自检：服务端 11 包全绿；console 语法 16 文件 + node:test 20/20；
前端 vue-tsc + build、node --test 69/69。
 2026-09-10 10:06:21 +08:00
AskaEth 005b51b2ec fix: 数据目录移出安装目录，修掉「覆盖安装/卸载即丢数据」 
根因：数据目录是 <安装目录>\data（config.yaml 的 dataDir 相对服务端工作目录），
而 electron-builder 的卸载器结尾执行 RMDir /r $INSTDIR，且覆盖安装会先跑旧卸载器
（installSection.nsh:52 的 uninstallOldVersion）→ 赛事库/规则/用户/审计/上传图片
连同安装目录被整个删除，再装新版。卸载一次同样如此。

- 服务端新增 -data <dir>（主命令、backup、passwd 三处），非空时覆盖 config.yaml 的
  dataDir；不传时行为完全不变（兼容便携/手工运行）
- Console 把数据指到当前用户目录 %LOCALAPPDATA%\ScoreboardConsole\data（卸载器不会碰
  这里；没有用 app.getPath('userData')，因为 %APPDATA%\<AppName> 正是被删的那个）
- 一次性迁移：目标为空且 <安装目录>\data 有数据时整体改名过去；两边都有数据时不动作
  只记警告；任何失败都保留原地数据、绝不删除
- passwd 也带 -data（否则重置的是安装目录下那个空库里的账号）
- deploy/backup.bat 指向同一数据目录
- 文档：部署指南新增「数据放在哪里（升级/卸载都不会删）」+ 备份/恢复/迁移路径改写，
  上线检查清单与使用手册同步

自检：服务端 12 包全绿；console 语法 14 文件 + datadir 单测 11/11；backup.bat 保持纯 ASCII。
 2026-09-10 09:17:56 +08:00
AskaEth 6483acf9ad feat: 人员年龄/号码布、图片上传、多显示器菜单、Console 两栏、exe 改名等一批改动 
人员与报名：
- 人员唯一标识改为「证件号 或 号码布」二选一（0013/0014 迁移 + 导入匹配/回填/冲突）
- 人员新增「年龄」（0015 迁移）：表单/列表/导入模板表头 11 列；冲突比较只在两边
  都有值且不同时才算差异，旧数据不误报
- 冲突决策键改为「证件号优先 → 号码布」（前端原先只用 idCard，号码布行会互相覆盖）
- 报名选择器支持无证件号但有号码布的运动员

大屏与 Console：
- 大屏控制新增「显示器」菜单：可给指定显示器重建全屏窗口；单屏/主显示器强制窗口化，
  限制在 Console 侧判定，不信任页面传参
- Console 服务管理窗口改左右两栏，运行日志独占右栏满高；窗口默认尺寸 1280×860
- 大屏右上角时钟精确到秒（同时把刷新间隔 15s 改为 1s）

图片与配置：
- 新增图片上传 POST /api/uploads（recorder+，png/jpg/webp/gif，≤5MiB）与匿名静态
  访问 GET /uploads/{name}（防目录穿越）；文件落赛事项目目录 uploads/，随赛事包
  一起导出/导入
- 「赛事信息」新增赛事会标 / 大屏会标 / 大屏背景图三个上传项
- 参赛单位 logo 输入框右侧加上传按钮

关于页与构建：
- 构建时间打通：version.BuildTime + /api/system/about 返回 + build.bat 注入
  （用 PowerShell 取时间戳，避免本地化 %DATE% 的非 ASCII 星期）

安装包：
- 主程序改名 Scoreboard_Console.exe（win.executableName；productName/显示名不变）
- 记住上次安装目录：自定义 NSIS 宏优先沿用自存路径（卸载不清除），并在 customInit
  里补写回 electron-builder 的键，避免安装模式页把 $INSTDIR 打回默认

自检：服务端 12 包全绿；前端 vue-tsc + build 通过、node --test 58/58；console 12 文件通过。
 2026-09-10 09:05:06 +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 045b0f5d95 docs: 上线清单补一条安装目录写权限提醒 2026-09-09 22:47:25 +08:00
AskaEth a0a4824dda docs: 新增上线检查清单（当天照着走一遍的核对表），README 加链接 2026-09-09 22:47:14 +08:00