平台包零业务:示例移到技能仓、解绑 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:
1 parent
ca8abf9cc9
commit
ecb77b230f
94 files changed
+842
-8986
No files matched your search
+67
-65
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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"),
|
||||
)
|
||||
|
||||
# 承认的文件后缀(决定什么算「一条引文」)
|
||||
|
||||
@@ -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
@@ -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` 是本仓前端唯一不发的** ⇒ 判别只能用它。
|
||||
|
||||
@@ -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
@@ -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
@@ -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:
|
||||
|
||||
@@ -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
@@ -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
@@ -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)" \
|
||||
|
||||
Reference in new issue
Block a user