feat(lowcode): P2-b 动态 CRUD 内核 + 写工具 + seed 通道,修 pglite /dev/null 退出码 100

- sspf-lowcode 纯计算建表 DDL 生成 + 模型回写(任务 #12/#13)
- 内核 lowcode_crud/check/ddl:真实事务执行、落库前三重校验、动态建表后回写 f_tables_data
- MCP 暴露 data.record.insert/update/delete(任务 #15)
- 开发期 --seed-lowcode-demo 通道:建表 + 写 dev/release 快照,prod 档开库前闸门拒绝
- 修 f_delete_mark 类型 bug(INTEGER 列误写 bool 导致 PG 报错)
- 修 pglite 0.2.7 在 stdout=/dev/null 时 boot 阶段 kevent 失败 -> exit(100) 残留 pid:
  open_db 开库前若 fd1 是字符设备,dup2 到匿名普通临时文件
- 文档漂移清理(tools/mod.rs 工具数、form.rs/model.rs 注释)
This commit is contained in:
admin committed 2026-10-31 19:26:47 +08:00
1 parent 343772be42
commit bcbe46c92b
23 files changed
+11185 -26

No files matched your search

File diff suppressed because it is too large. Load diff
+115
View File
@@ -103,8 +103,31 @@ pub struct FieldNode {
pub layout: String,
/// 该控件所属物理表(`__config__.tableName`)。
pub table_name: Option<String>,
/// 该控件关联的物理表(`__config__.relationTable`)。
///
/// 🔴 **只对子表里的字段有意义**:实测子表字段的 `tableName` 指向**主表**
/// (方言陷阱),但 `relationTable` 指向**子表自己** —— 它是「这个字段属于
/// 哪张表」唯一可信的线索。没有它,动态 CRUD 只能靠「取第一个非主表」来猜,
/// 多子表时会把数据串到错的表里。
pub relation_table: Option<String>,
/// 是否必填。
pub required: bool,
/// 🔴 是否**单行唯一**(`__config__.unique`)。
///
/// 基线平台 `ConfigModel`:
/// ```java
/// //是否唯一
/// private Boolean unique = false;
/// ```
///
/// 基线平台 `FormCheckUtils.checkForm()` 里,**只有 `jnpfKey == "input"`**
/// 且 `unique == true` 的字段才参与唯一性校验:
/// ```java
/// if (JnpfKeyConsts.COM_INPUT.equals(config.getJnpfKey())
/// && Boolean.TRUE.equals(config.getUnique())) { ... }
/// ```
/// ⇒ 这里保留 `jnpf_key` 一起判断,别把「唯一」当成通用能力。
pub unique: bool,
/// 可见端:`["pc"]` / `["pc","app"]`。
pub visibility: Vec<String>,
/// 是否隐藏(`noShow`)。
@@ -200,6 +223,23 @@ pub struct FormSchema {
pub concurrency_lock: Option<bool>,
/// 是否逻辑删除(`logicalDelete`)。
pub logical_delete: Option<bool>,
/// 🔴 是否启用**业务主键**(`useBusinessKey`)。
///
/// 基线平台 `FormDataModel`:
/// ```java
/// //业务主键属性
/// private boolean useBusinessKey;
/// private String[] businessKeyList;
/// private String businessKeyTip;
/// ```
pub use_business_key: bool,
/// 🔴 业务主键字段清单(`businessKeyList`,存的是 `__vModel__`)。
///
/// 语义:这几个字段的**组合**在表里必须唯一(基线平台
/// `FormCheckUtils.checkBusinessKey()`)。全为空 ⇒ 不校验。
pub business_key_list: Vec<String>,
/// 业务主键重复时的提示语(`businessKeyTip`)。
pub business_key_tip: Option<String>,
/// 顶层控件树。
pub fields: Vec<FieldNode>,
}
@@ -228,6 +268,21 @@ impl FormSchema {
primary_key_policy: obj.get("primaryKeyPolicy").and_then(Value::as_i64),
concurrency_lock: obj.get("concurrencyLock").and_then(Value::as_bool),
logical_delete: obj.get("logicalDelete").and_then(Value::as_bool),
use_business_key: obj.get("useBusinessKey").and_then(Value::as_bool).unwrap_or(false),
business_key_list: obj
.get("businessKeyList")
.and_then(Value::as_array)
.map(|a| {
a.iter()
.filter_map(Value::as_str)
.map(str::to_string)
.collect()
})
.unwrap_or_default(),
business_key_tip: obj
.get("businessKeyTip")
.and_then(Value::as_str)
.map(str::to_string),
fields,
})
}
@@ -270,6 +325,61 @@ impl FormSchema {
.collect()
}
/// 🔴 参与**单行唯一性**校验的字段。
///
/// 基线平台 `FormCheckUtils.checkForm()` 的条件是**两个都要满足**:
/// ```java
/// if (JnpfKeyConsts.COM_INPUT.equals(config.getJnpfKey())
/// && Boolean.TRUE.equals(config.getUnique())) { ... }
/// ```
/// - `JnpfKeyConsts.COM_INPUT` = `"input"`(普通单行输入框);
/// - `config.getUnique()` = `true`。
///
/// ⇒ **不是**「所有标了 unique 的字段」,而是「标了 unique **且**是 input 的字段」。
/// 下拉/日期/数字等控件即使标了 unique,基线平台**也不查** ——
/// 照抄这个口径,别查多了(查多了会拦住基线平台允许的写入)。
pub fn unique_fields(&self) -> Vec<&FieldNode> {
self.all_nodes()
.into_iter()
.filter(|n| n.unique && n.jnpf_key == "input" && !n.v_model.is_empty())
.collect()
}
/// 🔴 业务主键字段(`useBusinessKey` 开启时的 `businessKeyList`)。
///
/// 基线平台 `FormCheckUtils.checkBusinessKey()`:
/// ```java
/// if (formData.isUseBusinessKey()) {
/// List<String> businessKeyList = Arrays.asList(formData.getBusinessKeyList());
/// if (CollectionUtils.isEmpty(businessKeyList)) { return null; }
/// ...
/// for (String fieldName : businessKeyList) { setEachCondition(...); }
/// }
/// ```
/// ⇒ 清单里存的是 `__vModel__`;**空值字段用 `IS NULL` 参与比较**。
/// 返回 `None` 表示「不校验业务主键」。
pub fn business_key_fields(&self) -> Option<Vec<&FieldNode>> {
if !self.use_business_key || self.business_key_list.is_empty() {
return None;
}
let mut out = Vec::new();
for vm in &self.business_key_list {
if let Some(node) = self
.all_nodes()
.into_iter()
.find(|n| &n.v_model == vm && !n.is_container())
{
out.push(node);
}
}
// 清单里的字段一个都找不到 ⇒ 没法校验(不静默跳过)
if out.is_empty() {
None
} else {
Some(out)
}
}
/// 主表字段对应的物理列名(去重、保序)。
pub fn main_columns(&self) -> Vec<String> {
let mut out: Vec<String> = Vec::new();
@@ -399,7 +509,12 @@ fn parse_node(v: &Value) -> Option<FieldNode> {
widget,
layout,
table_name: cfg.get("tableName").and_then(Value::as_str).map(str::to_string),
relation_table: cfg
.get("relationTable")
.and_then(Value::as_str)
.map(str::to_string),
required: cfg.get("required").and_then(Value::as_bool).unwrap_or(false),
unique: cfg.get("unique").and_then(Value::as_bool).unwrap_or(false),
visibility,
no_show: cfg.get("noShow").and_then(Value::as_bool).unwrap_or(false),
form_id: cfg.get("formId").and_then(Value::as_i64),
+21
View File
@@ -35,19 +35,40 @@
//! 3. `rowFormItem` 是布局容器,不占列,孩子才占
//! 4. `table` 是子表,它的字段属于**另一张物理表**
//!
//! ## 模块地图
//!
//! | 模块 | 职责 |
//! |---|---|
//! | [`form`] | 控件树解析(`FormSchema` / `FieldNode`) |
//! | [`model`] | 表结构解析(`ModelSchema` / `TableSchema`) |
//! | [`widget`] | 54 种 `jnpfKey` → 类别 + 自动填充策略 |
//! | [`validate`] | 表单 ↔ 模型 自洽性诊断(9 类诊断码) |
//! | [`sql`] | **动态 CRUD 的 SQL 生成**(纯函数:出 SQL 文本 + 参数,不连库) |
//! | [`ddl`] | **动态建表的 DDL 生成**(纯函数:出 `CREATE TABLE`,不连库) |
//!
//! ## 为什么「不改一个字段」是可验证的
//!
//! [`FormSchema::raw`] / [`ModelSchema::raw`] 保留原始 JSON 一字不动,
//! 保存时原样写回。解析结果只是**只读视图**,
//! 测试 `real_sample.rs` 用官方初始化数据里的真表单做基线断言。
pub mod ddl;
pub mod form;
pub mod model;
pub mod sql;
pub mod validate;
pub mod widget;
pub use ddl::{
plan_create, rewrite_model, ColumnDdl, CreatePlan, DdlError, DdlOptions, TableDdl, TypeSpec,
};
pub use form::{v_model_to_column, FieldNode, FormError, FormSchema};
pub use model::{ColumnDef, ModelError, ModelSchema, TableSchema};
pub use sql::{
check_identifier, diff_sub_rows, lookup, plan_delete, plan_hard_delete, plan_insert,
plan_soft_delete, plan_update, plan_update_full, DeletePlan, Sql, SqlError, SqlKind, SubDiff,
SubUpdateContext, SubUpdateOptions, UpdatePlan, WriteContext, WritePlan,
};
pub use validate::{validate, Diagnostic, Report, Severity};
pub use widget::{auto_fill, classify, AutoFill, WidgetKind};
+48
View File
@@ -119,6 +119,27 @@ pub struct TableSchema {
pub type_id: String,
/// 列定义(顺序即建表顺序)。
pub fields: Vec<ColumnDef>,
/// 🔴 **子表外键列**(`tableField`)—— 子表里指向主表主键的那一列。
///
/// ## 溯源
///
/// Java `FlowFormDataUtil.createMastTable()`:
/// ```java
/// String foreignKey = tableModel.getTableField();
/// GeneralInsertDSL dsl = insertInto(sqlTable).set(sqlTable.column(foreignKey)).toValue(foreignValue);
/// ```
///
/// ⇒ 外键列名**来自模型**,不是常量。实测 `test_details` 的 `tableField` 是
/// `F_Receivableid` ⇒ 物理列 `f_receivableid`,**不是** `f_foreign_id`。
///
/// 🔴 之前硬编码 `f_foreign_id` 会在真实数据上直接 `column does not exist`。
pub table_field: Option<String>,
/// 🔴 **主表关联字段**(`relationField`)—— 主表里被子表外键引用的那一列。
///
/// Java:`Object foreignValue = dataNewMap.get(tableModel.getRelationField());`
pub relation_field: Option<String>,
/// 本表关联到的主表名(`relationTable`;主表自身为空串)。
pub relation_table: Option<String>,
}
impl TableSchema {
@@ -127,6 +148,20 @@ impl TableSchema {
self.type_id == "1"
}
/// 子表外键列的**物理列名**(`tableField` 推导)。
pub fn foreign_key_column(&self) -> Option<String> {
self.table_field
.as_deref()
.and_then(crate::form::v_model_to_column)
}
/// 主表关联列的**物理列名**(`relationField` 推导)。
pub fn relation_column(&self) -> Option<String> {
self.relation_field
.as_deref()
.and_then(crate::form::v_model_to_column)
}
/// 按 `F_xxx` 风格的设计态字段名找列(大小写不敏感)。
pub fn column_by_field(&self, field: &str) -> Option<&ColumnDef> {
self.fields
@@ -222,6 +257,10 @@ fn parse_table(v: &Value) -> Option<TableSchema> {
Some(Value::Number(n)) => n.to_string(),
_ => "0".to_string(),
},
// 🔴 官方数据里这三个字段是空串(主表)或具体列名(子表)⇒ 空串视作「没有」。
table_field: opt_str(obj, "tableField"),
relation_field: opt_str(obj, "relationField"),
relation_table: opt_str(obj, "relationTable"),
fields: obj
.get("fields")
.and_then(Value::as_array)
@@ -230,6 +269,15 @@ fn parse_table(v: &Value) -> Option<TableSchema> {
})
}
/// 取一个非空字符串字段(空串 ⇒ `None`)。
fn opt_str(obj: &Map<String, Value>, key: &str) -> Option<String> {
obj.get(key)
.and_then(Value::as_str)
.map(str::trim)
.filter(|s| !s.is_empty())
.map(str::to_string)
}
fn parse_column(v: &Value) -> Option<ColumnDef> {
let obj = v.as_object()?;
let field = obj.get("field").and_then(Value::as_str)?.trim().to_string();
File diff suppressed because it is too large. Load diff
+48 -10
View File
@@ -107,6 +107,27 @@ impl WidgetKind {
///
/// 不是「保持入参」:新增的行还没被改过,「最后修改人」为空才是正确的。
/// 如果照抄入参,会出现「刚建就显示被别人改过」的脏审计。
///
/// ## 🔴 为什么 `ModifyTime` 与 `ModifyUser` 必须拆成两个变体
///
/// 基线平台 `FlowFormDataUtil` 里这是**两个不同的 switch 分支**:
///
/// ```java
/// // create() —— 新增:两者都置 null
/// case JnpfKeyConsts.MODIFYTIME: value = null; break;
/// case JnpfKeyConsts.MODIFYUSER: value = null; break;
///
/// // update() —— 更新:modifyTime 写当前时间,modifyUser 写当前用户 id
/// case JnpfKeyConsts.MODIFYTIME:
/// if (!childNeedAdd) { value = new Date(); }
/// break;
/// case JnpfKeyConsts.MODIFYUSER:
/// if (!childNeedAdd) { value = user.getUserId(); }
/// break;
/// ```
///
/// 之前把两者合并成一个 `Null` ⇒ **更新时两者都没写**,
/// 「最后修改人 / 最后修改时间」永远停在旧值 —— 审计链断掉。
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum AutoFill {
/// 用入参原值(普通业务字段)。
@@ -119,8 +140,10 @@ pub enum AutoFill {
CurrentOrganizeIds,
/// 当前用户的岗位 id 列表,序列化成 JSON 字符串(`currPosition`)。
CurrentPositionIds,
/// 新增时置 `null`(`modifyTime` / `modifyUser`)。
Null,
/// 最后修改时间:新增置 `null`,更新写当前时间(`modifyTime`)。
ModifyTime,
/// 最后修改人:新增置 `null`,更新写当前用户 id(`modifyUser`)。
ModifyUser,
/// 单据号生成器产出(`billRule`,`ruleType=1` 时)。
BillNumber,
}
@@ -134,7 +157,8 @@ impl AutoFill {
AutoFill::Now => "now",
AutoFill::CurrentOrganizeIds => "currentOrganizeIds",
AutoFill::CurrentPositionIds => "currentPositionIds",
AutoFill::Null => "null",
AutoFill::ModifyTime => "modifyTime",
AutoFill::ModifyUser => "modifyUser",
AutoFill::BillNumber => "billNumber",
}
}
@@ -145,18 +169,20 @@ impl AutoFill {
}
}
/// 控件 → 新增时的自动填充行为。
/// 控件 → 自动填充行为。
///
/// 对齐 `FlowFormDataUtil.create()` 的 switch 分支;未知控件走 `Passthrough`。
/// 对齐 `FlowFormDataUtil.create()` / `update()` 的 switch 分支;未知控件走 `Passthrough`。
///
/// 🔴 `modifyTime` 与 `modifyUser` 在基线平台是**两个独立分支**,
/// 新增时都置 null、更新时分别写「当前时间」和「当前用户 id」⇒ 不能合并。
pub fn auto_fill(jnpf_key: &str) -> AutoFill {
match jnpf_key {
"createUser" | "createUserId" => AutoFill::CurrentUserId,
"createTime" => AutoFill::Now,
"currOrganize" | "currDept" => AutoFill::CurrentOrganizeIds,
"currPosition" => AutoFill::CurrentPositionIds,
"modifyTime" | "modifyUser" | "lastModifyTime" | "lastModifyUser" | "modifyUserId" => {
AutoFill::Null
}
"modifyTime" | "lastModifyTime" => AutoFill::ModifyTime,
"modifyUser" | "lastModifyUser" | "modifyUserId" => AutoFill::ModifyUser,
"billRule" => AutoFill::BillNumber,
_ => AutoFill::Passthrough,
}
@@ -307,13 +333,25 @@ mod tests {
assert_eq!(auto_fill("currPosition"), AutoFill::CurrentPositionIds);
assert_eq!(auto_fill("billRule"), AutoFill::BillNumber);
// 新增时清空 —— 「刚建就显示被人改过」是脏审计
assert_eq!(auto_fill("modifyTime"), AutoFill::Null);
assert_eq!(auto_fill("modifyUser"), AutoFill::Null);
assert_eq!(auto_fill("modifyTime"), AutoFill::ModifyTime);
assert_eq!(auto_fill("modifyUser"), AutoFill::ModifyUser);
// 普通字段不动
assert_eq!(auto_fill("input"), AutoFill::Passthrough);
assert_eq!(auto_fill("calculate"), AutoFill::Passthrough);
}
/// 🔴 `modifyTime` 与 `modifyUser` 必须是**两个不同的分支**。
///
/// 基线平台 `update()`:`MODIFYTIME` 写当前时间、`MODIFYUSER` 写当前用户 id。
/// 合并成一个变体 ⇒ 更新时两者都没写 ⇒ 「最后修改人/时间」永远停在旧值。
#[test]
fn modify_time_and_modify_user_are_distinct() {
assert_ne!(auto_fill("modifyTime"), auto_fill("modifyUser"));
assert_eq!(auto_fill("lastModifyTime"), AutoFill::ModifyTime);
assert_eq!(auto_fill("lastModifyUser"), AutoFill::ModifyUser);
assert_eq!(auto_fill("modifyUserId"), AutoFill::ModifyUser);
}
/// 凡是被覆盖的,`accepts_input` 必须是 false —— 否则「传了也没用」但没人告知。
#[test]
fn overridden_fields_do_not_accept_input() {