fix: P0 计分根因 + 奖牌结算/奖牌通道 + 身份口径改回证件号 + 19 条 P1（dev_0.1.8）

## P0：双通道项目重复发布跳分（45→85→收敛）
results.rank 一列同时充当「个人名次输出」「手工名次输入」「榜单数据源」，
团体手工通道把个人名次当团体名次又按团体表发一遍分。
- 新增 channel_ranks（每个计分通道各自持久化名次，发布时全量重建）
  与 channel_manual_ranks（按单位录入的团体手工名次，故意不挂通道外键，
  避免规则包重导时级联删掉录入数据）
- results.rank 语义收窄为「只表示个人名次」，只由 scope=athlete 通道写回；
  团体手工名次的来源改为 TeamRanks 优先、团体报名项兜底，
  个人报名项的名次绝不进团体通道
- writeLedgerTx 内重建 channel_ranks；buildRanked / export.loadRanked /
  realtime.loadRanked 三份同源 SQL 一起改读新表
- 回归：发布两次流水与名次逐字节一致（domain + httpapi 各一条，含变异验证）

## 奖牌结算开关与奖牌通道（P1(5)，新功能）
- events.award_medals + 通道 count_to_medals / count_to_team_medals
  （迁移默认 1，升级不改变既有榜单）
- 单位榜入选 = 小项结算奖牌 && 通道发奖牌 && 前三名 &&（团体项目 || 个人奖牌并入单位）
- 个人榜只取个人通道；金牌榜与积分榜同源同数据、按通道过滤独立计算
- 前端：小项「该项启用奖牌结算」、通道「发奖牌/个人奖牌并入单位金牌榜」、
  录入页新增「团体名次」区块（含新接口 GET/PUT .../team-ranks）

## 身份口径改回证件号（P1(15)，推翻第三十六轮）
- 匹配顺序恢复 证件号 → 号码布 → 姓名+单位；新增 athleteByIDCard
- 同表重复证件号 = 同一人报多个组别（notices 提示，不报错）；
  只有「同证件号 + 同小项同组别」才是真重复（conflicts[].duplicate）
- 补齐后端缺失但前端/文档已在依赖的三处契约

## 其余 P1
- 安全：会话撤销断开 ws、实时层按角色裁剪、整库快照限流（含 hello 路径，
  被限流的请求挂起并由心跳兜底补发，不丢刷新）
- 错误分级：手填名次非正数 / gender / 组别年龄 / 导出不存在的小项与单位 /
  积分模板 awardRanks → 400 或 404，不再 500
- 算分一致性：破纪录加分看得失状态；批量退赛·恢复·移出、作废成绩、
  报名导入改状态一律无条件重算推榜（不受延迟结算约束，与实时模式逐字节等价）
- 配置改动触发重算：通道 / 小项参数 / 积分模板
- 升级自愈：channel_ranks 空而已有已发布成绩时，启动时一次性全量重算
  （服务对外监听之前完成，避免升级后奖牌榜全 0）
- 示例数据模式下破坏性操作被阻断，不再假成功
- Console：修复「只剩一块屏」后屏幕监听器被永久摘掉
- 大屏模板引擎：嵌套深度与体积安全阀，任何输入都不抛异常

## 文档
- docs/：使用手册（奖牌开关、奖牌通道、团体名次、枚举列留空口径）、
  常见问题（奖牌排查、升级后奖牌榜为 0、历史重放已知限制）、
  部署指南、上线检查清单
- 版本 dev_0.1.7 → dev_0.1.8（console/package.json 同步）

自检：服务端 13 包 ×2 全绿；前端 vue-tsc + 449 例 ×2 + pnpm build；
Console 35 例 + 语法检查。

docs/常见问题.md

@@ -240,24 +240,25 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
 不能一键撤销。纠错需要重新导入旧规则包，或逐项修正后重新发布。导入前请务必先「预览差异」。
 
 **Q48：报名表里的证件号重复了怎么办？**
-先分清两种「重复」，处理方式完全不同：
+先分清三种「重复」，处理方式完全不同：
 
-- **同一份表里同一个证件号出现多次**：**不再报错**，照常导入（同一个人报多项时，证件号本来就会重复）。证件号只是**档案信息，不参与认人**。
-- **证件号已经登记在系统里另一个人名下**（姓名、号码布都对不上）：这一行会报 `第 N 行：证件号 X 已被另一个人占用（姓名 Y，号码布 Z）` 并**跳过该行**。系统里一个证件号只能属于一个人（避免把两个人的身份弄混）。处理办法：先核对证件号是不是抄错了——不是这个人的，把这一格留空即可（只填号码布也能导入）；确实是他的，先到「基础数据 → 运动员」把另一条档案里的证件号清掉或改对，再重新上传。
+- **同一份表里同一个证件号出现多次**：**不报错**，照常导入——证件号是**人员的唯一标识**，同一个证件号就是同一个人（同一个人报多个组别时本来就会重复）。导入结果里会给一条提示：`证件号 XXXX 在本表中出现 N 次（同一人报名多个组别）`，只是在提醒你别把不同的人写成同一个证件号。
+- **同一证件号 + 同一个小项同一个组别**：这才是**真重复**（同一个人在同一组里被写了两遍）。这一行会进「冲突」列表，由你选**保留已有**（已导入的那条报名不动）或**使用新数据**（用这一行覆盖它）。
+- **证件号已经登记在系统里另一个人名下**：这一行会**按证件号认到那个人**，姓名 / 单位等对不上就进「冲突」列表让你决定；只有实在认不到（例如同时又给了别人的号码布）时才会报 `第 N 行：证件号 X 已被另一个人占用（姓名 Y，号码布 Z）` 并**跳过该行**。处理办法：先核对证件号是不是抄错了——不是这个人的，把这一格留空即可（只填号码布也能导入）；确实是他的，先到「基础数据 → 运动员」把另一条档案里的证件号清掉或改对，再重新上传。
 - **在「运动员」里新增 / 编辑时提示证件号重复**：同上，说明该证件号已属于另一个人。是同一个人的话直接用已有记录；证件号填错就改对。已有历史数据可以没有证件号。
 
 详细步骤见 [使用手册 · 报名导入](./使用手册.md#107-报名导入)。
 
 **Q49：人员没有身份证，只有号码布，能报名吗？**
-可以，这正是**号码布作为唯一标识**的用法：在「运动员」里只填号码布也能保存；报名表里有姓名的行，`id_card` 与 `bib` 至少填一个就能导入；从已有名单勾选报名时，两项里有一项就能勾选。号码布会同时写入人员档案与报名记录。反过来，证件号只是**可选的档案信息**——只填证件号、没有号码布也能导入，但系统是**按号码布认人**的（号码布为空时按「姓名 + 单位」认），所以能编号码布就编上，重名重姓时才分得清。
+可以。证件号是系统认人的**第一依据**，但没有身份证的人只填号码布也能用：号码布此时**顶替证件号认人**。在「运动员」里只填号码布也能保存；报名表里有姓名的行，`id_card` 与 `bib` 至少填一个就能导入；从已有名单勾选报名时，两项里有一项就能勾选。号码布会同时写入人员档案与报名记录。因为没有证件号，认人就全看号码布了——能编上号码布就编上，重名重姓、号码布还必须写成同一个人每次都用的那个号。
 
 **Q50：号码布重复了怎么办？**
-号码布是**单人的唯一标识**，系统不允许两个人员共用同一个号码布。
+两个人**不能**共用同一个号码布（同一个人报多个组别时可以重复）。
 
 - **在「运动员」里新增 / 编辑时提示重复**：说明该号码布已属于另一个人员。请先核对是不是同一个人：是，就直接用已有记录；不是，请检查号码布是否填错。
-- **同一份报名表里号码布重复出现**：重复的行会报错并跳过，改好后重新上传。
-- **号码布在系统里已有、但表里这个人跟他对不上**（姓名 / 性别 / 年龄 / 单位不同）：会列为「冲突」，本次不写入（报名也不会创建），需要在导入结果里勾选后决定「保留已有数据」还是「使用新数据」。
-- **表里某人的号码布与库里「同名 + 同单位」的人不同**：系统按「**同名的另一个人**」给他**新建档案**（不报错），并在导入结果里单独列出 `姓名（单位）：原有号码布 XXX → 新号码布 XXX` 提醒核对。多半是号码布写错了：到「基础数据 → 运动员」把档案里的号改回来、删掉多出来的那条档案即可。
+- **同一份报名表里，同一个号码布给了两个不同的人**：重复的那一行会报错并跳过，改好后重新上传。（同一个人报多个组别、号码布写成同一个，不报错。）
+- **号码布在系统里已有、但表里这个人跟他对不上**（姓名 / 性别 / 年龄 / 单位不同）：会列为「冲突」，本次不写入（报名也不会创建），需要在导入结果里勾选后决定「保留已有数据」还是「使用新数据」。表里同时给了**别人的证件号**时，会先按证件号认人，同样是进「冲突」列表。
+- **表里某人的证件号（或号码布）与库里「同名 + 同单位」的人不同**：系统按「**同名的另一个人**」给他**新建档案**（不报错），并在导入结果里单独列出 `姓名（单位）：证件号 XXX → XXX；号码布 XXX → XXX` 提醒核对。多半是证件号或号码布写错了：到「基础数据 → 运动员」把档案里的号改回来、删掉多出来的那条档案即可。
 
 详细步骤见 [使用手册 · 报名导入](./使用手册.md#107-报名导入)。
 
@@ -308,7 +309,7 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
 
 **Q58：删掉的人怎么又出现在名单里了？**
 
-彻底删除之后，如果又在报名表里导入同一个人（同一个号码布，或同一「单位 + 姓名」），他会以**全新的档案**重新出现在运动员名单里——因为旧档案已经连同他的报名与成绩一起删掉了，系统按「号码布 → 姓名 + 单位」找不到他（证件号不参与认人），就当作新人员建档。所以名单里突然多出一个「以前删过的人」，通常就是某次导入带回来的。
+彻底删除之后，如果又在报名表里导入同一个人（同一个证件号、或同一个号码布、或同一「单位 + 姓名」），他会以**全新的档案**重新出现在运动员名单里——因为旧档案已经连同他的报名与成绩一起删掉了，系统按「证件号 → 号码布 → 姓名 + 单位」都找不到他，就当作新人员建档。所以名单里突然多出一个「以前删过的人」，通常就是某次导入带回来的。
 
 - 新出现的这条是**全新的记录**：以前的报名、成绩与积分不会回来，需要重新录；
 - 不想他再出现，就让各单位不要把这个人填进报名表；确实不该有的，再「彻底删除」一次即可。
@@ -530,7 +531,7 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
 录入、发布、看榜这些日常操作手机上都能做；赛事配置这类条目较多的操作仍建议在电脑上完成。如果某台手机上仍显示不全，请把**机型、浏览器与屏幕宽度**（或截图）告诉维护人员——目前适配覆盖到 390px 宽的窄屏，桌面端布局不受影响。
 
 **Q86：号码布和证件号，哪个才是系统认人的依据？**
-**号码布。** 报名导入时的匹配顺序是「号码布 → 姓名 + 单位」；**证件号不参与认人**，只作为可选的档案信息写入 / 更新。不过系统里**一个证件号仍然只能属于一个人**，撞上别人的证件号会明确报错并指出占用者（见 Q48）。完整匹配规则见[报名名单导入规范](./报名名单导入规范.md)。
+**证件号。** 报名导入时的匹配顺序是「证件号 → 号码布 → 姓名 + 单位」：先按证件号认人；证件号为空、或库里的档案还没登记证件号时按号码布认；两者都没命中才按「姓名 + 单位」找，并把表里给的证件号 / 号码布**回填**进档案。系统里**一个证件号只能属于一个人**，撞上别人的证件号会按证件号认到那个人并进「冲突」列表（见 Q48）。号码布不再单独充当唯一标识，但仍然**不能给两个人共用**（同一个人报多个组别可以重复）。完整匹配规则见[报名名单导入规范](./报名名单导入规范.md)。
 
 **Q87：怎么把报名名单导出来？**
 到「导出 → 结果导出」页，往下找**「报名名单」**卡片：先按**小项 / 组别 / 单位 / 批次**筛选（都可以留空 = 不筛，即导全部），再点「导出报名名单」，得到 `报名名单.xlsx`。表里有 13 列：小项编码、小项名、组别、单位编码、单位名、姓名、证件号、号码布、批次、性别、年龄、状态（中文：正常参赛 / 已退赛 / 取消资格 / 未出场）、备注；号码布按文本导出，前导零不会丢。访客也能导出（只读）。
@@ -541,7 +542,7 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
 - **导出**：一个工作簿四张工作表（单位 / 大项 / 小项 / 组别，组别表带所属小项编码）；
 - **导入**（**仅管理员**，只认 `.xlsx`）：按编码匹配，**存在就更新、不存在就新建，绝不删除**（表里没有的行不会被删、也不会被停用）。先点「预览差异」看「新增 / 更新 / 无变化 / 错误」与逐行变化，确认后再点「**确认写入**」；**有错的行会跳过、合法的行照常写入**，行级错误是中文并带真实 Excel 行号（如 `单位 第 3 行：单位编码必填`）。
 
-要点：**列不在表里 = 不动该字段**（**布尔列也一样**，缺整列 ≠ 取默认值）；**列在表里但格子空**：文本列与年龄上下限清空，权重按 1、布尔列（启用 / 计分等）按「是」，**排序留空保持原值**（**四张表口径一致**，单位 / 大项留空同样不会被改写）。表头行在第 4 行（导出件）或第 1 行（手工表）都能识别；枚举列要填英文规范值、布尔列填「是 / 否」。**最稳的做法是从系统导出、改完再导回**。详见使用手册 11.4。
+要点：**列不在表里 = 不动该字段**（**布尔列也一样**，缺整列 ≠ 取默认值）；**列在表里但格子空**：文本列与年龄上下限清空，权重按 1、布尔列（启用 / 计分等）按「是」，**排序留空保持原值**（**四张表口径一致**，单位 / 大项留空同样不会被改写）。**只有枚举列例外：列在表里但格子空 = 不改动**（小项的类型 / 结果模式 / 结果类型 / 比较 / 状态 / 平均口径、组别的性别），留空就沿用原来的值，只有**新建的行**才用默认值（新建组别时性别留空 = 不限）——这样误清一格不会把已发布小项打回「待录入」、也不会把「团体」改成「个人」。表头行在第 4 行（导出件）或第 1 行（手工表）都能识别；枚举列要填英文规范值、布尔列填「是 / 否」。**最稳的做法是从系统导出、改完再导回**。详见使用手册 11.4。
 
 **Q89：登录会不会用着用着被踢下线？「登录有效期」怎么设？**
 默认有效期 **24 小时**，管理员可在「系统设置 → 登录有效期」里改成 **1–720 小时**（最长 30 天）；比赛期间建议设成 **72 小时**。会话是**滑动续期**的：只要在有效期内继续操作（页面开着也会定期自动续期），到期时间就往后顺延——**不会因为「登录满 N 小时」被踢**。当前到期时间在右上角用户菜单与系统设置页都写着「当前会话将于 X 过期」。
@@ -559,6 +560,7 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
 - **批量退赛**：标记弃权（0 分、不占名次），**随时可以批量恢复**；已经是「取消资格 / 未出场」的行会被跳过、不覆盖原判定；
 - **批量移出报名**：**物理删除**报名项连同他的成绩与积分流水，**不可恢复**，确认框会列出将被删的人与将重算的小项 / 组别；
 - 一次最多 500 条；有未保存的成绩修改时请先「存草稿」再操作。
+- 这三个动作（以及**撤销发布**、**作废单条成绩**、**改积分模板 / 组别权重 / 计分通道**）都**立即重算并推榜**，**不受「分批发布时实时更新榜单」这个延迟结算开关影响**——它们改的是「谁还算数」「按什么规则算」，不是「录了多少」，留着旧分就会变成「榜上还有分、成绩却撤了」。延迟结算只作用于**发布成绩**这一步（见 Q90）。
 
 运动员列表也有类似的多选与**批量停用 / 批量彻底删除**（见使用手册 10.6）。
 
@@ -580,3 +582,49 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
 3. 核对预览后删除。若某张图在你打开页面之后刚被配到别处，服务端会**拒删并说明被谁引用**（宁可漏删、不误删）。
 
 注意：这个页签**只管图片**，上传的字体在「赛事信息 → 字体库」里各自删除（被标题 / 正文字体引用的不能删）；这些图片和字体都是文件，**备份的 `.db` 快照和「一键恢复」都不含它们**（见 Q37），要清点或搬迁请到 `data\event_projs\<项目名>\uploads\`。
+
+**Q94：奖牌榜上一个牌都没有，或者金牌数不对，怎么查？**
+按下面顺序一项项排除（都不需要改数据，改完保存会自动重算榜单）：
+
+1. **是不是刚升级完、第一次启动**？→ 见 Q96，那是升级后的正常现象，服务端会自己补齐；
+2. **该小项关了「该项启用奖牌结算」吗**？到「基础数据 → 大项 / 小项」编辑这个小项，看「选项」里的**「该项启用奖牌结算」**有没有被取消勾选——取消后这个小项**只出积分、不发奖牌**（见使用手册 10.2）；
+3. **该小项的通道关了「发奖牌」吗**？到「基础数据 → 计分通道」选中该小项，看「奖牌通道」列里这条通道的**「发奖牌」**有没有被取消——取消后这条通道的名次只出积分、不发牌（见使用手册 10.4）；关掉的通道在「大项 / 小项」页的通道摘要里会标出 `不发奖牌`；
+4. **个人项目的牌子是不是被排除在单位金牌榜之外**？同一列的**「个人奖牌并入单位金牌榜」**被取消时，这些个人奖牌仍进**个人积分榜**的奖牌列，但**不进单位金牌榜**——所以「某单位的金牌数比现场数的少」多半是这一条；
+5. **这个小项本身计分吗**？标记为「不计分」（只排名不计分）的小项**从来不发奖牌**，这是它本来的口径，不用去动上面那些开关；
+6. **名次是不是还没结算**？如果管理员开了**延迟结算**（Q90），未结算的组名次显示 `—`，自然也没有奖牌；等该组录完，或在录入页点「立即结算」；
+7. **奖牌只发给前三名**，而且**并列第 1 各记 1 金、不发银牌**（名次顺延口径，见 Q10）——「牌数比名次人数少」通常就是这个原因；
+8. 还有一条**全局开关**在规则包里（`standings.medalCountsTeamEvents`，默认**计入**团体项目的奖牌），界面上没有勾选框；本赛会的规则包是「计入」，一般不需要动。只有导入过别的规则包时才会把它改掉，检查办法见 Q47。
+
+**Q95：团体名次在哪里录？为什么有时候录入页没有那一块？**
+团体名次在**「成绩录入」页**录：选中项目与组别后，成绩表格下面会有一块 **「团体名次」** 卡片，按**单位**一行一个输入框，填完点「保存团体名次」。**留空就清空该单位的名次**；名次重复允许并列（会提示确认，不挡保存）；**个人名次不受影响**——它是另一套数据，每个人的名次仍然在成绩列表里录。
+
+**录入页没有这一块是正常的**，说明这个项目**没有配「团体名次 + 手动名次」的计分通道**。常见情况：
+
+- 纯团体项目（篮球、拔河等）：团体名次就是那条**团体报名行上的名次**，仍在成绩列表里照常录，不需要这块卡片；
+- 「个人+团体」项目：团体名次是**按队内成绩平均**算出来的，也不在这里录；
+- 真的需要按单位手填名次（例如「团体引体向上」）：到「基础数据 → 计分通道」给这个小项加一条**名次范围 = 团体名次、名次来源 = 手动名次**的通道并「保存全部」，回录入页就会出现这块卡片。
+
+完整说明见使用手册 4.9。
+
+**Q96：升级到新版本后，奖牌榜是空的（全是 0），怎么办？**
+这是升级后的**正常现象，会自己好**。原因：本版把奖牌统计的数据来源换成了一张新的「通道名次」表，而升级脚本只**建表、不回填**历史名次——所以升级完成到第一次重算之间，奖牌榜会短暂是 0。
+
+服务端**下一次启动时**会自动做一次全量重算把名次补齐（重算在对外提供服务之前跑完，所以大屏不会先亮出一帧全 0）。在 Console「运行日志」或 `logs\operations\` 当天文件里能看到这两行，**是正常的，不是报错**：
+
+```
+检测到通道名次为空但已有已发布成绩，正在执行一次性全量重算
+一次性全量重算完成，通道名次与奖牌榜已补齐（events=… ledgerRows=… elapsed=…）
+```
+
+- 通常**几秒内**跑完（数据量大时稍久，日志里会写耗时）；跑完后刷新管理端/大屏即可看到奖牌；
+- 它**只在需要时跑一次**：表里已经有名次（说明重算过）时不会再触发；
+- 如果看到的是 `通道名次自愈失败，奖牌榜可能仍为空`，那不是"坏了"而是重算没做完：**随便发布一次成绩**、或**重新导入一次规则包**都会触发重算，重算完奖牌就回来了；
+- 想立刻确认数据没问题，也可以手动**重新导入一次规则包**（会全量重算）。
+
+**Q97（已知限制）：双计项目回看历史版本时，积分跟当时现场对不上？**
+有这种可能，属于**已知限制，不影响当前榜单**。
+
+- **哪些项目**：配了「团体名次 + 手动名次」通道的项目（也就是录入页会出现「团体名次」卡片的那类，例如「团体引体向上」）；
+- **什么现象**：在「变更历史」里展开某个历史版本时，页面会按**那一版保存下来的成绩**重新算一遍各单位分数。而**按单位录入的「团体名次」不在历史版本快照里**，所以回看时这些组别的团体分算不出来，各单位的分数增减可能与当时现场看到的略有差异；
+- **不影响什么**：**当前榜单、大屏、导出全部是对的**（它们读的是库里现存的团体名次，与历史快照无关）；只有「历史版本详情」里那一列**分数增减**（以及它影响的单位数）会因此偏小或对不上；
+- 想核对当时的真实分数，以**当时的导出件**（成绩总表 / 单位积分明细）为准。