#!/usr/bin/env bash # ssw-jnpf-lite-rust 加业务模块的「接触点」静态自检(Rust 版) # # 目的:在跑 perm-smoke 之前,**快速发现漏改的文件或字符串不一致**——这类问题一旦漏掉, # 表现是「菜单不显示」「页面 404」「权限静默放行」,非常难定位。 # # 🔴 **纯静态**:不启动后端、不发一个请求、不依赖 node(契约明令:后端与冒烟脚本零 node 依赖)。 # ⇒ 用法里**没有** `--live`;传了未知参数 ⇒ 退出码 2(用法错)。 # # 用法: # 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" ENTITIES="$BACKEND/src/entities.rs" ROUTES="$BACKEND/src/routes.rs" SCHEMA="$BACKEND/db/schema.sql" SEED="$BACKEND/src/seed.rs" CRUD="$BACKEND/src/crud.rs" FE="$ROOT/src/frontend" 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 ---- TARGETS=() if [ "$#" -eq 0 ]; then TARGETS=("demo:DemoItem" "shop:Product" "books:Book") 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 # ---- 期望值表(逐字,来自契约 §8.4 + 契约 §5.3)---- # 每个目标:表名 / ROUTE(= urlAddress = module_key)/ 种子 id / module_key(None = 仅登录) # / **前端 api 文件该有没有**(有 = 有 / 无 = 走 view 直连分支) # # 🔴 **新增业务模块时须同步改这张期望表**(app_code:Entity 的分支、目标清单 TARGETS、 # 以及下面的 T_API 期望)—— 否则新模块会被判成「未知 app_code/Entity」退出 2。 T_COUNT=${#TARGETS[@]} T_APP=(); T_ENT=(); T_TABLE=(); T_ROUTE=(); T_SEED=(); T_MK=(); T_API=() for T in "${TARGETS[@]}"; do A="${T%%:*}" E="${T##*:}" case "${A}:${E}" in demo:DemoItem) T_TABLE+=("demo_item"); T_ROUTE+=("demo-item") T_SEED+=("m_demo"); T_MK+=("None") # demo **没有** api 文件:views/DemoItem.tsx 直接 request.get('/ssw/demo/DemoItem/List') T_API+=("无") ;; shop:Product) T_TABLE+=("shop_product"); T_ROUTE+=("shop/Product") T_SEED+=("m_product"); T_MK+=("shop/Product") T_API+=("有") ;; books:Book) T_TABLE+=("book_shop_book"); T_ROUTE+=("books/Book") T_SEED+=("m_book"); T_MK+=("books/Book") T_API+=("有") ;; *) echo "❌ 未知 app_code/Entity: ${A}/${E}" echo " 本仓已知: demo/DemoItem、shop/Product、books/Book" exit 2 ;; esac T_APP+=("${A}"); T_ENT+=("${E}") done PASS=0; FAIL=0 ok() { echo " ✅ $1"; PASS=$((PASS+1)); } no() { echo " ❌ $1"; FAIL=$((FAIL+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 } # 从 entities.rs 里取某个 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 } } ' "$ENTITIES" } # 从 entities.rs 里取某个 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 } } ' "$ENTITIES" } # 从 seed.rs 里取某个内置菜单 id 的 url_address seed_url_of() { awk -v want="$1" ' /id: "/ { cur = $0; sub(/.*id: "/, "", cur); sub(/".*/, "", cur) } /url_address: "/ { u = $0; sub(/.*url_address: "/, "", u); sub(/".*/, "", u) if (cur == want) { print u; exit } } ' "$SEED" } # 从 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]}" LC="$(lower "$ENT")" URL="${APP}/${ENT}" hdr "[${ENT}] 1) 后端路由注册:routes.rs 含 /api/ssw/${URL}/{List|Save|Delete}" for ep in List Save Delete; do if grep -q "/api/ssw/${URL}/${ep}" "$ROUTES" 2>/dev/null; then ok "routes.rs 已注册 /api/ssw/${URL}/${ep}" else no "routes.rs 缺 /api/ssw/${URL}/${ep} → 端点 404" fi done hdr "[${ENT}] 2) spec 定义:entities.rs 含 entity: \"${ENT}\" + table: \"${TABLE}\"" if grep -q "entity: \"${ENT}\"" "$ENTITIES" 2>/dev/null; then ok "entities.rs 含 entity: \"${ENT}\"" else no "entities.rs 缺 entity: \"${ENT}\"(spec 没登记这个实体)" fi SPEC_TABLE="$(spec_table_of "${ENT}")" 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:entities.rs 的 spec.module_key" SPEC_MK="$(spec_module_key_of "${ENT}")" 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 [ "${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 [ -f "$VIEW" ]; then ok "views/${ENT}.tsx" else no "缺文件: views/${ENT}.tsx" fi hdr "[${ENT}] 7) 前端路由:App.tsx 含 ),BSD grep 不支持 -P 跨行匹配, # 用 tr 把换行去掉再 grep 最稳。 if tr '\n' ' ' < "$FE/src/App.tsx" | grep -q "]*path=\"/${ROUTE}\"" 2>/dev/null; then ok "Route path=\"/${ROUTE}\" 已注册" else no "App.tsx 缺 /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 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 # -------- 总结 -------- 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)