Halaman utama Jelajahi Bantuan
Masuk
user5
/
forge_admin
1
0
Fork 0
Berkas Masalah 0 Tarik Permintaan 0 Wiki
Pohon: 0ce11f04cb
Ranting Tag
forge_admin
/
code-copilot
/
changes
/
archive
/
ai-crud-table-expand-enhancement
/
tasks.md

tasks.md 5.5 KB
Riwayat Mentahan

任务拆分 — AiCrudPage 表格增强与通用展开面板

拆分顺序：配置协议 → 底层表格能力 → 展开数据加载 → 展开渲染器 → 设计器入口 → 预览发布适配 每个任务 = 可独立提交的原子变更（3-5 个文件） 每个任务必须精确到文件路径和函数签名

前置条件

  • 用户确认 spec.md 中 expandConfig.panels[] 协议。
  • 用户确认第一期展开内容范围：建议 table、descriptions、tabs 必做，form、custom 做基础支持。
  • 用户确认运行态列宽拖拽第一期是否持久化。

Task 1: 扩展 AiCrudPage 配置协议

  • 状态: 已完成
  • 目标: 在 props 层定义表格增强和展开面板配置，不改变未配置页面行为。
  • 涉及文件:
    • forge-admin-ui/src/components/ai-form/AiCrudPageProps.js — 新增 expandConfig、表格拖拽相关 props 注释和默认值。
    • forge-admin-ui/src/components/ai-form/AiCrudPage.vue — 读取并归一化 expandConfig，传给 AiTable。
  • 关键签名: js const normalizedExpandConfig = computed(() => normalizeExpandConfig(props.expandConfig, props.childrenConfig))

Task 2: 补齐 AiTable 表格基础能力

  • 状态: 已完成
  • 目标: 支持列宽拖拽、固定头部、固定列稳定运行，并把 Naive UI 展开能力开放给 AiCrudPage。
  • 涉及文件:
    • forge-admin-ui/src/components/ai-form/AiTable.vue — 支持 resizable、onUpdate:columns/列宽状态、展开列渲染透传。
    • forge-admin-ui/src/components/ai-form/AiCrudPage.vue — 管理拖拽后的列宽状态，合并到 tableColumns。
  • 关键签名: js function handleColumnResize(columnKey, width) {} const runtimeTableColumns = computed(() => mergeColumnWidthState(tableColumns.value, columnWidthState.value))

Task 3: 新增展开数据加载与参数映射

  • 状态: 已完成
  • 目标: 支持 row、api、children 三类数据源，按当前行映射参数并懒加载缓存。
  • 涉及文件:
    • forge-admin-ui/src/components/ai-form/AiCrudRowExpand.vue — 新增，负责展开行数据加载、缓存状态和错误展示。
    • forge-admin-ui/src/components/ai-form/expand-utils.js — 新增，封装 resolveExpressionValue、buildExpandParams、extractExpandData。
    • forge-admin-ui/src/components/ai-form/AiCrudPage.vue — 在展开列中渲染 AiCrudRowExpand。
  • 关键签名: js export function buildExpandParams(paramsMap, row, context = {}) {} export async function loadExpandPanelData(panel, row, context = {}) {}

Task 4: 实现展开内容渲染器

  • 状态: 已完成
  • 目标: 展开内容不局限表格，支持多种飞书式展开展示。
  • 涉及文件:
    • forge-admin-ui/src/components/ai-form/expand-renderers/ExpandTablePanel.vue — 新增，渲染子表。
    • forge-admin-ui/src/components/ai-form/expand-renderers/ExpandDescriptionsPanel.vue — 新增，渲染描述信息。
    • forge-admin-ui/src/components/ai-form/expand-renderers/ExpandFormPanel.vue — 新增，渲染只读 AiForm。
    • forge-admin-ui/src/components/ai-form/expand-renderers/ExpandTabsPanel.vue — 新增，渲染多面板 tabs。
    • forge-admin-ui/src/components/ai-form/expand-renderers/ExpandCustomPanel.vue — 新增，渲染插槽/注册组件。
  • 关键签名: vue <ExpandPanelRenderer :panel="panel" :row="row" :data="panelData" :context="context" />

Task 5: 设计器新增展开面板配置入口

  • 状态: 已完成
  • 目标: 用户通过可视化方式配置展开面板，优先选择“子表 / 描述 / Tabs / 自定义”预设。
  • 涉及文件:
    • forge-admin-ui/src/components/lowcode-builder/page/ListPageGridDesigner.vue — AiCrudPage 属性区新增“展开面板”配置。
    • forge-admin-ui/src/views/app-center/components/designer/forge-form-designer/ForgePropertyPanel.vue — 表单设计器 CRUD 更多配置新增列宽拖拽和展开面板配置。
    • forge-admin-ui/src/views/app-center/components/designer/BusinessListDesigner.vue — schema 到运行态 props 时透传 expandConfig。
    • forge-admin-ui/src/components/lowcode-builder/page/GridBlockRenderer.vue — 设计器画布预览透传 expandConfig。
  • 关键签名: js function updateAiCrudExpandConfig(patch) {} function createDefaultExpandPanel(type, relation) {}

Task 6: 低代码预览与发布链路适配

  • 状态: 已完成（当前运行链路透传）
  • 目标: 运行预览、发布运行页和动态 CRUD 页面都按同一协议展示展开面板。
  • 涉及文件:
    • forge-admin-ui/src/components/lowcode-builder/preview/LowcodePreviewPane.vue — 预览运行态透传 expandConfig。
    • 低代码 schema 编译相关文件（按实际定位）— 保留 expandConfig。
    • 动态 CRUD 配置渲染相关文件（按实际定位）— 保留 expandConfig。
  • 关键签名: js function transformExpandConfigForRuntime(expandConfig, modelSchema) {}

Task 7: 验证与修正

  • 状态: 已完成
  • 目标: 覆盖表格基础能力、展开子表、描述展开、Tabs 展开和兼容性。
  • 涉及文件:
    • code-copilot/changes/ai-crud-table-expand-enhancement/execution-log.md — 追加验证记录。
    • code-copilot/changes/ai-crud-table-expand-enhancement/test-spec.md — 按实际实现更新验证证据。
  • 关键命令: bash source ~/.nvm/nvm.sh && nvm use v20.19.0 pnpm --dir forge-admin-ui build