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`。
2026-09-14 11:45:32 +08:00
1 parent 9663d5bfb0
commit 7a3e4ad365
@@ -2,6 +2,7 @@
 import { computed, onUnmounted, ref, watch } from 'vue'
 import { breakdownAthleteName, breakdownRevisionLine, breakdownSourceTag } from '@/shared'
 import { useScoreboard } from '../useScoreboard'
+import { resultTextOrPlaceholder } from '../results'
 import AnimatedNumber from './AnimatedNumber.vue'

 const { detail } = useScoreboard()
@@ -72,7 +73,7 @@ const autoClose = computed(() => (detail.value?.autoCloseSeconds ?? 0) > 0)
            </span>
            <span class="col-athlete">{{ breakdownAthleteName(item, teamName) }}</span>
            <span class="col-rank">{{ item.rank ?? '—' }}</span>
-            <span class="col-result">{{ item.resultText ?? '—' }}</span>
+            <span class="col-result">{{ resultTextOrPlaceholder(item.resultText) }}</span>
            <span class="col-points">{{ item.points }}</span>
            <!--
              修订痕迹占满一整行、只在这一分确实被改过时才出现：大屏不能悬停，观众要一眼看到
@@ -3,6 +3,7 @@ import { computed, onUnmounted, ref, watch } from 'vue'
 import { medalBoardRows } from '@/shared'
 import type { EventResultRow } from '@/shared'
 import { tickerRowText } from '../jointTeams'
+import { displayResult } from '../results'
 import { useScoreboard } from '../useScoreboard'
 import { DEFAULT_ROTATE_SECONDS } from '../guards'

@@ -13,16 +14,17 @@ interface TickerItem {
  label: string
 }

-const { standings, latestResults, announceText, detail, settings, jointTeamOf } = useScoreboard()
+const { standings, latestResults, announceText, detail, settings, jointTeamOf, squadOf } =
+  useScoreboard()

 /**
 * 底栏「最新完成项目」一行里的名字：团体行是联队时写「A+B联队」。
 *
 * 底栏放不下两个 logo，但两个单位的名字必须都在——只写主单位会让现场以为
- * 这条成绩是它一家拿的（成员单位来自报名表，见 display/jointTeams.ts）。
+ * 这条成绩是它一家拿的（成员单位与队名都来自报名表，见 display/jointTeams.ts）。
 */
 function chipName(row: EventResultRow): string {
-  return tickerRowText(row, jointTeamOf(row.entryId))
+  return tickerRowText(row, jointTeamOf(row.entryId), squadOf(row.entryId))
 }

 // 与单位奖牌榜页同一口径：按服务端的奖牌榜顺序（金→银→铜）取前 3，不在前端自己重排。
@@ -90,7 +92,7 @@ onUnmounted(() => window.clearInterval(timer))
          <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">{{ chipName(row) }}</span>
-            <span class="chip-stat">{{ row.resultText }}</span>
+            <span class="chip-stat">{{ displayResult(row) }}</span>
          </div>
        </template>

@@ -2,22 +2,25 @@
 import { computed } from 'vue'
 import type { EventResultRow } from '@/shared'
 import { rowTeamLogos, rowTeamText } from '../../jointTeams'
-import { displayName, displayResult } from '../../results'
+import { displayName, displayResult, eventResultColumns } from '../../results'
 import { useScoreboard } from '../../useScoreboard'
 import PageFrame from '../PageFrame.vue'
 import TeamLogo from '../TeamLogo.vue'

-const { latestResults, options, jointTeamOf } = useScoreboard()
+const { latestResults, options, jointTeamOf, squadOf } = useScoreboard()

 // 数据口径：服务端只过滤 state='published'（不看项目 status），按发布时间倒序取前 N 个（06 第 5 节）。
-const groups = computed(() => latestResults.value.slice(0, options.value.resultsCount))
+const columns = computed(() =>
+  eventResultColumns(latestResults.value, options.value.resultsCount),
+)

 /**
 * 单位列的文案与 logo（devdocs/19）：联队写「A+B联队」并画两个单位的 logo，
+ * 填了队名的写「第一分公司二队」（一个单位两个队时，两行的名字要分得开）；
 * 普通报名与改造前逐字/逐图一致（`shortName ?? teamName` 与单个 TeamLogo）。
 */
 function teamText(row: EventResultRow): string {
-  return rowTeamText(row, jointTeamOf(row.entryId))
+  return rowTeamText(row, jointTeamOf(row.entryId), squadOf(row.entryId))
 }

 function teamLogos(row: EventResultRow): (string | null)[] {
@@ -26,16 +29,16 @@ function teamLogos(row: EventResultRow): (string | null)[] {
 </script>

 <template>
-  <PageFrame title="分项成绩" :hint="`最新完成 ${groups.length} 项`">
-    <div v-if="groups.length > 0" class="groups">
-      <article v-for="group in groups" :key="`${group.eventId}-${group.categoryId}`" class="group">
+  <PageFrame title="分项成绩" :hint="`最新完成 ${columns.length} 项`">
+    <div v-if="columns.length > 0" class="groups">
+      <article v-for="column in columns" :key="column.key" class="group">
        <header class="group-head">
-          <h3>{{ group.eventName }}</h3>
-          <span class="cat">{{ group.categoryName }}</span>
+          <h3>{{ column.group.eventName }}</h3>
+          <span class="cat">{{ column.group.categoryName }}</span>
        </header>
        <div class="lines">
          <div
-            v-for="row in group.rows.slice(0, 6)"
+            v-for="row in column.rows"
            :key="row.entryId"
            class="line"
            :class="`top-${Math.min(row.rank ?? 99, 4)}`"
@@ -17,15 +17,24 @@ import { useScoreboard } from '../../useScoreboard'
 import PageFrame from '../PageFrame.vue'
 import TeamLogo from '../TeamLogo.vue'

-const { latestResults, settings, events, liveFeed, liveStale, refreshLiveEvents, jointTeamOf } =
-  useScoreboard()
+const {
+  latestResults,
+  settings,
+  events,
+  liveFeed,
+  liveStale,
+  refreshLiveEvents,
+  jointTeamOf,
+  squadOf,
+} = useScoreboard()

 /**
- * 联队（devdocs/19）：成绩行里只有主单位，成员单位来自报名表（useScoreboard 会为屏上的小项读一次）。
- * 普通报名下这两件事与改造前完全一样——文案还是 `shortName ?? teamName`，logo 还是刚一张。
+ * 联队与队伍（devdocs/19）：成绩行里只有主单位，成员单位与队名来自报名表
+ * （useScoreboard 会为屏上的小项读一次）。普通报名下这两件事与改造前完全一样——
+ * 文案还是 `shortName ?? teamName`，logo 还是刚一张。
 */
 function teamText(row: EventResultRow): string {
-  return rowTeamText(row, jointTeamOf(row.entryId))
+  return rowTeamText(row, jointTeamOf(row.entryId), squadOf(row.entryId))
 }

 function teamLogos(row: EventResultRow): (string | null)[] {
@@ -82,8 +91,8 @@ const layout = computed(() => liveBoardLayout(boards.value.length, rowCount.valu
 const resultTexts = computed(() =>
  boards.value.flatMap((board) => board.rows.map((row) => displayResult(row))),
 )
-// 联队行的单位名更长（两个单位名都写全），列宽预算必须按**实际会写出来的字**算，
-// 否则联队一到屏上就被挤成省略号。
+// 联队行的单位名更长（两个单位名都写全），带队名的行也多出几个字，列宽预算必须按
+// **实际会写出来的字**算（teamText 已经把队名拼进去了），否则一到屏上就被挤成省略号。
 const teamTexts = computed(() =>
  boards.value.flatMap((board) => board.rows.map((row) => teamText(row))),
 )