feat(platform): 标准平台包 v0.3.0 —— 业务自带状态的可组合装配
- Db 暴露同一个 Arc<PGlite>(Db::pg());Platform 两阶段装配 Assembled/Finish - Extras 加自带状态路由 / 可替换兜底 / 全局层,with_state 前移;默认路径行为不变 - 新增探针 business_composition_it 与闸门 AR19(反自证 14/14) - 文档:CHANGELOG / known-limitations / 需求稿实施记录与勘误
This commit is contained in:
1 parent
2b4f4d15b4
commit
6d6e0ee329
14 files changed
+1217
-82
No files matched your search
+92
-14
@@ -60,7 +60,12 @@
|
||||
# 的成本最低,而这类代码**不会让任何测试变红**
|
||||
#
|
||||
# 🔴 AR1–AR5 是 PLAN.md §3.2 的分层纪律;MEM1–MEM2 是判断 ⑥ 的四条内存红线的静态部分。
|
||||
# AR19 唯一装配链:`routes.rs` 只允许一个 `pub fn build_app_with`、一处
|
||||
# `.layer(catch_all())` 与恰好 2 处互斥的 fallback 调用;`Extras.router_owned`
|
||||
# 注释必须写明「不许自带 fallback」—— 业务自带状态路由若抄第二遍链,
|
||||
# 404 兜底会静默错位且测试全绿(S25)。
|
||||
# 🔴 AR17/AR18 是「sspf 标准平台包」(2026-11-04 P0)的边界:平台包里零业务。
|
||||
# 🔴 AR19 是「业务自带状态的可组合装配」(2026-11-04 P1)的边界:装配链仍然只有一份。
|
||||
|
||||
set -u
|
||||
|
||||
@@ -96,7 +101,7 @@ skip() { SKIP=$((SKIP + 1)); printf '⏭ %s\n' "$1"; }
|
||||
|
||||
usage() {
|
||||
echo "用法: bash scripts/check-arch.sh [--self-test]"
|
||||
echo " 静态检查 crate 依赖纪律(AR1–AR18)与内存红线(MEM1–MEM2)"
|
||||
echo " 静态检查 crate 依赖纪律(AR1–AR19)与内存红线(MEM1–MEM2)"
|
||||
echo "退出码: 0 全过 / 1 有 ❌ / 2 用法错"
|
||||
}
|
||||
|
||||
@@ -871,12 +876,60 @@ PY
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- AR19
|
||||
# **唯一装配链**(2026-11-04 v0.3.0 两阶段装配)。
|
||||
#
|
||||
# 🔴 **为什么需要**:业务自带状态的 `Router<()>` 现在能在 merge 点注入,
|
||||
# 「自己再抄一遍 fallback + layer + with_state」的诱惑变大了 —— 抄错顺序时
|
||||
# axum 不报编译错,404 兜底只是悄悄失去 catch-all 保护,且**测试全绿**。
|
||||
#
|
||||
# 判据(只看 `src/backend/src/routes.rs` 的**非注释**代码行):
|
||||
# - `pub fn build_app_with` 恰好 1 处;
|
||||
# - `.layer(catch_all())` 恰好 1 处;
|
||||
# - `.fallback(` / `.fallback_service(` 恰好 2 处(`if/else` 互斥分支 ⇒ 恒只有一个生效);
|
||||
# - `Extras.router_owned` 的文档注释必须含「不许自带 fallback」。
|
||||
check_ar19() {
|
||||
local file="$KERNEL/src/routes.rs"
|
||||
[ -f "$file" ] || { skip "AR19 routes.rs 不存在"; return; }
|
||||
local hits
|
||||
hits="$(python3 - "$file" <<'PY'
|
||||
import re, sys
|
||||
lines = open(sys.argv[1], encoding='utf-8').read().splitlines()
|
||||
code = [(i, l) for i, l in enumerate(lines, 1) if not l.lstrip().startswith('//')]
|
||||
def hits(pat):
|
||||
return [(i, l) for i, l in code if re.search(pat, l)]
|
||||
bad = []
|
||||
n = hits(r'pub fn build_app_with\b')
|
||||
if len(n) != 1:
|
||||
bad.append(f'unique-chain: pub fn build_app_with 应恰好 1 处,实际 {len(n)} 处')
|
||||
n = hits(r'\.layer\(catch_all\(\)\)')
|
||||
if len(n) != 1:
|
||||
bad.append(f'unique-catch-all: .layer(catch_all()) 应恰好 1 处,实际 {len(n)} 处')
|
||||
n = hits(r'\.fallback(_service)?\(')
|
||||
if len(n) != 2:
|
||||
bad.append(f'single-fallback: fallback 调用点应恰好 2 处(互斥分支),实际 {len(n)} 处')
|
||||
doc = '\n'.join(lines)
|
||||
m = re.search(r'((?:^\s*///.*\n)+)\s*pub router_owned:', doc, re.M)
|
||||
if not m or '不许自带 fallback' not in m.group(1):
|
||||
bad.append('router_owned-doc: Extras.router_owned 注释缺「不许自带 fallback」约定')
|
||||
for b in bad:
|
||||
print(b)
|
||||
PY
|
||||
)"
|
||||
if [ -z "$hits" ]; then
|
||||
ok "AR19 唯一装配链(build_app_with / catch_all / 单兜底 / 自带状态路由注释)"
|
||||
else
|
||||
bad "AR19 装配链被抄了第二遍(或兜底挂法退化):"
|
||||
printf '%s\n' "$hits" | sed 's/^/ /'
|
||||
fi
|
||||
}
|
||||
|
||||
# ---------------------------------------------------------------- 反自证
|
||||
# 🔴 永远返回「干净」的尺子 = 没有尺子。造明知违规的输入,必须被抓到。
|
||||
self_test() {
|
||||
local rc=0
|
||||
|
||||
echo "── 反自证 1/13:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
|
||||
echo "── 反自证 1/14:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
|
||||
local tmp="$ROOT/packs/__arch_selftest__"
|
||||
mkdir -p "$tmp"
|
||||
cat > "$tmp/Cargo.toml" <<'TOML'
|
||||
@@ -902,7 +955,7 @@ TOML
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 2/13:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
|
||||
echo "── 反自证 2/14:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **为什么必须自证 AR9**:它的判据是 `grep 目录`。
|
||||
# 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"**。
|
||||
@@ -941,7 +994,7 @@ TOML
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 3/13:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
|
||||
echo "── 反自证 3/14:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 造在**临时模块文件**上(不动真文件):只要它同时有 `pub use sspf_pack_`
|
||||
# 和 `= EntitySpec {`,PACK1 就必须红。
|
||||
@@ -967,7 +1020,7 @@ RS
|
||||
echo "⏭ 跳过 PACK1 反自证(业务模块目录不存在)"
|
||||
fi
|
||||
|
||||
echo "── 反自证 4/13:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
|
||||
echo "── 反自证 4/14:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
|
||||
local pfile="$CRATES/sspf-plugin/Cargo.toml"
|
||||
if [ -f "$pfile" ]; then
|
||||
cp "$pfile" "$pfile.bak"
|
||||
@@ -988,7 +1041,7 @@ RS
|
||||
echo "⏭ 跳过 AR8 反自证(sspf-plugin 不存在)"
|
||||
fi
|
||||
|
||||
echo "── 反自证 5/13:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
|
||||
echo "── 反自证 5/14:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR10**:它的判据是「扫平台层目录找契约面引用」。
|
||||
# 目录名写错 / 路径拼错 ⇒ 扫描永远返回空 ⇒ **永远"通过"** ⇒ 虚假安全感。
|
||||
@@ -1024,7 +1077,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 6/13:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
|
||||
echo "── 反自证 6/14:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴🔴 **M7 起底座只有一处**:真源 `crates/sspf-compat-core/src/helper.rs`
|
||||
# (转发壳 `src/backend/src/platform/compat/helper.rs` 已随 M7 删除)。
|
||||
@@ -1047,7 +1100,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 7/13:往壳里写 crate::platform::,AR15 必须报 ❌ ──"
|
||||
echo "── 反自证 7/14:往壳里写 crate::platform::,AR15 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR15**:删掉 `platform/` 转发壳之后,旧路径就**没有编译器**兜底了
|
||||
# —— 只要有人重建壳目录并把 import 改回去,**一切照常编译、测试照常全绿**,
|
||||
@@ -1089,7 +1142,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 8/13:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──"
|
||||
echo "── 反自证 8/14:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **为什么必须自证 AR12**:它的判据是「读 Cargo.toml 找 sspf-compat-* 依赖」。
|
||||
# 若 grep 模式写错(包名含连字符/下划线混用)⇒ 永远扫不到依赖 ⇒
|
||||
@@ -1116,7 +1169,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 9/13:给执行层塞一个越界依赖 + 一条业务包引用,AR13 必须报 ❌ ──"
|
||||
echo "── 反自证 9/14:给执行层塞一个越界依赖 + 一条业务包引用,AR13 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR13**:它的判据是「读 Cargo.toml + grep 源码」。
|
||||
# 两种失效模式都得堵:
|
||||
@@ -1149,7 +1202,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 10/13:给适配层塞一个越界依赖 + 一条业务包引用,AR14 必须报 ❌ ──"
|
||||
echo "── 反自证 10/14:给适配层塞一个越界依赖 + 一条业务包引用,AR14 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR14**:它是 M6 新增的判据,守护的是「全仓唯一知道全部包的
|
||||
# 汇聚点」的依赖面。两种失效模式都得堵:
|
||||
@@ -1182,7 +1235,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 11/13:内核加回 [[bin]] + 塞回 tests/*.rs,AR16 必须两处都报 ❌ ──"
|
||||
echo "── 反自证 11/14:内核加回 [[bin]] + 塞回 tests/*.rs,AR16 必须两处都报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR16**:它的三条判据全是「文件/目录在不在」——
|
||||
# 路径写错(比如把 $KERNEL 拼成别的名字)⇒ 永远判「没问题」⇒
|
||||
@@ -1216,7 +1269,7 @@ RS
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 12/13:把内核一条示例包依赖改成非 optional,AR17 必须报 ❌ ──"
|
||||
echo "── 反自证 12/14:把内核一条示例包依赖改成非 optional,AR17 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **为什么自证 AR17**:它的判据是「grep 依赖行里有没有 optional」。
|
||||
# grep 的模式写错 ⇒ 永远匹配不到 ⇒ **永远"通过"**(与 AR9 同一类风险)。
|
||||
@@ -1254,7 +1307,7 @@ PY
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 13/13:往门面里塞一句业务字面量,AR18 必须报 ❌ ──"
|
||||
echo "── 反自证 13/14:往门面里塞一句业务字面量,AR18 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **为什么自证 AR18**:它扫的是「门面源码里的业务名」。目录写错 / 正则写错
|
||||
# ⇒ 永远空 ⇒ 永远"通过"。这条自证保证「平台包里零业务」不是一句口号。
|
||||
@@ -1277,6 +1330,30 @@ PY
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 14/14:往 routes.rs 塞第二处 .layer(catch_all()),AR19 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **为什么自证 AR19**:它数的是「非注释代码里 catch_all 层的条数」。
|
||||
# 正则写错 / 扫描面写错 ⇒ 永远数到 1 ⇒ 永远"通过"。
|
||||
local a19file="$KERNEL/src/routes.rs"
|
||||
local a19ok=0
|
||||
if [ -f "$a19file" ]; then
|
||||
cp "$a19file" "$a19file.ar19bak"
|
||||
printf '\nfn __ar19_selftest() { let _ = axum::Router::new().layer(catch_all()); }\n' >> "$a19file"
|
||||
local a19before=$FAIL
|
||||
check_ar19 >/dev/null 2>&1
|
||||
local a19caught=0
|
||||
[ "$FAIL" -gt "$a19before" ] && a19caught=1
|
||||
mv "$a19file.ar19bak" "$a19file"
|
||||
FAIL=$a19before
|
||||
[ "$a19caught" -eq 1 ] && a19ok=1
|
||||
fi
|
||||
if [ "$a19ok" -eq 1 ]; then
|
||||
echo "✅ 反自证通过:AR19 抓到了第二处 catch_all 层"
|
||||
else
|
||||
echo "❌ 反自证失败:AR19 没抓到重复的装配链层 ⇒ 尺子是假的"
|
||||
rc=1
|
||||
fi
|
||||
|
||||
return $rc
|
||||
}
|
||||
|
||||
@@ -1302,6 +1379,7 @@ check_ar15
|
||||
check_ar16
|
||||
check_ar17
|
||||
check_ar18
|
||||
check_ar19
|
||||
check_pack1
|
||||
check_mem1
|
||||
check_mem2
|
||||
|
||||
Reference in new issue
Block a user