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:
admin committed 2026-10-31 11:47:40 +08:00
1 parent 16c0704c47
commit f0c77f731c
24 files changed
+4122 -22

No files matched your search

+42 -1
View File
@@ -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. 失败返回长什么样(比成功更重要)