Scoreboard/docs/上线检查清单.md

上线检查清单

比赛当天照着走一遍即可。细节见 部署指南 与 使用手册。

1. 交付物

文件	用途
Scoreboard Console-0.1.0-x64.exe	NSIS 安装包（推荐），双击按向导装
Scoreboard Console-0.1.0-x64.zip	免安装包，解压即用
scoreboard.exe	服务端本体（已内嵌前端页面）

校验完整性：certutil -hashfile "Scoreboard Console-0.1.0-x64.exe" SHA256

2. 目标机（服务端主机）

• Windows 10/11 x64，接市电（建议接 UPS）
• 端口 19540 未被占用：netstat -ano | findstr 19540
• 数据目录可写：默认 <安装目录>\data\，需要放行杀毒/防火墙
• 大屏通过 HDMI 接在同一台机器上（系统显示模式设为「扩展」）

3. 首次启动

• 双击 Scoreboard Console.exe，启动管理窗口出现
• 服务端状态变为「运行中 · 就绪」
• 打开管理面板（窗口内「打开服务端管理面板」按钮），用管理员账号登录
• 管理员初始密码在 logs\console.log 里搜 password=；首次登录会要求改密

4. 赛事配置（管理员）

• 「系统设置 → 赛事信息」填名称、副标题、主办方、会标、主题色
• 「大屏展示」选背景图、标题、轮播间隔
• 导入规则包：rules\2026-驭电利刃杯军事运动会.yaml（安装目录下的 rules\ 里） —— 服务端不会自动加载规则包，必须导入一次
• 检查计分模板：个人前六名 10/8/6/3/2/1、团体 15/10/8/4/2/1、最后一名不得分
• 「只排名不计分」的项目（飞行人员战斗体能）导入后应显示为不计分

5. 大屏

• 接好扩展屏后，服务管理窗口点「重新排布」
• 确认大屏锁定在「积分榜」页面；需要轮播就在后台开启
• 鼠标移到大屏上应看不到操作按钮；大屏窗口已开防熄屏
• 只有一块屏时是窗口化模式，按 F11 可切全屏（用于单屏测试）

6. 数据与备份

• 确认 data\backups\ 里已出现 system-auto-*.db 与 event-auto-*.db（默认每 5 分钟）
• 开幕前手动点一次「立即备份」
• 记下备份目录位置，必要时整个目录拷到 U 盘

7. 现场流程演练（建议至少一次）

• 录入员登录 → 录入一条成绩 → 存草稿 → 发布 → 大屏刷新
• 撤销发布 → 修改 → 重新发布（历史记录里能看到链路）
• 断网 → 大屏仍显示缓存数据 → 恢复后自动补增量
• 重启服务端 → Console 自动拉起

8. 出问题时的回退

故障	动作
服务端无响应	服务管理窗口「重启服务」
主机死机	备机启动同一份部署包，拷回 data\ 最近备份
数据库损坏	停机，用 data\backups\ 最新备份替换 data\event_projs\<项目名>\event.db（先删 -wal/-shm）
大屏黑屏	服务管理窗口「重新排布」；仍不行就用备用笔记本开同一地址

完整恢复步骤见 部署指南 · 备份与恢复。