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:
1 parent
e821770f58
commit
98b93967da
18 files changed
+3006
-2698
No files matched your search
+82
-7
@@ -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
|
||||
|
||||
@@ -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/^/ /'
|
||||
|
||||
Reference in new issue
Block a user