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>
8.9 KiB
8.9 KiB
人走五环建新功能 · 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. 整体形态 + 建功能流程
两个界面(落在设计中心):
- 建模器(新建的唯一无对应 UI 的环)— 建/浏览实体 + 字段,包
POST /api/meta/entity。 - 实时设计器(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 核实,几条反直觉的)
- 元数据单一真相、新旧共用。
MetaController.createEntity把实体行写进SYS_ENTITY(:89,克隆 SYS_USERGROUP 的实体描述行做模板载体)、字段行写进SYS_ENTITYATTRIBUTE(:246)。这两张表 + 引擎在platform-legacy-core,包名com.dsasp.server.common.dataDic.service——老系统保真层原物。eip3 老系统本身就是元数据驱动低代码平台;「转换」只动页面层(XML/engineclass → amissys_page_schema),元数据一行没转。 - CREATE 建表后端已 live。
createEntity走createTableDdl()拼真 DDL →dataDicService.executeCreateSql(ddl)真执行(MetaController.java:130-131),补索引、失效缓存。AI agent 建新表就走这条。唯一缺口是 ALTER(改已有表)= M4。 - 平台主路径零 LLM。
AiFeatureRequest完全结构化(featureName/tableName/entityName/List<AiFeatureField> fields/pageRecipe),连auto-develop吃的都是它,不是自然语言。AiFeatureDraftGenerator按规则确定性编译。平台内唯一 LLM =HttpAiLlmRepairClient,@ConditionalOnProperty(...repair.enabled,"true")默认关,且只做修复不做生成。 NL→结构化 spec 的魔法在平台外(外部 coding-agent 经 CLI)。 - 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 不做。
- 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 件):
- 建模器 UI(前端,最大块):列已有实体 / 建新实体(名/表)+ 字段表(列/类型/显示名/长度/必填/引用其它实体)。包
POST /api/meta/entity。最复杂控件 = 引用列(referenceid,外键选其它实体)。 - 「recipe→默认页→落标准层」单步端点(后端,小):把
PageBlueprintCompiler.compile+/standard写串成人可单步调的端点(现在只埋在auto-develop里)。属路线图「把 AI pipeline 拆成可单步调」收口的第一块。 - 「+ 新建功能」编排薄壳(前端):建模器→选 recipe→落页→跳设计器→发布(菜单注册)串起来。
- 「⚡ 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 个未知
- 建模器引用列(外键)UI:怎么选其它实体?下拉已有实体列表 + 选目标显示列?这是建模器最复杂的控件,需先定交互。
- recipe 仅 2 种 = v1 能建的功能类型窄:这是 v1 定位,需跟产品对齐——v1 明确只支持简单 CRUD/树类新功能,复杂功能引导走老路或等 M7。
- 发布 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 阶段钉死。