把「内核怎么知道有这个包」从手写改成生成,漏接直接报错而不是静默 404。 - crates/sspf-plugin:load_static() 收掉装配样板,bootstrap 的 load_packs 缩成一行 - 包统一出口:pub struct Pack + pub const DDLS(生成器不必理解各包常量命名) - 业务 DDL 跟包走(packs/*/schema/*.sql 经 include_str! 编进二进制) - packs_gen.rs / modules/mod.rs 5 段 / Cargo.toml / contract.md 三段改由 pack-sync.py 生成 - scripts/new-pack.sh:一条命令产出 5 个后端文件 + 接线 + 可选前端三件套 - scripts/verify.sh 静态闸门一键跑;.workbuddy 记忆与 HANDOFF 见下一提交
648 lines
28 KiB
Bash
Executable File
648 lines
28 KiB
Bash
Executable File
#!/usr/bin/env bash
|
||
# ssw-platform 加业务模块的「接触点」静态自检(Rust 版)
|
||
#
|
||
# 目的:在跑 perm-smoke 之前,**快速发现漏改的文件或字符串不一致**——这类问题一旦漏掉,
|
||
# 表现是「菜单不显示」「页面 404」「权限静默放行」,非常难定位。
|
||
#
|
||
# 🔴 **10 个接触点**(每个业务模块都要碰这 10 处):
|
||
# ① 业务模块文件 + 3 条路由 ② spec 定义 ③ 实体表 DDL ④ 守卫 module_key
|
||
# ⑤ 前端 api 文件 ⑥ 前端页面 ⑦ 前端路由 ⑧ **菜单声明**(`*_MENU`)
|
||
# ⑨ **菜单登记**(`ALL_MENUS`) ⑩ 三处一字不差(module_key == url_address == Route path)
|
||
#
|
||
# 🔴 **纯静态**:不启动后端、不发一个请求、不依赖 node(契约明令:后端与冒烟脚本零 node 依赖)。
|
||
# ⇒ 用法里**没有** `--live`;传了未知参数 ⇒ 退出码 2(用法错)。
|
||
#
|
||
# 🔴 **期望值的唯一真源 = `docs/contract.md` 附录 A**(机器可读区段 `[MODULE]` / `[MENU]` /
|
||
# `[RULER]`,由 `scripts/contract_expect.py` 解析)。
|
||
# 本脚本**不再硬编码**表名 / 路由 / 菜单 id ⇒
|
||
# ① 改契约(加模块、改菜单)⇒ 只改 contract.md 一处;
|
||
# ② 代码漂移 ⇒ 本脚本立刻报「与契约不一致」(不是默默放过)。
|
||
#
|
||
# 用法:
|
||
# 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`,不加 `-e` / `pipefail`** —— 这是有意的取舍,不是漏写:
|
||
# 本脚本的判定**依赖 grep 的返回码**(grep 命中 ⇒ 记一条 ✅,不命中 ⇒ 记一条 ❌)。
|
||
# 若加 `-e`,**第一条没命中的 grep 就会中止整个脚本** ⇒ 闸门只跑了一半就“静默变绿/变红”,
|
||
# 反而把闸门弄坏。加 `pipefail` 同理(管道里任一段非 0 都会中止)。
|
||
# ⇒ 想要「失败即停」请自己看末尾的 `PASS=` / `FAIL=` 与退出码。
|
||
set -u
|
||
|
||
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||
|
||
BACKEND="$ROOT/src/backend"
|
||
MODULES_DIR="$BACKEND/src/modules"
|
||
MODULES_MOD="$MODULES_DIR/mod.rs"
|
||
ROUTES="$BACKEND/src/routes.rs"
|
||
SCHEMA="$BACKEND/db/schema.sql"
|
||
CRUD="$BACKEND/src/platform/crud.rs"
|
||
FE="$ROOT/src/frontend"
|
||
|
||
# 🔴 **本仓是后端-only**(CLAUDE.md §2.2:前端/移动端本期不动,沿用 Java 版)。
|
||
# 脚手架原版假设 `src/frontend` 存在 ⇒ 前端接触点(5 前端 api / 6 前端页面 /
|
||
# 7 前端路由 / 全局面 A 判别头)在本仓**不适用**。
|
||
# ⇒ 无前端时这些接触点打印 `⏭` 并**仍计入条数**(与 check-citations.sh 的 skip
|
||
# 语义一致)—— 不许静默减条数,否则尺子会被悄悄改弱。
|
||
if [ -d "$FE/src" ]; then HAS_FE=1; else HAS_FE=0; fi
|
||
|
||
# ---- 契约期望值(唯一真源:docs/contract.md 附录 A)----
|
||
CE_PY="$ROOT/scripts/contract_expect.py"
|
||
if ! command -v python3 >/dev/null 2>&1; then
|
||
echo "❌ 前置错误:找不到 python3(读契约期望值用)。"
|
||
exit 2
|
||
fi
|
||
if [ ! -f "$CE_PY" ]; then
|
||
echo "❌ 前置错误:找不到 ${CE_PY}。"
|
||
exit 2
|
||
fi
|
||
ce() { python3 "${CE_PY}" "$@"; }
|
||
|
||
# 一次取全表(表头行 + 数据行,制表符分隔)
|
||
CE_MOD_ROWS="$(ce rows MODULE 2>/dev/null)" || {
|
||
echo "❌ 前置错误:读契约的 [MODULE] 区段失败(docs/contract.md 的附录 A 是不是被改坏了?)。"
|
||
exit 2
|
||
}
|
||
CE_MENU_ROWS="$(ce rows MENU 2>/dev/null)" || {
|
||
echo "❌ 前置错误:读契约的 [MENU] 区段失败(docs/contract.md 的附录 A 是不是被改坏了?)。"
|
||
exit 2
|
||
}
|
||
CE_RULER_ROWS="$(ce rows RULER 2>/dev/null)" || {
|
||
echo "❌ 前置错误:读契约的 [RULER] 区段失败(docs/contract.md 的附录 A 是不是被改坏了?)。"
|
||
exit 2
|
||
}
|
||
|
||
# 从「表头行 + 数据行」里按首列取某列的值;找不到 ⇒ 返回空 + 非 0
|
||
#
|
||
# 🔴 用 awk(-F'\t')而**不是** bash `read`:bash 的 `read` 按 IFS 空白折叠连续分隔符,
|
||
# 会把**空字段**(如 MENU.icon = NULL)吃掉 ⇒ 读出来错位。awk 保留空字段。
|
||
row_field() {
|
||
local rows="$1" key="$2" col="$3"
|
||
printf '%s\n' "${rows}" | awk -F'\t' -v key="${key}" -v col="${col}" '
|
||
NR == 1 { for (i = 1; i <= NF; i++) if ($i == col) c = i; next }
|
||
$1 == key { print $c; found = 1; exit }
|
||
END { if (!found) exit 3 }
|
||
'
|
||
}
|
||
|
||
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(默认取**契约** [MODULE] 区段登记的全部模块)----
|
||
CE_ALL_TARGETS="$(printf '%s\n' "${CE_MOD_ROWS}" | awk -F'\t' 'NR>1 { print $1 ":" $2 }')"
|
||
TARGETS=()
|
||
if [ "$#" -eq 0 ]; then
|
||
while IFS= read -r line; do
|
||
[ -n "${line}" ] || continue
|
||
TARGETS+=("${line}")
|
||
done <<< "${CE_ALL_TARGETS}"
|
||
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
|
||
|
||
# ---- 期望值表(**逐字来自契约** `docs/contract.md` 附录 A 的 `[MODULE]` 区段)----
|
||
# 每个目标:表名 / urlAddress(= 前端 Route path)/ 菜单 id / module_key(None = 仅登录)
|
||
# / **前端 api 文件该有没有**(有 = 有 / 无 = 走 view 直连分支)
|
||
# / **业务模块文件**(`src/backend/src/modules/<app>.rs` —— spec + handler + 路由)
|
||
#
|
||
# 🔴 **新增业务模块时**:在契约 `[MODULE]` 加一行 + 在 `[MENU]` 加一行 ⇒ 本脚本自动覆盖它。
|
||
# (本脚本**不再硬编码**任何业务标识符 ⇒ 加模块不用改脚本。)
|
||
T_COUNT=${#TARGETS[@]}
|
||
T_APP=(); T_ENT=(); T_TABLE=(); T_ROUTE=(); T_SEED=(); T_MK=(); T_API=(); T_FILE=()
|
||
for T in "${TARGETS[@]}"; do
|
||
A="${T%%:*}"
|
||
E="${T##*:}"
|
||
C_ENT="$(row_field "${CE_MOD_ROWS}" "${A}" entity)"
|
||
C_TABLE="$(row_field "${CE_MOD_ROWS}" "${A}" table)"
|
||
C_URL="$(row_field "${CE_MOD_ROWS}" "${A}" urlAddress)"
|
||
C_MK="$(row_field "${CE_MOD_ROWS}" "${A}" moduleKey)"
|
||
C_MENU="$(row_field "${CE_MOD_ROWS}" "${A}" menuId)"
|
||
C_API="$(row_field "${CE_MOD_ROWS}" "${A}" apiFile)"
|
||
C_FILE="$(row_field "${CE_MOD_ROWS}" "${A}" rsFile)"
|
||
if [ -z "${C_FILE}" ] || [ -z "${C_TABLE}" ]; then
|
||
echo "❌ 契约的 [MODULE] 区段里没有 app=${A} 这一行。"
|
||
echo " 本仓已知: $(printf '%s\n' "${CE_ALL_TARGETS}" | tr '\n' ' ')"
|
||
echo " ⇒ 新增模块请在 docs/contract.md 附录 A 的 [MODULE] 与 [MENU] 里各加一行。"
|
||
exit 2
|
||
fi
|
||
if [ "${C_ENT}" != "${E}" ]; then
|
||
echo "❌ 契约里 app=${A} 的 entity 是 ${C_ENT},你传的是 ${E}"
|
||
exit 2
|
||
fi
|
||
T_APP+=("${A}"); T_ENT+=("${E}")
|
||
T_TABLE+=("${C_TABLE}"); T_ROUTE+=("${C_URL}")
|
||
T_SEED+=("${C_MENU}"); T_MK+=("${C_MK}")
|
||
T_API+=("${C_API}"); T_FILE+=("${C_FILE}")
|
||
done
|
||
|
||
PASS=0; FAIL=0
|
||
ok() { echo " ✅ $1"; PASS=$((PASS+1)); }
|
||
no() { echo " ❌ $1"; FAIL=$((FAIL+1)); }
|
||
# ⏭ = 本仓不适用(当前只有「无前端」一种情形)—— **仍计入条数**,防止尺子被改弱
|
||
skip(){ echo " ⏭ $1"; PASS=$((PASS+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
|
||
}
|
||
|
||
# 从业务模块文件里取该模块的 spec 常量名(如 DEMO_SPEC / PRODUCT_SPEC / BOOK_SPEC)
|
||
spec_const_of() {
|
||
awk '
|
||
/pub const [A-Z_]+_SPEC: EntitySpec/ {
|
||
n = $0; sub(/.*pub const /, "", n); sub(/: EntitySpec.*/, "", n); print n; exit
|
||
}
|
||
' "$1"
|
||
}
|
||
|
||
# 从业务模块文件里取某个 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 } }
|
||
' "$2"
|
||
}
|
||
|
||
# 从业务模块文件里取某个 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
|
||
}
|
||
}
|
||
' "$2"
|
||
}
|
||
|
||
# 从业务模块文件的 MenuSpec 块里取该模块声明的**菜单 id**
|
||
#
|
||
# 🔴 **正则必须锚到行首的 `id:`** —— 否则 `parent_id: "0"` 里的 `id:` 会被误取。
|
||
menu_id_of() {
|
||
awk '
|
||
/^[ \t]*id:[ \t]*"/ { s = $0; sub(/^[ \t]*id:[ \t]*"/, "", s); sub(/".*/, "", s); print s; exit }
|
||
' "$1"
|
||
}
|
||
|
||
# 从业务模块文件的 MenuSpec 块里取**某个菜单 id 的某个字段**
|
||
#
|
||
# menu_field_of <menuId> <field> <file>
|
||
# field ∈ id | full_name | en_code | url_address | parent_id | menu_type | icon | sort_code
|
||
# `Some("x")` ⇒ `x`;`None` ⇒ `None`;字符串去引号;数字原样。
|
||
menu_field_of() {
|
||
awk -v want="$1" -v field="$2" '
|
||
/^[ \t]*id:[ \t]*"/ {
|
||
cur = $0; sub(/^[ \t]*id:[ \t]*"/, "", cur); sub(/".*/, "", cur)
|
||
}
|
||
cur == want {
|
||
key = $0; sub(/^[ \t]*/, "", key); sub(/:.*$/, "", key)
|
||
if (key == field) {
|
||
val = $0; sub(/^[ \t]*[A-Za-z_]+:[ \t]*/, "", val); gsub(/,$/, "", val)
|
||
if (val ~ /^Some\(/) { sub(/^Some\("/, "", val); sub(/"\)$/, "", val) }
|
||
else { sub(/^"/, "", val); sub(/"$/, "", val) }
|
||
print val; exit
|
||
}
|
||
}
|
||
' "$3"
|
||
}
|
||
|
||
menu_url_of() { menu_field_of "$1" url_address "$2"; }
|
||
|
||
# 逐字核对「代码里声明的菜单字段」与「契约 [MENU] 里那一行」
|
||
# check_menu_field <menuId> <契约列名> <代码字段名>
|
||
check_menu_field() {
|
||
local mid="$1" ccol="$2" cfield="$3" cval dval
|
||
cval="$(row_field "${CE_MENU_ROWS}" "${mid}" "${ccol}")"
|
||
dval="$(menu_field_of "${mid}" "${cfield}" "$MODFILE_CUR")"
|
||
if [ "${cval}" = "${dval}" ]; then
|
||
ok "菜单 ${mid}.${ccol} = ${cval}"
|
||
else
|
||
no "菜单 ${mid}.${ccol} = ${dval:-(没取到)},契约期望 ${cval:-(NULL)}"
|
||
fi
|
||
}
|
||
|
||
# 给人看的「spec 真源」标签(相对仓库根)—— 用于断言文案
|
||
#
|
||
# 🔴 **为什么要单独一个函数**:spec 的真源有两个可能的位置
|
||
# (`modules/<app>.rs` 或 `packs/<app>/src/lib.rs`)。
|
||
# 断言文案里写死其中一处 ⇒ 另一处出问题时**提示会指错文件** ⇒ 白跑一趟。
|
||
spec_src_label() {
|
||
printf '%s' "${SPECFILE_CUR#"$ROOT"/}"
|
||
}
|
||
|
||
# 从 schema.sql 里取某张表的 CREATE TABLE 块
|
||
#
|
||
# 🔴 允许 `CREATE TABLE IF NOT EXISTS`(业务包的 DDL 一律带 IF NOT EXISTS ——
|
||
# 内核启动时**幂等**执行,见批次 12 交付物 ③)。
|
||
schema_block_of() {
|
||
awk -v t="$1" '
|
||
$0 ~ ("CREATE TABLE (IF NOT EXISTS )?" t " \\(") { inb = 1 }
|
||
inb { print }
|
||
inb && /^\);/ { exit }
|
||
' "$SCHEMA"
|
||
}
|
||
|
||
# 在**所有可能的位置**找某张表的建表块:先平台 `schema.sql`,再各业务包的 DDL。
|
||
#
|
||
# 🔴 **为什么必须两处都找**(批次 12 交付物 ③):业务表的 DDL 从 `schema.sql`
|
||
# 搬进了 `packs/<app>/schema/*.sql`(跟包走、`include_str!` 编进二进制)。
|
||
# 只查 `schema.sql` ⇒ **加一张业务表就跑不起来**这个事实反而查不出来
|
||
# (每一项都报「没取到」⇒ 尺子还在打印,但**已经什么都检查不到了**)。
|
||
schema_block_any() {
|
||
local t="$1" blk f
|
||
blk="$(schema_block_of "$t")"
|
||
if [ -n "${blk}" ]; then printf '%s\n' "${blk}"; return 0; fi
|
||
for f in "$ROOT"/packs/*/schema/*.sql; do
|
||
[ -f "$f" ] || continue
|
||
blk="$(awk -v t="$t" '
|
||
$0 ~ ("CREATE TABLE (IF NOT EXISTS )?" t " \\(") { inb = 1 }
|
||
inb { print }
|
||
inb && /^\);/ { exit }
|
||
' "$f")"
|
||
if [ -n "${blk}" ]; then printf '%s\n' "${blk}"; return 0; fi
|
||
done
|
||
return 0
|
||
}
|
||
|
||
# 该表的 DDL 实际住在哪(给人看的路径)
|
||
schema_file_any() {
|
||
local t="$1" f
|
||
if [ -n "$(schema_block_of "$t")" ]; then printf '%s' "db/schema.sql"; return 0; fi
|
||
for f in "$ROOT"/packs/*/schema/*.sql; do
|
||
[ -f "$f" ] || continue
|
||
if awk -v t="$t" '
|
||
$0 ~ ("CREATE TABLE (IF NOT EXISTS )?" t " \\(") { found = 1; exit }
|
||
END { exit(found ? 0 : 1) }
|
||
' "$f"; then
|
||
printf '%s' "${f#"$ROOT"/}"; return 0
|
||
fi
|
||
done
|
||
return 0
|
||
}
|
||
|
||
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]}"
|
||
API_EXP="${T_API[$i]}"
|
||
MODFILE="$MODULES_DIR/${T_FILE[$i]}"
|
||
MODFILE_CUR="${MODFILE}" # 供 check_menu_field 用(bash 没有闭包,只能走全局)
|
||
MODNAME="${T_FILE[$i]%.rs}"
|
||
LC="$(lower "$ENT")"
|
||
URL="${APP}/${ENT}"
|
||
|
||
# 🔴 **spec / 菜单的真源可能已搬进业务包**(批次 12 交付物 ②):
|
||
# `modules/<app>.rs` 只做 `pub use sspf_pack_<app>::…` 转发 ⇒ 文件里**没有**
|
||
# `EntitySpec` / `MenuSpec` 字面量。
|
||
# ⇒ 若继续只读模块文件,下面每一条都会报「没取到」——
|
||
# 看起来像 17 个业务错误,实际是**尺子找不到真源了**(尺子瞎了,不是代码坏了)。
|
||
# ⇒ 判据:模块文件里有 `pub use sspf_pack_` ⇒ spec 去包里读。
|
||
SPECFILE="${MODFILE}"
|
||
if grep -q "pub use sspf_pack_" "${MODFILE}" 2>/dev/null; then
|
||
PKGLIB="$ROOT/packs/${APP}/src/lib.rs"
|
||
if [ -f "${PKGLIB}" ]; then
|
||
SPECFILE="${PKGLIB}"
|
||
fi
|
||
fi
|
||
SPECFILE_CUR="${SPECFILE}"
|
||
MODFILE_CUR="${SPECFILE}" # 菜单字段也从真源读(re-export 时模块文件里没有)
|
||
|
||
hdr "[${ENT}] 1) 后端路由注册:modules/${T_FILE[$i]} 含 /api/ssw/${URL}/{List|Save|Delete}"
|
||
if [ -f "$MODFILE" ]; then
|
||
ok "业务模块文件存在: src/backend/src/modules/${T_FILE[$i]}"
|
||
else
|
||
no "缺业务模块文件: src/backend/src/modules/${T_FILE[$i]}"
|
||
fi
|
||
for ep in List Save Delete; do
|
||
if grep -q "/api/ssw/${URL}/${ep}" "$MODFILE" 2>/dev/null; then
|
||
ok "modules/${T_FILE[$i]} 已注册 /api/ssw/${URL}/${ep}"
|
||
else
|
||
no "modules/${T_FILE[$i]} 缺 /api/ssw/${URL}/${ep} → 端点 404"
|
||
fi
|
||
done
|
||
# 🔴 **业务路由不许进平台层** —— 平台层只 merge 一次(`modules::router()`)。
|
||
# 只看**真正的注册调用**(`.route("…")`)—— routes.rs 的路由表钉子测试里
|
||
# 有一份**路径清单**(那是契约快照,不是注册)⇒ 不能拿它当判据。
|
||
if grep -qE "\.route\(\"/api/ssw/${URL}/" "$ROUTES" 2>/dev/null; then
|
||
no "routes.rs 里注册了业务路由 /api/ssw/${URL}/ ⇒ 平台层混进了业务知识"
|
||
else
|
||
ok "routes.rs 未注册业务路由(平台层只 merge modules::router())"
|
||
fi
|
||
# 🔴 **模块必须被业务层登记表收编** —— `modules/mod.rs` 的 `router()` 要 merge 它、
|
||
# `ALL_SPECS` 要收它的 spec(漏一处 ⇒ 端点 404 / 启动自检报错)。
|
||
if grep -q "${MODNAME}::router()" "$MODULES_MOD" 2>/dev/null; then
|
||
ok "modules/mod.rs 的 router() merge 了 ${MODNAME}::router()"
|
||
else
|
||
no "modules/mod.rs 的 router() 没 merge ${MODNAME}::router() ⇒ 端点 404"
|
||
fi
|
||
SPEC_CONST="$(spec_const_of "${SPECFILE}")"
|
||
|
||
if [ -n "${SPEC_CONST}" ] && grep -q "${SPEC_CONST}" "$MODULES_MOD" 2>/dev/null; then
|
||
ok "modules/mod.rs 的 ALL_SPECS 收了 ${SPEC_CONST}"
|
||
else
|
||
no "modules/mod.rs 的 ALL_SPECS 没收 ${SPEC_CONST:-(没取到 spec 常量)} ⇒ 启动白名单自检会失败"
|
||
fi
|
||
|
||
hdr "[${ENT}] 2) spec 定义:$(spec_src_label) 含 entity: \"${ENT}\" + table: \"${TABLE}\""
|
||
if grep -q "entity: \"${ENT}\"" "${SPECFILE}" 2>/dev/null; then
|
||
ok "$(spec_src_label) 含 entity: \"${ENT}\""
|
||
else
|
||
no "$(spec_src_label) 缺 entity: \"${ENT}\"(spec 没登记这个实体)"
|
||
fi
|
||
SPEC_TABLE="$(spec_table_of "${ENT}" "${SPECFILE}")"
|
||
if [ "${SPEC_TABLE}" = "${TABLE}" ]; then
|
||
ok "spec.table = ${TABLE}"
|
||
else
|
||
no "spec.table = ${SPEC_TABLE:-(没取到)},期望 ${TABLE}"
|
||
fi
|
||
|
||
DDL_AT="$(schema_file_any "${TABLE}")"
|
||
hdr "[${ENT}] 3) 实体表存在:${DDL_AT:-DDL} 含 CREATE TABLE ${TABLE}"
|
||
if [ -n "${DDL_AT}" ]; then
|
||
ok "${DDL_AT} 有表 ${TABLE}"
|
||
else
|
||
no "任何 DDL 里都没有表 ${TABLE}(db/schema.sql 与 packs/*/schema/*.sql 都查过)→ 业务模块跑不起来"
|
||
fi
|
||
|
||
hdr "[${ENT}] 4) 守卫 module_key:$(spec_src_label) 的 spec.module_key"
|
||
SPEC_MK="$(spec_module_key_of "${ENT}" "${SPECFILE}")"
|
||
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_EXP})"
|
||
API="$FE/src/api/${LC}.ts"
|
||
VIEW="$FE/src/views/${ENT}.tsx"
|
||
if [ "${HAS_FE}" -eq 0 ]; then
|
||
skip "本仓无前端(后端-only)⇒ 跳过 api/${LC}.ts 接触点(契约期望:${API_EXP})"
|
||
elif [ "${API_EXP}" = "有" ]; then
|
||
# 期望**有** api 文件 ⇒ 缺文件就是 ❌(**不许**再打「无 api/xxx.ts」这种误导性绿灯)。
|
||
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
|
||
no "缺 api/${LC}.ts(期望有:${ENT} 的前端必须有 api 层)"
|
||
fi
|
||
else
|
||
# 期望**无** api 文件 ⇒ 本仓前端是逐字复制:demo 模块没有 api 文件,
|
||
# views/DemoItem.tsx 直接 request.get('/ssw/demo/DemoItem/List') ⇒
|
||
# 「前端 api 文件」这一接触点对 demo 走**直连分支**(两种都查不到才算 ❌)。
|
||
if [ -f "$API" ]; then
|
||
no "多出 api/${LC}.ts(期望无:${ENT} 走 view 直连分支)—— 请同步期望值表"
|
||
else
|
||
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
|
||
fi
|
||
|
||
hdr "[${ENT}] 6) 前端页面:views/${ENT}.tsx 存在"
|
||
if [ "${HAS_FE}" -eq 0 ]; then
|
||
skip "本仓无前端(后端-only)⇒ 跳过 views/${ENT}.tsx 接触点"
|
||
elif [ -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 [ "${HAS_FE}" -eq 0 ]; then
|
||
skip "本仓无前端(后端-only)⇒ 跳过 App.tsx 路由接触点(path=\"/${ROUTE}\")"
|
||
elif 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) 菜单声明:$(spec_src_label) 的内置菜单 ${SEED_ID}(与契约 [MENU] 逐字对齐)"
|
||
#
|
||
# 🔴 **业务菜单住在业务层**(红线 12)—— 声明在 `*_MENU: MenuSpec` 里,
|
||
# 由装配根注入平台层的种子。批次 12 起这个真源**可能搬进了包**(见 SPECFILE)。
|
||
# 期望值来自**契约** `[MENU]` 区段 ⇒ 代码改了菜单名/编码/图标 ⇒ 这里立刻报漂移。
|
||
DECL_ID="$(menu_id_of "${SPECFILE}")"
|
||
if [ "${DECL_ID}" = "${SEED_ID}" ]; then
|
||
ok "$(spec_src_label) 声明的菜单 id = ${SEED_ID}"
|
||
else
|
||
no "$(spec_src_label) 声明的菜单 id = ${DECL_ID:-(没取到)},期望 ${SEED_ID}"
|
||
fi
|
||
SEED_URL="$(menu_url_of "${SEED_ID}" "${SPECFILE}")"
|
||
if [ "${SEED_URL}" = "${ROUTE}" ]; then
|
||
ok "菜单 ${SEED_ID}.url_address = ${ROUTE}"
|
||
else
|
||
no "菜单 ${SEED_ID}.url_address = ${SEED_URL:-(没取到)},期望 ${ROUTE} → 菜单不显示"
|
||
fi
|
||
# 契约 [MENU] 里这一行的其余字段,逐字核对
|
||
check_menu_field "${SEED_ID}" fullName full_name
|
||
check_menu_field "${SEED_ID}" enCode en_code
|
||
check_menu_field "${SEED_ID}" parentId parent_id
|
||
check_menu_field "${SEED_ID}" type menu_type
|
||
check_menu_field "${SEED_ID}" sortCode sort_code
|
||
# icon:契约里空 = NULL,代码里写 `None` ⇒ 归一化后再比
|
||
C_ICON="$(row_field "${CE_MENU_ROWS}" "${SEED_ID}" icon)"
|
||
D_ICON="$(menu_field_of "${SEED_ID}" icon "${SPECFILE}")"
|
||
if [ "${D_ICON}" = "None" ]; then D_ICON=""; fi
|
||
if [ "${C_ICON}" = "${D_ICON}" ]; then
|
||
ok "菜单 ${SEED_ID}.icon = ${C_ICON:-(NULL)}"
|
||
else
|
||
no "菜单 ${SEED_ID}.icon = ${D_ICON:-(NULL)},契约期望 ${C_ICON:-(NULL)}"
|
||
fi
|
||
|
||
hdr "[${ENT}] 9) 菜单登记:modules/mod.rs 的 ALL_MENUS 收了本模块的菜单"
|
||
MENU_CONST="$(grep -o "^pub const [A-Z_]*_MENU: MenuSpec" "${SPECFILE}" 2>/dev/null | sed 's/^pub const //; s/: MenuSpec$//')"
|
||
if [ -z "${MENU_CONST}" ]; then
|
||
no "$(spec_src_label) 没有 *_MENU: MenuSpec 声明"
|
||
elif grep -q "${MENU_CONST}," "${MODULES_MOD}" 2>/dev/null; then
|
||
ok "modules/mod.rs 的 ALL_MENUS 收了 ${MENU_CONST}"
|
||
else
|
||
no "modules/mod.rs 的 ALL_MENUS 没收 ${MENU_CONST} ⇒ 菜单不会被种、admin 少一条授权"
|
||
fi
|
||
|
||
hdr "[${ENT}] 10) 三处一字不差: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_any "${TABLE}")"
|
||
if [ -z "${BLOCK}" ]; then
|
||
no "任何 DDL 里都没解析出 ${TABLE} 的建表块"
|
||
else
|
||
# 🔴 **只取列定义行**:表级约束(`PRIMARY KEY (...)` / `UNIQUE (...)` /
|
||
# `CONSTRAINT ...` / `FOREIGN KEY ...` / `CHECK ...`)**不是列**。
|
||
# 官方 DDL 的复合主键就是表级约束(`PRIMARY KEY (f_id, f_tenant_id)`)——
|
||
# 不过滤的话会被当成一个叫 `PRIMARY` 的列 ⇒ 假红。
|
||
COLS="$(printf '%s\n' "${BLOCK}" \
|
||
| sed -n 's/^ \([A-Za-z_][A-Za-z0-9_]*\).*/\1/p' \
|
||
| grep -viE '^(primary|unique|constraint|foreign|check|key|index)$')"
|
||
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
|
||
|
||
# -------- 全局红线(与具体模块无关,但一样会让闸门失真)--------
|
||
#
|
||
# 🔴 **面 A / 面 B 的判别头是 `Vue-Version: 3`**(见 JNPF_COMPAT_SURFACE.md §2.2):
|
||
# 官方 JNPF 前端**必带** `Jnpf-Origin: pc` / `App-Code` / `Vue-Version: 3` 三个头,
|
||
# 而本仓前端**只带前两个**(`App-Code: sswflow` + `Jnpf-Origin: pc`,与官方同款)
|
||
# ⇒ 三个头里**只有 `Vue-Version` 是本仓前端唯一不发的** ⇒ 判别只能用它。
|
||
# 本仓前端一旦开始发 `Vue-Version` ⇒ 面 A 的请求会被误判成面 B ⇒ 契约整体错位。
|
||
hdr "[全局] 面 A/面 B 判别头:前端**禁发** Vue-Version"
|
||
if [ "${HAS_FE}" -eq 0 ]; then
|
||
skip "本仓无前端(后端-only)⇒ 判别头检查不适用;面 A/面 B 分流仍由后端按头判定"
|
||
elif grep -q "Vue-Version" "$FE/src/api/request.ts" 2>/dev/null; then
|
||
no "前端 request.ts 发了 Vue-Version 头 ⇒ 面 A 请求会被误判成面 B"
|
||
else
|
||
ok "前端 request.ts 未发 Vue-Version(面 A/面 B 判别成立)"
|
||
fi
|
||
|
||
hdr "[全局] 面 B 尺子必须带判别头 Vue-Version: 3"
|
||
if grep -q "Vue-Version: 3" "$ROOT/scripts/perm-smoke-jnpf.sh" 2>/dev/null; then
|
||
ok "perm-smoke-jnpf.sh 带了 Vue-Version: 3"
|
||
else
|
||
no "perm-smoke-jnpf.sh 缺 Vue-Version: 3 ⇒ 面 B 请求不会被识别成面 B"
|
||
fi
|
||
|
||
# -------- 尺子自证:跑出来的条数必须等于契约里登记的条数 --------
|
||
#
|
||
# 🔴 **为什么要有这一条**:尺子自己**知道**自己断言了几条(PASS+FAIL)。
|
||
# 如果哪天有人删掉了几条断言、或者某个分支提前 return 了,尺子照样「全绿」——
|
||
# 变弱的尺子比没有尺子更危险。⇒ 条数由**契约**钉死,对不上 ⇒ 失败。
|
||
#
|
||
# 🔴 只在**全量跑**(无参)时对账;单模块跑的条数本来就不是全量条数。
|
||
CE_EXP_ASSERTIONS="$(row_field "${CE_RULER_ROWS}" "check-module.sh" assertions)"
|
||
if [ "$#" -eq 0 ] && [ -n "${CE_EXP_ASSERTIONS}" ]; then
|
||
CE_ACT_ASSERTIONS=$((PASS + FAIL))
|
||
if [ "${CE_ACT_ASSERTIONS}" -eq "${CE_EXP_ASSERTIONS}" ]; then
|
||
# 🔴 自证**不计入** PASS/FAIL(它是元断言,不是业务断言)⇒ 契约里登记的条数
|
||
# 永远是「业务断言数」,与文档里说的「N 条」是同一个数。
|
||
echo " ✅ 尺子自证:本尺子跑了 ${CE_ACT_ASSERTIONS} 条断言 = 契约登记的 ${CE_EXP_ASSERTIONS} 条"
|
||
else
|
||
echo " ❌ 尺子自证:本尺子跑了 ${CE_ACT_ASSERTIONS} 条断言,契约登记 ${CE_EXP_ASSERTIONS} 条 ⇒ 尺子被改弱了(少了/多了断言)"
|
||
FAIL=$((FAIL + 1))
|
||
fi
|
||
fi
|
||
|
||
# -------- 总结 --------
|
||
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)
|