spec.md 1.7 KB

大屏版本管理与生成记录稽核

背景

当前大屏编辑器启用了实时保存,编辑过程会持续写入 ai_report_project.component_data。如果把版本创建绑定到普通保存,会产生大量无业务意义的版本记录,影响历史版本查看和回退体验。

管理侧已有 ai_dashboard_generate_record 表保存 AI 大屏生成记录,但缺少稽核查询页面和跨用户分页接口。

范围

  • forge-report-server 新增大屏发布版本表、实体、Mapper、服务和接口。
  • forge-report-ui 新增历史版本查看、回退、下载配置、历史版本预览入口。
  • forge-plugin-ai 新增生成记录管理端分页/详情接口。
  • forge-admin-ui 新增生成记录稽核页面。
  • 数据库增量脚本放入 forge/db/migration

规则

  1. 普通实时保存只更新当前草稿,不创建历史版本。
  2. 发布成功后创建版本快照,记录项目配置、发布地址、发布人、发布时间。
  3. 回退历史版本时恢复项目配置,并追加一条回退版本记录,保留审计链路。
  4. 历史版本预览读取版本快照,不污染当前项目草稿。
  5. 生成记录稽核接口按租户查询,可按项目、业务定义、用户、状态、时间过滤。

验收标准

  • 发布大屏后可在版本弹窗看到版本号、发布人、发布时间、操作类型。
  • 历史版本支持预览、下载 JSON 配置、回退。
  • 编辑器实时保存不会新增版本记录。
  • 管理端可查询 AI 大屏生成记录并查看 prompt、生成摘要、错误信息等详情。
  • 后端编译通过,前端构建或 lint 至少完成相关项目验证。