refactor(arch): M5 低代码执行层下沉 —— 4 模块 / 2,674 行迁入 sspf-lowcode-exec

把 src/backend/src/lowcode_{crud,ddl,check,seed}.rs 下沉到 crates/sspf-lowcode-exec/,
原路径全部变成 5 行转发壳 ⇒ CLI(--seed-lowcode-demo)与 MCP 适配器的调用路径零感知。

与 sspf-lowcode 的分工不变:前者纯计算(AR7 白名单不动),本 crate 是执行层
(连库 / 跑 SQL / 比对真实库列 / 事务 / 回写模型)。

依赖:sspf-lowcode + sspf-core + sspf-store + sspf-mcp + pglite-rs + chrono + serde_json
(比原计划多三个:pglite::ToSql/Error 是直接用的、now_iso() 用 chrono::Local::now()、JSON payload)

闸门改造:
- check-arch.sh 新增 AR13(两层:依赖白名单 + 源码不许 use sspf_pack_*)
- check-arch.sh 反自证 7→8(两处都注入:越界依赖 axum + 业务包引用,按路径分别验)
- check-boundary.sh 新增 LOWCODE_EXEC ⇒ CP1/CP2 纳入执行层真源
  (反向验证:插 LEAK_PROBE ⇒ CP1 报红;还原后 11/11)
- check-contract-scan.py 不用改 —— 契约里零 lowcode 端点(低代码是 MCP 工具不是 HTTP 路由)

🔴 踩坑:改写时把 use crate::lowcode_ddl; 一并改成 use crate::ddl; ⇒ 编译不过。
教训:搬 crate 只改跨 crate 的前缀(crate::platform:: → sspf_core::),
模块名一律不动;文档内链([`crate::lowcode_crud`])也不能跟着改(改了就变死链)。

数字:cargo build 零警告;cargo test 695/0(与 M1 基线完全一致);
check-arch 17/17;--self-test 8/8;check-boundary 11/11;check-contract 10/10;
check-module 123/123;check-citations 4/4;check-naming 3/0/1;
verify.sh --smoke 14 步全绿(377.6s)
This commit is contained in:
admin committed 2026-11-03 20:12:50 +08:00
1 parent e821770f58
commit 98b93967da
18 files changed
+3006 -2698

No files matched your search

+82 -7
View File
@@ -394,6 +394,47 @@ check_ar12() {
fi
}
# ---------------------------------------------------------------- AR13
# **低代码执行层的依赖白名单**(M5 把 `lowcode_*.rs` 下沉到 `sspf-lowcode-exec`)。
#
# 🔴 **为什么需要**:`sspf-lowcode`(AR7)是**纯计算**层 —— 只认 serde,不许碰 DB/HTTP。
# M5 新增的 `sspf-lowcode-exec` 是它的**执行层**,允许连库;但依赖面必须**锁死**:
# 一旦它拖进 `axum`(web 框架)⇒ 这层就再也用不了 CLI / MCP / 离线工具;
# 一旦它拖进 `sspf_pack_*`(业务包)⇒ 平台层开始认识业务 ⇒ 破 AR9。
#
# 判据(两层):
# ① `crates/sspf-lowcode-exec/Cargo.toml` 的依赖 ⊆ 白名单;
# ② 该 crate 的源码里**不许**出现 `sspf_pack_`(与 AR9 同款语义,但独立钉住
# —— AR9 只扫平台层目录,执行层是新的目录,得单独管)。
check_ar13() {
local f="$CRATES/sspf-lowcode-exec/Cargo.toml"
if [ ! -f "$f" ]; then
skip "AR13 sspf-lowcode-exec 不存在"
return
fi
local deps; deps="$(deps_of "$f" | tr '\n' ' ')"
# 🔴 白名单:`sspf-lowcode`(纯计算)+ `sspf-core`(平台核心)+ `sspf-store`(Db 真源)
# + `sspf-mcp`(ToolError)+ `pglite-rs`(真实库)+ `chrono` + `serde_json`。
# **不许** axum(web 框架)/ tokio(异步运行时,本层是同步函数 + 调用方 await)。
if subset_of "$deps" "sspf-lowcode sspf-core sspf-store sspf-mcp pglite-rs chrono serde_json"; then
ok "AR13 sspf-lowcode-exec 依赖干净([$deps])"
else
bad "AR13 sspf-lowcode-exec 依赖越界:[$deps] —— 只许 {lowcode, core, store, mcp, pglite-rs, chrono, serde_json},不许 web 框架 / 业务包"
fi
# 第二层:源码不许出现业务包引用
local src="$CRATES/sspf-lowcode-exec/src"
if [ -d "$src" ]; then
local hits
hits="$(grep -rnE '^[[:space:]]*(pub )?use[[:space:]]+sspf_pack_' "$src" 2>/dev/null || true)"
if [ -z "$hits" ]; then
ok "AR13 执行层源码没有 use sspf_pack_*(业务知识没漏进执行层)"
else
bad "AR13 执行层源码出现了业务包引用(业务知识漏进平台层):"
printf '%s\n' "$hits" | sed 's/^/ /'
fi
fi
}
# ---------------------------------------------------------------- PACK1
# **spec 单一真源**:`modules/<app>.rs` 只许做转发,不许自己写 spec。
#
@@ -527,7 +568,7 @@ PY
self_test() {
local rc=0
echo "── 反自证 1/7:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
echo "── 反自证 1/8:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
local tmp="$ROOT/packs/__arch_selftest__"
mkdir -p "$tmp"
cat > "$tmp/Cargo.toml" <<'TOML'
@@ -553,7 +594,7 @@ TOML
rc=1
fi
echo "── 反自证 2/7:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
echo "── 反自证 2/8:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
#
# 🔴 **为什么必须自证 AR9**:它的判据是 `grep 目录`。
# 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"**。
@@ -591,7 +632,7 @@ TOML
rc=1
fi
echo "── 反自证 3/7:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
echo "── 反自证 3/8:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
#
# 🔴 造在**临时模块文件**上(不动真文件):只要它同时有 `pub use sspf_pack_`
# 和 `= EntitySpec {`,PACK1 就必须红。
@@ -617,7 +658,7 @@ RS
echo "⏭ 跳过 PACK1 反自证(业务模块目录不存在)"
fi
echo "── 反自证 4/7:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
echo "── 反自证 4/8:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
local pfile="$CRATES/sspf-plugin/Cargo.toml"
if [ -f "$pfile" ]; then
cp "$pfile" "$pfile.bak"
@@ -638,7 +679,7 @@ RS
echo "⏭ 跳过 AR8 反自证(sspf-plugin 不存在)"
fi
echo "── 反自证 5/7:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
echo "── 反自证 5/8:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
#
# 🔴 **必须自证 AR10**:它的判据是「扫平台层目录找契约面引用」。
# 目录名写错 / 路径拼错 ⇒ 扫描永远返回空 ⇒ **永远"通过"** ⇒ 虚假安全感。
@@ -671,7 +712,7 @@ RS
rc=1
fi
echo "── 反自证 6/7:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
echo "── 反自证 6/8:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
#
# 🔴 **M3 起底座有两处**:真源 `crates/sspf-compat-core/src/helper.rs`(实现)
# + 转发壳 `src/backend/src/platform/compat/helper.rs`。**两处都注入、
@@ -698,7 +739,7 @@ RS
rc=1
fi
echo "── 反自证 7/7:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──"
echo "── 反自证 7/8:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──"
#
# 🔴 **为什么必须自证 AR12**:它的判据是「读 Cargo.toml 找 sspf-compat-* 依赖」。
# 若 grep 模式写错(包名含连字符/下划线混用)⇒ 永远扫不到依赖 ⇒
@@ -725,6 +766,39 @@ RS
rc=1
fi
echo "── 反自证 8/8:给执行层塞一个越界依赖 + 一条业务包引用,AR13 必须报 ❌ ──"
#
# 🔴 **必须自证 AR13**:它的判据是「读 Cargo.toml + grep 源码」。
# 两种失效模式都得堵:
# ① 依赖白名单写错/漏项 ⇒ 越界依赖进得来(执行层拖进 web 框架 ⇒ CLI/MCP 报废);
# ② 源码 grep 路径写错 ⇒ 业务包引用扫不到(平台层开始认识业务 ⇒ 破 AR9)。
# 🔴 **两处都注入、两处都被抓到**才算尺子有效(单点注入会漏判)。
local a13ok=0
local a13toml="$CRATES/sspf-lowcode-exec/Cargo.toml"
local a13src="$CRATES/sspf-lowcode-exec/src/__ar13_selftest.rs"
local a13need=0 a13c=0 a13out
if [ -f "$a13toml" ]; then
cp "$a13toml" "$a13toml.bak"
printf '\naxum = { workspace = true }\n' >> "$a13toml"
a13need=$((a13need+1))
printf 'use sspf_pack_asset::DATA_RESOURCE_SPEC;\n' > "$a13src"
a13need=$((a13need+1))
a13out="$(check_ar13 2>&1 || true)"
[ -f "$a13toml.bak" ] && mv "$a13toml.bak" "$a13toml"
rm -f "$a13src"
# ① 越界依赖(axum)必须被依赖白名单抓到
echo "$a13out" | grep -q "依赖越界" && a13c=$((a13c+1))
# ② 业务包引用必须被源码层抓到,且**路径明确**(不能只看到"有输出")
echo "$a13out" | grep -q "sspf-lowcode-exec/src/__ar13_selftest" && a13c=$((a13c+1))
[ "$a13need" -gt 0 ] && [ "$a13c" -ge "$a13need" ] && a13ok=1
fi
if [ "$a13ok" -eq 1 ]; then
echo "✅ 反自证通过:AR13 抓到了越界依赖(axum)与执行层里的业务包引用"
else
echo "❌ 反自证失败:AR13 没抓到越界依赖 / 业务包引用(或漏扫了其中一处)⇒ 尺子是假的"
rc=1
fi
return $rc
}
@@ -744,6 +818,7 @@ check_ar9
check_ar10
check_ar11
check_ar12
check_ar13
check_pack1
check_mem1
check_mem2
+9 -5
View File
@@ -49,6 +49,10 @@ COMPAT_DIRS=()
for d in "$ROOT"/crates/sspf-compat-*/src; do
[ -d "$d" ] && COMPAT_DIRS+=("$d")
done
# 🔴 **M5 起低代码执行层真源在 `crates/sspf-lowcode-exec/src/`**——
# 它也是「平台侧」(连库 / 跑 SQL / 校验),业务标识符泄漏同样要查。
# ⇒ 放进 CP1/CP2 的扫描范围(与契约面同款纪律)。
LOWCODE_EXEC="$ROOT/crates/sspf-lowcode-exec/src"
MODULES="$SRC/modules"
MODULES_MOD="$MODULES/mod.rs"
BOOTSTRAP="$SRC/bootstrap.rs"
@@ -122,7 +126,7 @@ hdr "[CP1] 平台层零业务标识符(扫字符串字面量;禁止清单从
# + `packs/*/src/lib.rs`(业务包)⇒ 两处都要进「禁止清单」,
# 否则包里的业务表名会从清单里消失 ⇒ 尺子变弱。
# 🔴 **M2 起平台层真源在 `crates/sspf-core/src/`** ⇒ 它必须进扫描面(否则扫空壳)。
SCAN_OUT="$(SSW_PACKS_DIR="${ROOT}/packs" "${PY_BIN}" "${SCAN}" "${MODULES}" "${PLATFORM_CORE}" "${PLATFORM}" ${COMPAT_DIRS[@]+"${COMPAT_DIRS[@]}"} "${SRC}/routes.rs" "${SRC}/main.rs" "${BOOTSTRAP}" 2>&1)"
SCAN_OUT="$(SSW_PACKS_DIR="${ROOT}/packs" "${PY_BIN}" "${SCAN}" "${MODULES}" "${PLATFORM_CORE}" "${PLATFORM}" ${COMPAT_DIRS[@]+"${COMPAT_DIRS[@]}"} ${LOWCODE_EXEC:+"${LOWCODE_EXEC}"} "${SRC}/routes.rs" "${SRC}/main.rs" "${BOOTSTRAP}" 2>&1)"
if [ "$?" -eq 0 ]; then
ok "平台层没有业务标识符($(printf '%s\n' "${SCAN_OUT}" | tail -1))"
else
@@ -131,11 +135,11 @@ else
fi
# ---- CP2 平台层不反向依赖业务层 ----
hdr "[CP2] 平台层不反向依赖业务层(sspf-core/** 与 compat 包/** 不许 use crate::modules)"
# 🔴 三处都扫:平台核心真源 + 平台转发壳 + 契约面 7 个包的真源。
CP2_HITS="$(grep -rn "use crate::modules" "${PLATFORM_CORE}" "${PLATFORM}" ${COMPAT_DIRS[@]+"${COMPAT_DIRS[@]}"} 2>/dev/null)"
hdr "[CP2] 平台层不反向依赖业务层(sspf-core/** 与 compat 包/** 与 lowcode-exec/** 不许 use crate::modules)"
# 🔴 四处都扫:平台核心真源 + 平台转发壳 + 契约面 7 个包的真源 + 低代码执行层真源(M5)。
CP2_HITS="$(grep -rn "use crate::modules" "${PLATFORM_CORE}" "${PLATFORM}" ${COMPAT_DIRS[@]+"${COMPAT_DIRS[@]}"} ${LOWCODE_EXEC:+"${LOWCODE_EXEC}"} 2>/dev/null)"
if [ -z "${CP2_HITS}" ]; then
ok "平台核心 / 转发壳 / 契约面各包 都没有 use crate::modules"
ok "平台核心 / 转发壳 / 契约面各包 / 低代码执行层 都没有 use crate::modules"
else
no "平台层引用了业务层:"
printf '%s\n' "${CP2_HITS}" | sed 's/^/ /'