Files
ssw-platform/crates/sspf-lowcode/tests/real_sample.rs
T
admin 343772be42 docs(lowcode): 对齐 jnpf 运行时机制,纠正两处已实现代码的错误判断
- 新增 docs/visualdev-mechanism.md:接口契约 15 端点 / 列名规则 / 系统字段 / 自动填充 / 主子表,
  每条结论标了源码位置与复核命令
- 纠正①:列名 = lower(vModel)(VisualDevTableCre 原样写 vModel + PG toLowerCase),
  不是「剥前缀」;f_creatortime 就是真实列名,f_creator_time 属于平台表手写 DDL
- 纠正②:calculate 接收入参(create() 走 getIntValue),归入 Number,删掉 Computed 枚举
- 新增 widget::auto_fill/AutoFill:把 Java create() 的自动填充固化成可测枚举,
  并加交叉断言「被覆盖的字段不能标 acceptsInput」
- 影响:测试 344 → 346;十二闸全绿;v_model_to_column 简化为 to_lowercase
2026-10-31 12:02:15 +08:00

210 lines
8.6 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);
}
/// 🔴 列名规则与 jnpf 建表逻辑逐字对齐:**列名 = `lower(vModel)`**。
///
/// 溯源:`VisualDevTableCre.fieldList()` 里 `setField(vModel)` 原样写,
/// 同文件 `tableList()` 里 PG ⇒ `isLowerCase = true` ⇒ `toLowerCase()`。
///
/// 所以 `F_CreatorTime` 的**真实列名就是 `f_creatortime`** ——
/// 不存在 `f_creator_time`(那是**平台表**手写 DDL 的命名,与低代码表无关)。
#[test]
fn column_name_equals_lowercase_vmodel() {
use sspf_lowcode::v_model_to_column;
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"),
"本身就带下划线的,原样保留"
);
assert_eq!(
v_model_to_column("F_CreatorTime").as_deref(),
Some("f_creatortime"),
"驼峰**不拆**:jnpf 原样写 vModel,PG 只折叠大小写"
);
assert_ne!(
v_model_to_column("F_CreatorTime").as_deref(),
Some("f_creator_time"),
"如果哪天这条挂了,说明有人加了驼峰拆分的自作聪明 —— 那会和 jnpf 建出来的表对不上"
);
// 平台表的 `f_creator_time` 与本函数无关(手写 DDL,不经过 vModel)
assert_eq!(v_model_to_column("f_tenant_id").as_deref(), Some("f_tenant_id"));
assert_eq!(v_model_to_column("F_").as_deref(), None, "纯前缀不算列名");
}
/// 未知控件在真实数据里存在吗?答案应该是否 —— 说明分类覆盖了实测在用控件。
#[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<_>>()
);
}