- 内核只有 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。
219 lines
8.5 KiB
Bash
Executable File
219 lines
8.5 KiB
Bash
Executable File
#!/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
|