平台包零业务:示例移到技能仓、解绑 example-packs、闸门全部改防回流

- 物理移出 packs/{asset,books,demo,shop}、modules/ 四个面 A 适配器、纯技能副本、
  纯业务测试 crud_it.rs 与 new-pack 脚手架(v0.3.0 tag 完整保留旧形态)。
- 删 example-packs feature / example_packs() / sspf-pack-* 依赖 / packs/* member;
  packs_gen.rs 与 modules/mod.rs 生成段降级为恒空的注入点,装配链一条不删;
  pack-sync.py 把「零包」钉成合法目标态。
- 尺子不再「跳过」:CP1 防回流清单、check-module 三条、AR2/PACK1 正向断言、
  AR17 升级为零业务依赖判据(含注入式反自证)、契约反自证换平台锚点、FACE 零包重算。
- 面 A 冒烟 43→21 条(17 条平台权限闭环 + 4 条业务端点 404);pack_smoke_it 改
  运行时防回流探针;auth/db/batch7/permission/seed/routes 单测换平台内置夹具。
- 契约 [MENU_TREE] 收成 5 条系统菜单、[RULER] 改 21/3;README/CLAUDE/HANDOFF/
  CHANGELOG/contract §5.1/schema.sql/db.rs 注释同步。

验收:cargo test --workspace --no-fail-fast 649 passed / 0 failed / 6 ignored;
verify.sh --smoke 14/14;check-arch 24/24 + 反自证 14/14;
cargo tree -p sspf 无 sspf-pack-*。前端 src/frontend 按要求保留。
This commit is contained in:
admin committed 2026-11-04 21:54:22 +08:00
1 parent ca8abf9cc9
commit ecb77b230f
94 files changed
+842 -8986

No files matched your search

+67 -65
View File
@@ -15,7 +15,7 @@
# ── 判据 ──
# AR1 `crates/sspf-sdk` 依赖只能有 `sspf-contract`
# —— 业务包只依赖 sdk ⇒ sdk 多一个依赖 = 所有业务包都要背
# AR2 `packs/*/Cargo.toml` 依赖 ⊆ {sspf-sdk, serde}
# AR2 🔴 平台包零业务:`packs/` 不存在;若出现则业务包依赖 ⊆ {sspf-sdk, serde}
# —— 业务包必须能整目录搬走 ⇒ 不许挂在 axum / tokio / pglite 上
# AR3 `crates/sspf-contract` 源码不许 `use axum|tokio|pglite|sqlx`
# —— 契约层一旦有 IO,业务包就再也不是「轻依赖」
@@ -52,7 +52,7 @@
# 到 `src/backend/tests/`、`crates/sspf-admin` 必须存在且产出 bin
# —— 「内核是库、装配是应用、测试是消费者」这三条边界都是**文件位置**
# ⇒ 没有任何编译错误会提示你踩线,只有结构慢慢退回原样
# AR17 内核默认 feature 下不得编译期依赖 `packs/*`
# AR17 🔴 平台包零业务:任何 Cargo.toml 里都不许有 `sspf-pack-*` 依赖 / `example-packs`
# —— `crates/sspf` 是业务仓唯一依赖的**标准平台包**;示例包一硬依赖,
# `cargo add sspf` 就等于把 asset/demo/shop/books 拖进业务二进制
# AR18 `crates/sspf/src/**` 不得出现业务字面量(业务仓名 / 业务表名 / `/api/ssw/`)
@@ -153,7 +153,16 @@ check_ar2() {
found=1
fi
done
[ "$n" -eq 0 ] && skip "AR2 尚无 packs/*(P3 才落地)"
if [ "$n" -eq 0 ]; then
# 🔴 2026-11-04 清理:零包是**合法目标态**,但不能「跳过」(跳过 = 尺子变瞎)。
# ⇒ 改成正向断言:packs/ 目录必须不存在,谁把业务包塞回来立刻红。
if [ -d "$ROOT/packs" ]; then
bad "AR2 平台包零业务:packs/ 目录不该存在(业务包属于业务仓 / 技能仓)"
found=1
else
ok "AR2 平台包零业务:没有 packs/,无任何业务包依赖(出现即红)"
fi
fi
return $found
}
@@ -631,7 +640,18 @@ check_pack1() {
fi
ok "PACK1 ${name}.rs 只做 re-export,spec 真源在 packs/${name}/src/lib.rs"
done
[ "$n" -eq 0 ] && skip "PACK1 尚无「模块转发业务包」的模块"
if [ "$n" -eq 0 ]; then
# 🔴 2026-11-04 清理:没有业务模块可检查时**不能跳过**(假闸门)。
# 正向钉住「modules/ 只剩 mod.rs」;反自证 3/14 注入的临时模块仍会
# 在上面的循环里被抓到(它带 `pub use sspf_pack_` ⇒ n > 0)。
local stray
stray="$(find "$MODULES_DIR" -maxdepth 1 -name '*.rs' ! -name 'mod.rs' -print 2>/dev/null)"
if [ -n "$stray" ]; then
bad "PACK1 平台包零业务:modules/ 出现业务适配器(应在业务仓):\n${stray}"
else
ok "PACK1 平台包零业务:modules/ 只剩 mod.rs(无 spec 两份拷贝的风险)"
fi
fi
return 0
}
@@ -770,57 +790,48 @@ check_ar16() {
}
# ---------------------------------------------------------------- AR17
# **内核默认 feature 下不得编译期依赖 `packs/*`**(2026-11-04 标准平台包)。
# 🔴 **平台包零业务:依赖清单里不许有任何业务包 / 选装开关**(2026-11-04 清理)。
#
# 🔴 **为什么需要**:`crates/sspf` 是给业务仓的**标准平台包**(业务仓唯一依赖)。
# 内核若在默认 feature 下硬依赖 4 个示例包(asset / books / demo / shop),
# 业务仓依赖门面就等于把这四个包拖进自己的二进制 ⇒ 「平台包里零业务」是假话,
# 且 `cargo tree -p sspf | grep sspf-pack` 会冒出 4 行(P0 的出口判据 ①)。
# ⇒ 示例包降为 `example-packs` feature,只有本仓 `sspf-admin` 与 `sspf-tests` 开。
# 原判据是「示例包依赖必须 optional + default 不开 example-packs」。清理后示例包、
# `example-packs` feature、`[features]` 段**全部退役** ⇒ 那条判据在空清单上恒真,
# 反自证也没有探针可用(实测自证 12/14 直接红)。
#
# 判据(三条,全部静态 —— 不跑 `cargo tree`,闸门必须秒级):
# ① `src/backend/Cargo.toml` 里每条 `sspf-pack-*` 依赖必须带 `optional = true`;
# ② 内核 `[features] default` 不得含 `example-packs` / `sspf-pack-*`;
# ③ 门面 `crates/sspf/Cargo.toml` 的 `default` 同样不得开 `example-packs`
# (门面自己开了 = 业务仓一依赖就被拖进示例包,绕过了 ①②)。
#
# 🔴 **为什么不靠 `cargo tree` 兜底**:`cargo tree` 要解析依赖图(~1-3s),
# 而且它看的是**本次构建的实际 feature 组合**(workspace 里 sspf-tests 开着
# feature ⇒ 永远有 sspf-pack-*)⇒ 判据必须是**清单层面**的。
# 新判据(清单层面,秒级,不跑 cargo tree):
# ① 内核 / 门面 / sspf-admin / sspf-tests / workspace 五个 Cargo.toml 的
# **非注释行**里不许出现 `sspf-pack-*` 依赖或 `example-packs` feature;
# ② `src/backend/Cargo.toml` 的 `>>>GEN:PACK_DEPS` 标记段必须恒空;
# ③ `packs/` 目录不许存在(与 AR2 互补,AR2 看依赖、这里看目录)。
# ⇒ 业务仓只依赖门面 `sspf`,通过 `Platform::packs()` 注入,不开任何平台 feature。
check_ar17() {
local toml="$KERNEL/Cargo.toml"
[ -f "$toml" ] || { skip "AR17 内核 Cargo.toml 不存在"; return; }
local hits=""
local toml="$KERNEL/Cargo.toml"
[ -f "$toml" ] || { bad "AR17 内核 Cargo.toml 不存在"; return; }
# ① 每条 pack 依赖都必须 optional
local not_optional
not_optional="$(grep -nE '^[[:space:]]*sspf-pack-[A-Za-z0-9_-]+[[:space:]]*=' "$toml" 2>/dev/null \
| grep -vE 'optional[[:space:]]*=[[:space:]]*true' || true)"
if [ -n "$not_optional" ]; then
hits="src/backend/Cargo.toml: 示例包依赖必须 optional = true(否则业务仓被拖进示例包):"$'\n'"$(printf '%s\n' "$not_optional" | sed 's/^/ /')"
# ① 五个清单:跳过注释行(注释里讲「不许有 sspf-pack-*」是合法的)
local f h
for f in "$KERNEL/Cargo.toml" "$CRATES/sspf/Cargo.toml" \
"$CRATES/sspf-admin/Cargo.toml" "$CRATES/tests/Cargo.toml" "$ROOT/Cargo.toml"; do
[ -f "$f" ] || continue
h="$(awk '!/^[[:space:]]*#/ && /sspf-pack-|example-packs/ {print NR": "$0}' "$f" 2>/dev/null || true)"
if [ -n "$h" ]; then
hits="${hits:+$hits$'\n'}${f#$ROOT/}: 平台仓不许有业务包依赖 / example-packs feature:$'\n'$(printf '%s\n' "$h" | sed 's/^/ /')"
fi
done
# ② 生成段恒空
local gen
gen="$(awk '/>>>GEN:PACK_DEPS/{f=1;next} /<<<GEN:PACK_DEPS/{f=0} f && NF' "$toml" 2>/dev/null || true)"
if [ -n "$gen" ]; then
hits="${hits:+$hits$'\n'}src/backend/Cargo.toml: >>>GEN:PACK_DEPS 段必须恒空,实际:$'\n'$(printf '%s\n' "$gen" | sed 's/^/ /')"
fi
# ② 内核 default 必须零包
local kdef
kdef="$(awk '/^\[features\]/{f=1;next} /^\[/{f=0} f && /^[[:space:]]*default[[:space:]]*=/' "$toml" 2>/dev/null)"
case "$kdef" in
*example-packs*|*sspf-pack-*)
hits="${hits:+$hits$'\n'}src/backend/Cargo.toml: [features] default 不许含 example-packs / sspf-pack-*(默认 feature 必须是平台包):$kdef" ;;
esac
# ③ 门面 default 不许开示例包
local facade="$CRATES/sspf/Cargo.toml"
if [ -f "$facade" ]; then
local fdef
fdef="$(awk '/^\[features\]/{f=1;next} /^\[/{f=0} f && /^[[:space:]]*default[[:space:]]*=/' "$facade" 2>/dev/null)"
case "$fdef" in
*example-packs*)
hits="${hits:+$hits$'\n'}crates/sspf/Cargo.toml: 门面 default 不许开 example-packs(业务仓会跟着被拖进示例包):$fdef" ;;
esac
# ③ packs/ 目录
if [ -d "$ROOT/packs" ]; then
hits="${hits:+$hits$'\n'}平台仓出现 packs/ 目录 ⇒ 业务包请用 sspf::Platform::packs() 注入"
fi
if [ -z "$hits" ]; then
ok "AR17 内核默认 feature 零业务包(示例包 optional + default 不含 example-packs)"
ok "AR17 平台包零业务:5 个 Cargo.toml 无业务包依赖 / feature,GEN 段恒空,packs/ 不存在"
else
bad "AR17 平台包里混进了业务包(业务仓会被拖进示例包):"
printf '%s\n' "$hits" | sed 's/^/ /'
@@ -947,6 +958,10 @@ TOML
local caught=0
[ "$FAIL" -gt "$before" ] && caught=1
rm -rf "$tmp"
# 🔴 2026-11-04 清理:`mkdir -p packs/__arch_selftest__` 会把 `packs/` 一起造出来,
# 只删子目录会留下**空 packs/** ⇒ AR2/AR17 的零业务判据当场红。
# ⇒ 用 rmdir(只删空目录,绝不动真文件)把探针外壳收干净。
rmdir "$ROOT/packs" 2>/dev/null || true
FAIL=$before
if [ "$caught" -eq 1 ]; then
echo "✅ 反自证通过:AR2 抓到了 axum 依赖"
@@ -1269,29 +1284,16 @@ RS
rc=1
fi
echo "── 反自证 12/14:把内核一条示例包依赖改成非 optional,AR17 必须报 ❌ ──"
echo "── 反自证 12/14:往内核塞回一条 sspf-pack 依赖,AR17 必须报 ❌ ──"
#
# 🔴 **为什么自证 AR17**:它的判据是「grep 依赖行里有没有 optional」。
# grep 的模式写错 ⇒ 永远匹配不到 ⇒ **永远"通过"**(与 AR9 同一类风险)。
# 🔴 **2026-11-04 清理**:依赖清单里已经没有 pack 行可改 ⇒ 旧探针(去掉
# `optional = true`)找不到锚点,自证会**假红**。改成「注入一整条硬依赖」,
# 判据仍是「AR17 对业务包依赖敏感」,锚点不再依赖示例包是否存在。
local a17toml="$KERNEL/Cargo.toml"
local a17ok=0
if [ -f "$a17toml" ]; then
cp "$a17toml" "$a17toml.ar17bak"
python3 - "$a17toml" <<'PY'
import re, sys
p = sys.argv[1]
s = open(p, encoding='utf-8').read()
# 只摘掉**第一行** pack 依赖的 optional(模拟「有人手改回硬依赖」)
s2, n = re.subn(
r'(?m)^(sspf-pack-[A-Za-z0-9_-]+\s*=\s*\{[^}\n]*?),\s*optional\s*=\s*true',
r'\1',
s,
count=1,
)
if n != 1:
sys.stderr.write('AR17 自证:没找到可改的 pack 依赖行\n')
open(p, 'w', encoding='utf-8').write(s2)
PY
printf '\nsspf-pack-probe = { path = "../../packs/probe" }\n' >> "$a17toml"
local a17before=$FAIL
check_ar17 >/dev/null 2>&1
local a17caught=0
@@ -1301,9 +1303,9 @@ PY
[ "$a17caught" -eq 1 ] && a17ok=1
fi
if [ "$a17ok" -eq 1 ]; then
echo "✅ 反自证通过:AR17 抓到了非 optional 的示例包依赖"
echo "✅ 反自证通过:AR17 抓到了回流的 sspf-pack 依赖"
else
echo "❌ 反自证失败:AR17 没抓到非 optional 的示例包依赖 ⇒ 尺子是假的"
echo "❌ 反自证失败:AR17 没抓到回流的业务包依赖 ⇒ 尺子是假的"
rc=1
fi