#!/usr/bin/env bash # tds-lite-rs 加业务模块的「接触点」静态自检(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 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 = 仅登录) T_COUNT=${#TARGETS[@]} T_APP=(); T_ENT=(); T_TABLE=(); T_ROUTE=(); T_SEED=(); T_MK=() 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") ;; shop:Product) T_TABLE+=("shop_product"); T_ROUTE+=("shop/Product") T_SEED+=("m_product"); T_MK+=("shop/Product") ;; books:Book) T_TABLE+=("book_shop_book"); T_ROUTE+=("books/Book") T_SEED+=("m_book"); T_MK+=("books/Book") ;; *) 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]}" 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="$FE/src/api/${LC}.ts" VIEW="$FE/src/views/${ENT}.tsx" 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 # 🔴 本仓前端是逐字复制:demo 模块**没有** api 文件, # views/DemoItem.tsx 直接 request.get('/ssw/demo/DemoItem/List') ⇒ # 「前端 api 文件」这一接触点对 demo 走**直连分支**(两种都查不到才算 ❌)。 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 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 # -------- 总结 -------- 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)