22ab49e73adcdc4e08251585c7db7b2b25873179
面向非技术读者写清楚报名表到底长什么样、每一列怎么填: - 11 列逐列说明(哪些必填、值域、示例),表头大小写不敏感、 列顺序可调、多余列忽略;event_code/team_code 抄系统编码、 category 填组别名称、status 只能填 registered/scratched/dq/dns 小写 - 个人项目 / 团体项目 / 「个人+团体」三种项目的完整示例表格 - 导入前自检清单、常见报错逐条对照(含中文乱码与「缺少列 event_code」)、 重传是整条覆盖(空值会清掉原值、status 会被重置)这条容易踩的坑 - 一页版「给填写人的最短提示」 同时:README 文档索引、使用手册 §10.7、常见问题 Q51 交叉引用该文档; debug/使用说明/ 也放了一份,方便直接发给填表人。
Scoreboard · 赛事积分榜系统
一套局域网内部署的赛事成绩与积分系统:一个服务端 + 两个界面,后台一改数据,前台大屏实时跟着变。
| 界面 | 地址 | 用途 |
|---|---|---|
| 实时积分大屏 | /display |
只读、无人值守;成绩发布后 1 秒内更新 |
| 管理面板 | /admin |
录入、发布成绩,控制大屏;未登录可只读查看全部赛事数据 |
功能概览
- 四个榜:总积分榜、团体奖牌榜、个人积分奖牌榜、分项成绩表
- 录入即上屏:成绩录入 → 发布 → 大屏即时更新
- 可追溯、可撤销:草稿不上屏;发布后纠错走「撤销发布 → 改 → 重新发布」,全程留痕
- 变更历史:仿 Git 图谱,一眼看清成绩是怎么变成现在这样的
- 现场公开:积分明细可下钻,争议时一键推送到大屏
- 全屏公告:推送后先全屏显示(5–120 秒),随即常驻大屏底部公告栏,直到替换或清除
- 小项类型齐全:个人 / 团体 / 对抗比赛 / 个人+团体(同一个项目同时按个人与团体通道记分)
- 多显示器:支持多屏各锁一页(kiosk 全屏),也能在管理端为指定显示器单独开窗或收窗
- 规则可配置:积分规则以规则包(YAML)描述,可导入导出、跨赛事复用
- 赛事独立存档:每个赛事一个独立项目目录,整包可导出/导入(含会标、背景图、单位 logo 与上传的字体),并可在管理端页内一键切换当前赛事
- 结果导出:Excel 总表、全部分项、分项成绩表、单位积分明细可分别导出
- 单位 logo:积分榜、奖牌榜、分项成绩表与个人榜都会显示参赛单位 logo
- 大屏字体可配:标题字体与正文字体可在「系统设置 → 赛事信息 → 字体」里从四款内置字体中选,或上传自己的字体(ttf / otf / woff / woff2,单个不超过 20 MiB);只作用于大屏,加载失败自动回落默认字体,字体文件随赛事项目包一起导出/导入
快速开始
- 解压部署包
- 双击
Scoreboard_Console.exe(现场推荐:守护服务端、把大屏投到扩展屏、防熄屏、开机自启) - 浏览器打开终端提示的地址
大屏 http://<主机IP>:19540/display
管理面板 http://<主机IP>:19540/admin
也可以直接双击
scoreboard.exe(Linux 下执行./scoreboard)只跑服务端,大屏投放与进程守护需自行接管。完全离线运行,不依赖外网,不需要安装任何运行时。
文档
- 上线检查清单:比赛当天照着走一遍的核对表(含交付物、目标机、首次启动、赛事项目包与规则包导入、大屏与公告、备份与回退)
- 部署指南:运行环境、安装与首次启动、端口与配置、大屏接线、赛事项目包导入/切换、备份恢复、故障排查
- 使用手册:角色权限、各功能页面的操作步骤、大屏端使用、常见操作问题
- 报名名单导入规范:报名表该用什么格式、11 列逐列怎么填、个人/团体/「个人+团体」三种项目的填法、常见报错对照(可直接发给各单位填表人)
- 常见问题(FAQ):账号、成绩与积分、大屏、数据备份、导出导入
- 规则包格式:见 rules/README.md
许可证
MIT
Languages
Go
53.5%
TypeScript
25.9%
Vue
14.5%
JavaScript
3.7%
NSIS
1.2%
Other
1.2%