refactor(arch): M7 删 platform/ 转发壳 —— 壳层收口,平台能力只剩真源

- 删 src/backend/src/platform/ 下 38 个转发壳 ⇒ 平台层只有真源(在 crates/)
- 新增 src/backend/src/compat.rs 别名表(16 个域)⇒ routes.rs 的 1010 处
  compat::<域>:: 调用点零改动,风险面从 1010 处降到 1 个文件
- test_support.rs 从 platform/ 迁到壳侧根(依赖装配根 ensure_schema_all ⇒ 认识业务层)
- 全仓改写 import:crate::platform::X → sspf_core::X(44 处/9 文件);
  ssw_platform::platform::X → sspf_core::X(229 处/38 文件)
- 修 check-contract-scan.py 的 plat_key 推导:按 crate 名判定(原按路径段数猜,
  M7 拆 crate 后必然失效 ⇒ CC6 静默失效);新增 derive_plat_key + 20 条断言自证
- 新增 AR15 防旧平台路径复活(三层判据,含目录级「含 .rs 才算复活」)
- 闸门去壳路径:check-arch / check-boundary / check-module / check-contract-scan
- 文档同步:CRATES-MIGRATION / contract / HANDOFF / HOWTO_MODULE / CLAUDE.md

验证:cargo build 零警告;cargo test 695 passed / 0 failed(与 M1 基线一致);
check-arch 20/20;--self-test 10/10;check-boundary 12/12;check-contract 10/10
(反自证 12 例 + 20 条推导断言);check-module 123/123;check-citations 4/4;
check-naming 3/0/1;verify.sh --smoke 14 步全绿。

至此 M1–M7 全部完成:crates/ 17 个包,src/backend/src/ 只剩装配 + 业务层。
This commit is contained in:
admin committed 2026-11-03 22:17:34 +08:00
1 parent 210a885f79
commit 867552af37
96 files changed
+901 -633

No files matched your search

+170 -44
View File
@@ -44,6 +44,10 @@
# AR14 `crates/sspf-mcp-adapter` 依赖 ⊆ 白名单 + 源码不许 `use sspf_pack_*`
# —— M6 把 MCP 适配层下沉成独立 crate;它是「全仓唯一知道全部包的汇聚点」
# ⇒ 依赖面必须锁死,否则它会变成第二个「什么都认识」的黑洞
# AR15 旧平台路径不许复活:全仓不许 `crate::platform::` / `ssw_platform::platform::`,
# 且 `src/backend/src/platform/` 目录不许存在
# —— M7 删掉了 38 个转发壳;重建壳 + 改回 import 会**一切照常编译、测试全绿**
# ⇒ 没有这条闸门,M2–M7 的架构收益会**静默蒸发**
#
# 🔴 AR1–AR5 是 PLAN.md §3.2 的分层纪律;MEM1–MEM2 是判断 ⑥ 的四条内存红线的静态部分。
@@ -57,15 +61,19 @@ MODULES_DIR="$KERNEL/src/modules"
# 🔴 **平台侧真源目录表**(M2/M3/M4 逐步扩):
# - `sspf-core/src` 平台核心(M2)
# - `sspf-compat-*/src` 契约面 7 个包(M3 底座 + M4 六个域包)
# - `platform/` 转发壳(防塞私货)
# 🔴 **动态收集**(`crates/sspf-compat-*/src`)⇒ 新增契约面包时**不会漏扫** ——
# 写死列表必然在某次新增包时漏掉 ⇒ 尺子静默失效(实测踩过)。
# 🔴🔴 **M7 起:`src/backend/src/platform/` 已删除**(38 个转发壳全部清空)⇒
# 平台层**只有真源**,没有壳 ⇒ 扫描面里**不再有**转发壳目录。
# ⇒ 旧路径(`crate::platform::…` / `ssw_platform::platform::…`)**必须**由
# **AR15** 单独钉住(见下)—— 否则删壳之后旧路径无人看管,
# 哪天有人写回 `crate::platform::sys::` ⇒ 编译不过(好的),
# 但若同时又建了个壳目录 ⇒ 就等于**复活了被删掉的架构**(坏的)。
PLAT_SRC_DIRS=()
[ -d "$CRATES/sspf-core/src" ] && PLAT_SRC_DIRS+=("$CRATES/sspf-core/src")
for d in "$CRATES"/sspf-compat-*/src; do
[ -d "$d" ] && PLAT_SRC_DIRS+=("$d")
done
[ -d "$KERNEL/src/platform" ] && PLAT_SRC_DIRS+=("$KERNEL/src/platform")
PASS=0
FAIL=0
@@ -324,10 +332,14 @@ PY
check_ar11() {
local files=()
[ -f "$CRATES/sspf-compat-core/src/helper.rs" ] && files+=("$CRATES/sspf-compat-core/src/helper.rs")
[ -f "$KERNEL/src/platform/compat/helper.rs" ] && files+=("$KERNEL/src/platform/compat/helper.rs")
local hits=""
if [ "${#files[@]}" -gt 0 ]; then
hits="$(grep -nE '^[[:space:]]*(pub )?use[[:space:]]+(super::[a-z_]+|crate::res)' "${files[@]}" 2>/dev/null \
# 🔴🔴 **必须用 `-H`(强制输出文件名前缀)** —— M7 起文件只有一个,
# `grep -n` 只输出「行号:内容」⇒ **不含路径** ⇒ 反自证里
# `grep -q "sspf-compat-core/src/helper.rs"` **永远匹配不到**
# ⇒ 尺子明明抓到了违规,自证却报「尺子是假的」(实测踩过)。
# ⇒ `-H` 保证路径在场,反自证才能**按路径**精确验证。
hits="$(grep -HnE '^[[:space:]]*(pub )?use[[:space:]]+(super::[a-z_]+|crate::res)' "${files[@]}" 2>/dev/null \
| grep -vE 'super::helper|crate::helper' || true)"
fi
# 跨 crate 形态:底座的 Cargo.toml 不许依赖 6 个契约面包
@@ -487,6 +499,81 @@ check_ar14() {
fi
}
# ---------------------------------------------------------------- AR15
# **M7 删壳后:旧平台路径不许复活**(`crate::platform::…` / `ssw_platform::platform::…`)。
#
# 🔴 **为什么需要**:M7 把 `src/backend/src/platform/` 的 38 个转发壳**全删了**,
# 平台能力的路径变成 `sspf_core::…` / `sspf_compat_<包>::…`。
# 删除本身是**可逆的**(git 一 revert 就回来了)⇒ 必须有闸门钉住「不许回来」。
#
# 🔴 **为什么这条不能靠「编译不过」兜底**:如果有人为了图省事
# ① 重建 `src/backend/src/platform/mod.rs` + 几个 `pub use` 壳,
# ② 把 import 改回 `crate::platform::…`,
# ⇒ **一切照常编译、测试照常全绿**,但架构**已经退回 M2 之前** ——
# 而 M2–M7 这 7 个批次(几万行搬迁、6 个契约面包)的收益**全部蒸发**,
# 而且**没有任何闸门会报红**。⇒ 这正是本仓最怕的那类静默退化。
#
# 🔴 **判据**(源码级,全仓 Rust 文件):
# ① 不许出现 `crate::platform::`(壳内引用旧路径);
# ② 不许出现 `ssw_platform::platform::`(集成测试引用旧路径);
# ③ 不许存在 `src/backend/src/platform/` 目录(M7 的删除不被回退)。
#
# 🔴 **注释不算违规** —— 文档里提到旧路径是**正常**的(迁移记录 / 历史说明)。
# ⇒ 只判**非注释行**(与 AR10 同一套路)。
check_ar15() {
local hits=""
local roots=()
[ -d "$KERNEL/src" ] && roots+=("$KERNEL/src")
[ -d "$KERNEL/tests" ] && roots+=("$KERNEL/tests")
[ -d "$CRATES" ] && roots+=("$CRATES")
[ -d "$ROOT/packs" ] && roots+=("$ROOT/packs")
if [ "${#roots[@]}" -gt 0 ]; then
hits="$(python3 - "${roots[@]}" <<'PY'
import os, re, sys
pat = re.compile(r'(crate::platform::|ssw_platform::platform::)')
bad = []
for root in sys.argv[1:]:
for dirpath, dirnames, files in os.walk(root):
for fn in files:
if not fn.endswith('.rs'):
continue
p = os.path.join(dirpath, fn)
try:
lines = open(p, encoding='utf-8').read().splitlines()
except OSError:
continue
for i, line in enumerate(lines, 1):
s = line.strip()
if s.startswith('//'):
continue # 整行注释(含 //! / ///)
code = line.split('//', 1)[0]
if pat.search(code):
bad.append(f'{p}:{i}: {s}')
for b in bad:
print(b)
PY
)"
fi
# 🔴 第三层:旧目录本身不许复活。
# ⚠️ **只看「含 .rs 文件」** —— git **不跟踪空目录** ⇒ 自证里
# `mkdir -p` 出来的空目录在清理后可能残留(rmdir 失败)⇒
# 若按「目录存在」判 ⇒ 假红(报了一个不存在的违规)。
# ⇒ 判据 = 「目录里**有** .rs 文件」= 真的有壳被重建了。
if [ -d "$KERNEL/src/platform" ]; then
local plat_rs
plat_rs="$(find "$KERNEL/src/platform" -name '*.rs' -type f 2>/dev/null | head -1)"
if [ -n "$plat_rs" ]; then
hits="${hits:+$hits$'\n'}$KERNEL/src/platform: 目录复活(M7 已删除该转发壳层,发现 ${plat_rs})"
fi
fi
if [ -z "$hits" ]; then
ok "AR15 旧平台路径未复活(无 crate::platform:: / ssw_platform::platform:: / platform/ 目录)"
else
bad "AR15 旧平台路径复活(M7 已删转发壳层 ⇒ 平台能力只能走 sspf_core:: / sspf_compat_*/::):"
printf '%s\n' "$hits" | sed 's/^/ /'
fi
}
# ---------------------------------------------------------------- PACK1
# **spec 单一真源**:`modules/<app>.rs` 只许做转发,不许自己写 spec。
#
@@ -620,7 +707,7 @@ PY
self_test() {
local rc=0
echo "── 反自证 1/9:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
echo "── 反自证 1/10:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
local tmp="$ROOT/packs/__arch_selftest__"
mkdir -p "$tmp"
cat > "$tmp/Cargo.toml" <<'TOML'
@@ -646,24 +733,25 @@ TOML
rc=1
fi
echo "── 反自证 2/9:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
echo "── 反自证 2/10:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
#
# 🔴 **为什么必须自证 AR9**:它的判据是 `grep 目录`。
# 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"**。
# 这类尺子比没有更危险(它给出虚假的安全感)。
# 🔴 **M2 起必须注入两处**:真源 `crates/sspf-core/src/`(实现所在)
# + 转发壳 `src/backend/src/platform/`。**只注入一处不够** ——
# 若闸门只扫壳不扫真源(或反之),单点注入会漏判 ⇒ 两处都注入、
# 🔴🔴 **M7 起:平台层**只有真源**(`src/backend/src/platform/` 的 38 个转发壳已删)
# ⇒ 注入点只剩真源一处。但**契约面各包也要注入**(AR9 扫的是整个
# `PLAT_SRC_DIRS`,含 `sspf-compat-*/src`)—— 只注入 core 不注入 compat
# ⇒ 单点注入会漏判「闸门只扫 core 不扫 compat」⇒ **两处都注入**、
# 且**两处都被抓到**才算尺子有效。
local a9core="$CRATES/sspf-core/src/__ar9_selftest.rs"
local a9shell="$KERNEL/src/platform/__ar9_selftest.rs"
local a9compat="$CRATES/sspf-compat-system/src/__ar9_selftest.rs"
local a9ok=0
if [ -d "$CRATES/sspf-core/src" ] || [ -d "$KERNEL/src/platform" ]; then
if [ -d "$CRATES/sspf-core/src" ] || [ -d "$CRATES/sspf-compat-system/src" ]; then
[ -d "$CRATES/sspf-core/src" ] && printf 'use sspf_pack_asset::DATA_RESOURCE_SPEC;\n' > "$a9core"
[ -d "$KERNEL/src/platform" ] && printf 'use sspf_pack_asset::DATA_RESOURCE_SPEC;\n' > "$a9shell"
[ -d "$CRATES/sspf-compat-system/src" ] && printf 'use sspf_pack_asset::DATA_RESOURCE_SPEC;\n' > "$a9compat"
local a9out
a9out="$(check_ar9 2>&1 || true)"
rm -f "$a9core" "$a9shell"
rm -f "$a9core" "$a9compat"
# 🔴 **按路径分别验**:必须证明闸门**两处都看得到** ——
# 只验「输出里有 __ar9_selftest」不够(单处抓到会误判成两处都抓到)。
local a9need=0 a9c=0
@@ -671,20 +759,20 @@ TOML
a9need=$((a9need+1))
echo "$a9out" | grep -q "sspf-core/src/__ar9_selftest" && a9c=$((a9c+1))
fi
if [ -d "$KERNEL/src/platform" ]; then
if [ -d "$CRATES/sspf-compat-system/src" ]; then
a9need=$((a9need+1))
echo "$a9out" | grep -q "platform/__ar9_selftest" && a9c=$((a9c+1))
echo "$a9out" | grep -q "sspf-compat-system/src/__ar9_selftest" && a9c=$((a9c+1))
fi
[ "$a9need" -gt 0 ] && [ "$a9c" -ge "$a9need" ] && a9ok=1
fi
if [ "$a9ok" -eq 1 ]; then
echo "✅ 反自证通过:AR9 抓到了真源与转发壳里的 use sspf_pack_*"
echo "✅ 反自证通过:AR9 抓到了真源与契约面包里的 use sspf_pack_*"
else
echo "❌ 反自证失败:AR9 没抓到平台层里的业务包引用(或漏扫了真源/转发壳)⇒ 尺子是假的"
echo "❌ 反自证失败:AR9 没抓到平台层里的业务包引用(或漏扫了真源/契约面)⇒ 尺子是假的"
rc=1
fi
echo "── 反自证 3/9:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
echo "── 反自证 3/10:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
#
# 🔴 造在**临时模块文件**上(不动真文件):只要它同时有 `pub use sspf_pack_`
# 和 `= EntitySpec {`,PACK1 就必须红。
@@ -710,7 +798,7 @@ RS
echo "⏭ 跳过 PACK1 反自证(业务模块目录不存在)"
fi
echo "── 反自证 4/9:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
echo "── 反自证 4/10:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
local pfile="$CRATES/sspf-plugin/Cargo.toml"
if [ -f "$pfile" ]; then
cp "$pfile" "$pfile.bak"
@@ -731,67 +819,104 @@ RS
echo "⏭ 跳过 AR8 反自证(sspf-plugin 不存在)"
fi
echo "── 反自证 5/9:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
echo "── 反自证 5/10:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
#
# 🔴 **必须自证 AR10**:它的判据是「扫平台层目录找契约面引用」。
# 目录名写错 / 路径拼错 ⇒ 扫描永远返回空 ⇒ **永远"通过"** ⇒ 虚假安全感。
# 而且这条判据守护的是**拆 crate 的前置条件** —— 它一旦失效,后续批次才炸。
# 🔴 **M2 起注入两处**(真源 + 转发壳),与 2/6 同理:单点注入会漏判。
# 🔴🔴 **M7 起注入两处**(平台核心真源 + 契约面真源),与 2/6 同理:单点注入会漏判。
# ⚠️ 契约面**自己**引用 `compat::` 是合法的(面 B 内部互引)⇒ AR10 的
# Python 扫描会跳过名为 `compat` 的子目录 —— 但现在契约面在**独立 crate**里
# ⇒ 目录里**没有** `compat` 子目录 ⇒ 注入到 `sspf-compat-system/src/` 会被抓到。
local a10core="$CRATES/sspf-core/src/__ar10_selftest.rs"
local a10shell="$KERNEL/src/platform/__ar10_selftest.rs"
local a10compat="$CRATES/sspf-compat-system/src/__ar10_selftest.rs"
local a10ok=0
if [ -d "$CRATES/sspf-core/src" ] || [ -d "$KERNEL/src/platform" ]; then
if [ -d "$CRATES/sspf-core/src" ] || [ -d "$CRATES/sspf-compat-system/src" ]; then
[ -d "$CRATES/sspf-core/src" ] && printf 'use crate::platform::compat::helper::current_user;\n' > "$a10core"
[ -d "$KERNEL/src/platform" ] && printf 'use crate::platform::compat::helper::current_user;\n' > "$a10shell"
[ -d "$CRATES/sspf-compat-system/src" ] && printf 'use crate::platform::compat::helper::current_user;\n' > "$a10compat"
local a10out
a10out="$(check_ar10 2>&1 || true)"
rm -f "$a10core" "$a10shell"
rm -f "$a10core" "$a10compat"
local a10need=0 a10c=0
if [ -d "$CRATES/sspf-core/src" ]; then
a10need=$((a10need+1))
echo "$a10out" | grep -q "sspf-core/src/__ar10_selftest" && a10c=$((a10c+1))
fi
if [ -d "$KERNEL/src/platform" ]; then
if [ -d "$CRATES/sspf-compat-system/src" ]; then
a10need=$((a10need+1))
echo "$a10out" | grep -q "platform/__ar10_selftest" && a10c=$((a10c+1))
echo "$a10out" | grep -q "sspf-compat-system/src/__ar10_selftest" && a10c=$((a10c+1))
fi
[ "$a10need" -gt 0 ] && [ "$a10c" -ge "$a10need" ] && a10ok=1
fi
if [ "$a10ok" -eq 1 ]; then
echo "✅ 反自证通过:AR10 抓到了真源与转发壳里的 crate::platform::compat"
echo "✅ 反自证通过:AR10 抓到了真源里的 crate::platform::compat"
else
echo "❌ 反自证失败:AR10 没抓到平台层的契约面反向依赖(或漏扫了真源/转发壳)⇒ 尺子是假的"
echo "❌ 反自证失败:AR10 没抓到平台层的契约面反向依赖(或漏扫了真源)⇒ 尺子是假的"
rc=1
fi
echo "── 反自证 6/9:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
echo "── 反自证 6/10:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
#
# 🔴 **M3 起底座有两处**:真源 `crates/sspf-compat-core/src/helper.rs`(实现)
# + 转发壳 `src/backend/src/platform/compat/helper.rs`。**两处都注入、
# 两处都被抓到**才算尺子有效(只注入一处会漏判「闸门只扫壳/只扫真源」)。
# 🔴🔴 **M7 起底座只有一处**:真源 `crates/sspf-compat-core/src/helper.rs`
# (转发壳 `src/backend/src/platform/compat/helper.rs` 已随 M7 删除)。
# ⇒ 注入点只剩真源一处。
# 做法:备份真文件 → 追加违规行 → 跑判据 → 还原(helper.rs 是活文件)。
local a11ok=0
local a11core="$CRATES/sspf-compat-core/src/helper.rs"
local a11shell="$KERNEL/src/platform/compat/helper.rs"
local a11need=0 a11c=0 a11out
if [ -f "$a11core" ] || [ -f "$a11shell" ]; then
[ -f "$a11core" ] && cp "$a11core" "$a11core.bak" && printf '\nuse super::system::menu_node;\n' >> "$a11core" && a11need=$((a11need+1))
[ -f "$a11shell" ] && cp "$a11shell" "$a11shell.bak" && printf '\nuse super::system::menu_node;\n' >> "$a11shell" && a11need=$((a11need+1))
if [ -f "$a11core" ]; then
cp "$a11core" "$a11core.bak" && printf '\nuse super::system::menu_node;\n' >> "$a11core" && a11need=$((a11need+1))
a11out="$(check_ar11 2>&1 || true)"
[ -f "$a11core.bak" ] && mv "$a11core.bak" "$a11core"
[ -f "$a11shell.bak" ] && mv "$a11shell.bak" "$a11shell"
[ -f "$a11core" ] && { echo "$a11out" | grep -q "sspf-compat-core/src/helper.rs" && a11c=$((a11c+1)); }
[ -f "$a11shell" ] && { echo "$a11out" | grep -q "platform/compat/helper.rs" && a11c=$((a11c+1)); }
[ "$a11need" -gt 0 ] && [ "$a11c" -ge "$a11need" ] && a11ok=1
fi
if [ "$a11ok" -eq 1 ]; then
echo "✅ 反自证通过:AR11 抓到了真源与转发壳里的 use super::system"
echo "✅ 反自证通过:AR11 抓到了底座真源里的 use super::system"
else
echo "❌ 反自证失败:AR11 没抓到底座的反向依赖(或漏扫了真源/转发壳)⇒ 尺子是假的"
echo "❌ 反自证失败:AR11 没抓到底座的反向依赖(或漏扫了真源)⇒ 尺子是假的"
rc=1
fi
echo "── 反自证 7/9:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──"
echo "── 反自证 7/10:往壳里写 crate::platform::,AR15 必须报 ❌ ──"
#
# 🔴 **必须自证 AR15**:删掉 `platform/` 转发壳之后,旧路径就**没有编译器**兜底了
# —— 只要有人重建壳目录并把 import 改回去,**一切照常编译、测试照常全绿**,
# 而 M2–M7 的架构收益全部蒸发。⇒ 必须有一条闸门钉住「不许回来」。
# 🔴 **注入三处**(证明三层判据都有效):
# ① 壳内引用旧路径(`crate::platform::`)⇒ 源码级判据要抓到;
# ② 集成测试引用旧路径(`ssw_platform::platform::`)⇒ 同上;
# ③ 重建 `src/backend/src/platform/` 目录 ⇒ 目录级判据要抓到。
local a15ok=0
local a15probe="$KERNEL/src/__ar15_selftest.rs"
local a15test="$KERNEL/tests/__ar15_selftest.rs"
local a15dir="$KERNEL/src/platform"
local a15had_dir=0
[ -d "$a15dir" ] && a15had_dir=1
printf 'use crate::platform::sys::user_list;\n' > "$a15probe"
printf 'use ssw_platform::platform::db::Db;\n' > "$a15test"
mkdir -p "$a15dir"
printf '//! 探针\n' > "$a15dir/__ar15_selftest.rs"
local a15out
a15out="$(check_ar15 2>&1 || true)"
rm -f "$a15probe" "$a15test" "$a15dir/__ar15_selftest.rs"
# 🔴 **清理要彻底**:删探针文件 + 删目录(git 不跟踪空目录 ⇒ 残留会让下次
# 主检查**假红** —— 实测踩过:`rmdir` 失败后留下空目录)。
rm -rf "$a15dir"
[ "$a15had_dir" -eq 1 ] && mkdir -p "$a15dir"
# 🔴 **按判据分别验**:三处都必须被提到(只看「输出非空」不够)。
local a15c=0
echo "$a15out" | grep -q "__ar15_selftest.rs" && a15c=$((a15c+1))
echo "$a15out" | grep -q "platform: 目录复活" && a15c=$((a15c+1))
[ "$a15c" -ge 2 ] && a15ok=1
if [ "$a15ok" -eq 1 ]; then
echo "✅ 反自证通过:AR15 抓到了旧路径引用与 platform/ 目录复活"
else
echo "❌ 反自证失败:AR15 没抓到旧平台路径复活(源码级 / 目录级判据可能失效)⇒ 尺子是假的"
rc=1
fi
echo "── 反自证 8/10:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──"
#
# 🔴 **为什么必须自证 AR12**:它的判据是「读 Cargo.toml 找 sspf-compat-* 依赖」。
# 若 grep 模式写错(包名含连字符/下划线混用)⇒ 永远扫不到依赖 ⇒
@@ -818,7 +943,7 @@ RS
rc=1
fi
echo "── 反自证 8/9:给执行层塞一个越界依赖 + 一条业务包引用,AR13 必须报 ❌ ──"
echo "── 反自证 9/10:给执行层塞一个越界依赖 + 一条业务包引用,AR13 必须报 ❌ ──"
#
# 🔴 **必须自证 AR13**:它的判据是「读 Cargo.toml + grep 源码」。
# 两种失效模式都得堵:
@@ -851,7 +976,7 @@ RS
rc=1
fi
echo "── 反自证 9/9:给适配层塞一个越界依赖 + 一条业务包引用,AR14 必须报 ❌ ──"
echo "── 反自证 10/10:给适配层塞一个越界依赖 + 一条业务包引用,AR14 必须报 ❌ ──"
#
# 🔴 **必须自证 AR14**:它是 M6 新增的判据,守护的是「全仓唯一知道全部包的
# 汇聚点」的依赖面。两种失效模式都得堵:
@@ -905,6 +1030,7 @@ check_ar11
check_ar12
check_ar13
check_ar14
check_ar15
check_pack1
check_mem1
check_mem2
+2 -1
View File
@@ -2,7 +2,8 @@
"""check-boundary-scan.py —— 平台层「零业务知识」扫描器(`check-boundary.sh` 的 CP1 后端)。
🔴 **为什么需要它**:CLAUDE.md 红线 12 要求「加一个业务模块只碰业务层」
⇒ 平台层(`src/backend/src/platform/`)里**不许出现任何业务标识符**
⇒ 平台层(`crates/sspf-core/` + `crates/sspf-compat-*/` 等真源)里**不许出现任何业务标识符**
(🔴 M7 起转发壳已删除 ⇒ 平台层只有真源)
(业务表名 / 实体名 / 路由前缀 / 菜单 id / 菜单 url / 菜单 en_code)。
这条规则**只靠人看代码守不住** —— 加模块的人不会主动去看平台层 ⇒ 需要一把尺子。
+7 -8
View File
@@ -37,10 +37,10 @@ ROOT="$(cd "$(dirname "$0")/.." && pwd)"
BACKEND="$ROOT/src/backend"
SRC="$BACKEND/src"
PLATFORM="$SRC/platform"
# 🔴 **M2 起平台层真源在 `crates/sspf-core/src/`**,`src/backend/src/platform/`
# 只剩转发壳(`pub use sspf_core::*`)+ 尚未搬走的 `compat/`(M3/M4)。
# ⇒ 所有「扫平台层」的判据必须**两处都扫**(真源管实现、壳防塞私货)。
# 🔴🔴 **M7 起平台层真源全在 `crates/`** —— `src/backend/src/platform/` 的
# 38 个转发壳**已整体删除** ⇒ 平台层**只有真源**,没有壳。
# ⇒ 所有「扫平台层」的判据**只需扫 crates/ 下的真源**(不再扫壳)。
# ⚠️ 「旧路径复活」由 `check-arch.sh` 的 **AR15** 单独钉住(防删掉的东西回来)。
PLATFORM_CORE="$ROOT/crates/sspf-core/src"
# 🔴 **M4 起契约面真源分散在 7 个 crate**(`sspf-compat-core` + 6 个域包)——
# 契约面也是「平台侧」⇒ 业务标识符泄漏 / 反向依赖业务层同样要查。
@@ -128,7 +128,7 @@ fi
# ---- CP1'' 反自证:扫描面必须**真覆盖**新 crate(M6 新增目录)----
#
# 🔴 **为什么必须有这一条**:CP1 的扫描面是**显式列出来的目录**(`PLATFORM_CORE` /
# `PLATFORM` / `COMPAT_DIRS` / `LOWCODE_EXEC` / `MCP_ADAPTER`)。
# `PLATFORM_CORE` / `COMPAT_DIRS` / `LOWCODE_EXEC` / `MCP_ADAPTER`)。
# 代码搬到新 crate 后,若忘了把新目录加进扫描面 ⇒ 尺子**扫不到** ⇒
# **永远"通过"** ⇒ 虚假安全感(AR9 自证注释里写明过这个坑)。
# ⇒ 往新 crate 注入一个**业务表名**,必须被抓到 —— 抓不到 = 扫描面漏了。
@@ -173,7 +173,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[@]}"} ${LOWCODE_EXEC:+"${LOWCODE_EXEC}"} ${MCP_ADAPTER:+"${MCP_ADAPTER}"} "${SRC}/routes.rs" "${SRC}/main.rs" "${BOOTSTRAP}" 2>&1)"
SCAN_OUT="$(SSW_PACKS_DIR="${ROOT}/packs" "${PY_BIN}" "${SCAN}" "${MODULES}" "${PLATFORM_CORE}" ${COMPAT_DIRS[@]+"${COMPAT_DIRS[@]}"} ${LOWCODE_EXEC:+"${LOWCODE_EXEC}"} ${MCP_ADAPTER:+"${MCP_ADAPTER}"} "${SRC}/routes.rs" "${SRC}/main.rs" "${BOOTSTRAP}" "${SRC}/compat.rs" 2>&1)"
if [ "$?" -eq 0 ]; then
ok "平台层没有业务标识符($(printf '%s\n' "${SCAN_OUT}" | tail -1))"
else
@@ -185,7 +185,7 @@ fi
hdr "[CP2] 平台层不反向依赖业务层(sspf-core/** 与 compat 包/** 与 lowcode-exec/** 与 mcp-adapter/** 不许 use crate::modules)"
# 🔴 五处都扫:平台核心真源 + 平台转发壳 + 契约面 7 个包的真源 + 低代码执行层真源(M5)
# + MCP 适配层真源(M6)。
CP2_HITS="$(grep -rn "use crate::modules" "${PLATFORM_CORE}" "${PLATFORM}" ${COMPAT_DIRS[@]+"${COMPAT_DIRS[@]}"} ${LOWCODE_EXEC:+"${LOWCODE_EXEC}"} ${MCP_ADAPTER:+"${MCP_ADAPTER}"} 2>/dev/null)"
CP2_HITS="$(grep -rn "use crate::modules" "${PLATFORM_CORE}" ${COMPAT_DIRS[@]+"${COMPAT_DIRS[@]}"} ${LOWCODE_EXEC:+"${LOWCODE_EXEC}"} ${MCP_ADAPTER:+"${MCP_ADAPTER}"} 2>/dev/null)"
if [ -z "${CP2_HITS}" ]; then
ok "平台核心 / 转发壳 / 契约面各包 / 低代码执行层 / MCP 适配层 都没有 use crate::modules"
else
@@ -291,7 +291,6 @@ fi
hdr "[CP6] 平台层自带菜单(条数与 id 都由契约 [MENU] 推出来;业务菜单不许混进 seed.rs)"
# 🔴 M2 起 `seed.rs` 真源在 `crates/sspf-core/src/seed.rs`(转发壳里没有 BUILTIN_MENUS)。
SEED_RS="${PLATFORM_CORE}/seed.rs"
[ -f "${SEED_RS}" ] || SEED_RS="${PLATFORM}/seed.rs"
PLATFORM_MENU_COUNT="$(awk '
/const BUILTIN_MENUS: \[MenuSpec; / { inb = 1; next }
inb && /^\];/ { inb = 0; next }
+111 -13
View File
@@ -357,6 +357,31 @@ def resolve_const(orig, masked, name, global_consts=None):
_CONST_CACHE = {}
def derive_plat_key(mod_path):
"""`mod_path`(handler 路径的全链)⇒ `plat_files` 的键。
🔴🔴 **M7 起按「crate 名」判定**(不再按路径段数猜):
- 第一段是 `sspf_compat_*` ⇒ **契约面** ⇒ `compat__<模块>`
- 第一段是 `compat`(壳侧别名表)⇒ **契约面** ⇒ `compat__<模块>`
- 其它(`sspf_core` / `sspf_store` / 单段 `sys` …)⇒ **平台核心** ⇒ `<模块>`
🔴 **为什么必须抽成独立函数**:推导规则是 CC6 的**命脉** ——
写错 ⇒ 守卫推不出来 ⇒ CC6 静默退化成 WARN ⇒ 尺子变瞎,
而闸门输出**仍然是绿的** ⇒ 只能靠**直接断言**(`self_test` 里那组)
把规则本身钉住。抽成函数 ⇒ 断言测的与实际用的是**同一份代码**
⇒ 不会出现「测的是 A、跑的是 B」的假自证。
"""
if not mod_path:
return None
if "::" not in mod_path:
return mod_path # 单段(`sys`)⇒ 平台核心根目录
root = mod_path.split("::", 1)[0]
mod = mod_path.split("::")[-1] # 最后一段 = 真正的模块文件名
if root.startswith("sspf_compat_") or root == "compat":
return "compat__" + mod
return mod # 平台核心(`sspf_core::sys` ⇒ `sys`)
def guard_of_platform(plat_files, mod, fn, mod_path=None, plat_consts=None):
"""平台层 handler 的守卫 ⇒ 菜单 key / 点权限编码 / 登录 / 无;推不出 ⇒ None。
@@ -387,11 +412,21 @@ def guard_of_platform(plat_files, mod, fn, mod_path=None, plat_consts=None):
# 🔴 **契约面实现文件**(批次 17 补):`platform/compat/<模块>.rs` ——
# key 形如 `compat__online_dev` ⇒ 与 `jnpf` / `face_b` **同一套**推导规则
# (`guard` / `guard_any` / `require_login_face_b`)。
# 🔴 `mod_path` 两段以上(`compat::online_dev`)⇒ 走 `compat__<模块>`;
# 一段(`sys`)⇒ 走根目录的 `<模块>`。
plat_key = mod
if mod_path and "::" in mod_path:
plat_key = "compat__" + mod
#
# 🔴🔴 **M7 起:按「crate 名」判定,不再按「路径段数」猜**。
# 旧规则是「`mod_path` 含 `::` ⇒ 就是契约面」—— 它只在**单 crate**
# 时代成立(`compat::system::` 两段 vs `sys::` 一段)。M7 把真源拆进
# 多个 crate 之后,**平台核心也变成两段**(`sspf_core::sys::user_list`)
# ⇒ 旧规则会把它误判成契约面 ⇒ `plat_key` 从 `sys` 变成 `compat__sys`
# ⇒ 守卫**推不出来** ⇒ CC6 静默退化成「全是 WARN」⇒ **尺子变瞎**。
# (实测已验证:`sspf_core::sys::user_list` ⇒ `plat_key=compat__sys`。)
#
# 新规则**只看第一段是不是契约面包**(见 [`derive_plat_key`])⇒
# 与路径深度**无关** ⇒ 平台核心 / 契约面**改写前后推导结果一致**
# ⇒ M7 的大爆炸改写**不会**让 CC6 退化。
plat_key = derive_plat_key(mod_path)
if plat_key is None:
plat_key = mod
# 🔴 平台层根目录的单段模块(`sys::user_list`)⇒ `require_module` / `require_login`。
if plat_key == mod and mod not in ("jnpf", "face_b"):
pair = plat_files.get(mod)
@@ -824,7 +859,9 @@ def scan_code(src_dir, packs_dir=None):
routes_path = os.path.join(src_dir, "routes.rs")
plat, plat_orig, plat_masked = scan_routes(routes_path, "platform")
plat_dir = os.path.join(src_dir, "platform")
# 🔴🔴 **M7 起:转发壳层已删除**(`src/backend/src/platform/` 的 38 个壳
# 全部清空)⇒ 平台层**只有真源**(在 `crates/` 下)⇒ 这里**不再**收壳。
# ⚠️ 「旧路径复活」由 `check-arch.sh` 的 AR15 钉住,与本扫描器无关。
plat_files = {"__routes__": (plat_orig, plat_masked)}
def _absorb(key, o):
@@ -846,12 +883,11 @@ def scan_code(src_dir, packs_dir=None):
# 🔴 **平台层真源**(M2):`crates/sspf-core/src/<模块>.rs` ——
# 实现都搬到这里,守卫推导必须扫它(否则推不出 ⇒ CC6 静默失效)。
core_dir = os.path.join(ROOT, "crates", "sspf-core", "src")
for d in (core_dir, plat_dir):
if os.path.isdir(d):
for name in sorted(os.listdir(d)):
if name.endswith(".rs"):
p = os.path.join(d, name)
_absorb(name[:-3], read(p))
if os.path.isdir(core_dir):
for name in sorted(os.listdir(core_dir)):
if name.endswith(".rs"):
p = os.path.join(core_dir, name)
_absorb(name[:-3], read(p))
# 🔴 **契约面实现文件**(批次 17 补):`platform/compat/<模块>.rs` ——
# 契约面按官方模块名分文件(`online_dev.rs` / `report.rs` / `system.rs` …),
# 路由注册写 `compat::<模块>::<handler>` ⇒ 这些文件**必须**进 `plat_files`,
@@ -863,7 +899,6 @@ def scan_code(src_dir, packs_dir=None):
# (实测:漏收时 check-contract 照样 10/10 全绿,但尺子已经废了)。
compat_dirs = [
os.path.join(ROOT, "crates", "sspf-compat-core", "src"), # M3 真源(helper/res)
os.path.join(plat_dir, "compat"), # 壳 + 尚未搬走的模块
]
# 🔴 **M4:六个契约面域包的真源**(按包名遍历 ⇒ 新增包时不会漏收)
crates_root = os.path.join(ROOT, "crates")
@@ -1328,6 +1363,69 @@ def self_test(contract=None, src_dir=None, packs_dir=None):
sys.stderr.write("check-contract-scan: 真实契约就有漂移(%s: %s)\n" % (cid, detail))
return 1
# =====================================================================
# 🔴 **推导规则自证**(M7 新增):`plat_key` 的推导规则一旦写错,
# 守卫就**推不出来** ⇒ CC6 静默退化成「全是 WARN」⇒ 尺子变瞎。
# 而 CC6 的反自证是「改契约」型的 —— 它**证不到**推导规则本身
# (契约没变、代码没变,只有**推导逻辑**坏了)⇒ 必须**直接断言**。
#
# 🔴 **为什么这条不能省**:M7 之前 `plat_key` 靠「路径段数」判定
# (两段 ⇒ 契约面)。M7 把平台核心也变成两段(`sspf_core::sys::`)
# ⇒ 旧规则**必然**失效 ⇒ CC6 从「能推出 362 条守卫」退化成
# 「一条都推不出」。而这两件事**在闸门输出上长得一样**(都绿)
# ⇒ 只能靠下面的断言把规则本身钉住。
#
# 断言表 = 「路径写法 → 必须推出的 plat_key」。两种写法(改写前/后)
# **必须推出同一个 key** —— 这正是 M7 改写不破坏尺子的充要条件。
# =====================================================================
plat_key_cases = [
# (mod_path, 期望 plat_key, 说明)
("sys", "sys", "平台核心单段(旧写法)"),
("sspf_core::sys", "sys", "平台核心两段(M7 新写法)"),
("sspf_core::auth", "auth", "平台核心两段(auth)"),
("sspf_store::db", "db", "存储层两段"),
("compat::system", "compat__system", "契约面旧写法(compat::)"),
("compat::online_dev", "compat__online_dev", "契约面旧写法(online_dev)"),
("compat::helper", "compat__helper", "契约面底座(helper)"),
("sspf_compat_system::system", "compat__system", "契约面新写法(system)"),
("sspf_compat_system::scheduletask", "compat__scheduletask", "契约面新写法(scheduletask)"),
("sspf_compat_workflow::workflow", "compat__workflow", "契约面新写法(workflow)"),
("sspf_compat_ext::ai", "compat__ai", "契约面新写法(ai)"),
("sspf_compat_msg::message", "compat__message", "契约面新写法(message)"),
("sspf_compat_permission::permission", "compat__permission", "契约面新写法(permission)"),
("sspf_compat_core::helper", "compat__helper", "契约面底座新写法(helper)"),
]
plat_key_failed = 0
for mp, want, why in plat_key_cases:
got = derive_plat_key(mp)
if got == want:
print(" ✅ 推导自证「%s」⇒ %s" % (mp, want))
else:
print(" ❌ 推导自证「%s」⇒ 期望 %s,实得 %s(%s)"
% (mp, want, got, why))
plat_key_failed += 1
# 🔴 **等价性断言**:同一模块的「旧写法」与「新写法」必须推出同一个 key
# —— 这是 M7 改写**不破坏** CC6 的充要条件。
equiv_pairs = [
("sys", "sspf_core::sys", "sys"),
("auth", "sspf_core::auth", "auth"),
("compat::system", "sspf_compat_system::system", "compat__system"),
("compat::online_dev", "sspf_compat_online_dev::online_dev", "compat__online_dev"),
("compat::helper", "sspf_compat_core::helper", "compat__helper"),
("compat::workflow", "sspf_compat_workflow::workflow", "compat__workflow"),
]
for old, new, want in equiv_pairs:
go, gn = derive_plat_key(old), derive_plat_key(new)
if go == gn == want:
print(" ✅ 等价自证「%s」≡「%s」⇒ %s" % (old, new, want))
else:
print(" ❌ 等价自证「%s」⇒ %s,「%s」⇒ %s(应同为 %s)"
% (old, go, new, gn, want))
plat_key_failed += 1
if plat_key_failed:
sys.stderr.write("check-contract-scan: 推导规则自证失败 %d 例\n" % plat_key_failed)
return 1
with io.open(contract, encoding="utf-8") as fh:
text = fh.read()
+2 -1
View File
@@ -45,8 +45,9 @@ ROUTES="$BACKEND/src/routes.rs"
SCHEMA="$BACKEND/db/schema.sql"
# 🔴 **M2 起 `crud.rs` 真源在 `crates/sspf-core/src/crud.rs`**(转发壳里没有 SQL)。
# 软删契约(`WHERE f_delete_mark = 0` / `SET f_delete_mark = 1`)必须读实现文件。
# 🔴🔴 **M7 起转发壳已整体删除** ⇒ 不再有「壳里没有 SQL」的回落分支
# (回落路径指向已删的 `src/backend/src/platform/crud.rs` ⇒ 尺子会读到不存在的文件)。
CRUD="$ROOT/crates/sspf-core/src/crud.rs"
[ -f "$CRUD" ] || CRUD="$BACKEND/src/platform/crud.rs"
FE="$ROOT/src/frontend"
# 🔴 **本仓是后端-only**(CLAUDE.md §2.2:前端/移动端本期不动,沿用 Java 版)。