平台包零业务:示例移到技能仓、解绑 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:
admin committed 2026-11-04 21:54:22 +08:00
1 parent ca8abf9cc9
commit ecb77b230f
94 files changed
+842 -8986

No files matched your search

+59
View File
@@ -9,6 +9,65 @@
---
## 0. 2026-11-04 晚:平台包零业务清理(第一批,**基于 v0.3.0,新提交**)
需求:`@docs/SSPF-BUSINESS-COMPOSITION.md` 之后的追加要求 —— 「示例部分拿到外面去做,
技能依赖**打好的包及说明**而不是整个 sspf 源码仓,前端留着;一次做清理,一次改技能」。
`v0.3.0` tag 一字不动,清理全走新提交;旧形态在 tag 里完整可回溯。
**做了什么**
1. 物理移出:`packs/{asset,books,demo,shop}`、`src/backend/src/modules/{asset,books,demo,shop}.rs`、
纯技能副本(`template-boot-jnpf/`、`references/`、`JNPF_*`、`PERMISSION.md`、`HOWTO_MODULE.md`、
`MIGRATION.md`、`docs/README-project.md`)、纯业务测试 `crud_it.rs`、
`scripts/new-pack{,-gen}`。备份在 `/tmp/sspf-cleanup-backup/`(供第二批改技能用)。
**前端 `src/frontend/` 与前端脚本按用户要求原样保留。**
2. 解绑:`example-packs` feature、`example_packs()`、`packs/*` workspace member、
`sspf-pack-*` 依赖(Cargo.lock 与 `cargo tree -p sspf` 均无)、`sspf-admin` 的 feature 开关。
`packs_gen.rs` / `modules/mod.rs` 生成段降级为**恒空的注入点**(装配链一条不删),
`pack-sync.py` 把「零包」钉成合法目标态,出现任何业务包直接报错。
3. 尺子全部改造成**防回流**,不是「跳过」:CP1 用固定 `ANTI_REFLUX_TOKENS`、
`check-module` 零业务三条、`check-arch` AR2/PACK1 正向断言 + **AR17 升级为
「5 个 Cargo.toml 无业务包依赖 / GEN 段恒空 / packs/ 不存在」**、
契约反自证锚点换成平台路由行、`FACE` 计数零包时重算。
4. 运行时尺子:面 A `perm-smoke.sh` 43 → **21 条**(17 条平台权限闭环 + 4 条业务端点 404);
面 B 23 条不变(授权夹具 `m_demo` → 平台菜单 `m_menu`);`pack_smoke_it` 改成
「清单恒空 + 平台端点 200 + 4 个示例端点 404」的运行时探针;
`auth_it` / `batch7_it` / `db_it` / `permission_it` / `seed_it` / `routes.rs` 单测
全部换成平台内置夹具(5 菜单 / `base_role` / `base_module` / 常量投影)。
5. 文档:`README` / `CLAUDE.md` / `CHANGELOG.md` / `docs/contract.md` §5.1 /
`schema.sql` / `db.rs` 注释同步;契约 `[MENU_TREE]` 收成 5 条系统菜单,
`[RULER]` 改 21 / 3。
**🔴 回归与坑(下轮别再踩)**
- `cargo test` 遇到第一个失败二进制就**停** ⇒ 必须 `cargo test --workspace --no-fail-fast`
才能一次拿全失败清单。本轮依次暴露:`crud_it`(编译)→ `auth_it` → `db_it` →
`batch7_it` → `pack_smoke_it` → `permission_it` → `seed_it` + `routes.rs` 单测。
- **跳过 ≠ 判据**:零业务后 `check-arch` 的 AR2/PACK1 原本各 `skip` 一条,
AR17 的反自证 12/14 因「没有 pack 依赖行可改」**静默假红**。已全部换成正向断言 +
注入式探针(造一条 `sspf-pack-probe` 依赖)。反自证 1/14 的 `mkdir -p packs/...`
会留下**空 `packs/`**,必须用 `rmdir` 收干净,否则 AR2/AR17 当场红。
- CP1 扫的是**平台层源码里的字面量** ⇒ 新写的防回流单测若直接写
`/api/ssw/<app>/...` 会把自己判红;路径要运行时用 app/entity 两段拼。
- `query_json` 对原生 numeric 列给 JSON **数字**(9.9),只有 `::text` 才是字符串 "9.90"
⇒ `db_it` 现在两种形态都钉。
- 运行时尺子默认读 `target/release/sspf-admin`;改完源码**必须**
`cargo build --release -p sspf-admin`,否则打的是旧二进制(本轮被它骗过一次)。
- 契约 `[RULER]` 条数 / `[MENU_TREE]` 是尺子的单一真源,改断言必须同步;
`[MENU_TREE]` 从 9 菜单收成 5 菜单后,`perm-smoke` 断言 13 的形状变成 `菜单管理:`。
**验收**:`cargo test --workspace --no-fail-fast` **649 passed / 0 failed / 6 ignored**
(清理前 711 ⇒ 下降 62,全是随示例搬走的纯业务测试,未造业务夹具冒充零业务);
`verify.sh --smoke` **14/14 步全绿**(6 道静态闸门 + 全量测试 + 5 把运行时尺子);
`check-arch.sh` 24/24 / 0 跳过,`--self-test` 14/14;`cargo tree -p sspf | grep sspf-pack` 无输出。
**待办(第二批)**:技能仓 `~/.agents/skills/ssw-jnpf-lite-rust` 接收示例,改成
`sspf = { git=…, tag=… }` 的薄脚手架,删掉旧的 `src/backend` 自研实现,重写
`SKILL.md` / `README.md`,前端随发布包保留。版本号(打 `v0.4.0` 还是只提交)需用户拍板。
---
## 0-bis. 2026-11-04 `v0.3.0`:业务自带状态的可组合装配(P1 交付,**已推送 `origin`:`main` + tag**)
需求与实施记录:`docs/SSPF-BUSINESS-COMPOSITION.md`(含 §11 四项评审决策)。