feat: 备份恢复 / 图片清理 / 单位恢复 / 审计过滤 / 模板引擎 M1 + 两个导入缺陷修复
用户点名的三件事（模板功能、删死代码、剩余缺口）这一批全部落地，另修掉两个刚暴露的导入缺陷：
**新增能力**
- 备份恢复：`POST /api/backup/restore`（admin）。先把校验做在拍快照之前（只读打开 + integrity_check +
关键表校验 + 异类库标志表互斥），再用 VACUUM INTO 拍「恢复前安全副本」，然后关连接、整文件替换、
触发优雅重启；`-wal` 还在时直接拒绝（宁可失败也不让旧库 WAL 套到新库上）；恢复后审计直写"恢复之后
还在的那份库"（不走通用 Auditor，否则记录只会落在被替换掉的旧文件上）。顺带修掉：裸服务端连续恢复
第二次会在拍副本处崩出一句看不懂的 500，现在回 503「上次恢复后尚未重启，请先重启服务端」。
- 安全副本保留策略：每类库保留最近 5 份，独立于 .db 的 20 份滚动清理。
- 图片管理：`DELETE /api/uploads/{name}`（被引用 409 并列出引用点）、`GET /api/uploads/orphans`、
`POST /api/uploads/orphans/delete`（只删列出的孤儿，宁漏勿误），全部 admin（与字体删除同档）；
`deploy/backup.bat` 补上 uploads/ 归档（logs 不归档：可再生的诊断且会无上限增长）。
- 已彻底删除单位的恢复：`POST /api/teams/{id}/restore`（与 hideTeam 同档）。幂等；恢复不会把「停用」
变成「启用」；真机确认恢复前后榜单逐字节一致、change_log 最大值不变（数据一行没动，不需要重算）。
界面加「显示已彻底删除的单位」（仅 admin）与恢复按钮；非 admin 的删除确认框里写明"本账号无法自行恢复"。
- 审计日志按 `action` 过滤（子串模糊，输入里的 %/_/\ 转义成字面量）。
- 删除死表 recent_projects（新增 system 迁移 0006，未动已应用的迁移）。
- points_override 不再"设了没效果"：写入侧 400 + 引擎侧守卫，提示改用「积分调整」。
- 联队份额空壳清理（UnionAttribution/UnionSplit/Entry.TeamShares/resolvedShares 等；TeamShare 类型保留，
因为 export/realtime/奖牌流水三处在生产路径上构造它）。
- 自定义大屏模板 M1：插值引擎（parseTemplate/renderTemplate），任何情况都不抛异常、未定义→空串+警告、
警告按 (code,path) 合并计数、无 eval/innerHTML，57 个新用例。
**两个真缺陷（前两个已随 0.1.6 出包）**
- 基础数据包导入「排序」列口径不一致：小项/组别留空保持原值，单位/大项留空被写成 0（plan 没从库里
现值起手）→ 四张表统一为「留空保持原值」。
- 同类第二处：布尔列「整列被删掉」被当成"取默认值"，会把库里所有停用的单位/大项静默改回启用 →
改为「缺列 = 不动」（写侧与解析侧都收口，补了"缺列保持/空格子=是/显式否=停用"三组对照用例）。
**删死代码**
- createEntry / updateEntry / deleteEntry / entryEventID / checkCategoryInEvent / getEntry /
normalizeEntryStatus / ExportBaseDataXLSX（全仓 grep 零引用）。⚠️ 随之记入文档：「组别必须属于该小项」
这道校验现在只由导入路径"按小项+组别名解析"天然保证，将来若新增从请求体接收 categoryId 的接口，
必须自己补校验（库层没有复合外键）。
**文档**
- devdocs 全面同步（01/02/03/04/05/06/07/09/11/12/13/README；含身份口径、延迟结算、大屏单栏新版式、
新增路由与设置键、R18/R19 风险）；docs 复核 + 第二轮（身份口径三个易写反的分支、图片删除、备份覆盖、
审计过滤、单位恢复、去掉硬编码版本号、上线检查清单 +5 项）；debug/使用说明 6 份逐份 diff 一致。
测试：服务端 13 包（连跑两遍）、前端 406 例、Console 28 例 + 18 文件语法检查 —— 全绿。
版本号 dev_0.1.6 → dev_0.1.7。
This commit is contained in:
AskaEth committed
1 parent
631c8dd8e1
commit
53a0cb225c
61 files changed
+6386
-699
No files matched your search
@@ -0,0 +1,116 @@
|
||||
import { test } from 'node:test'
|
||||
import assert from 'node:assert/strict'
|
||||
import { imageAssetsApi } from '../components/system/systemApi'
|
||||
|
||||
/**
|
||||
* 图片删除 / 孤儿清理接口的前端契约：路径、方法、请求体与响应形状。
|
||||
*
|
||||
* 这一组端点的红线是「只删点名的文件」，路径或字段名写错时现场看到的是
|
||||
* 「点了删除但列表没变」这类静默故障，所以这里用 stub fetch 钉住真正发出去的请求。
|
||||
*/
|
||||
|
||||
interface Captured {
|
||||
url?: string
|
||||
method?: string
|
||||
body?: unknown
|
||||
}
|
||||
|
||||
function jsonResponse(body: unknown, status = 200): Response {
|
||||
return new Response(JSON.stringify(body), {
|
||||
status,
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
})
|
||||
}
|
||||
|
||||
function stubFetch(reply: (captured: Captured) => Response): Captured {
|
||||
const captured: Captured = {}
|
||||
globalThis.fetch = (async (input: unknown, init?: RequestInit) => {
|
||||
captured.url = String(input)
|
||||
captured.method = init?.method ?? 'GET'
|
||||
captured.body = init?.body
|
||||
return reply(captured)
|
||||
}) as typeof fetch
|
||||
;(globalThis as { window?: unknown }).window = {
|
||||
setTimeout: (fn: () => void, ms?: number) => setTimeout(fn, ms),
|
||||
clearTimeout: (id: number) => clearTimeout(id),
|
||||
}
|
||||
return captured
|
||||
}
|
||||
|
||||
const ORPHAN = {
|
||||
name: '3f6a1c.png',
|
||||
url: '/uploads/3f6a1c.png',
|
||||
size: 2048,
|
||||
modifiedAt: '2026-09-11T03:04:05Z',
|
||||
}
|
||||
|
||||
test('imageAssetsApi.listOrphans 读 GET /api/uploads/orphans 并带出总数与占用', async () => {
|
||||
const captured = stubFetch(() =>
|
||||
jsonResponse({ ok: true, data: { items: [ORPHAN], total: 1, totalBytes: 2048 } }),
|
||||
)
|
||||
|
||||
const list = await imageAssetsApi.listOrphans()
|
||||
|
||||
assert.equal(captured.url, '/api/uploads/orphans')
|
||||
assert.equal(captured.method, 'GET')
|
||||
assert.deepEqual(list, { items: [ORPHAN], total: 1, totalBytes: 2048 })
|
||||
})
|
||||
|
||||
// 形状不对时必须报解析失败，而不是把 undefined 当成「没有孤儿」骗管理员说目录干净。
|
||||
test('imageAssetsApi.listOrphans 对非法响应报解析失败', async () => {
|
||||
stubFetch(() => jsonResponse({ ok: true, data: [ORPHAN] }))
|
||||
|
||||
await assert.rejects(() => imageAssetsApi.listOrphans(), (error: Error) => error.message.includes('孤儿图片'))
|
||||
})
|
||||
|
||||
test('imageAssetsApi.remove 以 DELETE 删单张并把文件名转义进路径', async () => {
|
||||
const captured = stubFetch(() => jsonResponse({ ok: true, data: null }))
|
||||
|
||||
await imageAssetsApi.remove('3f6a 1c.png')
|
||||
|
||||
assert.equal(captured.url, `/api/uploads/${encodeURIComponent('3f6a 1c.png')}`)
|
||||
assert.equal(captured.method, 'DELETE')
|
||||
})
|
||||
|
||||
// 被引用的图片服务端回 409：原因必须原样透出，否则管理员不知道该去哪改配置。
|
||||
test('imageAssetsApi.remove 原样抛出「正在被使用」的 409 文案', async () => {
|
||||
stubFetch(() =>
|
||||
jsonResponse(
|
||||
{
|
||||
ok: false,
|
||||
error: {
|
||||
code: 'CONFLICT',
|
||||
message: '图片 3f6a1c.png 正在被使用（赛事信息·大屏背景图），请先在对应位置改掉或清除后再删除',
|
||||
},
|
||||
},
|
||||
409,
|
||||
),
|
||||
)
|
||||
|
||||
await assert.rejects(
|
||||
() => imageAssetsApi.remove('3f6a1c.png'),
|
||||
(error: Error) => error.message.includes('正在被使用'),
|
||||
)
|
||||
})
|
||||
|
||||
test('imageAssetsApi.removeOrphans POST 明确列出的文件名并解析逐条回报', async () => {
|
||||
const captured = stubFetch(() =>
|
||||
jsonResponse({
|
||||
ok: true,
|
||||
data: { deleted: ['3f6a1c.png'], failed: [{ name: 'aabb.png', reason: '仍被引用（单位「第一中学」的单位图标），已跳过' }] },
|
||||
}),
|
||||
)
|
||||
|
||||
const result = await imageAssetsApi.removeOrphans(['3f6a1c.png', 'aabb.png'])
|
||||
|
||||
assert.equal(captured.url, '/api/uploads/orphans/delete')
|
||||
assert.equal(captured.method, 'POST')
|
||||
// 只断言 names：send() 会按幂等约定往请求体里补一个 requestId，整包深比较会被它带偏。
|
||||
assert.deepEqual((JSON.parse(String(captured.body)) as { names: string[] }).names, [
|
||||
'3f6a1c.png',
|
||||
'aabb.png',
|
||||
])
|
||||
assert.deepEqual(result.deleted, ['3f6a1c.png'])
|
||||
assert.equal(result.failed.length, 1)
|
||||
assert.match(result.failed[0]?.reason ?? '', /仍被引用/)
|
||||
})
|
||||
@@ -0,0 +1,152 @@
|
||||
import { test } from 'node:test'
|
||||
import assert from 'node:assert/strict'
|
||||
|
||||
/**
|
||||
* 参赛单位「恢复」的前端契约：方法 / 路径、已删除单位的列表开关，以及失败时服务端那句话的传递。
|
||||
*
|
||||
* 恢复是「彻底删除」（假删除）的反操作：报名、成绩与积分一行没动，所以服务端只回报
|
||||
* restored 与恢复后的单位，不重算、不推榜单。这里把契约钉住，免得有人按别的写法改坏。
|
||||
*/
|
||||
|
||||
interface Captured {
|
||||
url?: string
|
||||
method?: string
|
||||
headers?: Record<string, string>
|
||||
}
|
||||
|
||||
function jsonResponse(body: unknown, status = 200): Response {
|
||||
return new Response(JSON.stringify(body), {
|
||||
status,
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
})
|
||||
}
|
||||
|
||||
let reply: () => Response = () => jsonResponse({ ok: true, data: null })
|
||||
let lastRequest: Captured = {}
|
||||
|
||||
// 必须在导入被测模块之前装好：ApiClient 在构造时就把当时的 fetch 绑进实例，
|
||||
// 之后再替换 globalThis.fetch 对它无效。所以这里装一个固定函数，每个用例只换回复。
|
||||
globalThis.fetch = (async (input: unknown, init?: RequestInit) => {
|
||||
lastRequest = {
|
||||
url: String(input),
|
||||
method: init?.method ?? 'GET',
|
||||
headers: (init?.headers ?? {}) as Record<string, string>,
|
||||
}
|
||||
return reply()
|
||||
}) as typeof fetch
|
||||
|
||||
function respondWith(response: () => Response): void {
|
||||
lastRequest = {}
|
||||
reply = response
|
||||
}
|
||||
|
||||
const { ApiError, adminApi } = await import('../api/client')
|
||||
|
||||
test('恢复走 POST /api/teams/{id}/restore 并回报 restored', async () => {
|
||||
respondWith(() =>
|
||||
jsonResponse({
|
||||
ok: true,
|
||||
data: {
|
||||
team: { id: 3, code: 'A', name: '第一分公司', shortName: '一司', logoPath: null, color: null, sortOrder: 0, active: true, deletedAt: null },
|
||||
restored: true,
|
||||
},
|
||||
}),
|
||||
)
|
||||
|
||||
const result = await adminApi.client.teams.restore(3)
|
||||
|
||||
assert.equal(lastRequest.url, '/api/teams/3/restore')
|
||||
assert.equal(lastRequest.method, 'POST')
|
||||
assert.equal(result.restored, true)
|
||||
assert.equal(result.team.deletedAt, null)
|
||||
assert.equal(result.team.active, true)
|
||||
})
|
||||
|
||||
// 服务端中间件要求已登录的写请求带 X-CSRF-Token，漏掉就是 403，点「恢复」恢复不了还看不出原因。
|
||||
test('恢复带上 CSRF 双提交 Cookie 的请求头', async () => {
|
||||
respondWith(() => jsonResponse({ ok: true, data: { team: {}, restored: false } }))
|
||||
const globalWithDocument = globalThis as { document?: unknown }
|
||||
globalWithDocument.document = { cookie: 'csrf_token=token-123' }
|
||||
try {
|
||||
await adminApi.client.teams.restore(3)
|
||||
} finally {
|
||||
delete globalWithDocument.document
|
||||
}
|
||||
|
||||
assert.equal(lastRequest.headers?.['X-CSRF-Token'], 'token-123')
|
||||
})
|
||||
|
||||
// 幂等命中：服务端回 restored=false，前端不该把它当成失败。
|
||||
test('单位本就未删除时 restored=false 也算成功', async () => {
|
||||
respondWith(() =>
|
||||
jsonResponse({
|
||||
ok: true,
|
||||
data: {
|
||||
team: { id: 4, code: 'B', name: '第二分公司', shortName: null, logoPath: null, color: null, sortOrder: 1, active: false, deletedAt: null },
|
||||
restored: false,
|
||||
},
|
||||
}),
|
||||
)
|
||||
|
||||
const result = await adminApi.client.teams.restore(4)
|
||||
|
||||
assert.equal(result.restored, false)
|
||||
// 停用的单位不能被「恢复」顺手改成启用。
|
||||
assert.equal(result.team.active, false)
|
||||
})
|
||||
|
||||
// 列已彻底删除的单位要显式带开关，否则服务端不会把隐藏的行放进来。
|
||||
test('includeDeleted 拼成 ?includeDeleted=1', async () => {
|
||||
respondWith(() => jsonResponse({ ok: true, data: [] }))
|
||||
|
||||
await adminApi.client.teams.list({ includeDeleted: true })
|
||||
|
||||
assert.equal(lastRequest.url, '/api/teams?includeDeleted=1')
|
||||
assert.equal(lastRequest.method, 'GET')
|
||||
})
|
||||
|
||||
// 默认列表不能带上这个开关：非 admin 带它会被服务端 403，整个单位列表就空了。
|
||||
test('默认列表不带 includeDeleted 查询串', async () => {
|
||||
respondWith(() => jsonResponse({ ok: true, data: [] }))
|
||||
|
||||
await adminApi.client.teams.list()
|
||||
|
||||
assert.equal(lastRequest.url, '/api/teams')
|
||||
})
|
||||
|
||||
// 失败时不吞错误：服务端那句原文（单位不存在 / 编码被占用）必须原样带出。
|
||||
test('恢复失败时服务端那句原文原样带出', async () => {
|
||||
respondWith(() =>
|
||||
jsonResponse({ ok: false, error: { code: 'VALIDATION_FAILED', message: '单位不存在' } }, 404),
|
||||
)
|
||||
|
||||
await assert.rejects(
|
||||
() => adminApi.client.teams.restore(999999),
|
||||
(error: unknown) => {
|
||||
assert.ok(error instanceof ApiError)
|
||||
assert.equal(error.status, 404)
|
||||
assert.equal(error.message, '单位不存在')
|
||||
return true
|
||||
},
|
||||
)
|
||||
})
|
||||
|
||||
test('恢复撞上编码冲突时把 409 的原文带出', async () => {
|
||||
respondWith(() =>
|
||||
jsonResponse(
|
||||
{ ok: false, error: { code: 'CONFLICT', message: '单位编码 A 已被另一个可见单位占用，请先处理那个单位再恢复' } },
|
||||
409,
|
||||
),
|
||||
)
|
||||
|
||||
await assert.rejects(
|
||||
() => adminApi.client.teams.restore(3),
|
||||
(error: unknown) => {
|
||||
assert.ok(error instanceof ApiError)
|
||||
assert.equal(error.status, 409)
|
||||
assert.equal(error.code, 'CONFLICT')
|
||||
assert.match(error.message, /已被另一个可见单位占用/)
|
||||
return true
|
||||
},
|
||||
)
|
||||
})
|
||||
Reference in new issue
Block a user