Files
UHD_Media_Tool/apps/web
rootandClaude Opus 5.5 8c8b252667 feat(storage): 数据保留补齐引擎运行与流水表,新增每天低峰的流水数据清理和 db-retention 脚本
- 保留规则改为声明式(retention.ts 每个任务的 rules),定时任务、立即清理、脚本 dry-run 共用一份条件;
  删得多(≥ 1000 行)的表删完 ANALYZE
- 引擎 run 单独保留期 engineRun(缺省 14 天):只删终态、过期、没被保留中业务任务引用、父 run 已结束的;
  step_attempts 级联,运行元数据 / 事实 / 信号跟随 run(原来按时间直接删,长时间运行的 run 会丢元数据)
- 业务任务被 agent_run / decision 等引用时不删(外键 set null,删了会断开引用)
- 新任务 storage.retention.pipeline(每天 04:40):已投递 outbox 事件(只删无幂等键或一次性幂等键)、
  识别尝试(每条资源留最近 3 次)、已识别且资源仍绑定作品的待识别条目(忽略 / 归档不删)、
  站点快照(每站最近一次成功的列表快照保留)
- settings.storage.retentionDays 追加 engineRun / outboxEvent / resolutionAttempt / identityResolved /
  siteSnapshot(旧库按缺省补),设置页「系统 → 数据保留」显示
- scripts/db-retention.ts:缺省 dry-run 输出每张表将删行数,--apply 执行,--only 选目标
- 测试:各表按规则删、被引用 / 未结束的不删、dry-run 与删除一致、分批;EXPLAIN 确认改写后的查询走索引

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Cxwgnn2pbzQ7rXv3rq7fei
2026-10-06 20:24:26 +08:00
..
2026-10-06 18:58:53 +08:00

@umt/web

React Router 7 SPA 控制台(ssr:false),沿用 uhd_web 设计系统(token 见 app/app.css,规范见 docs/design/)。只通过 /api/v1 与 server 通信,请求/响应类型一律来自 @umt/contracts,不手写重复 DTO。开发端口 5180,/api 代理到 http://localhost:4380。

命令

在仓库根目录执行:

  • deno task dev:web:开发服务器(5180)。
  • cd apps/web && deno task build:生产构建到 build/client,由 server 的 WEB_ROOT 同端口托管。
  • cd apps/web && deno task test:单测(app/**/*.test.ts)。
  • deno task test:web:smoke:Playwright 全页面冒烟,前提与环境变量见仓库 README。
  • deno task check:tokens:设计 token 守卫。

目录

  • app/routes/:页面(routes.ts 登记全部路由);app/routes/console/ 为控制台。
  • app/api/:按资源分的 react-query hook,路径与 schema 取 @umt/contracts 的 Api 注册表。
  • app/components/:业务组件与 ui/ 基础组件。
  • Agent 页的 ?mock=1 演示模式只在开发构建或后端 pi.provider = "fake" 时生效,生产构建连真实模型时忽略。