feat(mcp): schema.table.create 落地 + P2-b 冒烟闭环,修 data.query 泄漏口令列
- MCP:新增 schema.table.create(第 26 个业务工具)—— 库内功能按设计稿建表并回写 f_tables_data;内联 formData/tablesData 只能演练(INLINE_REQUIRES_DRY_RUN); 写且幂等(表已存在跳 DDL,列不同报 TABLE_EXISTS_DIFFERENT),默认 dryRun=true - mcp-smoke 32 → 48 条:先 --seed-lowcode-demo 造 receivableDemo,再用同一 PGLITE_DIR 起 --mcp,python 动态驱动(主键是服务端 UUID)跑通「默认演练不落库 → 真写 → 查证 → 子表差集三类 → 删除 → 建表演练/幂等」;M4 回复数改为按请求文件计算,不再写死 29 - lowcode-smoke 8 → 15 条:用内联演练钉建表规则(类型映射+dataLength / 复合主键 / 逻辑删除三列 / 系统列视图类型),外加两条反自证(不开逻辑删除就不加删除列; inline 不许落库) - fix:data.query 不再投影 f_password / f_secretkey(实测能拖走全库口令哈希); 缺省滤掉并返回 hiddenColumns,显式 columns/where/orderBy 要用 ⇒ SENSITIVE_COLUMN - docs:PLAN / CLAUDE / docs/mcp / docs/visualdev-mechanism 补 P2-b 结论; 业务工具数 21 → 26 由 tool_count_matches_doc 钉死;清 f_foreign_id 文档漂移 (子表外键列来自模型 tableField);补单租户口径的三条交叉证据(K8s 配置 / Java 常量 / 官方 DDL);记 UNIQUE_CONSTRAINT_VIOLATED / BUSINESS_KEY_VIOLATED
This commit is contained in:
1 parent
bcbe46c92b
commit
1d1a3b1ef9
13 files changed
+1104
-56
No files matched your search
+84
-4
@@ -80,7 +80,7 @@ sspf_context # 1. 先确认环境
|
||||
→ 失败则读 error.hints / next_actions 自纠
|
||||
```
|
||||
|
||||
### 当前业务工具(22 个)
|
||||
### 当前业务工具(26 个)
|
||||
|
||||
| 域 | 工具 | 一句话 | 写 |
|
||||
|---|---|---|---|
|
||||
@@ -88,6 +88,7 @@ sspf_context # 1. 先确认环境
|
||||
| schema | `schema.table.list` | 列出物理表 | |
|
||||
| schema | `schema.table.describe` | 看表的列与类型 | |
|
||||
| schema | `schema.index.list` | 索引与唯一约束 | |
|
||||
| schema | `schema.table.create` | 按低代码设计稿建表 + 回写模型 | ✅ |
|
||||
| menu | `menu.tree` | 菜单树(按应用隔离) | |
|
||||
| menu | `menu.create` | 建菜单(写全 enCode + systemId) | ✅ |
|
||||
| menu | `menu.delete` | 软删菜单 | ✅ |
|
||||
@@ -103,6 +104,9 @@ sspf_context # 1. 先确认环境
|
||||
| dict | `dict.type.create` | 建字典分类 | ✅ |
|
||||
| data | `data.query` | 按表名查数据(结构化条件) | |
|
||||
| data | `data.count` | 按表名计数 | |
|
||||
| data | `data.record.insert` | 按设计稿新增记录(主表 + 子表) | ✅ |
|
||||
| data | `data.record.update` | 按设计稿更新(子表差集对账) | ✅ |
|
||||
| data | `data.record.delete` | 删记录(逻辑/物理按功能设置) | ✅ |
|
||||
| form | `form.list` | 列低代码功能(`base_visual_dev`) | |
|
||||
| form | `form.describe` | 解析表单:主表字段/子表/控件类型 | |
|
||||
| form | `form.validate` | 校验表单声明的字段在表里是否真有列 | |
|
||||
@@ -111,6 +115,11 @@ sspf_context # 1. 先确认环境
|
||||
所以写工具都在写库**之前**做完校验(必填/格式/父节点存在/编码唯一),
|
||||
并给出可执行的 `hints`;删除一律软删。
|
||||
|
||||
🔴 **`data.query` 不投影口令 / 密钥列**(`f_password` / `f_secretkey`):
|
||||
缺省投影会跳过它们并在结果里返回 `hiddenColumns`(藏了几列);
|
||||
显式在 `columns` / `where` / `orderBy` 里要它们 ⇒ `SENSITIVE_COLUMN`。
|
||||
要用户信息请用 `permission.user.list`(它本来就不返回口令字段)。
|
||||
|
||||
🔴 **`menu.create` 比 HTTP 侧的 `module_save` 更完整**:后者只写 12 列,缺
|
||||
`f_en_code`(面 B 权限判据)与 `f_system_id`(多应用隔离)——那两列缺了,
|
||||
菜单要么点进去 403,要么根本不显示。P2 元数据引擎统一时会把两处合成一处。
|
||||
@@ -181,7 +190,73 @@ jnpf 建表时原样写 vModel,PG/Kingsbase 再 `toLowerCase()`。
|
||||
|
||||
**`form.validate` 只保证「设计稿自洽」,不等于「表已经建好了」**:
|
||||
它比对表单推导的列与模型 `field` 推导的列(两边同一套规则,所以能验出「表单引用了模型里没有的字段」)。
|
||||
但库里到底有没有这张表、列够不够,要拿 `information_schema` 比 —— P2-b 补。
|
||||
但库里到底有没有这张表、列够不够,要拿 `information_schema` 比 ——
|
||||
这一步由 P2-b 的写工具在**落库前**做(对不上报 `COLUMN_MISMATCH` / `TABLE_NOT_IN_DB`,拒绝写)。
|
||||
|
||||
### 低代码动态 CRUD(P2-b)
|
||||
|
||||
```
|
||||
schema.table.create(dryRun) 先看要建的 DDL 与回写后的模型
|
||||
→ schema.table.create 建表 + 回写 f_tables_data(幂等)
|
||||
→ data.record.insert(dryRun) 看 SQL 与参数
|
||||
→ data.record.insert 落库
|
||||
→ data.query 查证
|
||||
→ data.record.update 改主表字段 / 子表差集对账
|
||||
→ data.record.delete 删(逻辑或物理,按功能的 logicalDelete)
|
||||
```
|
||||
|
||||
**建表不是可选项**:低代码功能的表不会自己出现。`data.record.*` 直接写一张不存在的表
|
||||
会报 `TABLE_NOT_IN_DB` —— 这时先 `schema.table.create`。
|
||||
|
||||
🔴 **建表后必须回写 `f_tables_data`**(工具内部做,`dryRun=false` 时)。
|
||||
不回写的后果不是「少一列」这么轻:CRUD 层在**模型**里找 `f_delete_mark`,
|
||||
找不到就报 `LOGICAL_DELETE_UNSUPPORTED`;而且「设计稿 vs 真实库」的列比对永远对不上。
|
||||
基线平台 `VisualDevTableCre.tableList()` 建完表也是把装配后的 `TableModel` 写回 `f_tables_data`。
|
||||
|
||||
`schema.table.create` 支持两种输入:
|
||||
|
||||
| 模式 | 入参 | 能落库吗 |
|
||||
|---|---|---|
|
||||
| 查库 | `id` / `enCode` | ✅ `dryRun=false` 建表 + 回写 |
|
||||
| inline | `formData` + `tablesData` | ❌ 只能演练(`INLINE_REQUIRES_DRY_RUN`)—— 没有可回写的功能记录 |
|
||||
|
||||
**子表更新是差集对账,不是整条替换**(与主表的部分更新语义不同):
|
||||
|
||||
| 情况 | 动作 |
|
||||
|---|---|
|
||||
| 入参行的主键在库里 | `updateSub` |
|
||||
| 入参行的主键不在库里 | `insertSub` |
|
||||
| 库里有、入参没有 | 删除(`logicalDelete` 开则 `softDelete`,否则 `hardDelete`) |
|
||||
|
||||
🔴 因此「只改子表一行的某个字段」也必须把**这张子表的所有行**都传进来,
|
||||
否则没传的旧行会被删掉。只想追加不改动,就先把现有行查出来一起传。
|
||||
|
||||
**三道落库前校验**(都对齐基线平台,失败时一条 SQL 都不执行):
|
||||
|
||||
| 校验 | 触发条件 | 错误码 |
|
||||
|---|---|---|
|
||||
| 单行唯一 | 控件 `unique=true` 且是普通输入 | `UNIQUE_CONSTRAINT_VIOLATED` |
|
||||
| 业务主键组合唯一 | 表单 `useBusinessKey=true` | `BUSINESS_KEY_VIOLATED` |
|
||||
| 必填 | 控件 `required=true` | `MISSING_REQUIRED` |
|
||||
|
||||
查重只算**未删除**的行(`f_delete_mark=0` 或该列不存在);更新时排除自己。
|
||||
|
||||
**写工具默认 `dryRun=true`**(不传就是演练)。dry-run 会返回完整 SQL 与参数 ——
|
||||
这是刻意的:AI 要先能看清「到底写什么」,才谈得上让人放心让它写。
|
||||
返回值里不含任何口令字段(适配器层就不投影这类列);业务数据本身**不做脱敏** ——
|
||||
dry-run 的意义就是让人核对真实值,遮掉反而看不出写错在哪。
|
||||
|
||||
### 造一份示例功能:`--seed-lowcode-demo`
|
||||
|
||||
```bash
|
||||
PGLITE_DIR=/tmp/sspf-demo ./target/debug/ssw-platform --seed-lowcode-demo # 建表 + 写功能定义
|
||||
PGLITE_DIR=/tmp/sspf-demo ./target/debug/ssw-platform --seed-lowcode-demo --dry-run # 只看不碰库(连库都不开)
|
||||
```
|
||||
|
||||
- 固定 `id=lowcode-demo-receivable` + `enCode=receivableDemo` ⇒ **幂等**(重复跑是更新同一条)
|
||||
- 数据来源是**官方 fixture**(基线初始化数据里的「应收费用」)⇒ 种出来的库就是真实低代码功能的样子
|
||||
- 只在 dev 档可用:`SSW_PROFILE=prod|production` 在**开库前**就拒绝(它会建表)
|
||||
- 种完可以立刻 `data.record.insert {"enCode":"receivableDemo",...}` 端到端试写
|
||||
|
||||
---
|
||||
|
||||
@@ -278,12 +353,17 @@ cargo run -p sspf-adapter-baseline --example probe -- \
|
||||
|
||||
---
|
||||
|
||||
## 5. 已知限制(P1 阶段)
|
||||
## 5. 已知限制(P2-b 收尾时点)
|
||||
|
||||
| 限制 | 说明 | 计划 |
|
||||
|---|---|---|
|
||||
| 没有登录态 | 进程内适配器是**管理员视角**,绕过菜单守卫 | 刻意如此(本地开发);对外暴露必须换 `BaselineHttpAdapter` |
|
||||
| 业务工具 19 个 | 见上面清单;form / model / workflow 还没有 | P2 补 |
|
||||
| 业务工具 26 个 | 见上面清单;model / workflow / release 域还没有 | P3 补 |
|
||||
| 读的是 `base_visual_dev`,不是 release | 只读工具与动态 CRUD 都取草稿表;发布快照 `base_visual_release` 只有种子在写 | 运行时读 release 待补(P2-c) |
|
||||
| 单据号生成器未做 | `billRule` 控件不接收入参,但**也不会自动生成**(需序号表);入参给了 `billRule` 字段会被忽略 | 序号表 + 规则引擎(P2-c) |
|
||||
| 没有乐观锁 | `concurrencyLock=true` 时插入会写 `f_version=0`,但更新**不校验**版本 | 真并发控制(P3) |
|
||||
| 建表只建不改 | 表已存在且列不同 ⇒ `TABLE_EXISTS_DIFFERENT`,不自动 ALTER | 刻意:自动迁移比报错危险 |
|
||||
| `schema.table.create` 只在 dev 档建表 | 生产档拒绝(会改库结构) | 刻意 |
|
||||
| 基线适配器只支持 5 个只读 op | baseline 无元数据 API | P4 按对账需要再补 |
|
||||
| 基线适配器只支持 `http://` | 未引入 TLS 栈;`https://` 构造期直接报错 | 需要时再加 |
|
||||
| `permission.user.create` 不开放建管理员 | `isAdministrator` 硬编码 false | 刻意:避免 AI 顺手造超管 |
|
||||
|
||||
+86
-13
@@ -2,7 +2,8 @@
|
||||
|
||||
> **这份文件解决什么问题**:`PLAN.md` 第 4 条要求「以 jnpf 源码迁移,数据库脚本一致,
|
||||
> API 调用/行为一致」。要做到「行为一致」,必须先知道**原平台到底怎么跑**。
|
||||
> 本文件是从 Java 源码逐条读出来的机制,是 P2-b(动态 CRUD)的实施依据。
|
||||
> 本文件是从 Java 源码逐条读出来的机制。P2-a/P2-b 已按它落地(`sspf-lowcode` + `data.record.*`),
|
||||
> §9 是「机制 ↔ 实现」的对照表;后续阶段(读 release / 单据号 / 乐观锁)仍以本文为准。
|
||||
>
|
||||
> **每条结论都标了源码位置**,改代码前先回来核对,别凭印象。
|
||||
|
||||
@@ -156,7 +157,9 @@ if (logicalDelete) {
|
||||
}
|
||||
```
|
||||
|
||||
子表额外多一个外键列 `f_foreign_id`(指向主表主键)。
|
||||
子表额外多一个**外键列**,列名来自模型的 `tableField` —— 实测 `test_details` 是
|
||||
`f_receivableid`(不是常量 `f_foreign_id`)。`f_foreign_id` 是早期猜测,已在
|
||||
`sspf-lowcode/src/sql.rs` 与建表模块里按真实数据纠正。
|
||||
|
||||
字段名常量见 `$SRC/jnpf-common/jnpf-boot-common/jnpf-common-core/src/main/java/jnpf/constant/TableFieldsNameConst.java`。
|
||||
|
||||
@@ -171,6 +174,36 @@ if (logicalDelete) {
|
||||
|
||||
⇒ 看到 `f_creator_time` 样式不要以为规律统一了 —— 那多半是控件叫 `F_Creator_Time`。
|
||||
|
||||
### 🔴 生成 DDL 的口径:**模型驱动**(Java 是表单驱动)
|
||||
|
||||
| | jnpf `VisualDevTableCre` | 本仓 `sspf-lowcode::ddl` |
|
||||
|---|---|---|
|
||||
| 列来源 | **表单控件**(`FieLdsModel`)+ 追加系统列 | **模型 `f_tables_data`** + 补齐缺失的系统列 |
|
||||
| 列序 | 控件顺序 + 系统列在后 | 模型顺序(= 官方回写后的真实列序) |
|
||||
| 类型/长度 | 按控件类型与 `dataType` 配置推 | 按模型 `dataType` / `dataLength` 直接映射 |
|
||||
| 适用场景 | 第一次建表(只有设计稿) | 设计稿已含模型(官方数据的常态) |
|
||||
|
||||
为什么可以不照抄表单驱动:库里真实的 `f_tables_data` 本来就是**建表之后回写**的产物
|
||||
(`entity.setVisualTables(...)`),列序与官方 DDL 逐列一致 —— 再拿表单控件反推一遍
|
||||
只会多一层「控件类型 ↔ DDL 类型」的多对一映射,反而容易错。
|
||||
前置条件是 **模型与表单自洽**,这由 `form.validate` 负责(列集合对不上会报 `COLUMN_NOT_IN_TABLE`)。
|
||||
|
||||
### 🔴 DEFAULT 差异:动态建表 vs 官方手写 SQL
|
||||
|
||||
| 列 | Java 动态建表 | 官方手写 `jnpf_db_init.sql` |
|
||||
|---|---|---|
|
||||
| `f_tenant_id` | `VARCHAR(50) DEFAULT '0' NOT NULL` | 同(有 DEFAULT) |
|
||||
| `f_version` | `INTEGER DEFAULT '0'` | `INTEGER`(**没有** DEFAULT) |
|
||||
| `f_flow_state` | `INTEGER DEFAULT '0'` | `INTEGER`(**没有** DEFAULT) |
|
||||
|
||||
原因:`ConcurrencyUtils.getDbFieldModel()` 对 TENANTID / FLOWSTATE / VERSION 设了
|
||||
`defaultValue="0"`,`FormatSql.defaultCheck()` **所有类型都加引号** ⇒ 输出 `DEFAULT '0'`。
|
||||
官方初始化脚本是**手写**的,不是这条链路的产物,所以没有 DEFAULT。
|
||||
|
||||
⇒ 本仓生成的是「Java 动态建表」的结果(带 DEFAULT)。语义等价(PG 里
|
||||
`INTEGER DEFAULT '0'` 合法,字符串常量会转成目标类型),但**逐字对比官方脚本时会看到差异** ——
|
||||
这不是 bug,是两条不同来源的 DDL。
|
||||
|
||||
---
|
||||
|
||||
## 5. 主键与流程字段
|
||||
@@ -214,6 +247,24 @@ GeneralInsertDSL dsl = insertInto(sqlTable)
|
||||
把它当只读会导致「计算字段永远存不进去」。
|
||||
2. **被覆盖的字段不能标 `acceptsInput`** —— 否则调用方以为传了有用,实际被丢弃。
|
||||
|
||||
### 🔴 子表 `modifyTime` / `modifyUser` 策略(已定,刻意与 Java 有一处差异)
|
||||
|
||||
**口径:自动填充跟随表单控件** —— 表单里有 `modifyTime` / `modifyUser` 控件才写,
|
||||
没有这个控件就不写(列可以存在,但没人填)。
|
||||
|
||||
| 场景 | Java | 本仓 |
|
||||
|---|---|---|
|
||||
| 新增(主表 / 子表) | 置 `null` | 置 `null`(一致) |
|
||||
| 更新(主表 / 子表已有行) | 写当前时间 / 当前用户 | 写当前时间 / 当前用户(一致) |
|
||||
| **更新时新增的子表行** | `childNeedAdd=true` ⇒ **跳过**填充,保留入参值 | 按「新增」语义置 `null` |
|
||||
|
||||
最后一处是**刻意**的:让调用方能给新子行伪造 `modifyUser` / `modifyTime` 没有好处,
|
||||
而「新行没有修改人」在审计上自洽。差异只落在审计列,不碰业务列 ——
|
||||
P4 影子对账时按「忽略审计列」处理即可。
|
||||
|
||||
> 代码落点:`crates/sspf-lowcode/src/sql.rs::sub_row_columns`(`is_update` 分支)
|
||||
> 测试钉死:`update_writes_modify_time_and_modify_user` / `insert_nulls_modify_time_and_modify_user`
|
||||
|
||||
> 代码落点:`crates/sspf-lowcode/src/widget.rs::auto_fill` / `AutoFill`
|
||||
> 测试钉死:`auto_fill_matches_jnpf_create_switch` / `overridden_fields_do_not_accept_input`
|
||||
|
||||
@@ -224,7 +275,7 @@ GeneralInsertDSL dsl = insertInto(sqlTable)
|
||||
`createTable()` 与 `createMast()` 的差别:
|
||||
|
||||
- 子表数据来自**父节点**的 `__config__.children`,写到 `__config__.tableName` 指定的表
|
||||
- 每行由服务端生成自己的 `f_id`,并把 **`f_foreign_id` = 主表 id**
|
||||
- 每行由服务端生成自己的 `f_id`,外键列(模型 `tableField`,如 `f_receivableid`)= 主表 id
|
||||
- 🔴 子表内字段**自身的 `tableName` 不可信**:实测指向的是主表
|
||||
|
||||
> 代码落点:`crates/sspf-lowcode/src/form.rs::sub_tables`(只看父节点)
|
||||
@@ -248,26 +299,48 @@ GeneralInsertDSL dsl = insertInto(sqlTable)
|
||||
| 机制 | 状态 | 落点 |
|
||||
|---|---|---|
|
||||
| 列名 = `lower(vModel)` | ✅ 已对齐 | `form::v_model_to_column` |
|
||||
| 系统字段清单 | ✅ 已记录 | 本文件 §4 |
|
||||
| 系统字段清单 | ✅ 已对齐 | 本文件 §4 / `ddl::SystemColumn` |
|
||||
| 自动填充表 | ✅ 已对齐 | `widget::auto_fill` |
|
||||
| 控件分类(54 种) | ✅ 已覆盖实测 top 12 | `widget::classify` |
|
||||
| 子表归属看父节点 | ✅ 已对齐 | `form::sub_tables` |
|
||||
| 读 release 而非 dev | 🟡 只读工具读的是 **dev** | P2-b 要补 release 读取 |
|
||||
| 动态 CRUD(写数据) | ❌ 未做 | P2-b |
|
||||
| `f_flow_task_id` = 主键 | ❌ 未做 | P2-b |
|
||||
| 单据号生成器 | ❌ 未做 | P2-b(需序号表) |
|
||||
| 并发锁 `f_version` | ❌ 未做 | P2-b |
|
||||
| 逻辑删除 | ❌ 未做 | P2-b |
|
||||
| 建表 DDL(类型映射/复合主键/系统列) | ✅ 已对齐 | `ddl::plan_create` + `rewrite_model` |
|
||||
| 建表后回写 `f_tables_data` | ✅ 已对齐 | `lowcode_ddl::create_and_sync` |
|
||||
| 动态 CRUD(写数据) | ✅ 已对齐 | `lowcode_crud` + `data.record.*` |
|
||||
| `f_flow_task_id` = 主键 | ✅ 已对齐 | `sql::main_guard.flow_task_id` |
|
||||
| 逻辑删除 | ✅ 已对齐(`f_delete_mark` 是 INTEGER) | `sql::soft_delete_row` |
|
||||
| 读 release 而非 dev | 🟡 只读工具读的是 **dev** | 运行时读 release 待补(P2-c) |
|
||||
| 单据号生成器 | ❌ 未做(需序号表);`billRule` 入参不被覆盖已实现 | P2-c |
|
||||
| 并发锁 `f_version` | 🟡 只写初值 0,**不校验**版本 | 真乐观锁待补(P3) |
|
||||
|
||||
---
|
||||
|
||||
## 10. 复核方法
|
||||
## 10. 单租户口径的交叉证据
|
||||
|
||||
「`f_tenant_id` 固定 `'0'`」不是约定俗成,有三条独立证据:
|
||||
|
||||
| 证据 | 内容 |
|
||||
|---|---|
|
||||
| 部署配置 | `jnpf-k8s/k8s/20-admin.yaml` 的 `config.MultiTenancy: false`(2026-10-31 起)⇒ admin 只查 `j7` 库的 `public` schema;登录账号**不带**租户号;`jnpf-tenant` 服务仍在跑但已成孤儿 |
|
||||
| Java 代码链 | `FlowFormDataUtil.addTenantId()` → `TenantDataSourceUtil.getTenantColumn()` → 多租户关闭时返回 `GlobalConst.DEFAULT_TENANT_VALUE`,其值就是 `"0"` |
|
||||
| 官方手写 DDL | `test_receivable`:`f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL` + `PRIMARY KEY (f_id, f_tenant_id)` |
|
||||
|
||||
⇒ 单租户下 `f_tenant_id` **恒为 `"0"`**,且这一列 `NOT NULL` 并参与复合主键 ——
|
||||
即使只有一个租户也不能省略。本仓 `DEFAULT_TENANT_ID = "0"`、建表生成
|
||||
`f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL`,与上表逐字对得上。
|
||||
|
||||
⚠️ **未做的人工核对**:JNPF 完整部署(`http://192.168.1.26:30093/`)里动态表的
|
||||
`f_tenant_id` 实际分布没抽查 —— 需要登录凭据(本次自动运行未提供,按约定不入档)。
|
||||
要核:`SELECT f_tenant_id, count(*) FROM test_receivable GROUP BY 1`,或多建几条记录看是否为 `0`。
|
||||
|
||||
---
|
||||
|
||||
## 11. 复核方法
|
||||
|
||||
改任何与「列名 / 系统字段 / 自动填充」相关的代码前,重跑这几条:
|
||||
|
||||
```bash
|
||||
cargo test -p sspf-lowcode # 40 条,含列名与自动填充的对齐断言
|
||||
bash scripts/lowcode-smoke.sh # 8 条,含反自证
|
||||
cargo test -p sspf-lowcode # 112 条,含列名 / 自动填充 / 建表 DDL 的对齐断言
|
||||
bash scripts/lowcode-smoke.sh # 15 条,含 4 条反自证(L6/L7/L13/L14)
|
||||
```
|
||||
|
||||
源码复核入口(按重要性):
|
||||
|
||||
Reference in new issue
Block a user