feat(joint-team): 联队 + 份额分成 —— 迁移 0024、引擎按份额拆、导出 / 大屏 / 录入三路打通；版本 dev_0.5.3

## 需求
现场 6 项球类比赛里，有两个单位因参赛人数不足**合并成一个单位参赛**。
做法不是新建「联队单位」（那样榜单会多出第 8 个单位，且分和奖牌分不到原单位头上），
而是**一条报名挂多个单位、按份额拆**。

## 拍板口径
- 份额**可配、默认均分**
- 积分**平均拆、接受 .5**（团体第 1 名 15 分 → 两个单位各 7.5 分）
- 奖牌**各记一枚**（两个单位各 1 枚完整金牌，不是各 0.5 枚）
- 显示上把联队名字写全（形如 `第一分公司+第二分公司联队`），成员单位的 logo 都放
- 导入表里单位编码写 `A+B`

## 一、核心层（数据模型 + 引擎 + 存储 + 报名写入 + 导入解析）
- 迁移 `0024_entry_team_shares.sql`：新建 `entry_team_shares(entry_id, team_id, points_share,
  medal_share, sort_order)`。**两个口径分开表达**是刻意的——积分要拆成小数（7.5）、奖牌要整枚
  各记，用一个数表达就会把「7.5 分」和「半枚金牌」绑在一起，奖牌榜立刻错。
  `entries.team_id` 保留为**主单位**；老数据 `INSERT OR IGNORE` 回填成「主单位独占 100%」。
- 引擎：`ResolveShares`（引擎与读侧共用）、`splitSharePoints`（按权重归一、**末位吞余数**，
  各份之和恒等于原来那一份）、`TeamShare.Medal`（缺省整枚）。积分按权重拆，奖牌每个份额各记整枚。
- 报名写入：`PUT /api/entries/{id}/team-shares`（recorder 及以上，保存后当场重算该小项组别并推榜）。
- 导入：`team_code` 支持 `A+B`（主单位 = 加号左边，均分，奖牌各整枚）；非法形态
  （`A+` / `+B` / `A++B` / `A+A` / 成员 >5 / 单位不存在）**行级拦下、不落库**，给人话报错。

## 二、导出与导入模板
- 11 份导出件：联队写全成员单位（`第一分公司+第二分公司联队`），并注明**分拆给了哪几家、各多少**
  （份额占比 + 各单位实得积分，取自按份额拆完的流水）。
- 单位奖牌明细：奖牌格写「金牌（联队 …，各单位各记 1 枚）」；含联队时副标题说明
  「各单位奖牌数之和会大于实际颁发数」——这是口径 3 的必然结果，**不是 bug**。
- 按单位筛选导出把成员单位一起算上（否则 B 单位导自己的名单会看不到自己参加的那场联队比赛）。
- 分工作表模板：`A+B` 写法挂在「单位编码」表头的**单元格批注 + 输入提示**（中英各一份）；
  **表头文字、列序、12 列、工作表命名一个字未动**（动了模板就导不回去）。

## 三、前端与大屏
- 录入页 / 复核页「单位」列：联队显示 `联队 第一分公司 67%（权重 2） 第二分公司 33%`，
  点该格打开「成员单位与份额」弹窗（加/删成员、改权重、主单位徽标、实时比例预览）。
  **普通报名（单单位）的文案、元素、类名一字未动**，只多了一个 `@click` 入口与悬停提示。
- 大屏：分项成绩 / 实时赛况单位列显示联队全名并**放上两个单位的 logo**（单位列宽按该行的
  logo 数留位）；底栏同理。

## 四、验证（都留了证据）
- **老数据逐字节不变**（改算分引擎的硬门槛）：引擎层 golden `a2aa1c97…`、接口层 golden
  `aa6cea37…`，两个哈希由主会话**在修前树上亲手重跑确认**；导出层另有 11 份导出件逐行对拍，
  差异 **0 处**。
- 前端 773 → **809 例**全绿（旧用例一行未改）；服务端 14 包两轮全绿；Console 68 例全绿。
- 真机联调：录入页份额弹窗、大屏两个 logo、奖牌榜 A/B 各 1 金、写路径（移除成员 → 保存 → 200）。

## 五、版本
`dev_0.5.2` → **`dev_0.5.3`**（本批含数据迁移 0024 + 新功能，必须与上一包区分开）；
安装器素材重生成（版本号烙在位图里，实测只有 `brand.bmp` 的 1x/2x 两张变化，其余 92 张逐字节未变）。

docs/报名名单导入规范.md

@@ -54,7 +54,7 @@
 |---|---|---|---|
 | `event_code`（项目编码） | **必须** | 小项编码，抄系统里配好的 | `M100` |
 | `category`（组别） | **必须** | 组别**名称**（中文，要跟系统里一字不差） | `男子30岁以下` |
-| `team_code`（单位编码） | **必须** | 参赛单位编码，抄系统里配好的 | `F1` |
+| `team_code`（单位编码） | **必须** | 参赛单位编码，抄系统里配好的。**两个单位联合参赛（联队）就写 `A+B`**，见第三节 | `F1`；联队写 `F1+F2` |
 | `athlete_name`（姓名） | **必须** | 运动员姓名。**团体项目这一列留空** | `张伟` |
 | `id_card`（证件号） | 可选 | 证件号（身份证号）。**系统的第一认人依据**；一个证件号只能属于一个人 | `110101199001011234` |
 | `gender`（性别） | 可选 | 性别，只写「男」或「女」 | `男` |
@@ -88,6 +88,39 @@
 在系统「基础数据 → 参赛单位」里给每个大单位配的**编码**，比如 `F1`、`F2`。系统里没有的会提示「单位 XXX 不存在」。
 被「彻底删除」的单位，导入时若再次用到它的编码，它会**重新出现（复活）**，这一行照常导入——单位编码是唯一的，系统按编码复用原来那条记录，它以前的报名、成绩与积分都还在。
 
+**两个单位联合参赛（联队）怎么写**
+
+同一小项组别里，两个单位合起来出一支队参赛时，**这一格写两个编码、中间用 `+` 连起来**：
+
+```
+F1+F2
+```
+
+- **加号左边那个是「主单位」**：名次与榜单的归属主体就是它。`F1+F2` 与 `F2+F1` 是**两条不同的报名**（主单位不同），同一组别里只写一条即可；
+- **全角 `＋` 与两侧空格都认**：`F1＋F2`、`F1 + F2` 与 `F1+F2` 是同一个意思（中文输入法下打出来的常是全角）；
+- **默认均分**：两个单位各占一半（50% / 50%）。团体第 1 名 15 分 → 两个单位**各 7.5 分**；奖牌**两边各记一枚整枚**（联队的金牌，F1、F2 各记 1 枚）；
+- ⚠️ **想改成非均分（例如 2:1）不能在表里写**：导入表只表达「是哪几个单位」。份额要等导入完到「成绩录入」页**点那一行的「单位」格**，在「成员单位与份额」弹窗里改（见[使用手册 · 4.11](./使用手册.md#411-联队两个单位合并参赛)）；
+- **一个联队最多 5 个单位**；成员单位一个都不能写错——写错的那一行会被拦下，其余行照常导入；
+- **加号两边都必须有编码**，而且同一个单位不能写两遍。
+
+**怎么写会被拦下（逐行报错，其余行照常导入）**
+
+| 写成 | 报错 |
+|---|---|
+| `F1+` / `+F2` / `F1++F2` | `第 N 行：单位编码 F1+ 里有一段是空的：联队要写成两个单位编码用 + 连起来（例如 A+B）` |
+| `F1+F1` | `第 N 行：单位编码 F1+F1 里同一个单位出现了两次：联队的每个单位只能写一次` |
+| `F1+F2+F3+F4+F5+F6` | `第 N 行：单位编码 F1+F2+F3+F4+F5+F6 里写了 6 个单位：一个联队最多 5 个单位` |
+| `F1+ZZ`（`ZZ` 不存在） | `第 N 行：单位 ZZ 不存在（来自联队编码 F1+ZZ）` |
+| `ZZ`（单个单位，写法没变） | `第 N 行：单位 ZZ 不存在` |
+
+> 报错都写在**行号**上，并把你那一格**原样打出来**——照那句话改那一行即可，不用重传整张表。
+
+**导入之后长什么样**
+
+- 联队仍是一条报名，但**分与奖牌都按份额记给各成员单位**：单位总分榜、单位奖牌榜上 A、B 各有一份；
+- 大屏和导出件里写的是**联队的名字**：`第一分公司+第二分公司联队`，报名名单导出的「单位编码」列也回写成 `F1+F2`（**导出的名单可以直接拿去重导**，不用手工改回单个单位）；
+- 用成员单位筛「报名名单」导出时，**也能看到这条联队报名**（否则 B 导出自己的名单会以为没派人上场）。
+
 ### `athlete_name` 运动员姓名
 - **个人项目**：填姓名，必填。
 - **团体项目**：**这一列留空**，表示"这是某个单位的一条团体报名"，队员写在 `member_names` 里。
@@ -163,7 +196,7 @@
 
 ---
 
-## 四、三个完整例子
+## 四、四个完整例子
 
 ### 例 1：个人项目（七单位 × 若干人）
 
@@ -195,6 +228,24 @@
 
 这类项目（比如团体引体向上）**按个人报名填**：每人一行、填姓名和单位。系统会自己算两份成绩——个人的名次分记在个人身上，团体分按各队成员的**平均成绩**排名后算给单位。**不需要**再单独写团体行。
 
+### 例 4：两个单位联合参赛（联队）
+
+本届运动会 6 项球类比赛里，**F2 与 F5 因参赛人数不足，合并出一个队参赛**。`BALL` 是篮球、`男子组`：
+
+| event_code | category | team_code | athlete_name | id_card | gender | age | bib | seed | heat | status | member_names |
+|---|---|---|---|---|---|---|---|---|---|---|---|
+| BALL | 男子组 | F1 |  |  |  |  |  |  |  | registered | 张三/李四 |
+| BALL | 男子组 | F2+F5 |  |  |  |  |  |  |  | registered | 王五/赵六/钱七 |
+| BALL | 男子组 | F3 |  |  |  |  |  |  |  | registered | 孙八 |
+
+要点：
+
+- **写一条 `F2+F5` 的报名就够了**，不要 F2、F5 各写一条（那会变成两队人上场）；也不要新建一个叫「F2F5」的单位；
+- `F2` 在**加号左边**，所以 **F2 是主单位**：这一条的名次与榜单以它为主体。写成 `F5+F2` 是另一条报名（主单位变成 F5），同一组别里只写一种；
+- 默认**均分**：这条成绩拿到的分，F2 与 F5 **各一半**（团体第 1 名 15 分 → 各 7.5 分）；奖牌**两边各记一枚整枚**（一块金牌，F2 榜上 1 枚、F5 榜上 1 枚）；
+- 要改成 **2:1** 这类非均分：**不能在这张表里写**，导入后到「成绩录入」页点那一行的「单位」格改（见[使用手册 · 4.11](./使用手册.md#411-联队两个单位合并参赛)）；
+- 大屏与导出件里写的是 `第二分公司+第五分公司联队`，报名名单导出的「单位编码」列回写成 `F2+F5`（可以直接拿去重导）。
+
 ---
 
 ## 五、导入前请先检查（自检清单）
@@ -210,6 +261,7 @@
 - [ ] 每个证件号在系统里只属于一个人，别和别人的档案重号
 - [ ] `status` 只用那 4 个英文词（大小写都行）或第三节列的中文别名，不写别的词；拿不准就留空
 - [ ] `heat` 要么留空，要么是 1–999 的整数（不参与算分，只是录入分组）
+- [ ] **联队**（两个单位联合参赛）写的是 `F1+F2` 这种形状：加号两边都有编码、**同一个单位没写两遍**、成员不超过 5 个；**加号左边那个是主单位**（见第三节）
 - [ ] 全表没有因为"怕麻烦"把某些列删掉——**表头 8 个必须列一个都不能少**（哪怕整列是空的）
 - [ ] 用的是**分工作表模板**时：每张工作表的名字都是「小项名称@组别名称」、没有多余的工作表；「项目编码 / 组别」两列要么整列留空、要么与表名一字不差（见第八节）
 
@@ -228,6 +280,10 @@
 | 无法解析 CSV：表格里多半有没配对的双引号 | 格子里**手工**写了双引号，或只有一个引号没配对 | 让 Excel 重新另存一次（引号由 Excel 按规则加，别手工写）；确实需要引号的，写成 `""` 转义 |
 | 第 N 行：小项 XXX 不存在 | `event_code` 写错，或该小项还没在系统里配 | 到「基础数据 → 大项 / 小项」核对编码；没配的先配 |
 | 第 N 行：单位 XX 不存在 | `team_code` 写错，或该单位还没配 | 到「基础数据 → 参赛单位」核对 |
+| 第 N 行：单位 ZZ 不存在（来自联队编码 F1+ZZ） | 这一格写的是**联队** `F1+ZZ`，其中 `ZZ` 没配 | 核对加号右边那个编码（括号里把**整格**原样打出来了，一眼看出是哪一段没对上）；不改联队写法的话，就照单单位的办法核对编码 |
+| 第 N 行：单位编码 F1+ 里有一段是空的：联队要写成两个单位编码用 + 连起来（例如 A+B） | **加号有一边是空的**（`F1+`、`+F2`、`F1++F2` 都是这一条）。多半是填一半或多了个加号 | 补上缺的那个编码，或删掉多余的加号；联队至少两个单位 |
+| 第 N 行：单位编码 F1+F1 里同一个单位出现了两次：联队的每个单位只能写一次 | 同一个单位在联队里写了两遍（`F1+F1`） | 一个单位只写一次；两个单位联合参赛就是 `F1+F2` |
+| 第 N 行：单位编码 … 里写了 6 个单位：一个联队最多 5 个单位 | 加号太多、成员超过 5 个 | **一个联队最多 5 个单位**；现场最多见过三个单位合并，超过 5 个多半是这一格填错了东西（例如整格都是加号） |
 | 第 N 行：组别 XXX 不存在 | 组别名和系统里不一致，或该小项还没有这个组别 | 到「基础数据 → 组别」核对名称（注意别多字少字） |
 | 第 N 行：小项 XXX 没有组别 | 该小项一个组别都没配 | 先在「组别」里配好，再导入 |
 | 第 N 行：填写了 athlete_name 就必须填 id_card 或 bib | 个人行缺两项标识 | 补证件号或号码布；确实都没有的，请先在「运动员」里登记 |
@@ -292,6 +348,7 @@
 - **「项目编码」「组别」两列可以整列留空**——表名已经说明了是哪个小项、哪个组别；
   一旦填了，就**必须与表名一致**，不一致的那一行会报错并跳过（系统不猜、也不会挑一个用）；
 - 其余列与单表模板完全一样（第三节逐列说明照样适用）；
+- **下载下来的模板自带「联队怎么写」的说明**：分工作表模板里，「单位编码」**表头那一格有单元格批注**（鼠标停上去弹出，右边带一个小红三角），**该列每一格还有输入提示**（点中格子就弹出来）；中文表头、英文表头各一份，内容就是 `A+B` 这套写法（加号左边是主单位、积分平均分、奖牌两边各记一枚）。**说明只挂在批注与输入提示上，不占任何一格数据、也不改表头与列序**——填好的表原样传回来照样导入；
 - **只填了表头、没填人的那张表**会被跳过并给一条提示（= 这个组别没人报名），其余表照常导入；
 - 不要在工作簿里加「说明」之类的工作表：**只要工作簿里有一张表名带 `@`**，整份文件就按分工作表模板处理，
   其它表名（例如 `Sheet1`、`备注`）必须也是「小项名称@组别名称」的形状，否则**整份拒绝**并点名是哪张表——
@@ -337,6 +394,7 @@ Excel 对工作表名有硬限制：**最长 31 个字符**，同一份工作簿
 > 7. 表里**不要合并单元格**、不要加标题行、不要插图；
 > 8. 填完先对着第五节的清单自查一遍，再发给收表人；
 > 9. **批次（`heat`）**可以不填；要分批比赛就填 1–999 的整数，它只影响录入时怎么分组找人，**不影响成绩与名次**；
-> 10. **存成什么格式**：Excel →「另存为」→「**CSV UTF-8 (逗号分隔) (*.csv)**」最稳；中文 Excel 默认的「CSV (逗号分隔)」也能用。**别用「Unicode 文本」（UTF-16）**，**别手工改名或把两个文件拼起来**，也别在格子里手写双引号（让 Excel 自己加）。
+> 10. **两个单位联合参赛（联队）**：`team_code` 那一格写 `F1+F2`（加号左边是主单位，默认均分，最多 5 个单位），**不要**新建一个「联队单位」、也不要两个单位各写一行；非均分（例如 2:1）要在导入后到「成绩录入」页点那一行的「单位」格改；
+> 11. **存成什么格式**：Excel →「另存为」→「**CSV UTF-8 (逗号分隔) (*.csv)**」最稳；中文 Excel 默认的「CSV (逗号分隔)」也能用。**别用「Unicode 文本」（UTF-16）**，**别手工改名或把两个文件拼起来**，也别在格子里手写双引号（让 Excel 自己加）。
 >
 > 一句话：**下载模板 → 只往下面粘数据 → 另存为 CSV UTF-8 → 上传**。中间任何一个"顺手改一下"都可能让整份表被拦下。