Files
ssw-platform/crates/tests/tests/lowcode_seed_it.rs
T
admin acf076df5a refactor: 内核瘦身 —— 示例搬成业务包 + 装配/测试各归其位
- 内核只有 lib:启动装配 → crates/sspf-admin(bin sspf-admin);37 个集成测试 → crates/tests(package sspf-tests)。
- demo/shop/books 的 spec/菜单/DDL/面 B 路由搬进 packs/{demo,shop,books};内核 modules/*.rs 只剩「面 A 适配器 + pub use」⇒ 内核零业务知识,示例可整目录搬走。面 A 与前端零改动。
- 示例表 DDL 按平台规则补 f_tenant_id + 复合主键(spec 不加 ⇒ JSON 键与响应逐字不变)。
- 修 is_builtin_table 只认 schema.sql 的漏洞:包表(含 asset_data_resource)此前可被建模页删除/改;现为「平台 DDL ∪ 包表」。
- sspf-compat-online_dev → onlinedev(包名/模块/文件/路由别名同步);6 个 5 行转发壳合并为 forward.rs。
- 新增 AR16 闸门 + lib.rs「30 秒地图」+ src/backend/README.md;pack-sync 补两处判据(module_key=None 的 urlAddress、apiFile 查存在性)。
- 回归:704 tests / 6 道静态闸门全绿;health 181 表;四个包面 A/面 B 运行时全部 200。
2026-11-04 14:46:12 +08:00

312 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.
//! 开发期低代码种子的集成测试 —— **真实 pglite 库**。
//!
//! ## 覆盖什么
//!
//! | 测试 | 证明什么 |
//! |---|---|
//! | `preview_needs_no_database` | 演练**连库都不开**(只读 fixture + 算 DDL) |
//! | `seed_creates_real_tables` | 种子真的建出 `test_receivable` / `test_details` |
//! | `seed_writes_visual_dev_and_release` | `base_visual_dev` 与 `base_visual_release` 各有一行 |
//! | `seed_write_back_includes_system_columns` | 回写后的模型含平台系统列(`f_tenant_id` 等) |
//! | `seed_is_idempotent` | 重复跑不报错、不重复行 |
//! | `seeded_feature_supports_record_insert` | 种完的功能够用 `data.record.insert` 写数据 |
//! | `seeded_feature_matches_official_ddl` | 建出来的列与**官方真实 DDL** 逐列一致 |
//!
//! ## 🔴 为什么最后两条最重要
//!
//! 种子的目的不是「库里有行」,而是「**种出来的东西能用**」:
//! - `seeded_feature_supports_record_insert` ⇒ 端到端闭环(种子 → 写工具 → 真落库);
//! - `seeded_feature_matches_official_ddl` ⇒ 列名/类型/顺序与基线平台**一致**
//! (不一致 ⇒ 迁移期跨库读写直接炸)。
use serde_json::Value;
use ssw_platform::lowcode_crud::{build_context, insert_record, now_iso, DEFAULT_TENANT_ID};
use ssw_platform::lowcode_ddl::real_columns;
use ssw_platform::lowcode_seed::{
fixture_path, preview_lowcode_demo, seed_lowcode_demo, DEMO_EN_CODE, DEMO_ID,
};
use sspf_core::db::Db;
use tokio::sync::{Mutex, OnceCell};
/// 全文件共享的临时库。
static DB: OnceCell<Db> = OnceCell::const_new();
/// 全文件串行(共用一个库)。
static LOCK: Mutex<()> = Mutex::const_new(());
async fn db() -> &'static Db {
DB.get_or_init(|| async {
let db = Db::open_temp().await.expect("打开 pglite 临时库失败");
ssw_platform::bootstrap::ensure_schema_all(&db)
.await
.expect("ensure_schema_all 失败");
db
})
.await
}
/// 项目根(测试的 cwd = crate 目录 ⇒ 上溯两级到仓库根)。
fn project_dir() -> std::path::PathBuf {
std::path::PathBuf::from(env!("CARGO_MANIFEST_DIR"))
.parent()
.and_then(|p| p.parent())
.expect("应能定位到项目根")
.to_path_buf()
}
/// 官方 fixture 的真实路径(供断言用)。
fn fixture(name: &str) -> std::path::PathBuf {
fixture_path(&project_dir(), name)
}
/// 🔴 演练:**连库都不开**。
#[tokio::test]
async fn preview_needs_no_database() {
// 🔴 刻意**不**取共享库 ⇒ 如果演练偷偷开了库,这里会撞 pglite 的
// 「一个进程只能开一个实例」限制(后面那些测试会开库)⇒ 立刻暴露。
let outcome = preview_lowcode_demo(&project_dir()).expect("演练应成功");
assert!(outcome.dry_run, "演练必须标 dry_run");
assert_eq!(
outcome.tables,
vec!["test_receivable".to_string(), "test_details".to_string()],
"演练要报出要建的两张表"
);
assert!(!outcome.ddl.is_empty(), "演练要给出 DDL");
assert!(outcome.ddl[0].contains("CREATE TABLE test_receivable"));
}
/// 🔴 种子真的建出物理表 + 两行功能定义。
#[tokio::test]
async fn seed_creates_real_tables() {
let _g = LOCK.lock().await;
let db = db().await;
let outcome = seed_lowcode_demo(db, &project_dir())
.await
.expect("种子应成功");
assert!(!outcome.dry_run);
assert_eq!(outcome.form_id, DEMO_ID);
assert_eq!(outcome.en_code, DEMO_EN_CODE);
// ---- 两张表真的在库里 ----
for table in ["test_receivable", "test_details"] {
let cols = real_columns(db, table)
.await
.unwrap_or_else(|e| panic!("表 {table} 应该建出来了: {} {}", e.code, e.message));
assert!(!cols.is_empty(), "表 {table} 应该是有列的");
}
// ---- 功能定义两行都在 ----
for table in ["base_visual_dev", "base_visual_release"] {
let rows = db
.query_json_params(
&format!("SELECT f_id AS \"id\" FROM {table} WHERE f_id = $1 LIMIT 1"),
&[&DEMO_ID.to_string()],
)
.await
.expect("查功能定义");
assert_eq!(rows.len(), 1, "{table} 里应有且只有一行示例功能");
}
}
/// 🔴 回写后的模型含**平台系统列**(`f_tenant_id` / `f_version` …)。
///
/// 这是「建表后回写」机制的价值所在:不回写 ⇒ CRUD 层找不到 `f_delete_mark`
/// ⇒ 逻辑删除直接报 `LOGICAL_DELETE_UNSUPPORTED`。
#[tokio::test]
async fn seed_write_back_includes_system_columns() {
let _g = LOCK.lock().await;
let db = db().await;
let outcome = seed_lowcode_demo(db, &project_dir())
.await
.expect("种子应成功");
let main = outcome.model[0].clone();
let fields = main["fields"].as_array().expect("fields 应是数组");
let names: Vec<&str> = fields
.iter()
.filter_map(|f| f["field"].as_str())
.collect();
for want in [
"f_tenant_id",
"f_version",
"f_flow_id",
"f_flow_task_id",
"f_flow_state",
] {
assert!(
names.contains(&want),
"回写后的模型应含系统列 {want},实际:{names:?}"
);
}
// ---- 库里那一行的 f_tables_data 也要是回写后的 ----
let rows = db
.query_json_params(
"SELECT f_tables_data AS \"tables\" FROM base_visual_dev WHERE f_id = $1 LIMIT 1",
&[&DEMO_ID.to_string()],
)
.await
.expect("读回写的模型");
let text = rows[0]["tables"].as_str().unwrap_or("");
let stored: Value = serde_json::from_str(text).expect("回写的模型应是合法 JSON");
assert_eq!(
stored, outcome.model,
"库里存的模型必须与回写产出逐字一致"
);
}
/// 🔴 **幂等**:重复跑不报错、不重复行。
#[tokio::test]
async fn seed_is_idempotent() {
let _g = LOCK.lock().await;
let db = db().await;
// 第一跑(可能已被前面的测试种过 ⇒ 也应是幂等的)。
seed_lowcode_demo(db, &project_dir()).await.expect("第一次种子");
// 第二跑 ⇒ 表已存在 ⇒ 跳过建表,但**仍回写模型**。
let second = seed_lowcode_demo(db, &project_dir())
.await
.expect("第二次种子也必须成功(幂等)");
assert!(
second.tables.is_empty(),
"第二次不该再建表(已存在)"
);
assert_eq!(
second.skipped,
vec!["test_receivable".to_string(), "test_details".to_string()],
"第二次应把两张表记为「已存在」"
);
// 功能定义仍只有一行。
let rows = db
.query_json_params(
"SELECT f_id AS \"id\" FROM base_visual_dev WHERE f_id = $1 LIMIT 1",
&[&DEMO_ID.to_string()],
)
.await
.expect("查功能定义");
assert_eq!(rows.len(), 1, "重复跑不许留下重复行");
}
/// 🔴 **种完的功能够用** —— 端到端闭环。
#[tokio::test]
async fn seeded_feature_supports_record_insert() {
let _g = LOCK.lock().await;
let db = db().await;
seed_lowcode_demo(db, &project_dir()).await.expect("种子");
// ---- 从库里读回功能定义(模拟 MCP 的 `load_visualdev`)----
let rows = db
.query_json_params(
"SELECT f_form_data AS \"formData\", f_tables_data AS \"tablesData\" \
FROM base_visual_dev WHERE f_id = $1 LIMIT 1",
&[&DEMO_ID.to_string()],
)
.await
.expect("读功能定义");
assert_eq!(rows.len(), 1);
let form = sspf_lowcode::FormSchema::from_str(rows[0]["formData"].as_str().unwrap_or(""))
.expect("表单应可解析");
let model = sspf_lowcode::ModelSchema::from_str(rows[0]["tablesData"].as_str().unwrap_or(""))
.expect("模型应可解析");
// ---- 走真正的写入路径(与 MCP `data.record.insert` 同款)----
let payload = serde_json::json!({ "F_Room": "A-101", "F_Company_name": "某某公司" });
let now = now_iso();
let mut ctx = build_context(None, Some(DEFAULT_TENANT_ID), Some(&now));
let outcome = insert_record(db, &form, &model, &payload, &mut ctx, false)
.await
.expect("种完的功应该能写数据");
assert!(!outcome.id.is_empty(), "应返回记录 id");
// ---- 真落库了 ----
let rows = db
.query_json_params(
"SELECT f_room AS \"room\", f_tenant_id AS \"tenant\" \
FROM test_receivable WHERE f_id = $1 LIMIT 1",
&[&outcome.id],
)
.await
.expect("查刚写的记录");
assert_eq!(rows.len(), 1, "记录应真的在库里");
assert_eq!(rows[0]["room"].as_str(), Some("A-101"));
// 🔴 单租户口径:租户列**必须**被写(Java `addTenantId()` 无条件执行),
// 且值恒为 "0"(`GlobalConst.DEFAULT_TENANT_VALUE`)。
assert_eq!(
rows[0]["tenant"].as_str(),
Some("0"),
"单租户下 f_tenant_id 必须写 \"0\""
);
}
/// 🔴 建出来的列与**官方真实 DDL** 逐列一致。
///
/// 官方(`jnpf_dbnull_init.sql` 的 `CREATE TABLE test_receivable`)的列序:
/// ```text
/// f_id, f_building, f_room, f_company_name, f_userid, f_phone, f_ost,
/// f_sort_code, f_enabledmark, f_creatortime, f_creatoruserid,
/// f_lastmodifytime, f_lastmodifyuserid, f_tenant_id, f_version,
/// f_flowtaskid, f_flow_id, f_flow_task_id, f_inte_assistant, f_flow_state
/// ```
#[tokio::test]
async fn seeded_feature_matches_official_ddl() {
let _g = LOCK.lock().await;
let db = db().await;
seed_lowcode_demo(db, &project_dir()).await.expect("种子");
let cols = real_columns(db, "test_receivable")
.await
.expect("读列");
let expected = [
"f_id",
"f_building",
"f_room",
"f_company_name",
"f_userid",
"f_phone",
"f_ost",
"f_sort_code",
"f_enabledmark",
"f_creatortime",
"f_creatoruserid",
"f_lastmodifytime",
"f_lastmodifyuserid",
"f_tenant_id",
"f_version",
"f_flowtaskid",
"f_flow_id",
"f_flow_task_id",
"f_inte_assistant",
"f_flow_state",
];
assert_eq!(
cols,
expected.iter().map(|s| s.to_string()).collect::<Vec<_>>(),
"🔴 建出来的列必须与官方真实 DDL 逐列一致(列名 + 顺序)"
);
}
/// 🔴 fixture 必须在(种子依赖它 ⇒ 路径错了要立刻报,不是静默跳过)。
#[test]
fn official_fixtures_exist() {
for name in [
"crates/sspf-lowcode/tests/fixtures/sample_form.json",
"crates/sspf-lowcode/tests/fixtures/sample_model.json",
] {
let p = fixture(name);
assert!(p.is_file(), "官方 fixture 必须存在:{}", p.display());
}
}