平台包零业务:示例移到技能仓、解绑 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
+24 -3
View File
@@ -43,6 +43,22 @@ MENU_FIELD_RE = {
# 🔴 字符串字面量:`r#"..."#` / `r"..."` / `"..."`(普通串的转义 `\"` 不影响子串判定)。
LITERAL_RE = re.compile(r'r(#*)"(.*?)"\1|"((?:[^"\\]|\\.)*)"', re.DOTALL)
# 🔴 **防回流清单**(2026-11-04 清理):示例包已搬到技能仓,本仓业务层恒空。
# 此时「从业务层派生」得不到任何 token ⇒ CP1 若直接放过就变成**假闸门**。
# ⇒ 改用这份固定清单:谁把示例业务写回平台层(表名 / 面 A 前缀),立刻红。
# 🔴 只列**不会误伤平台层**的字面量:不列 `Book` / `Product` / `DataResource`
# 这类通用词(平台层正常代码里可能出现),只列表名与带 app 的路由前缀。
ANTI_REFLUX_TOKENS = [
("业务表名(示例·已迁出)", "demo_item"),
("业务表名(示例·已迁出)", "shop_product"),
("业务表名(示例·已迁出)", "book_shop_book"),
("业务表名(示例·已迁出)", "asset_data_resource"),
("业务路由前缀(示例·已迁出)", "/api/ssw/demo/"),
("业务路由前缀(示例·已迁出)", "/api/ssw/shop/"),
("业务路由前缀(示例·已迁出)", "/api/ssw/books/"),
("业务路由前缀(示例·已迁出)", "/api/ssw/asset/"),
]
def strip_comments(src):
"""去掉 `//` 行注释与 `/* */` 块注释(保留字符串字面量里的内容)。
@@ -163,6 +179,9 @@ def business_tokens(modules_dir, packs_dir=None):
for kind, rx in MENU_FIELD_RE.items():
for f in rx.finditer(body):
add("业务菜单 {}".format(kind), f.group(1))
if not tokens:
# 🔴 平台包零业务:没有业务层可派生 ⇒ 用防回流清单,尺子不失效。
return list(ANTI_REFLUX_TOKENS)
return tokens
@@ -180,6 +199,11 @@ def rust_files(root):
def main(argv):
if len(argv) >= 2 and argv[1] == "--self-test":
return self_test()
if len(argv) >= 2 and argv[1] == "--tokens":
# 给 `check-boundary.sh` 的 CP1'' 探针用:打印当前禁止清单的 token(每行一个)。
for _kind, tok in business_tokens(os.environ.get("SSW_MODULES_DIR", ".")):
print(tok)
return 0
if len(argv) < 3:
sys.stderr.write(
@@ -192,9 +216,6 @@ def main(argv):
# 🔴 业务包目录(可省略 ⇒ 兼容旧调用;`check-boundary.sh` 会传)。
packs_dir = os.environ.get("SSW_PACKS_DIR") or None
tokens = business_tokens(modules_dir, packs_dir)
if not tokens:
sys.stderr.write("业务层没解析出任何标识符(modules_dir 有问题?)\n")
return 2
violations = []
scanned = 0
+9 -21
View File
@@ -133,24 +133,12 @@ fi
# **永远"通过"** ⇒ 虚假安全感(AR9 自证注释里写明过这个坑)。
# ⇒ 往新 crate 注入一个**业务表名**,必须被抓到 —— 抓不到 = 扫描面漏了。
hdr "[CP1''] 扫描面反自证(往 M6 新 crate 注入业务表名 ⇒ 必须被抓到)"
# 🔴 **2026-11-04 清理**:示例包已搬走 ⇒ 探针 token 不再从 `packs/` 派生,
# 改用扫描器的 `--tokens`(零业务时 = 防回流清单)。这样反自证仍然真能探到
# 「扫描面覆盖 mcp-adapter」,且顺带钉住防回流清单非空(尺子不会变瞎)。
if [ -d "${MCP_ADAPTER}" ]; then
CP1_PROBE="${MCP_ADAPTER}/__cp1_selftest.rs"
# 🔴 探针用**业务包真实声明的表名**(从业务层派生 ⇒ 探针本身不含硬编码清单)。
CP1_PROBE_TOKEN="$(CP1_SCAN_PATH="${SCAN}" SSW_PACKS_DIR="${ROOT}/packs" "${PY_BIN}" - "${MODULES}" "${ROOT}/packs" <<'PYPROBE'
import os, re, sys
sys.path.insert(0, os.path.dirname(os.path.abspath(os.environ["CP1_SCAN_PATH"])))
modules_dir, packs_dir = sys.argv[1], sys.argv[2]
spec = re.compile(r'table:\s*"([^"]+)"')
for src in [os.path.join(packs_dir, p, "src", "lib.rs")
for p in sorted(os.listdir(packs_dir)) if os.path.isdir(os.path.join(packs_dir, p))]:
if not os.path.isfile(src):
continue
m = spec.search(open(src, encoding="utf-8").read())
if m:
print(m.group(1))
break
PYPROBE
)"
CP1_PROBE_TOKEN="$(SSW_MODULES_DIR="${MODULES}" "${PY_BIN}" "${SCAN}" --tokens 2>/dev/null | head -1)"
if [ -n "${CP1_PROBE_TOKEN}" ]; then
printf 'const LEAK_PROBE: &str = "%s";\n' "${CP1_PROBE_TOKEN}" > "${CP1_PROBE}"
CP1_PROBE_OUT="$(SSW_PACKS_DIR="${ROOT}/packs" "${PY_BIN}" "${SCAN}" "${MODULES}" "${MCP_ADAPTER}" 2>&1 || true)"
@@ -161,17 +149,17 @@ PYPROBE
no "扫描面反自证失败:往 mcp-adapter 注入 ${CP1_PROBE_TOKEN} 没被抓到 ⇒ 扫描面漏了新 crate(尺子已失效)"
fi
else
no "扫描面反自证失败:业务层没解析出业务表名(探针无法构造)"
no "扫描面反自证失败:防回流清单为空(探针无法构造)"
fi
else
no "扫描面反自证失败:MCP_ADAPTER 目录不存在"
fi
# ---- CP1 平台层零业务标识符 ----
hdr "[CP1] 平台层零业务标识符(扫字符串字面量;禁止清单从业务层派生)"
# 🔴 **业务层现在有两处**(批次 12 交付物 ②):`modules/*.rs`(面 A 内嵌)
# + `packs/*/src/lib.rs`(业务包)⇒ 两处都要进「禁止清单」,
# 否则包里的业务表名会从清单里消失 ⇒ 尺子变弱。
hdr "[CP1] 平台层零业务标识符(扫字符串字面量;零业务时启用**防回流清单**)"
# 🔴 **2026-11-04 清理**:本仓业务层恒空 ⇒ 禁止清单由扫描器切成
# `ANTI_REFLUX_TOKENS`(4 张示例表名 + 4 个面 A 前缀)。
# 语义从「不许平台层引用本仓业务」变成「**不许示例业务回流平台层**」。
# 🔴 **M2 起平台层真源在 `crates/sspf-core/src/`** ⇒ 它必须进扫描面(否则扫空壳)。
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
+2 -3
View File
@@ -3,7 +3,7 @@
"""check-citations-scan —— 文档引文(`路径:行号`)校验扫描器。
🔴 为什么存在:
本仓的文档(`SKILL.md` / `MIGRATION.md` / `JNPF_SOURCE_AUDIT.md` / `PERMISSION.md` …)
仓根 + docs/ 的文档(技能向说明归技能仓 `ssw-jnpf-lite-rust`)
大量引用源码位置,语法有三种:
`文件.ext:行号` 单行
`文件.ext:起-止` 区间
@@ -53,11 +53,10 @@ SKIP_DIRS = {
".workbuddy", ".superpowers", "coverage", ".pytest_cache", ".mypy_cache",
}
# 文档语料:仓根 *.md + docs/** + references/**(不含 template-boot-jnpf —— 那是另一份骨架)
# 文档语料:仓根 *.md + docs/**(技能资产文档已迁出本仓,归技能仓 ssw-jnpf-lite-rust)
DOC_GLOBS = (
("", "*.md"),
("docs", "**/*.md"),
("references", "*.md"),
)
# 承认的文件后缀(决定什么算「一条引文」)
+21 -20
View File
@@ -1261,7 +1261,7 @@ def analyze(contract_path, src_dir=None, packs_dir=None, code_snapshot=None):
# ---- CC10 官方端点台账 ↔ 代码真实路由(双向)----
#
# 🔴 为什么要它:面 B 的「做了多少」原先只有**尺子的断言数**(18/18)这一个信号,
# 而**官方端点全表**(JNPF_SOURCE_AUDIT.md §4)是**散文表格** ⇒ 官方端点做没做、
# 而**官方端点全表**(技能仓 JNPF_SOURCE_AUDIT.md §4)是**散文表格** ⇒ 官方端点做没做、
# 做到什么程度,**没有机器可读的账** ⇒ 「覆盖率」只能靠人读散文。
# 本检查把契约附录 A 的 [OFFICIAL](机器可读)当成**账本**,
# 与代码里**真实注册**的路由双向对账,并打印覆盖 N/M。
@@ -1449,8 +1449,10 @@ def self_test(contract=None, src_dir=None, packs_dir=None):
"A\tGET\t/api/ssw/sys/User/List\t登录\tplatform\n", 1)
def bad_owner(t):
return t.replace("A\tGET\t/api/ssw/demo/DemoItem/List\t登录\tdemo\n",
"A\tGET\t/api/ssw/demo/DemoItem/List\t登录\tplatform\n", 1)
# 🔴 2026-11-04 清理:示例业务行已迁出契约 ⇒ 锚点换成**平台行**,
# 反向篡改(platform ⇒ 业务代号)同样能证 CC5 的归属层对账。
return t.replace("A\tGET\t/api/health\t无\tplatform\n",
"A\tGET\t/api/health\t无\tdemo\n", 1)
def bad_face(t):
# 🔴 **动态取现值再减 1**(别写死数字):加端点会让 [FACE] 的 A 条数变化,
@@ -1480,26 +1482,25 @@ def self_test(contract=None, src_dir=None, packs_dir=None):
"面 B 已落地:PageListVO 形状\n", "", 1)
# ---- 包路由的三类漂移(批次 12:`packs/*` 进了代码侧)----
# 🔴 **2026-11-04 清理**:示例包(asset/demo/shop/books)已搬到技能仓,
# 契约 `[ENDPOINT]` 里不再有包路由 ⇒ 下面三条用例的锚点换成**面 B 平台行**。
# 漂移类型不变(守卫形状 / 漏登记 / owner 串线)⇒ CC6/CC2/CC5 仍被真自证。
def pack_guard_wrong(t):
# 包的 3 条面 B 路由里,把守卫写成面 A 的菜单路径(**最容易犯的错**:
# 「两套守卫并存」记混 ⇒ 集成时权限判据错 ⇒ 而且**静默**)
# 把守卫写成面 A 的菜单路径形状(两套守卫记混 ⇒ 静默的权限判据错)
return t.replace(
"B\tGET\t/api/asset/DataResource\tpermission.asset.dataResource\tasset\n",
"B\tGET\t/api/asset/DataResource\tasset/DataResource\tasset\n", 1)
"B\tGET\t/api/permission/Users\tpermission.user\tplatform\n",
"B\tGET\t/api/permission/Users\tsystem/User\tplatform\n", 1)
def pack_drop_row(t):
# 包声明了 DELETE,但契约里没登记(生成段被手删 / 同步没跑)
# 代码里有这条面 B 路由,但契约里没登记(生成段被手删 / 同步没跑)
return t.replace(
"B\tDELETE\t/api/asset/DataResource/{id}\t"
"permission.asset.dataResource\tasset\n", "", 1)
"B\tGET\t/api/permission/Role\tpermission.role\tplatform\n", "", 1)
def pack_owner_wrong(t):
# 包路由的 owner 写成 platform(复制粘贴时的经典手误)⇒ 归属层串线
# owner 串线(复制粘贴时的经典手误)⇒ CC5
return t.replace(
"B\tDELETE\t/api/asset/DataResource/{id}\t"
"permission.asset.dataResource\tasset\n",
"B\tDELETE\t/api/asset/DataResource/{id}\t"
"permission.asset.dataResource\tplatform\n", 1)
"B\tGET\t/api/permission/Role\tpermission.role\tplatform\n",
"B\tGET\t/api/permission/Role\tpermission.role\tdemo\n", 1)
cases.append(("契约多一条端点", add_row, "CC3"))
cases.append(("契约少一条端点", drop_row, "CC2"))
@@ -1510,11 +1511,11 @@ def self_test(contract=None, src_dir=None, packs_dir=None):
cases.append(("台账把已实现的端点说成未实现", off_says_absent, "CC10"))
cases.append(("台账写了代码里没有的端点", off_fake_path, "CC10"))
cases.append(("面 B 路由没记账", off_drop_row, "CC10"))
# 🔴 下面三条是**包路由专属**的漂移:批次 12 之后包路由也会出现在 [ENDPOINT] 里,
# 如果尺子对它们不敏感,等于「加包 = 免检」。
cases.append(("包路由的守卫写成了面 A 形状", pack_guard_wrong, "CC6"))
cases.append(("包路由没登记进契约", pack_drop_row, "CC2"))
cases.append(("包路由的 owner 写错", pack_owner_wrong, "CC5"))
# 🔴 下面三条原为「包路由专属」漂移;零业务清理后锚点改到面 B 平台行,
# 但漂移类型与 CC 编号不变 ⇒ 尺子对「守卫 / 漏登记 / 归属层」仍被真自证。
cases.append(("路由守卫写成了面 A 形状", pack_guard_wrong, "CC6"))
cases.append(("路由没登记进契约", pack_drop_row, "CC2"))
cases.append(("路由的 owner 写错", pack_owner_wrong, "CC5"))
failed = 0
for name, fn, expect in cases:
+47 -1
View File
@@ -144,6 +144,52 @@ fi
#
# 🔴 **新增业务模块时**:在契约 `[MODULE]` 加一行 + 在 `[MENU]` 加一行 ⇒ 本脚本自动覆盖它。
# (本脚本**不再硬编码**任何业务标识符 ⇒ 加模块不用改脚本。)
# ---------------------------------------------------------------- 零业务目标态
#
# 🔴 **2026-11-04 清理**:示例业务模块(demo / shop / books / asset)已整体搬到
# 技能仓 `ssw-jnpf-lite-rust`,本仓契约 `[MODULE]` 段恒空 ⇒ 这把「业务模块
# 10 接触点」尺子**没有被测对象**。直接放过会变成假闸门 ⇒ 换成三条
# **防回流断言**:只要示例业务以任何形式回流,这里必须红。
#
# 🔴 **自证在分支条件里**:只要契约 `[MODULE]` 出现一行数据,
# `${#TARGETS[@]}` 就 > 0 ⇒ 立刻回到下面的完整检查(不会静默跳过)。
if [ "${#TARGETS[@]}" -eq 0 ]; then
echo
echo "── 平台包零业务:[MODULE] 段无业务模块 ⇒ 改跑防回流三条 ──"
PASS=0; FAIL=0
ok() { echo " ✅ $1"; PASS=$((PASS+1)); }
no() { echo " ❌ $1"; FAIL=$((FAIL+1)); }
if [ ! -d "${ROOT}/packs" ]; then
ok "packs/ 不存在 ⇒ 示例业务包未回流平台仓"
else
no "packs/ 又出现了 ⇒ 业务包属于业务仓,请用 sspf::Platform::packs() 注入"
fi
MOD_RS="$(find "${BACKEND}/src/modules" -maxdepth 1 -name '*.rs' ! -name 'mod.rs' -print 2>/dev/null)"
if [ -z "${MOD_RS}" ]; then
ok "modules/ 下没有业务适配器 ⇒ 面 A 业务路由未回流内核"
else
no "modules/ 出现业务适配器:${MOD_RS}"
fi
if [ ! -s "${ROOT}/docs/contract.md" ] || [ -z "${CE_ALL_TARGETS}" ]; then
ok "契约 [MODULE] 无数据行 ⇒ 分支条件本身即自证(加一行就会回到完整检查)"
else
no "契约 [MODULE] 有数据行却进了零业务分支 ⇒ 尺子逻辑坏了"
fi
echo
echo "── 总结 ──"
echo "PASS=${PASS} FAIL=${FAIL}"
if [ "${FAIL}" -eq 0 ]; then
echo "全 ✅ 平台包零业务,示例业务未回流"
exit 0
fi
echo "有 ❌,请修掉回流"
exit 1
fi
T_COUNT=${#TARGETS[@]}
T_APP=(); T_ENT=(); T_TABLE=(); T_ROUTE=(); T_SEED=(); T_MK=(); T_API=(); T_FILE=()
for T in "${TARGETS[@]}"; do
@@ -596,7 +642,7 @@ done
# -------- 全局红线(与具体模块无关,但一样会让闸门失真)--------
#
# 🔴 **面 A / 面 B 的判别头是 `Vue-Version: 3`**(见 JNPF_COMPAT_SURFACE.md §2.2):
# 🔴 **面 A / 面 B 的判别头是 `Vue-Version: 3`**(见 技能仓 JNPF_COMPAT_SURFACE.md §2.2):
# 官方 JNPF 前端**必带** `Jnpf-Origin: pc` / `App-Code` / `Vue-Version: 3` 三个头,
# 而本仓前端**只带前两个**(`App-Code: sswflow` + `Jnpf-Origin: pc`,与官方同款)
# ⇒ 三个头里**只有 `Vue-Version` 是本仓前端唯一不发的** ⇒ 判别只能用它。
+1 -1
View File
@@ -24,7 +24,7 @@
# NM4 代码注释里的提及 ⇒ 🟡 报数(技术债,逐步清零)
# `--strict` 时升级为 🔴
#
# 🔴 为什么注释不一刀切:`JNPF_SOURCE_AUDIT.md` 这类文档整篇都是基线平台源码分析,
# 🔴 为什么注释不一刀切:`技能仓 JNPF_SOURCE_AUDIT.md` 这类文档整篇都是基线平台源码分析,
# 注释里写「官方 `VisualAiServiceImpl.form()`」是**出处**,不是品牌露出。
# 一刀切会逼人删掉溯源信息,反而降低可维护性。⇒ 量化 + 逐步替换成「基线平台」。
File diff suppressed because it is too large. Load diff
-58
View File
@@ -1,58 +0,0 @@
#!/usr/bin/env bash
# 加一个业务模块 —— **一条命令**:后端包 + 面 A 适配器 + 四处派生位置。
#
# 🔴 **为什么存在**(HANDOFF §3 批次 12.5):
# 批次 12 把「spec 搬进 `packs/<app>/`」之后,加模块不用再碰平台层了。但**写包本身**
# 仍是手抄五个文件(`Cargo.toml` / `pack.toml` / `schema/*.sql` / `src/lib.rs` /
# `modules/<app>.rs`),而且抄漏一处**不报错**:
# · 漏 `merge` 一行 ⇒ 面 B 静默 404
# · 漏 `ALL_MENUS` 一行 ⇒ 菜单不种 ⇒ 守卫查不到菜单 ⇒ **越权放行**
# · 漏 `f_tenant_id` ⇒ 集成时导不进官方
# ⇒ 本命令把五个文件按「业务决策」生成,再让 `pack-sync.py` 把内核接线补齐。
#
# 🔴 **真源 = 业务决策**(app / 实体名 / 中文名 / 列清单),其余全是推导。
# **不猜**:没有列清单就拒绝生成(空表没有意义,还会掩盖「忘了给列」)。
#
# 用法:
# bash scripts/new-pack.sh <app> <Entity> --name "中文名" \
# --columns "name:VARCHAR(200),price:DECIMAL(18,2)"
#
# bash scripts/new-pack.sh <app> <Entity> --name "中文名" --from-ddl path/to.sql
# bash scripts/new-pack.sh <app> <Entity> --name "中文名" --columns "..." --with-frontend
# bash scripts/new-pack.sh <app> <Entity> --name "中文名" --columns "..." --dry-run
#
# 例(和数据资源同构的一个包里再加一个实体):
# bash scripts/new-pack.sh crm Customer --name "客户" \
# --columns "name:VARCHAR(200),level:VARCHAR(50),owner:VARCHAR(50)"
#
# 退出码:0 生成完成 / 2 用法错或前置不满足(已存在 / 缺列清单 / 撞名)
set -u
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
GEN="$ROOT/scripts/new-pack-gen.py"
if [ "${1:-}" = "-h" ] || [ "${1:-}" = "--help" ]; then
sed -n '2,32p' "$0" | sed 's/^# \{0,1\}//'
exit 0
fi
if [ "$#" -lt 2 ]; then
echo "❌ 用法错:需要 <appCode> <Entity>(再加 --name 与 --columns)"
echo " 例: bash scripts/new-pack.sh crm Customer --name \"客户\" --columns \"name:VARCHAR(200)\""
exit 2
fi
PY_BIN="${PY_BIN-$(command -v python3 2>/dev/null || true)}"
if [ -z "${PY_BIN}" ]; then
echo "❌ 找不到 python3(生成器需要它)"
exit 2
fi
if [ ! -f "${GEN}" ]; then
echo "❌ 找不到生成器 ${GEN}"
exit 2
fi
# 参数原样透传(--columns / --dry-run / --force … 由生成器解析)
exec "${PY_BIN}" "${GEN}" "$@"
+79 -166
View File
@@ -420,8 +420,10 @@ def sync_face_counts(text, faces):
🔴 **不写死增量**:直接写「当前 `[ENDPOINT]` 里的实际条数」
⇒ 天然幂等,且加包 / 加模块 / 改路由都自动跟着走。
"""
if not faces:
return text
# 🔴 零包时 `faces` 是空集合 —— **不能短路返回**:业务端点被清空后
# `[FACE]` 的旧条数必须跟着重算,否则 CC9 立刻红(2026-11-04 清理踩到)。
# ⇒ 空集合 = 「重算 [FACE] 里的**全部**面」。
recount_all = not faces
lines = text.split("\n")
try:
@@ -443,7 +445,7 @@ def sync_face_counts(text, faces):
if len(cols) < 2 or cols[0].startswith("#") or not cols[0]:
continue
face = cols[0]
if face not in faces:
if not recount_all and face not in faces:
continue
# 本函数在三次替换**之后**调用 ⇒ `count_faces` 读到的是更新后的值。
cols[1] = str(face_now.get(face, 0))
@@ -503,8 +505,9 @@ def read_all_packs():
for app in sorted(os.listdir(PACKS_DIR)):
if os.path.isdir(os.path.join(PACKS_DIR, app)):
packs.append(read_pack(app))
if not packs:
raise SyncError("packs/ 下没有包(目录:%s)" % PACKS_DIR)
# 🔴 **零包是合法目标态**(2026-11-04 清理):示例包已整体搬到技能仓
# `ssw-jnpf-lite-rust`,平台仓不认识任何业务包。此时四处派生位置
# 全部归零(`--check` 会把它们钉成空)⇒ 业务一旦回流立刻红。
return packs
@@ -584,7 +587,7 @@ def require_module_for_every_pack(packs, mods):
"包 %s 声明了实体,但缺 `src/backend/src/modules/%s.rs`\n"
" 🔴 缺它的后果是**静默**的:菜单不会被种 ⇒ 面 B 守卫查不到菜单\n"
" ⇒ 走「未映射放行」(越权);面 A 端点也不存在 ⇒ MVP 前端页面空着。\n"
" ⇒ 跑 `bash scripts/new-pack.sh %s <Entity>` 补上。"
" ⇒ 平台仓不允许自带业务包;请把 %s 放回业务仓 / 技能仓。"
% (p["app"], p["app"], p["app"])
)
@@ -625,87 +628,45 @@ def manifest_json_of(p):
def gen_packs_gen(packs):
"""生成 `src/backend/src/packs_gen.rs` 全文。"""
"""生成 `src/backend/src/packs_gen.rs` 全文。
🔴 **2026-11-04 清理**:示例包已搬到技能仓,本仓恒为零包。
本文件从「业务包清单」降级为**平台注入点的空实现**:
- [`registry`] 恒返回空注册表(本仓不认识任何业务包);
- [`registry_from`] 保留,供门面 `sspf::Platform::packs` 合并外部注册表。
⇒ 平台能力(包路由装配 / 包 DDL 建表 / 白名单自检)一个不动,
只是「默认带哪些包」变成空。
"""
if packs:
raise SyncError(
"平台仓不允许自带业务包(发现 %d 个)⇒ 业务包请用 sspf::Platform::packs() 注入"
% len(packs)
)
L = []
L.append("//! ⚠️ **本文件由 `scripts/pack-sync.py` 生成 —— 不许手改。**")
L.append("//!")
L.append("//! 它是内核的**业务包清单**:每个包一条 [`sspf_plugin::load_static`]")
L.append("//! 调用 + 一份 `pack.toml` 的 JSON 快照。")
L.append("//! **平台包零业务**(2026-11-04):本仓不认识任何业务包。")
L.append("//! 业务仓通过 `sspf::Platform::packs(reg)` 注入自己装载的注册表,")
L.append("//! 由 `crate::bootstrap` 在**同一个 `Db`** 上装配路由与 DDL。")
L.append("//!")
L.append("//! 🔴 **为什么是生成的**:批次 12 时这段在 `bootstrap.rs` 里手写 ——")
L.append("//! 每加一个包要抄「manifest JSON + `PackSource` + `merge(vec![…])`」三段。")
L.append("//! 漏掉最后那段 `merge` 的表现是:包**装载成功**、没有报错,")
L.append("//! 但 `entities` / `routes` 全丢 ⇒ **面 B 端点静默 404**。")
L.append("//! ⇒ 改成生成 ⇒ 「漏一处」在机制上不存在;真忘了跑生成,")
L.append("//! `scripts/verify.sh` 的第一步(`pack-sync.py --check`)会红。")
L.append("//!")
L.append("//! 🔴 **`packs/` 是唯一真源** —— 加包跑 `bash scripts/new-pack.sh`,")
L.append("//! 改完 `packs/*` 跑 `python3 scripts/pack-sync.py`。")
L.append("//!")
L.append("//! 🔴 **默认 feature 下本文件不装载任何包**(2026-11-04 标准平台包):")
L.append("//! 4 个示例包降为 `example-packs` feature(只有 `sspf-admin` 与 `sspf-tests` 开)。")
L.append("//! 业务仓只依赖门面 `sspf` ⇒ `cargo tree` 里**没有** `sspf-pack-*`")
L.append("//! ⇒ 平台包里零业务(`check-arch.sh` 的 AR17 钉住)。")
L.append("//! 🔴 为什么留着这个空文件:`bootstrap::load_packs()` / 白名单自检 /")
L.append("//! `Extras::kernel()` 都是**平台能力**(业务仓要用),删掉会逼着每个")
L.append("//! 业务仓自己抄一遍。留一个恒空的默认实现 ⇒ 平台侧零业务且不破装配链。")
L.append("")
L.append("use sspf_plugin::{LoadError, PackRegistry};")
L.append("")
L.append("/// 装载 `packs/*` 下的**全部**业务包(顺序 = `app_code` 字典序)。")
L.append("/// 本仓业务包清单:恒为空。")
L.append("///")
L.append("/// 🔴 任一包装载失败 ⇒ **整体失败**(半加载的包比不加载更危险):")
L.append("/// 半加载的包 = 一部分路由在、一部分不在 ⇒ 前端表现为「有的页面能用」。")
L.append('#[cfg(feature = "example-packs")]')
L.append("pub fn registry(kernel_version: &str) -> Result<PackRegistry, LoadError> {")
L.append(" let mut regs: Vec<PackRegistry> = Vec::new();")
L.append("")
for p in packs:
app = p["app"]
ident = "sspf_pack_" + app.replace("-", "_")
const = app.upper().replace("-", "_") + "_MANIFEST_JSON"
L.append(" // ---- %s ----" % app)
L.append(" regs.push(sspf_plugin::load_static(")
L.append(' "%s",' % app)
L.append(" %s," % const)
L.append(" Box::new(%s::Pack)," % ident)
L.append(" %s::DDLS," % ident)
L.append(" kernel_version,")
L.append(" )?);")
L.append("")
L.append(" Ok(sspf_plugin::merge(regs))")
L.append("}")
L.append("")
L.append("/// 默认 feature(业务仓只依赖门面时的形态):**本仓不认识任何业务包** ⇒ 空注册表。")
L.append("///")
L.append("/// 🔴 返回 `Ok` 而不是 `Err`:空注册表是**合法形态**(业务仓自己注入业务包),")
L.append("/// 不是装载失败。")
L.append('#[cfg(not(feature = "example-packs"))]')
L.append("/// 🔴 返回 `Ok` 而不是 `Err`:空注册表是**合法形态**,不是装载失败。")
L.append("pub fn registry(_kernel_version: &str) -> Result<PackRegistry, LoadError> {")
L.append(" Ok(PackRegistry::default())")
L.append("}")
L.append("")
L.append("/// 把**外部已装载**的注册表合并成一个(门面 `sspf::Platform::packs` / `.pack` 用)。")
L.append("///")
L.append("/// 🔴 与 [`registry`] 的分工:`registry` 装的是**本仓 `packs/*` 的示例包**;")
L.append("/// 本函数**只合并、不装载** ⇒ 业务仓用 `sspf::load_static` 装好自己的包后传进来。")
L.append("/// 🔴 空 vec ⇒ 空注册表(合法,不是错误)。")
L.append("/// 把**外部已装载**的注册表合并成一个(门面 `sspf::Platform::packs` 用)。")
L.append("/// 🔴 只合并、不装载;空 vec ⇒ 空注册表(合法)。")
L.append("pub fn registry_from(regs: Vec<PackRegistry>) -> PackRegistry {")
L.append(" sspf_plugin::merge(regs)")
L.append("}")
L.append("")
L.append("// ---------------------------------------------------------------- 清单快照")
L.append("//")
L.append("// 🔴 `pack.toml` 的**权威副本**在 `packs/<app>/pack.toml`(给人看、给导出工具读);")
L.append("// 这里是它的**编译期 JSON 快照**。为什么要快照、不运行期读文件:")
L.append("// 内核是**单二进制部署** ⇒ 运行目录里不一定有 `packs/` 目录。")
L.append("// 两份的一致性由 `scripts/pack-sync.py` 保证(`--check` 会比对)。")
L.append("//")
L.append("// 🔴 快照只在 `example-packs` 下编译(否则默认 feature 的构建里是死代码)。")
for p in packs:
app = p["app"]
const = app.upper().replace("-", "_") + "_MANIFEST_JSON"
L.append("")
L.append("/// `packs/%s/pack.toml` 的编译期快照。" % app)
L.append('#[cfg(feature = "example-packs")]')
L.append('const %s: &str = r#"%s"#;' % (const, manifest_json_of(p)))
return "\n".join(L).rstrip() + "\n"
@@ -738,109 +699,59 @@ def gen_pack_deps(packs):
def gen_pack_feature(packs):
"""生成 `src/backend/Cargo.toml` 的 `[features]` 段(`example-packs` 聚合开关)。
"""🔴 **已退役**(2026-11-04 清理):`example-packs` feature 随示例包一起搬走。
🔴 用 `dep:` 语法 ⇒ 不产生「与依赖同名的隐式 feature」,
业务仓不可能误开单个 `sspf-pack-demo`。
🔴 **空列表也要生成**(`example-packs = []`)—— 标记段必须存在,
否则 `pack-sync.py --check` 与闸门 AR17 都会失去判据。
平台仓现在**没有** `[features]` 段,也没有任何可选业务依赖;业务仓通过
`sspf::Platform::packs(reg)` 注入自己的注册表,不开任何平台 feature。
⇒ 本函数保留为「非空即报错」的护栏:谁把示例包塞回 `packs/`,同步直接失败。
"""
names = ['"dep:%s"' % _pack_crate_name(p["app"]) for p in packs]
return ["example-packs = [" + ", ".join(names) + "]"]
if packs:
raise SyncError(
"平台仓不允许自带业务包(发现 %d 个:%s)\n"
" ⇒ 业务包属于业务仓 / 技能仓,请通过 sspf::Platform::packs() 注入。"
% (len(packs), ", ".join(p["app"] for p in packs))
)
return []
def gen_mod_regions(mods):
"""生成 `modules/mod.rs` 的五个段 ⇒ `{段名: 行列表}`。
🔴 **`ALL_SPECS` 与 `ALL_ROUTES` 必须同序** —— 都按 `mods` 的顺序生成
⇒ `mod.rs` 的测试可以按 3 条一组配对(`chunks(3)`)。
这个「同序」不是约定,是**生成保证**。
🔴 **每个段都生成两份**(2026-11-04 标准平台包):
`#[cfg(feature = "example-packs")]` 的**实体清单**,
与 `#[cfg(not(feature = "example-packs"))]` 的**空清单**。
为什么不用「整段 cfg」:那会让 `all_specs()` / `all_menus()` / `router()`
在默认 feature 下**根本不存在** ⇒ `routes.rs` / `bootstrap.rs` 编译不过。
两份定义同名常量 / 函数 ⇒ 默认 feature 下**结构在、内容空**
(业务仓注入自己的东西,平台侧零业务)。
🔴 **2026-11-04 清理**:示例模块已搬到技能仓,本仓恒为零模块。
五个生成段全部归零 ⇒ `all_specs()` / `all_menus()` / `ALL_ROUTES` /
`router()` 都还在(装配链不破),只是**内容为空**。
业务仓用自己的路由 + `sspf::Platform` 注入,不需要往内核塞文件。
"""
if not mods:
raise SyncError("modules/ 下没有任何模块文件(至少要保住 demo/shop/books/asset)")
FEAT = '#[cfg(feature = "example-packs")]'
NOFEAT = '#[cfg(not(feature = "example-packs"))]'
decls = ["// 每个模块一行:**文件即登记**(顺序 = 文件名字典序,不代表业务顺序)。",
"// 🔴 只在 `example-packs` 下编译 —— 默认 feature 的内核**不认识任何业务模块**。"]
for app, _, _, _ in mods:
decls.append(FEAT)
decls.append("pub mod %s;" % app)
specs = [
"/// 全部业务实体 spec。",
"///",
"/// 🔴 **本段由 `scripts/pack-sync.py` 生成** —— 加模块不用手改(见文件头)。",
FEAT,
"pub const ALL_SPECS: &[EntitySpec] = &[",
]
for app, spec, _, _ in mods:
specs.append(" %s::%s," % (app, spec))
specs.append("];")
specs.append("/// 默认 feature:平台侧零业务 ⇒ 空清单(业务仓用 `sspf::Platform::packs` 注入)。")
specs.append(NOFEAT)
specs.append("pub const ALL_SPECS: &[EntitySpec] = &[];")
routes = [
"/// **全部业务路由**(面 A:`/api/ssw/{appCode}/{Entity}/{动作}`,每模块 3 条)。",
"///",
"/// 🔴 **与 `ALL_SPECS` 同序**(同一份模块清单生成)⇒ 可以按 3 条一组配对。",
FEAT,
"pub const ALL_ROUTES: &[&str] = &[",
]
for app, _, _, n in mods:
for i in range(n):
routes.append(" %s::ROUTES[%d]," % (app, i))
routes.append("];")
routes.append("/// 默认 feature:没有业务路由可登记。")
routes.append(NOFEAT)
routes.append("pub const ALL_ROUTES: &[&str] = &[];")
menus = [
"/// 全部业务内置菜单(由**装配根** [`crate::bootstrap`] 传给平台层的种子",
"/// ⇒ **平台层不认任何业务菜单**,红线 12)。",
FEAT,
"pub const ALL_MENUS: &[MenuSpec] = &[",
]
for app, _, menu, _ in mods:
menus.append(" %s::%s," % (app, menu))
menus.append("];")
menus.append("/// 默认 feature:平台侧零业务 ⇒ 种子只种平台菜单。")
menus.append(NOFEAT)
menus.append("pub const ALL_MENUS: &[MenuSpec] = &[];")
router = [
"/// **全部业务模块的路由**(`Router::merge` 进总路由)。",
"///",
"/// 🔴 加业务模块 ⇒ **不用改这里**(本段由 `pack-sync.py` 生成)。",
FEAT,
"pub fn router() -> Router<AppState> {",
" %s::router()" % mods[0][0],
]
for app, _, _, _ in mods[1:]:
router.append(" .merge(%s::router())" % app)
router.append("}")
router.append("/// 默认 feature:没有任何业务路由。")
router.append(NOFEAT)
router.append("pub fn router() -> Router<AppState> {")
router.append(" Router::new()")
router.append("}")
if mods:
raise SyncError(
"平台仓不允许自带业务模块(发现 %d 个:%s)\n"
" ⇒ 面 A 适配器属于业务仓,请用 sspf::Platform::router() 注入。"
% (len(mods), ", ".join(m[0] for m in mods))
)
return {
"MODS": decls,
"SPECS": specs,
"ROUTES": routes,
"MENUS": menus,
"ROUTER": router,
"MODS": [
"// 🔴 **平台包零业务**:本仓不认识任何业务模块。",
"// 业务模块的路由由业务仓经 `sspf::Platform::router()` 注入。",
],
"SPECS": [
"/// 本仓业务实体 spec:恒为空(平台包零业务)。",
"pub const ALL_SPECS: &[EntitySpec] = &[];",
],
"ROUTES": [
"/// 本仓业务路由表:恒为空(平台包零业务)。",
"pub const ALL_ROUTES: &[&str] = &[];",
],
"MENUS": [
"/// 本仓业务内置菜单:恒为空;业务菜单由 `.menus()` / `.packs()` 注入。",
"pub const ALL_MENUS: &[MenuSpec] = &[];",
],
"ROUTER": [
"/// 本仓业务路由:恒为空。",
"pub fn router() -> Router<AppState> {",
" Router::new()",
"}",
],
}
@@ -910,7 +821,9 @@ def sync(write=True):
# ④ Cargo 依赖段 + ⑤ `[features]` 段(两段都生成 ⇒ 「漏一处」不存在)
old = scan.read(BACKEND_CARGO)
new = replace_marker_block(old, GEN_DEPS_OPEN, GEN_DEPS_CLOSE, gen_pack_deps(packs))
new = replace_marker_block(new, GEN_FEAT_OPEN, GEN_FEAT_CLOSE, gen_pack_feature(packs))
# 🔴 `[features]` 段随示例包一起退役(2026-11-04):平台仓不再有任何
# 可选业务依赖 ⇒ 没有 feature 可生成。gen_pack_feature 只做「非空即报错」的护栏。
gen_pack_feature(packs)
artifacts.append(("src/backend/Cargo.toml", old, new, None))
if write:
+5 -5
View File
@@ -13,7 +13,7 @@
# 前置:后端已启动,且处于**初始种子状态**(admin / 123456)。
# 退出码:0 = 全绿(面 B 覆盖 23/23) / 1 = 有 FAIL 或有 SKIP(未全覆盖) / 2 = 前置错误
#
# 🔴 **面 B 的判别规则**(见 JNPF_COMPAT_SURFACE.md §2.2):
# 🔴 **面 B 的判别规则**(见 技能仓 JNPF_COMPAT_SURFACE.md §2.2):
# 请求头带 `Vue-Version: 3` ⇒ 走官方形状;否则走面 A。
# 官方前端**必然**带这三个头(jnpf-web-apps-main/src/api/request.ts:109-112),
# 但本仓 React 前端**也发** `App-Code` 与 `Jnpf-Origin: pc`(同款),
@@ -595,16 +595,16 @@ fi
# G8 · 授权:官方 body 超集(断言 17)+ 官方读用 POST(断言 18)
# =====================================================================
# 🔴 写入用的角色 = role_user,写入内容与面 A 尺子**完全相同**(module=["m_demo"])⇒ 幂等、互不干扰。
# 🔴 写入用的角色 = role_user,写入内容与面 A 尺子**完全相同**(module=["m_menu"])⇒ 幂等、互不干扰。
AUTH_WRITE="$(curl --noproxy '*' -s --max-time 10 -X PUT "$B/api/permission/Authority/Data/role_user" \
"${HDR_B[@]}" -H "$B_AUTH" -H 'Content-Type: application/json' \
-d '{"objectType":"role","module":["m_demo"],"button":[],"column":[],"resource":[],"form":[],"systemIds":[]}')"
-d '{"objectType":"role","module":["m_menu"],"button":[],"column":[],"resource":[],"form":[],"systemIds":[]}')"
AW_CODE="$(json_get code "$AUTH_WRITE")"
# 回读:走面 A 的只读端点(两把尺子共用一份数据 ⇒ 这才是真回读)
ROLE_MODS="$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/sys/Role/Modules?roleId=role_user" -H "$A_AUTH")"
ROLE_MOD_IDS="$(json_get strarray "$ROLE_MODS")"
if [ "$AW_CODE" = "200" ] && printf '%s' "$ROLE_MOD_IDS" | tr ',' '\n' | grep -qx 'm_demo'; then
assert1 "断言 17 · 授权写:官方完整 body(含 button/column/resource/form/systemIds)⇒ code=200 且 module 真落库" 1 "code=200, 回读含 m_demo"
if [ "$AW_CODE" = "200" ] && printf '%s' "$ROLE_MOD_IDS" | tr ',' '\n' | grep -qx 'm_menu'; then
assert1 "断言 17 · 授权写:官方完整 body(含 button/column/resource/form/systemIds)⇒ code=200 且 module 真落库" 1 "code=200, 回读含 m_menu"
else
assert1 "断言 17 · 授权写:官方完整 body(含 button/column/resource/form/systemIds)⇒ code=200 且 module 真落库" 0 "code=${AW_CODE}, 回读=${ROLE_MOD_IDS:-空}"
fi
+29 -75
View File
@@ -1,5 +1,5 @@
#!/usr/bin/env bash
# ssw-platform —— 权限闭环冒烟脚本(34 条断言 = 对齐 react 版的 32 条 + 多应用 2 条)
# ssw-platform —— 平台权限闭环 + 防回流冒烟脚本(21 条断言)
#
# 用法:
# bash scripts/perm-smoke.sh
@@ -9,7 +9,12 @@
#
# 前置:后端已启动,且处于**初始种子状态**(admin / 123456)。
# 幂等:脚本开头会删掉历史 smoke_user(存在才删)。
# 退出码:0 = 全绿(PASS=34 FAIL=0) / 1 = 有断言失败 / 2 = 前置错误(后端不可达、缺 jq+python3、缺 --enc 二进制)
# 退出码:0 = 全绿(PASS=21 FAIL=0) / 1 = 有断言失败 / 2 = 前置错误(后端不可达、缺 jq+python3、缺 --enc 二进制)
#
# 🔴 **平台包零业务**(2026-11-04 清理):示例包 demo/shop/books/asset 已搬到技能仓。
# 原来 43 条里的 25 条业务 CRUD 断言随之退役,换成 4 条「面 A 业务端点必须
# HTTP 404」的防回流判据;平台权限闭环(登录 / token / 菜单树 / 授权 / 多应用)
# 一条不少。断言条数仍由契约 [RULER] 钉住 ⇒ 尺子不会静默变弱。
#
# 🔴 不依赖 node:cipher 用后端 `--enc` 自证;JSON 取值用 jq(无则 python3 兜底)。
# 🔴 所有 curl 都带 `--noproxy '*'`(本机 curl 走系统代理,不加会打不通 loopback)与 `--max-time 10`(后端不回就超时,不许挂死)。
@@ -349,12 +354,12 @@ check '账号已存在:smoke_user' "$(json_get msg "$DUP_BODY")" "重复账号
# ---- 断言 10:写授权(一维数组 module)----
AUTH1="$(curl --noproxy '*' -s --max-time 10 -X PUT "$B/api/permission/Authority/Data/role_user" -H "$AUTH" \
-H 'Content-Type: application/json' -d '{"objectType":"role","module":["m_demo"]}')"
check 200 "$(json_get code "$AUTH1")" "写授权(一维)⇒ code=200"
-H 'Content-Type: application/json' -d '{"objectType":"role","module":["m_menu"]}')"
check 200 "$(json_get code "$AUTH1")" "写授权(一维,平台菜单 m_menu)⇒ code=200"
# ---- 断言 11:写授权(二维兼容 [checked, halfChecked])----
AUTH2="$(curl --noproxy '*' -s --max-time 10 -X PUT "$B/api/permission/Authority/Data/role_user" -H "$AUTH" \
-H 'Content-Type: application/json' -d '{"objectType":"role","module":[["m_demo"],[]]}')"
-H 'Content-Type: application/json' -d '{"objectType":"role","module":[["m_menu"],[]]}')"
check 200 "$(json_get code "$AUTH2")" "写授权(二维兼容)⇒ code=200"
# ---- 断言 12:smoke_user 登录(明文与建用户时的口径一致:'123456')----
@@ -367,8 +372,11 @@ check 200 "$(json_get code "$ALOGIN")" "smoke_user 登录 ⇒ code=200"
ATOKEN="$(json_get token "$ALOGIN")"
AAUTH="Authorization: bearer ${ATOKEN}"
# ---- 断言 13:smoke_user 菜单收窄为 Demo 示例 ----
check 'Demo 示例:' \
# ---- 断言 13:smoke_user 菜单按授权收窄(平台菜单 m_menu)----
# 🔴 零业务后菜单树只剩「系统管理」一族;授权 m_menu ⇒ 只留「菜单管理」这一项。
# 菜单树构造会把**被授权的叶子**提为根(父节点未授权就不带出来)⇒ 形状是
# `菜单管理:`(不是 `系统管理:菜单管理`);这个形状由 menutree 取值口径决定。
check '菜单管理:' \
"$(json_get menutree "$(curl --noproxy '*' -s --max-time 10 "$B/api/oauth/CurrentUser" -H "$AAUTH")")" \
"smoke_user 菜单已按授权收窄"
@@ -376,78 +384,24 @@ check 'Demo 示例:' \
check 403 "$(json_get code "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/sys/User/List" -H "$AAUTH")")" \
"smoke_user 访问 User/List ⇒ code=403"
# ---- 断言 15:smoke_user 访问 DemoItem/List(期望 200)----
check 200 "$(json_get code "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/demo/DemoItem/List" -H "$AAUTH")")" \
"smoke_user 访问 DemoItem/List ⇒ code=200"
# ---- 断言 15~18:防回流 —— 4 个示例业务端点必须**不存在**(HTTP 404)----
#
# 🔴 **平台包零业务**(2026-11-04 清理):示例包已整体搬到技能仓,本仓面 A 只留
# 平台路由。原来 17~41 那 25 条打的是 demo/shop/books/asset 的 CRUD + 权限,
# 现在改成「业务端点一律 404」⇒ 谁把示例业务接回平台仓,这里立刻红。
# 🔴 不是「模块不存在就跳过」的自适应分支:4 个前缀逐一真发请求,**条数固定进
# 契约 [RULER] 自证**,少一条就判尺子被改弱。
for biz in "demo/DemoItem/List" "shop/Product/List" "books/Book/List" "asset/DataResource/List"; do
BIZ_CODE="$(curl --noproxy '*' -s --max-time 10 -o /dev/null -w '%{http_code}' \
"$B/api/ssw/${biz}" -H "$AUTH")"
check 404 "${BIZ_CODE}" "防回流:/api/ssw/${biz} 必须 404(平台零业务)"
done
# ---- 断言 16:未知路由 ⇒ HTTP 404 ----
# ---- 断言 19:未知路由 ⇒ HTTP 404 ----
check 404 "$(curl --noproxy '*' -s --max-time 10 -o /dev/null -w '%{http_code}' "$B/api/not-exist-xyz")" \
"未知路由 HTTP 404 不被吞掉"
# ---- 断言 17:admin 访问 Product/List(管理员短路,期望 200)----
check 200 "$(json_get code "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/shop/Product/List" -H "$AUTH")")" \
"admin 访问 Product/List ⇒ code=200(管理员短路)"
# ---- 断言 18/19/20:Product 新建 + 主键长度 + numeric 往返 ----
PNEW="$(curl --noproxy '*' -s --max-time 10 -X POST "$B/api/ssw/shop/Product/Save" -H "$AUTH" \
-H 'Content-Type: application/json' -d '{"title":"测试产品","price":"9.90"}')"
check 200 "$(json_get code "$PNEW")" "Product 新建 ⇒ code=200"
check 36 "$(json_get idlen "$PNEW")" "Product 主键 = 36 位 UUID"
check '"9.90"' "$(json_get price "$PNEW")" "Product numeric 往返 = JSON 字符串 \"9.90\"(契约 R1.5)"
# ---- 断言 21/22:Product 无 token ⇒ 600;smoke_user 未授权 ⇒ 403 ----
check 600 "$(json_get code "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/shop/Product/List")")" \
"Product 无 token ⇒ code=600"
check 403 "$(json_get code "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/shop/Product/List" -H "$AAUTH")")" \
"Product 未授权非管理员 ⇒ code=403"
# ---- 断言 23:Book 列表(管理员短路,期望 200)----
# 🔴 本仓 books/Book 路由一定存在 ⇒ **不写「模块不存在就跳过」的自适应分支**(写了就等于少断言)。
BOOK_LIST="$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/books/Book/List" -H "$AUTH")"
check 200 "$(json_get code "$BOOK_LIST")" "Book 列表(admin 短路)⇒ code=200"
# ---- 断言 24~29:Book 新建(6 字段)+ 主键 + title/author/numeric/int 往返 ----
BNEW="$(curl --noproxy '*' -s --max-time 10 -X POST "$B/api/ssw/books/Book/Save" -H "$AUTH" \
-H 'Content-Type: application/json' \
-d '{"title":"三体","author":"刘慈欣","isbn":"9787229030937","category":"科幻","price":"58.00","stock":100}')"
check 200 "$(json_get code "$BNEW")" "Book 新建(6 字段)⇒ code=200"
check 36 "$(json_get idlen "$BNEW")" "Book 主键 = 36 位 UUID"
check "三体" "$(json_get title "$BNEW")" "Book title 往返"
check "刘慈欣" "$(json_get author "$BNEW")" "Book author 往返"
check '"58.00"' "$(json_get price "$BNEW")" "Book numeric 往返 = JSON 字符串 \"58.00\"(契约 R1.5)"
check 100 "$(json_get stock "$BNEW")" "Book int 库存往返 = JSON 数字 100"
# ---- 断言 30:Book 列表含新建项(长度 ≥ 1;新建**之后**重新查一次列表)----
BOOK_LIST2="$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/books/Book/List" -H "$AUTH")"
check ">=1" "$(json_get datalen "$BOOK_LIST2")" "Book 列表含新建项(长度 ≥ 1)"
# ---- 断言 31/32:Book 无 token ⇒ 600;smoke_user 未授权 ⇒ 403 ----
check 600 "$(json_get code "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/books/Book/List")")" \
"Book 无 token ⇒ code=600"
check 403 "$(json_get code "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/books/Book/List" -H "$AAUTH")")" \
"Book 未授权非管理员 ⇒ code=403"
# ---- 断言 33~41:asset/DataResource(尚数网真实业务:数据资源)----
# 🔴 字段取自公司本体 `DataResource`(名称 / 类别 / 提供方 …)⇒ 这条链是
# 「真实业务模块」的端到端证据(不是脚手架示例)。
RES_LIST="$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/asset/DataResource/List" -H "$AUTH")"
check 200 "$(json_get code "$RES_LIST")" "数据资源 列表(admin 短路)⇒ code=200"
RNEW="$(curl --noproxy '*' -s --max-time 10 -X POST "$B/api/ssw/asset/DataResource/Save" -H "$AUTH" \
-H 'Content-Type: application/json' \
-d '{"name":"全国企业工商登记数据","category":"结构化","scenario":"企业征信核验","provider":"尚数网","format":"CSV","scale":"1200万条","source":"平台收录"}')"
check 200 "$(json_get code "$RNEW")" "数据资源 新建(6 字段)⇒ code=200"
check 36 "$(json_get idlen "$RNEW")" "数据资源 主键 = 36 位 UUID"
check "全国企业工商登记数据" "$(json_get name "$RNEW")" "数据资源 name 往返"
check "结构化" "$(json_get category "$RNEW")" "数据资源 category 往返"
check "尚数网" "$(json_get provider "$RNEW")" "数据资源 provider 往返"
RES_LIST2="$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/asset/DataResource/List" -H "$AUTH")"
check ">=1" "$(json_get datalen "$RES_LIST2")" "数据资源 列表含新建项(长度 ≥ 1)"
check 600 "$(json_get code "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/asset/DataResource/List")")" \
"数据资源 无 token ⇒ code=600"
check 403 "$(json_get code "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/asset/DataResource/List" -H "$AAUTH")")" \
"数据资源 未授权非管理员 ⇒ code=403"
# ---- 断言 42/43:多应用 —— 当前应用由 `App-Code` 头决定(CLAUDE.md §4.1)----
# ---- 断言 20/21:多应用 —— 当前应用由 `App-Code` 头决定(CLAUDE.md §4.1)----
# 🔴 判据是**顶层** `currentSystemId`(面 A/面 B 同一口径):头缺失 ⇒ 回落主系统;
# 未知应用也回落主系统(不 500、不 panic)——这里用已注册的 app-b 验证真路由。
check "mainSystem" "$(json_get sysid "$MENU")" \
+6 -6
View File
@@ -155,12 +155,12 @@ if [ "${MODE}" = "lib" ] || [ "${MODE}" = "full" ] || [ "${MODE}" = "smoke" ]; t
if [ "${MODE}" = "lib" ]; then
run_step "单测(cargo test --lib)" \
cargo test --offline --workspace --lib
# 🔴 **包冒烟必须单独一步**(`full` / `smoke` 里已由 `--workspace` 覆盖 ⇒ 不重复):
# `--lib` 只跑单测 ⇒ 集成测试一条都不跑 ⇒ 下面这类**纯运行时**故障在这一档
# 完全看不见:包的表没建出来 / 面 B 路由没 merge / `module_key` 指向不存在的菜单。
# 它们全都**不会让静态闸门红**,只表现为「前端页面空着」。
# 代价实测 +1.3s(含起 pglite + 起 HTTP 服务)⇒ 放进中环完全值得。
run_step "包冒烟(每个包的 List 真应答,面 A + 面 B)" \
# 🔴 **运行时防回流探针必须单独一步**(`full` / `smoke` 里已由 `--workspace` 覆盖):
# `--lib` 只跑单测 ⇒ 集成测试一条都不跑 ⇒ 「平台是不是真的零业务」这一档
# 完全看不见(静态闸门只看文本,服务没起来/路由回流都测不到)。
# `pack_smoke_it` 在零业务清理后改成:清单恒空 + 平台端点仍活 + 4 个示例端点 404。
# 代价实测 +1.5s(含起 pglite + 起 HTTP 服务)⇒ 放进中环完全值得。
run_step "运行时防回流探针(零业务:清单空 / 平台活 / 业务端点 404)" \
cargo test --offline -p sspf-tests --test pack_smoke_it
else
run_step "全量测试(cargo test --workspace)" \