#!/usr/bin/env bash # ssw-platform —— 平台权限闭环 + 防回流冒烟脚本(21 条断言) # # 用法: # bash scripts/perm-smoke.sh # B=http://127.0.0.1:30110 bash scripts/perm-smoke.sh # ENC_BIN=/path/to/ssw-platform bash scripts/perm-smoke.sh # JQ_BIN="" bash scripts/perm-smoke.sh # 强制走 python3 兜底路径(两条路径判据一致) # # 前置:后端已启动,且处于**初始种子状态**(admin / 123456)。 # 幂等:脚本开头会删掉历史 smoke_user(存在才删)。 # 退出码:0 = 全绿(PASS=21 FAIL=0) / 1 = 有断言失败 / 2 = 前置错误(后端不可达、缺 jq+python3、缺 --enc 二进制) # # 🔴 **平台包零业务**(2026-11-04 清理):示例包 demo/shop/books/asset 已搬到技能仓。 # 原来 43 条里的 25 条业务 CRUD 断言随之退役,换成 4 条「面 A 业务端点必须 # HTTP 404」的防回流判据;平台权限闭环(登录 / token / 菜单树 / 授权 / 多应用) # 一条不少。断言条数仍由契约 [RULER] 钉住 ⇒ 尺子不会静默变弱。 # # 🔴 不依赖 node:cipher 用后端 `--enc` 自证;JSON 取值用 jq(无则 python3 兜底)。 # 🔴 所有 curl 都带 `--noproxy '*'`(本机 curl 走系统代理,不加会打不通 loopback)与 `--max-time 10`(后端不回就超时,不许挂死)。 # 🔴 numeric / int 的断言比的是**原始 JSON 文本**(契约 R1.5):JSON 字符串 "9.90" 与 JSON 数字 9.90 必须能分出来。 # 🔴 所有含中文的变量引用一律写 `${VAR}`(变量名后紧跟中文时,bash 会把中文并进变量名 ⇒ set -u 下 unbound variable)。 set -u if [ "${1:-}" = "-h" ] || [ "${1:-}" = "--help" ]; then sed -n '2,17p' "$0" | sed 's/^# \{0,1\}//' exit 0 fi ROOT="$(cd "$(dirname "$0")/.." && pwd)" # 🔴 记住「B 是不是用户显式给的」—— 显式给了就不自起隔离后端(尊重外部后端) B_RAW="${B:-}" B="${B:-http://127.0.0.1:30010}" ENC_BIN="${ENC_BIN:-$ROOT/target/release/sspf-admin}" TMP="$(mktemp -d)" # 🔴 退出时先停掉**自起的**隔离后端,再删临时目录(助手提供 kill;没自起就是空操作) trap 'smoke_backend_kill 2>/dev/null || true; rm -rf "$TMP"' EXIT # 隔离后端自启动助手(被 source;提供 ensure / kill) # shellcheck source=scripts/smoke_backend.sh . "${ROOT}/scripts/smoke_backend.sh" # 🔴 JQ_BIN / PY_BIN **允许从环境覆盖**(修复轮 R=1 必改 4)。 # 用 `${VAR-default}`(**只在未设置时**取默认)而不是 `${VAR:-default}`(未设置**或为空串**都取默认)—— # 后者会让 `JQ_BIN=""` 又回落到 jq ⇒ **python 路径没法从环境选**(评审指出的「静默丢弃」)。 # ⇒ `JQ_BIN="" bash scripts/perm-smoke.sh` ⇒ 强制走 python3 兜底路径。 JQ_BIN="${JQ_BIN-$(command -v jq 2>/dev/null || true)}" PY_BIN="${PY_BIN-$(command -v python3 2>/dev/null || true)}" # 🔴 前置错误写 **stdout**(修复轮 R=1 必改 6)—— # 只重定向 stdout 的调用方(`| tee`、`$(...)`)必须能拿到失败原因。 pre_fail() { echo "❌ 前置错误:${1}" exit 2 } # ---- 前置 1:JSON 取值工具(jq 优先,python3 兜底;两个都没有 ⇒ 退 2)---- if [ -z "$JQ_BIN" ] && [ -z "$PY_BIN" ]; then pre_fail "jq 与 python3 都没装,无法解析 JSON。" fi # ---- 契约期望值(唯一真源:docs/contract.md 附录 A)---- # 🔴 期望的**菜单树字符串**与**本尺子的断言条数**都从契约读 ⇒ # 契约改了、尺子不用改;尺子被改弱了(条数对不上)⇒ 自证失败。 CE_PY="$ROOT/scripts/contract_expect.py" if [ ! -f "$CE_PY" ]; then pre_fail "找不到 ${CE_PY}(契约期望值读取器)。" fi CE_MENU_TREE="$(python3 "${CE_PY}" menu-tree 2>/dev/null)" || CE_MENU_TREE="" if [ -z "${CE_MENU_TREE}" ]; then pre_fail "读契约的 [MENU_TREE] 区段失败(docs/contract.md 附录 A 是不是被改坏了?)。" fi CE_EXP_ASSERTIONS="$(python3 "${CE_PY}" ruler perm-smoke.sh 2>/dev/null)" || CE_EXP_ASSERTIONS="" if [ -z "${CE_EXP_ASSERTIONS}" ]; then pre_fail "读契约的 [RULER] 区段失败(perm-smoke.sh 的期望条数)。" fi # ---- 前置 2:cipher 自证二进制(--enc 必须在,脚本不依赖 node)---- if [ ! -x "$ENC_BIN" ]; then pre_fail "找不到可执行的 ${ENC_BIN}(先 cargo build --release,或用 ENC_BIN= 指定)。" fi ENC_PROBE="$("$ENC_BIN" --enc '123456' 2>/dev/null || true)" if [ -z "$ENC_PROBE" ]; then pre_fail "${ENC_BIN} --enc 自证失败(无输出)。" fi if ! printf '%s' "$ENC_PROBE" | grep -Eq '^[0-9a-fA-F]+$'; then pre_fail "${ENC_BIN} --enc 输出不是 hex。" fi # ---- 前置 3 的探活在 json_get 定义之后做(要读 body 的 code)---- # ---- python3 兜底的取值小工具(jq 在时不用它)---- PY_HELPER="$TMP/jget.py" cat >"$PY_HELPER" <<'PYEOF' import json import sys def out(v): if v is None: print("null") elif v is True: print("true") elif v is False: print("false") elif isinstance(v, str): print(v) else: print(json.dumps(v, ensure_ascii=False)) def out_raw(v): """**保留 JSON 类型**的输出(修复轮 R=1 必改 2/3)。 字符串 "9.90" ⇒ '"9.90"'(带引号);数字 9.90 ⇒ '9.9'(不带引号)。 ⇒ 与 jq 的 `jq -c` **逐字一致**(jq -c 对数字 9.90 也输出 9.9)。 """ print(json.dumps(v, ensure_ascii=False)) def data_obj(d): v = d.get("data") return v if isinstance(v, dict) else {} def main(): mode = sys.argv[1] raw = sys.stdin.read() try: d = json.loads(raw) except Exception: print("ERR") return if not isinstance(d, dict): print("ERR") return try: if mode == "code": out(d.get("code")) elif mode == "msg": out(d.get("msg")) elif mode == "token": # 🔴 修复轮 R=1 必改 1:token 缺失 / 为 null ⇒ **空串**(不是字面量 "null")。 # 否则 `[ -n "null" ]` 为真 ⇒ 第 3 条「token 非空」会**假通过**。 v = data_obj(d).get("token") print("" if v is None else v) elif mode == "id": out(data_obj(d).get("id")) elif mode == "price": # 🔴 修复轮 R=1 必改 2:numeric 必须保类型(JSON 字符串 vs JSON 数字)。 out_raw(data_obj(d).get("price")) elif mode == "stock": # 🔴 修复轮 R=1 必改 3:stock 同样保类型(数字 100 vs 字符串 "100")。 out_raw(data_obj(d).get("stock")) elif mode == "title": out(data_obj(d).get("title")) elif mode == "author": out(data_obj(d).get("author")) elif mode == "name": # 🔴 asset/DataResource(数据资源)的字段 out(data_obj(d).get("name")) elif mode == "category": out(data_obj(d).get("category")) elif mode == "provider": out(data_obj(d).get("provider")) elif mode == "idlen": out(len(data_obj(d).get("id") or "")) elif mode == "datalen": v = d.get("data") out(len(v) if isinstance(v, (list, dict, str)) else 0) elif mode == "menutree": nodes = data_obj(d).get("menuList") nodes = nodes if isinstance(nodes, list) else [] parts = [] for n in nodes: if not isinstance(n, dict): continue kids = n.get("children") kids = kids if isinstance(kids, list) else [] parts.append( str(n.get("fullName")) + ":" + ",".join(str(c.get("fullName")) for c in kids if isinstance(c, dict)) ) print("|".join(parts)) elif mode == "sysid": # 🔴 多应用:当前应用 id 由 `App-Code` 头解析。 # 位置 = **信封 data 内**(`{"code","msg","data":{"userInfo","menuList","currentSystemId"}}`), # 不是 JSON 根 —— 取错层会静默得到空串(假失败)。 v = data_obj(d).get("currentSystemId") print("" if v is None else v) elif mode == "smokeid": rows = d.get("data") rows = rows if isinstance(rows, list) else [] found = "" for u in rows: if isinstance(u, dict) and u.get("account") == "smoke_user": found = u.get("id") or "" break print(found) else: print("ERR") except Exception: print("ERR") main() PYEOF # ---- 取值小工具:json_get <模式> ---- # 🔴 raw=1 的模式用 `jq -c`(**保留 JSON 字面量**:字符串带引号、数字不带)—— # 与 python 路径的 `json.dumps` **逐字一致**(修复轮 R=1 必改 2/3)。 json_get() { local mode="${1}" body="${2}" expr="" raw=0 case "$mode" in code) expr='.code' ;; msg) expr='.msg' ;; # 🔴 修复轮 R=1 必改 1:`// ""` ⇒ token 缺失 / 为 null ⇒ **空串**(不是字面量 "null")。 token) expr='.data.token // ""' ;; id) expr='.data.id' ;; price) expr='.data.price' ; raw=1 ;; stock) expr='.data.stock' ; raw=1 ;; title) expr='.data.title' ;; author) expr='.data.author' ;; name) expr='.data.name' ;; category) expr='.data.category' ;; provider) expr='.data.provider' ;; idlen) expr='.data.id | length' ;; datalen) expr='.data | length' ;; menutree) expr='(.data.menuList // []) | map(.fullName + ":" + ((.children // []) | map(.fullName) | join(","))) | join("|")' ;; # 🔴 多应用:当前应用 id 由 `App-Code` 头解析(**信封 data 内** currentSystemId,见 CLAUDE.md §4.1) sysid) expr='.data.currentSystemId // ""' ;; smokeid) expr='(.data // []) | map(select(.account=="smoke_user")) | (.[0].id // "")' ;; *) echo "ERR"; return 0 ;; esac if [ -n "$JQ_BIN" ]; then if [ "$raw" -eq 1 ]; then printf '%s' "$body" | "$JQ_BIN" -c "$expr" 2>/dev/null || echo 'ERR' else printf '%s' "$body" | "$JQ_BIN" -r "$expr" 2>/dev/null || echo 'ERR' fi else printf '%s' "$body" | "$PY_BIN" "$PY_HELPER" "$mode" 2>/dev/null || echo 'ERR' fi } PASS=0 FAIL=0 # ---- 前置 3:后端可达且确实是本仓后端(不通 ⇒ 退 2,不是逐条假失败)---- # 🔴 **后端不可达时自动自起一个隔离实例**(独立数据目录 + 空闲端口)⇒ # ① 不用先手工起服务(CI 可跑)② 跑完不留脏数据 ③ 两把尺子互不污染。 # 但**用户显式给了 B** ⇒ 不自起(那个后端是用户自己的,不该替他关)。 smoke_backend_ensure "${ENC_BIN}" "${B_RAW}" if [ "${BACKEND_ISOLATED}" = "1" ]; then echo "ℹ️ 已自起隔离后端:${B}(数据目录 ${BACKEND_TMP}/pg,跑完即删)" fi # 判据:无 token 打 /api/oauth/CurrentUser ⇒ 本仓恒返回 {code:600}。 # 🔴 顺带排掉「端口上跑着别的服务」(实测 127.0.0.1:30999 上有个服务返 401)⇒ # 那种情况必须退 2(前置错),不能变成 31 条假失败。 PROBE_BODY="$(curl --noproxy '*' -s --max-time 10 "$B/api/oauth/CurrentUser" 2>/dev/null || true)" PROBE_CODE="$(json_get code "$PROBE_BODY")" if [ "$PROBE_CODE" != "600" ]; then pre_fail "后端不可达或不是 ssw-platform(${B} 返回 code=${PROBE_CODE:-无},期望 600=未登录)。先起服务,或用 B= 指定目标后重试。" fi # 断言:check <期望> <实际> <说明> # 期望写成 ">=N" ⇒ 数值比较(用于「列表长度 ≥ 1」)。 check() { local exp="${1}" act="${2}" desc="${3}" ok=0 case "$exp" in '>='*) local num="${exp#>=}" if printf '%s' "$act" | grep -Eq '^[0-9]+$' && [ "$act" -ge "$num" ]; then ok=1 fi ;; *) if [ "$exp" = "$act" ]; then ok=1 fi ;; esac if [ "$ok" -eq 1 ]; then echo " ✅ ${desc}(实际=${act})" PASS=$((PASS + 1)) else echo " ❌ ${desc} 期望=${exp} 实际=${act}" FAIL=$((FAIL + 1)) fi } # cipher 自证:enc <明文> ⇒ hex 密文(替代 react 版的 node + crypto-js) enc() { "$ENC_BIN" --enc "${1}" } echo "== ssw-platform 权限闭环冒烟(目标 ${B})==" # ---- 断言 1:无 token 访问 User/List(期望 600)---- R1="$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/sys/User/List")" check 600 "$(json_get code "$R1")" "无 token 访问 User/List ⇒ code=600" # ---- 断言 2:admin 加密登录(期望 200)---- LOGIN="$(curl --noproxy '*' -s --max-time 10 -X POST "$B/api/oauth/Login" \ -H 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode "account=admin" \ --data-urlencode "password=$(enc '123456')" \ --data-urlencode "grant_type=password")" check 200 "$(json_get code "$LOGIN")" "admin 加密登录 ⇒ code=200" # ---- 断言 3:token 非空 ---- TOKEN="$(json_get token "$LOGIN")" AUTH="Authorization: bearer ${TOKEN}" check 1 "$([ -n "$TOKEN" ] && echo 1 || echo 0)" "登录拿到非空 token" # ---- 断言 4:CurrentUser(期望 200)---- MENU="$(curl --noproxy '*' -s --max-time 10 "$B/api/oauth/CurrentUser" -H "$AUTH")" check 200 "$(json_get code "$MENU")" "CurrentUser ⇒ code=200" # ---- 断言 5:admin 菜单树(期望值来自**契约** [MENU_TREE] 区段)---- check "${CE_MENU_TREE}" \ "$(json_get menutree "$MENU")" \ "admin 菜单树分组正确" # ---- 幂等清理:删掉历史 smoke_user(存在才删)---- OLD="$(json_get smokeid "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/sys/User/List" -H "$AUTH")")" case "$OLD" in '' | ERR | null) OLD="" ;; esac if [ -n "$OLD" ]; then curl --noproxy '*' -s --max-time 10 -X DELETE "$B/api/ssw/sys/User/Delete?id=${OLD}" -H "$AUTH" >/dev/null fi echo " · 已清理历史 smoke_user:${OLD:-无}" # ---- 断言 6:新建 smoke_user(期望 200;不带 password ⇒ 落库 md5('123456'))---- NEW_USER="$(curl --noproxy '*' -s --max-time 10 -X POST "$B/api/ssw/sys/User/Save" -H "$AUTH" \ -H 'Content-Type: application/json' \ -d '{"account":"smoke_user","realName":"Smoke","isAdministrator":false,"roleIds":["role_user"]}')" check 200 "$(json_get code "$NEW_USER")" "新建 smoke_user ⇒ code=200" # ---- 断言 7/8/9:重复建 smoke_user ⇒ HTTP 200 + code 400 + msg 透传 ---- DUP_FILE="$TMP/dup.json" DUP_HTTP="$(curl --noproxy '*' -s --max-time 10 -o "$DUP_FILE" -w '%{http_code}' -X POST "$B/api/ssw/sys/User/Save" \ -H "$AUTH" -H 'Content-Type: application/json' \ -d '{"account":"smoke_user","realName":"Smoke","isAdministrator":false,"roleIds":["role_user"]}')" DUP_BODY="$(cat "$DUP_FILE")" check 200 "$DUP_HTTP" "重复账号 HTTP 状态 = 200(不是 500)" check 400 "$(json_get code "$DUP_BODY")" "重复账号业务码 = 400" check '账号已存在:smoke_user' "$(json_get msg "$DUP_BODY")" "重复账号 msg 透传" # ---- 断言 10:写授权(一维数组 module)---- AUTH1="$(curl --noproxy '*' -s --max-time 10 -X PUT "$B/api/permission/Authority/Data/role_user" -H "$AUTH" \ -H 'Content-Type: application/json' -d '{"objectType":"role","module":["m_menu"]}')" check 200 "$(json_get code "$AUTH1")" "写授权(一维,平台菜单 m_menu)⇒ code=200" # ---- 断言 11:写授权(二维兼容 [checked, halfChecked])---- AUTH2="$(curl --noproxy '*' -s --max-time 10 -X PUT "$B/api/permission/Authority/Data/role_user" -H "$AUTH" \ -H 'Content-Type: application/json' -d '{"objectType":"role","module":[["m_menu"],[]]}')" check 200 "$(json_get code "$AUTH2")" "写授权(二维兼容)⇒ code=200" # ---- 断言 12:smoke_user 登录(明文与建用户时的口径一致:'123456')---- ALOGIN="$(curl --noproxy '*' -s --max-time 10 -X POST "$B/api/oauth/Login" \ -H 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode "account=smoke_user" \ --data-urlencode "password=$(enc '123456')" \ --data-urlencode "grant_type=password")" check 200 "$(json_get code "$ALOGIN")" "smoke_user 登录 ⇒ code=200" ATOKEN="$(json_get token "$ALOGIN")" AAUTH="Authorization: bearer ${ATOKEN}" # ---- 断言 13:smoke_user 菜单按授权收窄(平台菜单 m_menu)---- # 🔴 零业务后菜单树只剩「系统管理」一族;授权 m_menu ⇒ 只留「菜单管理」这一项。 # 菜单树构造会把**被授权的叶子**提为根(父节点未授权就不带出来)⇒ 形状是 # `菜单管理:`(不是 `系统管理:菜单管理`);这个形状由 menutree 取值口径决定。 check '菜单管理:' \ "$(json_get menutree "$(curl --noproxy '*' -s --max-time 10 "$B/api/oauth/CurrentUser" -H "$AAUTH")")" \ "smoke_user 菜单已按授权收窄" # ---- 断言 14:smoke_user 访问 User/List(期望 403)---- check 403 "$(json_get code "$(curl --noproxy '*' -s --max-time 10 "$B/api/ssw/sys/User/List" -H "$AAUTH")")" \ "smoke_user 访问 User/List ⇒ code=403" # ---- 断言 15~18:防回流 —— 4 个示例业务端点必须**不存在**(HTTP 404)---- # # 🔴 **平台包零业务**(2026-11-04 清理):示例包已整体搬到技能仓,本仓面 A 只留 # 平台路由。原来 17~41 那 25 条打的是 demo/shop/books/asset 的 CRUD + 权限, # 现在改成「业务端点一律 404」⇒ 谁把示例业务接回平台仓,这里立刻红。 # 🔴 不是「模块不存在就跳过」的自适应分支:4 个前缀逐一真发请求,**条数固定进 # 契约 [RULER] 自证**,少一条就判尺子被改弱。 for biz in "demo/DemoItem/List" "shop/Product/List" "books/Book/List" "asset/DataResource/List"; do BIZ_CODE="$(curl --noproxy '*' -s --max-time 10 -o /dev/null -w '%{http_code}' \ "$B/api/ssw/${biz}" -H "$AUTH")" check 404 "${BIZ_CODE}" "防回流:/api/ssw/${biz} 必须 404(平台零业务)" done # ---- 断言 19:未知路由 ⇒ HTTP 404 ---- check 404 "$(curl --noproxy '*' -s --max-time 10 -o /dev/null -w '%{http_code}' "$B/api/not-exist-xyz")" \ "未知路由 HTTP 404 不被吞掉" # ---- 断言 20/21:多应用 —— 当前应用由 `App-Code` 头决定(CLAUDE.md §4.1)---- # 🔴 判据是**顶层** `currentSystemId`(面 A/面 B 同一口径):头缺失 ⇒ 回落主系统; # 未知应用也回落主系统(不 500、不 panic)——这里用已注册的 app-b 验证真路由。 check "mainSystem" "$(json_get sysid "$MENU")" \ "无 App-Code 头 ⇒ currentSystemId = 主系统 mainSystem(官方 JnpfConst.MAIN_SYSTEM_CODE)" SYS_APPB="$(curl --noproxy '*' -s --max-time 10 "$B/api/oauth/CurrentUser" -H "$AUTH" -H 'App-Code: app-b')" check "app-b" "$(json_get sysid "$SYS_APPB")" \ "App-Code: app-b ⇒ currentSystemId = app-b(应用路由生效)" echo echo "--------------------" # 🔴 **尺子自证**:跑出来的断言条数必须等于**契约**登记的条数。 # 少了 ⇒ 有人删了断言(尺子被改弱);多了 ⇒ 契约没同步。 # 自证本身**不计入** PASS/FAIL(它是元断言,不是业务断言)。 if [ "${PASS}" -eq "${CE_EXP_ASSERTIONS}" ]; then echo "✅ 尺子自证:本尺子跑了 ${PASS} 条断言 = 契约登记的 ${CE_EXP_ASSERTIONS} 条" else echo "❌ 尺子自证:本尺子跑了 ${PASS} 条断言,契约登记 ${CE_EXP_ASSERTIONS} 条 ⇒ 尺子被改弱了(少了/多了断言)" FAIL=$((FAIL + 1)) fi echo "PASS=${PASS} FAIL=${FAIL}" if [ "$FAIL" -eq 0 ]; then echo "全绿 ✅" exit 0 fi echo "有失败 ❌" exit 1