AskaEth
53a0cb225c
用户点名的三件事（模板功能、删死代码、剩余缺口）这一批全部落地，另修掉两个刚暴露的导入缺陷：
**新增能力**
- 备份恢复：`POST /api/backup/restore`（admin）。先把校验做在拍快照之前（只读打开 + integrity_check +
关键表校验 + 异类库标志表互斥），再用 VACUUM INTO 拍「恢复前安全副本」，然后关连接、整文件替换、
触发优雅重启；`-wal` 还在时直接拒绝（宁可失败也不让旧库 WAL 套到新库上）；恢复后审计直写"恢复之后
还在的那份库"（不走通用 Auditor，否则记录只会落在被替换掉的旧文件上）。顺带修掉：裸服务端连续恢复
第二次会在拍副本处崩出一句看不懂的 500，现在回 503「上次恢复后尚未重启，请先重启服务端」。
- 安全副本保留策略：每类库保留最近 5 份，独立于 .db 的 20 份滚动清理。
- 图片管理：`DELETE /api/uploads/{name}`（被引用 409 并列出引用点）、`GET /api/uploads/orphans`、
`POST /api/uploads/orphans/delete`（只删列出的孤儿，宁漏勿误），全部 admin（与字体删除同档）；
`deploy/backup.bat` 补上 uploads/ 归档（logs 不归档：可再生的诊断且会无上限增长）。
- 已彻底删除单位的恢复：`POST /api/teams/{id}/restore`（与 hideTeam 同档）。幂等；恢复不会把「停用」
变成「启用」；真机确认恢复前后榜单逐字节一致、change_log 最大值不变（数据一行没动，不需要重算）。
界面加「显示已彻底删除的单位」（仅 admin）与恢复按钮；非 admin 的删除确认框里写明"本账号无法自行恢复"。
- 审计日志按 `action` 过滤（子串模糊，输入里的 %/_/\ 转义成字面量）。
- 删除死表 recent_projects（新增 system 迁移 0006，未动已应用的迁移）。
- points_override 不再"设了没效果"：写入侧 400 + 引擎侧守卫，提示改用「积分调整」。
- 联队份额空壳清理（UnionAttribution/UnionSplit/Entry.TeamShares/resolvedShares 等；TeamShare 类型保留，
因为 export/realtime/奖牌流水三处在生产路径上构造它）。
- 自定义大屏模板 M1：插值引擎（parseTemplate/renderTemplate），任何情况都不抛异常、未定义→空串+警告、
警告按 (code,path) 合并计数、无 eval/innerHTML，57 个新用例。
**两个真缺陷（前两个已随 0.1.6 出包）**
- 基础数据包导入「排序」列口径不一致：小项/组别留空保持原值，单位/大项留空被写成 0（plan 没从库里
现值起手）→ 四张表统一为「留空保持原值」。
- 同类第二处：布尔列「整列被删掉」被当成"取默认值"，会把库里所有停用的单位/大项静默改回启用 →
改为「缺列 = 不动」（写侧与解析侧都收口，补了"缺列保持/空格子=是/显式否=停用"三组对照用例）。
**删死代码**
- createEntry / updateEntry / deleteEntry / entryEventID / checkCategoryInEvent / getEntry /
normalizeEntryStatus / ExportBaseDataXLSX（全仓 grep 零引用）。⚠️ 随之记入文档：「组别必须属于该小项」
这道校验现在只由导入路径"按小项+组别名解析"天然保证，将来若新增从请求体接收 categoryId 的接口，
必须自己补校验（库层没有复合外键）。
**文档**
- devdocs 全面同步（01/02/03/04/05/06/07/09/11/12/13/README；含身份口径、延迟结算、大屏单栏新版式、
新增路由与设置键、R18/R19 风险）；docs 复核 + 第二轮（身份口径三个易写反的分支、图片删除、备份覆盖、
审计过滤、单位恢复、去掉硬编码版本号、上线检查清单 +5 项）；debug/使用说明 6 份逐份 diff 一致。
测试：服务端 13 包（连跑两遍）、前端 406 例、Console 28 例 + 18 文件语法检查 —— 全绿。
版本号 dev_0.1.6 → dev_0.1.7。
11 KiB
11 KiB
上线检查清单
1. 交付物
| 文件 | 用途 |
|---|---|
Scoreboard Console-<版本>-x64.exe |
NSIS 安装包（推荐），双击按向导装 |
Scoreboard Console-<版本>-x64.zip |
免安装包，解压即用 |
scoreboard.exe |
服务端本体（已内嵌前端页面） |
版本号以
dist\console\下的实际文件名为准（构建时从仓库根VERSION生成，不在这里写死）。 校验完整性：certutil -hashfile "Scoreboard Console-<版本>-x64.exe" SHA256（<版本>照dist\console\里的实际文件名填）
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） - 登录有效期按赛程设好：到「系统设置 → 登录有效期」把有效期设成覆盖本次比赛全部时段的时长（默认 24 小时、可调 1–720 小时，跨天比赛建议 72 小时），并核对页面顶部「当前会话将于 … 过期」；比赛期间操作员长时间不操作也不会掉线，但它不是「永不掉线」（见使用手册 14.4、常见问题 Q89）
- 收表口径已交代：提醒各单位报名名单里的号码布是系统认人的唯一标识、不能重号（重号行会被跳过）；证件号可选、但也不能与别人重号（见报名名单导入规范）
- 赛事项目确认 / 导入：到「导出 → 赛事项目包」核对赛事项目列表里带「当前」徽标的是本次要用的赛事；需要换赛事时先「导入 .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 全屏后它与自绘标题栏一起消失（版本号角标已移除，任何画面都不该出现）
- 显示器菜单可用：在服务管理窗口里点「打开服务端管理面板」，进「大屏控制 → 显示器」，能看到每块屏；副屏点「创建全屏窗口」能重新开出来（单屏 / 主显示器只能窗口化，属正常）
- 在线大屏与逐屏切页：同页右侧「在线大屏」列表能看到本机每块屏的在线实例（局域网设备也已在这一列表里，标记为「局域网浏览器」），每行显示当前所在页；用某一行自己的下拉 +「切到此页」能把那一块屏 / 那台设备单独切走，其余屏不受影响（离线实例的控件为灰色，属正常）
- 公告可用：推送一条测试公告 → 大屏全屏显示 → 到时退回原页且底栏公告栏仍常驻显示正文 → 点「清除公告」后底栏回到「暂无公告」
- 实时赛况配置正确：「大屏控制 → 实时赛况」卡片里模式与项目已按今天赛程选好（自动判定 / 人工指定），「当前生效」显示的就是此刻该显示的项目；大屏切到「实时赛况」页能看到该项目已发布成绩的实时排名（两个项目同时进行时应自动左右分栏）
- 分批发布演练：选一个分多场跑的项目，先只填一批成绩发布 → 大屏立即出现这一批的排名 → 补录下一批再发布 → 排名自动重算（未录的行不会被当成 0 分，也不挡发布）
- 报名项批量操作演练：在「成绩录入」勾选几行试一次批量退赛 → 批量恢复（确认框会逐条列出被跳过的 dq / dns 行及原因）；「批量移出报名」是物理删除、不可恢复，只演示确认框、不要在真实报名上执行（详见使用手册 4.8）
- 报名名单导出演练：「导出 → 结果导出 → 报名名单」按小项 / 组别 / 单位 / 批次筛一次并导出，核对 13 列与状态中文（正常参赛 / 已退赛 / 取消资格 / 未出场）与录入页一致
6. 数据与备份
- 确认数据目录
%LOCALAPPDATA%\ScoreboardConsole\data下的backups\里已出现system-auto-*.db与event-auto-*.db（默认每 5 分钟） - 确认数据目录下已生成
logs\operations\与logs\interceptions\（服务端日志，见部署指南第 10 节），并知道操作被拒时去interceptions\当天文件里搜原因与拦截点 - 开幕前手动点一次「立即备份」（「系统设置 → 备份 → 立即备份」）
- 把整个数据目录（不只是
backups\：event_projs\<当前项目名>\uploads\里还有会标、背景图、单位 logo 与上传的字体）拷一份到 U 盘 - 留一份成绩总表存档：到「导出 → 结果导出」导一份全部（单页）（
赛事成绩总表（单页）.xlsx，一个工作簿一张表，适合比对与筛选），需要归档打印再导一份「全部」（多 sheet） - 导出并留档一份基础数据包：「导出 → 基础数据 → 导出 xlsx」得到含单位 / 大项 / 小项 / 组别四张工作表的工作簿；它可按编码原样导回（存在就更新、绝不删除），赛前改乱基础数据时可以拿它对照 / 回灌
7. 现场流程演练（建议至少一次）
- 录入员登录 → 录入一条成绩 → 存草稿 → 发布 → 大屏刷新
- 撤销发布 → 修改 → 重新发布（历史记录里能看到链路）
- 导出核对：「结果导出」里「全部」与「全部（单页）」都能正常下载（后者应是一个工作簿、只有一张表）；「积分榜」页三个榜单的卡片头各有导出——单位总分榜「导出总明细」得到
单位积分总明细.xlsx、团体奖牌榜「导出奖牌明细」得到团体奖牌明细.xlsx、个人积分榜「导出个人明细」得到个人积分总明细.xlsx；展开某单位后还能点「导出该单位明细」得到单位积分明细.xlsx - 断网 → 大屏仍显示缓存数据 → 恢复后自动补增量
- 重启服务端 → Console 自动拉起
8. 出问题时的回退
| 故障 | 动作 |
|---|---|
| 服务端无响应 | 服务管理窗口「重启服务」 |
| 导入赛事包后看不到数据 | 到「导出 → 赛事项目包 → 赛事项目列表」把该项目「切换为当前赛事」（服务端会重启一次，页面恢复后自动刷新，一般不用重新登录），详见部署指南第 8.5 节 |
| 主机死机 | 备机启动同一份部署包，把用户数据目录（%LOCALAPPDATA%\ScoreboardConsole\，含数据、配置与规则）拷回去 |
| 数据库损坏 | 停机，用数据目录下 backups\ 的最新备份替换 event_projs\<项目名>\event.db（先删 -wal/-shm），详见部署指南第 8.3 节 |
| 大屏黑屏 / 窗口被误关 | 服务管理窗口「重新排布」；仍不行就到「大屏控制 → 显示器」点该块屏的「创建全屏窗口」；最后才用备用笔记本开同一地址 |
| 覆盖安装后数据/配置不见了 | 看「运行日志」里的 数据目录：、用户数据目录： 与迁移警告，按部署指南第 9.9 节处理 |
完整恢复步骤见 部署指南 · 备份与恢复。