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

web/src/shared/api.ts

@@ -1,5 +1,6 @@
 import { isRawBody, isRecord, readString } from './internal'
 import { normalizeRulePack } from './rules'
+import { readTeamRanksView, readTeamRanksViews } from './teamRanks'
 import { parseYaml } from './yaml'
 import type {
   AdjustmentInput,
@@ -42,6 +43,8 @@ import type {
   SaveDraftPayload,
   ScoreChannel,
   ScoreChannelInput,
+  TeamRanksInput,
+  TeamRanksView,
   ScoringProfile,
   ScoringProfileInput,
   Sport,
@@ -108,6 +111,7 @@ const API_ERROR_CODES: readonly string[] = [
   'NETWORK',
   'TIMEOUT',
   'PARSE_FAILED',
+  'SAMPLE_DATA_BLOCKED',
 ]
 
 function isApiErrorCode(value: unknown): value is ApiErrorCode {
@@ -137,8 +141,36 @@ export interface SettingsApi {
   update(patch: Partial<EventSettings>): Promise<EventSettings>
 }
 
+/**
+ * 成绩录入接口的完整读数（`GET /api/events/{id}/entries`）。
+ *
+ * 旧服务端只回成绩行数组；设计 17 §七 之后同一响应会随行带上该小项的团体手工名次，
+ * 录入页一次请求就能把「成绩行 + 团体名次」都拿到，少发一轮。
+ */
+export interface EntryBoard {
+  entries: EntryWithResult[]
+  /** 随行下发的团体名次视图；只有存在团体手工通道的组别才非空，拿不到时为空数组。 */
+  teamRanks: TeamRanksView[]
+}
+
 export interface EventsApi extends CrudApi<Event, EventInput> {
   entries(eventId: number): Promise<EntryWithResult[]>
+  /** 与 entries 同一次请求，但把随行下发的 teamRanks 一并交给调用方。 */
+  entryBoard(eventId: number): Promise<EntryBoard>
+  /**
+   * 读某个组别的团体手工名次（`GET /api/events/{id}/categories/{cid}/team-ranks`）。
+   *
+   * 组别下没有团体手工通道时服务端回一组空数组，不是 404——录入页据此隐藏区块，
+   * 不需要先猜有没有这个接口。
+   */
+  teamRanks(eventId: number, categoryId: number): Promise<TeamRanksView>
+  /**
+   * 写某个组别的团体手工名次（`PUT` 同一路径），整组替换。
+   *
+   * `ranks[].rank: 0` 表示清空该单位；服务端在同一事务里重算该组名次与积分。
+   * 返回保存后的视图（口径与 GET 一致），调用方直接拿来回填。
+   */
+  saveTeamRanks(eventId: number, categoryId: number, input: TeamRanksInput): Promise<TeamRanksView>
   categories(eventId: number): Promise<EventCategory[]>
   saveCategories(eventId: number, categories: EventCategoryInput[]): Promise<EventCategory[]>
   /**
@@ -496,10 +528,43 @@ function createAthletesApi(http: Http): AthletesApi {
   }
 }
 
+/** 团体手工名次的路径：GET 读、PUT 写同一个地址。 */
+function teamRanksPath(eventId: number, categoryId: number): string {
+  return `/events/${eventId}/categories/${categoryId}/team-ranks`
+}
+
+/**
+ * 成绩录入接口的原始响应：裸数组（旧服务端）或 `{entries, teamRanks}`（设计 17 之后）。
+ *
+ * 两种形状都能读；都不像时抛 PARSE_FAILED 而不是给空成绩单——
+ * 把「解析不出来」显示成「这个组没有报名项」，现场会以为报名数据丢了。
+ */
+function readEntryBoard(value: unknown): EntryBoard {
+  if (Array.isArray(value)) {
+    return { entries: value as EntryWithResult[], teamRanks: [] }
+  }
+  if (isRecord(value) && Array.isArray(value.entries)) {
+    return {
+      entries: value.entries as EntryWithResult[],
+      teamRanks: readTeamRanksViews(value.teamRanks),
+    }
+  }
+  throw new ApiError('PARSE_FAILED', '成绩录入接口响应格式不符', 0, value)
+}
+
 function createEventsApi(http: Http): EventsApi {
+  const listBoard = async (eventId: number): Promise<EntryBoard> =>
+    readEntryBoard(await http.request<unknown>(`/events/${eventId}/entries`))
   return {
     ...createCrudApi<Event, EventInput>(http, '/events'),
-    entries: (eventId) => http.request<EntryWithResult[]>(`/events/${eventId}/entries`),
+    entries: async (eventId) => (await listBoard(eventId)).entries,
+    entryBoard: listBoard,
+    teamRanks: async (eventId, categoryId) =>
+      readTeamRanksView(await http.request<unknown>(teamRanksPath(eventId, categoryId))),
+    saveTeamRanks: async (eventId, categoryId, input) =>
+      readTeamRanksView(
+        await http.request<unknown>(teamRanksPath(eventId, categoryId), { method: 'PUT', body: input }),
+      ),
     categories: (eventId) => http.request<EventCategory[]>(`/events/${eventId}/categories`),
     saveCategories: (eventId, categories) =>
       http.request<EventCategory[]>(`/events/${eventId}/categories`, {