# Scoreboard · 赛事积分榜系统

一套局域网内部署的赛事成绩与积分系统：**一个服务端 + 两个界面**，后台一改数据，前台大屏实时跟着变。

| 界面 | 地址 | 用途 |
| --- | --- | --- |
| 实时积分大屏 | `/display` | 只读、无人值守；成绩发布后 1 秒内更新 |
| 管理面板 | `/admin` | 录入、发布成绩，控制大屏；未登录可只读查看全部赛事数据 |

## 功能概览

- **四个榜**：总积分榜、团体奖牌榜、个人积分奖牌榜、分项成绩表
- **录入即上屏**：成绩录入 → 发布 → 大屏即时更新
- **可追溯、可撤销**：草稿不上屏；发布后纠错走「撤销发布 → 改 → 重新发布」，全程留痕
- **变更历史**：仿 Git 图谱，一眼看清成绩是怎么变成现在这样的
- **现场公开**：积分明细可下钻，争议时一键推送到大屏
- **规则可配置**：积分规则以规则包（YAML）描述，可导入导出、跨赛事复用
- **赛事独立存档**：每个赛事一个独立项目目录，可整包导出/导入
- **结果导出**：Excel 总表与分项可单独导出

## 快速开始

1. 解压部署包
2. 双击 `scoreboard.exe`（Linux 下执行 `./scoreboard`）
3. 浏览器打开终端提示的地址

```
大屏      http://<主机IP>:8080/display
管理面板   http://<主机IP>:8080/admin
```

> 完全离线运行，不依赖外网，不需要安装任何运行时。

## 文档

- 使用说明、操作手册：随正式版发布补充
- 规则包格式：见 [rules/README.md](./rules/README.md)

## 许可证

MIT