feat(publish): 「以决赛成绩发布」开关 —— 非决赛发布只更新名次、不计分；版本 dev_0.5.8

## 需求（主人原话） > 只有在最后一轮(决赛)的成绩才算分，你给发布按钮边上带一个选项，勾选之后**当前小项/组以决赛成绩发布**， > 不然的话就**只更新名次(非决赛) 不加分**。 **设计好处**：不引入「轮次」模型，而是**在已有的「发布」动作上加一个口径** —— 分轮次比赛时，同一批人各轮成绩各发各的，榜单只认决赛那一轮的分。引擎本来就有一条「只排名不计分」的通路，这次是**把它在发布入口露出来**，没有另造算分分支。 ## 契约 `POST /api/results/publish` 请求体新增 **`rankOnly: boolean`**： - **缺省 / `false`** = 计分发布，**与改动前逐字节一致**（老客户端不带这个字段走现状路径）； - **`true`** = 本次只更新名次。 **只更新名次时写**：`results.state/verified_by/verified_at`（照旧）、`results.rank`（预赛排名次是刚需）、整小项录完时的 `events.status`、`result_revisions`（message 写明本次口径）、`change_log(entity=result)`（大屏据此重拉名次）。 **不写**：`score_ledger`（**既不加，也不作废任何已有流水**）、`channel_ranks`（不重建也不删除）、榜单快照版本。 ⇒ 于是会出现预期的「**名次变了、分还是旧的**」（本组上次按决赛发布过时）—— 确认框与录入页常驻提示都点名说了这件事。 ## 界面 - 录入页「发布」按钮**左边**：勾选框「**以决赛成绩发布（勾选才计分发牌）**」，**默认不勾**；旁边徽标随状态切「**只更新名次（不计分）**」（警示色）/「**计分发布（算分发牌）**」（绿色）。 - 确认框：标题切「确认按决赛成绩发布该组？」/「确认发布该组（只更新名次）？」；不勾时不再报「影响 N 个单位、最大分差 X 分」；已有在榜分时加一句「本组已有 X 分在榜…那份积分与奖牌会原样保留、不随名次变动」。 - **常驻「在榜口径」提示**：系统不记「上次勾了什么」，判据用**榜面事实**（已发布成绩的流水合计）—— 「本组在榜上只有名次（上次是按只更新名次发布的）」/「本组在榜上是已计分的成绩（已有 X 分来自上一次按决赛发布）」。 - **发布成功后勾选复位**：勾选是「这一次发布」的口径，不是页面设置（免得换小项时把预赛当决赛算分）。 - ⚠️ **审核页是第二个发布入口**，同样加了口径 —— 否则从审核页发布预赛会被**悄悄算成分**。 ## 兼容性（回答「能不能兼容现有数据包」） - **没有任何数据库变更、没有迁移**：纯行为改动，多带一个请求字段。 - 旧客户端 / 旧数据包 / 旧库照旧工作；不带该字段时与改动前**逐字节一致**（用改动前采集的整份写库 golden 对拍证明）。 - 反向（用新版导出的项目包去旧版本导入）仍是不支持的，与之前几版一致。 ## 验证 - **先红后绿**：改动前跑新用例，红在「只更新名次的发布动了已有流水」（贴出 `score_ledger` 前后对比）； - 另有 `rank_only_heal_test.go` 钉住「只更新名次发布过的库，**启动自愈不许把它算成分**」； - 全量自检两轮**全绿、`EXIT=0`**：服务端 14 包 / 前端 **944 例** 0 fail / Console 68 例 0 fail。 ## 文档 `docs/升级说明.md` 新增 `dev_0.5.8` 一节。 ## 版本 `dev_0.5.7` → **`dev_0.5.8`**（无数据迁移）；安装器素材同步重生成（照例只动 `brand.bmp` 两张）。
2026-09-14 22:57:03 +08:00
1 parent d11cab31db
commit c5ce1878fc
@@ -0,0 +1,143 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import {
+  FINAL_PUBLISH_LABEL,
+  boardModeNote,
+  publishModeConfirm,
+  publishModeHint,
+  rankOnlyOf,
+  publishedPointsOnBoard,
+} from '../pages/entryPublish'
+
+/**
+ * 「以决赛成绩发布」勾选项的口径（主人的新能力）：
+ *   不勾（默认）= 本次发布只更新名次，不计分、不发奖牌；
+ *   勾上 = 与改动前完全一样（算分、发牌、上榜）。
+ *
+ * 两件事必须钉住：勾选状态真的进了请求（rankOnly），以及界面上任一处都不许把
+ * 「只更新名次」说成会算分（确认框 / 常驻提示 / 预览面板）。
+ */
+
+const SOURCE = readFileSync(new URL('../pages/EntryPage.vue', import.meta.url), 'utf8')
+const MODULE = readFileSync(new URL('../pages/entryPublish.ts', import.meta.url), 'utf8')
+
+test('默认不勾：勾选状态取反就是请求里的 rankOnly', () => {
+  assert.equal(rankOnlyOf(false), true, '不勾 = 只更新名次')
+  assert.equal(rankOnlyOf(true), false, '勾上 = 计分发布')
+})
+
+test('确认框写明本次是计分发布还是只更新名次', () => {
+  const scored = publishModeConfirm(true, 0)
+  assert.match(scored, /按决赛成绩发布/)
+  assert.match(scored, /计分/)
+  assert.match(scored, /奖牌/)
+
+  const rankOnly = publishModeConfirm(false, 0)
+  assert.match(rankOnly, /只更新名次/)
+  assert.match(rankOnly, /不计分/)
+  assert.match(rankOnly, /不发奖牌/)
+  assert.doesNotMatch(rankOnly, /重算积分榜/)
+})
+
+test('只更新名次时，本组已有在榜积分必须点名说清「不会被改动」', () => {
+  const withPoints = publishModeConfirm(false, 18)
+  assert.match(withPoints, /已有 18 分/)
+  assert.match(withPoints, /保留/)
+  // 没有在榜积分时不说这句（免得制造不存在的顾虑）。
+  assert.doesNotMatch(publishModeConfirm(false, 0), /已有/)
+  // 计分发布时也不说（那份分本来就该被这次发布改写）。
+  assert.doesNotMatch(publishModeConfirm(true, 18), /保留/)
+})
+
+test('勾选框旁的常驻提示：不勾时明确说「不计分」', () => {
+  assert.match(publishModeHint(false), /只更新名次/)
+  assert.match(publishModeHint(false), /不计分/)
+  assert.match(publishModeHint(true), /算分/)
+})
+
+test('勾选框文案本身就说清「勾选才计分发牌」', () => {
+  assert.match(FINAL_PUBLISH_LABEL, /决赛/)
+  assert.match(FINAL_PUBLISH_LABEL, /勾选才计分/)
+})
+
+test('本组在榜上的口径（预赛 / 决赛）能从录入页看出来', () => {
+  // 一条都没发布过：不显示，避免无信息噪声。
+  assert.equal(boardModeNote(0, 0), null)
+  // 发布过但榜上没分 = 只排名（预赛）。
+  assert.match(boardModeNote(3, 0) ?? '', /只更新名次/)
+  assert.doesNotMatch(boardModeNote(3, 0) ?? '', /已计分/)
+  // 榜上有分 = 已经按决赛计分发布过。
+  assert.match(boardModeNote(3, 18) ?? '', /已计分/)
+  assert.match(boardModeNote(3, 18) ?? '', /18 分/)
+})
+
+test('在榜积分只数已发布的成绩，草稿不算', () => {
+  assert.equal(publishedPointsOnBoard([]), 0)
+  assert.equal(
+    publishedPointsOnBoard([
+      { resultState: 'published', points: 10 },
+      { resultState: 'published', points: 8 },
+      { resultState: 'draft', points: 6 },
+      { resultState: null, points: null },
+    ]),
+    18,
+  )
+})
+
+test('录入页：勾选框默认不勾，且勾选状态进了发布请求', () => {
+  assert.match(SOURCE, /const finalPublish = ref\(false\)/)
+  assert.match(SOURCE, /v-model="finalPublish"/)
+  assert.match(SOURCE, /rankOnly: rankOnlyOf\(finalPublish\.value\)/)
+  // 发布请求里不能写死 false（写死 = 永远计分发布，勾选框变成摆设）。
+  assert.doesNotMatch(SOURCE, /rankOnly: false/)
+})
+
+test('录入页：勾选框与醒目提示就贴在发布按钮边上', () => {
+  assert.match(SOURCE, /class="publish-final-toggle"/)
+  assert.match(SOURCE, /publishModeHint\(finalPublish\)/)
+  // 不勾时必须给出可读的「只更新名次」标记（警示色），不能只靠勾选框本身。
+  assert.match(SOURCE, /publishModeBadge/)
+})
+
+test('录入页：确认框用同一套文案，且把在榜积分传进去', () => {
+  assert.match(SOURCE, /publishModeConfirm\(finalPublish\.value, pointsOnBoard\.value\)/)
+})
+
+test('录入页：实时积分预览要说明「不勾时这些分差不会发生」', () => {
+  assert.match(SOURCE, /preview-rank-only-hint/)
+  assert.match(MODULE, /勾选「以决赛成绩发布」/)
+})
+
+test('发布沿用旧路径：请求体仍带 eventId / categoryId / requestId', () => {
+  const call = /await adminApi\.publish\(\{[\s\S]{0,220}?\}\)/.exec(SOURCE)?.[0] ?? ''
+  assert.match(call, /eventId: selectedEventId\.value/)
+  assert.match(call, /categoryId: selectedCategoryId\.value \?\? undefined/)
+  assert.match(call, /rankOnly: rankOnlyOf\(finalPublish\.value\)/)
+})
+
+/**
+ * 审核页（成绩审核 → 「发布整组」）是**第二个发布入口**：它不带上这个口径，
+ * 就成了绕开「只有决赛才算分」的暗门（从这一页发布预赛会被悄悄算分）。
+ */
+const REVIEW_SOURCE = readFileSync(new URL('../pages/ReviewPage.vue', import.meta.url), 'utf8')
+
+test('审核页：同样是默认不勾，勾选状态进发布请求', () => {
+  assert.match(REVIEW_SOURCE, /const finalPublish = ref\(false\)/)
+  assert.match(REVIEW_SOURCE, /v-model="finalPublish"/)
+  assert.match(REVIEW_SOURCE, /rankOnly: rankOnlyOf\(finalPublish\.value\)/)
+  assert.match(REVIEW_SOURCE, /finalPublish\.value = false/)
+})
+
+test('审核页：确认框同样写明口径，且不列不会发生的分差', () => {
+  assert.match(REVIEW_SOURCE, /publishModeConfirm\(finalPublish\.value, group\.pointsOnBoard\)/)
+  assert.match(REVIEW_SOURCE, /finalPublish \? '确认按决赛成绩发布该组？' : '确认发布该组（只更新名次）？'/)
+  assert.match(REVIEW_SOURCE, /:details="publishImpactDetails"/)
+  // 在榜上的分必须取服务端字段，不能用本地预览算出来的分。
+  assert.match(REVIEW_SOURCE, /publishedPointsOnBoard\(/)
+})
+
+test('审核页：只在计分发布时才报「影响多少单位、最大分差」', () => {
+  assert.match(REVIEW_SOURCE, /const scored = finalPublish\.value/)
+  assert.match(REVIEW_SOURCE, /if \(group === null \|\| !finalPublish\.value\) return \[\]/)
+})