docs: 新增上线检查清单(当天照着走一遍的核对表),README 加链接
This commit is contained in:
1 parent
8039da384d
commit
a0a4824dda
2 files changed
+68
No files matched your search
@@ -35,6 +35,7 @@
|
|||||||
|
|
||||||
## 文档
|
## 文档
|
||||||
|
|
||||||
|
- [上线检查清单](./docs/上线检查清单.md):比赛当天照着走一遍的核对表(含交付物、目标机、首次启动、规则包导入、大屏、备份与回退)
|
||||||
- [部署指南](./docs/部署指南.md):运行环境、安装与首次启动、端口与配置、大屏接线、备份恢复、故障排查
|
- [部署指南](./docs/部署指南.md):运行环境、安装与首次启动、端口与配置、大屏接线、备份恢复、故障排查
|
||||||
- [使用手册](./docs/使用手册.md):角色权限、各功能页面的操作步骤、大屏端使用、常见操作问题
|
- [使用手册](./docs/使用手册.md):角色权限、各功能页面的操作步骤、大屏端使用、常见操作问题
|
||||||
- [常见问题(FAQ)](./docs/常见问题.md):账号、成绩与积分、大屏、数据备份、导出导入
|
- [常见问题(FAQ)](./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-备份与恢复)。
|
||||||
Reference in new issue
Block a user