AskaEth
782a38f82f
## 大屏控制（用户：管理面板只能看到本机显示器，看不到局域网设备；也不能给某块屏单独切页） - 服务端：`POST /api/display/command` 新增可选 `targets []string` —— 空 = 广播（公告语义不变）， 非空 = 只发给点名的实例并返回命中数；命中 0 个返回 404 +「目标大屏已离线，请刷新在线列表」 （不落审计、公告也不落库）。`DisplaySender` 签名随之扩展，新增 `Hub.SendCommandToInstances`（与按房间的 SendCommand 并存）。 - 服务端：WS `hello` 新增可选 `screen`，`realtime.Instance` 新增 `Screen`（不带 omitempty， 局域网浏览器恒为空串），这样管理端能把「本机显示器」与「在线实例」精确对上。 - 管理端「大屏控制」：写死的「在线看板」占位换成真实列表（5 秒轮询、页面隐藏停表）， 列出实例 id / 在线离线 / 落后 / 屏号或「局域网浏览器」/ 当前页 / 来源 / 心跳； 每行可单独切页；本机显示器卡片补「当前页」与逐屏切页；离线时控件置灰并说明原因。 页面下拉改为共用大屏那份页名清单（管理端两处标签随之变为「个人积分奖牌榜」「分项成绩」）。 ## 导出（用户：保留多页工作簿的同时，再要一种全平铺单页；积分榜明细也要能导出） - 新增 `GET /api/export/all-flat.xlsx` → `赛事成绩总表（单页）.xlsx`：一个工作簿一张表， 列 = 大项/小项/组别/名次/号码/单位/运动员-队/成绩/积分/状态/备注；前三列取 `EventSheet` 的结构化字段（不解析标题），后 8 列就是 `eventColumns` 本身（append 拼出， 两处不可能漂移）。**既有「全部」（all.xlsx，多 sheet）一字未动。** - 新增 `GET /api/export/teams.xlsx` → `单位积分总明细.xlsx`：一张带「单位」列的总表 + 每个有明细行的单位一张分表；**无明细行的单位不出分表**（空表没信息量，且会把假删除的 隐藏单位名字重新印进导出件）；已隐藏但有流水的单位照常出表（它在榜单上）。 - 积分榜页：页头「导出总明细」、单位明细面板「导出该单位明细」；导出页新增「全部（单页）」。 测试：服务端 12 包全绿 / 347 个测试函数；前端 vue-tsc 通过、184 例全过；Console 18 文件。 docs/ 与 devdocs/ 同步（含新增 Q65–Q70 与两轮进度记录）。
8.3 KiB
8.3 KiB
上线检查清单
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 - 数据/配置目录可写：默认
%LOCALAPPDATA%\ScoreboardConsole\（数据在data\，配置与规则是console\config.json、config.yaml、rules\；都在安装目录之外，升级/卸载都不会删），需要放行杀毒/防火墙 - 大屏通过 HDMI 接在同一台机器上（系统显示模式设为「扩展」）
- 显示器数量确认：只接一块屏时大屏只能窗口化（按 F11 可切全屏）；要每屏一个 kiosk 全屏窗口就得接第二块屏（见部署指南 7.3、7.5）
- 安装目录不要选
C:\Program Files（那里普通用户没写权限，日志会写不进去）；装到 D 盘等普通目录即可，向导里可以改路径
3. 首次启动
- 双击
Scoreboard_Console.exe，启动管理窗口出现 - 服务端状态变为「运行中 · 就绪」
- 「运行日志」里
数据目录：指向%LOCALAPPDATA%\ScoreboardConsole\data（不是安装目录），且没有「都有数据 / 迁移失败」的警告 - 「运行日志」里
用户数据目录：指向%LOCALAPPDATA%\ScoreboardConsole，且没有「准备 … 失败」的警告（配置与规则也在那儿，见部署指南 3.5） - 打开管理面板（窗口内「打开服务端管理面板」按钮），用管理员账号登录
- 管理员初始密码在
logs\console.log里搜INITIAL ADMIN CREATED，密码就在该行上方；也可以直接打开 Console 的「运行日志」面板往上翻。首次登录会要求改密
4. 赛事配置（管理员）
- 「系统设置 → 赛事信息」的基本信息：填名称、副标题、主办方，上传赛事会标
- 同页的大屏配置：上传大屏会标、选大屏背景图，填大屏标题 / 副标题、轮播间隔与主题色（上传的图片随赛事项目包一起导出/导入）
- 同页的字体：确认标题字体与正文字体已选好（默认、四款内置字体，或自己上传的字体）；选完点「保存」，并核对大屏上标题与正文显示正常。上传的字体存在赛事项目的
uploads\fonts\里，导出赛事项目包会一并带走、导入后不用重新上传（见使用手册 14.3、部署指南 8.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 都已上传（会显示在总积分榜、团体奖牌榜、分项成绩表与个人积分榜上）
- 同页核对单位名单齐全、没有误删：被「彻底删除」的单位不会出现在这个列表里（它的报名、成绩与积分仍在库里，积分榜照常显示它）；发现少了就用它的编码导入一次报名表，它会重新出现（详见使用手册 10.1、常见问题 Q61–Q64）
5. 大屏
- 接好扩展屏后，服务管理窗口点「重新排布」
- 确认大屏锁定在「积分榜」页面；需要轮播就在后台开启
- 鼠标移到大屏上应看不到操作按钮；大屏窗口已开防熄屏
- 只有一块屏时是窗口化模式，按 F11 可切全屏（用于单屏测试）
- 调试标识已隐藏：多屏 kiosk 全屏画面上不该出现「实例 … · 屏 …」；窗口化窗口（单屏）里显示这一行属正常，按 F11 全屏后它与自绘标题栏一起消失（版本号角标已移除，任何画面都不该出现）
- 显示器菜单可用：在服务管理窗口里点「打开服务端管理面板」，进「大屏控制 → 显示器」，能看到每块屏；副屏点「创建全屏窗口」能重新开出来（单屏 / 主显示器只能窗口化，属正常）
- 在线大屏与逐屏切页：同页右侧「在线大屏」列表能看到本机每块屏的在线实例（局域网设备也已在这一列表里，标记为「局域网浏览器」），每行显示当前所在页；用某一行自己的下拉 +「切到此页」能把那一块屏 / 那台设备单独切走，其余屏不受影响（离线实例的控件为灰色，属正常）
- 公告可用：推送一条测试公告 → 大屏全屏显示 → 到时退回原页且底栏公告栏仍常驻显示正文 → 点「清除公告」后底栏回到「暂无公告」
6. 数据与备份
- 确认数据目录
%LOCALAPPDATA%\ScoreboardConsole\data下的backups\里已出现system-auto-*.db与event-auto-*.db（默认每 5 分钟） - 开幕前手动点一次「立即备份」（「系统设置 → 备份 → 立即备份」）
- 把整个数据目录（不只是
backups\：event_projs\<当前项目名>\uploads\里还有会标、背景图、单位 logo 与上传的字体）拷一份到 U 盘 - 留一份成绩总表存档：到「导出 → 结果导出」导一份全部（单页）（
赛事成绩总表（单页）.xlsx，一个工作簿一张表，适合比对与筛选），需要归档打印再导一份「全部」（多 sheet）
7. 现场流程演练（建议至少一次）
- 录入员登录 → 录入一条成绩 → 存草稿 → 发布 → 大屏刷新
- 撤销发布 → 修改 → 重新发布（历史记录里能看到链路）
- 导出核对：「结果导出」里「全部」与「全部（单页）」都能正常下载（后者应是一个工作簿、只有一张表）；「积分榜」页点「导出总明细」得到
单位积分总明细.xlsx，展开某单位后点「导出该单位明细」得到单位积分明细.xlsx - 断网 → 大屏仍显示缓存数据 → 恢复后自动补增量
- 重启服务端 → Console 自动拉起
8. 出问题时的回退
| 故障 | 动作 |
|---|---|
| 服务端无响应 | 服务管理窗口「重启服务」 |
| 导入赛事包后看不到数据 | 到「导出 → 赛事项目包 → 赛事项目列表」把该项目「切换为当前赛事」（服务端会重启一次，页面恢复后自动刷新，一般不用重新登录），详见部署指南第 8.5 节 |
| 主机死机 | 备机启动同一份部署包，把用户数据目录（%LOCALAPPDATA%\ScoreboardConsole\，含数据、配置与规则）拷回去 |
| 数据库损坏 | 停机，用数据目录下 backups\ 的最新备份替换 event_projs\<项目名>\event.db（先删 -wal/-shm），详见部署指南第 8.3 节 |
| 大屏黑屏 / 窗口被误关 | 服务管理窗口「重新排布」；仍不行就到「大屏控制 → 显示器」点该块屏的「创建全屏窗口」；最后才用备用笔记本开同一地址 |
| 覆盖安装后数据/配置不见了 | 看「运行日志」里的 数据目录：、用户数据目录： 与迁移警告，按部署指南第 9.9 节处理 |
完整恢复步骤见 部署指南 · 备份与恢复。