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>
This commit is contained in:
99
docs/plans/2026-06-20-人走五环建新功能-NocoBase式-design.md
Normal file
99
docs/plans/2026-06-20-人走五环建新功能-NocoBase式-design.md
Normal file
@@ -0,0 +1,99 @@
|
|||||||
|
# 人走五环建新功能 · 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 阶段钉死。*
|
||||||
Reference in New Issue
Block a user