Files
ssw-platform/scripts/check-module.sh
T
admin ce30c5b2f6 feat(pack): 框架固定包 + 加模块一条命令(批次 12 + 12.5)
把「内核怎么知道有这个包」从手写改成生成,漏接直接报错而不是静默 404。

- crates/sspf-plugin:load_static() 收掉装配样板,bootstrap 的 load_packs 缩成一行

- 包统一出口:pub struct Pack + pub const DDLS(生成器不必理解各包常量命名)

- 业务 DDL 跟包走(packs/*/schema/*.sql 经 include_str! 编进二进制)

- packs_gen.rs / modules/mod.rs 5 段 / Cargo.toml / contract.md 三段改由 pack-sync.py 生成

- scripts/new-pack.sh:一条命令产出 5 个后端文件 + 接线 + 可选前端三件套

- scripts/verify.sh 静态闸门一键跑;.workbuddy 记忆与 HANDOFF 见下一提交
2026-11-01 23:04:53 +08:00

648 lines
28 KiB
Bash
Executable File
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/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
}
# 给人看的「spec 真源」标签(相对仓库根)—— 用于断言文案
#
# 🔴 **为什么要单独一个函数**:spec 的真源有两个可能的位置
# (`modules/<app>.rs` 或 `packs/<app>/src/lib.rs`)。
# 断言文案里写死其中一处 ⇒ 另一处出问题时**提示会指错文件** ⇒ 白跑一趟。
spec_src_label() {
printf '%s' "${SPECFILE_CUR#"$ROOT"/}"
}
# 从 schema.sql 里取某张表的 CREATE TABLE 块
#
# 🔴 允许 `CREATE TABLE IF NOT EXISTS`(业务包的 DDL 一律带 IF NOT EXISTS ——
# 内核启动时**幂等**执行,见批次 12 交付物 ③)。
schema_block_of() {
awk -v t="$1" '
$0 ~ ("CREATE TABLE (IF NOT EXISTS )?" t " \\(") { inb = 1 }
inb { print }
inb && /^\);/ { exit }
' "$SCHEMA"
}
# 在**所有可能的位置**找某张表的建表块:先平台 `schema.sql`,再各业务包的 DDL。
#
# 🔴 **为什么必须两处都找**(批次 12 交付物 ③):业务表的 DDL 从 `schema.sql`
# 搬进了 `packs/<app>/schema/*.sql`(跟包走、`include_str!` 编进二进制)。
# 只查 `schema.sql` ⇒ **加一张业务表就跑不起来**这个事实反而查不出来
# (每一项都报「没取到」⇒ 尺子还在打印,但**已经什么都检查不到了**)。
schema_block_any() {
local t="$1" blk f
blk="$(schema_block_of "$t")"
if [ -n "${blk}" ]; then printf '%s\n' "${blk}"; return 0; fi
for f in "$ROOT"/packs/*/schema/*.sql; do
[ -f "$f" ] || continue
blk="$(awk -v t="$t" '
$0 ~ ("CREATE TABLE (IF NOT EXISTS )?" t " \\(") { inb = 1 }
inb { print }
inb && /^\);/ { exit }
' "$f")"
if [ -n "${blk}" ]; then printf '%s\n' "${blk}"; return 0; fi
done
return 0
}
# 该表的 DDL 实际住在哪(给人看的路径)
schema_file_any() {
local t="$1" f
if [ -n "$(schema_block_of "$t")" ]; then printf '%s' "db/schema.sql"; return 0; fi
for f in "$ROOT"/packs/*/schema/*.sql; do
[ -f "$f" ] || continue
if awk -v t="$t" '
$0 ~ ("CREATE TABLE (IF NOT EXISTS )?" t " \\(") { found = 1; exit }
END { exit(found ? 0 : 1) }
' "$f"; then
printf '%s' "${f#"$ROOT"/}"; return 0
fi
done
return 0
}
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}"
# 🔴 **spec / 菜单的真源可能已搬进业务包**(批次 12 交付物 ②):
# `modules/<app>.rs` 只做 `pub use sspf_pack_<app>::…` 转发 ⇒ 文件里**没有**
# `EntitySpec` / `MenuSpec` 字面量。
# ⇒ 若继续只读模块文件,下面每一条都会报「没取到」——
# 看起来像 17 个业务错误,实际是**尺子找不到真源了**(尺子瞎了,不是代码坏了)。
# ⇒ 判据:模块文件里有 `pub use sspf_pack_` ⇒ spec 去包里读。
SPECFILE="${MODFILE}"
if grep -q "pub use sspf_pack_" "${MODFILE}" 2>/dev/null; then
PKGLIB="$ROOT/packs/${APP}/src/lib.rs"
if [ -f "${PKGLIB}" ]; then
SPECFILE="${PKGLIB}"
fi
fi
SPECFILE_CUR="${SPECFILE}"
MODFILE_CUR="${SPECFILE}" # 菜单字段也从真源读(re-export 时模块文件里没有)
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 "${SPECFILE}")"
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 定义:$(spec_src_label) 含 entity: \"${ENT}\" + table: \"${TABLE}\""
if grep -q "entity: \"${ENT}\"" "${SPECFILE}" 2>/dev/null; then
ok "$(spec_src_label) 含 entity: \"${ENT}\""
else
no "$(spec_src_label) 缺 entity: \"${ENT}\"(spec 没登记这个实体)"
fi
SPEC_TABLE="$(spec_table_of "${ENT}" "${SPECFILE}")"
if [ "${SPEC_TABLE}" = "${TABLE}" ]; then
ok "spec.table = ${TABLE}"
else
no "spec.table = ${SPEC_TABLE:-(没取到)},期望 ${TABLE}"
fi
DDL_AT="$(schema_file_any "${TABLE}")"
hdr "[${ENT}] 3) 实体表存在:${DDL_AT:-DDL} 含 CREATE TABLE ${TABLE}"
if [ -n "${DDL_AT}" ]; then
ok "${DDL_AT} 有表 ${TABLE}"
else
no "任何 DDL 里都没有表 ${TABLE}(db/schema.sql 与 packs/*/schema/*.sql 都查过)→ 业务模块跑不起来"
fi
hdr "[${ENT}] 4) 守卫 module_key:$(spec_src_label) 的 spec.module_key"
SPEC_MK="$(spec_module_key_of "${ENT}" "${SPECFILE}")"
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) 菜单声明:$(spec_src_label) 的内置菜单 ${SEED_ID}(与契约 [MENU] 逐字对齐)"
#
# 🔴 **业务菜单住在业务层**(红线 12)—— 声明在 `*_MENU: MenuSpec` 里,
# 由装配根注入平台层的种子。批次 12 起这个真源**可能搬进了包**(见 SPECFILE)。
# 期望值来自**契约** `[MENU]` 区段 ⇒ 代码改了菜单名/编码/图标 ⇒ 这里立刻报漂移。
DECL_ID="$(menu_id_of "${SPECFILE}")"
if [ "${DECL_ID}" = "${SEED_ID}" ]; then
ok "$(spec_src_label) 声明的菜单 id = ${SEED_ID}"
else
no "$(spec_src_label) 声明的菜单 id = ${DECL_ID:-(没取到)},期望 ${SEED_ID}"
fi
SEED_URL="$(menu_url_of "${SEED_ID}" "${SPECFILE}")"
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 "${SPECFILE}")"
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" "${SPECFILE}" 2>/dev/null | sed 's/^pub const //; s/: MenuSpec$//')"
if [ -z "${MENU_CONST}" ]; then
no "$(spec_src_label) 没有 *_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_any "${TABLE}")"
if [ -z "${BLOCK}" ]; then
no "任何 DDL 里都没解析出 ${TABLE} 的建表块"
else
# 🔴 **只取列定义行**:表级约束(`PRIMARY KEY (...)` / `UNIQUE (...)` /
# `CONSTRAINT ...` / `FOREIGN KEY ...` / `CHECK ...`)**不是列**。
# 官方 DDL 的复合主键就是表级约束(`PRIMARY KEY (f_id, f_tenant_id)`)——
# 不过滤的话会被当成一个叫 `PRIMARY` 的列 ⇒ 假红。
COLS="$(printf '%s\n' "${BLOCK}" \
| sed -n 's/^ \([A-Za-z_][A-Za-z0-9_]*\).*/\1/p' \
| grep -viE '^(primary|unique|constraint|foreign|check|key|index)$')"
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)