平台包零业务:示例移到技能仓、解绑 example-packs、闸门全部改防回流
- 物理移出 packs/{asset,books,demo,shop}、modules/ 四个面 A 适配器、纯技能副本、
纯业务测试 crud_it.rs 与 new-pack 脚手架(v0.3.0 tag 完整保留旧形态)。
- 删 example-packs feature / example_packs() / sspf-pack-* 依赖 / packs/* member;
packs_gen.rs 与 modules/mod.rs 生成段降级为恒空的注入点,装配链一条不删;
pack-sync.py 把「零包」钉成合法目标态。
- 尺子不再「跳过」:CP1 防回流清单、check-module 三条、AR2/PACK1 正向断言、
AR17 升级为零业务依赖判据(含注入式反自证)、契约反自证换平台锚点、FACE 零包重算。
- 面 A 冒烟 43→21 条(17 条平台权限闭环 + 4 条业务端点 404);pack_smoke_it 改
运行时防回流探针;auth/db/batch7/permission/seed/routes 单测换平台内置夹具。
- 契约 [MENU_TREE] 收成 5 条系统菜单、[RULER] 改 21/3;README/CLAUDE/HANDOFF/
CHANGELOG/contract §5.1/schema.sql/db.rs 注释同步。
验收:cargo test --workspace --no-fail-fast 649 passed / 0 failed / 6 ignored;
verify.sh --smoke 14/14;check-arch 24/24 + 反自证 14/14;
cargo tree -p sspf 无 sspf-pack-*。前端 src/frontend 按要求保留。
This commit is contained in:
1 parent
ca8abf9cc9
commit
ecb77b230f
94 files changed
+842
-8986
No files matched your search
+79
-166
@@ -420,8 +420,10 @@ def sync_face_counts(text, faces):
|
||||
🔴 **不写死增量**:直接写「当前 `[ENDPOINT]` 里的实际条数」
|
||||
⇒ 天然幂等,且加包 / 加模块 / 改路由都自动跟着走。
|
||||
"""
|
||||
if not faces:
|
||||
return text
|
||||
# 🔴 零包时 `faces` 是空集合 —— **不能短路返回**:业务端点被清空后
|
||||
# `[FACE]` 的旧条数必须跟着重算,否则 CC9 立刻红(2026-11-04 清理踩到)。
|
||||
# ⇒ 空集合 = 「重算 [FACE] 里的**全部**面」。
|
||||
recount_all = not faces
|
||||
|
||||
lines = text.split("\n")
|
||||
try:
|
||||
@@ -443,7 +445,7 @@ def sync_face_counts(text, faces):
|
||||
if len(cols) < 2 or cols[0].startswith("#") or not cols[0]:
|
||||
continue
|
||||
face = cols[0]
|
||||
if face not in faces:
|
||||
if not recount_all and face not in faces:
|
||||
continue
|
||||
# 本函数在三次替换**之后**调用 ⇒ `count_faces` 读到的是更新后的值。
|
||||
cols[1] = str(face_now.get(face, 0))
|
||||
@@ -503,8 +505,9 @@ def read_all_packs():
|
||||
for app in sorted(os.listdir(PACKS_DIR)):
|
||||
if os.path.isdir(os.path.join(PACKS_DIR, app)):
|
||||
packs.append(read_pack(app))
|
||||
if not packs:
|
||||
raise SyncError("packs/ 下没有包(目录:%s)" % PACKS_DIR)
|
||||
# 🔴 **零包是合法目标态**(2026-11-04 清理):示例包已整体搬到技能仓
|
||||
# `ssw-jnpf-lite-rust`,平台仓不认识任何业务包。此时四处派生位置
|
||||
# 全部归零(`--check` 会把它们钉成空)⇒ 业务一旦回流立刻红。
|
||||
return packs
|
||||
|
||||
|
||||
@@ -584,7 +587,7 @@ def require_module_for_every_pack(packs, mods):
|
||||
"包 %s 声明了实体,但缺 `src/backend/src/modules/%s.rs`\n"
|
||||
" 🔴 缺它的后果是**静默**的:菜单不会被种 ⇒ 面 B 守卫查不到菜单\n"
|
||||
" ⇒ 走「未映射放行」(越权);面 A 端点也不存在 ⇒ MVP 前端页面空着。\n"
|
||||
" ⇒ 跑 `bash scripts/new-pack.sh %s <Entity>` 补上。"
|
||||
" ⇒ 平台仓不允许自带业务包;请把 %s 放回业务仓 / 技能仓。"
|
||||
% (p["app"], p["app"], p["app"])
|
||||
)
|
||||
|
||||
@@ -625,87 +628,45 @@ def manifest_json_of(p):
|
||||
|
||||
|
||||
def gen_packs_gen(packs):
|
||||
"""生成 `src/backend/src/packs_gen.rs` 全文。"""
|
||||
"""生成 `src/backend/src/packs_gen.rs` 全文。
|
||||
|
||||
🔴 **2026-11-04 清理**:示例包已搬到技能仓,本仓恒为零包。
|
||||
本文件从「业务包清单」降级为**平台注入点的空实现**:
|
||||
- [`registry`] 恒返回空注册表(本仓不认识任何业务包);
|
||||
- [`registry_from`] 保留,供门面 `sspf::Platform::packs` 合并外部注册表。
|
||||
⇒ 平台能力(包路由装配 / 包 DDL 建表 / 白名单自检)一个不动,
|
||||
只是「默认带哪些包」变成空。
|
||||
"""
|
||||
if packs:
|
||||
raise SyncError(
|
||||
"平台仓不允许自带业务包(发现 %d 个)⇒ 业务包请用 sspf::Platform::packs() 注入"
|
||||
% len(packs)
|
||||
)
|
||||
L = []
|
||||
L.append("//! ⚠️ **本文件由 `scripts/pack-sync.py` 生成 —— 不许手改。**")
|
||||
L.append("//!")
|
||||
L.append("//! 它是内核的**业务包清单**:每个包一条 [`sspf_plugin::load_static`]")
|
||||
L.append("//! 调用 + 一份 `pack.toml` 的 JSON 快照。")
|
||||
L.append("//! **平台包零业务**(2026-11-04):本仓不认识任何业务包。")
|
||||
L.append("//! 业务仓通过 `sspf::Platform::packs(reg)` 注入自己装载的注册表,")
|
||||
L.append("//! 由 `crate::bootstrap` 在**同一个 `Db`** 上装配路由与 DDL。")
|
||||
L.append("//!")
|
||||
L.append("//! 🔴 **为什么是生成的**:批次 12 时这段在 `bootstrap.rs` 里手写 ——")
|
||||
L.append("//! 每加一个包要抄「manifest JSON + `PackSource` + `merge(vec![…])`」三段。")
|
||||
L.append("//! 漏掉最后那段 `merge` 的表现是:包**装载成功**、没有报错,")
|
||||
L.append("//! 但 `entities` / `routes` 全丢 ⇒ **面 B 端点静默 404**。")
|
||||
L.append("//! ⇒ 改成生成 ⇒ 「漏一处」在机制上不存在;真忘了跑生成,")
|
||||
L.append("//! `scripts/verify.sh` 的第一步(`pack-sync.py --check`)会红。")
|
||||
L.append("//!")
|
||||
L.append("//! 🔴 **`packs/` 是唯一真源** —— 加包跑 `bash scripts/new-pack.sh`,")
|
||||
L.append("//! 改完 `packs/*` 跑 `python3 scripts/pack-sync.py`。")
|
||||
L.append("//!")
|
||||
L.append("//! 🔴 **默认 feature 下本文件不装载任何包**(2026-11-04 标准平台包):")
|
||||
L.append("//! 4 个示例包降为 `example-packs` feature(只有 `sspf-admin` 与 `sspf-tests` 开)。")
|
||||
L.append("//! 业务仓只依赖门面 `sspf` ⇒ `cargo tree` 里**没有** `sspf-pack-*`")
|
||||
L.append("//! ⇒ 平台包里零业务(`check-arch.sh` 的 AR17 钉住)。")
|
||||
L.append("//! 🔴 为什么留着这个空文件:`bootstrap::load_packs()` / 白名单自检 /")
|
||||
L.append("//! `Extras::kernel()` 都是**平台能力**(业务仓要用),删掉会逼着每个")
|
||||
L.append("//! 业务仓自己抄一遍。留一个恒空的默认实现 ⇒ 平台侧零业务且不破装配链。")
|
||||
L.append("")
|
||||
L.append("use sspf_plugin::{LoadError, PackRegistry};")
|
||||
L.append("")
|
||||
L.append("/// 装载 `packs/*` 下的**全部**业务包(顺序 = `app_code` 字典序)。")
|
||||
L.append("/// 本仓业务包清单:恒为空。")
|
||||
L.append("///")
|
||||
L.append("/// 🔴 任一包装载失败 ⇒ **整体失败**(半加载的包比不加载更危险):")
|
||||
L.append("/// 半加载的包 = 一部分路由在、一部分不在 ⇒ 前端表现为「有的页面能用」。")
|
||||
L.append('#[cfg(feature = "example-packs")]')
|
||||
L.append("pub fn registry(kernel_version: &str) -> Result<PackRegistry, LoadError> {")
|
||||
L.append(" let mut regs: Vec<PackRegistry> = Vec::new();")
|
||||
L.append("")
|
||||
for p in packs:
|
||||
app = p["app"]
|
||||
ident = "sspf_pack_" + app.replace("-", "_")
|
||||
const = app.upper().replace("-", "_") + "_MANIFEST_JSON"
|
||||
L.append(" // ---- %s ----" % app)
|
||||
L.append(" regs.push(sspf_plugin::load_static(")
|
||||
L.append(' "%s",' % app)
|
||||
L.append(" %s," % const)
|
||||
L.append(" Box::new(%s::Pack)," % ident)
|
||||
L.append(" %s::DDLS," % ident)
|
||||
L.append(" kernel_version,")
|
||||
L.append(" )?);")
|
||||
L.append("")
|
||||
L.append(" Ok(sspf_plugin::merge(regs))")
|
||||
L.append("}")
|
||||
L.append("")
|
||||
L.append("/// 默认 feature(业务仓只依赖门面时的形态):**本仓不认识任何业务包** ⇒ 空注册表。")
|
||||
L.append("///")
|
||||
L.append("/// 🔴 返回 `Ok` 而不是 `Err`:空注册表是**合法形态**(业务仓自己注入业务包),")
|
||||
L.append("/// 不是装载失败。")
|
||||
L.append('#[cfg(not(feature = "example-packs"))]')
|
||||
L.append("/// 🔴 返回 `Ok` 而不是 `Err`:空注册表是**合法形态**,不是装载失败。")
|
||||
L.append("pub fn registry(_kernel_version: &str) -> Result<PackRegistry, LoadError> {")
|
||||
L.append(" Ok(PackRegistry::default())")
|
||||
L.append("}")
|
||||
L.append("")
|
||||
L.append("/// 把**外部已装载**的注册表合并成一个(门面 `sspf::Platform::packs` / `.pack` 用)。")
|
||||
L.append("///")
|
||||
L.append("/// 🔴 与 [`registry`] 的分工:`registry` 装的是**本仓 `packs/*` 的示例包**;")
|
||||
L.append("/// 本函数**只合并、不装载** ⇒ 业务仓用 `sspf::load_static` 装好自己的包后传进来。")
|
||||
L.append("/// 🔴 空 vec ⇒ 空注册表(合法,不是错误)。")
|
||||
L.append("/// 把**外部已装载**的注册表合并成一个(门面 `sspf::Platform::packs` 用)。")
|
||||
L.append("/// 🔴 只合并、不装载;空 vec ⇒ 空注册表(合法)。")
|
||||
L.append("pub fn registry_from(regs: Vec<PackRegistry>) -> PackRegistry {")
|
||||
L.append(" sspf_plugin::merge(regs)")
|
||||
L.append("}")
|
||||
L.append("")
|
||||
L.append("// ---------------------------------------------------------------- 清单快照")
|
||||
L.append("//")
|
||||
L.append("// 🔴 `pack.toml` 的**权威副本**在 `packs/<app>/pack.toml`(给人看、给导出工具读);")
|
||||
L.append("// 这里是它的**编译期 JSON 快照**。为什么要快照、不运行期读文件:")
|
||||
L.append("// 内核是**单二进制部署** ⇒ 运行目录里不一定有 `packs/` 目录。")
|
||||
L.append("// 两份的一致性由 `scripts/pack-sync.py` 保证(`--check` 会比对)。")
|
||||
L.append("//")
|
||||
L.append("// 🔴 快照只在 `example-packs` 下编译(否则默认 feature 的构建里是死代码)。")
|
||||
for p in packs:
|
||||
app = p["app"]
|
||||
const = app.upper().replace("-", "_") + "_MANIFEST_JSON"
|
||||
L.append("")
|
||||
L.append("/// `packs/%s/pack.toml` 的编译期快照。" % app)
|
||||
L.append('#[cfg(feature = "example-packs")]')
|
||||
L.append('const %s: &str = r#"%s"#;' % (const, manifest_json_of(p)))
|
||||
return "\n".join(L).rstrip() + "\n"
|
||||
|
||||
|
||||
@@ -738,109 +699,59 @@ def gen_pack_deps(packs):
|
||||
|
||||
|
||||
def gen_pack_feature(packs):
|
||||
"""生成 `src/backend/Cargo.toml` 的 `[features]` 段(`example-packs` 聚合开关)。
|
||||
"""🔴 **已退役**(2026-11-04 清理):`example-packs` feature 随示例包一起搬走。
|
||||
|
||||
🔴 用 `dep:` 语法 ⇒ 不产生「与依赖同名的隐式 feature」,
|
||||
业务仓不可能误开单个 `sspf-pack-demo`。
|
||||
🔴 **空列表也要生成**(`example-packs = []`)—— 标记段必须存在,
|
||||
否则 `pack-sync.py --check` 与闸门 AR17 都会失去判据。
|
||||
平台仓现在**没有** `[features]` 段,也没有任何可选业务依赖;业务仓通过
|
||||
`sspf::Platform::packs(reg)` 注入自己的注册表,不开任何平台 feature。
|
||||
⇒ 本函数保留为「非空即报错」的护栏:谁把示例包塞回 `packs/`,同步直接失败。
|
||||
"""
|
||||
names = ['"dep:%s"' % _pack_crate_name(p["app"]) for p in packs]
|
||||
return ["example-packs = [" + ", ".join(names) + "]"]
|
||||
if packs:
|
||||
raise SyncError(
|
||||
"平台仓不允许自带业务包(发现 %d 个:%s)\n"
|
||||
" ⇒ 业务包属于业务仓 / 技能仓,请通过 sspf::Platform::packs() 注入。"
|
||||
% (len(packs), ", ".join(p["app"] for p in packs))
|
||||
)
|
||||
return []
|
||||
|
||||
|
||||
def gen_mod_regions(mods):
|
||||
"""生成 `modules/mod.rs` 的五个段 ⇒ `{段名: 行列表}`。
|
||||
|
||||
🔴 **`ALL_SPECS` 与 `ALL_ROUTES` 必须同序** —— 都按 `mods` 的顺序生成
|
||||
⇒ `mod.rs` 的测试可以按 3 条一组配对(`chunks(3)`)。
|
||||
这个「同序」不是约定,是**生成保证**。
|
||||
|
||||
🔴 **每个段都生成两份**(2026-11-04 标准平台包):
|
||||
`#[cfg(feature = "example-packs")]` 的**实体清单**,
|
||||
与 `#[cfg(not(feature = "example-packs"))]` 的**空清单**。
|
||||
为什么不用「整段 cfg」:那会让 `all_specs()` / `all_menus()` / `router()`
|
||||
在默认 feature 下**根本不存在** ⇒ `routes.rs` / `bootstrap.rs` 编译不过。
|
||||
两份定义同名常量 / 函数 ⇒ 默认 feature 下**结构在、内容空**
|
||||
(业务仓注入自己的东西,平台侧零业务)。
|
||||
🔴 **2026-11-04 清理**:示例模块已搬到技能仓,本仓恒为零模块。
|
||||
五个生成段全部归零 ⇒ `all_specs()` / `all_menus()` / `ALL_ROUTES` /
|
||||
`router()` 都还在(装配链不破),只是**内容为空**。
|
||||
业务仓用自己的路由 + `sspf::Platform` 注入,不需要往内核塞文件。
|
||||
"""
|
||||
if not mods:
|
||||
raise SyncError("modules/ 下没有任何模块文件(至少要保住 demo/shop/books/asset)")
|
||||
|
||||
FEAT = '#[cfg(feature = "example-packs")]'
|
||||
NOFEAT = '#[cfg(not(feature = "example-packs"))]'
|
||||
|
||||
decls = ["// 每个模块一行:**文件即登记**(顺序 = 文件名字典序,不代表业务顺序)。",
|
||||
"// 🔴 只在 `example-packs` 下编译 —— 默认 feature 的内核**不认识任何业务模块**。"]
|
||||
for app, _, _, _ in mods:
|
||||
decls.append(FEAT)
|
||||
decls.append("pub mod %s;" % app)
|
||||
|
||||
specs = [
|
||||
"/// 全部业务实体 spec。",
|
||||
"///",
|
||||
"/// 🔴 **本段由 `scripts/pack-sync.py` 生成** —— 加模块不用手改(见文件头)。",
|
||||
FEAT,
|
||||
"pub const ALL_SPECS: &[EntitySpec] = &[",
|
||||
]
|
||||
for app, spec, _, _ in mods:
|
||||
specs.append(" %s::%s," % (app, spec))
|
||||
specs.append("];")
|
||||
specs.append("/// 默认 feature:平台侧零业务 ⇒ 空清单(业务仓用 `sspf::Platform::packs` 注入)。")
|
||||
specs.append(NOFEAT)
|
||||
specs.append("pub const ALL_SPECS: &[EntitySpec] = &[];")
|
||||
|
||||
routes = [
|
||||
"/// **全部业务路由**(面 A:`/api/ssw/{appCode}/{Entity}/{动作}`,每模块 3 条)。",
|
||||
"///",
|
||||
"/// 🔴 **与 `ALL_SPECS` 同序**(同一份模块清单生成)⇒ 可以按 3 条一组配对。",
|
||||
FEAT,
|
||||
"pub const ALL_ROUTES: &[&str] = &[",
|
||||
]
|
||||
for app, _, _, n in mods:
|
||||
for i in range(n):
|
||||
routes.append(" %s::ROUTES[%d]," % (app, i))
|
||||
routes.append("];")
|
||||
routes.append("/// 默认 feature:没有业务路由可登记。")
|
||||
routes.append(NOFEAT)
|
||||
routes.append("pub const ALL_ROUTES: &[&str] = &[];")
|
||||
|
||||
menus = [
|
||||
"/// 全部业务内置菜单(由**装配根** [`crate::bootstrap`] 传给平台层的种子",
|
||||
"/// ⇒ **平台层不认任何业务菜单**,红线 12)。",
|
||||
FEAT,
|
||||
"pub const ALL_MENUS: &[MenuSpec] = &[",
|
||||
]
|
||||
for app, _, menu, _ in mods:
|
||||
menus.append(" %s::%s," % (app, menu))
|
||||
menus.append("];")
|
||||
menus.append("/// 默认 feature:平台侧零业务 ⇒ 种子只种平台菜单。")
|
||||
menus.append(NOFEAT)
|
||||
menus.append("pub const ALL_MENUS: &[MenuSpec] = &[];")
|
||||
|
||||
router = [
|
||||
"/// **全部业务模块的路由**(`Router::merge` 进总路由)。",
|
||||
"///",
|
||||
"/// 🔴 加业务模块 ⇒ **不用改这里**(本段由 `pack-sync.py` 生成)。",
|
||||
FEAT,
|
||||
"pub fn router() -> Router<AppState> {",
|
||||
" %s::router()" % mods[0][0],
|
||||
]
|
||||
for app, _, _, _ in mods[1:]:
|
||||
router.append(" .merge(%s::router())" % app)
|
||||
router.append("}")
|
||||
router.append("/// 默认 feature:没有任何业务路由。")
|
||||
router.append(NOFEAT)
|
||||
router.append("pub fn router() -> Router<AppState> {")
|
||||
router.append(" Router::new()")
|
||||
router.append("}")
|
||||
if mods:
|
||||
raise SyncError(
|
||||
"平台仓不允许自带业务模块(发现 %d 个:%s)\n"
|
||||
" ⇒ 面 A 适配器属于业务仓,请用 sspf::Platform::router() 注入。"
|
||||
% (len(mods), ", ".join(m[0] for m in mods))
|
||||
)
|
||||
|
||||
return {
|
||||
"MODS": decls,
|
||||
"SPECS": specs,
|
||||
"ROUTES": routes,
|
||||
"MENUS": menus,
|
||||
"ROUTER": router,
|
||||
"MODS": [
|
||||
"// 🔴 **平台包零业务**:本仓不认识任何业务模块。",
|
||||
"// 业务模块的路由由业务仓经 `sspf::Platform::router()` 注入。",
|
||||
],
|
||||
"SPECS": [
|
||||
"/// 本仓业务实体 spec:恒为空(平台包零业务)。",
|
||||
"pub const ALL_SPECS: &[EntitySpec] = &[];",
|
||||
],
|
||||
"ROUTES": [
|
||||
"/// 本仓业务路由表:恒为空(平台包零业务)。",
|
||||
"pub const ALL_ROUTES: &[&str] = &[];",
|
||||
],
|
||||
"MENUS": [
|
||||
"/// 本仓业务内置菜单:恒为空;业务菜单由 `.menus()` / `.packs()` 注入。",
|
||||
"pub const ALL_MENUS: &[MenuSpec] = &[];",
|
||||
],
|
||||
"ROUTER": [
|
||||
"/// 本仓业务路由:恒为空。",
|
||||
"pub fn router() -> Router<AppState> {",
|
||||
" Router::new()",
|
||||
"}",
|
||||
],
|
||||
}
|
||||
|
||||
|
||||
@@ -910,7 +821,9 @@ def sync(write=True):
|
||||
# ④ Cargo 依赖段 + ⑤ `[features]` 段(两段都生成 ⇒ 「漏一处」不存在)
|
||||
old = scan.read(BACKEND_CARGO)
|
||||
new = replace_marker_block(old, GEN_DEPS_OPEN, GEN_DEPS_CLOSE, gen_pack_deps(packs))
|
||||
new = replace_marker_block(new, GEN_FEAT_OPEN, GEN_FEAT_CLOSE, gen_pack_feature(packs))
|
||||
# 🔴 `[features]` 段随示例包一起退役(2026-11-04):平台仓不再有任何
|
||||
# 可选业务依赖 ⇒ 没有 feature 可生成。gen_pack_feature 只做「非空即报错」的护栏。
|
||||
gen_pack_feature(packs)
|
||||
artifacts.append(("src/backend/Cargo.toml", old, new, None))
|
||||
|
||||
if write:
|
||||
|
||||
Reference in new issue
Block a user