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 张逐字节未变）。

web/src/display/components/TickerBar.vue

@@ -1,6 +1,8 @@
 <script setup lang="ts">
 import { computed, onUnmounted, ref, watch } from 'vue'
 import { medalBoardRows } from '@/shared'
+import type { EventResultRow } from '@/shared'
+import { tickerRowText } from '../jointTeams'
 import { useScoreboard } from '../useScoreboard'
 import { DEFAULT_ROTATE_SECONDS } from '../guards'
 
@@ -11,7 +13,17 @@ interface TickerItem {
   label: string
 }
 
-const { standings, latestResults, announceText, detail, settings } = useScoreboard()
+const { standings, latestResults, announceText, detail, settings, jointTeamOf } = useScoreboard()
+
+/**
+ * 底栏「最新完成项目」一行里的名字：团体行是联队时写「A+B联队」。
+ *
+ * 底栏放不下两个 logo，但两个单位的名字必须都在——只写主单位会让现场以为
+ * 这条成绩是它一家拿的（成员单位来自报名表，见 display/jointTeams.ts）。
+ */
+function chipName(row: EventResultRow): string {
+  return tickerRowText(row, jointTeamOf(row.entryId))
+}
 
 // 与单位奖牌榜页同一口径：按服务端的奖牌榜顺序（金→银→铜）取前 3，不在前端自己重排。
 const topMedals = computed(() => medalBoardRows(standings.value).slice(0, 3))
@@ -77,7 +89,7 @@ onUnmounted(() => window.clearInterval(timer))
           </div>
           <div v-for="row in latestGroup.rows.slice(0, 3)" :key="row.entryId" class="chip">
             <span class="chip-rank">{{ row.rank ?? '—' }}</span>
-            <span class="chip-name">{{ row.athleteName ?? row.teamName }}</span>
+            <span class="chip-name">{{ chipName(row) }}</span>
             <span class="chip-stat">{{ row.resultText }}</span>
           </div>
         </template>

web/src/display/components/pages/EventResultsPage.vue

@@ -1,14 +1,28 @@
 <script setup lang="ts">
 import { computed } from 'vue'
+import type { EventResultRow } from '@/shared'
+import { rowTeamLogos, rowTeamText } from '../../jointTeams'
 import { displayName, displayResult } from '../../results'
 import { useScoreboard } from '../../useScoreboard'
 import PageFrame from '../PageFrame.vue'
 import TeamLogo from '../TeamLogo.vue'
 
-const { latestResults, options } = useScoreboard()
+const { latestResults, options, jointTeamOf } = useScoreboard()
 
 // 数据口径：服务端只过滤 state='published'（不看项目 status），按发布时间倒序取前 N 个（06 第 5 节）。
 const groups = computed(() => latestResults.value.slice(0, options.value.resultsCount))
+
+/**
+ * 单位列的文案与 logo（devdocs/19）：联队写「A+B联队」并画两个单位的 logo，
+ * 普通报名与改造前逐字/逐图一致（`shortName ?? teamName` 与单个 TeamLogo）。
+ */
+function teamText(row: EventResultRow): string {
+  return rowTeamText(row, jointTeamOf(row.entryId))
+}
+
+function teamLogos(row: EventResultRow): (string | null)[] {
+  return rowTeamLogos(row, jointTeamOf(row.entryId))
+}
 </script>
 
 <template>
@@ -28,9 +42,10 @@ const groups = computed(() => latestResults.value.slice(0, options.value.results
           >
             <span class="rk">{{ row.rank ?? '—' }}</span>
             <span class="nm">{{ displayName(row) }}</span>
+            <!-- 联队两个单位的 logo 都要出现：teamLogos 普通报名时只有一个元素。 -->
             <span class="team">
-              <TeamLogo :path="row.logoPath" />
-              <span class="team-name">{{ row.shortName ?? row.teamName }}</span>
+              <TeamLogo v-for="(logo, index) in teamLogos(row)" :key="index" :path="logo" />
+              <span class="team-name">{{ teamText(row) }}</span>
             </span>
             <span class="rs">{{ displayResult(row) }}</span>
           </div>

web/src/display/components/pages/LivePage.vue

@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { computed, onMounted, onUnmounted } from 'vue'
+import type { EventResultRow } from '@/shared'
 import { fitLiveRowFontPx, liveResultColumnPx, liveTeamColumnPx } from '../../fitFont'
 import {
   LIVE_REFRESH_INTERVAL_MS,
@@ -10,12 +11,26 @@ import {
   pickLiveColumns,
 } from '../../live'
 import type { LiveEventSource } from '../../live'
+import { rowLogoCount, rowTeamLogos, rowTeamText } from '../../jointTeams'
 import { displayName, displayResult } from '../../results'
 import { useScoreboard } from '../../useScoreboard'
 import PageFrame from '../PageFrame.vue'
 import TeamLogo from '../TeamLogo.vue'
 
-const { latestResults, settings, events, liveFeed, liveStale, refreshLiveEvents } = useScoreboard()
+const { latestResults, settings, events, liveFeed, liveStale, refreshLiveEvents, jointTeamOf } =
+  useScoreboard()
+
+/**
+ * 联队（devdocs/19）：成绩行里只有主单位，成员单位来自报名表（useScoreboard 会为屏上的小项读一次）。
+ * 普通报名下这两件事与改造前完全一样——文案还是 `shortName ?? teamName`，logo 还是刚一张。
+ */
+function teamText(row: EventResultRow): string {
+  return rowTeamText(row, jointTeamOf(row.entryId))
+}
+
+function teamLogos(row: EventResultRow): (string | null)[] {
+  return rowTeamLogos(row, jointTeamOf(row.entryId))
+}
 
 const eventNames = computed(() => new Map(events.value.map((event) => [event.id, event.name])))
 
@@ -67,13 +82,26 @@ const layout = computed(() => liveBoardLayout(boards.value.length, rowCount.valu
 const resultTexts = computed(() =>
   boards.value.flatMap((board) => board.rows.map((row) => displayResult(row))),
 )
+// 联队行的单位名更长（两个单位名都写全），列宽预算必须按**实际会写出来的字**算，
+// 否则联队一到屏上就被挤成省略号。
 const teamTexts = computed(() =>
-  boards.value.flatMap((board) => board.rows.map((row) => row.shortName ?? row.teamName)),
+  boards.value.flatMap((board) => board.rows.map((row) => teamText(row))),
 )
-// 有单位 logo 时单位名那一格还要多占一个 logo 宽（TeamLogo 是 1em + 0.28em 间距）。
+// 单位名后面还要放 logo（TeamLogo 是 1em + 0.28em 间距），一个不够就按最多的那一行算。
 const teamsWithLogo = computed(() =>
   boards.value.some((board) => board.rows.some((row) => row.logoPath !== null && row.logoPath !== '')),
 )
+const maxLogosPerRow = computed(() =>
+  boards.value.reduce(
+    (max, board) =>
+      Math.max(
+        max,
+        ...board.rows.map((row) => rowLogoCount(row, jointTeamOf(row.entryId))),
+        0,
+      ),
+    0,
+  ),
+)
 const rowFontPx = computed(() =>
   fitLiveRowFontPx(
     liveBlockRowCount(rowCount.value, layout.value),
@@ -81,6 +109,7 @@ const rowFontPx = computed(() =>
     resultTexts.value,
     teamTexts.value,
     teamsWithLogo.value,
+    maxLogosPerRow.value,
   ),
 )
 
@@ -92,6 +121,7 @@ const boardStyle = computed(() => ({
     layout.value,
     rowFontPx.value,
     teamsWithLogo.value,
+    maxLogosPerRow.value,
   )}px`,
 }))
 
@@ -141,9 +171,10 @@ onUnmounted(() => {
             >
               <span class="rk">{{ row.rank ?? '—' }}</span>
               <span class="nm">{{ displayName(row) }}</span>
+              <!-- 联队两个单位的 logo 都画（teamLogos 普通报名时只有一个元素）。 -->
               <span class="team">
-                <TeamLogo :path="row.logoPath" />
-                <span class="team-name">{{ row.shortName ?? row.teamName }}</span>
+                <TeamLogo v-for="(logo, index) in teamLogos(row)" :key="index" :path="logo" />
+                <span class="team-name">{{ teamText(row) }}</span>
               </span>
               <span class="rs">{{ displayResult(row) }}</span>
             </div>