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:
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}`, '变更详情接口'))
|
||||
}
|
||||
@@ -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)
|
||||
|
||||
@@ -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,
|
||||
)
|
||||
},
|
||||
}
|
||||
Reference in new issue
Block a user