Files
ssw-mpc-flow/scripts/check-module.sh
T
admin d43ee2f37a feat: 隐私计算流程编排平台(sswflow + 设备注册 + 链上存证)
从 ssw-mvp 抽取隐私计算编排域,框架换 JNPF Lite 契约
(NestJS + TypeORM + PGlite 嵌入式 Postgres + React 18/Vite),
执行底座对接 ../ssw-mpc Rust CLI。

三个兄弟模块:
- sswflow(编排,12 表):DAG 画布(React Flow @xyflow/react)、
  19 算子目录、可插拔执行引擎(mpc / simulation)、运行监控
- sswdevice(设备注册,1 表):真源 = ssw-mpc 控制面 GET /nodes,
  TeeNode 字段逐一对应,含 TTL 90s 在线清单的下线语义
- sswchain(链上存证,1 表):真源 = ssw-mpc outbox 二进制 canonical_bytes
  + FISCO 国密链自有 RPC,Receipt 四验证位分开报

配套 scripts/ 六个门禁脚本(期望数字写死)+ docs/e2e 端到端演示
+ CLAUDE.md 项目级上下文。
2026-11-10 16:13:57 +08:00

280 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
# ssw-jnpf-lite-react 加业务模块的「接触点」静态自检
#
# 目的:在跑 perm-smoke 之前,**快速发现漏改的文件或字符串不一致**——这类问题一旦漏掉,
# 表现是「菜单不显示」「页面 404」「权限静默放行」,非常难定位。
#
# 用法:
# bash scripts/check-module.sh <appCode> <Entity>... # 静态检查(1 个或多个 Entity)
# bash scripts/check-module.sh <appCode> <Entity>... --live # 额外实跑后端
# bash scripts/check-module.sh <appCode> --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 <appCode> <Entity>... [--live]"
echo " bash scripts/check-module.sh <appCode> --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 含 <Route path=\"/${URL}\"(接触点 8)"
# JSX 常写成多行(<Route\n path=...>),BSD grep 不支持 -P 跨行匹配,
# 用 tr 把换行去掉再 grep 最稳。
if tr '\n' ' ' < "$ROOT/src/frontend/src/App.tsx" | grep -q "<Route[^>]*path=\"/${URL}\"" 2>/dev/null \
|| grep -Eq "<Route[^>]*path=\"/${URL}\"" "$ROOT/src/frontend/src/App.tsx" 2>/dev/null; then
ok "Route path=\"/${URL}\" 已注册"
else
no "App.tsx 缺 <Route path=\"/${URL}\" → 路由 404"
fi
hdr "[${ENT}] seed.service.ts menus[] 含 urlAddress='${URL}'(接触点 9)"
SEED="$ROOT/src/backend/src/sys/seed.service.ts"
if grep -qE "urlAddress:[[:space:]]*'${URL}'" "$SEED" 2>/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)