docs: 用户文档补齐「个人+团体」等新功能,修正切换赛事与账号存储位置的说法

按 407abec 之后落地的功能,对照代码逐条更新四份用户文档与 README:

- 使用手册:补「个人+团体」是什么与完整配置链路、平均值口径两种分母、
  榜单口径(全局)折算系数、公告(全屏→底栏常驻)、报名导入两个页签、
  单位 logo 显示位置、17.5 调试标识;修正「账号存在各个赛事库里」的错误说法
  (账号与会话在数据目录的 system.db),在线看板改为指向服务管理窗口的实例卡片
- 部署指南:新增 7.5 显示器菜单 / 7.6 公告 / 7.7 调试标识与单位 logo;
  重写 8.5 赛事项目包(导入 ≠ 切换、包内四类内容、不能覆盖运行中的项目),
  并把 -project 启动参数明确标为「不要用来切赛事」
- 上线检查清单:补当前赛事、显示器菜单、单位 logo、公告四项现场核对,
  修正「切换后登录状态失效」
- 常见问题:重编号 Q1–Q48,新增个人+团体算分、平均值口径、只报单位、
  折算系数、公告底栏、单位 logo、调试标识 8 条;切换赛事与数据迁移按实测重写
- README:功能概览与文档索引同步
This commit is contained in:
AskaEth committed 2026-09-10 15:16:17 +08:00
1 parent 6bd7bd1627
commit 9c6d0bd3b3
5 files changed
+288 -94

No files matched your search

+13 -6
View File
@@ -18,6 +18,7 @@
- [ ] 端口 **19540** 未被占用:`netstat -ano | findstr 19540`
- [ ] 数据/配置目录可写:默认 `%LOCALAPPDATA%\ScoreboardConsole\`(数据在 `data\`,配置与规则是 `console\config.json`、`config.yaml`、`rules\`;都在安装目录之外,升级/卸载都不会删),需要放行杀毒/防火墙
- [ ] 大屏通过 HDMI 接在**同一台机器**上(系统显示模式设为「扩展」)
- [ ] 显示器数量确认:只接一块屏时大屏只能窗口化(按 F11 可切全屏);要每屏一个 kiosk 全屏窗口就得接第二块屏(见部署指南 7.3、7.5)
- [ ] **安装目录不要选 `C:\Program Files`**(那里普通用户没写权限,日志会写不进去);装到 D 盘等普通目录即可,向导里可以改路径
## 3. 首次启动
@@ -31,12 +32,14 @@
## 4. 赛事配置(管理员)
- [ ] 「系统设置 → 赛事信息」填名称、副标题、主办方、会标、主题色
- [ ] 「大屏展示」选背景图、标题、轮播间隔
- [ ] **导入规则包**:`%LOCALAPPDATA%\ScoreboardConsole\rules\2026-驭电利刃杯军事运动会.yaml`(规则目录在用户数据目录里,见部署指南 3.5)
- [ ] 「系统设置 → 赛事信息」的**基本信息**:填名称、副标题、主办方,上传**赛事会标**
- [ ] 同页的**大屏配置**:上传大屏会标、选大屏背景图,填大屏标题 / 副标题、轮播间隔与主题色(上传的图片随赛事项目包一起导出/导入)
- [ ] **赛事项目确认 / 导入**:到「导出 → 赛事项目包」核对**赛事项目列表**里带「当前」徽标的是本次要用的赛事;需要换赛事时先「导入 .zip」,再点「切换为当前赛事」(服务端会重启一次,页面显示「正在重启服务端…」,恢复后自动刷新)。账号与会话在数据目录的 `system.db` 里,**不受切换影响**,一般不用重新登录。这一步做完再往下走,否则后面看到的是别的赛事的数据
- [ ] **导入规则包**:`%LOCALAPPDATA%\ScoreboardConsole\rules\2026-驭电利刃杯军事运动会.yaml`,走「导出 → 规则包 → 选择 YAML → 预览差异 → 确认导入并全量重算」(规则目录在用户数据目录里,见部署指南 3.5)
—— 服务端不会自动加载规则包,必须导入一次
- [ ] 检查计分模板:个人前六名 `10/8/6/3/2/1`、团体 `15/10/8/4/2/1`、最后一名不得分
- [ ] 「只排名不计分」的项目(飞行人员战斗体能)导入后应显示为不计分
- [ ] 「基础数据 → 参赛单位」里各单位的 logo 都已上传(会显示在总积分榜、团体奖牌榜、分项成绩表与个人积分榜上)
## 5. 大屏
@@ -44,12 +47,15 @@
- [ ] 确认大屏锁定在「积分榜」页面;需要轮播就在后台开启
- [ ] 鼠标移到大屏上应看不到操作按钮;大屏窗口已开防熄屏
- [ ] 只有一块屏时是窗口化模式,按 **F11** 可切全屏(用于单屏测试)
- [ ] **调试标识已隐藏**:多屏 kiosk 全屏画面上不该出现「实例 … · 屏 …」与版本号角标;窗口化窗口(单屏)里显示这两个属正常,按 F11 全屏后「实例 · 屏」隐藏、版本号角标仍在
- [ ] **显示器菜单可用**:在服务管理窗口里点「打开服务端管理面板」,进「大屏控制 → 显示器」,能看到每块屏;副屏点「创建全屏窗口」能重新开出来(单屏 / 主显示器只能窗口化,属正常)
- [ ] **公告可用**:推送一条测试公告 → 大屏全屏显示 → 到时退回原页且**底栏公告栏仍常驻显示正文** → 点「清除公告」后底栏回到「暂无公告」
## 6. 数据与备份
- [ ] 确认数据目录 `%LOCALAPPDATA%\ScoreboardConsole\data` 下的 `backups\` 里已出现 `system-auto-*.db` 与 `event-auto-*.db`(默认每 5 分钟)
- [ ] 开幕前手动点一次「立即备份」
- [ ] 把整个数据目录(不只是 `backups\`:`event_projs\<项目名>\uploads\` 里还有上传的图片)拷一份到 U 盘
- [ ] 开幕前手动点一次「立即备份」(「系统设置 → 备份 → 立即备份」)
- [ ] 把整个数据目录(不只是 `backups\`:`event_projs\<当前项目名>\uploads\` 里还有会标、背景图与单位 logo)拷一份到 U 盘
## 7. 现场流程演练(建议至少一次)
@@ -63,9 +69,10 @@
| 故障 | 动作 |
| --- | --- |
| 服务端无响应 | 服务管理窗口「重启服务」 |
| 导入赛事包后看不到数据 | 到「导出 → 赛事项目包 → 赛事项目列表」把该项目「切换为当前赛事」(服务端会重启一次,页面恢复后自动刷新,一般不用重新登录),详见部署指南第 8.5 节 |
| 主机死机 | 备机启动同一份部署包,把用户数据目录(`%LOCALAPPDATA%\ScoreboardConsole\`,含数据、配置与规则)拷回去 |
| 数据库损坏 | 停机,用数据目录下 `backups\` 的最新备份替换 `event_projs\<项目名>\event.db`(先删 `-wal`/`-shm`),详见部署指南第 8.3 节 |
| 大屏黑屏 | 服务管理窗口「重新排布」;仍不行就用备用笔记本开同一地址 |
| 大屏黑屏 / 窗口被误关 | 服务管理窗口「重新排布」;仍不行就到「大屏控制 → 显示器」点该块屏的「创建全屏窗口」;最后才用备用笔记本开同一地址 |
| 覆盖安装后数据/配置不见了 | 看「运行日志」里的 `数据目录:`、`用户数据目录:` 与迁移警告,按部署指南第 9.9 节处理 |
> 完整恢复步骤见 [部署指南 · 备份与恢复](./部署指南.md#8-备份与恢复)。