forge_admin/code-copilot/changes/archive/form-first-business-object-designer/research.md

fcDesigner 集成能力盘点

change: form-first-business-object-designer task: Task 1 date: 2026-05-31

1. 结论

当前项目已经具备可复用的 fcDesigner / form-create 基础，不需要首期自研完整表单画布。

推荐路线：

fcDesigner 可视化编辑 -> form-create rule/options -> Forge Adapter -> FormDesignerSchema + FieldRegistry + ViewSchema + LinkageSchema -> LowcodeRuntimeConfigBuilder -> AiCrudPage

关键边界：

• fcDesigner 负责拖拽、排序、复制、删除、基础属性编辑、JSON 预览和设计预览。
• Forge 负责业务对象上下文、字段绑定、业务组件、级联联动、视图投影、发布检查和运行态编译。
• form-create rule/options 可以作为设计态可编辑表示，但不能作为 Forge 运行时唯一事实来源。

2. 依赖版本

来源：

• forge-admin-ui/package.json
• forge-admin-ui/pnpm-lock.yaml

当前依赖：

• @form-create/designer: package 声明 ^3，锁定版本 3.4.0
• @form-create/element-ui: package 声明 ^3，锁定版本 3.3.0
• 设计态依赖 Element Plus 外观，运行态 Forge 仍以 Vue3 + Naive UI + AiCrudPage 为主。

3. 已有可复用能力

3.1 流程动态表单

相关文件：

• forge-admin-ui/src/components/form-create/FlowFormCreateDesigner.vue
• forge-admin-ui/src/components/form-create/FlowFormCreateRenderer.vue
• forge-admin-ui/src/components/form-create/formCreateBridge.js
• forge-admin-ui/src/components/bpmn/NodePropertiesPanel.vue

已具备能力：

• 安装 Element Plus 和 @form-create/element-ui 插件。
• 使用 FcDesigner 渲染表单设计器。
• 支持 setRule、getRule、setOption、保存、清空。
• 支持 form-create renderer 做预览和流程运行态动态表单提交。
• formCreateBridge.js 已提供 rule/options normalize、默认 options、clone、旧字段协议兼容。

可复用点：

• 插件安装逻辑应沉淀为统一 bridge，避免不同组件重复安装 Element Plus / form-create。
• normalize 逻辑可扩展为 Forge Adapter 的输入清洗层。
• renderer 可继续作为设计预览态，不替代发布运行态。

3.2 低代码页面表单适配器

相关文件：

• forge-admin-ui/src/components/lowcode-builder/page/FormCreateDesignerAdapter.vue
• forge-admin-ui/src/components/lowcode-builder/page/page-schema.js
• forge-admin-ui/src/components/lowcode-builder/preview/LowcodePreviewPane.vue

已具备能力：

• 在低代码页面 edit zone 中嵌入 FcDesigner。
• 根据模型字段生成 form-create rule。
• 支持字段类型到基础 form-create 控件映射：input、textarea、inputNumber、select、radio、checkbox、datePicker、timePicker、switch、upload。
• 支持保存 formCreateRule 和 formCreateOptions 到 zone props。
• 支持根据 rule 中的 field 抽取字段引用。
• 支持清理不存在字段、重复字段引用。
• 支持主子表布局下主表字段和子表字段分离展示。
• LowcodePreviewPane.vue 已能优先读取 canvas/form-create 字段引用做草稿预览。

可复用点：

• FormCreateDesignerAdapter.vue 可以作为业务对象表单设计器的画布基础，但需要抽出转换器，避免只绑定 zone.props.formCreateRule。
• page-schema.js 的 resolveFieldRefsFromFormCreateRules 可迁移或复用到 formDesignerSchema.js。
• buildRuleFromField、resolveRuleType、buildRuleProps 可作为 Forge Schema -> form-create 的第一版映射基础。

4. 主要缺口

4.1 缺少 Forge FormDesignerSchema

现在保存的是 formCreateRule/formCreateOptions 或页面 zone canvas，不是面向业务对象的稳定表单协议。

需要补齐：

• FormDesignerSchema
• 组件稳定 id
• fieldBinding
• 表单 layout
• validation
• visibility
• _forge 扩展属性保留

4.2 缺少字段绑定和自动建字段协议

当前低代码适配器假设字段已经存在于模型字段列表。表单优先需要支持：

• 拖入组件后生成临时字段绑定。
• 保存时批量创建缺失字段。
• 已发布字段重命名不改 fieldCode / columnName。
• 删除表单组件不删除字段资产。

4.3 Forge 业务组件仍不完整

需要为 fcDesigner 设计态和 Forge 运行态建立映射：

• DictSelect
• 级联字典选择
• RegionTreeSelect
• 组织树 / 部门选择
• 用户选择
• 文件上传 / 图片上传
• 业务对象引用
• 子表 / 明细表

4.4 级联能力没有统一模型

当前字典组件和 optionSource 缺少统一 LinkageSchema。

需要补齐：

• parentDictCode
• linkedDictType
• linkedDictValue
• remoteParam
• orgScope
• objectReference
• clearOnSourceChange
• emptyStrategy

4.5 视图投影与运行态配置未统一

当前表单、查询、列表、详情分散在页面 Schema、canvas、zone props 中。表单优先需要：

• 从表单和字段注册表派生查询、列表、详情。
• 只保存视图覆盖项。
• 支持表单、查询、列表分别配置同一字段的不同对齐方式。
• 发布时统一输出到 LowcodeRuntimeConfigBuilder 使用的运行态配置。

5. 首期不做

• 不自研完整拖拽画布。
• 不把 form-create rule/options 当作最终运行时事实来源。
• 不把普通用户带到 DDL、表名、JSON Schema、configKey 配置。
• 不替换 DynamicCrudController。
• 不替换 AiCrudPage。
• 不在本阶段实现多人实时协同。

6. 后续实施建议

1. 先定义 FormDesignerSchema、ViewSchema、LinkageSchema 的前端工具和后端 DTO。
2. 再建设 form-create rule/options 与 Forge Schema 的双向转换器。
3. 然后把 FormCreateDesignerAdapter.vue 包装成业务对象表单设计器，输出 Forge Schema。
4. 最后接入发布检查和 LowcodeRuntimeConfigBuilder，确保运行态仍复用现有动态 CRUD。