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