Files
ssw-platform/crates/sspf-lowcode/tests/real_sample.rs
T
admin f0c77f731c feat(lowcode): 低代码元数据引擎第一波 —— 解析 + 校验 + 3 个只读工具
- 新 crate sspf-lowcode(纯计算,AR7 钉住不依赖 DB/HTTP):widget 把 54 种 jnpfKey 归成 11 类
  (决定「怎么存、能不能接收入参」)/ form 解析控件树 / model 解析表结构 / validate 9 类诊断码
- DDL:base_visual_dev + base_visual_release 逐字对齐官方(21 → 23 张表)
- MCP 3 个只读工具:form.list / form.describe / form.validate,后两个支持 inline JSON
- 真实样例落盘为 fixture(官方初始化数据的「应收费用」:主表 6 字段 / 子表 8 字段)
- 新增 lowcode-smoke.sh 8 条(含两条反自证:改坏 __vModel__ 必被抓、未知控件只 warn)
- 影响:测试 306 → 344;十二闸全绿;三条真实方言已写进注释与测试
2026-10-31 11:47:40 +08:00

207 lines
8.4 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_sample —— 用**官方初始化数据里的真表单**做基线断言。
//!
//! 数据来源:`jnpf-database/PostgreSQL/jnpf_db_init.sql` 的 `base_visual_dev` 表,
//! 一条「应收费用」功能的完整定义(`f_form_data` + `f_tables_data`)。
//!
//! ## 这组测试证明什么
//!
//! PLAN 的 P2 出口是「基线平台导出的表单 JSON,**不改一个字段**能在 SSPF 上渲染 + 存取」。
//! 「不改一个字段」有两层意思,这组测试各钉一层:
//!
//! | 层 | 钉法 |
//! |---|---|
//! | 解析不丢信息 | `raw` 与文件内容逐字节等价(同构) |
//! | 语义没读错 | 主表 6 个字段 / 子表 8 个字段 / 表数 2 —— 与人工核对一致 |
//!
//! ## 🔴 这组测试**不**证明「列名与真实数据库一致」
//!
//! 实测数据里 `f_tables_data` 的 `columnName` **全是 null**,所以本 crate 只能从
//! `field` 推导(`F_Room` → `f_room`)。推导规则是「剥前缀 + 转小写」,
//! 对 `F_CreatorTime` 会得到 `f_creatortime`,而官方实际列名是 `f_creator_time`
//! —— **推导必然有偏差**(见下方 `derivation_is_not_ground_truth`)。
//!
//! ⇒ 本 crate 校验的是「表单 ↔ 模型设计稿」的自洽性。
//! 与真实数据库列的一致性要拿 `information_schema` 比,属于动态 CRUD 那一波(P2-b)。
//! 把这条边界写进测试,是为了防止有人看到「校验通过」就以为能直接跑 SQL。
use std::path::PathBuf;
use sspf_lowcode::{validate, FormSchema, ModelSchema, WidgetKind};
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()))
}
#[test]
fn real_form_parses_with_expected_shape() {
let raw = fixture("sample_form.json");
let form = FormSchema::parse(&serde_json::from_str(&raw).unwrap()).unwrap();
// 实测值:formRef/formModel 是 Vue 里的变量名,不是固定常量
// (见过 `elForm`/`formData`,这条数据是 `formRef`/`dataForm`)
assert_eq!(form.form_ref, "formRef");
assert_eq!(form.form_model, "dataForm");
assert_eq!(form.label_position, "right");
assert_eq!(form.label_width, 100);
assert_eq!(form.primary_key_policy, Some(1));
// 人工核对过:顶层 7 个节点 = 6 个字段 + 1 个子表
assert_eq!(form.fields.len(), 7, "顶层节点数不对");
// 主表 6 个字段(billRule + 5 input),子表容器不算
let main = form.main_fields();
assert_eq!(main.len(), 6, "主表字段数不对: {:?}",
main.iter().map(|f| &f.v_model).collect::<Vec<_>>());
let models: Vec<&str> = main.iter().map(|f| f.v_model.as_str()).collect();
assert_eq!(
models,
vec!["F_Building", "F_Room", "F_Company_name", "F_Userid", "F_Phone", "F_Ost"],
"主表字段顺序/名称应保持 JSON 原样"
);
// 第一个是单据号(系统生成)—— 分类必须对,否则单号会被入参覆盖
assert_eq!(main[0].widget, WidgetKind::SystemGenerated);
assert_eq!(main[0].jnpf_key, "billRule");
// 子表 1 个,8 个字段
let subs = form.sub_tables();
assert_eq!(subs.len(), 1);
assert_eq!(subs[0].table_name.as_deref(), Some("test_details"));
assert_eq!(subs[0].children.len(), 8, "子表字段数不对");
}
/// 🔴 真实的方言陷阱:子表内字段的 `tableName` 指向的是**主表**,不是子表。
///
/// 官方数据里,`test_details` 下那 8 个 input 的 `tableName` 全是
/// `test_receivable`(主表名)。如果按字段自身的 `tableName` 决定写哪张表,
/// 子表数据会被全部写进主表 —— 静默错数据。
///
/// 正确做法:**子表数据的归属只看父节点的 `tableName`**(`FormSchema::sub_tables`)。
#[test]
fn subtable_field_own_table_name_is_misleading() {
let form = FormSchema::parse(&serde_json::from_str(&fixture("sample_form.json")).unwrap())
.unwrap();
let sub = &form.sub_tables()[0];
assert_eq!(
sub.table_name.as_deref(),
Some("test_details"),
"父节点说的是子表"
);
let inner_wrong = sub
.children
.iter()
.filter(|c| c.table_name.as_deref() == Some("test_details"))
.count();
let inner_total = sub.children.len();
assert_eq!(
inner_wrong, 0,
"实测:子表内 {inner_total} 个字段的 tableName 全都**不是** test_details —— \
它们填的是主表名,这是官方数据的真实形态,不能按字段自身的 tableName 判断归属"
);
}
#[test]
fn real_model_parses_with_expected_shape() {
let model =
ModelSchema::parse(&serde_json::from_str(&fixture("sample_model.json")).unwrap()).unwrap();
assert_eq!(model.tables.len(), 2);
let main = model.main_table().expect("应有主表");
assert_eq!(main.table, "test_receivable");
assert_eq!(main.fields.len(), 20, "主表列数不对");
let subs = model.sub_tables();
assert_eq!(subs.len(), 1);
assert_eq!(subs[0].table, "test_details");
assert_eq!(subs[0].fields.len(), 13, "子表列数不对");
// 联合主键:F_Id + f_tenant_id(官方所有业务表都这样)
assert_eq!(main.primary_keys(), vec!["f_id", "f_tenant_id"]);
}
/// 表单 ↔ 模型在设计稿层面自洽:不报 error。
#[test]
fn real_form_and_model_are_consistent() {
let form = FormSchema::parse(&serde_json::from_str(&fixture("sample_form.json")).unwrap())
.unwrap();
let model =
ModelSchema::parse(&serde_json::from_str(&fixture("sample_model.json")).unwrap()).unwrap();
let report = validate(&form, &model);
assert!(
report.ok(),
"真实样例应通过校验,实际有 {} 个 error: {:#?}",
report.error_count(),
report
.diagnostics
.iter()
.filter(|d| d.severity == sspf_lowcode::Severity::Error)
.collect::<Vec<_>>()
);
}
/// 同构:raw 与文件内容语义完全一致(序列化后再比对,避免空白差异)。
#[test]
fn raw_is_isomorphic_to_source() {
let raw_text = fixture("sample_form.json");
let src: serde_json::Value = serde_json::from_str(&raw_text).unwrap();
let form = FormSchema::parse(&src).unwrap();
assert_eq!(
form.raw, src,
"raw 必须原样保留 —— 保存时写回的就是它,任何改动都可能让前端白屏"
);
let mraw = fixture("sample_model.json");
let msrc: serde_json::Value = serde_json::from_str(&mraw).unwrap();
let model = ModelSchema::parse(&msrc).unwrap();
assert_eq!(model.raw, msrc);
}
/// 🔴 把「推导 ≠ 真实列名」这条边界钉死。
///
/// `F_CreatorTime` 推导出 `f_creatortime`,但官方建表用的是 `f_creator_time`。
/// 这不是 bug,是「设计态没有 columnName 时的信息缺失」——
/// 所以本 crate **不承诺**推导结果等于数据库列名,只承诺两边用同一套推导做自洽性检查。
#[test]
fn derivation_is_not_ground_truth() {
use sspf_lowcode::v_model_to_column;
// 推导一致(本 crate 的自洽性基础)
assert_eq!(v_model_to_column("F_Room").as_deref(), Some("f_room"));
assert_eq!(
v_model_to_column("F_Company_name").as_deref(),
Some("f_company_name"),
"已含下划线的字段能推导对"
);
// 推导不一致(真实数据库用的是 f_creator_time)
assert_eq!(
v_model_to_column("F_CreatorTime").as_deref(),
Some("f_creatortime"),
"驼峰字段推导不出下划线形态 —— 这正是必须拿 information_schema 复核的原因"
);
assert_ne!(
v_model_to_column("F_CreatorTime").as_deref(),
Some("f_creator_time"),
"如果哪天这条断言挂了,说明推导规则改了 —— 全仓的列映射都要重查"
);
}
/// 未知控件在真实数据里存在吗?答案应该是否 —— 说明分类覆盖了实测在用控件。
#[test]
fn real_samples_have_no_unknown_widgets() {
let form = FormSchema::parse(&serde_json::from_str(&fixture("sample_form.json")).unwrap())
.unwrap();
let unknown = form.unknown_widgets();
assert!(
unknown.is_empty(),
"真实样例里出现未知控件说明分类表有缺口: {:?}",
unknown.iter().map(|n| &n.jnpf_key).collect::<Vec<_>>()
);
}