- 新增 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
210 lines
8.6 KiB
Rust
210 lines
8.6 KiB
Rust
//! 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<_>>()
|
||
);
|
||
}
|