#!/usr/bin/env bash # ============================================================================ # lowcode-smoke —— 低代码元数据引擎的契约尺子(P2-a) # # 验证什么: # L1 真实样例(官方初始化数据里的「应收费用」表单)能解析:主表 6 字段 / 子表 8 字段 # L2 form.validate 对真实样例报 0 error(设计稿自洽) # L3 同构:describe 的字段顺序与 JSON 原样一致 # L4 form.list 在空库上可用(0 条不算失败) # L5 inline 模式缺 tablesData ⇒ MISSING_ARG(不许静默只校验一半) # L6 🔴 反自证:故意改坏一个 __vModel__ ⇒ 必须报 COLUMN_NOT_IN_TABLE # L7 🔴 反自证:故意塞一个未知控件 ⇒ 必须报 warn 且 ok 仍为 true # L8 子表字段的 tableName 陷阱:子表 8 个字段自身的 tableName 全部不是子表名 # # 建表 DDL 规则(P2-b,用 schema.table.create 的 inline 演练 -- 不碰库): # L9 类型映射:varchar/int/bigint/decimal/datetime/bool ⇒ PG 类型 + 回写视图类型 + dataLength # L10 复合主键:PRIMARY KEY (f_id, f_tenant_id) # L11 逻辑删除列:f_delete_mark(INTEGER) / f_delete_time(timestamp) / f_delete_user_id(varchar) # L12 系统列视图类型:f_version/f_flow_state/f_delete_mark⇒int;租户/流程/删除人⇒varchar;删除时间⇒datetime # L13 🔴 反自证:logicalDelete=false ⇒ **不加**删除列(不是无条件加) # L14 🔴 反自证:inline + dryRun=false ⇒ INLINE_REQUIRES_DRY_RUN(演练不许悄悄落库) # # L6 / L7 / L13 / L14 是「尺子自己会不会骗人」的证明 —— 没有它们, # 一把永远返回 ok=true 的尺子和「校验真的работает」看起来一模一样。 # # 用法: bash scripts/lowcode-smoke.sh # 退出码: 0 全过 / 1 有 ❌ # ============================================================================ set -u ROOT="$(cd "$(dirname "$0")/.." && pwd)" cd "$ROOT" || exit 1 BIN="$ROOT/target/debug/ssw-platform" [ -x "$BIN" ] || BIN="$ROOT/target/release/ssw-platform" FIX="$ROOT/crates/sspf-lowcode/tests/fixtures" if [ ! -x "$BIN" ]; then echo "❌ 找不到 ssw-platform 二进制(先 cargo build)" exit 1 fi if [ ! -f "$FIX/sample_form.json" ] || [ ! -f "$FIX/sample_model.json" ]; then echo "❌ 缺 fixture:$FIX/sample_form.json / sample_model.json" exit 1 fi TMP="$(mktemp -d /tmp/lowcode-smoke.XXXXXX)" || exit 1 trap 'rm -rf "$TMP"' EXIT # ---- 生成请求(含两条「改坏」的变体)---- python3 - "$FIX" "$TMP/req.ndjson" <<'PY' import json, sys, os, copy fix, out = sys.argv[1], sys.argv[2] form = json.load(open(os.path.join(fix, "sample_form.json"), encoding="utf-8")) tables = json.load(open(os.path.join(fix, "sample_model.json"), encoding="utf-8")) # 变体 A:把一个主表字段改成模型里不存在的名字 ⇒ 应报 COLUMN_NOT_IN_TABLE bad_field = copy.deepcopy(form) for f in bad_field["fields"]: if f.get("__vModel__") == "F_Room": f["__vModel__"] = "F_GhostColumn" break # 变体 B:塞一个未知控件 ⇒ 应报 warn,但 ok 仍为 true bad_widget = copy.deepcopy(form) bad_widget["fields"].append({ "__config__": {"jnpfKey": "futureWidgetXyz", "layout": "colFormItem", "label": "未来控件", "tableName": "test_receivable"}, "__vModel__": "F_Room", # 复用已有列,确保只有「未知控件」这一条诊断 }) # ---- 建表规则专用的设计稿(inline 演练:不碰库、不依赖 seed)---- # 覆盖 6 种标量类型;系统列刻意**不给**(验证平台会自动补齐)。 ddl_model = [{ "table": "t_ddl_rules", "tableName": "建表规则", "typeId": "1", "fields": [ {"field": "F_Id", "dataType": "varchar", "dataLength": "50", "primaryKey": 1, "allowNull": 0}, {"field": "F_Name", "dataType": "varchar", "dataLength": "100", "allowNull": 1}, {"field": "F_Num", "dataType": "int", "allowNull": 1}, {"field": "F_Big", "dataType": "bigint", "allowNull": 1}, {"field": "F_Amt", "dataType": "decimal", "dataLength": "18,2", "allowNull": 1}, {"field": "F_Time", "dataType": "datetime", "allowNull": 1}, {"field": "F_Flag", "dataType": "bool", "allowNull": 1}, ], }] def ddl_form(logical_delete): return {"formRef": "formRef", "formModel": "formData", "primaryKeyPolicy": 1, "logicalDelete": logical_delete, "fields": []} def create_req(i, frm, dry=None): args = {"formData": json.dumps(frm, ensure_ascii=False), "tablesData": json.dumps(ddl_model, ensure_ascii=False)} if dry is not None: args["dryRun"] = dry return {"jsonrpc": "2.0", "id": i, "method": "tools/call", "params": {"name": "sspf_call", "arguments": {"tool_id": "schema.table.create", "args": args}}} reqs = [ {"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {}}, {"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "sspf_call", "arguments": { "tool_id": "form.validate", "args": {"formData": json.dumps(form, ensure_ascii=False), "tablesData": json.dumps(tables, ensure_ascii=False)}}}}, {"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "sspf_call", "arguments": { "tool_id": "form.describe", "args": {"formData": json.dumps(form, ensure_ascii=False)}}}}, {"jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": {"name": "sspf_call", "arguments": { "tool_id": "form.list", "args": {}}}}, {"jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": {"name": "sspf_call", "arguments": { "tool_id": "form.validate", "args": {"formData": json.dumps(form, ensure_ascii=False)}}}}, {"jsonrpc": "2.0", "id": 6, "method": "tools/call", "params": {"name": "sspf_call", "arguments": { "tool_id": "form.validate", "args": {"formData": json.dumps(bad_field, ensure_ascii=False), "tablesData": json.dumps(tables, ensure_ascii=False)}}}}, {"jsonrpc": "2.0", "id": 7, "method": "tools/call", "params": {"name": "sspf_call", "arguments": { "tool_id": "form.validate", "args": {"formData": json.dumps(bad_widget, ensure_ascii=False), "tablesData": json.dumps(tables, ensure_ascii=False)}}}}, # ---- 建表 DDL 规则(P2-b)---- create_req(8, ddl_form(True)), # logicalDelete=true ⇒ 应有删除列 create_req(9, ddl_form(False)), # logicalDelete=false ⇒ 不该有删除列 create_req(10, ddl_form(True), dry=False), # 反自证:inline 不许落库 ] with open(out, "w", encoding="utf-8") as f: for r in reqs: f.write(json.dumps(r, ensure_ascii=False) + "\n") PY # ---- 跑一次(临时库,不碰开发数据)---- PGLITE_DIR="$TMP/db" "$BIN" --mcp < "$TMP/req.ndjson" > "$TMP/out.ndjson" 2> "$TMP/err.log" if [ ! -s "$TMP/out.ndjson" ]; then echo "❌ 没有输出;stderr:" grep -vE "stand-alone|^backend>|LOG:" "$TMP/err.log" | head -5 exit 1 fi # ---- 断言 ---- python3 - "$TMP/out.ndjson" <<'PY' import json, sys rows = {} for line in open(sys.argv[1], encoding="utf-8"): if line.strip(): m = json.loads(line) rows[m.get("id")] = m PASS = [0] FAIL = [0] def ok(msg): PASS[0] += 1 print(f"✅ {msg}") def bad(msg): FAIL[0] += 1 print(f"❌ {msg}") def payload(i): return (rows.get(i, {}).get("result") or {}).get("structuredContent", {}) def data(i): return payload(i).get("data", {}) def codes(i): return [d.get("code") for d in (data(i).get("diagnostics") or [])] # L1 / L2 真实样例 d2 = data(2) if d2.get("ok") is True and d2.get("errorCount") == 0: ok(f"L1 真实样例校验通过(0 error / {d2.get('warnCount')} warn)") else: bad(f"L1 真实样例应 0 error,实际 {d2.get('errorCount')}:{codes(2)}") d3 = data(3) main = d3.get("mainFields") or [] subs = d3.get("subTables") or [] if len(main) == 6 and len(subs) == 1 and len(subs[0].get("fields") or []) == 8: ok(f"L2 form.describe 结构正确(主表 {len(main)} 字段 / 子表 {len(subs[0]['fields'])} 字段)") else: bad(f"L2 结构不对:主表 {len(main)} / 子表 {[len(s.get('fields') or []) for s in subs]}") # L3 同构:字段顺序与原文一致 expect = ["F_Building", "F_Room", "F_Company_name", "F_Userid", "F_Phone", "F_Ost"] got = [f.get("vModel") for f in main] if got == expect: ok("L3 字段顺序与 JSON 原样一致(同构,没有重排)") else: bad(f"L3 字段顺序被改了:{got}") # L4 空库 form.list p4 = payload(4) if p4.get("ok") is True and isinstance(p4.get("data", {}).get("forms"), list): ok(f"L4 form.list 可用(空库 {p4['data'].get('count', 0)} 条,不算失败)") else: bad(f"L4 form.list 失败: {json.dumps(p4, ensure_ascii=False)[:150]}") # L5 缺 tablesData p5 = payload(5) if p5.get("ok") is False and p5.get("error", {}).get("code") == "MISSING_ARG": ok("L5 inline 模式缺 tablesData ⇒ MISSING_ARG(不静默只校验一半)") else: bad(f"L5 缺参未被拦: {json.dumps(p5, ensure_ascii=False)[:150]}") # L6 🔴 反自证:改坏字段必须被抓到 d6 = data(6) # 🔴 注意 `ok` 有两层:外层是 sspf_call 是否调用成功,data.ok 才是校验结论 if d6.get("ok") is False and "COLUMN_NOT_IN_TABLE" in codes(6): diag = [d for d in d6["diagnostics"] if d["code"] == "COLUMN_NOT_IN_TABLE"][0] if "f_title" in diag.get("message", "") or "f_building" in diag.get("message", ""): ok("L6 反自证:改坏一个 __vModel__ ⇒ COLUMN_NOT_IN_TABLE,且列出了现有列") else: ok("L6 反自证:改坏一个 __vModel__ ⇒ COLUMN_NOT_IN_TABLE") else: bad(f"L6 🔴 校验没抓到坏字段 —— 这把尺子是假的: {codes(6)}") # L7 🔴 反自证:未知控件是 warn 不是 error d7 = data(7) if "UNKNOWN_WIDGET" in codes(7) and d7.get("warnCount", 0) >= 1: if d7.get("ok") is True: ok("L7 反自证:未知控件 ⇒ warn 且 ok 仍为 true(降级不阻断)") else: bad("L7 未知控件不该让 ok=false(会逼得新控件表单完全不可用)") else: bad(f"L7 未知控件没被报出来: {codes(7)}") # L8 子表 tableName 陷阱 script = json.dumps(d3, ensure_ascii=False) if "test_details" in script: ok("L8 子表归属取父节点 tableName(test_details),子表内字段自身的 tableName 不可信") else: bad("L8 子表 tableName 丢了") # ============ 建表 DDL 规则(P2-b,inline 演练)============ def ddl_text(i): return "\n".join((data(i) or {}).get("ddl") or []) def ddl_cols(i): out = {} for line in ddl_text(i).splitlines(): s = line.strip().rstrip(",") if not s or s.upper().startswith(("CREATE TABLE", "PRIMARY KEY", ")")): continue out[s.split()[0].lower()] = s return out def view_types(i): out = {} for t in (data(i) or {}).get("model") or []: for f in t.get("fields") or []: out[f.get("field", "").lower()] = (f.get("dataType"), f.get("dataLength")) return out c8 = ddl_cols(8) ddl8 = ddl_text(8) v8 = view_types(8) # L9 类型映射(PG 类型) want_cols = { "f_name": "f_name VARCHAR(100)", "f_num": "f_num INTEGER", "f_big": "f_big BIGINT", "f_amt": "f_amt DECIMAL(18, 2)", "f_flag": "f_flag BOOLEAN", } missing = [f"{k}→{v}" for k, v in want_cols.items() if c8.get(k) != v] if not missing and c8.get("f_time", "").startswith("f_time TIMESTAMP(0)"): ok("L9 类型映射正确(varchar→VARCHAR(100) / int / bigint / decimal(18,2) / datetime / bool)") else: bad(f"L9 类型映射不对:{missing};f_time={c8.get('f_time')}") # L9b 回写模型的视图类型 + dataLength(只有 varchar/decimal 带长度) want_view = { "f_name": ("varchar", "100"), "f_num": ("int", None), "f_big": ("bigint", None), "f_amt": ("decimal", "18,2"), "f_time": ("datetime", None), "f_flag": ("bool", None), } wrong = {k: v8.get(k) for k, v in want_view.items() if v8.get(k) != v} if not wrong: ok("L9b 回写模型视图类型/dataLength 正确(int/bigint/datetime/bool 的长度为 null)") else: bad(f"L9b 回写视图类型不对:{wrong}") # L10 复合主键 if "PRIMARY KEY (f_id, f_tenant_id)" in ddl8: ok("L10 复合主键 (f_id, f_tenant_id) —— 与官方 DDL 一致(单租户也不省这一列)") else: bad(f"L10 复合主键不对:{ [l for l in ddl8.splitlines() if 'PRIMARY KEY' in l] }") # L11 逻辑删除三列 del_cols_ok = ( c8.get("f_delete_mark") == "f_delete_mark INTEGER" and c8.get("f_delete_time", "").startswith("f_delete_time TIMESTAMP") and c8.get("f_delete_user_id") == "f_delete_user_id VARCHAR(50)" ) if del_cols_ok: ok("L11 逻辑删除列齐备(f_delete_mark INTEGER / f_delete_time / f_delete_user_id)") else: bad(f"L11 删除列不对:{ {k: c8.get(k) for k in ('f_delete_mark','f_delete_time','f_delete_user_id')} }") # L12 系统列视图类型(官方 DtViewConst 口径) want_sys = { "f_version": "int", "f_flow_state": "int", "f_delete_mark": "int", "f_tenant_id": "varchar", "f_flow_id": "varchar", "f_flow_task_id": "varchar", "f_delete_user_id": "varchar", "f_delete_time": "datetime", } bad_sys = {k: v8.get(k) for k, v in want_sys.items() if (v8.get(k) or (None, None))[0] != v} if not bad_sys: ok(f"L12 系统列视图类型正确({len(want_sys)} 列:int×3 / varchar×4 / datetime×1)") else: bad(f"L12 系统列视图类型不对:{bad_sys}") # L13 🔴 反自证:logicalDelete=false ⇒ 不追加删除列 leaked = [k for k in ddl_cols(9) if k.startswith("f_delete_")] if not leaked: ok("L13 反自证:logicalDelete=false ⇒ 不追加删除列(不是无条件加)") else: bad(f"L13 没开逻辑删除却建了删除列:{leaked}") # L14 🔴 反自证:inline + dryRun=false 必须被拒 p10 = payload(10) if p10.get("ok") is False and p10.get("error", {}).get("code") == "INLINE_REQUIRES_DRY_RUN": ok("L14 反自证:inline + dryRun=false ⇒ INLINE_REQUIRES_DRY_RUN(演练不许悄悄落库)") else: bad(f"L14 inline 落库没被拒: {json.dumps(p10, ensure_ascii=False)[:150]}") print() print(f"PASS={PASS[0]} FAIL={FAIL[0]}") sys.exit(1 if FAIL[0] else 0) PY RC=$? echo if [ "$RC" -ne 0 ]; then echo "❌ lowcode-smoke 有失败项(见上)" exit 1 fi echo "✅ lowcode-smoke 全过"