Files
ssw-platform/scripts/verify.sh
T
admin acf076df5a refactor: 内核瘦身 —— 示例搬成业务包 + 装配/测试各归其位
- 内核只有 lib:启动装配 → crates/sspf-admin(bin sspf-admin);37 个集成测试 → crates/tests(package sspf-tests)。
- demo/shop/books 的 spec/菜单/DDL/面 B 路由搬进 packs/{demo,shop,books};内核 modules/*.rs 只剩「面 A 适配器 + pub use」⇒ 内核零业务知识,示例可整目录搬走。面 A 与前端零改动。
- 示例表 DDL 按平台规则补 f_tenant_id + 复合主键(spec 不加 ⇒ JSON 键与响应逐字不变)。
- 修 is_builtin_table 只认 schema.sql 的漏洞:包表(含 asset_data_resource)此前可被建模页删除/改;现为「平台 DDL ∪ 包表」。
- sspf-compat-online_dev → onlinedev(包名/模块/文件/路由别名同步);6 个 5 行转发壳合并为 forward.rs。
- 新增 AR16 闸门 + lib.rs「30 秒地图」+ src/backend/README.md;pack-sync 补两处判据(module_key=None 的 urlAddress、apiFile 查存在性)。
- 回归:704 tests / 6 道静态闸门全绿;health 181 表;四个包面 A/面 B 运行时全部 200。
2026-11-04 14:46:12 +08:00

219 lines
8.5 KiB
Bash
Executable File
Raw Permalink 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-platform **一条命令验证** —— 「快速打包 / 快速验证」的用户可见入口
#
# 🔴 **为什么存在**(HANDOFF §3 批次 12 交付物 ④ 的原文要求):
# 本仓有 6 把静态闸门 + 37 个测试二进制 + 6 把运行时尺子。
# 改一行代码要跑哪些、按什么顺序跑、哪一道慢了 ⇒ **没人知道** ⇒
# 结果是「全都跑一遍」(6 分钟)或者「一道都不跑」(然后提交坏代码)。
# ⇒ 本脚本把「该跑的」定成一个**固定顺序**,并在末尾打印**总耗时 + Top 3 最慢**。
#
# 🔴 **判据:耗时必须可见**。看不见耗时 ⇒ 慢下来也没人管 ⇒
# 「快速验证」退化回「不敢验证」。
#
# 用法:
# bash scripts/verify.sh # 全量:pack-sync → build → 静态闸门 → 全量测试
# bash scripts/verify.sh --fast # 内环:pack-sync → build → 静态闸门(不跑测试,~15s)
# bash scripts/verify.sh --lib # 中环:上面 + lib 单测 + **包冒烟**(起库)
# bash scripts/verify.sh --smoke # 全量 + 运行时尺子(要起后端,最慢)
# bash scripts/verify.sh --help
#
# 退出码:0 全过 / 1 有 ❌ / 2 用法错或前置错误
set -u
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
SCRIPTS="$ROOT/scripts"
MODE="full" # fast | lib | full | smoke
VERBOSE=0
usage() {
sed -n '2,25p' "$0" | sed 's/^# \{0,1\}//'
}
while [ "$#" -gt 0 ]; do
case "$1" in
-h|--help) usage; exit 0 ;;
--fast) MODE="fast"; shift ;;
--lib) MODE="lib"; shift ;;
--smoke) MODE="smoke"; shift ;;
-v|--verbose) VERBOSE=1; shift ;;
*) echo "❌ 未知参数: $1"; usage; exit 2 ;;
esac
done
PY_BIN="${PY_BIN-$(command -v python3 2>/dev/null || true)}"
if [ -z "${PY_BIN}" ]; then
echo "❌ 找不到 python3(静态闸门需要它)"
exit 2
fi
# ---------------------------------------------------------------- 环境告警
#
# 🔴 **被「转发壳」接管的命令会让计时整体失真**(实测,别忽略这条):
# 某些执行环境(沙箱 CLI / AI 助手内置 bash)会把 `grep` `sed` `cat` `wc`
# 替换成一个转发壳(PATH 里指向 `…/shim/brokered-bin/<命令>`)。壳每次启动
# ≈0.19s,而本仓的闸门正是「几百次 grep」的形态 ⇒ 实测把 check-module
# 从 **1.5s 放大到 13.7s(9 倍)**,check-contract 从 3.3s 放大到 8.1s。
# ⇒ 这种环境下打出来的耗时**不能**用来判断闸门本身快不快,
# 要真实数字请到普通终端里重跑(本脚本在那边会打印真实值)。
_grep_at="$(command -v grep 2>/dev/null || true)"
case "${_grep_at}" in
*/shim/* | */brokered-bin/*)
echo "⚠️ 本环境的 grep 被转发壳接管:${_grep_at}"
echo " 转发壳每次启动 ≈0.19s ⇒ 下面每步的耗时都会被**放大数倍**,"
echo " 不要用它判断闸门本身快不快;请到普通终端重跑取真实数字。"
;;
esac
# ---------------------------------------------------------------- 计时
#
# 🔴 **时间源必须零启动开销**。原来每步取 2 个时间戳、再算 1 次差值,三次都起
# `python3`(每次 ≈120ms)⇒ 8 步共 24 次 ≈ **2.9s**。这 2.9s 不属于任何一步,
# 却计进「总耗时」⇒ 结论会变成「闸门慢」,而真因是**计时器自己慢**。
# ⇒ 改成 `date +%s%N`(≈6ms)+ 纯 bash 整数运算(零进程)。
# 取不到纳秒(少数 BSD date)才回落到 python3 —— 慢,但结果仍然正确。
_now_probe="$(date +%s%N 2>/dev/null || true)"
case "${_now_probe}" in
'' | *[!0-9]*)
now() { "${PY_BIN}" -c 'import time; print(int(time.time() * 1e9))'; } ;;
*)
now() { date +%s%N; } ;;
esac
# 纳秒差 ⇒ "12.3"(秒,一位小数)
ns_to_secs() {
local ms=$(( $1 / 1000000 ))
printf '%d.%d' $(( ms / 1000 )) $(( (ms % 1000) / 100 ))
}
STEPS_NAME=()
STEPS_SECS=()
STEPS_RC=()
T0="$(now)"
FAILED=0
# run_step <名字> <命令...>
run_step() {
local name="$1"; shift
local t_start t_end t_secs rc out
printf '\n▶ %s\n' "${name}"
t_start="$(now)"
if [ "${VERBOSE}" -eq 1 ]; then
"$@"
rc=$?
else
# 只留尾部 25 行:闸门失败时的关键信息都在尾部(总结 / 失败清单)
out="$("$@" 2>&1)"
rc=$?
if [ "${rc}" -ne 0 ]; then
printf '%s\n' "${out}" | tail -25
elif [ "${VERBOSE}" -eq 1 ]; then
printf '%s\n' "${out}"
else
printf '%s\n' "${out}" | tail -3
fi
fi
t_end="$(now)"
t_secs="$(ns_to_secs $(( t_end - t_start )))"
STEPS_NAME+=("${name}")
STEPS_SECS+=("${t_secs}")
STEPS_RC+=("${rc}")
if [ "${rc}" -eq 0 ]; then
printf ' ✅ %s(%ss)\n' "${name}" "${t_secs}"
else
printf ' ❌ %s(%ss,退出码 %d)\n' "${name}" "${t_secs}" "${rc}"
FAILED=$((FAILED + 1))
fi
return 0
}
# ---------------------------------------------------------------- 步骤
# ① 契约生成段漂移(加包 / 改包后**必须**同步契约表)
#
# 🔴 放在**第一位**:如果契约表与包不一致,后面 check-contract 会报一堆
# 「契约 ↔ 代码漂移」,而真因只是「忘了跑 pack-sync」⇒ 先修这个省 8 秒排查。
run_step "契约生成段同步(pack-sync --check)" \
"${PY_BIN}" "${SCRIPTS}/pack-sync.py" --check
# ② 编译(后面所有步骤都依赖它)
run_step "编译(cargo build --offline)" \
cargo build --offline
# ③ 静态闸门(6 把,纯静态、不起服务)
run_step "静态闸门 check-arch" bash "${SCRIPTS}/check-arch.sh"
run_step "静态闸门 check-boundary" bash "${SCRIPTS}/check-boundary.sh"
run_step "静态闸门 check-naming" bash "${SCRIPTS}/check-naming.sh"
run_step "静态闸门 check-module" bash "${SCRIPTS}/check-module.sh"
run_step "静态闸门 check-contract" bash "${SCRIPTS}/check-contract.sh"
run_step "静态闸门 check-citations" bash "${SCRIPTS}/check-citations.sh"
# ④ 测试
if [ "${MODE}" = "lib" ] || [ "${MODE}" = "full" ] || [ "${MODE}" = "smoke" ]; then
if [ "${MODE}" = "lib" ]; then
run_step "单测(cargo test --lib)" \
cargo test --offline --workspace --lib
# 🔴 **包冒烟必须单独一步**(`full` / `smoke` 里已由 `--workspace` 覆盖 ⇒ 不重复):
# `--lib` 只跑单测 ⇒ 集成测试一条都不跑 ⇒ 下面这类**纯运行时**故障在这一档
# 完全看不见:包的表没建出来 / 面 B 路由没 merge / `module_key` 指向不存在的菜单。
# 它们全都**不会让静态闸门红**,只表现为「前端页面空着」。
# 代价实测 +1.3s(含起 pglite + 起 HTTP 服务)⇒ 放进中环完全值得。
run_step "包冒烟(每个包的 List 真应答,面 A + 面 B)" \
cargo test --offline -p sspf-tests --test pack_smoke_it
else
run_step "全量测试(cargo test --workspace)" \
cargo test --offline --workspace
fi
fi
# ⑤ 运行时尺子(要起后端,最慢;只有 --smoke 才跑)
if [ "${MODE}" = "smoke" ]; then
for s in perm-smoke perm-smoke-jnpf lowcode-smoke baseline-smoke mcp-smoke; do
if [ -f "${SCRIPTS}/${s}.sh" ]; then
run_step "运行时尺子 ${s}" bash "${SCRIPTS}/${s}.sh"
else
printf '\n▶ 运行时尺子 %s\n ⏭ 不存在,跳过\n' "${s}"
fi
done
fi
# ---------------------------------------------------------------- 汇总
T1="$(now)"
TOTAL="$(ns_to_secs $(( T1 - T0 )))"
echo
echo "──────────────────────────────────────────"
printf '总耗时 %ss(模式 %s,%d 个步骤)\n' "${TOTAL}" "${MODE}" "${#STEPS_NAME[@]}"
# 🔴 **Top 3 最慢** —— 「快验证」的成本结构必须可见,
# 否则没人知道该优化哪一道(本次就是靠它发现 check-contract 占 55s)。
if [ "${#STEPS_NAME[@]}" -gt 0 ]; then
echo
echo "最慢的 3 步:"
# 用制表符把「名字 / 耗时」喂给 python 排序(bash 没有浮点排序)
for i in "${!STEPS_NAME[@]}"; do
printf '%s\t%s\n' "${STEPS_SECS[$i]}" "${STEPS_NAME[$i]}"
done | "${PY_BIN}" -c '
import sys
rows = []
for line in sys.stdin:
line = line.rstrip("\n")
if not line:
continue
secs, name = line.split("\t", 1)
rows.append((float(secs), name))
for rank, (secs, name) in enumerate(sorted(rows, reverse=True)[:3], 1):
print(" %d. %-46s %ss" % (rank, name, secs))
'
fi
echo
if [ "${FAILED}" -eq 0 ]; then
echo "全 ✅ (${TOTAL}s)"
exit 0
fi
echo "有 ${FAILED} 步失败,见上面的 ❌"
exit 1