feat(platform): 标准平台包 v0.2.0 —— 门面 crate sspf + 示例包选装
- 新增 crates/sspf(0.2.0):Platform builder(packs/ddl/menus/router/static_dir/on_ready)
+ build_app/serve/serve_mcp;契约与运行时类型原样重导出(业务仓不碰 19 个 sspf-*)
- 内核 4 个示例包降为 example-packs feature(依赖 optional + 生成段 [features]);
packs_gen.rs / modules/mod.rs 改为 feature/not-feature 两份同名定义(整段 cfg 会让
all_specs() 在默认 feature 下不存在)
- 七步启动迁入门面;平台表清单 / 白名单对账落在内核 boot.rs;sspf-admin 1111 → 381 行
- routes::build_app_with(state, extras) + bootstrap::{ensure_base_with, ensure_schema_all_with},
旧签名保留 ⇒ 既有 704 个测试零改动;静态 SPA 托管手写在 routes.rs(不引 tower-http)
- 新增探针 crates/tests/tests/external_consumer_it.rs;闸门 AR17/AR18(反自证 13/13)
影响:业务仓只依赖 sspf 即可起服务;默认依赖树无 sspf-pack-*;面 A/B 行为一字未改。
回归:710 passed / 0 failed;check-arch 29/29;perm-smoke 43、perm-smoke-jnpf 23、
lowcode/baseline/mcp-smoke 15/10/14 全绿;仓外探针 /api/health = {"ok":true,"tables":177}。
This commit is contained in:
1 parent
acf076df5a
commit
9083394b8a
20 files changed
+2604
-887
No files matched your search
+189
-12
@@ -52,8 +52,15 @@
|
||||
# 到 `src/backend/tests/`、`crates/sspf-admin` 必须存在且产出 bin
|
||||
# —— 「内核是库、装配是应用、测试是消费者」这三条边界都是**文件位置**
|
||||
# ⇒ 没有任何编译错误会提示你踩线,只有结构慢慢退回原样
|
||||
# AR17 内核默认 feature 下不得编译期依赖 `packs/*`
|
||||
# —— `crates/sspf` 是业务仓唯一依赖的**标准平台包**;示例包一硬依赖,
|
||||
# `cargo add sspf` 就等于把 asset/demo/shop/books 拖进业务二进制
|
||||
# AR18 `crates/sspf/src/**` 不得出现业务字面量(业务仓名 / 业务表名 / `/api/ssw/`)
|
||||
# —— 门面是平台与业务的**唯一汇聚点**,两边都碰得到 ⇒ 「顺手写一句业务」
|
||||
# 的成本最低,而这类代码**不会让任何测试变红**
|
||||
#
|
||||
# 🔴 AR1–AR5 是 PLAN.md §3.2 的分层纪律;MEM1–MEM2 是判断 ⑥ 的四条内存红线的静态部分。
|
||||
# 🔴 AR17/AR18 是「sspf 标准平台包」(2026-11-04 P0)的边界:平台包里零业务。
|
||||
|
||||
set -u
|
||||
|
||||
@@ -89,7 +96,7 @@ skip() { SKIP=$((SKIP + 1)); printf '⏭ %s\n' "$1"; }
|
||||
|
||||
usage() {
|
||||
echo "用法: bash scripts/check-arch.sh [--self-test]"
|
||||
echo " 静态检查 crate 依赖纪律(AR1–AR7)与内存红线(MEM1–MEM2)"
|
||||
echo " 静态检查 crate 依赖纪律(AR1–AR18)与内存红线(MEM1–MEM2)"
|
||||
echo "退出码: 0 全过 / 1 有 ❌ / 2 用法错"
|
||||
}
|
||||
|
||||
@@ -757,12 +764,119 @@ check_ar16() {
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- AR17
|
||||
# **内核默认 feature 下不得编译期依赖 `packs/*`**(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` 开。
|
||||
#
|
||||
# 判据(三条,全部静态 —— 不跑 `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-*)⇒ 判据必须是**清单层面**的。
|
||||
check_ar17() {
|
||||
local toml="$KERNEL/Cargo.toml"
|
||||
[ -f "$toml" ] || { skip "AR17 内核 Cargo.toml 不存在"; return; }
|
||||
local hits=""
|
||||
|
||||
# ① 每条 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/^/ /')"
|
||||
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
|
||||
fi
|
||||
|
||||
if [ -z "$hits" ]; then
|
||||
ok "AR17 内核默认 feature 零业务包(示例包 optional + default 不含 example-packs)"
|
||||
else
|
||||
bad "AR17 平台包里混进了业务包(业务仓会被拖进示例包):"
|
||||
printf '%s\n' "$hits" | sed 's/^/ /'
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- AR18
|
||||
# **门面 crate 不得出现任何业务字面量**(2026-11-04 标准平台包)。
|
||||
#
|
||||
# 🔴 **为什么需要**:门面是「平台 ↔ 业务」的**唯一汇聚点** —— 它既认识平台的 19 个
|
||||
# crate,又会被业务仓依赖。正因为它两边都碰得到,「顺手写一句业务」的成本极低:
|
||||
# `${业务表}_list` 的默认路由、`/api/ssw/...` 的示例端点、某个租户的写死分支……
|
||||
# 这类代码**不会让任何测试变红**,但平台包就从「可复用」退化成「那一个业务的」。
|
||||
#
|
||||
# 判据:`crates/sspf/src/**` 里**任何一行**(含注释)不得出现:
|
||||
# - 业务仓名 `tdc`
|
||||
# - 本仓 4 个示例包的表名(`asset_data_resource` / `demo_item` /
|
||||
# `shop_product` / `book_shop_book`)
|
||||
# - 面 A 的端点前缀 `/api/ssw/`
|
||||
#
|
||||
# 🔴 **注释也扫**(故意的):门面里出现业务名,读者就会以为平台认识它。
|
||||
# 要写业务示例 ⇒ 写在 `docs/` 或业务仓自己那边。
|
||||
check_ar18() {
|
||||
local dir="$CRATES/sspf/src"
|
||||
[ -d "$dir" ] || { skip "AR18 门面 crate 不存在(crates/sspf)"; return; }
|
||||
local hits
|
||||
hits="$(python3 - "$dir" <<'PY'
|
||||
import os, re, sys
|
||||
pat = re.compile(r'(?i)(tdc|asset_data_resource|demo_item|shop_product|book_shop_book|/api/ssw/)')
|
||||
bad = []
|
||||
for root in sys.argv[1:]:
|
||||
for dirpath, _, files in os.walk(root):
|
||||
for fn in files:
|
||||
if not fn.endswith('.rs'):
|
||||
continue
|
||||
p = os.path.join(dirpath, fn)
|
||||
try:
|
||||
lines = open(p, encoding='utf-8').read().splitlines()
|
||||
except OSError:
|
||||
continue
|
||||
for i, line in enumerate(lines, 1):
|
||||
if pat.search(line):
|
||||
bad.append(f'{p}:{i}: {line.strip()}')
|
||||
for b in bad:
|
||||
print(b)
|
||||
PY
|
||||
)"
|
||||
if [ -z "$hits" ]; then
|
||||
ok "AR18 门面里没有业务字面量(无业务仓名 / 业务表名 / 面 A 端点)"
|
||||
else
|
||||
bad "AR18 门面里出现业务字面量(平台包退化成「那一个业务的」):"
|
||||
printf '%s\n' "$hits" | sed 's/^/ /'
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- 反自证
|
||||
# 🔴 永远返回「干净」的尺子 = 没有尺子。造明知违规的输入,必须被抓到。
|
||||
self_test() {
|
||||
local rc=0
|
||||
|
||||
echo "── 反自证 1/11:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
|
||||
echo "── 反自证 1/13:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
|
||||
local tmp="$ROOT/packs/__arch_selftest__"
|
||||
mkdir -p "$tmp"
|
||||
cat > "$tmp/Cargo.toml" <<'TOML'
|
||||
@@ -788,7 +902,7 @@ TOML
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 2/11:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
|
||||
echo "── 反自证 2/13:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **为什么必须自证 AR9**:它的判据是 `grep 目录`。
|
||||
# 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"**。
|
||||
@@ -827,7 +941,7 @@ TOML
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 3/11:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
|
||||
echo "── 反自证 3/13:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 造在**临时模块文件**上(不动真文件):只要它同时有 `pub use sspf_pack_`
|
||||
# 和 `= EntitySpec {`,PACK1 就必须红。
|
||||
@@ -853,7 +967,7 @@ RS
|
||||
echo "⏭ 跳过 PACK1 反自证(业务模块目录不存在)"
|
||||
fi
|
||||
|
||||
echo "── 反自证 4/11:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
|
||||
echo "── 反自证 4/13:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
|
||||
local pfile="$CRATES/sspf-plugin/Cargo.toml"
|
||||
if [ -f "$pfile" ]; then
|
||||
cp "$pfile" "$pfile.bak"
|
||||
@@ -874,7 +988,7 @@ RS
|
||||
echo "⏭ 跳过 AR8 反自证(sspf-plugin 不存在)"
|
||||
fi
|
||||
|
||||
echo "── 反自证 5/11:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
|
||||
echo "── 反自证 5/13:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR10**:它的判据是「扫平台层目录找契约面引用」。
|
||||
# 目录名写错 / 路径拼错 ⇒ 扫描永远返回空 ⇒ **永远"通过"** ⇒ 虚假安全感。
|
||||
@@ -910,7 +1024,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 6/11:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
|
||||
echo "── 反自证 6/13:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴🔴 **M7 起底座只有一处**:真源 `crates/sspf-compat-core/src/helper.rs`
|
||||
# (转发壳 `src/backend/src/platform/compat/helper.rs` 已随 M7 删除)。
|
||||
@@ -933,7 +1047,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 7/11:往壳里写 crate::platform::,AR15 必须报 ❌ ──"
|
||||
echo "── 反自证 7/13:往壳里写 crate::platform::,AR15 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR15**:删掉 `platform/` 转发壳之后,旧路径就**没有编译器**兜底了
|
||||
# —— 只要有人重建壳目录并把 import 改回去,**一切照常编译、测试照常全绿**,
|
||||
@@ -975,7 +1089,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 8/11:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──"
|
||||
echo "── 反自证 8/13:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **为什么必须自证 AR12**:它的判据是「读 Cargo.toml 找 sspf-compat-* 依赖」。
|
||||
# 若 grep 模式写错(包名含连字符/下划线混用)⇒ 永远扫不到依赖 ⇒
|
||||
@@ -1002,7 +1116,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 9/11:给执行层塞一个越界依赖 + 一条业务包引用,AR13 必须报 ❌ ──"
|
||||
echo "── 反自证 9/13:给执行层塞一个越界依赖 + 一条业务包引用,AR13 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR13**:它的判据是「读 Cargo.toml + grep 源码」。
|
||||
# 两种失效模式都得堵:
|
||||
@@ -1035,7 +1149,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 10/11:给适配层塞一个越界依赖 + 一条业务包引用,AR14 必须报 ❌ ──"
|
||||
echo "── 反自证 10/13:给适配层塞一个越界依赖 + 一条业务包引用,AR14 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR14**:它是 M6 新增的判据,守护的是「全仓唯一知道全部包的
|
||||
# 汇聚点」的依赖面。两种失效模式都得堵:
|
||||
@@ -1068,7 +1182,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 11/11:内核加回 [[bin]] + 塞回 tests/*.rs,AR16 必须两处都报 ❌ ──"
|
||||
echo "── 反自证 11/13:内核加回 [[bin]] + 塞回 tests/*.rs,AR16 必须两处都报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR16**:它的三条判据全是「文件/目录在不在」——
|
||||
# 路径写错(比如把 $KERNEL 拼成别的名字)⇒ 永远判「没问题」⇒
|
||||
@@ -1102,6 +1216,67 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 12/13:把内核一条示例包依赖改成非 optional,AR17 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **为什么自证 AR17**:它的判据是「grep 依赖行里有没有 optional」。
|
||||
# grep 的模式写错 ⇒ 永远匹配不到 ⇒ **永远"通过"**(与 AR9 同一类风险)。
|
||||
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
|
||||
local a17before=$FAIL
|
||||
check_ar17 >/dev/null 2>&1
|
||||
local a17caught=0
|
||||
[ "$FAIL" -gt "$a17before" ] && a17caught=1
|
||||
mv "$a17toml.ar17bak" "$a17toml"
|
||||
FAIL=$a17before
|
||||
[ "$a17caught" -eq 1 ] && a17ok=1
|
||||
fi
|
||||
if [ "$a17ok" -eq 1 ]; then
|
||||
echo "✅ 反自证通过:AR17 抓到了非 optional 的示例包依赖"
|
||||
else
|
||||
echo "❌ 反自证失败:AR17 没抓到非 optional 的示例包依赖 ⇒ 尺子是假的"
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 13/13:往门面里塞一句业务字面量,AR18 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **为什么自证 AR18**:它扫的是「门面源码里的业务名」。目录写错 / 正则写错
|
||||
# ⇒ 永远空 ⇒ 永远"通过"。这条自证保证「平台包里零业务」不是一句口号。
|
||||
local a18dir="$CRATES/sspf/src"
|
||||
local a18ok=0
|
||||
if [ -d "$a18dir" ]; then
|
||||
printf 'pub const AR18_SELFTEST: &str = "tdc_order";\n' > "$a18dir/__ar18_selftest.rs"
|
||||
local a18before=$FAIL
|
||||
check_ar18 >/dev/null 2>&1
|
||||
local a18caught=0
|
||||
[ "$FAIL" -gt "$a18before" ] && a18caught=1
|
||||
rm -f "$a18dir/__ar18_selftest.rs"
|
||||
FAIL=$a18before
|
||||
[ "$a18caught" -eq 1 ] && a18ok=1
|
||||
fi
|
||||
if [ "$a18ok" -eq 1 ]; then
|
||||
echo "✅ 反自证通过:AR18 抓到了门面里的业务表名"
|
||||
else
|
||||
echo "❌ 反自证失败:AR18 没抓到门面里的业务字面量 ⇒ 尺子是假的"
|
||||
rc=1
|
||||
fi
|
||||
|
||||
return $rc
|
||||
}
|
||||
|
||||
@@ -1125,6 +1300,8 @@ check_ar13
|
||||
check_ar14
|
||||
check_ar15
|
||||
check_ar16
|
||||
check_ar17
|
||||
check_ar18
|
||||
check_pack1
|
||||
check_mem1
|
||||
check_mem2
|
||||
|
||||
+97
-9
@@ -85,6 +85,8 @@ GEN_OPEN = "// >>>GEN:%s"
|
||||
GEN_CLOSE = "// <<<GEN:%s"
|
||||
GEN_DEPS_OPEN = "# >>>GEN:PACK_DEPS"
|
||||
GEN_DEPS_CLOSE = "# <<<GEN:PACK_DEPS"
|
||||
GEN_FEAT_OPEN = "# >>>GEN:PACK_FEATURE"
|
||||
GEN_FEAT_CLOSE = "# <<<GEN:PACK_FEATURE"
|
||||
|
||||
# 🔴 **契约表的段名**(与 `contract_expect.py` 的 SCHEMAS 对齐)。
|
||||
SEC_MODULE = "MODULE"
|
||||
@@ -639,6 +641,11 @@ def gen_packs_gen(packs):
|
||||
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("")
|
||||
L.append("use sspf_plugin::{LoadError, PackRegistry};")
|
||||
L.append("")
|
||||
@@ -646,6 +653,7 @@ def gen_packs_gen(packs):
|
||||
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("")
|
||||
@@ -665,88 +673,167 @@ def gen_packs_gen(packs):
|
||||
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("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("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"
|
||||
|
||||
|
||||
def _pack_crate_name(app):
|
||||
"""包目录名 ⇒ crate 名(读 `packs/<app>/Cargo.toml` 的 `[package].name`)。"""
|
||||
cargo = os.path.join(PACKS_DIR, app, "Cargo.toml")
|
||||
name = app
|
||||
if os.path.isfile(cargo):
|
||||
with open(cargo, "rb") as fh:
|
||||
name = tomllib.load(fh).get("package", {}).get("name", name)
|
||||
return name
|
||||
|
||||
|
||||
def gen_pack_deps(packs):
|
||||
"""生成 `src/backend/Cargo.toml` 的包依赖段(每包一行)。"""
|
||||
"""生成 `src/backend/Cargo.toml` 的包依赖段(每包一行,**全部 optional**)。
|
||||
|
||||
🔴 **为什么 `optional = true`**(2026-11-04,标准平台包 / P0):
|
||||
内核是**可被外部仓依赖的平台包**。业务仓(tdc-rs)只该拿到平台能力,
|
||||
不该被拖进本仓的 4 个示例包(`asset` / `demo` / `shop` / `books`)。
|
||||
⇒ 依赖降为可选,默认 feature 下 `cargo tree -p sspf` 里**没有**
|
||||
`sspf-pack-*`(`check-arch.sh` 的 AR17 钉住)。
|
||||
"""
|
||||
out = []
|
||||
for p in packs:
|
||||
cargo = os.path.join(PACKS_DIR, p["app"], "Cargo.toml")
|
||||
name = p["app"]
|
||||
if os.path.isfile(cargo):
|
||||
with open(cargo, "rb") as fh:
|
||||
name = tomllib.load(fh).get("package", {}).get("name", name)
|
||||
out.append('%s = { path = "../../packs/%s" }' % (name, p["app"]))
|
||||
out.append(
|
||||
'%s = { path = "../../packs/%s", optional = true }'
|
||||
% (_pack_crate_name(p["app"]), p["app"])
|
||||
)
|
||||
return out
|
||||
|
||||
|
||||
def gen_pack_feature(packs):
|
||||
"""生成 `src/backend/Cargo.toml` 的 `[features]` 段(`example-packs` 聚合开关)。
|
||||
|
||||
🔴 用 `dep:` 语法 ⇒ 不产生「与依赖同名的隐式 feature」,
|
||||
业务仓不可能误开单个 `sspf-pack-demo`。
|
||||
🔴 **空列表也要生成**(`example-packs = []`)—— 标记段必须存在,
|
||||
否则 `pack-sync.py --check` 与闸门 AR17 都会失去判据。
|
||||
"""
|
||||
names = ['"dep:%s"' % _pack_crate_name(p["app"]) for p in packs]
|
||||
return ["example-packs = [" + ", ".join(names) + "]"]
|
||||
|
||||
|
||||
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 下**结构在、内容空**
|
||||
(业务仓注入自己的东西,平台侧零业务)。
|
||||
"""
|
||||
if not mods:
|
||||
raise SyncError("modules/ 下没有任何模块文件(至少要保住 demo/shop/books/asset)")
|
||||
|
||||
decls = ["// 每个模块一行:**文件即登记**(顺序 = 文件名字典序,不代表业务顺序)。"]
|
||||
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("}")
|
||||
|
||||
return {
|
||||
"MODS": decls,
|
||||
@@ -820,9 +907,10 @@ def sync(write=True):
|
||||
new = replace_rust_region(new, region, body)
|
||||
artifacts.append(("src/backend/src/modules/mod.rs", old, new, None))
|
||||
|
||||
# ④ Cargo 依赖段
|
||||
# ④ 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))
|
||||
artifacts.append(("src/backend/Cargo.toml", old, new, None))
|
||||
|
||||
if write:
|
||||
|
||||
Reference in new issue
Block a user