This repository was archived by the owner on Nov 4, 2026. It is now read-only.
Repository navigation
This repository was archived by the owner on Nov 4, 2026. It is now read-only.
[Tracking] ADR-0034: 运行时编辑统一到 studio 的草稿/发布模型 #1516
Description
总览 issue。决策文档:docs/adr/0034-unified-runtime-metadata-persistence.md。
目标:运行时(ObjectView/ReportView/DashboardView)的编辑统一复用 studio 的 per-item 草稿 → 发布 → 版本 模型(经 /meta),退役 sys_view/sys_report/sys_dashboard。保存=暂存草稿(用户看不到、编辑者实时预览),显式发布才生效。
✅ 已开发并合并(sandbox 内可验证的部分)
| PR | 内容 |
|---|---|
| #1496 | 运行时视图编辑 UI 统一到 studio ViewVariantInspector |
| #1503 | 视图 inspector 标签 i18n(en/zh) |
| #1504 | 报表编辑 UI 统一到 studio ReportDefaultInspector |
| #1505 | 仪表盘编辑 UI 统一到 studio inspectors |
| #1508 | 报表/仪表盘编辑器补 admin 门控(修复无门控共享编辑) |
| #1509 | PageView「在 studio 编辑」深链按钮 |
| #1513 | 持久化 seam(persistRuntimeMetadata/publishRuntimeMetadata)+ report/dashboard 接线;flag VITE_RUNTIME_EDIT_VIA_META 默认关=现有 sys_* 行为零变化 |
| #1514 | ObjectView 视图更新路径接入 seam(flag-off 走真实的 dataSource.updateViewConfig) |
现状:三个运行时编辑器的主要保存路径都经过 seam;flag 默认关 → 行为与改造前逐字节一致;flag 开 → 走 metadataClient.save(type,name,body,{mode:'draft'}) + publish。已有单测覆盖 flag 开/关两条路径。
关键约束:本仓库 CI/沙箱无运行后端,所以 flag-on 的「保存→草稿→发布→读回」真实链路至今未经端到端验证。
🔍 需验证(必须在有后端的真实环境做 —— 见 #1518)
设 VITE_RUNTIME_EDIT_VIA_META=true 后验证:
- 保存=草稿:运行时编辑 view/report/dashboard → 保存 → 后端生成 per-item 草稿(
PUT /meta/:type/:name?mode=draft),其他用户看不到。 - 发布:对该 item 发布(暂借 studio 现有"发布"UI)→ 生效 + 记版本。
- 读回 / 续编:发布后运行时读到新值;
GET /meta/:type/:name?state=draft能读回草稿继续编辑。 - 回退:flag 设回
false→ 完全回到sys_*行为。 - 权限(仅管理员)、即时性、多租户归属、读路径(运行时读已发布有效值)。
⚠️ 在验证通过前,不要翻默认值、不要删sys_*、不要做数据迁移。
🛠 后续开发任务(子 issue)
- ADR-0034 step 3: runtime draft/publish UI chrome (flag-gated) #1515 — step 3:运行时草稿/发布 UI(发布按钮 / 未发布指示 / 丢弃草稿 / 打开续编),flag 门控 — PR feat(adr-0034): runtime draft/publish UI chrome + view-create seam (#1515, #1517) #1533
- ADR-0034: 视图创建路径(handleViewCreate)接入持久化 seam #1517 — 视图创建路径(
handleViewCreate:createView+ 默认列/kanban/gallery)接入 seam — PR feat(adr-0034): runtime draft/publish UI chrome + view-create seam (#1515, #1517) #1533 - ADR-0034: 在真实环境验证 flag-on 并翻默认值 #1518 — 在真实环境验证 flag-on(showcase 后端,save→draft→publish→version 全通)。flag 已随 ADR-0034: 迁移 sys_* 到覆盖层并退役专用表 + 清理形状转换 #1519 整体移除(metadata 成为唯一路径),翻默认已不适用。
- ADR-0034: 迁移 sys_* 到覆盖层并退役专用表 + 清理形状转换 #1519 — 退役
sys_*(前端)— PR feat(adr-0034): retire sys_view/sys_report/sys_dashboard (#1519) #1534。系统未上线,跳过数据迁移;前端删除 flag + 所有 legacy 路径 +toSysViewPayload/fromSysViewRecord。后端删 object schema/endpoint 为独立 framework-repo 任务。 - ADR-0034 (v2/未来): 仅视图的 per-user 个性化(user 覆盖 scope) #1520 —(v2/未来)仅视图加
user覆盖 scope,支持普通用户个性化
每个子 issue 内都写明了「✅ 已开发 / 🔍 待验证 / 🛠 后续开发」三块。
建议顺序:#1515 +#1517(可并行,flag 默认关、安全)→ #1518(真实环境验证、翻默认)→ #1519(迁移退役)→ #1520(v2,按需)。
Activity
xuyushun441-sys commentedon Jun 6, 2026
进度更新 — #1515 + #1517 完成并真实环境验证(PR #1533)
✅ #1515(草稿/发布 UI chrome)+ ✅ #1517(视图创建接入 seam)已开发、单测、并在有后端的真实环境(app-showcase :3000)端到端验证。flag 仍默认关。
真实环境已验证(flag ON)— 提前覆盖了 #1518 验证清单的大部分
PUT /meta/:type/:name?mode=draft,他人不可见)op=publishGET ?state=draft)外加修了一个会阻断 flag-on 落库的既有问题:
useMetadataClient用空 baseUrl,在 SPA/后端分离环境下/meta写入 404(studio 编辑同样受影响)——改为读VITE_SERVER_URL,已并入 PR #1533。仍需在 #1518 正式收尾
顺序
PR #1533 合并 → #1518(翻默认)→ #1519(迁移退役)→ #1520(按需)。
xuyushun441-sys commentedon Jun 6, 2026
进度更新 —
sys_*退役完成(PR #1534 已合并)ADR-0034 前端部分全部落地并合入 main:
sys_view/sys_report/sys_dashboard(PR feat(adr-0034): retire sys_view/sys_report/sys_dashboard (#1519) #1534)— 系统未上线,跳过数据迁移。删除 flagVITE_RUNTIME_EDIT_VIA_META+ 全部 legacy 写/读/兜底路径 + shape adapter;运行时编辑现在只走 metadata 草稿/发布/版本。唯一剩余(独立 framework-repo 任务)
删除后端物理表的 object schema + 自动 CRUD 端点(
sys_view/sys_report/sys_dashboard)。前端已不再引用它们,这些表现在是 dead,可在 framework 仓库独立删除。范围外
xuyushun441-sys commentedon Jun 6, 2026
ADR-0034 完成,关闭总览
前端主体全部开发、验证(真实 showcase 后端)、合并到 main:
sys_*(PR feat(adr-0034): retire sys_view/sys_report/sys_dashboard (#1519) #1534):删 flag + 全部 legacy 路径 + shape adapter;运行时编辑只走 metadata 草稿/发布/版本。系统未上线,跳过数据迁移。"后端删表"核查 → 无需操作
核查 framework 仓库与 showcase DB:
sys_view/sys_report/sys_dashboard的 object schema 与物理表均不存在(只有不相关的 sys_view_definition/sys_report_schedule)。这些 legacy 表在当前后端从未实现,真实持久化一直是 metadata 覆盖层。无 schema/endpoint 可删——该尾巴已满足。范围外(独立跟踪)
总览目标达成,关闭。