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

@@ -102,6 +102,8 @@
 
 表格列依次为：勾选框、录入（状态徽标）、号码、批次、单位、运动员 / 队、成绩输入、名次、状态、积分（自动）、备注、操作。**「运动员 / 队」这一列在姓名后面直接跟着该人的号码布**（灰色小字，例如 `张伟 101`）：号码列仍然保留，这一处只是省得在长表格里左右横跳找号。
 
+**「单位」这一列兼作「成员单位与份额」的入口**：普通报名显示单位简称（或全称）——**这一格与以前长得一模一样**，只是鼠标移上去变成手型、旁边有一行悬停提示，**点一下**会打开「成员单位与份额」弹窗（什么单位参赛、各占多少，见 4.11）。一条报名挂了多个单位（**联队**，两个单位因人数不足合并参赛）时，这一格会多一个「联队」小标，并把成员单位与份额逐条列出来：`联队 第一分公司 50% 第二分公司 50%`；不是均分时还会带上权重，例如 `联队 第一分公司 67%（权重 2） 第二分公司 33%`。
+
 | 列 | 操作 |
 | --- | --- |
 | 成绩输入 | 直接输入成绩；工具栏会提示当前单位（秒 / 米 / 次 / 分），成绩格比过去更宽，四位数也看得全；打字时格子旁边会浮出一个小提示（见下） |
@@ -272,6 +274,45 @@
 
 > 需要先「存草稿」再动这些入口：修改 / 作废 / 退回会重算并整表刷新，未保存的编辑会被刷新覆盖，页面会拦下并提示。
 
+### 4.11 联队（两个单位合并参赛）
+
+有些项目**两个单位因参赛人数不足，合并成一个单位参赛**。这种情况**不要新建一个「联队单位」**——那样榜单会多出一个单位，联队拿到的分与奖牌也分不到原单位头上。正确做法是**一条报名挂多个单位、按份额分成**：榜单仍然是原来的单位数，分数与奖牌按份额记给各单位，联队的名字在大屏与导出件上写全。
+
+**三个口径（赛会已定，录之前先知道）**
+
+| 口径 | 怎么写 |
+| --- | --- |
+| 份额 | **可配、默认均分**：两个单位各占一半（50% / 50%）；要改成别的比例（例如 2:1）就填权重 |
+| 积分 | **平均拆，接受 .5**：团体第 1 名 15 分 → 两个单位**各 7.5 分**（榜单上就写 7.5） |
+| 奖牌 | **每个成员单位各记一枚整枚**：联队的金牌，两个单位**各记 1 枚**（不是各 0.5 枚） |
+
+> ⚠️ 由此产生一个**必须知道**的结果：**各单位的奖牌数之和会大于实际颁发的奖牌数**。A、B 联队拿 1 枚金牌，奖牌榜上 A 记 1 金、B 记 1 金，而场上只颁发了 1 枚。**这是定稿口径，不是数据错了**；拿奖牌数去和实际颁发的奖牌核对时请记住这一点。导出件的「总表 / 单位奖牌明细」副标题里也写着这句话。
+
+**怎么配（两个入口）**
+
+1. **导入报名表时**：把「单位编码」那一格写成 `A+B`（例如 `F1+F2`）——**加号左边那个是主单位**（名次与榜单的归属主体），全角 `＋` 与两侧空格都认。默认均分；一个联队最多 5 个单位。写法与报错见[报名名单导入规范 · 第三节](./报名名单导入规范.md)；
+2. **导入之后在界面上改**：到「成绩录入」页**点那一行的「单位」格**（复核页只读，改份额在录入页），打开「成员单位与份额」弹窗。要改成非均分（例如 2:1）**只能在弹窗里改，导入表里写不了**。
+
+**「成员单位与份额」弹窗怎么用**
+
+1. 弹窗里每个成员单位一行：**编码 / 单位全称 / 「主单位」徽标 / 权重输入框 / 移除**；
+2. 权重是**相对权重**：都留空（或填 0）就是**均分**（各 50%），填 `2` 与 `1` 就是 **67% 与 33%**；
+3. 底部「**添加成员单位…**」下拉里选一个单位再点「添加」——下拉里列的是还没在成员里的单位（**已停用**的单位也可以加，会标注「已停用」；被「彻底删除」的单位不出现）；
+4. 弹窗下方实时显示 `当前比例：第一分公司 50% · 第二分公司 50%`，两个以上成员时旁边还会给出联队名预览（`第一分公司+第二分公司联队`）；
+5. **主单位不能去掉**（它的「移除」是灰的）：报名挂在它名下，要换主单位只能重新建报名；
+6. 点 **「保存成员单位」** 提交——服务端**当场重算该小项该组别**的名次与积分并刷新大屏榜单，提示「成员单位已保存」。**没改动时保存按钮是灰的**，点「关闭」不会发出任何请求。
+
+**要注意的**
+
+- **权限**：读得到成绩的人都能看见这一格；**能改的是录入员及以上**（与录成绩同档）。访客只读时输入框置灰，并写明「当前为访客只读视图」或「服务端未连接」；示例数据模式下不能保存；
+- **普通报名完全不受影响**：只有一个单位的报名，这一格的文案、元素与以前一样，**不改动就不会发出任何请求**；
+- **分数怎么分、牌怎么记**：保存后这条成绩的分按份额拆给各成员单位（榜单上各处都已经是拆后的数），奖牌**每个成员单位各记一枚**（见上面的口径表与那句提醒）；
+- **按单位导出名单时，成员单位也看得到这条报名**：用 B 单位筛「报名名单」，能看到主单位是 A、成员里有 B 的联队报名——否则 B 导出自己的名单会发现「没派人上场」；
+- ⚠️ **个人积分总明细里，联队里的同一个人会出现两行**（引擎按份额给两个成员单位各留一行流水）。导出侧只在「来源」列写清这两行为什么出现（`成绩（联队分拆：…）`）：**看两行加起来才是这个人的总数**，他的总分没有被算两遍；
+- ⚠️ **团体名次（见 4.9）要录在「主单位」那一行**：联队的名次录在主单位上，系统才会按份额拆给各成员单位；**不要再给成员单位单独录一份名次**，那会让成员单位再拿一份分（重复计分）。
+- ⚠️ **「按队内平均」这类聚合通道的项目，联队不拆份额**：这类通道的名次不对应任何一条报名，分仍记在主单位头上（本轮如此）。要保证联队一起算，请用不聚合的口径（或按 4.9 在主单位上录名次）。
+- 一件事只做一次：**同一个小项同一个组别里，两个单位联合参赛就写一条 `A+B` 的报名**。`A+B` 与 `B+A` 是**两条不同的报名**（主单位不同），不要两种写法都填。
+
 ---
 
 ## 5. 成绩审核
@@ -280,6 +321,9 @@
 
 1. 左侧「待审草稿」按「小项 + 组别」分组，显示每组草稿条数，可搜索小项 / 组别 / 单位；
 2. 点选一组后，右侧显示该组成绩明细（单位、运动员 / 队、成绩、名次、状态、积分）；
+
+   > 「单位」这一列与录入页同一口径：普通报名显示单位简称；**联队**（一条报名挂多个单位）会多一个「联队」小标，并把成员单位与份额逐条列出（`第一分公司 50%` / `第二分公司 50%`），悬停能看到联队全名——复核时一眼就看出这一条其实是几个单位合并报的。本页只读，改份额请到「成绩录入」页点那一行的「单位」格（见 4.11）。
+
 3. 用「整组对比 / 逐条对比」切换，查看发布后各单位积分的变化；
 4. 「发布影响」列出受影响单位与分值变化；
 5. 操作：
@@ -387,6 +431,7 @@
 ### 8.2 单位奖牌榜 / 个人积分榜
 
 - 单位奖牌榜显示金、银、铜与合计；
+- ⚠️ **有联队（两个单位合并参赛）时，各单位的奖牌数加起来会大于实际颁发的奖牌数**——联队的每一枚奖牌**每个成员单位各记一枚整枚**（A、B 联队拿 1 枚金牌，榜上 A 记 1 金、B 记 1 金，场上只颁发了 1 枚）。**这是定稿口径，不是数据错了**；拿榜单去和实际颁发的奖牌核对时请记住这一点。联队本身怎么配见 4.11；
 - **单位奖牌榜有自己的名次与顺序：金牌多的在前，其次比银牌、铜牌，最后按单位编码排**——它不看总分，所以「金牌多但总分低」的单位在这里排在前面，在单位总分榜上却靠后，这是口径不同，不是数据错了；
 - 个人积分榜显示运动员、单位、个人总分与奖牌数；
 - 单位奖牌榜那一列的「明细」展开的是**同一个单位积分明细面板**（见 8.1），不是奖牌专属明细；但这份榜单本身有专属的逐枚奖牌导出（见 8.3）；
@@ -399,6 +444,11 @@
 - **导出奖牌明细**（单位奖牌榜卡片头）：导出 `单位奖牌明细.xlsx`——第一张总表逐枚奖牌列出「单位 / 大项 / 小项 / 组别 / 名次 / 奖牌 / 运动员、队」，`奖牌` 列是 `金牌` / `银牌` / `铜牌`；其后每个**有奖牌**的单位一张分表（列同上、去掉「单位」，末尾一行小计 `金 X / 银 Y / 铜 Z`），没有奖牌的单位不出分表。口径与「单位奖牌榜」一致：同一个报名项在「个人+团体」这类双计通道下只记一枚奖牌，不会重复计数；
 - **导出个人明细**（个人积分榜卡片头）：导出 `个人积分总明细.xlsx`——第一张总表逐条列出「单位 / 运动员 / 大项 / 小项 / 组别 / 名次 / 成绩 / 得分 / 来源」；其后每个**有得分**的单位一张分表（按单位分，不按人分），没有得分流水的人不出现在表里。`得分` 是记到个人的原始分，**与「个人积分榜」逐个数字一致，且不乘榜单口径里的个人项目得分折算系数**（那个系数只作用于单位总分）；
 - **导出该单位明细**（右侧单位明细面板头部）：先展开某个单位再点，导出 `单位积分明细.xlsx`（列：序号、大项、小项、组别、运动员、名次、成绩、来源、积分、备注，末行是「合计」）。**备注列会写下修订痕迹**：被改过的成绩写「已修订 ×N；最后一次 <时间> <原因>」，没改过的行留空——与屏幕上那个角标是同一句话，事后拿表格对账不会对不上。单位奖牌榜展开的也是这个单位积分明细面板，所以想按单位逐条看时同样用它；
+- **联队（一条报名挂多个单位）在这几份导出件里怎么体现**（见 4.11）：
+  - **单位积分明细 / 单位积分总明细的「备注」列**：这一条是从联队分来的，会写清分给了哪些单位、各拿多少分（多少 %），例如 `联队分拆：第一分公司 5 分（50%）、第二分公司 5 分（50%）`；「积分」列写的是**本单位实得的那一份**（上例是 5 分，不是联队拿到的 10 分）；
+  - **个人积分总明细的「来源」列**：这一条是联队分来的写成 `成绩（联队分拆：第一分公司 5 分（50%）、第二分公司 5 分（50%））`。⚠️ 这张表里**联队成员会出现两行**（引擎按份额给两个成员单位各留一行流水）——**看两行加起来才是这个人的总数**，他不是被算了两遍；
+  - **单位奖牌明细的「奖牌」列**：联队那一枚写成 `金牌（联队 第一分公司+第二分公司，各单位各记 1 枚）`（非联队行仍然只有「金牌」两个字）。为了让这句话写得下，这一列**加宽并允许换行**，格子里的值本身没变；
+  - **总表 / 单位奖牌明细的副标题**：赛事里有联队时，会追加一句 `· 注：本赛事含联队，奖牌按「每个成员单位各记 1 枚」统计，各单位奖牌数之和会大于实际颁发数`——**各单位奖牌数加起来比实际颁发的多，是定稿口径，不是数据错了**（A、B 联队拿 1 枚金牌，两边榜上各 1 枚）；
 - 这些导出都是只读下载（访客也能用），不需要写权限；导出过程中按钮会变成「导出中…」并禁用，避免重复下载。
 
 ### 8.4 推送明细到大屏
@@ -660,6 +710,8 @@
 
 报名有两种方式，都在本页完成：**从已有名单勾选**适合零散补报，**表格导入**适合批量录入。
 
+> 两个单位因参赛人数不足**合并成一个队参赛**时，不要建一个「联队单位」——**在导入表的「单位编码」列写 `F1+F2`**，或导入后到「成绩录入」页点那一行的「单位」格配成员单位与份额（见 4.11）。榜单仍是原来的单位数，分数与奖牌按份额记给各单位。
+
 > 本页的「从已有名单勾选」在**成绩录入页的工具栏里也有一个入口**（按钮叫 **「补报名」**），打开的是同一套勾选界面，只是预选了你正在录的那个小项与组别——在录入界面把某人移出报名之后，就地补回来即可（见 4.8）。
 
 **从已有名单勾选**
@@ -687,7 +739,9 @@
    - 「**中文表头 / 英文表头**」＝**单表模板**（`entries-template-zh.csv` / `entries-template-en.csv`）：一份表装全部报名，每行都要填「项目编码」与「组别」两列；
    - 「**分工作表 · 中文表头 / 分工作表 · 英文表头**」＝**分工作表模板**（`.xlsx`）：按当前赛事已配好的**小项 × 组别各建一张工作表**，表名是「**小项名称@组别名称**」（例如 `100 米跑@男子组 30岁以下`），范围由表名承担，数据区只填人和单位。小项组别多时用它更不容易抄串；
    - 两种模板的表头与列顺序完全一样，只有「范围从哪来」不同（详细规范见 [报名名单导入规范 · 第八节](./报名名单导入规范.md)）；
+   - **两个单位联合参赛（联队）**：把「单位编码」那一格写成 `F1+F2`（加号左边是主单位，默认均分，见 4.11）。**分工作表模板**里，「单位编码」表头那一格挂了一条**单元格批注**（鼠标停上去就弹出来）、这一列还有**输入提示**（点中该列的格子就弹出来），中英各一份，写的正是这套写法——表头文字、列顺序与工作表名一个字都没动，**老表格照常导入**；
 2. 表头共 12 列：`event_code`、`category`、`team_code`、`athlete_name`、`id_card`、`gender`、`age`、`bib`、`seed`、`heat`、`status`、`member_names`（大小写不敏感）。其中 `id_card`（证件号）、`gender`（性别）、`age`（年龄）、`heat`（批次）为可选列，缺失不影响导入，其余列必须包含；
+   - `team_code`（单位编码）有两种填法：**一个单位**填它的编码（`F1`）；**两个单位联合参赛**填 `F1+F2`（加号左边是主单位，默认均分；非均分要到录入页改，见 4.11）；
    - 用**分工作表模板**时，`event_code`、`category` 两列也可以整列不要或整列留空（范围由工作表名决定）；一旦填了就必须与工作表名一致，不一致的那一行会报错并跳过；
    - 工作表名必须是「小项名称@组别名称」；工作簿里只要有**一张**表名带 `@`，整份文件就按分工作表模板处理，别的表名不合规会**整份拒绝并点名是哪张表**（不让数据无声消失）；
    - 小项名与组别名里**不允许出现 `@`**（它是表名里的分隔符）：新建 / 编辑小项与组别时界面会当场拦下并说明原因；**已经带 `@` 的历史名字不影响报名与成绩**，但下载分工作表模板时会被点名要求先改名；
@@ -757,6 +811,11 @@
 | 个人积分总明细 | **在「积分榜 → 个人积分榜」页操作**：逐条列出单位 / 运动员 / 大项 / 小项 / 组别 / 名次 / 成绩 / 得分 / 来源，每个有得分的单位一张分表 | `个人积分总明细.xlsx` |
 
 - 「分项成绩表」需先选择小项，「单位积分明细」需先选择单位；「报名名单」的四个筛选（小项 / 组别 / 单位 / 批次）**都可以留空**，留空就是不筛这一维度（全导）；
+- **联队（一条报名挂多个单位）在这几份导出件里的写法**（见 4.11）：
+  - **「分项成绩表」「全部」「全部（单页）」的「单位」列**：写成联队全名 `第一分公司+第二分公司联队`（成员单位名写全，与导入表的 `F1+F2` 同构）；**「备注」列**写清这条分给了谁、各多少，例如 `联队分拆：第一分公司 5 分（50%）、第二分公司 5 分（50%）`——「积分」列写的是**联队拿到的总分**（上例 10 分），每家的那一份看备注；
+  - **「报名名单」**：「单位编码」列回写成 `F1+F2`（**导出的名单可以直接拿去重导**，不用手工改回单个单位）、「单位名」列写联队全名、「备注」列写 `联队分拆：第一分公司 50%、第二分公司 50%`（这张表没有积分列，所以只写份额比例）；
+  - **按单位筛选导出时，成员单位也看得到这条报名**：「报名名单」按 F2 筛选，能导出「主单位是 F1、成员里含 F2」的联队报名（否则 F2 导出自己的名单会发现「没派人上场」）；
+  - 「单位积分明细 / 单位积分总明细」「个人积分总明细」「单位奖牌明细」里联队的写法见 8.3；**没有联队的赛事，这些列与升级前逐字一致**。
 - **三种「还没出结果」的行也照样占一行**（「分项成绩表」「全部」「全部（单页）」都是，逐格口径完全一致）：
   - **录了但还没发布**：成绩列写 **`分数未录入`**、名次与积分列写 `—`、状态列写「草稿」；
   - **完全没有录成绩**（连草稿都没有）：名次 / 成绩 / 积分三列都写 `—`（不是空、也不是 `0`）、状态列写「未录入」；
@@ -992,6 +1051,8 @@
 
 > 单位 logo 取自「基础数据 → 参赛单位」里上传的图片（见 10.1），按行内文字大小显示，不会撑开行高；没传 logo 的单位不占位，图片临时加载不出来时保留占位、刷新后恢复，队名不会跳动。
 
+> **联队（两个单位合并参赛）在大屏上怎么写**（见 4.11）：「分项成绩」与「实时赛况」的**单位列写联队全名**——`第一分公司+第二分公司联队`，并且**把两个单位的 logo 都放上**（单位列宽会为该行实际要画的 logo 数留位置，第二个 logo 不会把名字挤成省略号）；底栏「最新完成项目」那一行同样写联队全名。**单位奖牌榜、总积分榜本来就是逐单位一行，服务端已按份额拆好**（例：A、B 各 1 枚金、各 7.5 分），屏上不需要另做处理。**没有联队的赛事，大屏画面与升级前逐像素一致**。
+
 > 大屏的标题字体与正文字体取自「系统设置 → 赛事信息 → 字体」（见 14.3）：可选四款内置字体，也可以上传自己的字体；上传字体加载失败时自动回落到默认字体，画面不会出现方块或空白。
 
 > 除了 Console 开出来的本机大屏窗口，**局域网设备（另一台电脑、电视浏览器）打开 `http://<主机IP>:19540/display` 也能当大屏用**。这个地址不用手敲：管理端「大屏控制 → 局域网大屏」卡片里有**可复制的完整链接与二维码**（见第 9 节）。这类设备会出现在管理端「大屏控制 → 在线大屏」列表里（标记为「局域网浏览器」），也能被单独切页，用法见第 9 节；它们不受 Console 的 kiosk、防熄屏控制（另见常见问题 Q29）。