fix: 修掉十路审查发现的 9 个 P0 与一批 P1(数据正确性 / 越权 / 现场可用性)

P0(9 条全修):
- 多通道项目奖牌重复计数:domain 层按 (EventID,CategoryID,EntryID/Subject) 去重,
  通道优先级 athlete→team→id
- 「只排名不计分」项目(scored:false)不再进奖牌榜,REST/WS/导出口径统一
- aggregate 流水 entry_id 恒 NULL 导致重算后分数翻倍:作废范围改按 event+category 定位
- 已发布成绩仍可被「存草稿」覆盖并清空 rank:服务端 409 STATE_INVALID + 前端禁编辑
- voidResult / 规则导入重算后名次不回写:接住 Ranked 调 applyComputedRanks
- 赛事包覆盖导入可能「旧项目已删、新项目没成」:先改名成功再清理,失败回滚
- 导入赛事包可覆盖正在运行的赛事目录:name==当前项目直接 400
- Console spawn 失败后守护器永久卡死:清 child/pid + 调度重启 + stop 超时兜底
- /ws 快照向非 admin 下发 admin-only 配置:按角色裁剪 settings

P1(计分口径 / 契约 / 现场):
- standings.tieBreak 三处接线;profiles[].recordBonusMode 生效;破纪录校验
  RecordEligible 与 entry 归属;破纪录登记校验已发布成绩
- export.loadRanked 与主路径对齐;ListBackups reason 解析;CLI backup 前缀修正
  (原来只增不减会撑爆磁盘);单位积分明细/导出统一权重折算;停用单位展示
- 规则导入原子化(重算并入同一事务)+ 返回 compatible/affectedEventCount/
  recalculatedLedgerRows;登录审计 user_id 修正
- WS 策略性断开用 Close(code,reason);HelloMessage 补 page/instanceId;
  实例注册表清理;settings/单位/项目写操作补 change_log 触发大屏刷新
- 大屏:全量快照不再被版本守卫丢弃;个人积分榜刷新;公告返回页/轮播;行数截断;
  REST 竞态;1008 停止重连;握手超时;时区补 Z;401 仅 AUTH_REQUIRED 才登出
- 管理端:published 行禁编辑;saveDraft 补 unit(1:06.33 显示);前端预览改用服务端
  points;空成绩行不再恒「已修改」;修订详情按 id 拉取;切项目请求序号与 dirty 保护;
  发布后刷新项目状态;NAV/路由按角色过滤;recorder 不再打 admin-only 接口
- Console:大屏窗口销毁后重建;大屏 URL 复用 host 归一化;backup.bat 改纯 ASCII
  (已在 Meowhome 实跑验证)

自检:服务端 gofmt/build/vet 通过、12 包测试全绿;前端 vue-tsc + build 通过、
node --test 24/24;console check-syntax 12 文件通过。
This commit is contained in:
AskaEth committed 2026-09-09 22:16:58 +08:00
1 parent 96cf181ae3
commit 13f1f03cd0
124 files changed
+5658 -1820

No files matched your search

@@ -1,10 +1,12 @@
import { parseRevisions, type Revision } from './types'
import { ApiError } from '@/shared'
import { parseRevisionDetail, parseRevisions, type Revision } from './types'
/**
* `GET /api/revisions`(05 §7 的变更历史接口,由服务端另一处实现)。
* `GET /api/revisions` 与 `GET /api/revisions/{id}`(05 §7 的变更历史接口)。
*
* 直接 fetch 而不是走 adminApi:client.ts 的接口表里暂时没有这个方法,
* 而 api/** 不在本页的改动范围内;解析失败 / 404 时由页面降级到示例数据。
* 直接 fetch 而不是走 adminApi:client.ts 的接口表里暂时没有这组方法。
* 只有网络不可达(NETWORK)才由页面降级到示例数据;403 / 404 / 500 是服务端的真实回答,
* 必须原样抛出,否则访客会看到一批冒充历史的假数据。
*/
export interface RevisionQuery {
@@ -24,12 +26,28 @@ function buildUrl(query: RevisionQuery): string {
return search === '' ? REVISIONS_PATH : `${REVISIONS_PATH}?${search}`
}
async function request(url: string, label: string): Promise<unknown> {
let response: Response
try {
response = await fetch(url, { headers: { Accept: 'application/json' }, credentials: 'include' })
} catch (error) {
throw new ApiError('NETWORK', '无法连接服务端', 0, error)
}
if (!response.ok) {
const code = response.status === 403 ? 'FORBIDDEN' : 'INTERNAL'
throw new ApiError(code, `${label}返回 HTTP ${response.status}`, response.status)
}
return response.json()
}
export async function fetchRevisions(query: RevisionQuery = {}): Promise<Revision[]> {
const response = await fetch(buildUrl(query), {
headers: { Accept: 'application/json' },
credentials: 'include',
})
if (!response.ok) throw new Error(`变更历史接口返回 HTTP ${response.status}`)
const body: unknown = await response.json()
return parseRevisions(body)
return parseRevisions(await request(buildUrl(query), '变更历史接口'))
}
/**
* 列表接口不含成绩快照,只有 `GET /api/revisions/{id}` 才带 snapshot。
* 选中节点后必须补拉一次,否则真机上的 diff、影响单位与积分流水全是 0。
*/
export async function fetchRevisionDetail(id: number): Promise<Revision | null> {
return parseRevisionDetail(await request(`${REVISIONS_PATH}/${id}`, '变更详情接口'))
}
+7 -1
View File
@@ -131,7 +131,7 @@ function parseLedgerIds(value: unknown): number[] {
.filter((item): item is number => item !== null)
}
function parseRevision(value: unknown): Revision | null {
export function parseRevision(value: unknown): Revision | null {
if (!isRecord(value)) return null
const id = readNumber(value, 'id')
const eventId = readNumber(value, 'eventId')
@@ -165,3 +165,9 @@ export function parseRevisions(body: unknown): Revision[] {
.map(parseRevision)
.filter((item): item is Revision => item !== null)
}
/** 解析 GET /api/revisions/{id}:单个对象,兼容未拆包的 {ok,data} 统一响应。 */
export function parseRevisionDetail(body: unknown): Revision | null {
const source = isRecord(body) && 'data' in body ? body['data'] : body
return parseRevision(source)
}
@@ -44,10 +44,12 @@ function clone(value: EventSettings): EventSettings {
return JSON.parse(JSON.stringify(value)) as EventSettings
}
/** 可选文本:空串在接口里等于「没有」,必须转成 null,否则大屏会显示空白标题。 */
function optional(value: string | null): string | null {
const trimmed = (value ?? '').trim()
return trimmed === '' ? null : trimmed
/**
* 可选文本:服务端对 `*string` 的 nil 是「保持原值」,所以清空必须传空串。
* 若这里把空串转成 null,副标题 / 主办方将永远清不掉。
*/
function optional(value: string | null): string {
return (value ?? '').trim()
}
function reset(): void {
@@ -64,6 +66,11 @@ async function save(): Promise<void> {
return
}
// 清空轮播间隔时 v-model.number 会给出空串,直接提交会被服务端按 *float64 解码失败(400)。
// 空值按「不改动」处理(服务端对 nil 也是保持原值),回填当前值即可。
const rotate = Number(next.display.rotateSeconds)
const rotateSeconds = Number.isFinite(rotate) && rotate > 0 ? rotate : current.display.rotateSeconds
const patch: EventSettingsPatch = {
event: {
...next.event,
@@ -71,14 +78,19 @@ async function save(): Promise<void> {
subtitle: optional(next.event.subtitle),
host: optional(next.event.host),
},
display: { ...next.display, title: next.display.title.trim(), subtitle: optional(next.display.subtitle) },
display: {
...next.display,
title: next.display.title.trim(),
subtitle: optional(next.display.subtitle),
rotateSeconds,
},
standings: { ...next.standings },
}
saving.value = true
saveError.value = null
try {
const result = await settingsApi.save(patch, current)
const result = await settingsApi.save(patch)
usingMock.value = result.mock
data.settings = result.data
form.value = clone(result.data)
+37 -38
View File
@@ -7,8 +7,9 @@ import { mockMode, mockReason } from '../../api/client'
* `api/client.ts` 只封装了 ApiClient 已有的端点,用户管理 / 备份列表 / 赛事项目包 /
* 规则包这几组接口还没进共享客户端(且本任务不允许改 api 层),所以在组件目录里补一层薄封装。
*
* 降级策略与 client.ts 完全一致:只有「连不上 / 超时 / 响应不是约定结构 / 404 未实现」
* 才降级示例数据;403、校验失败这类业务回答必须原样抛出,否则会把「没权限」伪装成「示例数据」。
* 降级策略与 client.ts 完全一致:只有「连不上 / 超时」才降级示例数据;
* 403、404、校验失败这类业务回答必须原样抛出,否则会把「没权限 / 不存在」伪装成「示例数据」。
* 写操作(用户、备份、设置、规则落地、项目导入)一律不降级,避免假成功。
*/
const BASE_URL = '/api'
@@ -16,7 +17,8 @@ const DEFAULT_TIMEOUT_MS = 15_000
/** 上传整包可能上百 MB,超时必须放宽,否则现场弱网必然失败。 */
const UPLOAD_TIMEOUT_MS = 120_000
const FALLBACK_CODES: readonly string[] = ['NETWORK', 'TIMEOUT', 'PARSE_FAILED']
// 与 client.ts 一致:只有连不上 / 超时才降级;解析失败说明服务端在跑但响应不对,必须暴露。
const FALLBACK_CODES: readonly string[] = ['NETWORK', 'TIMEOUT']
const API_ERROR_CODES: readonly string[] = [
'AUTH_REQUIRED',
@@ -36,8 +38,9 @@ function isApiErrorCode(value: unknown): value is ApiErrorCode {
return typeof value === 'string' && API_ERROR_CODES.includes(value)
}
export function isBackendUnavailable(error: unknown): boolean {
return error instanceof ApiError && (FALLBACK_CODES.includes(error.code) || error.status === 404)
function isBackendUnavailable(error: unknown): boolean {
// 404 / 403 / 校验失败都是服务端的真实回答,只有连不上 / 超时才算「后端未就绪」。
return error instanceof ApiError && FALLBACK_CODES.includes(error.code)
}
export interface MockAware<T> {
@@ -51,10 +54,15 @@ function markMock(reason: string): void {
mockReason.value = reason
}
/** 与 client.ts 的 call() 同构,额外把「是否降级」返回给调用方。 */
export async function withMockInfo<T>(
/**
* 与 client.ts 的 call() 同构,额外把「是否降级」返回给调用方。
*
* `mock` 传 null 表示不降级,用于所有写操作:示例数据里的「保存成功」会让操作员
* 以为改动已经落库(最典型的是重置密码),因此写操作一律原样抛错。
*/
async function withMockInfo<T>(
real: () => Promise<T>,
mock: () => T | Promise<T>,
mock: (() => T | Promise<T>) | null,
): Promise<MockAware<T>> {
try {
const data = await real()
@@ -64,16 +72,12 @@ export async function withMockInfo<T>(
}
return { data, mock: false }
} catch (error) {
if (!isBackendUnavailable(error)) throw error
if (mock === null || !isBackendUnavailable(error)) throw error
markMock(error instanceof Error ? error.message : '无法连接服务端')
return { data: await mock(), mock: true }
}
}
export async function withMock<T>(real: () => Promise<T>, mock: () => T | Promise<T>): Promise<T> {
return (await withMockInfo(real, mock)).data
}
/**
* 服务端只回一句「服务端异常」,真正的线索在 error.detail 里(例如「赛事项目名非法: 名称为空」)。
* 展示时把 detail 一并带上,现场才不用去翻服务端日志。
@@ -166,10 +170,14 @@ async function send(path: string, options: RawOptions = {}): Promise<Response> {
if (options.json !== undefined) headers['Content-Type'] = 'application/json; charset=utf-8'
else if (options.contentType !== undefined) headers['Content-Type'] = options.contentType
let json = options.json
if (method !== 'GET') {
const token = readCsrfToken()
if (token !== null && token !== '') headers['X-CSRF-Token'] = token
headers['X-Request-Id'] = newRequestId()
const requestId = newRequestId()
headers['X-Request-Id'] = requestId
// 服务端幂等缓存同时看 header 与 body.requestId,两边必须一致才可能命中。
if (isRecord(json) && !('requestId' in json)) json = { ...json, requestId }
}
const controller = new AbortController()
@@ -180,7 +188,7 @@ async function send(path: string, options: RawOptions = {}): Promise<Response> {
method,
headers,
credentials: 'include',
body: options.json !== undefined ? JSON.stringify(options.json) : options.body,
body: json !== undefined ? JSON.stringify(json) : options.body,
signal: controller.signal,
})
} catch (error) {
@@ -402,7 +410,8 @@ export const usersApi = {
if (created === null) throw new ApiError('PARSE_FAILED', '新建用户响应格式不符', 0, body)
return created
},
() => mockUsers().create(input),
// 写操作不降级:假成功会让管理员以为账号已建好。
null,
)
},
@@ -414,7 +423,7 @@ export const usersApi = {
if (updated === null) throw new ApiError('PARSE_FAILED', '更新用户响应格式不符', 0, body)
return updated
},
() => mockUsers().update(id, patch),
null,
)
},
@@ -426,7 +435,8 @@ export const usersApi = {
if (password === null) throw new ApiError('PARSE_FAILED', '重置密码响应缺少 password', 0, body)
return { password }
},
() => mockUsers().resetPassword(id),
// 这里绝不能降级:mock 会返回一个假密码,等于谎报「重置成功」。
null,
)
},
}
@@ -496,16 +506,8 @@ export const backupsApi = {
if (created === null) throw new ApiError('PARSE_FAILED', '备份响应格式不符', 0, body)
return created
},
() => {
const createdAt = new Date().toISOString()
return {
name: `event-${createdAt.replace(/[:.]/g, '-')}.db`,
path: `data/backups/event-${createdAt.replace(/[:.]/g, '-')}.db`,
size: 1_486_848,
reason: 'manual',
createdAt,
}
},
// 备份是写操作:示例数据里假装备份成功会让现场以为已经落盘。
null,
)
},
}
@@ -633,12 +635,8 @@ export const projectApi = {
meta: body.meta,
}
},
() => ({
name: options.rename.trim() === '' ? file.name.replace(/\.zip$/i, '') : options.rename.trim(),
dir: `data/event_projs/${options.rename.trim() === '' ? file.name.replace(/\.zip$/i, '') : options.rename.trim()}`,
eventDB: 'event.db',
meta: { note: '示例数据:未真正解压落盘' },
}),
// 导入会覆盖赛事目录,绝不能降级成「示例数据导入成功」。
null,
)
},
}
@@ -803,7 +801,8 @@ export const rulesApi = {
contentType: 'application/yaml; charset=utf-8',
timeoutMs: 60_000,
}).then(toRuleApplyResult),
() => ({ ...mockPreview(), recalculatedLedgerRows: 128 }),
// 落地规则包会重算积分,不能降级成假的「已应用」。
null,
)
},
}
@@ -815,7 +814,7 @@ export const rulesApi = {
export type EventSettingsPatch = Partial<EventSettings>
export const settingsApi = {
async save(patch: EventSettingsPatch, current: EventSettings): Promise<MockAware<EventSettings>> {
async save(patch: EventSettingsPatch): Promise<MockAware<EventSettings>> {
return withMockInfo(
async () => {
const body = await requestJson<unknown>('/settings', { method: 'PUT', json: patch })
@@ -823,8 +822,8 @@ export const settingsApi = {
// 服务端返回的字段与 shared/types 的 EventSettings 一一对应,这里只做结构校验后透传。
return body as unknown as EventSettings
},
// 示例模式下把改动合并进当前设置,让表单交互能完整走通。
() => ({ ...current, ...patch }),
// 写操作不降级:示例数据里的「保存成功」会让管理员以为设置已生效。
null,
)
},
}