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/internal/httpapi/repo.go

@@ -502,6 +502,22 @@ func validateAthleteAge(age *int) error {
 	return nil
 }
 
+// validateAthleteGender 性别可以留空（历史档案里就有空的），填了就必须是「男」或「女」。
+//
+// athletes.gender 有 CHECK (gender IN ('男', '女'))，不在写入侧拦下来，现场把性别填成
+// M / male 就只能看到 500 + 英文约束原文 —— 同一类错在组别就地更新路径上是 400。
+// 与组别那条（validateCategoryGender）同口径：不做 TrimSpace，带空格的值按非法拒绝，
+// 免得「校验通过、落库撞 CHECK」这种更难看的结果。
+func validateAthleteGender(gender *string) error {
+	if gender == nil {
+		return nil
+	}
+	if v := *gender; v != "" && v != "男" && v != "女" {
+		return badRequest("gender 只能是 男 / 女", gender)
+	}
+	return nil
+}
+
 func (s *server) createAthlete(ctx context.Context, in athleteDTO) (athleteDTO, error) {
 	if strings.TrimSpace(in.Name) == "" || in.TeamID == 0 {
 		return athleteDTO{}, badRequest("name 与 teamId 必填", nil)
@@ -509,6 +525,9 @@ func (s *server) createAthlete(ctx context.Context, in athleteDTO) (athleteDTO,
 	if err := validateAthleteAge(in.Age); err != nil {
 		return athleteDTO{}, err
 	}
+	if err := validateAthleteGender(in.Gender); err != nil {
+		return athleteDTO{}, err
+	}
 	// 证件号与号码布都是唯一标识：先查重给出明确 409，并发下再由唯一索引兜底。
 	if err := s.checkAthleteIdentity(ctx, in, 0); err != nil {
 		return athleteDTO{}, err
@@ -560,6 +579,9 @@ func (s *server) updateAthlete(ctx context.Context, id int64, in athleteDTO) (at
 	if err := validateAthleteAge(in.Age); err != nil {
 		return athleteDTO{}, err
 	}
+	if err := validateAthleteGender(in.Gender); err != nil {
+		return athleteDTO{}, err
+	}
 	if err := s.checkAthleteIdentity(ctx, in, id); err != nil {
 		return athleteDTO{}, err
 	}
@@ -676,8 +698,9 @@ func (s *server) purgeAthlete(ctx context.Context, id int64) (athletePurge, erro
 		return athletePurge{}, err
 	}
 
-	// 重算：删完成绩后按组别重建流水，别人的名次与得分随新排序更新。
-	// 只重建流水还不够——成绩表与奖牌统计看的是 results.rank，必须像发布那样把名次写回去。
+	// 重算：删完成绩后按组别重建流水与通道名次，别人的名次与得分随新排序更新。
+	// 只重建流水不够——成绩表看的是 results.rank（个人名次），必须像发布那样把名次写回去；
+	// 奖牌榜与运动员榜看的是 channel_ranks，由 recomputeLedgerTx 一并重建。
 	actorID := middleware.User(ctx).ID
 	eventIDs := make([]int64, 0, len(scopes))
 	for _, sc := range scopes {
@@ -1210,6 +1233,19 @@ func (s *server) getProfile(ctx context.Context, id int64) (profileDTO, error) {
 	return p, nil
 }
 
+// validateAwardRanks 校验积分模板的「录取名次」（scoring_profiles.award_ranks）。
+//
+// 口径照建表约束来（migrations/event/0003：CHECK (award_ranks >= 0)），不自己发明上限：
+// 0 表示不按名次封顶——算分引擎只在 award_ranks > 0 时才按名次截断（domain.basePoints），
+// 规则包侧（rules/validate.go）也只拒负数。不在这里拦，-1 会一路撞 CHECK 报 500 +
+// 原始约束文本，而同一张表的 tieMode / recordBonusMode 早就是 400。
+func validateAwardRanks(awardRanks int) error {
+	if awardRanks < 0 {
+		return badRequest("awardRanks 需要是不小于 0 的整数（0 表示不按名次封顶）", awardRanks)
+	}
+	return nil
+}
+
 func (s *server) createProfile(ctx context.Context, in profileDTO) (profileDTO, error) {
 	if strings.TrimSpace(in.Code) == "" || strings.TrimSpace(in.Name) == "" {
 		return profileDTO{}, badRequest("code 与 name 必填", nil)
@@ -1222,6 +1258,9 @@ func (s *server) createProfile(ctx context.Context, in profileDTO) (profileDTO,
 	if err != nil {
 		return profileDTO{}, err
 	}
+	if err := validateAwardRanks(in.AwardRanks); err != nil {
+		return profileDTO{}, err
+	}
 	tx, err := s.ev.BeginTx(ctx, nil)
 	if err != nil {
 		return profileDTO{}, internal(err)
@@ -1248,6 +1287,15 @@ func (s *server) createProfile(ctx context.Context, in profileDTO) (profileDTO,
 	if err := tx.Commit(); err != nil {
 		return profileDTO{}, internal(err)
 	}
+	// 新建的模板此刻还没有任何引用（sports.default_profile_id 与
+	// event_score_channels.profile_id 都是指向 scoring_profiles(id) 的外键，
+	// 模板必须先存在才挂得上），所以这一次重算实际上是空转；留在这里是为了与
+	// 「改模板」走同一条落地路径，免得以后给新建流程加上「顺手挂到某处」的逻辑时漏掉重算。
+	// recomputeAllEvents 自带事务与推榜，别再包一层。
+	if _, err := s.recomputeAllEvents(ctx, middleware.User(ctx).ID); err != nil {
+		s.logger.Error("积分模板新建后重算失败", "err", err)
+		return profileDTO{}, internalMsg("积分模板已保存，但积分重算失败，成绩与积分尚未同步；请重试保存", err)
+	}
 	return s.getProfile(ctx, id)
 }
 
@@ -1260,6 +1308,9 @@ func (s *server) updateProfile(ctx context.Context, id int64, in profileDTO) (pr
 	if err != nil {
 		return profileDTO{}, err
 	}
+	if err := validateAwardRanks(in.AwardRanks); err != nil {
+		return profileDTO{}, err
+	}
 	tx, err := s.ev.BeginTx(ctx, nil)
 	if err != nil {
 		return profileDTO{}, internal(err)
@@ -1288,6 +1339,12 @@ func (s *server) updateProfile(ctx context.Context, id int64, in profileDTO) (pr
 	if err := tx.Commit(); err != nil {
 		return profileDTO{}, internal(err)
 	}
+	// 模板分值是算分公式的输入：改了就必须全量重算已发布成绩的积分与名次，并把新榜单推给大屏。
+	// recomputeAllEvents 内部自建事务并写 standings 版本，这里不要再套事务（嵌套会死锁在单连接上）。
+	if _, err := s.recomputeAllEvents(ctx, middleware.User(ctx).ID); err != nil {
+		s.logger.Error("积分模板更新后重算失败", "err", err)
+		return profileDTO{}, internalMsg("积分模板已保存，但积分重算失败，成绩与积分尚未同步；请重试保存", err)
+	}
 	return s.getProfile(ctx, id)
 }