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 例 + 语法检查。

server/main.go

@@ -124,6 +124,8 @@ func main() {
 	authSvc := auth.New(st.DB(), auth.Options{Logger: logger})
 	hub := realtime.NewHub(eventDB, logger)
 	hub.SetAllowedOrigins(cfg.Server.AllowedOrigins)
+	// 会话复查：/ws 的身份在握手时固化，会话被撤销后必须断开对应的长连接。
+	hub.SetSessionChecker(authSvc)
 	defer func() { _ = hub.Close() }()
 
 	// 可信代理：默认空，表示不采信任何代理头（见 devdocs/08 第 1 节）。
@@ -148,23 +150,32 @@ func main() {
 
 	backupSvc := export.NewService(st.DB(), eventDB, filepath.Join(cfg.DataDir, "backups"), cfg.Backup.Keep, logger)
 
+	apiOpts := httpapi.Options{
+		Logger:  logger,
+		Version: version,
+		System:  st.DB(),
+		Event:   eventDB,
+		Auth:    authSvc,
+		DataDir: cfg.DataDir,
+		Backup:  backupSvc,
+		// POST /api/shutdown 复用同一个关闭信号：取消 ctx 后走下面的 Shutdown + 关库。
+		Shutdown:   stop,
+		ProjectDir: filepath.Join(cfg.DataDir, "event_projs", projectName),
+		Display:    displaySender{hub: hub},
+		Realtime:   hub,
+		WS:         hub.Handler(),
+	}
+
+	// 老库升级自愈（迁移 0020 只建 channel_ranks、不回填历史名次）。
+	// 必须在这台大屏开始拉快照之前同步跑完，否则奖牌榜会先亮出一帧全 0。
+	// 失败不拦启动：现场正开着赛事，重算留到下一次发布 / 规则导入重试，服务本身要能起来。
+	if _, err := httpapi.HealChannelRanksOnce(ctx, apiOpts); err != nil {
+		logger.Error("通道名次自愈失败，奖牌榜可能仍为空；可重新发布成绩或导入规则包触发重算", "err", err)
+	}
+
 	srv := &http.Server{
-		Addr: cfg.Server.Addr(),
-		Handler: httpapi.New(httpapi.Options{
-			Logger:  logger,
-			Version: version,
-			System:  st.DB(),
-			Event:   eventDB,
-			Auth:    authSvc,
-			DataDir: cfg.DataDir,
-			Backup:  backupSvc,
-			// POST /api/shutdown 复用同一个关闭信号：取消 ctx 后走下面的 Shutdown + 关库。
-			Shutdown:   stop,
-			ProjectDir: filepath.Join(cfg.DataDir, "event_projs", projectName),
-			Display:    displaySender{hub: hub},
-			Realtime:   hub,
-			WS:         hub.Handler(),
-		}),
+		Addr:              cfg.Server.Addr(),
+		Handler:           httpapi.New(apiOpts),
 		ReadHeaderTimeout: 10 * time.Second,
 	}