AskaEth
5ae49b001c
与运动员的真物理删除是**两套相反口径**，有意如此（两个按钮同名，代码与
文档里都做了显著区分）：
- 运动员 `?purge=1`：真删人员+报名+成绩+流水并重算积分（上一版 `9d4ee09`）
- 参赛单位 `?purge=1`：只置 `teams.deleted_at` + `active = 0`，让单位从列表里
消失；报名、成绩、积分流水、人工调整、纪录、名下运动员全部原样，
**不触发重算、积分榜不变**（单位下挂着几十号人，真删代价太大）
实现：
- 迁移 0018 `ALTER TABLE teams ADD COLUMN deleted_at TEXT`
- `listTeams` 默认排除已隐藏单位；`?includeDeleted=1` 仅 admin；
`GET /api/teams/{id}` 对已隐藏单位：admin 200 / 非 admin 404
- 审计 `team.purge`（detail 标明是隐藏）；成功走 `writeVoid`（无统计对象）
- 报名导入按 `team_code` 命中已隐藏单位时复活（清 deleted_at、置 active=1）
- 故意不过滤的地方都加了注释：榜单补单位名、写路径与审计、导入按 code 查、
赛事包导出、大屏快照、按 team_id JOIN 取历史单位名——过滤会让历史成绩的
单位名变空白或让包的引用悬挂
管理端「参赛单位」行加「彻底删除」按钮 + 危险确认框（如实写明"从列表移除、
数据不受影响、积分榜不会变化"），失败原文展示、404 不降级。
顺带修一处界面文案与行为不符：单位页原写「停用后新报名不再可选该单位」，
但报名选择器其实仍会列出已停用单位供手动勾选（只有「全选」跳过它们），
已按真实行为改写（两处）。
测试：服务端 12 包全绿（新增 team_purge_test.go 与 0018 迁移用例）；
前端 172 例全过（新增 team-purge-api.test.ts 6 例）。docs/ 与 devdocs/ 同步。
55 lines
4.2 KiB
Markdown
55 lines
4.2 KiB
Markdown
# Scoreboard · 赛事积分榜系统
|
||
|
||
一套局域网内部署的赛事成绩与积分系统：**一个服务端 + 两个界面**，后台一改数据，前台大屏实时跟着变。
|
||
|
||
| 界面 | 地址 | 用途 |
|
||
| --- | --- | --- |
|
||
| 实时积分大屏 | `/display` | 只读、无人值守；成绩发布后 1 秒内更新 |
|
||
| 管理面板 | `/admin` | 录入、发布成绩，控制大屏；未登录可只读查看全部赛事数据 |
|
||
|
||
## 功能概览
|
||
|
||
- **四个榜**：总积分榜、团体奖牌榜、个人积分奖牌榜、分项成绩表
|
||
- **录入即上屏**：成绩录入 → 发布 → 大屏即时更新
|
||
- **可追溯、可撤销**：草稿不上屏；发布后纠错走「撤销发布 → 改 → 重新发布」，全程留痕
|
||
- **变更历史**：仿 Git 图谱，一眼看清成绩是怎么变成现在这样的
|
||
- **现场公开**：积分明细可下钻，争议时一键推送到大屏
|
||
- **全屏公告**：推送后先全屏显示（5–120 秒），随即常驻大屏底部公告栏，直到替换或清除
|
||
- **小项类型齐全**：个人 / 团体 / 对抗比赛 / **个人+团体**（同一个项目同时按个人与团体通道记分）
|
||
- **多显示器**：支持多屏各锁一页（kiosk 全屏），也能在管理端为指定显示器单独开窗或收窗
|
||
- **规则可配置**：积分规则以规则包（YAML）描述，可导入导出、跨赛事复用
|
||
- **运动员名册**：启用 / 停用 / **彻底删除**三档——「停用」保留全部历史数据、随时可启用；「彻底删除」把人员档案连同他名下的报名、成绩与积分流水一起删掉且不可恢复，并自动按新排序重算受影响小项的排名与积分（大屏同步更新）
|
||
- **参赛单位名册**：启用 / 停用 / **彻底删除**三档——「停用」保留全部历史数据、随时可启用；「彻底删除」是**假删除**，只把单位从列表里移除（界面上没有恢复入口），它的报名、成绩、积分流水与名下运动员全部保留，**积分榜不会变化**；报名表里再次用到该单位编码会让它自动恢复
|
||
- **赛事独立存档**：每个赛事一个独立项目目录，整包可导出/导入（含会标、背景图、单位 logo 与上传的字体），并可在管理端页内一键切换当前赛事
|
||
- **结果导出**：Excel 总表、全部分项、分项成绩表、单位积分明细可分别导出
|
||
- **单位 logo**：积分榜、奖牌榜、分项成绩表与个人榜都会显示参赛单位 logo
|
||
- **大屏字体可配**：标题字体与正文字体可在「系统设置 → 赛事信息 → 字体」里从四款内置字体中选，或上传自己的字体（ttf / otf / woff / woff2，单个不超过 20 MiB）；只作用于大屏，加载失败自动回落默认字体，字体文件随赛事项目包一起导出/导入
|
||
|
||
## 快速开始
|
||
|
||
1. 解压部署包
|
||
2. 双击 `Scoreboard_Console.exe`（现场推荐：守护服务端、把大屏投到扩展屏、防熄屏、开机自启）
|
||
3. 浏览器打开终端提示的地址
|
||
|
||
```
|
||
大屏 http://<主机IP>:19540/display
|
||
管理面板 http://<主机IP>:19540/admin
|
||
```
|
||
|
||
> 也可以直接双击 `scoreboard.exe`（Linux 下执行 `./scoreboard`）只跑服务端，大屏投放与进程守护需自行接管。
|
||
>
|
||
> 完全离线运行，不依赖外网，不需要安装任何运行时。
|
||
|
||
## 文档
|
||
|
||
- [上线检查清单](./docs/上线检查清单.md)：比赛当天照着走一遍的核对表（含交付物、目标机、首次启动、赛事项目包与规则包导入、大屏与公告、备份与回退）
|
||
- [部署指南](./docs/部署指南.md)：运行环境、安装与首次启动、端口与配置、大屏接线、赛事项目包导入/切换、备份恢复、故障排查
|
||
- [使用手册](./docs/使用手册.md)：角色权限、各功能页面的操作步骤、大屏端使用、常见操作问题
|
||
- [报名名单导入规范](./docs/报名名单导入规范.md)：报名表该用什么格式、11 列逐列怎么填、个人/团体/「个人+团体」三种项目的填法、常见报错对照（可直接发给各单位填表人）
|
||
- [常见问题（FAQ）](./docs/常见问题.md)：账号、成绩与积分、大屏、数据备份、导出导入
|
||
- 规则包格式：见 [rules/README.md](./rules/README.md)
|
||
|
||
## 许可证
|
||
|
||
MIT
|