//! 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())); } } }