AskaEth
6483acf9ad
人员与报名：
- 人员唯一标识改为「证件号 或 号码布」二选一（0013/0014 迁移 + 导入匹配/回填/冲突）
- 人员新增「年龄」（0015 迁移）：表单/列表/导入模板表头 11 列；冲突比较只在两边
都有值且不同时才算差异，旧数据不误报
- 冲突决策键改为「证件号优先 → 号码布」（前端原先只用 idCard，号码布行会互相覆盖）
- 报名选择器支持无证件号但有号码布的运动员
大屏与 Console：
- 大屏控制新增「显示器」菜单：可给指定显示器重建全屏窗口；单屏/主显示器强制窗口化，
限制在 Console 侧判定，不信任页面传参
- Console 服务管理窗口改左右两栏，运行日志独占右栏满高；窗口默认尺寸 1280×860
- 大屏右上角时钟精确到秒（同时把刷新间隔 15s 改为 1s）
图片与配置：
- 新增图片上传 POST /api/uploads（recorder+，png/jpg/webp/gif，≤5MiB）与匿名静态
访问 GET /uploads/{name}（防目录穿越）；文件落赛事项目目录 uploads/，随赛事包
一起导出/导入
- 「赛事信息」新增赛事会标 / 大屏会标 / 大屏背景图三个上传项
- 参赛单位 logo 输入框右侧加上传按钮
关于页与构建：
- 构建时间打通：version.BuildTime + /api/system/about 返回 + build.bat 注入
（用 PowerShell 取时间戳，避免本地化 %DATE% 的非 ASCII 星期）
安装包：
- 主程序改名 Scoreboard_Console.exe（win.executableName；productName/显示名不变）
- 记住上次安装目录：自定义 NSIS 宏优先沿用自存路径（卸载不清除），并在 customInit
里补写回 electron-builder 的键，避免安装模式页把 $INSTDIR 打回默认
自检：服务端 12 包全绿；前端 vue-tsc + build 通过、node --test 58/58；console 12 文件通过。
69 lines
3.5 KiB
Markdown
69 lines
3.5 KiB
Markdown
# 上线检查清单
|
||
|
||
> 比赛当天照着走一遍即可。细节见 [部署指南](./部署指南.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 接在**同一台机器**上（系统显示模式设为「扩展」）
|
||
- [ ] **安装目录不要选 `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`） |
|
||
| 大屏黑屏 | 服务管理窗口「重新排布」；仍不行就用备用笔记本开同一地址 |
|
||
|
||
> 完整恢复步骤见 [部署指南 · 备份与恢复](./部署指南.md#8-备份与恢复)。
|