From 39fe448b48c1ef5f938ac9e4fd058297fa338e9c Mon Sep 17 00:00:00 2001 From: yml2213 Date: Sun, 25 Oct 2026 13:34:09 +0800 Subject: [PATCH] =?UTF-8?q?feat(cost-exceptions):=20=E6=94=AF=E6=8C=81=20-?= =?UTF-8?q?-days=3D0=20=E4=B8=80=E6=AC=A1=E6=80=A7=E5=BD=92=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 一次性清理需要「不按时间过滤」的语义，但 CLI 把 days 下限钳在 1： 本地库的 15.2 万条 resolved 异常是 17 小时前重建生成的， --days=1 一条都命中不了，只能手写 SQL。 - --days=0 表示不过滤时间，归档全部已处理行（open 仍不归档）； - 执行时打印一次性清理提示，避免日常误用； - 记录 2026-10-25 的实际清理结果：151,939 行 / 152 批 / 3.9 秒， 热表 260,253 → 108,314（全为 open），VACUUM FULL 后 155 MB → 51 MB， 归档表 61 MB，主键重叠 0 条。 验证：--days=0 --dry-run 返回 retentionDays=0、archivableRows=0（已清空）。 --- apps/backend/scripts/archive-cost-exceptions.ts | 7 ++++++- docs/成本中心与履约模型.md | 5 +++++ 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/apps/backend/scripts/archive-cost-exceptions.ts b/apps/backend/scripts/archive-cost-exceptions.ts index b029db4a..a694c615 100644 --- a/apps/backend/scripts/archive-cost-exceptions.ts +++ b/apps/backend/scripts/archive-cost-exceptions.ts @@ -7,6 +7,7 @@ * npm run cost-exceptions:archive -- --dry-run * npm run cost-exceptions:archive -- --days=90 * npm run cost-exceptions:archive -- --days=60 --batch-size=2000 + * npm run cost-exceptions:archive -- --days=0 # 一次性清理：归档全部已处理行 */ import process from 'node:process' @@ -19,13 +20,17 @@ import { const options = parseOptions(process.argv.slice(2)) const defaultDays = Number(runtimeConfig.retention?.costExceptionDays) || 60 -const retentionDays = normalizeInteger(options.days, defaultDays, 1, 3650) +// 0 表示不按时间过滤：一次性把已处理的历史异常全部归档（日常任务永远 >= 1 天）。 +const retentionDays = normalizeInteger(options.days, defaultDays, 0, 3650) const batchSize = normalizeInteger(options.batchSize, 1000, 1, 10_000) const dryRun = options.dryRun === 'true' async function main() { const startedAt = Date.now() const archivable = await countArchivableCostExceptions(retentionDays) + if (retentionDays === 0) { + console.warn('[archive] days=0：一次性清理，将归档全部已处理异常（open 行不受影响）') + } if (dryRun) { console.log( diff --git a/docs/成本中心与履约模型.md b/docs/成本中心与履约模型.md index 0c25c919..c99f9f2d 100644 --- a/docs/成本中心与履约模型.md +++ b/docs/成本中心与履约模型.md @@ -482,9 +482,14 @@ npm run revenue:backfill -- --batch-size=2000 --max-batches=100 | 落点 | `cost_exceptions_archive`（保留原 id 与时间字段，加 `archived_at`） | | 执行 | `data-retention` 每日任务；每批 1000 行，`DELETE ... RETURNING` + `INSERT` 同语句，单批原子 | | 手动 | `npm run cost-exceptions:archive -- --dry-run` / `-- --days=90` | +| 一次性清理 | `npm run cost-exceptions:archive -- --days=0`（不按时间过滤，归档全部已处理行；open 仍不归档） | 归档不删除审计痕迹，但热表查询与页面上不会再出现这些历史行；需要追溯时查归档表。 +> **2026-10-25 已执行一次性清理**：`--days=0` 口径归档 151,939 条 resolved 异常（152 批，3.9 秒）。 +> 热表 260,253 → 108,314 行（全部为 open），`VACUUM FULL` 后体积 155 MB → 51 MB（heap 38 / idx 13）， +> 归档表 61 MB；主键重叠校验 0 条。生产环境不要在业务时段跑 `VACUUM FULL`，日常由 autovacuum 复用空间即可。 + --- ## 十、关联文档