From a0a4824dda28c1433e041cfa137458215061254c Mon Sep 17 00:00:00 2001 From: AskaEth Date: Wed, 9 Sep 2026 22:47:14 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=E4=B8=8A=E7=BA=BF?= =?UTF-8?q?=E6=A3=80=E6=9F=A5=E6=B8=85=E5=8D=95=EF=BC=88=E5=BD=93=E5=A4=A9?= =?UTF-8?q?=E7=85=A7=E7=9D=80=E8=B5=B0=E4=B8=80=E9=81=8D=E7=9A=84=E6=A0=B8?= =?UTF-8?q?=E5=AF=B9=E8=A1=A8=EF=BC=89=EF=BC=8CREADME=20=E5=8A=A0=E9=93=BE?= =?UTF-8?q?=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 1 + docs/上线检查清单.md | 67 ++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 68 insertions(+) create mode 100644 docs/上线检查清单.md diff --git a/README.md b/README.md index 64fe59c..0dc4885 100644 --- a/README.md +++ b/README.md @@ -35,6 +35,7 @@ ## 文档 +- [上线检查清单](./docs/上线检查清单.md)：比赛当天照着走一遍的核对表（含交付物、目标机、首次启动、规则包导入、大屏、备份与回退） - [部署指南](./docs/部署指南.md)：运行环境、安装与首次启动、端口与配置、大屏接线、备份恢复、故障排查 - [使用手册](./docs/使用手册.md)：角色权限、各功能页面的操作步骤、大屏端使用、常见操作问题 - [常见问题（FAQ）](./docs/常见问题.md)：账号、成绩与积分、大屏、数据备份、导出导入 diff --git a/docs/上线检查清单.md b/docs/上线检查清单.md new file mode 100644 index 0000000..e60cbd0 --- /dev/null +++ b/docs/上线检查清单.md @@ -0,0 +1,67 @@ +# 上线检查清单 + +> 比赛当天照着走一遍即可。细节见 [部署指南](./部署指南.md) 与 [使用手册](./使用手册.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`） | +| 大屏黑屏 | 服务管理窗口「重新排布」；仍不行就用备用笔记本开同一地址 | + +> 完整恢复步骤见 [部署指南 · 备份与恢复](./部署指南.md#8-备份与恢复)。