feat: 主人拍板的 4 条全部落地(单条作废/重录、破纪录驳回、历史纪录、仪表盘卡片)+ 迁移 0021(dev_0.3.0)

## ① 成绩「作废本条 / 重新录入」——手滑填错了怎么办
- 新增 `POST /api/results/{id}/reopen`:把已发布的那条退回草稿(state=draft、
  status=ok、rank=NULL、note=原因)并重算推榜;口径与既有 `void` 完全一致
  (回滚类动作,不受 `standings.live_on_publish` 约束)。
- 成绩录入页新增「操作」列:已发布行可「作废本条」,已作废行可「重新录入」,
  两者都必填原因、确认后立即重算+推大屏。**验收用例**:作废→重录→改→重发,
  名次/流水/榜单与「一开始就填对」逐字节一致。

## ② 破纪录的驳回 / 作废
- 迁移 `0021_record_breaks_note.sql`:`record_breaks` 加一列可空 `note`。
- 新增 `GET /api/record-breaks?state=`(recorder 起可读,guest 403)与
  `POST /api/record-breaks/{id}/reject`(必填原因):已批准的登记被作废时
  **撤回该笔加分、重算推榜、并把该级别当前纪录恢复为上一条**;`approve`
  放开为可对 rejected 再次批准。
- 破纪录页新增「已批准的破纪录」卡片(作废入口);原先只存在浏览器内存里的
  「拒绝」改为持久化(先登记再驳回,刷新不再复现)。

## ③ 历史纪录的写入路径(`records.source` 以前恒为「本届」)
- 新增 `POST /api/records`(source 只收 history)与 `DELETE /api/records/{id}`
  (删当前纪录时恢复上一条)。纪录库卡片新增「新增历史纪录」与「删除」。
- 至此《使用手册》6.2 承诺的「来源(本届/历史)」这一列才真正有意义。

## ④ 仪表盘补齐承诺的卡片
今天的小项(按 scheduledAt 的本地时区当天 + 进度)、草稿待发布、待确认破纪录、
大屏在线数;数据源读不到显示 `—` 而不是 0。文档里「管理端在线数」服务端没有
接口,按实际改写成本机管理端连接状态。

## 旧版数据包兼容(主人特别交代,三处验证)
迁移只加**可空**列、不重建表、不动数据行;旧赛事包导入后由 `main.go` 的
`store.MigrateEvent` 在启动时补跑迁移。证据:`migration_0021_test.go`
(旧库升级 + 幂等 + 老行取 NULL)、`migration_legacy_test.go` 扩到 0021、
`legacy_pack_upgrade_test.go`(真实旧 event.db 走 main 同一条路径后装配 API,
驳回老登记 → 加分撤回、纪录回退、旧数据逐表一行不差),另有真二进制冒烟。
未迁移的库上不存在任何新列读取。

## 文档
升级说明新增 dev_0.3.0(含「旧包仍可导入、自动补跑迁移」);使用手册新增
§4.10 与 §6.1/§6.2 明细;常见问题新增 Q98/Q99/Q100;devdocs 04/05/07/13/02
同步(含新接口表与错误分级)。

自检:服务端 13 包 ×2 全绿(httpapi 新增 reopen/reject/records/旧包 四个用例文件)、
前端 vue-tsc + 604 例 ×2 + build、Console 19 文件 + 54 例。
This commit is contained in:
AskaEth committed 2026-09-12 01:27:09 +08:00
1 parent 6841cf49aa
commit ed2c0b3f3c
35 files changed
+4003 -115

No files matched your search

+145 -5
View File
@@ -2,9 +2,18 @@
import { computed, onMounted, ref } from 'vue'
import { RouterLink } from 'vue-router'
import { formatPoints, type RecordEntry } from '@/shared'
import type { DisplayInstance } from '@/shared/api'
import MxIcon from '../components/MxIcon.vue'
import PageHeader from '../components/PageHeader.vue'
import { adminApi } from '../api/client'
import {
adminLinkLabel,
countText,
displayCountText,
displayCounts,
scheduleProgress,
todayEvents,
} from './dashboard'
import { useAuthStore } from '../stores/auth'
import { useEventStore } from '../stores/event'
@@ -17,6 +26,38 @@ const pendingEvents = computed(() => data.events.filter((event) => event.status
const topTeams = computed(() => data.standings.slice(0, 3))
const leader = computed(() => data.standings[0] ?? null)
/** 今天的小项与进度(devdocs/07 §7「当前赛程」卡片)。 */
const today = computed(() => todayEvents(data.events))
const todayProgress = computed(() => scheduleProgress(today.value))
const todayIds = computed(() => new Set(today.value.map((event) => event.id)))
/**
* 进度说明。
*
* 项目列表还没加载完时不能显示「今天没有排期」——那会把「还没读到」说成一条结论;
* 加载完成且确实没有排期时才是真的空。
*/
const todayHint = computed(() => {
if (!data.loaded) return '数据加载中…'
return todayProgress.value.text ?? '今天没有排期'
})
/**
* 待办:草稿待发布数、疑似破纪录待确认数。
*
* 两个数都来自各自的接口,读不到时为 null → 显示 `—`:卡片不能把「读不到」说成「0 条」。
*/
const draftCount = ref<number | null>(null)
const pendingBreakCount = ref<number | null>(null)
/**
* 大屏实例:`null` 表示数据源不可用(示例数据 / 接口失败)。
*
* adminApi.displayInstances 在连不上服务端时会退化成空数组,单看它分不清
* 「没有大屏」与「读不到」;示例数据模式(isMock)一律按读不到处理,显示 `—`。
*/
const displayInstances = ref<DisplayInstance[] | null>(null)
const displayTotal = computed(() => displayCountText(displayCounts(displayInstances.value)))
const connectionText = computed(() => {
if (data.isMock) return '示例数据'
if (data.realtimeStatus === 'online') return '实时在线'
@@ -24,12 +65,43 @@ const connectionText = computed(() => {
return '连接中断'
})
onMounted(async () => {
/** 管理端连接文案:没有「管理端在线数」接口,如实显示本机连接状态。 */
const adminLink = computed(() => adminLinkLabel(data.isMock, data.realtimeStatus))
/** 待确认数读不到时的说明:访客是权限问题,其余按接口不可用说。 */
const pendingBreakHint = computed(() => {
if (pendingBreakCount.value === null) return auth.readOnly ? '访客只读' : '接口不可用'
return pendingBreakCount.value > 0 ? '去「破纪录」页确认' : '没有待确认'
})
async function loadCards(): Promise<void> {
try {
records.value = await adminApi.records()
} catch {
records.value = []
}
// 每个数据源各自兜底:任何一个接口挂了都只让自己的卡片显示 —,不让整页崩。
try {
draftCount.value = await adminApi.draftResultCount()
} catch {
draftCount.value = null
}
try {
// GET /api/record-breaks 要求 recorder 及以上:访客必然 403,不必发这一枪。
pendingBreakCount.value = auth.readOnly ? null : (await adminApi.recordBreaks('pending')).length
} catch {
pendingBreakCount.value = null
}
try {
// GET /api/display/instances 要求 recorder 及以上:访客不必发这一枪(403 没有更多信息)。
displayInstances.value = data.isMock || auth.readOnly ? null : await adminApi.displayInstances()
} catch {
displayInstances.value = null
}
}
onMounted(() => {
void loadCards()
})
</script>
@@ -70,11 +142,47 @@ onMounted(async () => {
</div>
</section>
<!--
07 §7 承诺的另外三张卡片:今天的小项与进度、待办的两类数量、大屏在线数。
任何一个数据源读不到,只让那一张显示 —,不影响其它卡片。
-->
<section class="mx-stat-grid mx-section">
<div class="mx-stat">
<div class="mx-stat-label"><span class="mx-stat-icon"><MxIcon name="display" :size="14" /></span>今天的小项</div>
<div class="mx-stat-value">{{ !data.loaded || todayProgress.text === null ? '—' : todayProgress.total }}</div>
<span class="mx-stat-delta" :class="todayProgress.text === null ? '' : 'up'">
{{ todayHint }}
</span>
</div>
<div class="mx-stat">
<div class="mx-stat-label"><span class="mx-stat-icon"><MxIcon name="record" :size="14" /></span>草稿待发布</div>
<div class="mx-stat-value">{{ countText(draftCount) }}</div>
<span class="mx-stat-delta" :class="draftCount !== null && draftCount > 0 ? 'down' : 'up'">
{{ draftCount === null ? '接口不可用' : draftCount > 0 ? '已保存未发布' : '没有待发布草稿' }}
</span>
</div>
<div class="mx-stat">
<div class="mx-stat-label"><span class="mx-stat-icon"><MxIcon name="record" :size="14" /></span>待确认破纪录</div>
<div class="mx-stat-value">{{ countText(pendingBreakCount) }}</div>
<span class="mx-stat-delta" :class="pendingBreakCount !== null && pendingBreakCount > 0 ? 'down' : 'up'">
{{ pendingBreakHint }}
</span>
</div>
<div class="mx-stat">
<div class="mx-stat-label"><span class="mx-stat-icon"><MxIcon name="display" :size="14" /></span>大屏在线数</div>
<div class="mx-stat-value">{{ displayTotal }}</div>
<!-- 没有「管理端在线数」这种接口:这里显示本机管理端的连接状态,不编造数字。 -->
<span class="mx-stat-delta up">管理端:{{ adminLink }}</span>
</div>
</section>
<div class="dash-grid">
<section class="mx-card">
<div class="mx-card-head">
<span class="mx-card-title">当前赛程</span>
<span class="mx-badge mx-badge-neutral">{{ data.events.length }} 个小项</span>
<span class="mx-badge mx-badge-neutral">
{{ data.events.length }} 个小项 · 今天 {{ todayProgress.total }} 个
</span>
</div>
<div class="mx-card-body no-pad">
<div class="mx-table-wrap">
@@ -89,7 +197,10 @@ onMounted(async () => {
</thead>
<tbody>
<tr v-for="event in data.events.slice(0, 8)" :key="event.id">
<td>{{ event.name }}</td>
<td>
{{ event.name }}
<span v-if="todayIds.has(event.id)" class="mx-badge mx-badge-info today-tag">今天</span>
</td>
<td class="mono">{{ event.code }}</td>
<td>
<span
@@ -137,9 +248,24 @@ onMounted(async () => {
<li v-if="topTeams.length === 0" class="top-empty">暂无已发布成绩</li>
</ol>
<div v-if="pendingEvents.length > 0" class="todo">
<div v-if="pendingEvents.length > 0 || draftCount !== null || pendingBreakCount !== null" class="todo">
<div class="todo-title"><MxIcon name="warning" :size="14" /> 待办</div>
<p>
<ul class="todo-list">
<li>
草稿待发布:
<strong>{{ countText(draftCount) }}</strong>
{{ draftCount === null ? '(读不到,接口不可用)' : '条成绩草稿还没发布' }}
</li>
<li>
疑似破纪录待确认:
<strong>{{ countText(pendingBreakCount) }}</strong>
{{ pendingBreakCount === null ? '(读不到,接口不可用)' : '条' }}
<RouterLink v-if="pendingBreakCount !== null && pendingBreakCount > 0" class="mx-btn mx-btn-ghost mx-btn-sm" :to="{ name: 'records' }">
去确认
</RouterLink>
</li>
</ul>
<p v-if="pendingEvents.length > 0">
还有 {{ pendingEvents.length }} 个项目未录入:
{{ pendingEvents.map((event) => event.name).join('、') }}
</p>
@@ -237,6 +363,20 @@ onMounted(async () => {
margin-bottom: 10px;
line-height: 1.6;
}
.todo-list {
display: flex;
flex-direction: column;
gap: 6px;
margin-bottom: 10px;
line-height: 1.6;
}
.todo-list strong {
color: var(--mx-t1);
}
.today-tag {
margin-left: 6px;
font-size: 10px;
}
.foot-hint {
margin-top: 20px;
font-size: 12px;
+174 -4
View File
@@ -48,6 +48,15 @@ import {
type EntryBatchPlan,
type EntryBatchRow,
} from './entryBatch'
import {
RESULT_ACTION_CONFIRM,
RESULT_ACTION_SUCCESS,
RESULT_ROW_ACTION_LABEL,
RESULT_ROW_ACTION_TITLE,
RESULT_ROW_ACTION_WORD,
resultActionTarget,
type ResultActionTarget,
} from './entryResultActions'
import {
DEFAULT_HEAT_SIZE,
MAX_HEAT,
@@ -60,7 +69,7 @@ import {
type HeatAllocation,
type HeatFilter,
} from './entryHeat'
import { adminApi } from '../api/client'
import { adminApi, sampleDataBlockedNotice } from '../api/client'
import { computeEventScore, type ScorableRow } from '../api/scoring'
import { entryRowLabel } from '../components/baseData/entrySelection'
import { settlementApi, type SettlementGroup, type SettlementStatus } from '../components/system/systemApi'
@@ -83,6 +92,8 @@ interface EditableRow {
heat: number | null
/** 报名项状态:与成绩状态(status)无关,退赛 / 取消资格看这一列。 */
entryStatus: EntryStatus
/** 成绩 id(服务端按它定位作废 / 退回;草稿行也有,未报名时才是 null)。 */
resultId: number | null
resultText: string
rank: number | null
status: ResultStatus
@@ -453,6 +464,34 @@ function rowLocked(row: EditableRow): boolean {
return row.resultState === 'published'
}
/**
* 每行的行操作(作废本条 / 重新录入):判定在 entryResultActions 的纯函数里。
*
* 与 judgements 同口径——按当前可见行算,筛选后看不见的行不会残留按钮。
*/
const rowActions = computed<Map<number, ResultActionTarget>>(() => {
const map = new Map<number, ResultActionTarget>()
for (const row of visibleRows.value) {
const target = resultActionTarget(row)
if (target !== null) map.set(row.entryId, target)
}
return map
})
function rowAction(row: EditableRow): ResultActionTarget | null {
return rowActions.value.get(row.entryId) ?? null
}
function rowActionLabel(row: EditableRow): string {
const target = rowAction(row)
return target === null ? '' : RESULT_ROW_ACTION_LABEL[target.action]
}
function rowActionTitle(row: EditableRow): string {
const target = rowAction(row)
return target === null ? '' : RESULT_ROW_ACTION_TITLE[target.action]
}
/**
* 每一行的发布判定:✅已填 / ⚠️未录 / 🚫有错。
*
@@ -505,7 +544,12 @@ const focusedHint = computed<ResultCellHint | null>(() => {
/** 失焦后由既有的红框 + title 承载原因;合法成绩不写 title,避免无意义悬浮。 */
function resultTitle(row: EditableRow): string {
if (rowLocked(row)) return '已发布,请先撤销发布'
if (rowLocked(row)) {
// 已作废的行同样是「锁定」的,但原因是作废而不是发布:提示要指向真正的出路。
return row.status === 'withdrawn'
? '本条已作废:不计入名次与积分,用「重新录入」退回草稿后才能修改'
: '已发布,请先撤销发布'
}
const hint = resultHintOf(row)
return hint !== null && hint.level !== 'ok' ? hint.message : ''
}
@@ -681,6 +725,7 @@ function toRow(entry: EntryWithResult): EditableRow {
memberNames: entry.memberNames,
heat: entry.heat,
entryStatus: entry.status,
resultId: result?.id ?? null,
resultText: result?.resultText ?? '',
rank: result?.rank ?? null,
status: result?.status ?? 'ok',
@@ -1350,6 +1395,69 @@ const BATCH_CONFIRM_TEXT: Record<EntryBatchAction, string> = {
remove: '确认移出',
}
// ── 单条作废 / 重新录入(A16:外科手术式改一条,不必整组撤销发布) ──────────────
/** 待确认的行操作;非 null 时确认框打开。 */
const resultAction = ref<ResultActionTarget | null>(null)
const resultActionBusy = ref(false)
/** 确认框文案随动作变(作废 / 退回草稿的后果不同)。 */
const resultActionCopy = computed(() => RESULT_ACTION_CONFIRM[resultAction.value?.action ?? 'void'])
/**
* 点行操作按钮:先做前置检查(示例数据 / 只读 / 未保存修改),再弹确认框。
*
* 与批量操作同一口径——它会重算并刷新整表,未保存的编辑必须先落草稿,
* 否则刚填的名次会被服务端返回的口径覆盖掉。
*/
function requestResultAction(row: EditableRow): void {
const target = rowAction(row)
if (target === null) return
if (data.isMock) {
// 示例数据模式下写接口没有后端可落库,提示成功等于谎报(与发布 / 批量操作同口径)。
const notice = sampleDataBlockedNotice(RESULT_ROW_ACTION_WORD[target.action])
toast.error(notice.title, notice.detail)
return
}
if (!canWrite.value) {
toast.error('当前不可写入', auth.readOnly ? '请先登录' : '服务端未连接')
return
}
if (dirty.value) {
toast.error('有未保存的修改', '作废 / 退回会重算并刷新整表,请先「存草稿」/「保存团体名次」再操作')
return
}
resultAction.value = target
}
/** 确认框回传的原因;空原因由 ConfirmDialog 拦下,这里拿到的一定是填好的。 */
async function confirmResultAction(reason: string): Promise<void> {
const target = resultAction.value
if (target === null || resultActionBusy.value) return
resultActionBusy.value = true
try {
if (target.action === 'void') {
await adminApi.voidResult(target.resultId, { reason })
} else {
await adminApi.reopenResult(target.resultId, { reason })
}
resultAction.value = null
// 名次 / 积分 / 大屏都由服务端重算:整表 + 榜单一起重拉,不在本地行上打补丁。
await reloadAfterSettlementChange()
const success = RESULT_ACTION_SUCCESS[target.action]
toast.success(success.title, success.detail)
} catch (caught) {
toast.error(target.action === 'void' ? '作废失败' : '退回草稿失败', caught instanceof Error ? caught.message : null)
} finally {
resultActionBusy.value = false
}
}
function cancelResultAction(): void {
if (resultActionBusy.value) return
resultAction.value = null
}
/** 一键均分:先亮明「动哪些人、怎么切、编到第几批」,确认后才提交。 */
function requestSplit(): void {
const plan = splitPlan.value
@@ -1810,6 +1918,7 @@ watch([selectedEventId, selectedCategoryId], () => void refreshSettlement(), { i
<th>状态</th>
<th class="center">积分(自动)</th>
<th>备注</th>
<th class="center action-col">操作</th>
</tr>
</thead>
<tbody>
@@ -1827,8 +1936,17 @@ watch([selectedEventId, selectedCategoryId], () => void refreshSettlement(), { i
<input v-model="selectedEntryIds" type="checkbox" :value="row.entryId" />
</td>
<td class="center">
<!--
已作废是独立状态:它仍是 published(所以输入框照样锁着),
但成绩不计入名次与积分,徽标必须先说清这件事,别只显示「已发布」。
-->
<span
v-if="row.resultState === 'published'"
v-if="row.resultState === 'published' && row.status === 'withdrawn'"
class="mx-badge mx-badge-error"
title="本条已作废:不计入名次与积分,可用「重新录入」退回草稿"
>已作废</span>
<span
v-else-if="row.resultState === 'published'"
class="mx-badge mx-badge-success"
title="已发布上屏"
>已发布</span>
@@ -1937,9 +2055,27 @@ watch([selectedEventId, selectedCategoryId], () => void refreshSettlement(), { i
@keydown="onCellKeydown($event, $event.currentTarget as HTMLElement)"
/>
</td>
<!--
行操作区:只对已发布的行出现(草稿行本来就能直接改)。
guest / 断线只读时按钮保留但置灰,让访客看得到「这里能作废」而不是一片空白。
-->
<td class="center action-cell">
<button
v-if="rowAction(row) !== null"
class="mx-btn mx-btn-sm"
:class="rowAction(row)?.action === 'reopen' ? 'mx-btn-secondary' : 'mx-btn-danger'"
type="button"
:disabled="!canWrite || resultActionBusy"
:title="rowActionTitle(row)"
@click="requestResultAction(row)"
>
{{ rowActionLabel(row) }}
</button>
<span v-else class="muted">—</span>
</td>
</tr>
<tr v-if="!loading && visibleRows.length === 0">
<td colspan="11">
<td colspan="12">
<div class="mx-empty">
<div class="mx-empty-title">
{{ categoryRows.length === 0 ? '该组还没有报名项' : '该批次没有报名项' }}
@@ -2099,6 +2235,28 @@ watch([selectedEventId, selectedCategoryId], () => void refreshSettlement(), { i
@cancel="unpublishDialog = false"
/>
<!--
单条作废 / 重新录入:原因必填(服务端写审计),后果写在弹窗里。
与「撤销发布」分开:这是外科手术式改一条,不动同组其它已发布成绩。
-->
<ConfirmDialog
:open="resultAction !== null"
tone="danger"
:title="resultActionCopy.title"
:message="resultActionCopy.message"
:details="
resultAction === null
? []
: [`${resultAction.resultText === '' ? '(空成绩)' : resultAction.resultText}`, '同组其它人的名次与积分会一起重算并推送大屏']
"
:confirm-text="resultActionCopy.confirmText"
:reason-required="true"
:reason-label="resultActionCopy.reasonLabel"
:pending="resultActionBusy"
@confirm="confirmResultAction"
@cancel="cancelResultAction"
/>
<ConfirmDialog
:open="settleDialog"
tone="warning"
@@ -2426,6 +2584,18 @@ watch([selectedEventId, selectedCategoryId], () => void refreshSettlement(), { i
.team-cell {
font-weight: 600;
}
/* 行操作区:窄列、不换行,按钮别把整张表撑宽。 */
.action-col,
.action-cell {
width: 96px;
white-space: nowrap;
}
.action-cell .mx-btn {
width: 100%;
}
.action-cell .muted {
color: var(--mx-t3);
}
/*
* 团体名次区块:与成绩表分开的一张卡片,横向铺开单位 + 名次输入框。
* 只读(guest / 断线)时整块降透明度,配合卡片内的只读提示说明原因。
+544 -32
View File
@@ -5,6 +5,7 @@ import {
formatDateTime,
formatPoints,
type Event,
type RecordBreak,
type RecordEntry,
type RecordLevel,
type RulePack,
@@ -13,7 +14,19 @@ import {
import MxIcon from '../components/MxIcon.vue'
import PageHeader from '../components/PageHeader.vue'
import ConfirmDialog from '../components/ConfirmDialog.vue'
import { adminApi } from '../api/client'
import { adminApi, sampleDataBlockedNotice } from '../api/client'
import {
IGNORE_BREAK_REASON,
RECORD_LEVEL_LABELS,
RECORD_LEVEL_OPTIONS,
RECORD_LEVEL_ORDER,
breakKey,
breakNote,
breakBonusText,
handledBreakKeys,
recordSourceLabel,
} from './recordBreaks'
import { emptyRecordForm, planRecordInput, type RecordFormState } from './recordForm'
import { useAuthStore } from '../stores/auth'
import { useEventStore } from '../stores/event'
import { useToastStore } from '../stores/toast'
@@ -44,15 +57,6 @@ interface RecordGroup {
records: RecordEntry[]
}
const LEVEL_LABELS: Record<RecordLevel, string> = {
meet: '赛会',
city: '市级',
province: '省级',
national: '全国',
}
const LEVEL_ORDER: RecordLevel[] = ['meet', 'city', 'province', 'national']
const data = useEventStore()
const auth = useAuthStore()
const toast = useToastStore()
@@ -73,10 +77,39 @@ const levelFilter = ref<RecordLevel | 'all'>('all')
const approveTarget = ref<SuspectedBreak | null>(null)
const approving = ref(false)
const rejectTarget = ref<SuspectedBreak | null>(null)
/** 拒绝没有服务端接口,只能在本地标记;列表刷新后会重新出现。 */
const rejecting = ref(false)
/**
* 兜底用的本地标记。
*
* 服务端登记成功后靠「已处理登记」抑制(handledKeys),这两个数组只在接口写不进去时
* (示例数据 / 后端旧版)用,并且提示里会如实说明「仅本机有效,刷新后重新出现」。
*/
const rejectedKeys = ref<string[]>([])
const approvedKeys = ref<string[]>([])
/** 已批准的破纪录登记(GET /api/record-breaks?state=approved)。 */
const approvedBreaks = ref<RecordBreak[]>([])
const breaksLoading = ref(false)
const breaksError = ref<string | null>(null)
/** 接口读不到(示例数据 / 后端旧版)时卡片显示空态说明,绝不让整页报错。 */
const breaksUnavailable = ref(false)
/** 读不到是因为权限(guest):文案与「接口不可用」不同,别把权限说成后端太旧。 */
const breaksForbidden = ref(false)
/** 已处理登记(approved + rejected)的键,用来抑制前端推导出的疑似列表。 */
const handledKeys = ref<Set<string>>(new Set())
const revokeTarget = ref<RecordBreak | null>(null)
const revoking = ref(false)
/** 新增历史纪录表单(P2 C11)。 */
const createOpen = ref(false)
const createForm = ref<RecordFormState>(emptyRecordForm())
const createError = ref('')
const creating = ref(false)
/** 删除纪录确认。 */
const deleteTarget = ref<RecordEntry | null>(null)
const deleting = ref(false)
const canWrite = computed(() => !auth.readOnly && data.canWrite)
const isAdmin = computed(() => auth.user?.role === 'admin')
/**
@@ -129,14 +162,24 @@ const recordGroups = computed<RecordGroup[]>(() => {
.sort((a, b) => a.eventName.localeCompare(b.eventName))
})
/**
* 待确认的疑似破纪录。
*
* 三层过滤:推导出的疑似条目,减去本机兜底标记(接口写不进去时用的),
* 再减去服务端已登记(approved / rejected)的键——最后这层才是「驳回以后刷新不再出现」的关键。
*/
const pendingBreaks = computed(() =>
suspected.value.filter(
(item) => !rejectedKeys.value.includes(item.key) && !approvedKeys.value.includes(item.key),
(item) =>
!rejectedKeys.value.includes(item.key) &&
!approvedKeys.value.includes(item.key) &&
!handledKeys.value.has(item.key),
),
)
/** 档位序号:排序与筛选下拉共用(登记卡片与纪录库都要按同一顺序排)。 */
function levelRank(level: RecordLevel): number {
const index = LEVEL_ORDER.indexOf(level)
const index = RECORD_LEVEL_ORDER.indexOf(level)
return index < 0 ? 0 : index
}
@@ -154,6 +197,20 @@ function teamLabel(teamId: number): string {
return team?.shortName ?? team?.name ?? `单位 ${teamId}`
}
/** 破纪录登记只带 eventId,卡片里要显示小项名与代码;查不到时给出可定位的占位。 */
function eventNameOf(eventId: number): string {
return data.eventById(eventId)?.name ?? `项目 ${eventId}`
}
function eventCodeOf(eventId: number): string {
return data.eventById(eventId)?.code ?? ''
}
/** 保持人单位:登记的是单位 id,可能在单位列表里查不到(已停用 / 已删)。 */
function holderTeamLabel(teamId: number | null): string {
return teamId === null ? '—' : teamLabel(teamId)
}
/** 只有「已发布 + 有效成绩」才可能破纪录;草稿永远不参与判断。 */
function beats(compare: Event['compare'], value: number, recordValue: number): boolean {
if (compare === 'asc') return value < recordValue
@@ -225,6 +282,42 @@ async function loadRecords(): Promise<void> {
}
}
/**
* 读破纪录登记(approved + rejected 两态)。
*
* 两态分开取:approved 是「已批准的破纪录」卡片的数据源,两者合起来才能算出
* 「已经处理过」的键去抑制前端推导出的疑似列表(驳回过的条目刷新后不该再冒出来)。
*
* 读不到时(示例数据 / 后端旧版 404)不让整页报错,只把卡片置为空态说明;
* 这时「忽略」退回本机标记,并在提示里如实说明刷新后会重新出现。
*/
async function loadBreaks(): Promise<void> {
breaksLoading.value = true
const [approved, rejected] = await Promise.allSettled([
adminApi.recordBreaks('approved'),
adminApi.recordBreaks('rejected'),
])
const failures = [approved, rejected].filter((result) => result.status === 'rejected')
const failure = failures[0]
breaksUnavailable.value = failure !== undefined
// GET /api/record-breaks 要求 recorder 及以上:guest 必然 403,那是权限边界而不是后端太旧。
breaksForbidden.value = failures.some((item) => isForbidden(item.reason))
breaksError.value =
failure !== undefined
? failure.reason instanceof Error
? failure.reason.message
: '读取破纪录登记失败'
: null
// 部分成功也照收:能抑制多少算多少,读不到的那一态由上面的空态说明交代。
const loaded: RecordBreak[] = [
...(approved.status === 'fulfilled' ? approved.value : []),
...(rejected.status === 'fulfilled' ? rejected.value : []),
]
approvedBreaks.value = approved.status === 'fulfilled' ? approved.value : []
handledKeys.value = handledBreakKeys(loaded)
breaksLoading.value = false
}
async function loadSuspected(): Promise<void> {
if (!data.loaded) return
suspectedLoading.value = true
@@ -250,7 +343,7 @@ async function loadSuspected(): Promise<void> {
}
if (best === null) continue
list.push({
key: `${event.id}-${entry.id}-${best.level}`,
key: breakKey(event.id, entry.id, best.level),
eventId: event.id,
eventName: event.name,
eventCode: event.code,
@@ -315,10 +408,10 @@ async function confirmApprove(): Promise<void> {
toast.success(
'已确认破纪录',
item.bonusPoints === null
? `${LEVEL_LABELS[item.level]}纪录,加分分值以服务端结果为准`
: `+${formatPoints(item.bonusPoints)} 分(${LEVEL_LABELS[item.level]})`,
? `${RECORD_LEVEL_LABELS[item.level]}纪录,加分分值以服务端结果为准`
: `+${formatPoints(item.bonusPoints)} 分(${RECORD_LEVEL_LABELS[item.level]})`,
)
await Promise.all([loadRecords(), data.refreshStandings()])
await Promise.all([loadRecords(), data.refreshStandings(), loadBreaks()])
} catch (caught) {
if (isFallback(caught)) {
// 后端未就绪:只做本地标记,绝不假装写成功。
@@ -333,16 +426,187 @@ async function confirmApprove(): Promise<void> {
}
}
function confirmReject(): void {
/** 「忽略」确认框正文:示例数据模式下写不进去,必须如实说明只在本机生效。 */
const rejectMessage = computed(() =>
data.isMock
? '示例数据模式没有后端可写:只在本机隐藏该条,刷新页面后它会重新出现。'
: '会在服务端登记为一条破纪录记录并立即驳回(原因写「现场判定不是破纪录」),刷新后不会再出现在待确认列表里。',
)
/**
* 「忽略」疑似破纪录:在服务端登记一条 pending 再驳回,原因是固定的「现场判定不是破纪录」。
*
* 以前只在本地数组里藏起来,刷新就回来——现场看到的「已忽略」和服务端真实状态不一致。
* 现在只有真的写不进去(示例数据 / 未连接服务端)才退回本机标记,并如实说明仅本机有效。
*/
async function confirmReject(): Promise<void> {
const item = rejectTarget.value
if (item === null) return
rejectedKeys.value = [...rejectedKeys.value, item.key]
rejectTarget.value = null
toast.info('已拒绝该条', '接口未提供拒绝动作,仅在本地隐藏,刷新后会重新出现')
if (item === null || rejecting.value) return
if (!canWrite.value) {
toast.error('当前不可写入', auth.readOnly ? '请先登录' : '服务端未连接')
return
}
rejecting.value = true
try {
const created = await adminApi.client.records.createBreak({
eventId: item.eventId,
entryId: item.entryId,
level: item.level,
resultValue: item.resultValue,
resultText: item.resultText,
})
await adminApi.rejectBreak(created.id, IGNORE_BREAK_REASON)
rejectedKeys.value = [...rejectedKeys.value, item.key]
rejectTarget.value = null
toast.success('已拒绝该条疑似破纪录', '已在服务端登记并驳回,刷新后不会再出现')
await loadBreaks()
} catch (caught) {
if (isFallback(caught)) {
// 后端未就绪:只能在本机隐藏,绝不假装写成功;提示里必须说清刷新后会回来。
rejectedKeys.value = [...rejectedKeys.value, item.key]
rejectTarget.value = null
toast.warning('已在本机忽略(未连接服务端)', '没有写入服务端,刷新页面后该条会重新出现')
} else {
toast.error('拒绝失败', caught instanceof Error ? caught.message : null)
}
} finally {
rejecting.value = false
}
}
// ── 已批准的破纪录:作废(撤回加分 + 恢复上一条纪录) ────────────────────────
/** 示例数据模式统一拦截写操作;返回 true 表示已拦下。 */
function blockSampleData(action: string): boolean {
if (!data.isMock) return false
const notice = sampleDataBlockedNotice(action)
toast.error(notice.title, notice.detail)
return true
}
/** 点「作废」:先过权限与示例数据,再弹必填原因的确认框。 */
function requestRevoke(item: RecordBreak): void {
if (blockSampleData('作废破纪录')) return
if (!canWrite.value) {
toast.error('当前不可写入', auth.readOnly ? '请先登录' : '服务端未连接')
return
}
revokeTarget.value = item
}
async function confirmRevoke(reason: string): Promise<void> {
const item = revokeTarget.value
if (item === null || revoking.value) return
revoking.value = true
try {
await adminApi.rejectBreak(item.id, reason)
revokeTarget.value = null
// 撤回加分与「恢复上一条纪录」都在服务端同一事务里做完:纪录库与榜单必须重拉。
await Promise.all([loadRecords(), data.refreshStandings()])
await Promise.all([loadBreaks(), loadSuspected()])
toast.success(
'加分已撤回,该级别纪录已恢复上一条',
`已作废 ${RECORD_LEVEL_LABELS[item.level]}破纪录登记(${breakBonusText(item)})`,
)
} catch (caught) {
toast.error('作废破纪录失败', caught instanceof Error ? caught.message : null)
} finally {
revoking.value = false
}
}
function cancelRevoke(): void {
if (revoking.value) return
revokeTarget.value = null
}
// ── 纪录库:新增历史纪录 / 删除 ──────────────────────────────────────────────
/** 打开新增表单:每次都用空表单,别把上一次的输入带进来。 */
function openCreate(): void {
if (blockSampleData('新增历史纪录')) return
if (!canWrite.value) {
toast.error('当前不可写入', auth.readOnly ? '请先登录' : '服务端未连接')
return
}
createForm.value = emptyRecordForm(data.events[0]?.id ?? null)
createError.value = ''
createOpen.value = true
}
function closeCreate(): void {
if (creating.value) return
createOpen.value = false
}
/** 保持下拉受控:小项 / 单位允许留空(null),空值不能变成字符串 "null"。 */
function formEventId(event: globalThis.Event): number | null {
const raw = (event.target as HTMLSelectElement).value
return raw === '' ? null : Number(raw)
}
function formTeamId(event: globalThis.Event): number | null {
const raw = (event.target as HTMLSelectElement).value
return raw === '' ? null : Number(raw)
}
async function submitCreate(): Promise<void> {
if (creating.value) return
const plan = planRecordInput(createForm.value)
if (!plan.ok) {
createError.value = plan.error
return
}
createError.value = ''
creating.value = true
try {
await adminApi.createRecord(plan.input)
createOpen.value = false
// 新纪录可能比现有纪录更优 → 疑似破纪录的推导会变,两件事一起重拉。
await loadRecords()
await loadSuspected()
toast.success('已新增历史纪录', '来源记为「历史」')
} catch (caught) {
toast.error('新增历史纪录失败', caught instanceof Error ? caught.message : null)
} finally {
creating.value = false
}
}
/** 点「删除」:先过权限与示例数据,再弹确认(说清「当前纪录会自动恢复上一条」)。 */
function requestDelete(record: RecordEntry): void {
if (blockSampleData('删除纪录')) return
if (!canWrite.value) {
toast.error('当前不可写入', auth.readOnly ? '请先登录' : '服务端未连接')
return
}
deleteTarget.value = record
}
async function confirmDelete(): Promise<void> {
const record = deleteTarget.value
if (record === null || deleting.value) return
deleting.value = true
try {
await adminApi.removeRecord(record.id)
deleteTarget.value = null
await loadRecords()
await loadSuspected()
toast.success('已删除该条纪录', '若它是当前纪录,服务端已恢复上一条')
} catch (caught) {
toast.error('删除纪录失败', caught instanceof Error ? caught.message : null)
} finally {
deleting.value = false
}
}
function cancelDelete(): void {
if (deleting.value) return
deleteTarget.value = null
}
async function refreshAll(): Promise<void> {
await Promise.all([loadRecords(), loadRules()])
await Promise.all([loadRecords(), loadRules(), loadBreaks()])
await loadSuspected()
}
@@ -460,7 +724,7 @@ watch(
</td>
<td class="mono highlight">{{ item.resultText }}</td>
<td class="mono">{{ item.recordText }}</td>
<td><span class="mx-tag mx-tag-primary">{{ LEVEL_LABELS[item.level] }}</span></td>
<td><span class="mx-tag mx-tag-primary">{{ RECORD_LEVEL_LABELS[item.level] }}</span></td>
<td class="right mono points">
{{ item.bonusPoints === null ? '—' : `+${formatPoints(item.bonusPoints)}` }}
</td>
@@ -495,21 +759,105 @@ watch(
</div>
</section>
<!--
已批准的破纪录(A41):加分一旦批出去就要能撤回。
数据来自服务端登记表,不是前端推导——所以作废后刷新页面也仍然生效。
-->
<section class="mx-card mx-section">
<div class="mx-card-head">
<span class="mx-card-title">已批准的破纪录</span>
<span class="mx-badge mx-badge-neutral">{{ approvedBreaks.length }} 条</span>
</div>
<div class="mx-card-body">
<div v-if="breaksLoading" class="mx-empty">
<div class="mx-spinner mx-spinner-sm"></div>
<div class="mx-empty-title">正在加载已批准的破纪录…</div>
</div>
<!-- 接口读不到时只让这张卡片显示空态说明,页面其余部分照常可用。 -->
<div v-else-if="breaksUnavailable" class="mx-empty">
<div class="mx-empty-icon"><MxIcon name="warning" :size="26" /></div>
<div class="mx-empty-title">{{ breaksForbidden ? '访客只读:看不到破纪录登记' : '读不到破纪录登记' }}</div>
<div v-if="breaksForbidden" class="mx-empty-desc">
破纪录登记(含待审核的登记与驳回理由)要求录入员及以上权限;登录后即可查看与作废。
</div>
<div v-else class="mx-empty-desc">
{{ breaksError ?? '接口不可用' }};示例数据模式或后端版本较旧时没有这个接口,
已批准的破纪录无法在这里作废,请在服务端升级后再试。
</div>
<button class="mx-btn mx-btn-ghost mx-btn-sm" type="button" @click="loadBreaks">重试</button>
</div>
<div v-else-if="approvedBreaks.length === 0" class="mx-empty">
<div class="mx-empty-icon"><MxIcon name="record" :size="26" /></div>
<div class="mx-empty-title">没有已批准的破纪录</div>
<div class="mx-empty-desc">在「疑似破纪录」里点「确认加分」后,登记会出现在这里</div>
</div>
<div v-else class="mx-table-wrap">
<table class="mx-table mx-table-compact">
<thead>
<tr>
<th>小项</th>
<th>级别</th>
<th>成绩</th>
<th class="right">加分</th>
<th>批准时间</th>
<th>说明</th>
<th class="right">操作</th>
</tr>
</thead>
<tbody>
<tr v-for="item in approvedBreaks" :key="item.id">
<td>
<span class="event-name">{{ eventNameOf(item.eventId) }}</span>
<small class="mono event-code">{{ eventCodeOf(item.eventId) }}</small>
</td>
<td><span class="mx-tag mx-tag-primary">{{ RECORD_LEVEL_LABELS[item.level] }}</span></td>
<td class="mono highlight">{{ item.resultText }}</td>
<td class="right mono points">{{ breakBonusText(item) }}</td>
<td class="mono">{{ formatDateTime(item.approvedAt) }}</td>
<!-- note 是新增字段,旧服务端不下发:缺字段时整格留白,不显示 undefined。 -->
<td class="note">{{ breakNote(item) ?? '—' }}</td>
<td class="right actions">
<button
class="mx-btn mx-btn-danger mx-btn-sm"
type="button"
:disabled="!canWrite || revoking"
title="作废后撤回该笔加分,并恢复该级别的上一条纪录"
@click="requestRevoke(item)"
>
作废
</button>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</section>
<section class="mx-card mx-section">
<div class="mx-card-head">
<span class="mx-card-title">纪录库</span>
<div class="head-tools">
<button
class="mx-btn mx-btn-primary mx-btn-sm"
type="button"
:disabled="!canWrite"
:title="canWrite ? '登记一条历史纪录(来源记为「历史」)' : '访客只读,无法新增'"
@click="openCreate"
>
<MxIcon name="entry" :size="14" /> 新增历史纪录
</button>
<div class="mx-tabs">
<button class="mx-tab" :class="{ active: levelFilter === 'all' }" type="button" @click="levelFilter = 'all'">全部</button>
<button
v-for="level in LEVEL_ORDER"
v-for="level in RECORD_LEVEL_ORDER"
:key="level"
class="mx-tab"
:class="{ active: levelFilter === level }"
type="button"
@click="levelFilter = level"
>
{{ LEVEL_LABELS[level] }}
{{ RECORD_LEVEL_LABELS[level] }}
</button>
</div>
<div class="mx-input-wrap search">
@@ -551,20 +899,37 @@ watch(
<th>达成时间</th>
<th>来源</th>
<th class="center">当前</th>
<th class="right">操作</th>
</tr>
</thead>
<tbody>
<tr v-for="record in group.records" :key="record.id">
<td><span class="mx-tag" :class="record.isCurrent ? 'mx-tag-primary' : ''">{{ LEVEL_LABELS[record.level] }}</span></td>
<td><span class="mx-tag" :class="record.isCurrent ? 'mx-tag-primary' : ''">{{ RECORD_LEVEL_LABELS[record.level] }}</span></td>
<td class="mono highlight">{{ record.resultText }}</td>
<td>{{ record.holderName ?? '—' }}</td>
<td>{{ record.holderTeamId === null ? '—' : teamLabel(record.holderTeamId) }}</td>
<td>{{ holderTeamLabel(record.holderTeamId) }}</td>
<td class="mono">{{ formatDateTime(record.achievedAt) }}</td>
<td>{{ record.source === 'current' ? '本届' : '历史' }}</td>
<!-- 来源:历史 = 老资料登记进来的,本届 = 本场赛事产生的;缺字段显示 —,不冒充「历史」。 -->
<td>
<span class="mx-badge" :class="record.source === 'history' ? 'mx-badge-neutral' : 'mx-badge-info'">
{{ recordSourceLabel(record.source) }}
</span>
</td>
<td class="center">
<span v-if="record.isCurrent" class="mx-badge mx-badge-success">当前</span>
<span v-else class="muted">—</span>
</td>
<td class="right">
<button
class="mx-btn mx-btn-ghost mx-btn-sm"
type="button"
:disabled="!canWrite || deleting"
title="删除该条纪录"
@click="requestDelete(record)"
>
删除
</button>
</td>
</tr>
</tbody>
</table>
@@ -582,8 +947,8 @@ watch(
approveTarget === null
? ''
: approveTarget.bonusPoints === null
? `将登记「${approveTarget.eventName} · ${approveTarget.athleteName}」的 ${LEVEL_LABELS[approveTarget.level]}纪录;加分分值未知,以服务端结果为准。`
: `将登记「${approveTarget.eventName} · ${approveTarget.athleteName}」的 ${LEVEL_LABELS[approveTarget.level]}纪录,并生成 +${formatPoints(approveTarget.bonusPoints)} 分加分流水。`
? `将登记「${approveTarget.eventName} · ${approveTarget.athleteName}」的 ${RECORD_LEVEL_LABELS[approveTarget.level]}纪录;加分分值未知,以服务端结果为准。`
: `将登记「${approveTarget.eventName} · ${approveTarget.athleteName}」的 ${RECORD_LEVEL_LABELS[approveTarget.level]}纪录,并生成 +${formatPoints(approveTarget.bonusPoints)} 分加分流水。`
"
:details="[
`成绩:${approveTarget?.resultText ?? ''}(原纪录 ${approveTarget?.recordText ?? ''})`,
@@ -599,12 +964,126 @@ watch(
:open="rejectTarget !== null"
tone="danger"
title="拒绝这条疑似破纪录?"
message="拒绝只在本地隐藏该条,不会写入服务端;接口清单里没有拒绝动作。"
:message="rejectMessage"
:details="rejectTarget === null ? [] : [`成绩:${rejectTarget.resultText}`, `小项:${rejectTarget.eventName}`]"
confirm-text="确认拒绝"
:pending="rejecting"
@confirm="confirmReject"
@cancel="rejectTarget = null"
/>
<!--
作废已批准的破纪录:批准时加过分,作废要把那笔加分撤掉并恢复上一条纪录,
所以原因必填(写审计),后果写在弹窗里。
-->
<ConfirmDialog
:open="revokeTarget !== null"
tone="danger"
title="确认作废这条破纪录登记?"
message="作废后将撤回该笔加分,并恢复该级别的上一条纪录;大屏与此处纪录库会立即更新。"
:details="
revokeTarget === null
? []
: [
`小项:${eventNameOf(revokeTarget.eventId)}`,
`成绩:${revokeTarget.resultText}(${RECORD_LEVEL_LABELS[revokeTarget.level]})`,
`撤回加分:${breakBonusText(revokeTarget)}`,
]
"
confirm-text="确认作废"
:reason-required="true"
reason-label="作废原因"
:pending="revoking"
@confirm="confirmRevoke"
@cancel="cancelRevoke"
/>
<ConfirmDialog
:open="deleteTarget !== null"
tone="danger"
title="确认删除这条纪录?"
:message="
deleteTarget === null
? ''
: `将删除「${eventNameOf(deleteTarget.eventId)}」的${RECORD_LEVEL_LABELS[deleteTarget.level]}纪录 ${deleteTarget.resultText};若它是当前纪录,会恢复上一条。`
"
:details="['删除只影响纪录库,不会改动任何已发布的成绩与积分']"
confirm-text="确认删除"
:pending="deleting"
@confirm="confirmDelete"
@cancel="cancelDelete"
/>
<!-- 新增历史纪录表单:成绩值 / 成绩文本至少一个,其余可留空(老资料常常只有一部分)。 -->
<div v-if="createOpen" class="mx-modal-overlay open" @click.self="closeCreate">
<div class="mx-modal" role="dialog" aria-modal="true">
<div class="mx-modal-head">
<span class="mx-modal-title">新增历史纪录</span>
<button class="mx-modal-close" type="button" :disabled="creating" @click="closeCreate">
<MxIcon name="close" :size="16" />
</button>
</div>
<div class="mx-modal-body create-body">
<p class="create-hint">
登记的是<strong>历史资料</strong>(秩序册 / 上届成绩),来源固定记为「历史」,与本届成绩无关。
</p>
<label class="create-field">
<span>小项</span>
<select class="mx-input" :value="createForm.eventId ?? ''" @change="createForm.eventId = formEventId($event)">
<option value="">请选择小项</option>
<option v-for="event in data.events" :key="event.id" :value="event.id">
{{ event.name }}
</option>
</select>
</label>
<label class="create-field">
<span>级别</span>
<select v-model="createForm.level" class="mx-input">
<option v-for="option in RECORD_LEVEL_OPTIONS" :key="option.value" :value="option.value">
{{ option.label }}
</option>
</select>
</label>
<div class="create-row">
<label class="create-field">
<span>成绩值</span>
<input v-model="createForm.resultValue" class="mx-input mono" placeholder="例 11.2(秒 / 米 / 次)" />
</label>
<label class="create-field">
<span>成绩文本</span>
<input v-model="createForm.resultText" class="mx-input mono" placeholder="例 11.20 或 1:06.33" />
</label>
</div>
<p class="create-hint">成绩值与成绩文本至少填一个;比较与破纪录判断以成绩值为准。</p>
<div class="create-row">
<label class="create-field">
<span>保持人姓名</span>
<input v-model="createForm.holderName" class="mx-input" placeholder="可留空" />
</label>
<label class="create-field">
<span>保持单位</span>
<select class="mx-input" :value="createForm.holderTeamId ?? ''" @change="createForm.holderTeamId = formTeamId($event)">
<option value="">不指定</option>
<option v-for="team in data.teams" :key="team.id" :value="team.id">
{{ team.shortName ?? team.name }}
</option>
</select>
</label>
</div>
<label class="create-field">
<span>创造日期</span>
<input v-model="createForm.achievedAt" class="mx-input mono" type="date" />
</label>
<p v-if="createError !== ''" class="create-error">{{ createError }}</p>
</div>
<div class="mx-modal-foot">
<button class="mx-btn mx-btn-secondary" type="button" :disabled="creating" @click="closeCreate">取消</button>
<button class="mx-btn mx-btn-primary" type="button" :disabled="creating" @click="submitCreate">
{{ creating ? '保存中…' : '保存纪录' }}
</button>
</div>
</div>
</div>
</div>
</template>
@@ -704,6 +1183,39 @@ watch(
flex-direction: column;
gap: 16px;
}
.create-body {
display: flex;
flex-direction: column;
gap: 10px;
}
.create-row {
display: flex;
gap: 10px;
}
.create-row .create-field {
flex: 1;
}
.create-field {
display: flex;
flex-direction: column;
gap: 4px;
font-size: 12px;
color: var(--mx-t2);
}
.create-hint {
font-size: 12px;
color: var(--mx-t3);
line-height: 1.6;
}
.create-error {
font-size: 12px;
color: var(--mx-red);
}
.note {
max-width: 220px;
font-size: 12px;
color: var(--mx-t3);
}
.record-group-head {
display: flex;
align-items: center;
+97
View File
@@ -0,0 +1,97 @@
import type { Event, RealtimeStatus } from '@/shared'
/**
* 仪表盘卡片的纯逻辑(P2 B08)。
*
* `devdocs/07 §7` 承诺了「今天的小项 / 待办数 / 连接状态」三类卡片,之前实现里都没有。
* 补齐时最容易出错的是「今天是哪一天」——服务端存的是带时区的时间串,
* 一律按本地时区取当天(现场看的日历就是本机日历),所以口径抽在这里单独测。
*/
/** 本地时区的当天,`YYYY-MM-DD`。 */
export function localDayKey(at: Date = new Date()): string {
const pad = (value: number): string => String(value).padStart(2, '0')
return `${at.getFullYear()}-${pad(at.getMonth() + 1)}-${pad(at.getDate())}`
}
/**
* 排期时间属于本地时区的哪一天;读不出日期时返回 null(不猜)。
*
* 纯日期(`2026-09-12`)没有时区含义,直接取日期部分——交给 `new Date()` 会按 UTC 午夜解析,
* 在东八区以外的机器上会整体错一天,把「今天的小项」算成昨天或明天。
* 带时间的串(`...T09:00` 或带 Z / 偏移量)交给 Date 解析后再取本地日历日:
* 带偏移量的时间串本来就是「某个绝对时刻」,显示给现场看必须是本机日历上的那一天。
*/
export function scheduleDayKey(scheduledAt: string | null | undefined): string | null {
const text = (scheduledAt ?? '').trim()
if (text === '') return null
const bare = /^(\d{4}-\d{2}-\d{2})$/.exec(text)
if (bare !== null) return bare[1] ?? null
const at = new Date(text)
if (Number.isNaN(at.getTime())) return null
return localDayKey(at)
}
/** 指定某天(`YYYY-MM-DD`)计划进行的小项;scheduledAt 为空的排期不算任何一天。 */
export function eventsOnDay(events: readonly Event[], day: string): Event[] {
return events.filter((event) => scheduleDayKey(event.scheduledAt) === day)
}
export function todayEvents(events: readonly Event[], now: Date = new Date()): Event[] {
return eventsOnDay(events, localDayKey(now))
}
export interface ScheduleProgress {
total: number
published: number
/** 可展示的进度文案;total 为 0 时给 null,由页面显示「今天没有排期」。 */
text: string | null
}
export function scheduleProgress(events: readonly Event[]): ScheduleProgress {
const published = events.filter((event) => event.status === 'published').length
return {
total: events.length,
published,
text: events.length === 0 ? null : `已发布 ${published} / 共 ${events.length}`,
}
}
export interface DisplayCounts {
online: number
total: number
}
/**
* 大屏在线数 / 总数。
*
* `instances` 为 null 表示数据源不可用(示例数据 / 接口失败):这时返回 null,
* 由页面显示 `—`,绝不能用 0 / 0 冒充「一台大屏都没连」。
*/
export function displayCounts(instances: readonly { online: boolean }[] | null): DisplayCounts | null {
if (instances === null) return null
return { online: instances.filter((item) => item.online).length, total: instances.length }
}
/** 数据源不可用时统一显示 `—`,不要用 0 冒充「没有」。 */
export function countText(value: number | null): string {
return value === null ? '—' : String(value)
}
export function displayCountText(counts: DisplayCounts | null): string {
return counts === null ? '—' : `${counts.online} / ${counts.total}`
}
/**
* 管理端的连接状态文案。
*
* 接口里没有「管理端在线数」这种统计(`GET /api/display/instances` 只登记大屏实例),
* 所以这里如实显示**本机管理端**的实时连接状态,不编一个数出来。
*/
export function adminLinkLabel(isMock: boolean, status: RealtimeStatus): string {
if (isMock) return '示例数据'
if (status === 'online') return '本机在线'
if (status === 'connecting') return '连接中'
if (status === 'idle') return '未连接'
return '连接中断'
}
+96
View File
@@ -0,0 +1,96 @@
import type { ResultState, ResultStatus } from '@/shared'
/**
* 成绩录入页「行操作区」的纯逻辑(P2 A16)。
*
* 抽出来的原因与 entryGuards 一致:`.vue` 组件跑不进 `node --test`,而这里恰好有两处
* 会真出错的地方——「哪一行显示哪个按钮」的状态判定,以及「动的是哪一条成绩」的 id 口径。
*
* 注意 id 口径:作废 / 退回的接口是 `POST /api/results/{id}/...`,id 是**成绩 id**,
* 不是报名项 id。两者在页面上挨着,拿错就会把别人的成绩作废掉,所以这里单独强调。
*/
/** 行操作区能对一条已发布成绩做的事。 */
export type ResultRowAction = 'void' | 'reopen'
export interface ResultRowState {
resultState: ResultState | null
status: ResultStatus
}
/**
* 这一行此刻该显示哪个操作;null 表示不显示(草稿行本来就能直接改,不需要作废入口)。
*
* 口径来自服务端 void 的实际行为:只把 `results.status` 改成 withdrawn,`state` 仍是 published,
* 所以「已发布 + withdrawn」= 已作废(显示「重新录入」),「已发布 + 其它状态」= 正常已发布(显示「作废本条」)。
*/
export function resultRowAction(row: ResultRowState): ResultRowAction | null {
if (row.resultState !== 'published') return null
return row.status === 'withdrawn' ? 'reopen' : 'void'
}
export interface ResultActionRow extends ResultRowState {
entryId: number
/** 成绩 id;草稿行也可能有(未发布的成绩同样有 id),缺了就没法定位接口目标。 */
resultId: number | null
resultText: string
}
export interface ResultActionTarget {
action: ResultRowAction
/** 服务端按成绩 id 定位,绝不是 entryId。 */
resultId: number
entryId: number
resultText: string
}
/** 把一行收窄成一次可提交的操作;判定不成立(草稿行 / 没有成绩 id)时为 null。 */
export function resultActionTarget(row: ResultActionRow): ResultActionTarget | null {
const action = resultRowAction(row)
if (action === null || row.resultId === null) return null
return { action, resultId: row.resultId, entryId: row.entryId, resultText: row.resultText }
}
export const RESULT_ROW_ACTION_LABEL: Record<ResultRowAction, string> = {
void: '作废本条',
reopen: '重新录入',
}
export const RESULT_ROW_ACTION_TITLE: Record<ResultRowAction, string> = {
void: '作废后该成绩不再计入名次与积分,同组其它人重新排名,大屏立即更新',
reopen: '退回草稿后可继续修改,改完再发布本组',
}
/** 示例数据模式下拦下写操作时的动作名(拼进「示例数据模式不能X」)。 */
export const RESULT_ROW_ACTION_WORD: Record<ResultRowAction, string> = {
void: '作废成绩',
reopen: '退回草稿',
}
/** 确认框文案:后果必须写在弹窗里,不能只让操作员凭经验猜(07 §8)。 */
export const RESULT_ACTION_CONFIRM: Record<ResultRowAction, { title: string; message: string; confirmText: string; reasonLabel: string }> = {
void: {
title: '确认作废本条成绩?',
message: '作废后该成绩不再计入名次与积分,同组其它人重新排名,大屏立即更新。',
confirmText: '确认作废',
reasonLabel: '作废原因',
},
reopen: {
title: '确认重新录入本条成绩?',
message: '该条成绩将退回草稿(可编辑),不再计入名次与积分;改完请再发布本组。',
confirmText: '退回草稿',
reasonLabel: '退回原因',
},
}
/** 成功提示:作废与退回的后续动作不同,提示要各说各的。 */
export const RESULT_ACTION_SUCCESS: Record<ResultRowAction, { title: string; detail: string }> = {
void: {
title: '已作废该条成绩,名次与积分已重算',
detail: '大屏已更新;需要改回来时用同一行的「重新录入」退回草稿',
},
reopen: {
title: '已退回草稿,该行可以继续修改',
detail: '改完记得再点一次「发布本批」,名次与积分会按新成绩重算',
},
}
+81
View File
@@ -0,0 +1,81 @@
import { formatPoints } from '@/shared'
import type { RecordBreak, RecordLevel, RecordSource } from '@/shared'
/**
* 破纪录登记(record-breaks)与纪录库(records)的纯逻辑(P2 A41 / C11)。
*
* 抽出来的原因:`.vue` 跑不进 `node --test`,而这里有两处会真出错的地方——
* 「已处理」的登记要靠键去抑制前端推导出来的疑似列表(两边键算法必须一模一样),
* 以及「来源」列缺字段时不能把旧包显示成「历史」。
*/
export const RECORD_LEVEL_LABELS: Record<RecordLevel, string> = {
meet: '赛会',
city: '市级',
province: '省级',
national: '全国',
}
/** 档位从低到高;列表与筛选都按它排序。 */
export const RECORD_LEVEL_ORDER: RecordLevel[] = ['meet', 'city', 'province', 'national']
export const RECORD_LEVEL_OPTIONS: Array<{ value: RecordLevel; label: string }> = RECORD_LEVEL_ORDER.map(
(level) => ({ value: level, label: RECORD_LEVEL_LABELS[level] }),
)
/**
* 纪录来源文案。
*
* 缺字段(旧包 / 示例数据 / 老服务端)时显示 `—` 而不是「历史」:
* 「历史」是一条真实结论,而这里只是读不到,两者不能混。
*/
export function recordSourceLabel(source: RecordSource | null | undefined): string {
if (source === 'current') return '本届'
if (source === 'history') return '历史'
return '—'
}
/**
* 疑似破纪录与登记行共用的键。
*
* 录入侧由「已发布成绩 vs 当前纪录」推导出疑似条目,服务端侧返回已处理的登记;
* 两侧必须用同一个函数算键,否则「已经驳回的那条」刷新后会重新冒出来。
*/
export function breakKey(eventId: number, entryId: number, level: RecordLevel): string {
return `${eventId}-${entryId}-${level}`
}
/** 已处理(approved / rejected)的登记键;pending 的不抑制——它本来就该留在待确认里。 */
export function handledBreakKeys(breaks: readonly RecordBreak[]): Set<string> {
const keys = new Set<string>()
for (const item of breaks) {
if (item.state === 'pending') continue
keys.add(breakKey(item.eventId, item.entryId, item.level))
}
return keys
}
/** 登记说明(驳回原因等);旧服务端不下发 note 时返回 null,界面据此不渲染那一行。 */
export function breakNote(item: { note?: string | null }): string | null {
const text = (item.note ?? '').trim()
return text === '' ? null : text
}
/**
* 加分展示。
*
* `bonusPoints` 缺失(旧服务端 / 示例数据)时给 `—`:直接拼 `+${formatPoints(undefined)}`
* 会渲染成「+—」这种既不是数字也不是占位的怪东西。
*/
export function breakBonusText(item: { bonusPoints?: number | null }): string {
const value = item.bonusPoints
return typeof value === 'number' && Number.isFinite(value) ? `+${formatPoints(value)}` : '—'
}
/**
* 「忽略」在服务端登记的固定原因。
*
* 现场判定不是破纪录不是「错误」而是一次判定,把它写进 note 之后,
* 谁在什么时候否掉了哪一条在审计里看得见,而不是只留在某个浏览器的内存里。
*/
export const IGNORE_BREAK_REASON = '现场判定不是破纪录'
+68
View File
@@ -0,0 +1,68 @@
import type { RecordEntryInput, RecordLevel } from '@/shared'
/**
* 「新增历史纪录」表单的纯逻辑(P2 C11)。
*
* 之前 `records.source='history'` 没有任何写入路径,这一档永远是空的;
* 接上 `POST /api/records` 之后,录入的是**手抄的历史资料**,所以两个值字段都允许只填一个:
* 老秩序册上常常只有「12.34 秒」这种文本,也可能只有换算后的数值。
* 校验与请求体的拼装放这里,组件只负责把输入框接上去。
*/
export interface RecordFormState {
eventId: number | null
level: RecordLevel
/** 成绩值输入框的原始文本;空串 = 没填。 */
resultValue: string
resultText: string
holderName: string
holderTeamId: number | null
/** 创造日期;空串 = 没填(历史资料常常记不清具体日期)。 */
achievedAt: string
}
export type RecordFormPlan = { ok: true; input: RecordEntryInput } | { ok: false; error: string }
/** 表单初始值:级别默认赛会纪录(录入历史资料时最常用),其余留空。 */
export function emptyRecordForm(eventId: number | null = null): RecordFormState {
return {
eventId,
level: 'meet',
resultValue: '',
resultText: '',
holderName: '',
holderTeamId: null,
achievedAt: '',
}
}
export function planRecordInput(form: RecordFormState): RecordFormPlan {
if (form.eventId === null) return { ok: false, error: '请选择小项' }
const valueText = form.resultValue.trim()
const text = form.resultText.trim()
let resultValue: number | null = null
if (valueText !== '') {
const parsed = Number(valueText)
if (!Number.isFinite(parsed)) return { ok: false, error: '成绩值要填数字;只填成绩文本也可以' }
resultValue = parsed
}
if (resultValue === null && text === '') {
return { ok: false, error: '成绩值或成绩文本至少填一个' }
}
return {
ok: true,
input: {
eventId: form.eventId,
level: form.level,
resultValue,
resultText: text === '' ? null : text,
holderName: form.holderName.trim() === '' ? null : form.holderName.trim(),
holderTeamId: form.holderTeamId,
achievedAt: form.achievedAt.trim() === '' ? null : form.achievedAt.trim(),
// 前端不猜 source:服务端对新登记的纪录固定写 history,这里显式带上只为与响应体同构。
source: 'history',
},
}
}