#!/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 # 也可只查一个(如 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" # 🔴 **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 版)。 # 脚手架原版假设 `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 [ ...]" 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 "❌ 用法错: 后面至少要跟一个 " 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/.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 # 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 <契约列名> <代码字段名> 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/.rs` 或 `packs//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//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/.rs` 只做 `pub use sspf_pack_::…` 转发 ⇒ 文件里**没有** # `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 含 ),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 "]*path=\"/${ROUTE}\"" 2>/dev/null; then ok "Route path=\"/${ROUTE}\" 已注册" else no "App.tsx 缺 /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)