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` 两张）。
This commit is contained in:
AskaEth committed
1 parent
7a3e4ad365
commit
99c91f99f7
57 files changed
+4903
-94
No files matched your search
+54
-4
@@ -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. 填完先对着第五节的清单自查一遍，再发给收表人；
|
||||
|
||||
Reference in new issue
Block a user