init: 尚数网平台 JNPF 7.0 兼容后端(多应用 + 面 A/面 B 双契约)

- axum 0.8 + pglite:12 张表,多应用按 App-Code 头解析 f_system_id 隔离
- 面 A(ssw/react 形状)+ 面 B(官方 JNPF 形状,Vue-Version: 3)双契约并存
- 业务模块 asset/DataResource;面 B 用户 CRUD 9 条已落地
- 六道闸门 + 两把运行时尺子(perm-smoke 43 / perm-smoke-jnpf 23)
- scripts/:前端接口清单、页面依赖反查、运行时探针
This commit is contained in:
sukyboor committed 2026-10-30 22:08:31 +08:00
commit 9771fa844d
95 files changed
+30592

No files matched your search

+573
View File
@@ -0,0 +1,573 @@
#!/usr/bin/env bash
# ssw-platform 加业务模块的「接触点」静态自检(Rust 版)
#
# 目的:在跑 perm-smoke 之前,**快速发现漏改的文件或字符串不一致**——这类问题一旦漏掉,
# 表现是「菜单不显示」「页面 404」「权限静默放行」,非常难定位。
#
# 🔴 **10 个接触点**(每个业务模块都要碰这 10 处):
# ① 业务模块文件 + 3 条路由 ② spec 定义 ③ 实体表 DDL ④ 守卫 module_key
# ⑤ 前端 api 文件 ⑥ 前端页面 ⑦ 前端路由 ⑧ **菜单声明**(`*_MENU`)
# ⑨ **菜单登记**(`ALL_MENUS`) ⑩ 三处一字不差(module_key == url_address == Route path)
#
# 🔴 **纯静态**:不启动后端、不发一个请求、不依赖 node(契约明令:后端与冒烟脚本零 node 依赖)。
# ⇒ 用法里**没有** `--live`;传了未知参数 ⇒ 退出码 2(用法错)。
#
# 🔴 **期望值的唯一真源 = `docs/contract.md` 附录 A**(机器可读区段 `[MODULE]` / `[MENU]` /
# `[RULER]`,由 `scripts/contract_expect.py` 解析)。
# 本脚本**不再硬编码**表名 / 路由 / 菜单 id ⇒
# ① 改契约(加模块、改菜单)⇒ 只改 contract.md 一处;
# ② 代码漂移 ⇒ 本脚本立刻报「与契约不一致」(不是默默放过)。
#
# 用法:
# bash scripts/check-module.sh # 无参 ⇒ 检查契约里登记的全部业务模块
# bash scripts/check-module.sh <appCode> <Entity> # 也可只查一个(如 books Book)
# bash scripts/check-module.sh --help # 本用法
#
# 例:
# bash scripts/check-module.sh # demo / shop / books 全查
# bash scripts/check-module.sh books Book # 单模块
#
# 退出码:0 全过 / 1 有 ❌ 项 / 2 用法错
# 🔴 **故意只用 `set -u`,不加 `-e` / `pipefail`** —— 这是有意的取舍,不是漏写:
# 本脚本的判定**依赖 grep 的返回码**(grep 命中 ⇒ 记一条 ✅,不命中 ⇒ 记一条 ❌)。
# 若加 `-e`,**第一条没命中的 grep 就会中止整个脚本** ⇒ 闸门只跑了一半就“静默变绿/变红”,
# 反而把闸门弄坏。加 `pipefail` 同理(管道里任一段非 0 都会中止)。
# ⇒ 想要「失败即停」请自己看末尾的 `PASS=` / `FAIL=` 与退出码。
set -u
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
BACKEND="$ROOT/src/backend"
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"
FE="$ROOT/src/frontend"
# 🔴 **本仓是后端-only**(CLAUDE.md §2.2:前端/移动端本期不动,沿用 Java 版)。
# 脚手架原版假设 `src/frontend` 存在 ⇒ 前端接触点(5 前端 api / 6 前端页面 /
# 7 前端路由 / 全局面 A 判别头)在本仓**不适用**。
# ⇒ 无前端时这些接触点打印 `⏭` 并**仍计入条数**(与 check-citations.sh 的 skip
# 语义一致)—— 不许静默减条数,否则尺子会被悄悄改弱。
if [ -d "$FE/src" ]; then HAS_FE=1; else HAS_FE=0; fi
# ---- 契约期望值(唯一真源:docs/contract.md 附录 A)----
CE_PY="$ROOT/scripts/contract_expect.py"
if ! command -v python3 >/dev/null 2>&1; then
echo "❌ 前置错误:找不到 python3(读契约期望值用)。"
exit 2
fi
if [ ! -f "$CE_PY" ]; then
echo "❌ 前置错误:找不到 ${CE_PY}。"
exit 2
fi
ce() { python3 "${CE_PY}" "$@"; }
# 一次取全表(表头行 + 数据行,制表符分隔)
CE_MOD_ROWS="$(ce rows MODULE 2>/dev/null)" || {
echo "❌ 前置错误:读契约的 [MODULE] 区段失败(docs/contract.md 的附录 A 是不是被改坏了?)。"
exit 2
}
CE_MENU_ROWS="$(ce rows MENU 2>/dev/null)" || {
echo "❌ 前置错误:读契约的 [MENU] 区段失败(docs/contract.md 的附录 A 是不是被改坏了?)。"
exit 2
}
CE_RULER_ROWS="$(ce rows RULER 2>/dev/null)" || {
echo "❌ 前置错误:读契约的 [RULER] 区段失败(docs/contract.md 的附录 A 是不是被改坏了?)。"
exit 2
}
# 从「表头行 + 数据行」里按首列取某列的值;找不到 ⇒ 返回空 + 非 0
#
# 🔴 用 awk(-F'\t')而**不是** bash `read`:bash 的 `read` 按 IFS 空白折叠连续分隔符,
# 会把**空字段**(如 MENU.icon = NULL)吃掉 ⇒ 读出来错位。awk 保留空字段。
row_field() {
local rows="$1" key="$2" col="$3"
printf '%s\n' "${rows}" | awk -F'\t' -v key="${key}" -v col="${col}" '
NR == 1 { for (i = 1; i <= NF; i++) if ($i == col) c = i; next }
$1 == key { print $c; found = 1; exit }
END { if (!found) exit 3 }
'
}
usage() {
echo "用法: bash scripts/check-module.sh [<appCode> <Entity>...]"
echo " 无参 ⇒ 检查全部三个业务模块(demo / shop / books)"
echo "例: bash scripts/check-module.sh"
echo " bash scripts/check-module.sh books Book"
echo "退出码: 0 全过 / 1 有 ❌ 项 / 2 用法错"
}
if [ "${1:-}" = "-h" ] || [ "${1:-}" = "--help" ]; then
usage
exit 0
fi
# ---- 目标清单:appCode:Entity(默认取**契约** [MODULE] 区段登记的全部模块)----
CE_ALL_TARGETS="$(printf '%s\n' "${CE_MOD_ROWS}" | awk -F'\t' 'NR>1 { print $1 ":" $2 }')"
TARGETS=()
if [ "$#" -eq 0 ]; then
while IFS= read -r line; do
[ -n "${line}" ] || continue
TARGETS+=("${line}")
done <<< "${CE_ALL_TARGETS}"
else
APP_ARG="$1"
shift
if [ "$#" -eq 0 ]; then
echo "❌ 用法错:<appCode> 后面至少要跟一个 <Entity>"
usage
exit 2
fi
for ENT_ARG in "$@"; do
case "${ENT_ARG}" in
-*)
echo "❌ 未知参数: ${ENT_ARG}"
usage
exit 2
;;
esac
TARGETS+=("${APP_ARG}:${ENT_ARG}")
done
fi
# ---- 期望值表(**逐字来自契约** `docs/contract.md` 附录 A 的 `[MODULE]` 区段)----
# 每个目标:表名 / urlAddress(= 前端 Route path)/ 菜单 id / module_key(None = 仅登录)
# / **前端 api 文件该有没有**(有 = 有 / 无 = 走 view 直连分支)
# / **业务模块文件**(`src/backend/src/modules/<app>.rs` —— spec + handler + 路由)
#
# 🔴 **新增业务模块时**:在契约 `[MODULE]` 加一行 + 在 `[MENU]` 加一行 ⇒ 本脚本自动覆盖它。
# (本脚本**不再硬编码**任何业务标识符 ⇒ 加模块不用改脚本。)
T_COUNT=${#TARGETS[@]}
T_APP=(); T_ENT=(); T_TABLE=(); T_ROUTE=(); T_SEED=(); T_MK=(); T_API=(); T_FILE=()
for T in "${TARGETS[@]}"; do
A="${T%%:*}"
E="${T##*:}"
C_ENT="$(row_field "${CE_MOD_ROWS}" "${A}" entity)"
C_TABLE="$(row_field "${CE_MOD_ROWS}" "${A}" table)"
C_URL="$(row_field "${CE_MOD_ROWS}" "${A}" urlAddress)"
C_MK="$(row_field "${CE_MOD_ROWS}" "${A}" moduleKey)"
C_MENU="$(row_field "${CE_MOD_ROWS}" "${A}" menuId)"
C_API="$(row_field "${CE_MOD_ROWS}" "${A}" apiFile)"
C_FILE="$(row_field "${CE_MOD_ROWS}" "${A}" rsFile)"
if [ -z "${C_FILE}" ] || [ -z "${C_TABLE}" ]; then
echo "❌ 契约的 [MODULE] 区段里没有 app=${A} 这一行。"
echo " 本仓已知: $(printf '%s\n' "${CE_ALL_TARGETS}" | tr '\n' ' ')"
echo " ⇒ 新增模块请在 docs/contract.md 附录 A 的 [MODULE] 与 [MENU] 里各加一行。"
exit 2
fi
if [ "${C_ENT}" != "${E}" ]; then
echo "❌ 契约里 app=${A} 的 entity 是 ${C_ENT},你传的是 ${E}"
exit 2
fi
T_APP+=("${A}"); T_ENT+=("${E}")
T_TABLE+=("${C_TABLE}"); T_ROUTE+=("${C_URL}")
T_SEED+=("${C_MENU}"); T_MK+=("${C_MK}")
T_API+=("${C_API}"); T_FILE+=("${C_FILE}")
done
PASS=0; FAIL=0
ok() { echo " ✅ $1"; PASS=$((PASS+1)); }
no() { echo " ❌ $1"; FAIL=$((FAIL+1)); }
# ⏭ = 本仓不适用(当前只有「无前端」一种情形)—— **仍计入条数**,防止尺子被改弱
skip(){ echo " ⏭ $1"; PASS=$((PASS+1)); }
hdr() { echo; echo "── $1 ──"; }
# 小写(兼容 bash 3.x,不用 ${var,,})
lower() { printf '%s' "$1" | tr '[:upper:]' '[:lower:]'; }
# 自然英语复数(兼容 bash 3.x,不依赖 declare -A)
# Apply → Applies / Box → Boxes / Match → Matches / Buy → Buys(y 辅音前) / Boy → Boys
plural() {
case "$1" in
*s|*x|*ch|*sh) echo "${1}es" ;; # -s/-x/-ch/-sh 直接加 es
*ay|*ey|*oy|*uy) echo "${1}s" ;; # 单元音 + y → 保留 +s(Boy → Boys)
*y) echo "${1%y}ies" ;; # 辅音 + y → 去 y 加 ies
*) echo "${1}s" ;; # 默认 +s
esac
}
# 从业务模块文件里取该模块的 spec 常量名(如 DEMO_SPEC / PRODUCT_SPEC / BOOK_SPEC)
spec_const_of() {
awk '
/pub const [A-Z_]+_SPEC: EntitySpec/ {
n = $0; sub(/.*pub const /, "", n); sub(/: EntitySpec.*/, "", n); print n; exit
}
' "$1"
}
# 从业务模块文件里取某个 spec 的 table 字面量
spec_table_of() {
awk -v want="$1" '
/entity: "/ { e = $0; sub(/.*entity: "/, "", e); sub(/".*/, "", e) }
/table: "/ { t = $0; sub(/.*table: "/, "", t); sub(/".*/, "", t);
if (e == want) { print t; exit } }
' "$2"
}
# 从业务模块文件里取某个 spec 的 module_key(None 或 Some("x") 的 x)
spec_module_key_of() {
awk -v want="$1" '
/entity: "/ { e = $0; sub(/.*entity: "/, "", e); sub(/".*/, "", e) }
/module_key:/ {
m = $0; sub(/.*module_key:[[:space:]]*/, "", m); sub(/,[[:space:]]*$/, "", m)
if (e == want) {
if (m ~ /^Some\(/) { s = m; sub(/^Some\("/, "", s); sub(/"\)$/, "", s); print s }
else print "None"
exit
}
}
' "$2"
}
# 从业务模块文件的 MenuSpec 块里取该模块声明的**菜单 id**
#
# 🔴 **正则必须锚到行首的 `id:`** —— 否则 `parent_id: "0"` 里的 `id:` 会被误取。
menu_id_of() {
awk '
/^[ \t]*id:[ \t]*"/ { s = $0; sub(/^[ \t]*id:[ \t]*"/, "", s); sub(/".*/, "", s); print s; exit }
' "$1"
}
# 从业务模块文件的 MenuSpec 块里取**某个菜单 id 的某个字段**
#
# menu_field_of <menuId> <field> <file>
# field ∈ id | full_name | en_code | url_address | parent_id | menu_type | icon | sort_code
# `Some("x")` ⇒ `x`;`None` ⇒ `None`;字符串去引号;数字原样。
menu_field_of() {
awk -v want="$1" -v field="$2" '
/^[ \t]*id:[ \t]*"/ {
cur = $0; sub(/^[ \t]*id:[ \t]*"/, "", cur); sub(/".*/, "", cur)
}
cur == want {
key = $0; sub(/^[ \t]*/, "", key); sub(/:.*$/, "", key)
if (key == field) {
val = $0; sub(/^[ \t]*[A-Za-z_]+:[ \t]*/, "", val); gsub(/,$/, "", val)
if (val ~ /^Some\(/) { sub(/^Some\("/, "", val); sub(/"\)$/, "", val) }
else { sub(/^"/, "", val); sub(/"$/, "", val) }
print val; exit
}
}
' "$3"
}
menu_url_of() { menu_field_of "$1" url_address "$2"; }
# 逐字核对「代码里声明的菜单字段」与「契约 [MENU] 里那一行」
# check_menu_field <menuId> <契约列名> <代码字段名>
check_menu_field() {
local mid="$1" ccol="$2" cfield="$3" cval dval
cval="$(row_field "${CE_MENU_ROWS}" "${mid}" "${ccol}")"
dval="$(menu_field_of "${mid}" "${cfield}" "$MODFILE_CUR")"
if [ "${cval}" = "${dval}" ]; then
ok "菜单 ${mid}.${ccol} = ${cval}"
else
no "菜单 ${mid}.${ccol} = ${dval:-(没取到)},契约期望 ${cval:-(NULL)}"
fi
}
# 从 schema.sql 里取某张表的 CREATE TABLE 块
schema_block_of() {
awk -v t="$1" '
$0 ~ ("CREATE TABLE " t " \\(") { inb = 1 }
inb { print }
inb && /^\);/ { exit }
' "$SCHEMA"
}
for i in $(seq 0 $((T_COUNT - 1))); do
APP="${T_APP[$i]}"
ENT="${T_ENT[$i]}"
TABLE="${T_TABLE[$i]}"
ROUTE="${T_ROUTE[$i]}"
SEED_ID="${T_SEED[$i]}"
MK="${T_MK[$i]}"
API_EXP="${T_API[$i]}"
MODFILE="$MODULES_DIR/${T_FILE[$i]}"
MODFILE_CUR="${MODFILE}" # 供 check_menu_field 用(bash 没有闭包,只能走全局)
MODNAME="${T_FILE[$i]%.rs}"
LC="$(lower "$ENT")"
URL="${APP}/${ENT}"
hdr "[${ENT}] 1) 后端路由注册:modules/${T_FILE[$i]} 含 /api/ssw/${URL}/{List|Save|Delete}"
if [ -f "$MODFILE" ]; then
ok "业务模块文件存在: src/backend/src/modules/${T_FILE[$i]}"
else
no "缺业务模块文件: src/backend/src/modules/${T_FILE[$i]}"
fi
for ep in List Save Delete; do
if grep -q "/api/ssw/${URL}/${ep}" "$MODFILE" 2>/dev/null; then
ok "modules/${T_FILE[$i]} 已注册 /api/ssw/${URL}/${ep}"
else
no "modules/${T_FILE[$i]} 缺 /api/ssw/${URL}/${ep} → 端点 404"
fi
done
# 🔴 **业务路由不许进平台层** —— 平台层只 merge 一次(`modules::router()`)。
# 只看**真正的注册调用**(`.route("…")`)—— routes.rs 的路由表钉子测试里
# 有一份**路径清单**(那是契约快照,不是注册)⇒ 不能拿它当判据。
if grep -qE "\.route\(\"/api/ssw/${URL}/" "$ROUTES" 2>/dev/null; then
no "routes.rs 里注册了业务路由 /api/ssw/${URL}/ ⇒ 平台层混进了业务知识"
else
ok "routes.rs 未注册业务路由(平台层只 merge modules::router())"
fi
# 🔴 **模块必须被业务层登记表收编** —— `modules/mod.rs` 的 `router()` 要 merge 它、
# `ALL_SPECS` 要收它的 spec(漏一处 ⇒ 端点 404 / 启动自检报错)。
if grep -q "${MODNAME}::router()" "$MODULES_MOD" 2>/dev/null; then
ok "modules/mod.rs 的 router() merge 了 ${MODNAME}::router()"
else
no "modules/mod.rs 的 router() 没 merge ${MODNAME}::router() ⇒ 端点 404"
fi
SPEC_CONST="$(spec_const_of "$MODFILE")"
if [ -n "${SPEC_CONST}" ] && grep -q "${SPEC_CONST}" "$MODULES_MOD" 2>/dev/null; then
ok "modules/mod.rs 的 ALL_SPECS 收了 ${SPEC_CONST}"
else
no "modules/mod.rs 的 ALL_SPECS 没收 ${SPEC_CONST:-(没取到 spec 常量)} ⇒ 启动白名单自检会失败"
fi
hdr "[${ENT}] 2) spec 定义:modules/${T_FILE[$i]} 含 entity: \"${ENT}\" + table: \"${TABLE}\""
if grep -q "entity: \"${ENT}\"" "$MODFILE" 2>/dev/null; then
ok "modules/${T_FILE[$i]} 含 entity: \"${ENT}\""
else
no "modules/${T_FILE[$i]} 缺 entity: \"${ENT}\"(spec 没登记这个实体)"
fi
SPEC_TABLE="$(spec_table_of "${ENT}" "$MODFILE")"
if [ "${SPEC_TABLE}" = "${TABLE}" ]; then
ok "spec.table = ${TABLE}"
else
no "spec.table = ${SPEC_TABLE:-(没取到)},期望 ${TABLE}"
fi
hdr "[${ENT}] 3) 实体表存在:schema.sql 含 CREATE TABLE ${TABLE}"
if grep -q "CREATE TABLE ${TABLE}" "$SCHEMA" 2>/dev/null; then
ok "schema.sql 有表 ${TABLE}"
else
no "schema.sql 缺表 ${TABLE} → 业务模块跑不起来"
fi
hdr "[${ENT}] 4) 守卫 module_key:modules/${T_FILE[$i]} 的 spec.module_key"
SPEC_MK="$(spec_module_key_of "${ENT}" "$MODFILE")"
if [ "${SPEC_MK}" = "${MK}" ]; then
ok "spec.module_key = ${MK}"
else
no "spec.module_key = ${SPEC_MK:-(没取到)},期望 ${MK}"
fi
hdr "[${ENT}] 5) 前端 api 文件:api/${LC}.ts 含 list/save/delete 三导出(期望:${API_EXP})"
API="$FE/src/api/${LC}.ts"
VIEW="$FE/src/views/${ENT}.tsx"
if [ "${HAS_FE}" -eq 0 ]; then
skip "本仓无前端(后端-only)⇒ 跳过 api/${LC}.ts 接触点(契约期望:${API_EXP})"
elif [ "${API_EXP}" = "有" ]; then
# 期望**有** api 文件 ⇒ 缺文件就是 ❌(**不许**再打「无 api/xxx.ts」这种误导性绿灯)。
if [ -f "$API" ]; then
# 命名约定:list 函数走「自然英语复数」(Book → listBooks / Product → listProducts)
# save/delete 用 Entity 单数(PascalCase),与后端端点命名一致。
PLURAL_ENT="$(plural "$ENT")"
for fn in "list${PLURAL_ENT}" "save${ENT}" "delete${ENT}"; do
if grep -qE "export[[:space:]]+const[[:space:]]+${fn}" "$API" 2>/dev/null; then
ok "${fn} 导出存在"
else
no "${API} 缺 export const ${fn}(前端解构会 undefined)"
fi
done
else
no "缺 api/${LC}.ts(期望有:${ENT} 的前端必须有 api 层)"
fi
else
# 期望**无** api 文件 ⇒ 本仓前端是逐字复制:demo 模块没有 api 文件,
# views/DemoItem.tsx 直接 request.get('/ssw/demo/DemoItem/List') ⇒
# 「前端 api 文件」这一接触点对 demo 走**直连分支**(两种都查不到才算 ❌)。
if [ -f "$API" ]; then
no "多出 api/${LC}.ts(期望无:${ENT} 走 view 直连分支)—— 请同步期望值表"
else
ok "无 api/${LC}.ts(期望无 ⇒ 走 view 直连分支)"
if [ -f "$VIEW" ]; then
for ep in List Save Delete; do
if grep -qE "request\.(get|post|delete)\([^)]*/ssw/${URL}/${ep}" "$VIEW" 2>/dev/null; then
ok "views/${ENT}.tsx 直连 request → /ssw/${URL}/${ep}"
else
no "views/${ENT}.tsx 没有直连 request → /ssw/${URL}/${ep}"
fi
done
else
no "views/${ENT}.tsx 不存在,无法核对直连分支"
fi
fi
fi
hdr "[${ENT}] 6) 前端页面:views/${ENT}.tsx 存在"
if [ "${HAS_FE}" -eq 0 ]; then
skip "本仓无前端(后端-only)⇒ 跳过 views/${ENT}.tsx 接触点"
elif [ -f "$VIEW" ]; then
ok "views/${ENT}.tsx"
else
no "缺文件: views/${ENT}.tsx"
fi
hdr "[${ENT}] 7) 前端路由:App.tsx 含 <Route path=\"/${ROUTE}\""
# JSX 常写成多行(<Route\n path=...>),BSD grep 不支持 -P 跨行匹配,
# 用 tr 把换行去掉再 grep 最稳。
if [ "${HAS_FE}" -eq 0 ]; then
skip "本仓无前端(后端-only)⇒ 跳过 App.tsx 路由接触点(path=\"/${ROUTE}\")"
elif tr '\n' ' ' < "$FE/src/App.tsx" | grep -q "<Route[^>]*path=\"/${ROUTE}\"" 2>/dev/null; then
ok "Route path=\"/${ROUTE}\" 已注册"
else
no "App.tsx 缺 <Route path=\"/${ROUTE}\" → 路由 404"
fi
hdr "[${ENT}] 8) 菜单声明:modules/${T_FILE[$i]} 的内置菜单 ${SEED_ID}(与契约 [MENU] 逐字对齐)"
#
# 🔴 **业务菜单住在业务层**(红线 12)—— 声明在 `modules/<app>.rs` 的
# `*_MENU: MenuSpec` 里,由装配根注入平台层的种子。
# 期望值来自**契约** `[MENU]` 区段 ⇒ 代码改了菜单名/编码/图标 ⇒ 这里立刻报漂移。
DECL_ID="$(menu_id_of "${MODFILE}")"
if [ "${DECL_ID}" = "${SEED_ID}" ]; then
ok "modules/${T_FILE[$i]} 声明的菜单 id = ${SEED_ID}"
else
no "modules/${T_FILE[$i]} 声明的菜单 id = ${DECL_ID:-(没取到)},期望 ${SEED_ID}"
fi
SEED_URL="$(menu_url_of "${SEED_ID}" "${MODFILE}")"
if [ "${SEED_URL}" = "${ROUTE}" ]; then
ok "菜单 ${SEED_ID}.url_address = ${ROUTE}"
else
no "菜单 ${SEED_ID}.url_address = ${SEED_URL:-(没取到)},期望 ${ROUTE} → 菜单不显示"
fi
# 契约 [MENU] 里这一行的其余字段,逐字核对
check_menu_field "${SEED_ID}" fullName full_name
check_menu_field "${SEED_ID}" enCode en_code
check_menu_field "${SEED_ID}" parentId parent_id
check_menu_field "${SEED_ID}" type menu_type
check_menu_field "${SEED_ID}" sortCode sort_code
# icon:契约里空 = NULL,代码里写 `None` ⇒ 归一化后再比
C_ICON="$(row_field "${CE_MENU_ROWS}" "${SEED_ID}" icon)"
D_ICON="$(menu_field_of "${SEED_ID}" icon "${MODFILE}")"
if [ "${D_ICON}" = "None" ]; then D_ICON=""; fi
if [ "${C_ICON}" = "${D_ICON}" ]; then
ok "菜单 ${SEED_ID}.icon = ${C_ICON:-(NULL)}"
else
no "菜单 ${SEED_ID}.icon = ${D_ICON:-(NULL)},契约期望 ${C_ICON:-(NULL)}"
fi
hdr "[${ENT}] 9) 菜单登记:modules/mod.rs 的 ALL_MENUS 收了本模块的菜单"
MENU_CONST="$(grep -o "^pub const [A-Z_]*_MENU: MenuSpec" "${MODFILE}" 2>/dev/null | sed 's/^pub const //; s/: MenuSpec$//')"
if [ -z "${MENU_CONST}" ]; then
no "modules/${T_FILE[$i]} 没有 *_MENU: MenuSpec 声明"
elif grep -q "${MENU_CONST}," "${MODULES_MOD}" 2>/dev/null; then
ok "modules/mod.rs 的 ALL_MENUS 收了 ${MENU_CONST}"
else
no "modules/mod.rs 的 ALL_MENUS 没收 ${MENU_CONST} ⇒ 菜单不会被种、admin 少一条授权"
fi
hdr "[${ENT}] 10) 三处一字不差:module_key == url_address == Route path(去前导斜杠)"
if [ "${MK}" = "None" ]; then
# 🔴 demo 是「仅登录」守卫 ⇒ **没有** module_key 这一侧 ⇒ 只比 url_address == Route path。
if [ "${SEED_URL}" = "${ROUTE}" ]; then
ok "url_address == Route path:${SEED_URL} == ${ROUTE}(demo 仅登录 ⇒ 跳过 module_key 侧)"
else
no "url_address=${SEED_URL:-无} / Route=${ROUTE} 不一致"
fi
elif [ "${SPEC_MK}" = "${SEED_URL}" ] && [ "${SEED_URL}" = "${ROUTE}" ]; then
ok "三处相等:${SPEC_MK} == ${SEED_URL} == ${ROUTE}"
else
no "三处不一致:module_key=${SPEC_MK:-无} / url_address=${SEED_URL:-无} / Route=${ROUTE}"
fi
hdr "[${ENT}] 实体列 f_ 前缀 + 主键 f_id VARCHAR(50)(契约红线 4)"
BLOCK="$(schema_block_of "${TABLE}")"
if [ -z "${BLOCK}" ]; then
no "schema.sql 里没解析出 ${TABLE} 的建表块"
else
COLS="$(printf '%s\n' "${BLOCK}" | sed -n 's/^ \([A-Za-z_][A-Za-z0-9_]*\).*/\1/p')"
if [ -z "${COLS}" ]; then
no "${TABLE} 的建表块里没解析出任何列"
else
BADCOLS=""
for c in ${COLS}; do
case "${c}" in
f_*) ;;
*) BADCOLS="${BADCOLS} ${c}" ;;
esac
done
if [ -n "${BADCOLS}" ]; then
no "列名不是 f_ 前缀:${BADCOLS}"
else
ok "全部列名都是 f_ 前缀($(printf '%s\n' "${COLS}" | wc -l | tr -d ' ') 列)"
fi
fi
if printf '%s\n' "${BLOCK}" | grep -q "f_id VARCHAR(50)"; then
ok "主键 f_id VARCHAR(50)(36 位 UUID 装得下)"
else
no "主键必须是 f_id VARCHAR(50)(不要写成 32,否则 36 位 UUID 装不下)"
fi
fi
hdr "[${ENT}] 软删契约:list 带 f_delete_mark = 0 + remove 走软删(不是物理 DELETE)"
if grep -q "WHERE f_delete_mark = 0" "$CRUD" 2>/dev/null; then
ok "list 查询带 f_delete_mark = 0"
else
no "list 查询缺 f_delete_mark = 0 → 软删数据会显示"
fi
if grep -q "SET f_delete_mark = 1" "$CRUD" 2>/dev/null; then
ok "remove 置 f_delete_mark = 1(软删)"
else
no "remove 没软删(应是 UPDATE f_delete_mark=1,非物理 DELETE)"
fi
done
# -------- 全局红线(与具体模块无关,但一样会让闸门失真)--------
#
# 🔴 **面 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` 是本仓前端唯一不发的** ⇒ 判别只能用它。
# 本仓前端一旦开始发 `Vue-Version` ⇒ 面 A 的请求会被误判成面 B ⇒ 契约整体错位。
hdr "[全局] 面 A/面 B 判别头:前端**禁发** Vue-Version"
if [ "${HAS_FE}" -eq 0 ]; then
skip "本仓无前端(后端-only)⇒ 判别头检查不适用;面 A/面 B 分流仍由后端按头判定"
elif grep -q "Vue-Version" "$FE/src/api/request.ts" 2>/dev/null; then
no "前端 request.ts 发了 Vue-Version 头 ⇒ 面 A 请求会被误判成面 B"
else
ok "前端 request.ts 未发 Vue-Version(面 A/面 B 判别成立)"
fi
hdr "[全局] 面 B 尺子必须带判别头 Vue-Version: 3"
if grep -q "Vue-Version: 3" "$ROOT/scripts/perm-smoke-jnpf.sh" 2>/dev/null; then
ok "perm-smoke-jnpf.sh 带了 Vue-Version: 3"
else
no "perm-smoke-jnpf.sh 缺 Vue-Version: 3 ⇒ 面 B 请求不会被识别成面 B"
fi
# -------- 尺子自证:跑出来的条数必须等于契约里登记的条数 --------
#
# 🔴 **为什么要有这一条**:尺子自己**知道**自己断言了几条(PASS+FAIL)。
# 如果哪天有人删掉了几条断言、或者某个分支提前 return 了,尺子照样「全绿」——
# 变弱的尺子比没有尺子更危险。⇒ 条数由**契约**钉死,对不上 ⇒ 失败。
#
# 🔴 只在**全量跑**(无参)时对账;单模块跑的条数本来就不是全量条数。
CE_EXP_ASSERTIONS="$(row_field "${CE_RULER_ROWS}" "check-module.sh" assertions)"
if [ "$#" -eq 0 ] && [ -n "${CE_EXP_ASSERTIONS}" ]; then
CE_ACT_ASSERTIONS=$((PASS + FAIL))
if [ "${CE_ACT_ASSERTIONS}" -eq "${CE_EXP_ASSERTIONS}" ]; then
# 🔴 自证**不计入** PASS/FAIL(它是元断言,不是业务断言)⇒ 契约里登记的条数
# 永远是「业务断言数」,与文档里说的「N 条」是同一个数。
echo " ✅ 尺子自证:本尺子跑了 ${CE_ACT_ASSERTIONS} 条断言 = 契约登记的 ${CE_EXP_ASSERTIONS} 条"
else
echo " ❌ 尺子自证:本尺子跑了 ${CE_ACT_ASSERTIONS} 条断言,契约登记 ${CE_EXP_ASSERTIONS} 条 ⇒ 尺子被改弱了(少了/多了断言)"
FAIL=$((FAIL + 1))
fi
fi
# -------- 总结 --------
echo
echo "── 总结 ──"
echo "Modules: ${TARGETS[*]}"
echo "PASS=$PASS FAIL=$FAIL"
if [ "$FAIL" -eq 0 ]; then
echo "全 ✅ 可以跑 perm-smoke 了"
else
echo "有 ❌,请按上面修复后再跑 perm-smoke"
fi
exit $([ "$FAIL" -eq 0 ] && echo 0 || echo 1)