feat(pack): 框架固定包 + 加模块一条命令(批次 12 + 12.5)

把「内核怎么知道有这个包」从手写改成生成,漏接直接报错而不是静默 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 见下一提交
This commit is contained in:
admin committed 2026-11-01 23:04:53 +08:00
1 parent e0c1904a0e
commit ce30c5b2f6
84 files changed
+9837 -394

No files matched your search

+100 -26
View File
@@ -268,15 +268,65 @@ check_menu_field() {
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 " t " \\(") { inb = 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]}"
@@ -291,6 +341,22 @@ for i in $(seq 0 $((T_COUNT - 1))); do
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]}"
@@ -319,35 +385,37 @@ for i in $(seq 0 $((T_COUNT - 1))); do
else
no "modules/mod.rs 的 router() 没 merge ${MODNAME}::router() ⇒ 端点 404"
fi
SPEC_CONST="$(spec_const_of "$MODFILE")"
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 定义:modules/${T_FILE[$i]} 含 entity: \"${ENT}\" + table: \"${TABLE}\""
if grep -q "entity: \"${ENT}\"" "$MODFILE" 2>/dev/null; then
ok "modules/${T_FILE[$i]} 含 entity: \"${ENT}\""
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 "modules/${T_FILE[$i]} 缺 entity: \"${ENT}\"(spec 没登记这个实体)"
no "$(spec_src_label) 缺 entity: \"${ENT}\"(spec 没登记这个实体)"
fi
SPEC_TABLE="$(spec_table_of "${ENT}" "$MODFILE")"
SPEC_TABLE="$(spec_table_of "${ENT}" "${SPECFILE}")"
if [ "${SPEC_TABLE}" = "${TABLE}" ]; then
ok "spec.table = ${TABLE}"
else
no "spec.table = ${SPEC_TABLE:-(没取到)},期望 ${TABLE}"
fi
hdr "[${ENT}] 3) 实体表存在:schema.sql 含 CREATE TABLE ${TABLE}"
if grep -q "CREATE TABLE ${TABLE}" "$SCHEMA" 2>/dev/null; then
ok "schema.sql 有表 ${TABLE}"
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 "schema.sql 缺表 ${TABLE} → 业务模块跑不起来"
no "任何 DDL 里都没有表 ${TABLE}(db/schema.sql 与 packs/*/schema/*.sql 都查过)→ 业务模块跑不起来"
fi
hdr "[${ENT}] 4) 守卫 module_key:modules/${T_FILE[$i]} 的 spec.module_key"
SPEC_MK="$(spec_module_key_of "${ENT}" "$MODFILE")"
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
@@ -417,18 +485,18 @@ for i in $(seq 0 $((T_COUNT - 1))); do
no "App.tsx 缺 <Route path=\"/${ROUTE}\" → 路由 404"
fi
hdr "[${ENT}] 8) 菜单声明:modules/${T_FILE[$i]} 的内置菜单 ${SEED_ID}(与契约 [MENU] 逐字对齐)"
hdr "[${ENT}] 8) 菜单声明:$(spec_src_label) 的内置菜单 ${SEED_ID}(与契约 [MENU] 逐字对齐)"
#
# 🔴 **业务菜单住在业务层**(红线 12)—— 声明在 `modules/<app>.rs` 的
# `*_MENU: MenuSpec` 里,由装配根注入平台层的种子。
# 🔴 **业务菜单住在业务层**(红线 12)—— 声明在 `*_MENU: MenuSpec` 里,
# 由装配根注入平台层的种子。批次 12 起这个真源**可能搬进了包**(见 SPECFILE)。
# 期望值来自**契约** `[MENU]` 区段 ⇒ 代码改了菜单名/编码/图标 ⇒ 这里立刻报漂移。
DECL_ID="$(menu_id_of "${MODFILE}")"
DECL_ID="$(menu_id_of "${SPECFILE}")"
if [ "${DECL_ID}" = "${SEED_ID}" ]; then
ok "modules/${T_FILE[$i]} 声明的菜单 id = ${SEED_ID}"
ok "$(spec_src_label) 声明的菜单 id = ${SEED_ID}"
else
no "modules/${T_FILE[$i]} 声明的菜单 id = ${DECL_ID:-(没取到)},期望 ${SEED_ID}"
no "$(spec_src_label) 声明的菜单 id = ${DECL_ID:-(没取到)},期望 ${SEED_ID}"
fi
SEED_URL="$(menu_url_of "${SEED_ID}" "${MODFILE}")"
SEED_URL="$(menu_url_of "${SEED_ID}" "${SPECFILE}")"
if [ "${SEED_URL}" = "${ROUTE}" ]; then
ok "菜单 ${SEED_ID}.url_address = ${ROUTE}"
else
@@ -442,7 +510,7 @@ for i in $(seq 0 $((T_COUNT - 1))); do
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 "${MODFILE}")"
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)}"
@@ -451,9 +519,9 @@ for i in $(seq 0 $((T_COUNT - 1))); do
fi
hdr "[${ENT}] 9) 菜单登记:modules/mod.rs 的 ALL_MENUS 收了本模块的菜单"
MENU_CONST="$(grep -o "^pub const [A-Z_]*_MENU: MenuSpec" "${MODFILE}" 2>/dev/null | sed 's/^pub const //; s/: MenuSpec$//')"
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 "modules/${T_FILE[$i]} 没有 *_MENU: MenuSpec 声明"
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
@@ -475,11 +543,17 @@ for i in $(seq 0 $((T_COUNT - 1))); do
fi
hdr "[${ENT}] 实体列 f_ 前缀 + 主键 f_id VARCHAR(50)(契约红线 4)"
BLOCK="$(schema_block_of "${TABLE}")"
BLOCK="$(schema_block_any "${TABLE}")"
if [ -z "${BLOCK}" ]; then
no "schema.sql 里没解析出 ${TABLE} 的建表块"
no "任何 DDL 里都没解析出 ${TABLE} 的建表块"
else
COLS="$(printf '%s\n' "${BLOCK}" | sed -n 's/^ \([A-Za-z_][A-Za-z0-9_]*\).*/\1/p')"
# 🔴 **只取列定义行**:表级约束(`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