AskaEth
99c91f99f7
## 需求（主人原话）
> 「双打我给他定义的是团队赛事，团队赛事不应该本来就是可以配置多个人的吗」
> 「把队员身份证留住，**应该是服务于整个团体报名**」
**现状问题**：界面（`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` 两张）。
70 lines
5.2 KiB
SQL
70 lines
5.2 KiB
SQL
-- 团体报名的「队员身份」（devdocs/20 的实现）。
|
||
--
|
||
-- 背景：双打这类团体 / 对抗项目，界面本来就能一次勾多个运动员（EntryPicker），但提交时只把
|
||
-- 姓名拼成文字写进 entries.member_names —— 系统只知道「这条报名属于某单位」，不知道队里坐着谁，
|
||
-- 于是所有配了个人通道的团体项目都给不出个人分、个人奖牌，上不了个人积分榜。
|
||
--
|
||
-- 表达方式：**队员是报名的人员关联，不是新的一条报名**。一条团体报名 0..N 个队员
|
||
-- （0 个 = 只报单位，与升级前逐字节一致）。队员与「队伍」（0025 的 entries.squad）是两个
|
||
-- 正交的维度：squad 是「这个单位派的第几支队」，队员是「这支队的队员是谁」，可以叠加。
|
||
-- **报名唯一键 (category_id, team_id, squad) WHERE athlete_id IS NULL 一个字都不动**：
|
||
-- 队员不参与报名去重（同一个人在同一组别的两条报名里出现是允许的，见 devdocs/20 §五）。
|
||
--
|
||
-- member_names 保留：它是**显示用的文字名单**（导出、大屏、录入页都读它），老数据靠它，
|
||
-- 也是「人没录档案、只登记不关联」的降级形态。人员身份只认这张表。
|
||
--
|
||
-- 老数据回填（尽力而为，匹配不上就不关联，绝不硬猜）：
|
||
-- 1) 号码布优先：member_names 里的每一项先按 athletes.bib 认人（0014 有部分唯一索引，
|
||
-- 号码布是运动员的唯一标识）；
|
||
-- 2) 其次「姓名 + 单位」，且**同单位同名的人只有一个**时才认（重名留给人工确认）；
|
||
-- 3) 其余留空 = 维持升级前的行为（只报单位，上不了个人榜）。
|
||
-- 回填只在升级那一刻做一次（写进 schema_migrations），不会在每次启动时重跑。它是
|
||
-- INSERT OR IGNORE：万一被重放（schema_migrations 少了一行被补跑），已有的关联——包括人工
|
||
-- 确认过的——一行都不会被覆盖或重复，最多补上「还没有的关联」（与 0024 的份额回填同一口径）。
|
||
-- 回填只碰**纯团体报名**（athlete_id IS NULL）：带运动员的报名本来就带身份，不需要队员。
|
||
--
|
||
-- 回填之后，配了个人通道（scope=athlete）的老团体项目会开始给队员发个人分 / 个人奖牌
|
||
-- ——这正是本单的目的；**单位维度（单位总分、单位奖牌）不受影响**（见 domain 侧的口径与
|
||
-- httpapi 的端到端对拍）。只配了团体通道的球类项目（现场绝大多数）一个字节都不变。
|
||
|
||
CREATE TABLE IF NOT EXISTS entry_athletes (
|
||
entry_id INTEGER NOT NULL REFERENCES entries(id) ON DELETE CASCADE,
|
||
athlete_id INTEGER NOT NULL REFERENCES athletes(id) ON DELETE CASCADE,
|
||
-- 展示与流水顺序都用它：写侧按请求给的顺序编号，老数据回填按 member_names 里的书写顺序。
|
||
-- 名次与积分不依赖顺序（每个队员各拿一整份），它只影响「队里有谁」的排列。
|
||
sort_order INTEGER NOT NULL DEFAULT 0,
|
||
-- 同一条报名里同一个人只能出现一次（重复 = 同一条成绩给同一个人记两份分、两枚牌）。
|
||
PRIMARY KEY (entry_id, athlete_id)
|
||
);
|
||
|
||
-- 不另建 entry_id 索引：主键 (entry_id, athlete_id) 的索引已经以 entry_id 打头，
|
||
-- 读侧的「按小项批量取队员」走的正是它（与 0024 的份额表同一个取舍）。
|
||
-- athlete_id 上的级联删除（人员被彻底删除时带走关联行）走全表扫描，但这张表只有报名量级。
|
||
|
||
-- 回填 1：号码布优先。member_names 里写号码布（导入规范允许）时按号码布认人。
|
||
-- json_valid 的守卫是必须的：member_names 在库里是 JSON 数组文本，但历史上不排除被手工写成
|
||
-- 别的样子；json_each 遇到坏 JSON 会直接报错，那会让整个升级失败、现场开不了机。
|
||
-- 坏值按「没有名单」处理（'[]'），等价于不回填这条报名。
|
||
INSERT OR IGNORE INTO entry_athletes (entry_id, athlete_id, sort_order)
|
||
SELECT e.id, a.id, je.key
|
||
FROM entries e
|
||
JOIN json_each(CASE WHEN json_valid(e.member_names) THEN e.member_names ELSE '[]' END) AS je
|
||
JOIN athletes a ON a.bib = TRIM(je.value)
|
||
WHERE e.athlete_id IS NULL
|
||
AND TRIM(COALESCE(je.value, '')) <> '';
|
||
|
||
-- 回填 2：姓名 + 单位。同单位同名不止一个时（重名）不认——猜错会把分记到另一个人头上，
|
||
-- 而人还能事后在界面上补；猜错的分却已经上了榜。
|
||
INSERT OR IGNORE INTO entry_athletes (entry_id, athlete_id, sort_order)
|
||
SELECT e.id, a.id, MIN(je.key)
|
||
FROM entries e
|
||
JOIN json_each(CASE WHEN json_valid(e.member_names) THEN e.member_names ELSE '[]' END) AS je
|
||
JOIN athletes a ON a.name = TRIM(je.value) AND a.team_id = e.team_id
|
||
WHERE e.athlete_id IS NULL
|
||
AND TRIM(COALESCE(je.value, '')) <> ''
|
||
-- 上面那条已经按号码布认过人时不再按姓名认第二遍（同一条报名里同一个人只能一行，主键兜着，
|
||
-- 这条只是让「认了谁」这件事一眼可读）。
|
||
AND NOT EXISTS (SELECT 1 FROM entry_athletes ea WHERE ea.entry_id = e.id AND ea.athlete_id = a.id)
|
||
AND (SELECT COUNT(*) FROM athletes a2 WHERE a2.name = TRIM(je.value) AND a2.team_id = e.team_id) = 1
|
||
GROUP BY e.id, a.id;
|