#!/usr/bin/env bash # ssw-jnpf-lite-react 加业务模块的「接触点」静态自检 # # 目的:在跑 perm-smoke 之前,**快速发现漏改的文件或字符串不一致**——这类问题一旦漏掉, # 表现是「菜单不显示」「页面 404」「权限静默放行」,非常难定位。 # # 用法: # bash scripts/check-module.sh ... # 静态检查(1 个或多个 Entity) # bash scripts/check-module.sh ... --live # 额外实跑后端 # bash scripts/check-module.sh --all [--live] # 自动扫 src/backend/src/${appCode}/*.entity.ts # # 例: # bash scripts/check-module.sh books Book # 单 Entity(向后兼容) # bash scripts/check-module.sh shoes Shoe Order # 同 appCode 多 Entity(一次跑完) # bash scripts/check-module.sh shoes --all # 自动探测 Shoe + Order # bash scripts/check-module.sh --help # 本用法 # # 退出码:0 全过 / 1 有 ❌ 项 / 2 用法错(参数不足 / --all 没探到 Entity) set -u usage() { echo "用法: bash scripts/check-module.sh ... [--live]" echo " bash scripts/check-module.sh --all [--live]" echo "例: bash scripts/check-module.sh books Book" echo " bash scripts/check-module.sh shoes Shoe Order" echo "退出码: 0 全过 / 1 有 ❌ 项 / 2 用法错" } if [ "${1:-}" = "-h" ] || [ "${1:-}" = "--help" ]; then usage exit 0 fi if [ "$#" -lt 2 ]; then usage exit 2 fi APP="$1" # books / shoes 小写 LIVE="" # 必须先算 ROOT,--all 分支要靠它探 *.entity.ts ROOT="$(cd "$(dirname "$0")/.." && pwd)" # ---- 解析参数:APP + 1+ Entity + 可选 --live ---- shift ENT_ARGS=() for arg in "$@"; do if [ "$arg" = "--live" ]; then LIVE="--live" elif [ "$arg" = "--all" ]; then # 自动探测 src/backend/src/${APP}/*.entity.ts for f in "$ROOT/src/backend/src/${APP}"/*.entity.ts; do [ -f "$f" ] || continue lc="$(basename "$f" .entity.ts)" # 小写 ent="$(printf '%s' "$lc" | cut -c1 | tr '[:lower:]' '[:upper:]')$(printf '%s' "$lc" | cut -c2-)" ENT_ARGS+=("$ent") done else ENT_ARGS+=("$arg") fi done if [ "${#ENT_ARGS[@]}" -eq 0 ]; then echo "❌ 没找到任何 Entity(--all 模式下 src/backend/src/${APP}/ 是否有 *.entity.ts?)" exit 2 fi cd "$ROOT/src/backend" || exit 2 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) upper_first() { local s="$1" printf '%s' "$s" | cut -c1 | tr '[:lower:]' '[:upper:]' printf '%s' "$s" | cut -c2- } # 自然英语复数(兼容 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 } # APP 级(与 Entity 无关,只检查一次) APP_MOD="$(upper_first "$APP")Module" # BooksModule / ShoesModule hdr "APP 级:${APP} 模块文件 + app.module.ts 注册(接触点 5)" APP_MOD_FILE="$ROOT/src/backend/src/${APP}/${APP}.module.ts" if [ -f "$APP_MOD_FILE" ]; then ok "${APP}/${APP}.module.ts" else no "缺文件: ${APP}/${APP}.module.ts(${APP_MOD} 类)" fi AM="$ROOT/src/backend/src/app.module.ts" if grep -q "import.*${APP_MOD}.*from.*${APP}/${APP}.module" "$AM" 2>/dev/null; then ok "import 行包含 ${APP_MOD}" else no "app.module.ts 缺 ${APP_MOD} 的 import" fi if grep -qE "^[[:space:]]+${APP_MOD}," "$AM" 2>/dev/null; then ok "imports[] 数组含 ${APP_MOD}" else no "app.module.ts 的 imports[] 数组缺 ${APP_MOD}(接触点 5 漏了 → 后端起不来)" fi # ---- 每个 Entity 各自跑一遍 ---- for ENT in "${ENT_ARGS[@]}"; do LC="$(lower "$ENT")" # book / shoe / order URL="${APP}/${ENT}" # books/Book / shoes/Shoe / shoes/Order hdr "[${ENT}] 后端 3 文件齐全(appCode=${APP};模块文件共享)" for f in "src/backend/src/${APP}/${LC}.entity.ts" \ "src/backend/src/${APP}/${LC}.service.ts" \ "src/backend/src/${APP}/${LC}.controller.ts"; do if [ -f "$ROOT/$f" ]; then ok "$f" else no "缺文件: $f" fi done hdr "[${ENT}] 前端 api/${LC}.ts 含 list/save/delete 三导出" API="$ROOT/src/frontend/src/api/${LC}.ts" if [ -f "$API" ]; then # 命名约定:list 函数走「自然英语复数」 # Apply → listApplies / Box → listBoxes / Order → listOrders / Match → listMatches # plural() 兼容上述五类(-s/-x/-ch/-sh → +es;辅音 + y → 去 y 加 ies;元音 + y → +s;默认 +s)。 # save/delete 用 Entity 单数(PascalCase),与 controller 端点命名一致。 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 # 显式 brace 包变量,避免 set -u 在 bash 3.x 下对复合字符串的 unbound 误报 no "${API} 缺 export const ${fn}(前端解构会 undefined)" fi done else no "缺文件: $API" fi hdr "[${ENT}] 前端 views/${ENT}.tsx 存在" if [ -f "$ROOT/src/frontend/src/views/${ENT}.tsx" ]; then ok "views/${ENT}.tsx" else no "缺文件: views/${ENT}.tsx" fi hdr "[${ENT}] App.tsx 含 ),BSD grep 不支持 -P 跨行匹配, # 用 tr 把换行去掉再 grep 最稳。 if tr '\n' ' ' < "$ROOT/src/frontend/src/App.tsx" | grep -q "]*path=\"/${URL}\"" 2>/dev/null \ || grep -Eq "]*path=\"/${URL}\"" "$ROOT/src/frontend/src/App.tsx" 2>/dev/null; then ok "Route path=\"/${URL}\" 已注册" else no "App.tsx 缺 /dev/null; then ok "menus[] 已含 '${URL}'" else no "seed.service.ts 缺 urlAddress:'${URL}' 行 → 菜单不显示" fi hdr "[${ENT}] 三处一字不差:MODKEY const == urlAddress == Route path(去前导斜杠)" CTRL="$ROOT/src/backend/src/${APP}/${LC}.controller.ts" if [ -f "$CTRL" ]; then if grep -qE "const[[:space:]]+MODULE_KEY[[:space:]]*=[[:space:]]*'${URL}'" "$CTRL" 2>/dev/null; then ok "controller MODULE_KEY = '${URL}'" else no "controller 缺 const MODULE_KEY = '${URL}'(接触点 9 与守卫 key 不一致 → 权限静默放行)" fi else no "controller 文件不存在,跳过 MODKEY 检查" fi hdr "[${ENT}] 实体列 f_ 前缀 + 主键 varchar(50)(契约红线 4)" ENT_FILE="$ROOT/src/backend/src/${APP}/${LC}.entity.ts" if [ -f "$ENT_FILE" ]; then if grep -qE "PrimaryColumn.*name:[[:space:]]*'f_id'.*length:[[:space:]]*50" "$ENT_FILE" 2>/dev/null; then ok "主键 f_id varchar(50)" else no "主键必须是 varchar(50)(不要写成 32,否则 36 位 UUID 装不下)" fi if grep -qE "name:[[:space:]]*'f_" "$ENT_FILE" 2>/dev/null; then ok "含 f_ 前缀列" else no "实体里没找到任何 f_ 前缀列" fi fi hdr "[${ENT}] 软删契约:查询带 deleteMark: 0 + remove 软删" if grep -qE "deleteMark:[[:space:]]*0" "$ROOT/src/backend/src/${APP}/${LC}.service.ts" 2>/dev/null; then ok "list 查询带 deleteMark: 0" else no "list 查询缺 where: { deleteMark: 0 } → 软删数据会显示" fi if grep -qE "deleteMark:[[:space:]]*1" "$ROOT/src/backend/src/${APP}/${LC}.service.ts" 2>/dev/null; then ok "remove 置 deleteMark = 1" else no "remove 没软删(应是 update deleteMark=1,非 repo.delete)" fi hdr "[${ENT}] 端点命名 /api/ssw/${APP}/${ENT}/{List|Save|Delete}" if grep -qE "@Controller\('api/ssw/${APP}/${ENT}'\)" "$CTRL" 2>/dev/null; then ok "@Controller('api/ssw/${APP}/${ENT}')" else no "controller 类注解不是 @Controller('api/ssw/${APP}/${ENT}')" fi for ep in "'List'" "'Save'" "'Delete'"; do if grep -qE "@(Get|Post|Delete)\(${ep}\)" "$CTRL" 2>/dev/null; then ok "端点 ${ep} 存在" else no "缺端点 ${ep}" fi done done # -------- 总结 -------- echo echo "── 总结 ──" echo "Entities: ${ENT_ARGS[*]}" echo "PASS=$PASS FAIL=$FAIL" if [ "$FAIL" -eq 0 ]; then echo "全 ✅ 可以跑 perm-smoke 了" else echo "有 ❌,请按上面修复后再跑 perm-smoke" fi # -------- 可选:实跑端点(需后端已起) -------- if [ "$LIVE" = "--live" ]; then hdr "实跑端点(依赖后端在 127.0.0.1:30000)" B="${B:-http://127.0.0.1:30000}" # 默认走 which node,回退到 workbuddy 路径 NODE_RESOLVED="$(command -v node 2>/dev/null || echo /Users/xs/.workbuddy/binaries/node/versions/22.22.2-3/bin/node)" ENC="$($NODE_RESOLVED -e "const C=require('crypto-js');const k=C.enc.Utf8.parse(C.MD5('EY8WePvjM5GGwQzn').toString());const s=C.enc.Utf8.parse(C.MD5('123456').toString());console.log(C.AES.encrypt(s,k,{mode:C.mode.ECB,padding:C.pad.Pkcs7}).ciphertext.toString(C.enc.Hex))")" LOGIN=$(curl --noproxy '*' -s -X POST "$B/api/oauth/Login" \ -H 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode "account=admin" --data-urlencode "password=$ENC" --data-urlencode "grant_type=password") T=$(echo "$LOGIN" | $NODE_RESOLVED -e "let d='';process.stdin.on('data',c=>d+=c).on('end',()=>{console.log(JSON.parse(d).data.token)})") if [ -z "$T" ]; then no "admin 登录失败,确认后端在跑" exit 1 fi ok "admin 登录成功" # 每个 Entity 都打实跑 for ENT in "${ENT_ARGS[@]}"; do hdr "[${ENT}] 实跑 /api/ssw/${APP}/${ENT}/List" CODE=$(curl --noproxy '*' -s -o /tmp/.chk-list.json -w '%{http_code}' \ "$B/api/ssw/${APP}/${ENT}/List" -H "Authorization: bearer $T") BCODE=$($NODE_RESOLVED -e "let d='';process.stdin.on('data',c=>d+=c).on('end',()=>{console.log(JSON.parse(d).code)})" < /tmp/.chk-list.json) if [ "$CODE" = "200" ] && [ "$BCODE" = "200" ]; then ok "GET List 返 200 + body.code=200" else no "List 失败:HTTP=$CODE body.code=$BCODE" fi CODE=$(curl --noproxy '*' -s -o /tmp/.chk-600.json -w '%{http_code}' \ "$B/api/ssw/${APP}/${ENT}/List") BCODE=$($NODE_RESOLVED -e "let d='';process.stdin.on('data',c=>d+=c).on('end',()=>{console.log(JSON.parse(d).code)})" < /tmp/.chk-600.json) if [ "$BCODE" = "600" ]; then ok "无 token 拦截:code=600" else no "无 token 应返 600,实得 $BCODE" fi done fi exit $([ "$FAIL" -eq 0 ] && echo 0 || echo 1)