Scoreboard

96 Commits 1 Branch 1 Tag

2 Commits

Include renames

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

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