feat: 8 条功能 + 身份口径改为号码布为准（含批量退赛/移出、基础数据导入导出、登录有效期）
用户给出的 8 条功能 + 一条口径变更，全部带真机/真浏览器验证：
① 录入页姓名后直接显示号码布（原「号码」列保留）
② 录入页批次进度条：`第 2 批 已录 5/8 · 3 条有错`，录完变绿；已录判据复用
entryGuards.judgeEntryRow（与发布防呆同源，不会出现"进度条说录完、发布说缺 8 条"）
⑦ 小项列表双击 → 跳到该小项的组别（编辑/删除按钮不误触）
③ 赛事开关 `standings.live_on_publish`（默认开＝保持原行为）：关闭后分批发布只上屏成绩，
名次/流水/榜单一起等该组录完再结算 —— 代理实读代码后纠正了我的前提：
奖牌榜读的是 results.rank（buildRanked）而非流水汇总，只延迟流水会出现
「有金牌但 0 分」。另提供 POST /api/results/settle 人工兜底 + GET /api/results/settlement 未结算清单
④ 组别「就地更新」PUT /api/events/{id}/categories/{categoryId}：有报名数据时也能改名/改年龄/
改性别/改权重（旧路径是整表替换，一改就被 409 拦下）；改名不动报名/成绩/流水（真机逐字节比对）；
权重真的变了才触发该组重算（容差 1e-9）
④辅 运动员列表多选+全选，POST /api/athletes/batch 一次请求完成整批停用/彻底删除（逐条回报，
dryRun 预览走同一段 SQL 但不提交、不写审计）——这才是绕开限流的正解
新增 报名项批量：POST /api/entries/batch（scratch/restore/remove）。退赛只动 registered、
跳过 dq/dns 并说明原因；移出是物理删除，必须显式清 score_ledger（该表 entry_id 是
ON DELETE SET NULL，不显式删会留下"人没了分还在"的孤儿流水，验证基线 orphan=0）；
退赛同时清 results.rank（否则出现"0 分还挂着金牌"）
⑤ GET /api/export/entries.xlsx 报名名单导出（13 列含批次，状态中文与录入页逐字一致）
⑥ 基础数据包：GET /api/export/basedata.xlsx + POST /api/export/basedata/import
（四张表、表头只有一份定义、表头行自动定位、列缺席≠写空、按编码 upsert、绝不删除、
行级中文错误带真实 Excel 行号、枚举走既有校验、新增单位一定是启用）
⑧ 登录有效期面板可配：系统设置新页签，1–720 小时，默认 12h → 24h；滑动续期 +
Cookie 同步刷新（只服务端续期是假的，浏览器侧的 Max-Age 到点仍会丢 Cookie）
身份口径：号码布为唯一标识、证件号退出匹配（号码布不同=同名的两个人，新建并单独报告）；
同一份表重复证件号不再报错；两个不同的人共用证件号仍报行级错误（唯一索引保留）
其它对齐：分项成绩表草稿行不再消失（成绩列「分数未录入」、名次/积分 `—`，没成绩的行同占位）；
大屏实时赛况单栏铺满（留白 370→78px）、字号上限 56→96px、≥7 行自动拆左右两块；
删除报名项/退赛/权重等改动都会重算并推榜单。
测试：服务端 13 包（连跑两遍）、前端 335 例、vue-tsc + build、Console 18 文件 —— 全绿。
文档：README、docs/ 四份（含 debug/使用说明 副本）、devdocs 05/08/04/13。
版本号 dev_0.1.5 → dev_0.1.6。
This commit is contained in:
AskaEth committed
1 parent
8dd599bd97
commit
631c8dd8e1
80 files changed
+12468
-519
No files matched your search
@@ -0,0 +1,276 @@
|
||||
import { ApiError } from '@/shared'
|
||||
import type { ApiErrorCode, EntryStatus } from '@/shared'
|
||||
|
||||
/**
|
||||
* 报名项批量操作（退赛 / 恢复 / 移出报名）的前端逻辑。
|
||||
*
|
||||
* 网络层直接 fetch 而不是走 adminApi：client.ts 的接口表与 shared/api.ts 归口在共享层，
|
||||
* 本功能只服务录入页，先把请求构造与确认文案收在这一个模块里，便于单测；
|
||||
* CSRF 与 X-Request-Id 的补法与 shared/api.ts 的写请求保持一致，否则写操作会被 403 挡回。
|
||||
*/
|
||||
|
||||
/** 与 server/internal/httpapi/entries_batch.go 的 maxEntryBatch 一致。 */
|
||||
export const MAX_ENTRY_BATCH = 500
|
||||
|
||||
export const ENTRY_BATCH_PATH = '/api/entries/batch'
|
||||
|
||||
/** 确认框里逐条列出「将被删的人」时最多列几行，超出的只报数。 */
|
||||
const MAX_LISTED_PEOPLE = 20
|
||||
|
||||
export type EntryBatchAction = 'scratch' | 'restore' | 'remove'
|
||||
|
||||
export interface EntryBatchPayload {
|
||||
action: EntryBatchAction
|
||||
ids: number[]
|
||||
reason?: string
|
||||
requestId?: string
|
||||
}
|
||||
|
||||
export interface EntryBatchItem {
|
||||
id: number
|
||||
ok: boolean
|
||||
error?: string
|
||||
skipped?: boolean
|
||||
note?: string
|
||||
}
|
||||
|
||||
export interface EntryBatchSummary {
|
||||
ok: number
|
||||
failed: number
|
||||
skipped: number
|
||||
changed: number
|
||||
removedEntries: number
|
||||
removedResults: number
|
||||
removedLedger: number
|
||||
removedBreaks: number
|
||||
recomputedEvents: number[]
|
||||
}
|
||||
|
||||
export interface EntryBatchResult {
|
||||
items: EntryBatchItem[]
|
||||
summary: EntryBatchSummary
|
||||
}
|
||||
|
||||
/** 批量操作作用于的勾选行；字段只取确认文案与跳过判定需要的部分。 */
|
||||
export interface EntryBatchRow {
|
||||
entryId: number
|
||||
/** 展示名：运动员姓名 → 队员首人 → 单位（与表格行文案同口径）。 */
|
||||
name: string
|
||||
bib: string | null
|
||||
team: string
|
||||
categoryId: number
|
||||
entryStatus: EntryStatus
|
||||
}
|
||||
|
||||
export interface EntryBatchPlan {
|
||||
action: EntryBatchAction
|
||||
/** 去重后的报名项 id（服务端同样会去重，这里先去掉重复勾选）。 */
|
||||
ids: number[]
|
||||
/** 真正会被改动的行数。 */
|
||||
changed: number
|
||||
/** 会被跳过的行及其原因（dq / dns 是别人的判定，不覆盖）。 */
|
||||
skipped: { name: string; note: string }[]
|
||||
/** 会重算的组别数量：重算按 (小项, 组别) 走，本页只有当前小项。 */
|
||||
scopeCount: number
|
||||
message: string
|
||||
details: string[]
|
||||
}
|
||||
|
||||
/**
|
||||
* 去重并丢掉非法 id（0 / 负数 / 非整数），保持勾选顺序。
|
||||
* 与服务端 dedupeIDs 同一口径：重复勾选不该变成两条请求明细。
|
||||
*/
|
||||
export function dedupeEntryIds(ids: number[]): number[] {
|
||||
const out: number[] = []
|
||||
const seen = new Set<number>()
|
||||
for (const id of ids) {
|
||||
if (!Number.isInteger(id) || id <= 0 || seen.has(id)) continue
|
||||
seen.add(id)
|
||||
out.push(id)
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
/** 批量条数校验；通过返回 null，否则返回可直接上屏的中文提示。 */
|
||||
export function entryBatchSizeError(count: number): string | null {
|
||||
if (count === 0) return '请先勾选要操作的报名项'
|
||||
if (count > MAX_ENTRY_BATCH) {
|
||||
return `一次最多处理 ${MAX_ENTRY_BATCH} 条报名项，请分批提交`
|
||||
}
|
||||
return null
|
||||
}
|
||||
|
||||
/** 该行在当前动作下会不会被改动；不改动时返回跳过原因（与服务端文案一致）。 */
|
||||
export function entryBatchSkipNote(action: EntryBatchAction, status: EntryStatus): string | null {
|
||||
if (action === 'remove') return null
|
||||
if (action === 'scratch' && status === 'registered') return null
|
||||
if (action === 'restore' && status === 'scratched') return null
|
||||
switch (status) {
|
||||
case 'scratched':
|
||||
return '已是退赛状态，跳过'
|
||||
case 'registered':
|
||||
return '当前正常参赛，无需恢复'
|
||||
case 'dq':
|
||||
return '已被判罚取消资格（dq），跳过，不覆盖原判定'
|
||||
case 'dns':
|
||||
return '已标记未出场（dns），跳过，不覆盖原判定'
|
||||
}
|
||||
return `当前状态为「${status}」，跳过`
|
||||
}
|
||||
|
||||
/** 行在确认框里的身份行：姓名｜号码布｜单位。 */
|
||||
function personLine(row: EntryBatchRow): string {
|
||||
return `${row.name || '（未署名）'}｜号码 ${row.bib ?? '—'}｜${row.team || '未知单位'}`
|
||||
}
|
||||
|
||||
/**
|
||||
* 把一次批量操作整理成确认框能直接用的内容：
|
||||
* 前端先算清「动谁、跳过谁、重算几个组别」，不让操作员点完才知道。
|
||||
*/
|
||||
export function planEntryBatch(action: EntryBatchAction, rows: EntryBatchRow[]): EntryBatchPlan {
|
||||
const ids = dedupeEntryIds(rows.map((row) => row.entryId))
|
||||
// 重复勾选不该在「动几个人」里数两遍：按 entryId 去重后再统计。
|
||||
const seen = new Set<number>()
|
||||
const unique = rows.filter((row) => {
|
||||
if (seen.has(row.entryId)) return false
|
||||
seen.add(row.entryId)
|
||||
return true
|
||||
})
|
||||
const scopes = new Set(unique.map((row) => row.categoryId))
|
||||
const changedRows: EntryBatchRow[] = []
|
||||
const skipped: { name: string; note: string }[] = []
|
||||
for (const row of unique) {
|
||||
const note = entryBatchSkipNote(action, row.entryStatus)
|
||||
if (note === null) changedRows.push(row)
|
||||
else skipped.push({ name: row.name || '（未署名）', note })
|
||||
}
|
||||
|
||||
const changed = changedRows.length
|
||||
const scopeCount = scopes.size
|
||||
const details: string[] = []
|
||||
if (action === 'remove') {
|
||||
details.push(`将删除以下 ${changed} 人（物理删除，不可恢复）：`)
|
||||
for (const row of changedRows.slice(0, MAX_LISTED_PEOPLE)) details.push(`· ${personLine(row)}`)
|
||||
if (changedRows.length > MAX_LISTED_PEOPLE) {
|
||||
details.push(`…还有 ${changedRows.length - MAX_LISTED_PEOPLE} 人未列出`)
|
||||
}
|
||||
} else if (skipped.length > 0) {
|
||||
details.push(`以下 ${skipped.length} 人会被跳过（不覆盖已有判定）：`)
|
||||
for (const item of skipped.slice(0, MAX_LISTED_PEOPLE)) details.push(`· ${item.name}：${item.note}`)
|
||||
if (skipped.length > MAX_LISTED_PEOPLE) {
|
||||
details.push(`…还有 ${skipped.length - MAX_LISTED_PEOPLE} 人未列出`)
|
||||
}
|
||||
}
|
||||
|
||||
let message = ''
|
||||
if (action === 'scratch') {
|
||||
message = `将把选中的 ${changed} 人标记为退赛（0 分且不占名次），随后按新名次重算积分榜。退赛随时可以用「批量恢复」撤回。`
|
||||
} else if (action === 'restore') {
|
||||
message = `将把选中的 ${changed} 人恢复为正常参赛，随后按新名次重算积分榜。`
|
||||
} else {
|
||||
message = `将从报名名单中物理删除选中的 ${changed} 人，成绩与积分流水一并删除，不可恢复。`
|
||||
}
|
||||
|
||||
// 本页只操作当前小项；重算按 (小项, 组别) 走，所以组别数就是这里的规模。
|
||||
if (scopeCount > 0) {
|
||||
details.push(`会重算 1 个小项（当前项目）、${scopeCount} 个组别的名次与积分。`)
|
||||
}
|
||||
if (action === 'remove' && changed > MAX_LISTED_PEOPLE) {
|
||||
message += `这会重算 1 个小项（当前项目）、${scopeCount} 个组别，别人的名次会变。`
|
||||
}
|
||||
|
||||
return { action, ids, changed, skipped, scopeCount, message, details }
|
||||
}
|
||||
|
||||
/** 批量操作成功后的 toast 副标题：逐条成败 + 删除规模 + 重算范围。 */
|
||||
export function entryBatchOutcome(result: EntryBatchResult): string {
|
||||
const { summary } = result
|
||||
const parts: string[] = []
|
||||
parts.push(`成功 ${summary.ok} 条${summary.skipped > 0 ? `（跳过 ${summary.skipped} 条）` : ''}`)
|
||||
if (summary.failed > 0) parts.push(`失败 ${summary.failed} 条`)
|
||||
if (summary.removedEntries > 0) parts.push(`删除报名 ${summary.removedEntries} 条`)
|
||||
if (summary.removedResults > 0) parts.push(`删除成绩 ${summary.removedResults} 条`)
|
||||
if (summary.removedLedger > 0) parts.push(`删除流水 ${summary.removedLedger} 条`)
|
||||
if (summary.recomputedEvents.length > 0) parts.push(`重算 ${summary.recomputedEvents.length} 个小项`)
|
||||
return parts.join('；')
|
||||
}
|
||||
|
||||
function readCsrfToken(): string | null {
|
||||
if (typeof document === 'undefined') return null
|
||||
const match = /(?:^|;\s*)csrf_token=([^;]+)/.exec(document.cookie)
|
||||
return match?.[1] === undefined ? null : decodeURIComponent(match[1])
|
||||
}
|
||||
|
||||
function defaultRequestId(): string {
|
||||
const cryptoApi: Crypto | undefined = globalThis.crypto
|
||||
if (cryptoApi !== undefined && typeof cryptoApi.randomUUID === 'function') return cryptoApi.randomUUID()
|
||||
return `req-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`
|
||||
}
|
||||
|
||||
const KNOWN_CODES: readonly string[] = [
|
||||
'AUTH_REQUIRED',
|
||||
'AUTH_FAILED',
|
||||
'FORBIDDEN',
|
||||
'VALIDATION_FAILED',
|
||||
'CONFLICT',
|
||||
'STATE_INVALID',
|
||||
'RATE_LIMITED',
|
||||
'INTERNAL',
|
||||
'NETWORK',
|
||||
'TIMEOUT',
|
||||
'PARSE_FAILED',
|
||||
]
|
||||
|
||||
function isRecord(value: unknown): value is Record<string, unknown> {
|
||||
return typeof value === 'object' && value !== null && !Array.isArray(value)
|
||||
}
|
||||
|
||||
function apiError(code: unknown, message: string, status: number, detail?: unknown): ApiError {
|
||||
const safe: ApiErrorCode = typeof code === 'string' && KNOWN_CODES.includes(code) ? (code as ApiErrorCode) : 'INTERNAL'
|
||||
return new ApiError(safe, message, status, detail)
|
||||
}
|
||||
|
||||
/**
|
||||
* 提交批量操作。写操作不降级到示例数据：示例数据模式下的「成功」会让操作员
|
||||
* 以为已经退赛 / 删干净了，页面必须先看 data.isMock 再决定是否调用这里。
|
||||
*/
|
||||
export async function submitEntryBatch(payload: EntryBatchPayload): Promise<EntryBatchResult> {
|
||||
const headers: Record<string, string> = {
|
||||
Accept: 'application/json',
|
||||
'Content-Type': 'application/json; charset=utf-8',
|
||||
'X-Request-Id': defaultRequestId(),
|
||||
}
|
||||
const token = readCsrfToken()
|
||||
if (token !== null && token !== '') headers['X-CSRF-Token'] = token
|
||||
|
||||
let response: Response
|
||||
try {
|
||||
response = await fetch(ENTRY_BATCH_PATH, {
|
||||
method: 'POST',
|
||||
headers,
|
||||
credentials: 'include',
|
||||
body: JSON.stringify({ ...payload, requestId: payload.requestId ?? defaultRequestId() }),
|
||||
})
|
||||
} catch (caught) {
|
||||
throw apiError('NETWORK', '无法连接服务端，批量操作没有生效', 0, caught)
|
||||
}
|
||||
|
||||
let body: unknown
|
||||
try {
|
||||
body = await response.json()
|
||||
} catch (caught) {
|
||||
throw apiError('PARSE_FAILED', `服务端响应无法解析（HTTP ${response.status}）`, response.status, caught)
|
||||
}
|
||||
if (!isRecord(body) || typeof body['ok'] !== 'boolean') {
|
||||
throw apiError('PARSE_FAILED', '服务端响应不是约定的 {ok,data} 结构', response.status, body)
|
||||
}
|
||||
if (body['ok'] !== true) {
|
||||
const error = isRecord(body['error']) ? body['error'] : {}
|
||||
const message = typeof error['message'] === 'string' ? error['message'] : `批量操作失败（HTTP ${response.status}）`
|
||||
throw apiError(error['code'], message, response.status, error['detail'])
|
||||
}
|
||||
if (!response.ok) {
|
||||
throw apiError('INTERNAL', `批量操作失败（HTTP ${response.status}）`, response.status, body)
|
||||
}
|
||||
return body['data'] as EntryBatchResult
|
||||
}
|
||||
Reference in new issue
Block a user