Files
ssw-jnpf-lite-rust/scripts/check-module.sh
T
adminandClaude Code 8edcd3507d feat: 前端逐字复制(仅代理端口改 30010)+ run.sh + check-module.sh + 文档
前端:从 ssw-jnpf-lite-react/src/frontend 逐字复制(package-lock.json 一并复制),
唯一改动 = vite.config.ts 的代理目标 30000 → 30010(含紧邻注释行的端口);
src/api/request.ts 的注释与 axios timeout: 30000 逐字节保留。

脚本:run.sh(install/build/dev/backend/frontend/stop/logs,退出码 0/1/2,
kill_ports 只清 30010 与 5173);scripts/check-module.sh(9 接触点静态自检,
纯静态零 node 依赖)。

文档:README.md、docs/runbook.md、.env.example;CLAUDE.md 逐条核对并与代码同步,
HANDOFF.md §0 状态表与 §9 交接话术改为交付态。

Co-Authored-By: Claude Code <[email protected]>
2026-10-26 03:26:22 +08:00

333 lines
11 KiB
Bash
Executable File
Raw 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
# tds-lite-rs 加业务模块的「接触点」静态自检(Rust 版)
#
# 目的:在跑 perm-smoke 之前,**快速发现漏改的文件或字符串不一致**——这类问题一旦漏掉,
# 表现是「菜单不显示」「页面 404」「权限静默放行」,非常难定位。
#
# 🔴 **纯静态**:不启动后端、不发一个请求、不依赖 node(契约明令:后端与冒烟脚本零 node 依赖)。
# ⇒ 用法里**没有** `--live`;传了未知参数 ⇒ 退出码 2(用法错)。
#
# 用法:
# 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
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 [<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 ----
TARGETS=()
if [ "$#" -eq 0 ]; then
TARGETS=("demo:DemoItem" "shop:Product" "books:Book")
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
# ---- 期望值表(逐字,来自契约 §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 含 <Route path=\"/${ROUTE}\""
# JSX 常写成多行(<Route\n path=...>),BSD grep 不支持 -P 跨行匹配,
# 用 tr 把换行去掉再 grep 最稳。
if 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) 菜单种子:seed.rs 的内置菜单 ${SEED_ID} 的 url_address"
SEED_URL="$(seed_url_of "${SEED_ID}")"
if [ "${SEED_URL}" = "${ROUTE}" ]; then
ok "seed ${SEED_ID}.url_address = ${ROUTE}"
else
no "seed ${SEED_ID}.url_address = ${SEED_URL:-(没取到)},期望 ${ROUTE} → 菜单不显示"
fi
hdr "[${ENT}] 9) 三处一字不差: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_of "${TABLE}")"
if [ -z "${BLOCK}" ]; then
no "schema.sql 里没解析出 ${TABLE} 的建表块"
else
COLS="$(printf '%s\n' "${BLOCK}" | sed -n 's/^ \([A-Za-z_][A-Za-z0-9_]*\).*/\1/p')"
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
# -------- 总结 --------
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)