feat(entry): 团体报名「队员身份」—— 一条报名挂多个运动员，标识用号码布；版本 dev_0.5.6

## 需求（主人原话）
> 「双打我给他定义的是团队赛事，团队赛事不应该本来就是可以配置多个人的吗」
> 「把队员身份证留住，**应该是服务于整个团体报名**」

**现状问题**：界面（`EntryPicker`）**本来就能勾多个运动员**，但提交时只把姓名拼成文字
（`entrySelection.ts` 的 `input.athletes.map(a => a.name)` 存进 `entries.member_names TEXT`）→ **身份全丢**
→ 系统不知道队里坐着谁 → **所有团体/对抗项目都给不出个人分、个人奖牌，上不了个人积分榜**。

## 口径
- **运动员的唯一标识是号码布**（主人明确更正，不是证件号）。
- **每个队员各拿一份完整的个人分** —— 是「**复制**」不是「拆」（与联队 `splitSharePoints` 正好相反）。
- **个人奖牌每人各一枚**；**单位总分与单位奖牌不受影响**（由通道开关 `count_to_team` / `count_to_team_medals` 控制）。

## 一、数据
- 迁移 `0026_entry_athletes.sql`：新表 `entry_athletes(entry_id, athlete_id, sort_order)`，PK `(entry_id, athlete_id)`，两个外键都 `ON DELETE CASCADE`。
  `entries` **一个字节没动**（`member_names` 保留为显示用名单；多队唯一键 `(category_id,team_id,squad) WHERE athlete_id IS NULL` 未触碰）。
- **老数据回填（尽力而为）**：拿 `member_names` 去 `athletes` 匹配 —— **号码布优先**，其次「姓名 + 单位」且同单位同名唯一；**匹配不上留空**，不硬猜。

## 二、引擎
- `RankedResult.MemberCopy`（报名项那份 `false`、队员副本 `true`）；**只在 `scope=athlete` 通道展开**（`scope=team` 与 `basis=aggregate` 不展开）。
- **单位维度不重复计算的三道锁**（本单最大的坑）：
  1. 队员副本流水 `count_to_team` **恒为 false** —— 单位总分那条 SQL 第一句就跳过它，而个人榜不看这个开关；
  2. 单位奖牌仍按**报名项**去重、且报名项那份**排在最前**；
  3. 队员副本**照抄 `TeamID` 与 `Shares`**（不换单位、不另造份额 —— 联队报名尤其危险）。
  反面也测了：个人奖牌若按报名项去重会**一枚都发不出来**（被 `AthleteID=0` 那份吃掉），故改为按「报名项 + 运动员」去重。

## 三、写 / 读
- `PUT /api/entries/{id}/athletes`（recorder+、CSRF）：body `{"athletes":[{"athleteId":12}],"requestId":"..."}`，**只认 athleteId**；空数组＝清空；
  改完当场重算推榜。400：athleteId 缺/不存在、同一人两次、>30 人、个人报名不能挂队员。
- 读：`entryDTO.athletes: [{athleteId, name, bib}]`（**始终是数组**）；`memberNames` 原样保留，**两者可并存**（没档案的人只能留文字）。

## 四、导入
- 报名表「队员名单」列现在**按号码布认人**（命中即关联，同时保留文字）；⚠️ **姓名完全不做匹配**（同名会认错，而认错的分已经上了榜）；匹配不上**不报错、只当文字**。
- 边界逐条有 notice/报错：跨单位号码布**照关联 + notice**（号码布是唯一标识）；同格重号只关联一次 + notice；**个人行**写了号码布只留文字 + notice；**认出 >30 人整行拦下**；成功时一条汇总 notice。
- **更新路必须重算**：老表先导入、成绩已发布，之后补上号码布重传 —— 不在更新路重算就会出现「名单里有队员、榜上没有他」（删掉该条件即红）。

## 五、界面与显示
- 补报名勾的人**真正提交**（导入成功后追加 `PUT /athletes`，**只发需要变的**：勾了人的单位、以及原来有队员这次一个没勾的（发 `[]`）；一个都没勾且原来也没队员的一律不发）；**队员写失败单独提示**（报名本身已加入，不冒充「加入报名失败」）。
- **改队员**：录入页「运动员/队」那格的**「队员」小按钮**（只有纯团体行才有），弹窗勾选式名单；**与「成员单位与份额」是两个独立写请求**（份额管「分给哪些单位」、队员管「这条报名里有哪几个人」）。
- 显示统一写法 **`姓名（号码布）`**（导出件；大屏只写姓名与 ` / ` 分隔 —— 号码布太长会把整屏字号压下去）；**没有队员关联的老数据一个字不变**；
  ⚠️ **一条报名仍只占一行**（有护栏测试钉着）；`squad`（队）与 `athletes`（队员）**正交**。

## 验证
- 全量自检两轮**全绿、`EXIT=0`**：服务端 14 包 / 前端 **921 例** 0 fail / Console 68 例 0 fail。
- 各块先红后绿并留原始输出；**老数据零变化**有 golden 对拍（引擎层 / 接口层 / 导出层逐行 dump）。

## 文档
`docs/报名名单导入规范.md`（队员列语义升级，列数仍是 13）、`docs/使用手册.md`（新增 4.13 团体报名的队员）、
`docs/升级说明.md`（新增 `dev_0.5.6` 一节）。

## 版本
`dev_0.5.5` → **`dev_0.5.6`**（含数据迁移 `0026`）；安装器素材同步重生成（照例只动 `brand.bmp` 两张）。

docs/升级说明.md

@@ -6,7 +6,60 @@
 
 ---
 
-## dev_0.5.5（当前版本）
+## dev_0.5.6（当前版本）
+
+### 一句话
+
+**有一条数据迁移（`0026`），老数据一个字节都不变**：团体 / 对抗项目的报名现在能**挂具体的队员了**——界面本来就能一次勾多个运动员，但以前提交时只把姓名拼成一串文字，**身份丢了**，所以配了「个人通道」的团体项目**给不出个人分、个人奖牌，队员也上不了个人积分榜**。升级后：队员**每人各拿一份完整的个人分、各一枚个人奖牌**（是「每人各一份」，不是几个人分同一份）；**单位总分与单位奖牌不受影响**（由计分通道的开关决定，双打现场通常都设成不计入）。没有挂队员的老报名、以及只配了团体通道的项目（现场绝大多数球类项目），**行为与升级前逐字一样**。
+
+### ① 数据迁移：一条（`0026`）
+
+- **它做什么**：新建一张 `entry_athletes` 表，记「这条报名里有哪几个运动员」；**报名表本身一个字节没动**（原来那串姓名文字 `member_names` 保留为**显示用名单**，报名的唯一键、队名、名单导出都不受影响）。
+- **老数据回填（尽力而为，匹配不上就留空）**：拿原来那串姓名文字去对运动员档案——**先按号码布认**；号码布对不上再按「**姓名 + 单位**」，且**同一个单位里同名的人只有一个**时才认（重名留给人工确认）；**认不上的不猜，留空**（维持升级前的行为：这条报名只有单位、没有队员身份）。
+- **回填之后会发生什么**：配了**个人通道**的老团体项目会**开始给这些队员发个人分与个人奖牌**（这正是这一版的目的）；**只配了团体通道的项目一个字节都不变**（单位总分、单位奖牌、榜单都不动）。⚠️ 所以升级后请**抽查几个团体项目**：原来只写姓名的报名可能仍然没有队员（那就手动挂上，见下）。
+- **怎么看它跑过**：启动一次 Console，在运行日志或 `logs\operations\` 当天文件里能看到 `已应用迁移 … name=0026_entry_athletes.sql`。
+
+### ② 新能力：团体报名的队员（谁在这支队里）
+
+| 场景 | 怎么做 |
+| --- | --- |
+| **导入报名表** | 「队员名单」那一格写**号码布**（例如 `101/102`）→ 自动关联到人；**写姓名只当文字**（名单照常显示，但拿不到个人分），也**不报错**。⚠️ 号码布要**单独成段**：`张三（101）` 这种混写认不出人；一条报名最多 30 人 |
+| **补报名时勾人** | 「成绩录入」页的「补报名」/「基础数据 → 报名导入」的团体报名页签：勾上人**会真正提交**到报名上 |
+| **录入页改队员** | 「成绩录入」页表格里**「运动员 / 队」那一格旁边的「队员」小按钮**（只有纯团体行才有）→ 勾选式名单（带搜索）→ 保存。改完**当场重算该组别并推榜** |
+
+**口径**：
+
+- **号码布是运动员的唯一标识**（不是证件号、也不是姓名）：系统**只按号码布认人**；号码布认到的是**别的单位**的人时**照样关联**，只给一条提示让你核对；
+- **每人各拿一份完整的分**（一对双打赢了拿 10 分 → 两个人各 10 分），**各一枚个人奖牌**；
+- **单位那本账不变**：单位总分与单位奖牌由「计分通道」的 `计入单位总分` / 个人奖牌是否并入单位榜两个开关决定；**双打现场通常都是不计入**；
+- **个人报名（按人报名的那些）没有队员**——它自己就是那个人的身份；**一条报名仍然只占一行**（挂了两个队员也不会变成两行）。
+
+### ③ 显示：一个队员写成 `姓名（号码布）`
+
+- **导出件**：报名名单「姓名」列、分项成绩表 / 全部成绩单页 / 单位奖牌明细的「运动员 / 队」列都写成 `张三（101）`，多个用 `、` 连；**个人得分明细里每人各占一行**（双打两行，各一整份分）；
+- **大屏**：分项成绩 / 实时赛况的运动员列、底栏「最新完成项目」都带上队员名单（**只写姓名**，号码布太长会把整屏字号压小）；
+- ⚠️ **没有队员关联的老数据一个字不变**：老报名的导出件与大屏画面与升级前逐字 / 逐像素一致（姓名文字照旧、行为照旧）。
+
+### ④ 升级后 5 分钟核对
+
+1. 启动一次 Console，看运行日志 / `logs\operations\` 当天文件：应能看到 `0026` 这条迁移记录，没有别的报错；
+2. 刷新管理端「积分榜」与大屏：**单位总分榜、单位奖牌榜的数字与升级前一致**（本版不动单位那本账）；
+3. 打开「成绩录入」页：挑一条**团体报名**看「运动员 / 队」那一格——纯团体行旁边应有一个**「队员」小按钮**（个人行没有，这是对的）；点开看看有没有队员（老报名可能一个都没有，那是回填没认上，属正常）；
+4. 挑一个**原来只写了姓名**的团体报名（羽毛球双打那种），点「队员」按钮**把队员勾上**保存；再到「积分榜 → 个人积分榜」确认**这些队员出现了、各有一条分**；
+5. 拿一份**写着号码布**的报名表（「队员名单」列写成 `101/102`）试导一次，导入结果里应能看到一条关于队员的汇总提示；
+6. 用《上线检查清单》过一遍。
+
+### ⑤ 详细说明在哪
+
+| 想了解 | 看 |
+| --- | --- |
+| 队员怎么挂、改在哪、显示成什么样 | 《使用手册》4.13（以及 4.2、10.7 的衔接说明） |
+| 导入表里「队员名单」怎么写（号码布 / 姓名各是什么效果） | 《报名名单导入规范》第三节「`member_names` 队员名单」、第四节的例 6、第六节 |
+| 迁移与两处判定 | `server/migrations/event/0026_entry_athletes.sql` |
+
+---
+
+## dev_0.5.5
 
 ### 一句话