Files
Scoreboard/docs/上线检查清单.md
T
AskaEth 27bddefaad fix: 上线前快修(大屏自愈 / 奖牌口径 / 聚合作废 / 密码可发现性)
- P0 慢客户端关闭码 1008 → 4000:前端把所有 1008 当「登录失效」并永久停止重连,
  大屏被踢后再也不自愈(服务端 markSlow 改用自定义码,前端逻辑不动)
- P1 REST 与 WS 的奖牌榜补 events.scored = 1 过滤,与导出成绩册口径一致
  (否则「只排名不计分」项目只要挂着通道就会在大屏凭空出奖牌)
- P1 聚合流水作废去掉 source_id 子查询:改通道会重建通道 id,旧聚合流水
  永远匹配不上 → 再插一份 → 分数翻倍
- P1 审核页/历史页的折算系数兜底由 ?? 1 改为 >0 ? : 1:/ws 快照对非 admin
  会把 individualToTeamWeight 置 0,recorder 看到的个人折算分全是 0
- P2 删掉 signature.local.txt 后清理残留的 signature.build.txt,避免继续注入旧署名
- 初始管理员密码:banner 加纯 ASCII 锚 INITIAL ADMIN CREATED,文档改为搜它
  (原来教的 findstr "password=" 已经失效,且中文 findstr 本身不可靠)

自检:服务端 12 包全绿;前端 vue-tsc + build 通过、node --test 24/24;console 语法通过。
2026-09-09 23:13:20 +08:00

3.5 KiB
Raw Blame History

上线检查清单

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

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 接在同一台机器上(系统显示模式设为「扩展」)
  • 安装目录不要选 C:\Program Files(那里普通用户没写权限,数据库会写不进去);装到 D 盘等普通目录即可,向导里可以改路径

3. 首次启动

  • 双击 Scoreboard Console.exe,启动管理窗口出现
  • 服务端状态变为「运行中 · 就绪」
  • 打开管理面板(窗口内「打开服务端管理面板」按钮),用管理员账号登录
  • 管理员初始密码在 logs\console.log 里搜 INITIAL ADMIN CREATED,密码就在该行上方;也可以直接打开 Console 的「运行日志」面板往上翻。首次登录会要求改密

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)
大屏黑屏 服务管理窗口「重新排布」;仍不行就用备用笔记本开同一地址

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