feat(entry): 团体项目多队（迁移 0025）+ 修联队团体名次 / 大屏分项成绩 / 预览算分口径；版本 dev_0.5.5

## 一、新能力：团体项目多队
现场：羽毛球双打，一个单位可能派两个队，一个单位两个队各占一个名次。
- 迁移 `0025_entry_squad.sql`：`entries` 加 `squad TEXT NOT NULL DEFAULT ''`（自由文本队名，空串＝不区分队伍）；
  唯一索引由 `(category_id, team_id) WHERE athlete_id IS NULL` 换成 `(category_id, team_id, squad) WHERE athlete_id IS NULL`
  —— 原来那条正是「一个单位在一个组别只能报一条团体报名」的拦路虎。
- 导入：**第 13 列「队伍」**（`squad` / 队伍 / 队名 / 队伍名，可选，放最后）；老 12 列表照常导入。
- 显示：`单位名 + 队名`（不加括号），榜单不写队名（分与牌本来就归单位）。
- 新增「改队名」：`PUT /api/entries/{id}/squad` + 「成员单位与份额」弹窗里的队伍输入框（只对纯团体报名显示）。
  改队名**不需要重算**（`grep squad server/internal/domain/` = 0 处，改名前后流水/名次/榜单逐字节相同）。
- **老数据零变化**：接口层 JSON 剥掉新字段后逐字节相同；导出层 9 份导出件全单元格 750 行 dump 的 md5 相同。

## 二、修：团体名次控件没体现联队
联队的成员单位在「团体名次」里各占一行 → **合并成一行**（标签用大屏/导出一致的联队名），名次**只落主单位**；
成员单位不再进保存载荷，顺手堵掉「看 A、B 各一行，给 B 也录一个名次 → B 重复拿分」。
被并掉的成员单位原来若录过名次，区块里点名提示「已并入联队那一行，保存后清除」，不静默吞。

## 三、修：大屏「分项成绩」排名错乱
现场：第 3 栏列出的项目排名跳着显示（3、6、9、14、15、16），羽毛球单打第 1 名不显示。
**根因**：`group.rows.slice(0, 6)` 取的是**数据到达顺序**，整条渲染链**没有一处读 `rank`**。
修法：按名次升序（并列保持原先后、无名次排最后）再截断 —— 与同页「实时赛况」的既有口径一致。
复现证据：修前 `actual: [3,6,9,14,15,16]`（与现场数字一致）、`expected: [1,2,3,4,5,6]`。
顺带澄清：「只有第 3 栏出问题」不是栏的问题，是那一栏分到的数据次序不成立。

## 四、修：录入页预览算分与后端口径不一致（四处 + 一条延伸）
现场：手动录名次的项目（台球）「积分（自动）」列全是 0，而后端**有分**。
1. **预览不读 `channel_manual_ranks`、也不按通道 scope 分名次来源** → 「按单位录名次」的项目预览全 0，反过来名次填在成绩表时预览有分而服务端 0；
2. **末位归零判据不同**：预览原本「区间跨末位就整组归零」，与后端的 `startRank == lastPlace` 不符（并列第 1 时预览 0、服务端 10）；
3. **`compare=none` 时预览静默降级成 manual**（后端此时直接报错）→ 改为同口径：显示**原因**而不是一个算不出来的数字；
4. **管理端保存计分通道缺守卫**：`compare=none + basis=result/aggregate` 原先只有规则包导入拦，手工能配出来、到发布才报错 → 保存前 400 + 人话。
延伸：预览的「已发布分」基线**只扣行分**，不挂报名项的分（团体名次那类）没扣 → 发布确认框「最大分差」虚高；新增 `unitPoints` 一并扣。

## 五、修：手录名次项目的「成绩」列空白
`displayResult()` 在 `resultValue`/`resultText` 都拿不到时**漏出空值**（且函数声明返回 `string`）→
新增占位 `—`、类型收紧，实时赛况与底栏对齐同一口径。

## 文档
`docs/报名名单导入规范.md`（12 → 13 列）、`docs/使用手册.md`（多队章节）、
`docs/升级说明.md`（新增 `dev_0.5.5` 一节）、`debug/使用说明/` 七份同步。

## 验证
- 全量自检两轮**全绿、`EXIT=0`**：服务端 14 包 / 前端 **883 例** 0 fail / Console 68 例 0 fail。
- 各块都先写会红的测试、留了原始输出（含现场报的那组数字与「预览全 0」）。

## 版本
`dev_0.5.4` → **`dev_0.5.5`**（含数据迁移 `0025`）；安装器素材同步重生成（照例只动 `brand.bmp` 两张）。

## 下一批
`dev_0.5.6` = **团体报名队员身份**（把队员从文字名单变成人员关联，标识用**号码布**），工单见 `devdocs/20-团体报名队员身份.md`。

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

@@ -11,14 +11,17 @@
 ## 一、先看懂三件事
 
 1. **用什么软件做表**：Excel 或 WPS 都行，做完存成 `.xlsx` 或 `.csv` 都可以（推荐 `.csv`，系统兼容性最好，不用管编码）。
-2. **表格长什么样**：**第一行是表头**（固定的 12 个列名，**中文、英文两套任选其一**，见第二节），**从第二行开始每人一行**。不要合并单元格，不要在表头上方再加标题行、说明行。
+2. **表格长什么样**：**第一行是表头**（固定的 13 个列名，**中文、英文两套任选其一**，见第二节），**从第二行开始每人一行**。不要合并单元格，不要在表头上方再加标题行、说明行。
 3. **编码不能自己编**：表里的「小项编码」「单位编码」「组别名称」必须是系统里已经配好的，**照抄系统里的写法**。系统里没有的编码，这一行会被跳过并报错。
 
 ---
 
 ## 二、表头（第一行的列名）
 
-一共 12 列。系统**同时认两套表头**——英文一套、中文一套，**两套都能导入**，也可以**中英混着写**（每一列各自认名字，例如英文 `event_code` 配中文「姓名」）。**英文是规范列名**：老的英文模板一个字都不用改，照常导入；中文只是给习惯看中文的人用的同义写法。
+一共 13 列。系统**同时认两套表头**——英文一套、中文一套，**两套都能导入**，也可以**中英混着写**（每一列各自认名字，例如英文 `event_code` 配中文「姓名」）。**英文是规范列名**：老的英文模板一个字都不用改，照常导入；中文只是给习惯看中文的人用的同义写法。
+
+> **第 13 列「队伍」是新加的（2026 年 9 月）**：**同一个单位在同一个组别派两支队**（羽毛球双打的一队 / 二队那种）时才需要填它；**绝大多数表格整列留空就行**，填法见第三节的「队伍」。
+> **老表格不用改**：表头里没有这一列、整列不写、格子留空，三种情况都合法，系统按「不区分队伍」处理——**原来的 12 列一列都不会错位**（新的一列加在**最后**）。
 
 下载模板时按手上表格的样子选：
 
@@ -43,6 +46,9 @@
 | `heat` | 批次（也认「批次号」） | 批次，可缺省 |
 | `status` | 状态（也认「报名状态」） | 报名状态 |
 | `member_names` | 队员名单 | 团体项目的队员名单 |
+| `squad` | 队伍（也认「队名」「队伍名」） | **队名，可缺省**；同一个单位在同一组别派两支队时用它区分（留空 = 不区分队伍） |
+
+> **第 13 列 `squad`（队伍）永远排在最后**：它是 2026 年 9 月新增的，加在表尾是为了让**手里那些原来 12 列的老表格一列都不会错位**（表格少的正是最后这一列）。整列不写、整列留空、表头没有它，三种情况都合法。
 
 > **同一列只能写一次**：一份表里同时出现 `event_code` 和「项目编码」（或者干脆把同一列写了两遍），会被整份拦下并提示「报名表表头重复」，删掉多余的那一列再导入即可——系统不会替你猜该信哪一列，免得静默丢掉另一列的数据。
 >
@@ -64,6 +70,7 @@
 | `heat`（批次） | 可选 | 批次号：1–999 的整数；**留空 = 未分批**（不参与算分，见下） | `1` |
 | `status`（状态） | 可选 | 报名状态：4 个英文词（大小写都行）或等价的中文别名（见下） | `registered` |
 | `member_names`（队员名单） | 可选 | 团体项目的队员名单，多人用 `/` 隔开 | `张三/李四/王五` |
+| `squad`（队伍） | 可选 | **队名**（自由写，例如 `一队`）；**留空 = 不区分队伍**。**同一个单位在同一个组别派两支队就靠它区分**，见第三节 | `一队` |
 
 > 「必须」指的是**这一列的表头要有**。至于每格里能不能留空，看下面第三节逐列的说明。
 
@@ -183,6 +190,23 @@ F1+F2
 - 团体项目**可以只报单位、不写队员**（这一列留空即可），队员名单以后还能补。
 - 系统界面里会把这条名单显示成「张三、李四、王五」。
 
+### `squad` 队伍 —— 可选（表的最后一列）
+
+**这一列只在「同一个单位在同一个组别派了不止一支队」时才需要填**，比如羽毛球双打：一个单位报了一队、二队，两队可能各占一个名次。
+
+```
+一队
+二队
+青年队
+```
+
+- **队名随便写**（`一队` / `二队` / `青年队` / `A 组` 都行），就是给现场看的一个标签；
+- **留空 = 不区分队伍**：一个单位在这个组别只有一支队（绝大多数情况）时，**整列留空、整列不写、表头里没有这一列**，三种都合法，与升级前的行为完全一样；
+- **只对团体项目有效**：这一列只认「姓名那一格留空」的团体行。**个人行（填了姓名的行）如果也填了队名，这一格不会写进库里**，导入结果里会给你一条提示：`第 N 行填了队伍「一队」，但这一行有运动员姓名、按个人报名处理：队伍只对团体报名（不填姓名那几行）生效，这一格没有写进库里`；
+- **同一个单位、同一个组别、同一个队名只能有一条**（要派两支队就写两个不同的队名）。撞上了会逐行拦下并说清是哪个单位、哪个队（见第六节）；
+- **队名只影响显示与查重，不影响成绩与算分**：两个队的成绩、名次、积分各算各的，最后都汇总到同一个单位的总分上；显示上写成「单位名 + 队名」，例如 `第一分公司二队`（队名留空时仍然只写 `第一分公司`）。**单位总分榜 / 单位奖牌榜 / 个人积分榜上不写队名**（分与牌本来就归到单位）；
+- 队名**改起来不用删掉重建**：到「成绩录入」页点那一行的「单位」格，在弹窗里改（见[使用手册 · 4.12](./使用手册.md)）。⚠️ 改完记得**把报名表里的队名也改成一样**——以后再导一份还写着旧队名的表，会因为认不出来而**新增出旧队名那一条**。
+
 ### 系统怎么认人（证件号 → 号码布 → 姓名 + 单位）
 有姓名的行，系统按下面的顺序认人。**证件号是唯一标识，号码布是它的替补，最后才靠「姓名 + 单位」兜底回填**：
 
@@ -196,7 +220,7 @@ F1+F2
 
 ---
 
-## 四、四个完整例子
+## 四、五个完整例子
 
 ### 例 1：个人项目（七单位 × 若干人）
 
@@ -246,11 +270,30 @@ F1+F2
 - 要改成 **2:1** 这类非均分：**不能在这张表里写**，导入后到「成绩录入」页点那一行的「单位」格改（见[使用手册 · 4.11](./使用手册.md#411-联队两个单位合并参赛)）；
 - 大屏与导出件里写的是 `第二分公司+第五分公司联队`，报名名单导出的「单位编码」列回写成 `F2+F5`（可以直接拿去重导）。
 
+### 例 5：同一个单位派两个队（团体项目多队）
+
+羽毛球双打，**F1 派出「一队」和「二队」两支队伍**，两队都可能拿名次。`BD` 是羽毛球双打、`男子组`：
+
+| event_code | category | team_code | athlete_name | id_card | gender | age | bib | seed | heat | status | member_names | squad |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| BD | 男子组 | F1 |  |  |  |  |  |  |  | registered | 张三/李四 | 一队 |
+| BD | 男子组 | F1 |  |  |  |  |  |  |  | registered | 王五/赵六 | 二队 |
+| BD | 男子组 | F2 |  |  |  |  |  |  |  | registered | 孙八/周九 |  |
+| BD | 男子组 | F3 |  |  |  |  |  |  |  | registered | 吴十/郑十一 |  |
+
+要点：
+
+- **同一个单位、同一个组别写两行**，靠**最后一列「队伍」**区分开：`一队`、`二队`。**一个单位两个队都进前三时，这个单位会拿 2 枚牌**（两支队各算各的名次）；
+- F2、F3 只有一支队，队伍列**留空**即可（也可以整列不填、或表头里干脆没有这一列）；
+- **列都写对了才有多队的效果**：两行的 `event_code` / `category` / `team_code` / `squad` 必须**都不一样的那一格正好是 squad**——如果两行队名也写成一样的（都写 `一队`），第二行会被拦下（「同一个单位同一个组别的同一个队只能报一条」）；如果两行队名都留空，第二行也会被拦下（「一个单位在一个组别只能有一条不分队的报名」）；
+- 显示上写成 **`第一分公司一队` / `第一分公司二队`**（单位名后面直接跟队名，不加括号不加分隔符）；**单位总分榜、单位奖牌榜、个人积分榜上只写 `第一分公司`**（两队的分数都已经算进这个单位的总分）；
+- 报了之后想改队名**不用删掉重建**：到「成绩录入」页点那一行的「单位」格，在弹窗里改（见[使用手册 · 4.12](./使用手册.md)）。⚠️ **改完记得把这张表里的队名也改成一样**——以后再导一份还写着旧队名的表，会**新增出旧队名那一条报名**（导入是按「小项 + 组别 + 单位 + 队名」认人的）。
+
 ---
 
 ## 五、导入前请先检查（自检清单）
 
-- [ ] 第一行是那 12 个列名（**英文一套、中文一套都行**，也可以中英混着写，见第二节），没有被合并单元格、**同一列没有写两遍**
+- [ ] 第一行是那 13 个列名（**英文一套、中文一套都行**，也可以中英混着写，见第二节），没有被合并单元格、**同一列没有写两遍**
 - [ ] 表头上方没有多余的标题行或空行
 - [ ] `event_code`、`team_code` 都是从系统里抄的编码，没有空格
 - [ ] `category` 与系统里的组别名一字不差
@@ -262,6 +305,7 @@ F1+F2
 - [ ] `status` 只用那 4 个英文词（大小写都行）或第三节列的中文别名，不写别的词；拿不准就留空
 - [ ] `heat` 要么留空，要么是 1–999 的整数（不参与算分，只是录入分组）
 - [ ] **联队**（两个单位联合参赛）写的是 `F1+F2` 这种形状：加号两边都有编码、**同一个单位没写两遍**、成员不超过 5 个；**加号左边那个是主单位**（见第三节）
+- [ ] **「队伍」列**（最后一列）只在**同一个单位派了不止一支队**时才填：两队写了**两个不一样的队名**（都写一样或都留空会被拦下）；只有一支队的单位留空即可；**个人行（有姓名的行）没有填队名**（填了也不会写进库里，只给一条提示）
 - [ ] 全表没有因为"怕麻烦"把某些列删掉——**表头 8 个必须列一个都不能少**（哪怕整列是空的）
 - [ ] 用的是**分工作表模板**时：每张工作表的名字都是「小项名称@组别名称」、没有多余的工作表；「项目编码 / 组别」两列要么整列留空、要么与表名一字不差（见第八节）
 
@@ -284,6 +328,9 @@ F1+F2
 | 第 N 行：单位编码 F1+ 里有一段是空的：联队要写成两个单位编码用 + 连起来（例如 A+B） | **加号有一边是空的**（`F1+`、`+F2`、`F1++F2` 都是这一条）。多半是填一半或多了个加号 | 补上缺的那个编码，或删掉多余的加号；联队至少两个单位 |
 | 第 N 行：单位编码 F1+F1 里同一个单位出现了两次：联队的每个单位只能写一次 | 同一个单位在联队里写了两遍（`F1+F1`） | 一个单位只写一次；两个单位联合参赛就是 `F1+F2` |
 | 第 N 行：单位编码 … 里写了 6 个单位：一个联队最多 5 个单位 | 加号太多、成员超过 5 个 | **一个联队最多 5 个单位**；现场最多见过三个单位合并，超过 5 个多半是这一格填错了东西（例如整格都是加号） |
+| 第 N 行：单位 A 在本组别已经有一条队伍「一队」的报名：「同一个单位同一个组别的同一个队」只能报一条；要派两个队请换一个队伍名（例如 二队） | 同一个单位、同一个组别、**同一个队名**写了两遍（两支队要写两个不同的队名） | 把其中一行的「队伍」列改成另一个队名（`一队` / `二队`）；如果本来就是同一支队、只是想把队员名单补全，改完重导**不会新增**（同一单位同一队名是更新） |
+| 第 N 行：单位 A 在本组别已经有一条不分队的团体报名：队伍列留空就是不区分队伍，一个单位在一个组别只能有一条；要派两个队请在队伍列分别写清（例如 一队 / 二队） | **两行的队伍列都留空**（等于都说「这个单位在这个组别只有一支队」），或者库里以前报过一条不分队的、这行又留空 | 要派两支队就在两行的「队伍」列分别写 `一队` / `二队`；确实只有一支队，就把多余的那一行删掉 |
+| 第 N 行：单位 A 在本组别已经有这个人的报名：同一个人在同一组别只能报一条，请把重复行合并后再导入 | **个人行**（填了姓名的行）在同一个小项同一个组别里写了两次。个人报名按「人」唯一，队伍列不参与（也不影响）这件事 | 把两行合并成一行；同一个人要参加两个项目就写在**不同小项**里，不能靠队名分成两条 |
 | 第 N 行：组别 XXX 不存在 | 组别名和系统里不一致，或该小项还没有这个组别 | 到「基础数据 → 组别」核对名称（注意别多字少字） |
 | 第 N 行：小项 XXX 没有组别 | 该小项一个组别都没配 | 先在「组别」里配好，再导入 |
 | 第 N 行：填写了 athlete_name 就必须填 id_card 或 bib | 个人行缺两项标识 | 补证件号或号码布；确实都没有的，请先在「运动员」里登记 |
@@ -344,7 +391,7 @@ F1+F2
 
 ### 8.2 数据怎么填
 
-- 每张工作表**第 1 行就是表头**（与单表模板同样的 12 列、中英两套都认），**从第 2 行开始填人**；
+- 每张工作表**第 1 行就是表头**（与单表模板同样的 13 列、中英两套都认），**从第 2 行开始填人**；
 - **「项目编码」「组别」两列可以整列留空**——表名已经说明了是哪个小项、哪个组别；
   一旦填了，就**必须与表名一致**，不一致的那一行会报错并跳过（系统不猜、也不会挑一个用）；
 - 其余列与单表模板完全一样（第三节逐列说明照样适用）；
@@ -395,6 +442,7 @@ Excel 对工作表名有硬限制：**最长 31 个字符**，同一份工作簿
 > 8. 填完先对着第五节的清单自查一遍，再发给收表人；
 > 9. **批次（`heat`）**可以不填；要分批比赛就填 1–999 的整数，它只影响录入时怎么分组找人，**不影响成绩与名次**；
 > 10. **两个单位联合参赛（联队）**：`team_code` 那一格写 `F1+F2`（加号左边是主单位，默认均分，最多 5 个单位），**不要**新建一个「联队单位」、也不要两个单位各写一行；非均分（例如 2:1）要在导入后到「成绩录入」页点那一行的「单位」格改；
-> 11. **存成什么格式**：Excel →「另存为」→「**CSV UTF-8 (逗号分隔) (*.csv)**」最稳；中文 Excel 默认的「CSV (逗号分隔)」也能用。**别用「Unicode 文本」（UTF-16）**，**别手工改名或把两个文件拼起来**，也别在格子里手写双引号（让 Excel 自己加）。
+> 11. **同一个单位派两支队**（羽毛球双打的一队 / 二队那种）：在**最后一列「队伍」**里分别写队名（`一队` / `二队`）；**只有一支队的单位这一列留空**，整列不写也行。**个人项目不用管这一列**；
+> 12. **存成什么格式**：Excel →「另存为」→「**CSV UTF-8 (逗号分隔) (*.csv)**」最稳；中文 Excel 默认的「CSV (逗号分隔)」也能用。**别用「Unicode 文本」（UTF-16）**，**别手工改名或把两个文件拼起来**，也别在格子里手写双引号（让 Excel 自己加）。
 >
 > 一句话：**下载模板 → 只往下面粘数据 → 另存为 CSV UTF-8 → 上传**。中间任何一个"顺手改一下"都可能让整份表被拦下。