Files
eip4-platform/docs/plans/2026-06-20-人走五环建新功能-NocoBase式-design.md
zhengwr 22d481e1cb docs(plan): land human five-ring build-new-feature design (NocoBase-style modeler + live designer)
Brainstorm output. Locks: NocoBase-style modeler+live-designer (no linear wizard);
v1 builds NEW features only (CREATE proven, ALTER=M4 deferred); recipe auto-generates
wired default page then edit in DesignerPage; AI-assist via external agent+Skills
(no in-platform LLM); single metadata truth SYS_ENTITY/SYS_ENTITYATTRIBUTE.
Companion to 2026-06-19 direction+roadmap. Ready for writing-plans.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 00:16:31 +08:00

8.9 KiB
Raw Blame History

人走五环建新功能 · NocoBase 式(建模器 + 实时设计器)· 设计

日期 2026-06-20 | brainstorm 产物 | 配套《2026-06-19-EIP4开发平台-架构方向-design.md》(方向 D1-D7)+《2026-06-19-EIP4开发平台-落地执行路线图.md》(里程碑 M0-M8)。 决策来源:memory eip4-human-five-ring-wizard(宽度 vs 深度 → 选 B:人走五环建新功能,AI 退回加速器)。 本文是该特性的设计定型,供新会话直接跑 superpowers:writing-plans 出实施计划。

0. 一句话

给老引擎本来就有的「元数据驱动低代码核」配一套 NocoBase 式的现代 UI(建模器 + 实时设计器),不做线性问卷向导;让人能走完整五环(元数据→设计→实现→发布)建新功能,AI 作为加速器、不是唯一通道。

1. 锁定的决策(带依据)

  • D-A 形态 = 建模器 + 实时设计器,不做线性 wizard。 依据:用户指定参考 NocoBase,NocoBase 用「实时所见即所得区块设计器 + 一键切使用/配置模式」,明确不用向导;且我们今天刚把 DesignerPage(amis-editor)修到全闭环,与之天然契合。
  • D-B v1 只「建新功能」,不「改已有表」。 依据:CREATE 建表后端已 live 验证(见 §3);唯一缺口是 ALTER(改已有表的列)= 路线图 M4,留给 v2。
  • D-C 建完实体走「recipe 自动产默认页 → 进设计器微调」,不走「空白页现拖组件绑实体」。 依据:PageBlueprintCompiler.compile() 吃 blueprint 直接产出已接好 /api/flow/{TABLE}_SEARCH 的页(PageBlueprintCompiler.java:50);DesignerPage 现为 edit-only(只改存量页),recipe 预接好页正好落在它能干的范围内,设计器无需长「从零绑实体」的新能力。
  • D-D「AI 帮我」走 ①面(外部 agent + Skills + CLI 驱动确定性工具),不在平台内置生成 LLM。 依据:见 §3——平台主路径零 LLM,NocoBase 的「建功能 AI」本身就是外部 coding-agent CLI + Skills;EIP4 已建好这套底座(docs/skills/ + platform-cli + AiToolRegistry + AiEmployee)。②面(in-app AI employees,平台内置 LLM)= v1 之后单独立项。
  • D-E 元数据单一真相 = SYS_ENTITY + SYS_ENTITYATTRIBUTE(老系统保真层),新旧共用。 见 §3。

2. 整体形态 + 建功能流程

两个界面(落在设计中心):

  1. 建模器(新建的唯一无对应 UI 的环)— 建/浏览实体 + 字段,包 POST /api/meta/entity。
  2. 实时设计器(DesignerPage / amis-editor,已有,edit-only)— 微调页面。

建一个新功能的流:

①建模器建实体+字段
   → POST /api/meta/entity(写 SYS_ENTITY/SYS_ENTITYATTRIBUTE + 真 CREATE 物理表)
②选 recipe(维护CRUD / 树CRUD)
   → PageBlueprintCompiler 自动产出已接 /api/flow 的默认页 → 落 sys_page_schema(标准层)
③默认页进 DesignerPage 微调(拖列/调布局)
④选菜单位置 + 发布(PageSchemaWriter 单一写真相 + 菜单注册)
   (五流 _ADD/_UPDATE/_SEARCH/_DELETE/_LOAD 由 DefaultFlowHelper 默认生成,可见可确认,多数不用人管)

设计中心两入口(人/AI 共用同一套后端 + 同一份 schema):

  • [+ 新建功能](人):自己在建模器 + 设计器里走五环。
  • [⚡ AI 建功能](AI ①面):触发外部 agent + 现有 skills/CLI 链(POST /api/ai/features/auto-develop),产 READY_FOR_HUMAN_REVIEW 草稿,人回设计器审/改/发。

3. 关键架构事实(brainstorm 核实,几条反直觉的)

  1. 元数据单一真相、新旧共用。 MetaController.createEntity 把实体行写进 SYS_ENTITY(:89,克隆 SYS_USERGROUP 的实体描述行做模板载体)、字段行写进 SYS_ENTITYATTRIBUTE(:246)。这两张表 + 引擎在 platform-legacy-core,包名 com.dsasp.server.common.dataDic.service——老系统保真层原物。eip3 老系统本身就是元数据驱动低代码平台;「转换」只动页面层(XML/engineclass → amis sys_page_schema),元数据一行没转。
  2. CREATE 建表后端已 live。 createEntity 走 createTableDdl() 拼真 DDL → dataDicService.executeCreateSql(ddl) 真执行(MetaController.java:130-131),补索引、失效缓存。AI agent 建新表就走这条。唯一缺口是 ALTER(改已有表)= M4。
  3. 平台主路径零 LLM。 AiFeatureRequest 完全结构化(featureName/tableName/entityName/List<AiFeatureField> fields/pageRecipe),连 auto-develop 吃的都是它,不是自然语言。AiFeatureDraftGenerator 按规则确定性编译。平台内唯一 LLM = HttpAiLlmRepairClient,@ConditionalOnProperty(...repair.enabled,"true") 默认关,且只做修复不做生成。 NL→结构化 spec 的魔法在平台外(外部 coding-agent 经 CLI)。
  4. NocoBase 的「建功能 AI」= 外部 agent CLI + Skills。 NocoBase Skills 官方定义 =「给 AI Agent CLI(Claude Code、Codex、Cursor 等)用的可复用领域知识包」,外部加载、非服务端组件,agent 经 CLI/API 在权限+审计下驱动 no-code 操作。EIP4 已有对应底座。NocoBase 另有 in-platform「AI Employees」(业务用户在 App 内对话,内置 LLM)= 我们的 ②面,v1 不做。
  5. recipe 编译器吃 blueprint 产已接 API 的页。 PageBlueprintCompiler.compile() 设 crud.api=/api/flow/{TABLE}_SEARCH、列、增删改按钮(:45-72);AiFeatureDraftGenerator 已串了这条(:47-52)。

4. 真正要新建 vs 复用(端点均已核实)

复用(端点/能力都已 live):

环 复用
建实体+建表 POST /api/meta/entity
标准层页写 PUT /api/page/schema/{templateId}/standard(M3a 单一真相)
设计器存改+门禁 /api/page/schema/{templateId}/overlay + /validate + /components
recipe 列表 GET /api/ai/page-recipes
菜单注册 POST /api/admin/menus/create
微调页面 DesignerPage(amis-editor)
AI 建功能链(①面) POST /api/ai/features/auto-develop(基址 /api/ai)
CRUD/flow 自动伺服 保真层引擎

真正要新建(4 件):

  1. 建模器 UI(前端,最大块):列已有实体 / 建新实体(名/表)+ 字段表(列/类型/显示名/长度/必填/引用其它实体)。包 POST /api/meta/entity。最复杂控件 = 引用列(referenceid,外键选其它实体)。
  2. 「recipe→默认页→落标准层」单步端点(后端,小):把 PageBlueprintCompiler.compile + /standard 写串成人可单步调的端点(现在只埋在 auto-develop 里)。属路线图「把 AI pipeline 拆成可单步调」收口的第一块。
  3. 「+ 新建功能」编排薄壳(前端):建模器→选 recipe→落页→跳设计器→发布(菜单注册)串起来。
  4. 「⚡ AI 建功能」入口接线(前端 + 少量后端):网页触发 auto-develop,把 READY_FOR_HUMAN_REVIEW 草稿回流到设计器供人审/改/发。

5. v1 边界(YAGNI)

  • 只建新,不改已有表(ALTER/M4 = v2)。
  • recipe 限现有 2 种(维护 CRUD / 树 CRUD)→ v1 只覆盖简单 CRUD/树类功能;主子表/审批/组合 = 路线图 M7 扩面后。
  • 设计器 edit-only 够用(recipe 预接好页)。
  • ②面 in-app AI employees 不做(平台内置 LLM = 独立大特性 + 红线扩面,v1 之后立项)。

6. 守红线(与架构 D3 + memory eip4-ai-agent-merge-mapping 一致)

  • 发布恒人审。
  • AI 入口产物状态恒 READY_FOR_HUMAN_REVIEW。
  • 标准层写恒走 PageSchemaWriter 单一真相(M3a 已收口,不得旁路裸 INSERT)。
  • 平台进程内不内置生成 LLM(仅 repair 钩子,默认关)。

7. 要在 plan 里钉死的 3 个未知

  1. 建模器引用列(外键)UI:怎么选其它实体?下拉已有实体列表 + 选目标显示列?这是建模器最复杂的控件,需先定交互。
  2. recipe 仅 2 种 = v1 能建的功能类型窄:这是 v1 定位,需跟产品对齐——v1 明确只支持简单 CRUD/树类新功能,复杂功能引导走老路或等 M7。
  3. 发布 online apply 断档(路线图:线上仍人工跑 SQL):v1「发布」到哪一步算完?真上线 vs 出部署包人工执行?决定 ④环的终点与是否需要 env/creds 终验。

8. 不做 / 推迟

  • ALTER/改已有表(M4,v2)
  • recipe 扩面:主子表/EditGrid/审批/组合 tabs(M7)
  • ②面 in-app AI employees / 平台内置 LLM 生成端点
  • 纯 NocoBase「空白页拖组件现绑实体」(需给 amis-editor 造绑定能力,v1 用 recipe 预接好规避)

本文为 brainstorm 定型设计。下一步:新会话跑 superpowers:writing-plans 出带文件路径/代码示例/验证步骤的实施计划,§7 三未知在 plan 阶段钉死。