Files
ssw-platform/crates/sspf-lowcode/tests/real_ddl.rs
T
admin bcbe46c92b 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 注释)
2026-10-31 19:26:47 +08:00

305 lines
11 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! 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()));
}
}
}