refactor(arch): M2 平台核心下沉 —— 19 模块迁入 crates/sspf-core + 闸门扫真源
平台能力全迁 crates/ 迁移计划第 2 批(docs/CRATES-MIGRATION.md,基线 tag v0.1.0)。
本批次 = M2:平台核心从 src/backend/src/platform/ 下沉到 crates/sspf-core/。
搬迁:
- 19 个模块 git mv 进 crates/sspf-core/src/(保留历史):
auth/authorization/cipher/config/crud/db/entity/envelope/guard/ids/menu/
monitor/registry/route/seed/session/state/sys/variate_catalog
- src/backend/src/platform/*.rs 全改成 pub use sspf_core::<mod>::* 转发壳(5 行/个)
⇒ 上层零感知:routes / modules / 695 个测试的 import 一个没改
- crate 内路径改写 crate::platform::X → crate::X(compat 除外,那是 M3/M4)
- pub(crate) → pub(10 处,跨 crate 后失效)
闸门改造(🔴 本批最大风险不是代码是闸门 —— 搬迁后闸门扫空壳 = 虚假安全感):
- 纪律 = 「两处都扫」:真源 crates/sspf-core/src/(管实现)+ 转发壳(防塞私货)
- check-arch.sh AR9/AR10 扫两处;反自证 2/6、5/6 两处注入探针且按路径分别验
- check-boundary.sh 新增 PLATFORM_CORE;CP1/CP2 两处扫;CP6 的 seed.rs 改读真源
- check-contract-scan.py 的 plat_files 两处都收、重名键拼接(覆盖会丢函数 ⇒ 推不出守卫)
- check-module.sh 的 CRUD 改读 crates/sspf-core/src/crud.rs(软删契约要看 SQL)
- gen-function-catalog.py 的 OUT 改写真源(否则覆盖转发壳 ⇒ 上层 import 全断)
- 反向验证:只往 crates/sspf-core/ 塞违规 ⇒ AR9/AR10 都报红(证明真在扫真源)
测试归属调整:crud.rs 3 个测试原依赖 crate::modules::all_specs()(业务层)
⇒ 改用契约层合成 spec 参数化测试;registry.rs 测试改自建库 + seed::ensure_base(db, &[])。
顺带记录技术债:write_cast 的 numeric 映射是列名枚举而非 spec 声明。
影响:功能零变化(路由、响应形状、语义均未动),纯结构下沉。
验证:cargo build 零警告;cargo test --workspace 695 passed / 0 failed(与基线一致);
check-arch 14/14;--self-test 6/6;check-boundary 11/11;check-contract 10/10(反自证 12 例全过);
check-module 123/123;check-citations 4/4;verify --smoke 14 步全绿(512.3s)。
This commit is contained in:
1 parent
215b5e8fcf
commit
94d05f4649
52 files changed
+7085
-6643
No files matched your search
+99
-67
@@ -28,9 +28,10 @@
|
||||
# —— 适配器只认工具契约层;依赖内核 store 就等于把第二种后端钉死在本进程旁
|
||||
# AR7 `crates/sspf-lowcode` 依赖 ⊆ {sspf-contract, serde, serde_json}
|
||||
# —— 低代码引擎是纯计算;依赖 DB/HTTP 会让它只能在内核里跑,且测试必须起库
|
||||
# AR9 `src/backend/src/platform/**` 里不许出现 `use sspf_pack_*`
|
||||
# AR9 平台层(真源 `crates/sspf-core/src/**` + 转发壳 `src/backend/src/platform/**`)
|
||||
# 里不许出现 `use sspf_pack_*`
|
||||
# —— 平台层不许认识任何业务包(业务知识隔离)
|
||||
# AR10 `src/backend/src/platform/**`(不含 compat/)里不许出现
|
||||
# AR10 平台层(同上两处,不含 compat/)里不许出现
|
||||
# `crate::platform::compat` —— 平台层不许**反向依赖**契约面
|
||||
# —— M1 解开的环 A;拆 crate 时它就是循环依赖(编译器当天才报错 ⇒ 必须提前钉住)
|
||||
# AR11 `src/backend/src/platform/compat/helper.rs` 里不许 `use super::<别的模块>`
|
||||
@@ -38,7 +39,7 @@
|
||||
# —— M1 解开的环 B/C
|
||||
# MEM1 非注释代码里不许出现 `SELECT *`
|
||||
# —— 终端产品内存预算 ≤ 120MB(PLAN.md 判断 ⑥)⇒ 全表读进 Vec 直接爆
|
||||
# MEM2 `crates/**` 与 `src/backend/src/platform/**` 里不许出现无界 `HashMap` 缓存
|
||||
# MEM2 `crates/**` 与 `src/backend/src/**` 里不许出现无界 `HashMap` 缓存
|
||||
# (近似检查:`static` + `Mutex<HashMap` 必须有 `MAX` 常量同文件出现)
|
||||
#
|
||||
# 🔴 AR1–AR5 是 PLAN.md §3.2 的分层纪律;MEM1–MEM2 是判断 ⑥ 的四条内存红线的静态部分。
|
||||
@@ -206,17 +207,23 @@ check_ar8() {
|
||||
#
|
||||
# 🔴 方向是「内核 ⇒ 包」,**不是**「包 ⇒ 内核」:`src/backend/Cargo.toml` 依赖
|
||||
# `sspf-pack-<app>` 是**允许**的(装配根要装载它们);
|
||||
# 但 `src/backend/src/platform/**` 里出现 `use sspf_pack_*` ⇒ 平台层知道了
|
||||
# 但**平台层**里出现 `use sspf_pack_*` ⇒ 平台层知道了
|
||||
# 具体业务 ⇒ 加/删业务包就要改平台层 ⇒ 「链接就好」这个承诺是假的。
|
||||
# 🔴 **M2 起平台层的真源在 `crates/sspf-core/src/`**,`src/backend/src/platform/`
|
||||
# 只剩转发壳(`pub use sspf_core::*`)+ 尚未搬走的 `compat/`(M3/M4)。
|
||||
# ⇒ 闸门必须**两处都扫**:扫真源(管实现)+ 扫转发壳(防有人往壳里塞实现)。
|
||||
# 只扫壳 = 尺子量空壳 = 虚假安全感。
|
||||
check_ar9() {
|
||||
local dir="$KERNEL/src/platform"
|
||||
[ -d "$dir" ] || { skip "AR9 平台层目录不存在"; return; }
|
||||
local dirs=()
|
||||
[ -d "$CRATES/sspf-core/src" ] && dirs+=("$CRATES/sspf-core/src")
|
||||
[ -d "$KERNEL/src/platform" ] && dirs+=("$KERNEL/src/platform")
|
||||
[ "${#dirs[@]}" -gt 0 ] || { skip "AR9 平台层目录不存在"; return; }
|
||||
local hits
|
||||
hits="$(grep -rnE '^[[:space:]]*(pub )?use[[:space:]]+sspf_pack_' "$dir" 2>/dev/null || true)"
|
||||
hits="$(grep -rnE '^[[:space:]]*(pub )?use[[:space:]]+sspf_pack_' "${dirs[@]}" 2>/dev/null || true)"
|
||||
if [ -z "$hits" ]; then
|
||||
ok "AR9 平台层没有 use sspf_pack_*(业务知识没漏进 platform/)"
|
||||
ok "AR9 平台层没有 use sspf_pack_*(业务知识没漏进 sspf-core/ 或 platform/)"
|
||||
else
|
||||
bad "AR9 平台层出现了业务包引用(业务知识漏进 platform/ ⇒ 加包要改平台层):"
|
||||
bad "AR9 平台层出现了业务包引用(业务知识漏进平台层 ⇒ 加包要改平台层):"
|
||||
printf '%s\n' "$hits" | sed 's/^/ /'
|
||||
fi
|
||||
}
|
||||
@@ -234,41 +241,43 @@ check_ar9() {
|
||||
# **照样编译通过、测试照样全绿**,只有到 M2 那天才炸 ⇒ 那时候已经改了一堆东西,
|
||||
# 回滚成本高得多。⇒ 现在就把它拦住。
|
||||
#
|
||||
# 判据:`src/backend/src/platform/**`(**不含 compat/**)里不许出现
|
||||
# `crate::platform::compat` / `super::compat` / `crate::compat`。
|
||||
# 判据:平台层真源(`crates/sspf-core/src/**`)与转发壳(`src/backend/src/platform/**`,
|
||||
# **不含 compat/**)里都不许出现 `crate::platform::compat` / `super::compat` / `crate::compat`。
|
||||
check_ar10() {
|
||||
local dir="$KERNEL/src/platform"
|
||||
[ -d "$dir" ] || { skip "AR10 平台层目录不存在"; return; }
|
||||
local dirs=()
|
||||
[ -d "$CRATES/sspf-core/src" ] && dirs+=("$CRATES/sspf-core/src")
|
||||
[ -d "$KERNEL/src/platform" ] && dirs+=("$KERNEL/src/platform")
|
||||
[ "${#dirs[@]}" -gt 0 ] || { skip "AR10 平台层目录不存在"; return; }
|
||||
local hits
|
||||
# 🔴 **必须排除注释行**(`//` / `//!` / `///`)—— 文档注释里的路径引用是
|
||||
# **给人看的**(如 `//! (见 crate::platform::compat::helper::load_menus])`),
|
||||
# 不是依赖 ⇒ 不该判红。
|
||||
# 🔴 纯 grep 过滤不了:`//!` 前面**没有空格** ⇒ `^\s*//` 漏掉它。
|
||||
# 这里用 python3 逐行判(与 MEM1/MEM2 同一套路)。
|
||||
hits="$(python3 - "$dir" <<'PY'
|
||||
hits="$(python3 - "${dirs[@]}" <<'PY'
|
||||
import os, re, sys
|
||||
root = sys.argv[1]
|
||||
pat = re.compile(r'(crate::platform::compat|crate::compat|super::compat)')
|
||||
bad = []
|
||||
for dirpath, dirnames, files in os.walk(root):
|
||||
dirnames[:] = [d for d in dirnames if d != 'compat'] # 契约面自己互引合法
|
||||
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):
|
||||
s = line.strip()
|
||||
# 整行注释(含 `//!` / `///`)⇒ 跳过
|
||||
if s.startswith('//'):
|
||||
for root in sys.argv[1:]:
|
||||
for dirpath, dirnames, files in os.walk(root):
|
||||
dirnames[:] = [d for d in dirnames if d != 'compat'] # 契约面自己互引合法
|
||||
for fn in files:
|
||||
if not fn.endswith('.rs'):
|
||||
continue
|
||||
# 行尾注释:把 `//` 之后截掉再判(`use x::y; // 说明` 里的说明不算)
|
||||
code = line.split('//', 1)[0]
|
||||
if pat.search(code):
|
||||
bad.append(f'{p}:{i}: {s}')
|
||||
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):
|
||||
s = line.strip()
|
||||
# 整行注释(含 `//!` / `///`)⇒ 跳过
|
||||
if s.startswith('//'):
|
||||
continue
|
||||
# 行尾注释:把 `//` 之后截掉再判(`use x::y; // 说明` 里的说明不算)
|
||||
code = line.split('//', 1)[0]
|
||||
if pat.search(code):
|
||||
bad.append(f'{p}:{i}: {s}')
|
||||
for b in bad:
|
||||
print(b)
|
||||
PY
|
||||
@@ -466,26 +475,40 @@ TOML
|
||||
|
||||
echo "── 反自证 2/6:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **为什么必须自证 AR9**:它的判据是 `grep platform/`。
|
||||
# 🔴 **为什么必须自证 AR9**:它的判据是 `grep 目录`。
|
||||
# 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"**。
|
||||
# 这类尺子比没有更危险(它给出虚假的安全感)。
|
||||
local probe="$KERNEL/src/platform/__ar9_selftest.rs"
|
||||
if [ -d "$KERNEL/src/platform" ]; then
|
||||
printf 'use sspf_pack_asset::DATA_RESOURCE_SPEC;\n' > "$probe"
|
||||
before=$FAIL
|
||||
check_ar9 >/dev/null 2>&1
|
||||
caught=0
|
||||
[ "$FAIL" -gt "$before" ] && caught=1
|
||||
rm -f "$probe"
|
||||
FAIL=$before
|
||||
if [ "$caught" -eq 1 ]; then
|
||||
echo "✅ 反自证通过:AR9 抓到了平台层里的 use sspf_pack_*"
|
||||
else
|
||||
echo "❌ 反自证失败:AR9 没抓到平台层里的业务包引用 ⇒ 尺子是假的"
|
||||
rc=1
|
||||
# 🔴 **M2 起必须注入两处**:真源 `crates/sspf-core/src/`(实现所在)
|
||||
# + 转发壳 `src/backend/src/platform/`。**只注入一处不够** ——
|
||||
# 若闸门只扫壳不扫真源(或反之),单点注入会漏判 ⇒ 两处都注入、
|
||||
# 且**两处都被抓到**才算尺子有效。
|
||||
local a9core="$CRATES/sspf-core/src/__ar9_selftest.rs"
|
||||
local a9shell="$KERNEL/src/platform/__ar9_selftest.rs"
|
||||
local a9ok=0
|
||||
if [ -d "$CRATES/sspf-core/src" ] || [ -d "$KERNEL/src/platform" ]; then
|
||||
[ -d "$CRATES/sspf-core/src" ] && printf 'use sspf_pack_asset::DATA_RESOURCE_SPEC;\n' > "$a9core"
|
||||
[ -d "$KERNEL/src/platform" ] && printf 'use sspf_pack_asset::DATA_RESOURCE_SPEC;\n' > "$a9shell"
|
||||
local a9out
|
||||
a9out="$(check_ar9 2>&1 || true)"
|
||||
rm -f "$a9core" "$a9shell"
|
||||
# 🔴 **按路径分别验**:必须证明闸门**两处都看得到** ——
|
||||
# 只验「输出里有 __ar9_selftest」不够(单处抓到会误判成两处都抓到)。
|
||||
local a9need=0 a9c=0
|
||||
if [ -d "$CRATES/sspf-core/src" ]; then
|
||||
a9need=$((a9need+1))
|
||||
echo "$a9out" | grep -q "sspf-core/src/__ar9_selftest" && a9c=$((a9c+1))
|
||||
fi
|
||||
if [ -d "$KERNEL/src/platform" ]; then
|
||||
a9need=$((a9need+1))
|
||||
echo "$a9out" | grep -q "platform/__ar9_selftest" && a9c=$((a9c+1))
|
||||
fi
|
||||
[ "$a9need" -gt 0 ] && [ "$a9c" -ge "$a9need" ] && a9ok=1
|
||||
fi
|
||||
if [ "$a9ok" -eq 1 ]; then
|
||||
echo "✅ 反自证通过:AR9 抓到了真源与转发壳里的 use sspf_pack_*"
|
||||
else
|
||||
echo "⏭ 跳过 AR9 反自证(平台层目录不存在)"
|
||||
echo "❌ 反自证失败:AR9 没抓到平台层里的业务包引用(或漏扫了真源/转发壳)⇒ 尺子是假的"
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 3/6:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
|
||||
@@ -537,26 +560,35 @@ RS
|
||||
|
||||
echo "── 反自证 5/6:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
|
||||
#
|
||||
# 🔴 **必须自证 AR10**:它的判据是 `grep platform/`。
|
||||
# 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"** ⇒ 虚假安全感。
|
||||
# 而且这条判据守护的是**拆 crate 的前置条件** —— 它一旦失效,M2 当天才炸。
|
||||
local a10probe="$KERNEL/src/platform/__ar10_selftest.rs"
|
||||
if [ -d "$KERNEL/src/platform" ]; then
|
||||
printf 'use crate::platform::compat::helper::current_user;\n' > "$a10probe"
|
||||
before=$FAIL
|
||||
check_ar10 >/dev/null 2>&1
|
||||
caught=0
|
||||
[ "$FAIL" -gt "$before" ] && caught=1
|
||||
rm -f "$a10probe"
|
||||
FAIL=$before
|
||||
if [ "$caught" -eq 1 ]; then
|
||||
echo "✅ 反自证通过:AR10 抓到了平台层里的 crate::platform::compat"
|
||||
else
|
||||
echo "❌ 反自证失败:AR10 没抓到平台层的契约面反向依赖 ⇒ 尺子是假的"
|
||||
rc=1
|
||||
# 🔴 **必须自证 AR10**:它的判据是「扫平台层目录找契约面引用」。
|
||||
# 目录名写错 / 路径拼错 ⇒ 扫描永远返回空 ⇒ **永远"通过"** ⇒ 虚假安全感。
|
||||
# 而且这条判据守护的是**拆 crate 的前置条件** —— 它一旦失效,后续批次才炸。
|
||||
# 🔴 **M2 起注入两处**(真源 + 转发壳),与 2/6 同理:单点注入会漏判。
|
||||
local a10core="$CRATES/sspf-core/src/__ar10_selftest.rs"
|
||||
local a10shell="$KERNEL/src/platform/__ar10_selftest.rs"
|
||||
local a10ok=0
|
||||
if [ -d "$CRATES/sspf-core/src" ] || [ -d "$KERNEL/src/platform" ]; then
|
||||
[ -d "$CRATES/sspf-core/src" ] && printf 'use crate::platform::compat::helper::current_user;\n' > "$a10core"
|
||||
[ -d "$KERNEL/src/platform" ] && printf 'use crate::platform::compat::helper::current_user;\n' > "$a10shell"
|
||||
local a10out
|
||||
a10out="$(check_ar10 2>&1 || true)"
|
||||
rm -f "$a10core" "$a10shell"
|
||||
local a10need=0 a10c=0
|
||||
if [ -d "$CRATES/sspf-core/src" ]; then
|
||||
a10need=$((a10need+1))
|
||||
echo "$a10out" | grep -q "sspf-core/src/__ar10_selftest" && a10c=$((a10c+1))
|
||||
fi
|
||||
if [ -d "$KERNEL/src/platform" ]; then
|
||||
a10need=$((a10need+1))
|
||||
echo "$a10out" | grep -q "platform/__ar10_selftest" && a10c=$((a10c+1))
|
||||
fi
|
||||
[ "$a10need" -gt 0 ] && [ "$a10c" -ge "$a10need" ] && a10ok=1
|
||||
fi
|
||||
if [ "$a10ok" -eq 1 ]; then
|
||||
echo "✅ 反自证通过:AR10 抓到了真源与转发壳里的 crate::platform::compat"
|
||||
else
|
||||
echo "⏭ 跳过 AR10 反自证(平台层目录不存在)"
|
||||
echo "❌ 反自证失败:AR10 没抓到平台层的契约面反向依赖(或漏扫了真源/转发壳)⇒ 尺子是假的"
|
||||
rc=1
|
||||
fi
|
||||
|
||||
echo "── 反自证 6/6:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
|
||||
|
||||
+19
-10
@@ -38,6 +38,10 @@ ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
BACKEND="$ROOT/src/backend"
|
||||
SRC="$BACKEND/src"
|
||||
PLATFORM="$SRC/platform"
|
||||
# 🔴 **M2 起平台层真源在 `crates/sspf-core/src/`**,`src/backend/src/platform/`
|
||||
# 只剩转发壳(`pub use sspf_core::*`)+ 尚未搬走的 `compat/`(M3/M4)。
|
||||
# ⇒ 所有「扫平台层」的判据必须**两处都扫**(真源管实现、壳防塞私货)。
|
||||
PLATFORM_CORE="$ROOT/crates/sspf-core/src"
|
||||
MODULES="$SRC/modules"
|
||||
MODULES_MOD="$MODULES/mod.rs"
|
||||
BOOTSTRAP="$SRC/bootstrap.rs"
|
||||
@@ -110,7 +114,8 @@ hdr "[CP1] 平台层零业务标识符(扫字符串字面量;禁止清单从
|
||||
# 🔴 **业务层现在有两处**(批次 12 交付物 ②):`modules/*.rs`(面 A 内嵌)
|
||||
# + `packs/*/src/lib.rs`(业务包)⇒ 两处都要进「禁止清单」,
|
||||
# 否则包里的业务表名会从清单里消失 ⇒ 尺子变弱。
|
||||
SCAN_OUT="$(SSW_PACKS_DIR="${ROOT}/packs" "${PY_BIN}" "${SCAN}" "${MODULES}" "${PLATFORM}" "${SRC}/routes.rs" "${SRC}/main.rs" "${BOOTSTRAP}" 2>&1)"
|
||||
# 🔴 **M2 起平台层真源在 `crates/sspf-core/src/`** ⇒ 它必须进扫描面(否则扫空壳)。
|
||||
SCAN_OUT="$(SSW_PACKS_DIR="${ROOT}/packs" "${PY_BIN}" "${SCAN}" "${MODULES}" "${PLATFORM_CORE}" "${PLATFORM}" "${SRC}/routes.rs" "${SRC}/main.rs" "${BOOTSTRAP}" 2>&1)"
|
||||
if [ "$?" -eq 0 ]; then
|
||||
ok "平台层没有业务标识符($(printf '%s\n' "${SCAN_OUT}" | tail -1))"
|
||||
else
|
||||
@@ -119,12 +124,13 @@ else
|
||||
fi
|
||||
|
||||
# ---- CP2 平台层不反向依赖业务层 ----
|
||||
hdr "[CP2] 平台层不反向依赖业务层(platform/** 不许 use crate::modules)"
|
||||
CP2_HITS="$(grep -rn "use crate::modules" "${PLATFORM}" 2>/dev/null)"
|
||||
hdr "[CP2] 平台层不反向依赖业务层(sspf-core/** 与 platform/** 不许 use crate::modules)"
|
||||
# 🔴 两处都扫:真源 `crates/sspf-core/src/`(实现)+ 转发壳(防塞私货)。
|
||||
CP2_HITS="$(grep -rn "use crate::modules" "${PLATFORM_CORE}" "${PLATFORM}" 2>/dev/null)"
|
||||
if [ -z "${CP2_HITS}" ]; then
|
||||
ok "platform/** 没有 use crate::modules"
|
||||
ok "sspf-core/** 与 platform/** 都没有 use crate::modules"
|
||||
else
|
||||
no "platform/** 引用了业务层:"
|
||||
no "平台层引用了业务层:"
|
||||
printf '%s\n' "${CP2_HITS}" | sed 's/^/ /'
|
||||
fi
|
||||
|
||||
@@ -223,24 +229,27 @@ else
|
||||
fi
|
||||
|
||||
# ---- CP6 平台层自带菜单:条数与 id 都由**契约**推出来 ----
|
||||
hdr "[CP6] 平台层自带菜单(条数与 id 都由契约 [MENU] 推出来;业务菜单不许混进 platform/seed.rs)"
|
||||
hdr "[CP6] 平台层自带菜单(条数与 id 都由契约 [MENU] 推出来;业务菜单不许混进 seed.rs)"
|
||||
# 🔴 M2 起 `seed.rs` 真源在 `crates/sspf-core/src/seed.rs`(转发壳里没有 BUILTIN_MENUS)。
|
||||
SEED_RS="${PLATFORM_CORE}/seed.rs"
|
||||
[ -f "${SEED_RS}" ] || SEED_RS="${PLATFORM}/seed.rs"
|
||||
PLATFORM_MENU_COUNT="$(awk '
|
||||
/const BUILTIN_MENUS: \[MenuSpec; / { inb = 1; next }
|
||||
inb && /^\];/ { inb = 0; next }
|
||||
inb && /^[[:space:]]*id: "/ { n++ }
|
||||
END { print n + 0 }
|
||||
' "${PLATFORM}/seed.rs")"
|
||||
' "${SEED_RS}")"
|
||||
if [ "${PLATFORM_MENU_COUNT}" -eq "${CE_EXP_PLATFORM_MENUS}" ]; then
|
||||
ok "platform/seed.rs 的 BUILTIN_MENUS 恰好 ${CE_EXP_PLATFORM_MENUS} 条系统菜单(契约菜单 ${CE_MENU_COUNT} 条 − 业务模块 ${CE_MOD_COUNT} 个)"
|
||||
ok "seed.rs 的 BUILTIN_MENUS 恰好 ${CE_EXP_PLATFORM_MENUS} 条系统菜单(契约菜单 ${CE_MENU_COUNT} 条 − 业务模块 ${CE_MOD_COUNT} 个)"
|
||||
else
|
||||
no "platform/seed.rs 的 BUILTIN_MENUS 有 ${PLATFORM_MENU_COUNT} 条(契约推出应为 ${CE_EXP_PLATFORM_MENUS} 条 = 契约菜单 ${CE_MENU_COUNT} − 业务模块 ${CE_MOD_COUNT})"
|
||||
no "seed.rs 的 BUILTIN_MENUS 有 ${PLATFORM_MENU_COUNT} 条(契约推出应为 ${CE_EXP_PLATFORM_MENUS} 条 = 契约菜单 ${CE_MENU_COUNT} − 业务模块 ${CE_MOD_COUNT})"
|
||||
fi
|
||||
# 平台层那几条的 id,必须**逐条**等于契约 [MENU] 里「不属于任何业务模块」的那些 id
|
||||
PLATFORM_MENU_IDS="$(awk '
|
||||
/const BUILTIN_MENUS: \[MenuSpec; / { inb = 1; next }
|
||||
inb && /^\];/ { inb = 0; next }
|
||||
inb && /^[[:space:]]*id: "/ { s = $0; sub(/^[ \t]*id: "/, "", s); sub(/".*/, "", s); print s }
|
||||
' "${PLATFORM}/seed.rs" | sort | tr '\n' ' ')"
|
||||
' "${SEED_RS}" | sort | tr '\n' ' ')"
|
||||
CE_PLATFORM_MENU_IDS="$(printf '%s\n' "${CE_MENU_ROWS}" | awk -F'\t' -v biz="${CE_BUSINESS_MENU_IDS}" '
|
||||
NR > 1 {
|
||||
skip = 0
|
||||
|
||||
@@ -826,12 +826,32 @@ def scan_code(src_dir, packs_dir=None):
|
||||
|
||||
plat_dir = os.path.join(src_dir, "platform")
|
||||
plat_files = {"__routes__": (plat_orig, plat_masked)}
|
||||
if os.path.isdir(plat_dir):
|
||||
for name in sorted(os.listdir(plat_dir)):
|
||||
if name.endswith(".rs"):
|
||||
p = os.path.join(plat_dir, name)
|
||||
o = read(p)
|
||||
plat_files[name[:-3]] = (o, mask_rust(o))
|
||||
|
||||
def _absorb(key, o):
|
||||
"""把一个源文件收进 plat_files;重名键**拼接**(而非覆盖)。
|
||||
|
||||
🔴 **为什么拼接**:M2 起平台层有两处 —— 真源 `crates/sspf-core/src/`
|
||||
(实现)与转发壳 `platform/<模块>.rs`(`pub use sspf_core::*`)。
|
||||
守卫推导按模块名查 `plat_files[mod]`;若后扫的覆盖先扫的,
|
||||
一边的函数就**推不出守卫** ⇒ CC6 退化成「全是 WARN」⇒ 静默失效。
|
||||
拼接 ⇒ 两处定义的函数都看得见(壳里若有私货也逃不掉)。
|
||||
"""
|
||||
m = mask_rust(o)
|
||||
if key in plat_files:
|
||||
o0, m0 = plat_files[key]
|
||||
plat_files[key] = (o0 + "\n" + o, m0 + "\n" + m)
|
||||
else:
|
||||
plat_files[key] = (o, m)
|
||||
|
||||
# 🔴 **平台层真源**(M2):`crates/sspf-core/src/<模块>.rs` ——
|
||||
# 实现都搬到这里,守卫推导必须扫它(否则推不出 ⇒ CC6 静默失效)。
|
||||
core_dir = os.path.join(ROOT, "crates", "sspf-core", "src")
|
||||
for d in (core_dir, plat_dir):
|
||||
if os.path.isdir(d):
|
||||
for name in sorted(os.listdir(d)):
|
||||
if name.endswith(".rs"):
|
||||
p = os.path.join(d, name)
|
||||
_absorb(name[:-3], read(p))
|
||||
# 🔴 **契约面实现文件**(批次 17 补):`platform/compat/<模块>.rs` ——
|
||||
# 契约面按官方模块名分文件(`online_dev.rs` / `report.rs` / `system.rs` …),
|
||||
# 路由注册写 `compat::<模块>::<handler>` ⇒ 这些文件**必须**进 `plat_files`,
|
||||
|
||||
@@ -43,7 +43,10 @@ MODULES_DIR="$BACKEND/src/modules"
|
||||
MODULES_MOD="$MODULES_DIR/mod.rs"
|
||||
ROUTES="$BACKEND/src/routes.rs"
|
||||
SCHEMA="$BACKEND/db/schema.sql"
|
||||
CRUD="$BACKEND/src/platform/crud.rs"
|
||||
# 🔴 **M2 起 `crud.rs` 真源在 `crates/sspf-core/src/crud.rs`**(转发壳里没有 SQL)。
|
||||
# 软删契约(`WHERE f_delete_mark = 0` / `SET f_delete_mark = 1`)必须读实现文件。
|
||||
CRUD="$ROOT/crates/sspf-core/src/crud.rs"
|
||||
[ -f "$CRUD" ] || CRUD="$BACKEND/src/platform/crud.rs"
|
||||
FE="$ROOT/src/frontend"
|
||||
|
||||
# 🔴 **本仓是后端-only**(CLAUDE.md §2.2:前端/移动端本期不动,沿用 Java 版)。
|
||||
|
||||
@@ -9,7 +9,7 @@
|
||||
① 漏条 —— 前端某个函数在帮助里点不开,但没人发现;
|
||||
② 抄错 HTML 描述 —— 帮助面板显示成乱码/错行,且没有闸门能发现。
|
||||
|
||||
所以:**官方枚举是唯一真源**,本脚本把它转成 `src/backend/src/platform/variate_catalog.rs`。
|
||||
所以:**官方枚举是唯一真源**,本脚本把它转成 `crates/sspf-core/src/variate_catalog.rs`。
|
||||
改了官方枚举就重跑;`--check` 用于闸门(生成物与真源不一致 ⇒ 非零退出)。
|
||||
|
||||
用法
|
||||
@@ -31,7 +31,9 @@ JAVA_DIR = pathlib.Path(
|
||||
"/Users/xs/Desktop/workspace/jnpf/jnpf-java-boot/jnpf-system/"
|
||||
"jnpf-system-entity/src/main/java/jnpf/base/model/variate"
|
||||
)
|
||||
OUT = ROOT / "src" / "backend" / "src" / "platform" / "variate_catalog.rs"
|
||||
# 🔴 **M2 起生成物的真源在 `crates/sspf-core/src/variate_catalog.rs`** ——
|
||||
# 写旧路径会**覆盖转发壳**(`pub use sspf_core::*`)⇒ 上层 import 全断。
|
||||
OUT = ROOT / "crates" / "sspf-core" / "src" / "variate_catalog.rs"
|
||||
|
||||
|
||||
def read(path: pathlib.Path) -> str:
|
||||
|
||||
Reference in new issue
Block a user