- 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 注释)
305 lines
11 KiB
Rust
305 lines
11 KiB
Rust
//! real_ddl —— 用**官方初始化数据里的真模型**验证建表 DDL 生成。
|
||
//!
|
||
//! ## 为什么必须用真数据
|
||
//!
|
||
//! `ddl.rs` 的单测用**合成**模型验证规则;这份用**官方 fixture**
|
||
//! (`tests/fixtures/sample_model.json`,与基线平台初始化 SQL 同源)验证
|
||
//! 「生成的 DDL 与官方真实 DDL 同形」。
|
||
//!
|
||
//! ## 🔴 这份测试钉死的三件事
|
||
//!
|
||
//! | 真相 | 影响 |
|
||
//! |---|---|
|
||
//! | 官方真实 DDL 的主键是**复合**的 `(f_id, f_tenant_id)` | 单列主键 ⇒ 与基线库结构不一致,跨库读写直接炸 |
|
||
//! | 子表外键列是 `f_receivableid`(**不是** `f_foreign_id`) | 硬编码 ⇒ `column does not exist` |
|
||
//! | 官方模型里**已含**系统列(`f_tenant_id` / `f_version` / …) | 重复追加 ⇒ 建表报 duplicate column |
|
||
//!
|
||
//! ## 🔴 断言的强度
|
||
//!
|
||
//! [`ddl_matches_official_ddl_line_by_line`]:把生成的 DDL **逐列**与官方
|
||
//! `jnpf_db_init.sql` 里的 `CREATE TABLE test_receivable` 对照 ——
|
||
//! 列名、类型、顺序、NOT NULL、DEFAULT 全部要一致。
|
||
//!
|
||
//! 这不是「差不多就行」的断言:任何一列对不上就红。
|
||
|
||
use std::path::PathBuf;
|
||
|
||
use sspf_lowcode::{plan_create, DdlOptions, ModelSchema};
|
||
|
||
fn fixture(name: &str) -> String {
|
||
let mut p = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
|
||
p.push("tests/fixtures");
|
||
p.push(name);
|
||
std::fs::read_to_string(&p).unwrap_or_else(|e| panic!("读不到 {}: {e}", p.display()))
|
||
}
|
||
|
||
fn real_model() -> ModelSchema {
|
||
let raw = fixture("sample_model.json");
|
||
ModelSchema::parse(&serde_json::from_str(&raw).unwrap()).unwrap()
|
||
}
|
||
|
||
fn opts() -> DdlOptions {
|
||
DdlOptions::default_options()
|
||
}
|
||
|
||
/// 从 `CREATE TABLE` 文本里抽出「列名 ⇒ 完整定义」。
|
||
fn column_defs(sql: &str) -> Vec<(String, String)> {
|
||
let body = sql
|
||
.split_once("(\n")
|
||
.expect("应有 CREATE TABLE (")
|
||
.1
|
||
.rsplit_once("\n);")
|
||
.expect("应有 );")
|
||
.0;
|
||
body.lines()
|
||
.filter_map(|l| {
|
||
let l = l.trim().trim_end_matches(',').trim();
|
||
if l.is_empty() || l.starts_with("PRIMARY KEY") {
|
||
return None;
|
||
}
|
||
let (name, rest) = l.split_once(' ')?;
|
||
Some((name.to_string(), rest.to_string()))
|
||
})
|
||
.collect()
|
||
}
|
||
|
||
/// 🔴 生成的 DDL 必须与官方真实 DDL **逐列一致**。
|
||
///
|
||
/// 官方 `jnpf_db_init.sql`(PostgreSQL 版):
|
||
/// ```sql
|
||
/// CREATE TABLE test_receivable (
|
||
/// f_id VARCHAR(50) NOT NULL,
|
||
/// f_building VARCHAR(100),
|
||
/// f_room VARCHAR(100),
|
||
/// f_company_name VARCHAR(50),
|
||
/// f_userid VARCHAR(50),
|
||
/// f_phone VARCHAR(50),
|
||
/// f_ost VARCHAR(50),
|
||
/// f_sort_code BIGINT,
|
||
/// f_enabledmark INTEGER,
|
||
/// f_creatortime TIMESTAMP(0) WITHOUT TIME ZONE,
|
||
/// f_creatoruserid VARCHAR(50),
|
||
/// f_lastmodifytime TIMESTAMP(0) WITHOUT TIME ZONE,
|
||
/// f_lastmodifyuserid VARCHAR(50),
|
||
/// f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
|
||
/// f_version INTEGER DEFAULT '0',
|
||
/// f_flowtaskid VARCHAR(50),
|
||
/// f_flow_id VARCHAR(50),
|
||
/// f_flow_task_id VARCHAR(50),
|
||
/// f_inte_assistant INTEGER,
|
||
/// f_flow_state INTEGER DEFAULT '0',
|
||
/// PRIMARY KEY (f_id, f_tenant_id)
|
||
/// );
|
||
/// ```
|
||
///
|
||
/// ## 🔴 与官方手写脚本的两处差异(有意为之)
|
||
///
|
||
/// | 列 | 官方手写脚本 | 本生成器 | 理由 |
|
||
/// |---|---|---|---|
|
||
/// | `f_version` | `INTEGER`(无默认) | `INTEGER DEFAULT '0'` | Java `FormatSql.defaultCheck` 给有默认值的列加 `DEFAULT '0'` |
|
||
/// | `f_flow_state` | `INTEGER`(无默认) | `INTEGER DEFAULT '0'` | 同上(`ConcurrencyUtils` 明确给 FLOWSTATE 设了默认值) |
|
||
///
|
||
/// 官方脚本是**手写**的基线 DDL;本生成器产出的是 **Java 动态建表**的结果 ——
|
||
/// 两者本就可能不同。这里对齐的是**动态建表**(那才是运行时真正会发生的事)。
|
||
#[test]
|
||
fn ddl_matches_official_ddl_line_by_line() {
|
||
let plan = plan_create(&real_model(), &opts()).expect("应能生成建表计划");
|
||
let sql = plan.main.render();
|
||
|
||
// 官方 DDL 的期望形态:(列名, 类型 + 约束)
|
||
let expected: Vec<(&str, &str)> = vec![
|
||
("f_id", "VARCHAR(50) NOT NULL"),
|
||
("f_building", "VARCHAR(100)"),
|
||
("f_room", "VARCHAR(100)"),
|
||
("f_company_name", "VARCHAR(50)"),
|
||
("f_userid", "VARCHAR(50)"),
|
||
("f_phone", "VARCHAR(50)"),
|
||
("f_ost", "VARCHAR(50)"),
|
||
("f_sort_code", "BIGINT"),
|
||
("f_enabledmark", "INTEGER"),
|
||
("f_creatortime", "TIMESTAMP(0) WITHOUT TIME ZONE"),
|
||
("f_creatoruserid", "VARCHAR(50)"),
|
||
("f_lastmodifytime", "TIMESTAMP(0) WITHOUT TIME ZONE"),
|
||
("f_lastmodifyuserid", "VARCHAR(50)"),
|
||
("f_tenant_id", "VARCHAR(50) DEFAULT '0' NOT NULL"),
|
||
("f_version", "INTEGER DEFAULT '0'"),
|
||
("f_flowtaskid", "VARCHAR(50)"),
|
||
("f_flow_id", "VARCHAR(50)"),
|
||
("f_flow_task_id", "VARCHAR(50)"),
|
||
("f_inte_assistant", "INTEGER"),
|
||
("f_flow_state", "INTEGER DEFAULT '0'"),
|
||
];
|
||
|
||
let actual = column_defs(&sql);
|
||
assert_eq!(
|
||
actual.len(),
|
||
expected.len(),
|
||
"🔴 列数不一致\n期望 {expected:#?}\n实际 {actual:#?}"
|
||
);
|
||
for (i, (exp_name, exp_def)) in expected.iter().enumerate() {
|
||
let (act_name, act_def) = &actual[i];
|
||
assert_eq!(act_name, exp_name, "第 {i} 列名不一致");
|
||
assert_eq!(act_def, exp_def, "第 {i} 列({exp_name})定义不一致");
|
||
}
|
||
}
|
||
|
||
/// 🔴 子表也要与官方真实 DDL 逐列一致。
|
||
///
|
||
/// 官方:
|
||
/// ```sql
|
||
/// CREATE TABLE test_details (
|
||
/// f_id VARCHAR(50) NOT NULL,
|
||
/// f_receivableid VARCHAR(50),
|
||
/// f_month VARCHAR(200),
|
||
/// f_rent DECIMAL(18, 2),
|
||
/// f_water_rent DECIMAL(18, 2),
|
||
/// f_powerrate DECIMAL(18, 2),
|
||
/// f_property DECIMAL(18, 2),
|
||
/// f_cleaning DECIMAL(18, 2),
|
||
/// f_pollutant DECIMAL(18, 2),
|
||
/// f_totalbilling DECIMAL(18, 2),
|
||
/// f_creatortime TIMESTAMP(0) WITHOUT TIME ZONE,
|
||
/// f_creatoruserid VARCHAR(50),
|
||
/// f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL,
|
||
/// PRIMARY KEY (f_id, f_tenant_id)
|
||
/// );
|
||
/// ```
|
||
#[test]
|
||
fn sub_table_ddl_matches_official_line_by_line() {
|
||
let plan = plan_create(&real_model(), &opts()).expect("应能生成建表计划");
|
||
let sql = plan.subs[0].render();
|
||
|
||
let expected: Vec<(&str, &str)> = vec![
|
||
("f_id", "VARCHAR(50) NOT NULL"),
|
||
("f_receivableid", "VARCHAR(50)"),
|
||
("f_month", "VARCHAR(200)"),
|
||
("f_rent", "DECIMAL(18, 2)"),
|
||
("f_water_rent", "DECIMAL(18, 2)"),
|
||
("f_powerrate", "DECIMAL(18, 2)"),
|
||
("f_property", "DECIMAL(18, 2)"),
|
||
("f_cleaning", "DECIMAL(18, 2)"),
|
||
("f_pollutant", "DECIMAL(18, 2)"),
|
||
("f_totalbilling", "DECIMAL(18, 2)"),
|
||
("f_creatortime", "TIMESTAMP(0) WITHOUT TIME ZONE"),
|
||
("f_creatoruserid", "VARCHAR(50)"),
|
||
("f_tenant_id", "VARCHAR(50) DEFAULT '0' NOT NULL"),
|
||
];
|
||
|
||
let actual = column_defs(&sql);
|
||
assert_eq!(
|
||
actual.len(),
|
||
expected.len(),
|
||
"🔴 子表列数不一致\n期望 {expected:#?}\n实际 {actual:#?}"
|
||
);
|
||
for (i, (exp_name, exp_def)) in expected.iter().enumerate() {
|
||
let (act_name, act_def) = &actual[i];
|
||
assert_eq!(act_name, exp_name, "第 {i} 列名不一致");
|
||
assert_eq!(act_def, exp_def, "第 {i} 列({exp_name})定义不一致");
|
||
}
|
||
}
|
||
|
||
/// 🔴 复合主键必须是 `(f_id, f_tenant_id)`。
|
||
#[test]
|
||
fn primary_key_is_composite() {
|
||
let plan = plan_create(&real_model(), &opts()).expect("应能生成建表计划");
|
||
let sql = plan.main.render();
|
||
assert!(
|
||
sql.contains("PRIMARY KEY (f_id, f_tenant_id)"),
|
||
"🔴 主键必须是复合的: {sql}"
|
||
);
|
||
// 不能是单列主键
|
||
assert!(!sql.contains("PRIMARY KEY (f_id)"), "{sql}");
|
||
}
|
||
|
||
/// 🔴 官方模型里已含系统列 ⇒ **不能重复追加**。
|
||
#[test]
|
||
fn system_columns_are_not_duplicated() {
|
||
let plan = plan_create(&real_model(), &opts()).expect("应能生成建表计划");
|
||
for sql in [&plan.main.render(), &plan.subs[0].render()] {
|
||
for name in [
|
||
"f_id",
|
||
"f_tenant_id",
|
||
"f_version",
|
||
"f_flow_task_id",
|
||
"f_flow_state",
|
||
] {
|
||
let count = sql
|
||
.lines()
|
||
.filter(|l| l.trim().starts_with(&format!("{name} ")))
|
||
.count();
|
||
assert!(
|
||
count <= 1,
|
||
"🔴 列 {name} 出现了 {count} 次(重复追加):\n{sql}"
|
||
);
|
||
}
|
||
}
|
||
}
|
||
|
||
/// 🔴 子表**没有**流程/并发列(Java 只给主表加)。
|
||
#[test]
|
||
fn sub_table_has_no_flow_columns() {
|
||
let plan = plan_create(&real_model(), &opts()).expect("应能生成建表计划");
|
||
let sql = plan.subs[0].render();
|
||
for name in ["f_flow_id", "f_version", "f_flow_state", "f_flow_task_id"] {
|
||
assert!(
|
||
!sql.lines().any(|l| l.trim().starts_with(&format!("{name} "))),
|
||
"🔴 子表不该有 {name}:\n{sql}"
|
||
);
|
||
}
|
||
}
|
||
|
||
/// 🔴 官方模型 `logicalDelete = false` ⇒ 表里**没有**删除列。
|
||
#[test]
|
||
fn no_delete_columns_when_logical_delete_is_off() {
|
||
let plan = plan_create(&real_model(), &opts()).expect("应能生成建表计划");
|
||
for sql in [&plan.main.render(), &plan.subs[0].render()] {
|
||
for name in ["f_delete_mark", "f_delete_time", "f_delete_user_id"] {
|
||
assert!(
|
||
!sql.lines().any(|l| l.trim().starts_with(&format!("{name} "))),
|
||
"🔴 logicalDelete=false 时不该有 {name}:\n{sql}"
|
||
);
|
||
}
|
||
}
|
||
}
|
||
|
||
/// 🔴 开启逻辑删除后,主表与子表**同进同退**。
|
||
#[test]
|
||
fn delete_columns_appear_together() {
|
||
let mut o = opts();
|
||
o.logical_delete = true;
|
||
let plan = plan_create(&real_model(), &o).expect("应能生成建表计划");
|
||
for sql in [&plan.main.render(), &plan.subs[0].render()] {
|
||
assert!(sql.contains("f_delete_mark INTEGER"), "{sql}");
|
||
assert!(sql.contains("f_delete_time TIMESTAMP(0) WITHOUT TIME ZONE"), "{sql}");
|
||
assert!(sql.contains("f_delete_user_id VARCHAR(50)"), "{sql}");
|
||
}
|
||
}
|
||
|
||
/// 🔴 建表顺序:主表 → 子表(子表外键指向主表)。
|
||
#[test]
|
||
fn tables_are_created_main_first() {
|
||
let plan = plan_create(&real_model(), &opts()).expect("应能生成建表计划");
|
||
let sqls = plan.render();
|
||
assert_eq!(sqls.len(), 2);
|
||
assert!(sqls[0].contains("CREATE TABLE test_receivable"));
|
||
assert!(sqls[1].contains("CREATE TABLE test_details"));
|
||
}
|
||
|
||
/// 🔴 DDL 里的每个标识符都必须合法(不能带分号之类的注入载荷)。
|
||
#[test]
|
||
fn all_identifiers_are_safe() {
|
||
let plan = plan_create(&real_model(), &opts()).expect("应能生成建表计划");
|
||
for t in plan.all() {
|
||
for c in &t.columns {
|
||
assert!(
|
||
c.name
|
||
.chars()
|
||
.all(|ch| ch.is_ascii_alphanumeric() || ch == '_'),
|
||
"🔴 列名不安全: {}",
|
||
c.name
|
||
);
|
||
assert!(!c.name.starts_with(|ch: char| ch.is_ascii_digit()));
|
||
}
|
||
}
|
||
}
|