Scoreboard

86 Commits 1 Branch 1 Tag

2 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	8dd599bd97	fix: 实机复测六批发现的 16 条缺陷（导入编码静默错误 / 导出观感 / 错误分级 / 大屏裁切）先把「实机复测」能在这台 Linux 机器上验的全部自己验掉（真服务端 + 真 Chromium + 真样本），六批全部通过，另挖出 16 条缺陷，逐条修完并复验：导入 - 坏字节被静默替换成 U+FFFD 却报「组别不存在」→ 检测 RuneError 回 400 + 可操作中文文案 - UTF-16 无 BOM 误报「缺少列 event_code」→ 保守判据识别并正确解码 - CSV 语法错只有英文 → 中文提示，英文原文保留在 detail - 表头缺列补「第 1 行应是表头」的指向导出 - 名次列宽 8 → 11（放得下「3（并列）」，Excel 里不再硬裁） - 运动员/队列宽 18 → 24（含奖牌明细的同一列） - 聚合流水行补组别（仅单位在该小项只参加一个组别时回推；多组别宁可留空也不猜） - docProps 作者从 excelize 默认的 xuri 改成中性名 + 真实导出时间 - Content-Disposition 补 ASCII 退化 filename（9 个下载端点，含此前没有测试的 project.zip）错误分级与限流 - 未知大屏指令 500 → 400 VALIDATION_FAILED（传输层真失败仍走 5xx） - 5xx 的 ERROR 日志补 role / ip（4xx 的 WARN 一直有） - 写限流 30 → 120 次/分钟/用户（登录 5 次/分/IP 不动，性质不同） - 赛事名含非法字符时导出给 400 + 可操作提示（原来永远 500「服务端异常」）大屏与基础设施 - 实时赛况 2 栏成绩末位被裁（1:09.00 显示成 1:09.0）→ 成绩列按内容定宽 + nowrap；字号不缩，让位给可省略号截断的运动员列。真 Chromium 实测 slack −45px → +6px、0 裁切、 scrollWidth 恒 1920（无横向滚动条）；顺带修掉 1 栏长成绩同样被裁 8px 的问题 - logging 启动即预建两个日志目录（原来 interceptions/ 懒创建，现场会以为日志坏了） - C→S 裸帧由静默忽略改为 WARN，并把「要套 {event,data} 外壳」写进日志 - 建单位/大项漏传 active 不再静默建成「停用」（新增 decodeJSONPresence 按键是否存在判意图）文档 - README 单位 logo 措辞收窄到「大屏端」（管理端只负责上传配置） - 导入规范补三类编码报错说明 + 现场另存结论 + 限流提示 - 部署指南补「导出前先看赛事名称」与「切换后怎么确认真的切过去了」 - devdocs 05/08/13 同步（含第三十五轮的完整记录与教训）自检：服务端 13 包连跑两遍全绿；前端 257 例；vue-tsc + build 通过；Console 18 文件。版本号 dev_0.1.4 → dev_0.1.5。	2026-09-11 15:35:42 +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

Author

SHA1

Message

Date

AskaEth

8dd599bd97

fix: 实机复测六批发现的 16 条缺陷（导入编码静默错误 / 导出观感 / 错误分级 / 大屏裁切）

先把「实机复测」能在这台 Linux 机器上验的全部自己验掉（真服务端 + 真 Chromium + 真样本），
六批全部通过，另挖出 16 条缺陷，逐条修完并复验：

导入
- 坏字节被静默替换成 U+FFFD 却报「组别不存在」→ 检测 RuneError 回 400 + 可操作中文文案
- UTF-16 无 BOM 误报「缺少列 event_code」→ 保守判据识别并正确解码
- CSV 语法错只有英文 → 中文提示，英文原文保留在 detail
- 表头缺列补「第 1 行应是表头」的指向

导出
- 名次列宽 8 → 11（放得下「3（并列）」，Excel 里不再硬裁）
- 运动员/队列宽 18 → 24（含奖牌明细的同一列）
- 聚合流水行补组别（仅单位在该小项只参加一个组别时回推；多组别宁可留空也不猜）
- docProps 作者从 excelize 默认的 xuri 改成中性名 + 真实导出时间
- Content-Disposition 补 ASCII 退化 filename（9 个下载端点，含此前没有测试的 project.zip）

错误分级与限流
- 未知大屏指令 500 → 400 VALIDATION_FAILED（传输层真失败仍走 5xx）
- 5xx 的 ERROR 日志补 role / ip（4xx 的 WARN 一直有）
- 写限流 30 → 120 次/分钟/用户（登录 5 次/分/IP 不动，性质不同）
- 赛事名含非法字符时导出给 400 + 可操作提示（原来永远 500「服务端异常」）

大屏与基础设施
- 实时赛况 2 栏成绩末位被裁（1:09.00 显示成 1:09.0）→ 成绩列按内容定宽 + nowrap；
  字号不缩，让位给可省略号截断的运动员列。真 Chromium 实测 slack −45px → +6px、0 裁切、
  scrollWidth 恒 1920（无横向滚动条）；顺带修掉 1 栏长成绩同样被裁 8px 的问题
- logging 启动即预建两个日志目录（原来 interceptions/ 懒创建，现场会以为日志坏了）
- C→S 裸帧由静默忽略改为 WARN，并把「要套 {event,data} 外壳」写进日志
- 建单位/大项漏传 active 不再静默建成「停用」（新增 decodeJSONPresence 按键是否存在判意图）

文档
- README 单位 logo 措辞收窄到「大屏端」（管理端只负责上传配置）
- 导入规范补三类编码报错说明 + 现场另存结论 + 限流提示
- 部署指南补「导出前先看赛事名称」与「切换后怎么确认真的切过去了」
- devdocs 05/08/13 同步（含第三十五轮的完整记录与教训）

自检：服务端 13 包连跑两遍全绿；前端 257 例；vue-tsc + build 通过；Console 18 文件。
版本号 dev_0.1.4 → dev_0.1.5。

2026-09-11 15:35:42 +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