Scoreboard

89 Commits 1 Branch 1 Tag

2 Commits

Include renames

Author	SHA1	Message	Date
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	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

Author

SHA1

Message

Date

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

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