feat(lowcode): 低代码元数据引擎第一波 —— 解析 + 校验 + 3 个只读工具
- 新 crate sspf-lowcode(纯计算,AR7 钉住不依赖 DB/HTTP):widget 把 54 种 jnpfKey 归成 11 类 (决定「怎么存、能不能接收入参」)/ form 解析控件树 / model 解析表结构 / validate 9 类诊断码 - DDL:base_visual_dev + base_visual_release 逐字对齐官方(21 → 23 张表) - MCP 3 个只读工具:form.list / form.describe / form.validate,后两个支持 inline JSON - 真实样例落盘为 fixture(官方初始化数据的「应收费用」:主表 6 字段 / 子表 8 字段) - 新增 lowcode-smoke.sh 8 条(含两条反自证:改坏 __vModel__ 必被抓、未知控件只 warn) - 影响:测试 306 → 344;十二闸全绿;三条真实方言已写进注释与测试
This commit is contained in:
1 parent
16c0704c47
commit
f0c77f731c
24 files changed
+4122
-22
No files matched your search
+42
-1
@@ -80,7 +80,7 @@ sspf_context # 1. 先确认环境
|
||||
→ 失败则读 error.hints / next_actions 自纠
|
||||
```
|
||||
|
||||
### 当前业务工具(19 个)
|
||||
### 当前业务工具(22 个)
|
||||
|
||||
| 域 | 工具 | 一句话 | 写 |
|
||||
|---|---|---|---|
|
||||
@@ -103,6 +103,9 @@ sspf_context # 1. 先确认环境
|
||||
| dict | `dict.type.create` | 建字典分类 | ✅ |
|
||||
| data | `data.query` | 按表名查数据(结构化条件) | |
|
||||
| data | `data.count` | 按表名计数 | |
|
||||
| form | `form.list` | 列低代码功能(`base_visual_dev`) | |
|
||||
| form | `form.describe` | 解析表单:主表字段/子表/控件类型 | |
|
||||
| form | `form.validate` | 校验表单声明的字段在表里是否真有列 | |
|
||||
|
||||
**写工具为什么少而严**:读工具错了只是「看到错的数据」,写工具错了是「把库改坏」。
|
||||
所以写工具都在写库**之前**做完校验(必填/格式/父节点存在/编码唯一),
|
||||
@@ -135,6 +138,44 @@ menu.create 建菜单
|
||||
|
||||
两者不一致 ⇒ 授权指向了别的应用的菜单(或菜单已删)。
|
||||
|
||||
### 低代码:看懂一张表单,先于写它
|
||||
|
||||
```
|
||||
form.list 有哪些功能(type/state)
|
||||
→ form.describe 主表字段 / 子表 / 每个控件的存储类别
|
||||
→ form.validate 表单声明的字段 ↔ 表结构对不对得上
|
||||
```
|
||||
|
||||
`form.describe` 和 `form.validate` 支持**两种输入**:
|
||||
|
||||
| 模式 | 入参 | 用在哪 |
|
||||
|---|---|---|
|
||||
| 查库 | `id` 或 `enCode` | 功能已经在 `base_visual_dev` 里 |
|
||||
| **inline** | `formData`(+ `tablesData`) | 草稿还没入库,先校验再说 |
|
||||
|
||||
inline 模式是刻意的:AI 生成一份表单 JSON 后**先校验、后落库**,比写完再报错成本低得多。
|
||||
|
||||
**控件分类决定数据怎么存**(`sspf-lowcode/src/widget.rs`,54 种 jnpfKey → 11 类):
|
||||
|
||||
| 类别 | 举例 | 接收入参 |
|
||||
|---|---|---|
|
||||
| text / number / dateTime / enum | `input` `inputNumber` `datePicker` `select` | ✅ |
|
||||
| entityRef | `userSelect` `organizeSelect` | ✅(存 id) |
|
||||
| attachment | `uploadFile` | ✅(URL 列表 JSON) |
|
||||
| **systemGenerated** | `billRule` `createUser` `createTime` | ❌ 后端填 |
|
||||
| **layout** | `groupTitle` `divider` | ❌ 不占列 |
|
||||
| **subTable** | `table` | ❌ 数据在独立表 |
|
||||
|
||||
🔴 让入参覆盖 `billRule`(单据号)或 `createUser`,会破坏业务编号规则与审计链路 ——
|
||||
这是「数据被写坏」最常见的来源,所以 `acceptsInput` 在 `describe` 里显式返回。
|
||||
|
||||
**`form.validate` 只保证「设计稿自洽」,不等于「能直接跑 SQL」**:
|
||||
|
||||
它比对的是「表单 `__vModel__` 推导的列」与「模型 `field` 推导的列」,两边同一套推导。
|
||||
但官方数据里 `columnName` 全是 null,推导必然有偏差
|
||||
(`F_CreatorTime` → `f_creatortime`,真实列是 `f_creator_time`)。
|
||||
与真实数据库列的一致性要拿 `information_schema` 比 —— P2-b 补。
|
||||
|
||||
---
|
||||
|
||||
## 3. 失败返回长什么样(比成功更重要)
|
||||
|
||||
Reference in new issue
Block a user