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:
admin committed 2026-11-04 16:39:47 +08:00
1 parent acf076df5a
commit 9083394b8a
20 files changed
+2604 -887

No files matched your search

+189 -12
View File
@@ -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
View File
@@ -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: