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` 两张）。
2026-09-14 14:05:48 +08:00
1 parent 7a3e4ad365
commit 99c91f99f7
@@ -100,7 +100,7 @@

 ### 4.2 录入成绩

-表格列依次为：勾选框、录入（状态徽标）、号码、批次、单位、运动员 / 队、成绩输入、名次、状态、积分（自动）、备注、操作。**「运动员 / 队」这一列在姓名后面直接跟着该人的号码布**（灰色小字，例如 `张伟 101`）：号码列仍然保留，这一处只是省得在长表格里左右横跳找号。
+表格列依次为：勾选框、录入（状态徽标）、号码、批次、单位、运动员 / 队、成绩输入、名次、状态、积分（自动）、备注、操作。**「运动员 / 队」这一列在姓名后面直接跟着该人的号码布**（灰色小字，例如 `张伟 101`）：号码列仍然保留，这一处只是省得在长表格里左右横跳找号。**纯团体报名这一格旁边还有一个「队员」小按钮**（点开登记 / 修改这支队的队员，见 4.13）；普通报名没有这个按钮。

 **「单位」这一列兼作「成员单位与份额」的入口**：普通报名显示单位简称（或全称）——**这一格与以前长得一模一样**，只是鼠标移上去变成手型、旁边有一行悬停提示，**点一下**会打开「成员单位与份额」弹窗（什么单位参赛、各占多少，见 4.11）。一条报名挂了多个单位（**联队**，两个单位因人数不足合并参赛）时，这一格会多一个「联队」小标，并把成员单位与份额逐条列出来：`联队 第一分公司 50% 第二分公司 50%`；不是均分时还会带上权重，例如 `联队 第一分公司 67%（权重 2） 第二分公司 33%`。**报名的队名**（同一个单位派两个队时写的那个，见 4.12）直接跟在单位名后面显示，例如 `第一分公司二队`；**没填队名时这一格与以前逐字一样**。

@@ -342,6 +342,45 @@
 - **改队名不影响成绩与榜单**：队名只是给现场看的一个标签，不参与名次、积分、奖牌的计算，所以改它**不会重算榜单**，也**不会给别处的大屏 / 录入页推刷新**——别的窗口要等下一次刷新才看到新队名（你自己那一次保存的页面上会立刻变）；
 - 队伍**不参与「团体名次」按单位录入**的那一类项目（篮球那种每个单位只有一支队）：名次仍然是按单位录的，与队名无关。

+### 4.13 团体报名的队员（谁在这支队里）
+
+**团体/对抗项目（双打、接力、拔河、篮球…）的报名上可以挂「队员」**——挂上之后，系统知道**这支队伍里坐着谁**。这条报名在配了「个人通道」的项目里就会**给每个队员各发一份完整的个人分、各一枚个人奖牌**，他们也因此能上**个人积分榜**（过去只存一串姓名文字，谁都上不了个人榜）。
+
+**「每人各一份」不是「几个人分同一份」**：一对双打赢了拿 10 分，是**两个人各 10 分**（不是各 5 分）——这与「联队把分拆给几个单位」正相反。**单位总分与单位奖牌不受影响**：一个单位拿到多少分、多少牌，由「计分通道」里的 `计入单位总分` / 个人奖牌是否并入单位榜两个开关决定；**双打现场通常都设成不计入**，也就是个人分给到人、单位那本账不变。
+
+**怎么挂队员（三条路）**
+
+| 方式 | 怎么做 |
+| --- | --- |
+| **补报名时勾人** | 「成绩录入」页工具栏的 **「补报名」**（或「基础数据 → 报名导入」的**团体报名**页签）：勾上单位后可以**登记队员**（逐个勾选，可按姓名 / 工号搜索）。**勾上的人会真正提交上去**，写进那一条团体报名 |
+| **录入页改队员** | 「成绩录入」页表格里**「运动员 / 队」那一格旁边的「队员」小按钮**（**只有纯团体行才有**）→ 打开勾选式名单（带搜索）→ 勾完保存。这是**把已经报过的报名补挂 / 改挂队员**的地方 |
+| **导入报名表** | 把「队员名单」那一格写成**号码布**（例如 `101/102`），导入时会自动关联到人；**写姓名只当文字**，详见[报名名单导入规范 · 第三节「队员名单」](./报名名单导入规范.md) |
+
+**号码布是唯一标识**
+
+- 系统**只按号码布认人**（`101` → 号码布是 101 的那个人）。**姓名一律不参与匹配**——同名会认错人，而认错的分已经上了榜；
+- 所以**「队员名单」里只写姓名是拿不到个人分的**（名单照常显示，也**不报错**）；界面上手动勾人不受这条限制（勾的是人）；
+- 号码布认到的是**别的单位**的人时**照常关联**，并给一条提示让你核对号码布是不是抄错了（号码布是唯一标识，系统不看单位）。
+
+**显示成什么样**
+
+- **导出件**：一个队员写 **`姓名（号码布）`**（例如 `张三（101）`），多个用 `、` 连——报名名单的「姓名」列、分项成绩表 / 全部成绩单页 / 单位奖牌明细的「运动员 / 队」列都这样；**个人得分明细里每个队员各占一行**（双打就是两行，各一整份分）；
+- **大屏**：分项成绩 / 实时赛况的运动员列、底栏「最新完成项目」的名字格都会带上队员名单（**只写姓名**，号码布太长会把整屏字号压小）；
+- ⚠️ **一条报名仍然只占一行**，不会因为挂了两个队员就变成两行（队里的两个人是**一条报名**里的两个身份）；
+- ⚠️ **队名（4.12）与队员是两件独立的事**：单位列照旧显示「单位名 + 队名」，队员只出现在运动员列 / 底栏。
+
+**老数据怎么办**
+
+- 升级时会**尽力回填**一次：拿原来那串姓名文字去对——**先按号码布认**，再按「姓名 + 单位」（**同一个单位同名的人只有一个**时才认）；**认不上的就留空**（不硬猜，避免把分记到别人头上）；
+- 所以**升级后请抽查几个团体报名**：只写姓名（或没写队员）的老报名，很可能**还是没有队员身份**——需要的话，到录入页点「队员」按钮手动挂上，或重新导入一份**写着号码布**的报名表；
+- ⚠️ **改完队员之后**：这条报名的个人分、个人奖牌会**当场重算并推榜**；但**名单文字（`member_names`）与队员关联是并存的**——名字文字里没被认成人的那些名字**永远上不了个人榜**，要上榜就得挂成队员。
+
+**要注意的**
+
+- **权限**：读得到成绩的人都能看见；**能改的是录入员及以上**（与录成绩同档）。访客只读时按钮置灰；示例数据模式下不能保存；
+- **一条报名最多 30 个队员**（超过会被拦下，多半是号码布写错了位置）；**个人报名（按人报的那些）没有队员**（它自己就是那个人的身份）；
+- **改队员不会重算整张榜**（与改队名一样只重算这条报名所在的组别），**也不会给别处的大屏推刷新**——别的窗口要等下一次刷新才看到新名单。
+
 ---

 ## 5. 成绩审核
@@ -756,7 +795,8 @@

 1. 在参赛单位清单里勾选要参加本组别的单位，**默认一个都不勾**——不参加的单位不勾即可；每行显示该单位是否「已报名」、已登记几名队员；
 2. **同一个单位要派两支队时**（羽毛球双打那种）：勾上这个单位后，那一行右侧会出现 **「队伍（留空＝不区分）」** 输入框，填上队名（例如 `一队`）；**没勾的单位不显示这个框**。已经报过的单位徽标会写成 `已报名（一队、二队）`——**要再报第二支队，就再填一个新的队名提交一次**（同一个队名重复提交只是更新队员名单，不会新增）。详见 4.12；
-3. 要登记队员时点该行的「登记队员」展开名单逐个勾选（可按姓名 / 工号搜索）；一个队员都不勾就是**纯单位报名**，队员名单之后还能再补；
+3. 要登记队员时点该行的「登记队员」展开名单逐个勾选（可按姓名 / 工号搜索）；一个队员都不勾就是**纯单位报名**，队员名单之后还能再补。
+   - **这里勾上的队员会真正提交到报名上**（不是只存一串姓名）：配了「个人通道」的项目里，他们会各拿一份个人分、各一枚个人奖牌，也上得了个人积分榜——详见 **4.13**；
 4. 勾选「已报名」的单位会出现「提交将清空原名单」提醒：再次提交是用本次登记的队员覆盖原名单；
 5. 点「加入报名」，一次为所有勾选的单位各建一条报名（**同一个单位 + 同一个队名**只留一条）。
   - 「全选」只勾启用中且还没报名的单位（已停用的单位要单独勾），且不会展开队员面板；「清空」只取消单位勾选，已登记的队员名单留着，重新勾上就回来。
@@ -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

 ### 一句话

@@ -45,7 +45,7 @@
 | `seed` | 种子（也认「道次」） | 道次 / 种子 |
 | `heat` | 批次（也认「批次号」） | 批次，可缺省 |
 | `status` | 状态（也认「报名状态」） | 报名状态 |
-| `member_names` | 队员名单 | 团体项目的队员名单 |
+| `member_names` | 队员名单 | 团体项目的队员名单；**写号码布才会关联到人**（写姓名只当文字） |
 | `squad` | 队伍（也认「队名」「队伍名」） | **队名，可缺省**；同一个单位在同一组别派两支队时用它区分（留空 = 不区分队伍） |

 > **第 13 列 `squad`（队伍）永远排在最后**：它是 2026 年 9 月新增的，加在表尾是为了让**手里那些原来 12 列的老表格一列都不会错位**（表格少的正是最后这一列）。整列不写、整列留空、表头没有它，三种情况都合法。
@@ -69,7 +69,7 @@
 | `seed`（种子） | 可选 | 道次 / 种子，随便写或留空 | `种子1` |
 | `heat`（批次） | 可选 | 批次号：1–999 的整数；**留空 = 未分批**（不参与算分，见下） | `1` |
 | `status`（状态） | 可选 | 报名状态：4 个英文词（大小写都行）或等价的中文别名（见下） | `registered` |
-| `member_names`（队员名单） | 可选 | 团体项目的队员名单，多人用 `/` 隔开 | `张三/李四/王五` |
+| `member_names`（队员名单） | 可选 | 团体项目的队员名单，多人用 `/` 隔开。**写号码布 = 关联到那个人（能拿个人分）**；只写姓名 = 只当文字 | `101/102`（号码布）；`张三/李四`（仅文字） |
 | `squad`（队伍） | 可选 | **队名**（自由写，例如 `一队`）；**留空 = 不区分队伍**。**同一个单位在同一个组别派两支队就靠它区分**，见第三节 | `一队` |

 > 「必须」指的是**这一列的表头要有**。至于每格里能不能留空，看下面第三节逐列的说明。
@@ -180,6 +180,7 @@ F1+F2
 > 第 12 行：status「已报到」无法识别，只能填 registered / scratched / dq / dns（或留空）

 ### `member_names` 队员名单
+
 团体项目用这一列写队员，多人之间用 `/`、`,` 或 `，` 分开：

 ```
@@ -190,6 +191,31 @@ F1+F2
 - 团体项目**可以只报单位、不写队员**（这一列留空即可），队员名单以后还能补。
 - 系统界面里会把这条名单显示成「张三、李四、王五」。

+**想让队员真正「上场」——这一列要写号码布**
+
+这一列有**两种内容**，系统按段（用 `/`、`,`、`，` 分开的每一段）分别处理：
+
+| 这一段写的是 | 系统怎么处理 |
+| --- | --- |
+| **某个运动员的号码布**（例如 `101`、`A001`） | **认成那个人**：把这条团体报名与他**关联**起来（这一格也原样保留成文字）。**关联上的队员才能拿个人分、上个人积分榜、拿个人奖牌**（该项目配了「个人通道」时） |
+| **只有姓名**（例如 `张三`） | **只当文字**：名单照常显示，**不会关联到人**（姓名可能重名，认错的分已经上了榜——所以系统**故意不按姓名认人**），也**不报错** |
+
+```
+101/102          ← 推荐写法：号码布，两个队员都能拿到个人分
+张三/李四         ← 只当文字：名单会显示，但这两个人没有身份（拿不到个人分）
+101/李四          ← 混着写也行：101 关联到人，李四只当文字
+```
+
+几条要记住的：
+
+- ⚠️ **号码布要单独成一段**：`张三（101）` 这种「姓名和号码布写在同一段」的写法**认不出人**（系统只拿整段去比对号码布），要写成 `张三/101`，或者干脆只写 `101`。**推荐只写号码布**；
+- **号码布是运动员的唯一标识，不看单位**：号码布认到的是**别的单位**的人时，**照常关联**，并在导入结果里给一条提示让你核对号码布是不是写错了（不是冲突、不拦截）；
+- **认不出人的段不报错**：没录档案的临时队员、写错的名字，都只当文字留在名单里（这条报名仍然只有单位、没有队员身份）；
+- **同一格里同一个号码布写两次**：只关联一次，并给一条提示（同一条报名里一个人只占一个位置）；
+- **个人行（填了姓名的那几行）这一列只当文字**：个人报名自己就是那个人的身份，不存在「队员」。这一格里写了号码布也不关联，只会给一条提示；
+- **一条报名最多关联 30 个人**：超过的那一行会被**整行拦下**（多半是把号码布写错了位置）；
+- **老数据的人要补挂**：升级前已经报好的团体报名，如果当时只写了姓名（或连姓名都没写），**升级时会尽力按「号码布 → 姓名 + 单位」回填一次**；**回填不上的，要重新导入一份写着号码布的名单，或到录入页手动挂人**（见[使用手册 · 4.13](./使用手册.md)）。
+
 ### `squad` 队伍 —— 可选（表的最后一列）

 **这一列只在「同一个单位在同一个组别派了不止一支队」时才需要填**，比如羽毛球双打：一个单位报了一队、二队，两队可能各占一个名次。
@@ -220,7 +246,7 @@ F1+F2

 ---

-## 四、五个完整例子
+## 四、六个完整例子

 ### 例 1：个人项目（七单位 × 若干人）

@@ -289,6 +315,24 @@ F1+F2
 - 显示上写成 **`第一分公司一队` / `第一分公司二队`**（单位名后面直接跟队名，不加括号不加分隔符）；**单位总分榜、单位奖牌榜、个人积分榜上只写 `第一分公司`**（两队的分数都已经算进这个单位的总分）；
 - 报了之后想改队名**不用删掉重建**：到「成绩录入」页点那一行的「单位」格，在弹窗里改（见[使用手册 · 4.12](./使用手册.md)）。⚠️ **改完记得把这张表里的队名也改成一样**——以后再导一份还写着旧队名的表，会**新增出旧队名那一条报名**（导入是按「小项 + 组别 + 单位 + 队名」认人的）。

+### 例 6：同一支队里的两个队员（队员名单写号码布）
+
+`BD` 羽毛球双打、`男子组`，F1 的「一队」是张三（号码布 `101`）与李四（号码布 `102`）；F2 那支队只报了单位、没写队员：
+
+| event_code | category | team_code | athlete_name | id_card | gender | age | bib | seed | heat | status | member_names | squad |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| BD | 男子组 | F1 |  |  |  |  |  |  |  | registered | 101/102 | 一队 |
+| BD | 男子组 | F2 |  |  |  |  |  |  |  | registered |  |  |
+
+要点：
+
+- **队员名单里写号码布，系统才认得出队里坐着谁**：`101/102` → 这条报名关联到张三、李四两个人。**该项目配了「个人通道」时，两个人各拿一份完整的个人分、各一枚个人奖牌，都上个人积分榜**（是「每人各一份」，不是两个人分同一份）；
+- **单位总分与单位奖牌不受影响**：上不上的开关在「计分通道」里（`计入单位总分` / 个人奖牌是否并入单位榜）。**双打现场通常都设成「不计入」**——个人分给到人，单位那本账不变；
+- **只写姓名（`张三/李四`）也合法**：名单照常显示，但**这两个人没有身份**——拿不到个人分、上不了个人榜，也**不报错**。要让他们上榜，把这一格改成他们的**号码布**（`101/102`），或到录入页手动挂人（见[使用手册 · 4.13](./使用手册.md)）；
+- ⚠️ **号码布要单独成段**：写成 `张三（101）/李四（102）` **认不出人**（系统拿整段去比号码布）。要「名字 + 号码布」都看得见，就先写号码布（`101/102`）——导出件与录入页会自己显示成 `张三（101）、李四（102）`；
+- **号码布写错成别的单位的人**：照号码布关联，并给一条提示让你核对（号码布是唯一标识，系统不按单位猜）；
+- **F2 那一行留空**：只报单位、没有队员身份，这是合法的，也是升级前所有团体报名的样子。
+
 ---

 ## 五、导入前请先检查（自检清单）
@@ -306,6 +350,7 @@ F1+F2
 - [ ] `heat` 要么留空，要么是 1–999 的整数（不参与算分，只是录入分组）
 - [ ] **联队**（两个单位联合参赛）写的是 `F1+F2` 这种形状：加号两边都有编码、**同一个单位没写两遍**、成员不超过 5 个；**加号左边那个是主单位**（见第三节）
 - [ ] **「队伍」列**（最后一列）只在**同一个单位派了不止一支队**时才填：两队写了**两个不一样的队名**（都写一样或都留空会被拦下）；只有一支队的单位留空即可；**个人行（有姓名的行）没有填队名**（填了也不会写进库里，只给一条提示）
+- [ ] **要让队员拿到个人分**：`member_names`（队员名单）里写的是**单独的号码布**（`101/102`），不是姓名、也不是 `张三（101）` 这种混写；号码布抄对（写错会关联到别人，系统会提示但不会拦）
 - [ ] 全表没有因为"怕麻烦"把某些列删掉——**表头 8 个必须列一个都不能少**（哪怕整列是空的）
 - [ ] 用的是**分工作表模板**时：每张工作表的名字都是「小项名称@组别名称」、没有多余的工作表；「项目编码 / 组别」两列要么整列留空、要么与表名一字不差（见第八节）

@@ -331,6 +376,11 @@ F1+F2
 | 第 N 行：单位 A 在本组别已经有一条队伍「一队」的报名：「同一个单位同一个组别的同一个队」只能报一条；要派两个队请换一个队伍名（例如 二队） | 同一个单位、同一个组别、**同一个队名**写了两遍（两支队要写两个不同的队名） | 把其中一行的「队伍」列改成另一个队名（`一队` / `二队`）；如果本来就是同一支队、只是想把队员名单补全，改完重导**不会新增**（同一单位同一队名是更新） |
 | 第 N 行：单位 A 在本组别已经有一条不分队的团体报名：队伍列留空就是不区分队伍，一个单位在一个组别只能有一条；要派两个队请在队伍列分别写清（例如 一队 / 二队） | **两行的队伍列都留空**（等于都说「这个单位在这个组别只有一支队」），或者库里以前报过一条不分队的、这行又留空 | 要派两支队就在两行的「队伍」列分别写 `一队` / `二队`；确实只有一支队，就把多余的那一行删掉 |
 | 第 N 行：单位 A 在本组别已经有这个人的报名：同一个人在同一组别只能报一条，请把重复行合并后再导入 | **个人行**（填了姓名的行）在同一个小项同一个组别里写了两次。个人报名按「人」唯一，队伍列不参与（也不影响）这件事 | 把两行合并成一行；同一个人要参加两个项目就写在**不同小项**里，不能靠队名分成两条 |
+| 第 N 行：队员名单里认出了 31 名运动员，超过一条报名最多 30 人：请检查这一格是不是把号码布写错了位置 | 这一格里能对上号码布的段**超过 30 个**（多半是把别的内容写进去了） | 核对这一格：一条报名最多 30 个队员；只有一支队时这一格留空即可。**这一行整行未导入** |
+| 第 N 行：队员名单里的号码布 101 写了两次，只关联一个人（同一条报名里一个人只占一个位置） | 同一格里同一个号码布写了两次 | 不算错误（照常导入、只关联一次）；把这一格里重复的那个号码布删掉即可 |
+| 第 N 行的队员名单里有 2 个号码布认得出人，但这一行有运动员姓名、按个人报名处理：队员只对团体报名（不填姓名那几行）生效，这一格只作文字名单保留，没有关联到人 | **个人行**（有姓名的行）里写了号码布。个人报名自己就是那个人的身份，不存在「队员」 | 不算错误（这一行照常导入，只是**没有**建立队员关联）；团体报名的那一行才需要写号码布 |
+| 第 N 行：队员名单里的号码布 205 是单位 F3 的 李四，本行报名挂在单位 F1 名下 —— 号码布是运动员的唯一标识，已按它关联为队员，请核对号码布是否写错 | 号码布认到的是**别的单位**的人。号码布是唯一标识，系统**照它认、不看单位** | 先核对号码布有没有抄错：抄错了改成正确的号码布；**确实就是借调/跨单位的人**，这条提示可以忽略（关联已经生效） |
+| **（没有报错，但名单里的人上不了个人榜）** | 队员名单里写的是**姓名**（例如 `张三/李四`），或号码布写成了 `张三（101）` 这种「姓名 + 号码布写在同一段」的形式 —— 系统拿**整段**去比号码布，认不出人 | 这是**正常行为**（不报错）：把这一段改成**单独的号码布**（`101/102`），队员才会被关联、才会拿到个人分。要「姓名 + 号码布」都显示，直接写号码布即可（导出件与录入页会显示成 `张三（101）`） |
 | 第 N 行：组别 XXX 不存在 | 组别名和系统里不一致，或该小项还没有这个组别 | 到「基础数据 → 组别」核对名称（注意别多字少字） |
 | 第 N 行：小项 XXX 没有组别 | 该小项一个组别都没配 | 先在「组别」里配好，再导入 |
 | 第 N 行：填写了 athlete_name 就必须填 id_card 或 bib | 个人行缺两项标识 | 补证件号或号码布；确实都没有的，请先在「运动员」里登记 |
@@ -436,7 +486,7 @@ Excel 对工作表名有硬限制：**最长 31 个字符**，同一份工作簿
 > 2. **一个人一行**；一个人报几项就写几行；
 > 3. `event_code`（小项）、`team_code`（单位）、`category`（组别）照抄系统里配好的，不自己编；
 > 4. 每人要有**证件号或号码布**，至少一个；**证件号是系统认人的第一依据**（有就优先填、填准、别和人重号）；没有证件号时号码布顶替它认人，**号码布也不能给两个人**；
-> 5. 团体项目：姓名列留空，队员写进 `member_names`，多人用 `/` 隔开；
+> 5. 团体项目：姓名列留空，队员写进 `member_names`，多人用 `/` 隔开——**写号码布（`101/102`）才会关联到人、才拿得到个人分**，只写姓名就只是文字名单；
 > 6. 拿不准的列**留空**，不要写「无」「/」「—」这类符号；
 > 7. 表里**不要合并单元格**、不要加标题行、不要插图；
 > 8. 填完先对着第五节的清单自查一遍，再发给收表人；