平台包零业务:示例移到技能仓、解绑 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

+21 -65
View File
@@ -1,10 +1,10 @@
# 契约规格 —— ssw-jnpf-lite-rust
# 契约规格 —— sspf 标准平台包
> **本文件是唯一规格来源(binding spec)。** 所有实现任务、代码评审、最终评审都以此为准。
> 与 `HANDOFF.md` 冲突时,以本文件为准;与本文件冲突的**计划文字**由控制者裁决并记入 ledger。
>
> 🔴 **本文件 = 面 A(ssw/react 契约)的规格,冻结不动。**
> 面 B(官方 JNPF 契约面)的规格在 **[`JNPF_COMPAT_SURFACE.md`](../JNPF_COMPAT_SURFACE.md)**(已落地 18/18),
> 面 B(官方 JNPF 契约面)的规格在 **`JNPF_COMPAT_SURFACE.md`(技能仓 `ssw-jnpf-lite-rust`)**(已落地 18/18),
> 两面共用同一套 `base_*` 表 / cipher / seed,但**权限判据不同**(面 A 按菜单路径、面 B 按 `f_en_code`)。
---
@@ -238,6 +238,13 @@ pub fn valid_column(name: &str) -> Option<String>;
> 两个方向的依据分开:**写**以**官方 DDL** 为准(本仓的种子会写 `f_creator_user_id` /
> `f_creator_time`);**读**以 **react 的 entity 列集**为准(见 §5.3 的投影规则)。
> 🔴 **2026-11-04 平台包零业务清理**:以下「业务表」段落描述的是**已迁出本仓的示例**
> (demo / shop / books / asset)。本仓 `db/schema.sql` 只有 177 张平台表,构建产物里
> **没有**这些表、没有对应 spec、没有面 A 端点;示例包与 DDL 的权威副本在技能仓
> `ssw-jnpf-lite-rust`。本节表格保留为**示例 DDL 规格参考**(技能仓与业务仓要用),
> 不再是对本仓运行时的描述。运行时判据见附录 A `[MODULE]`(恒空)与
> `[RULER]`(面 A 冒烟的 4 条防回流断言)。
业务表 3 张 —— 表名与 react 版同名(两版后端可开同一个库):
| 表 | 列 |
@@ -1113,34 +1120,14 @@ m_user 用户管理 permission.user system/User m_sys 2 2
m_role 角色管理 permission.role system/Role m_sys 2 3
m_org 机构管理 permission.organize system/Organize m_sys 2 4
m_menu 菜单管理 permission.menu system/Module m_sys 2 5
<!-- PACK:BEGIN -->
# 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改**
# (下次同步会被覆盖;改包就够)
m_resource 数据资源 permission.asset.dataResource asset/DataResource 0 2 app 9
m_book 图书超市 permission.books.book books/Book 0 2 app 8
m_demo Demo 示例 permission.demo demo-item 0 2 app 6
m_product 产品管理 permission.shop.product shop/Product 0 2 app 7
<!-- PACK:END -->
[MENU_TREE]
系统管理:用户管理,角色管理,机构管理,菜单管理|Demo 示例:|产品管理:|图书超市:|数据资源:
系统管理:用户管理,角色管理,机构管理,菜单管理
[MODULE]
# app entity table urlAddress moduleKey menuId apiFile rsFile
# moduleKey = 该模块的守卫菜单 key;`None` = 仅需登录(无菜单权限要求)
# apiFile = 前端**应不应该**有 `src/frontend/src/api/<name>.ts`(`有` / `无`)
# rsFile = 业务模块源文件 `src/backend/src/modules/<name>.rs`
<!-- PACK:BEGIN -->
# 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改**
# (下次同步会被覆盖;改包就够)
asset DataResource asset_data_resource asset/DataResource asset/DataResource m_resource 有 asset.rs
books Book book_shop_book books/Book books/Book m_book 有 books.rs
demo DemoItem demo_item demo-item None m_demo 无 demo.rs
shop Product shop_product shop/Product shop/Product m_product 有 shop.rs
<!-- PACK:END -->
[ENDPOINT]
# face method path guard owner
# face = A(面A 专属) / B(面B 专属) / AB(两面共用,按判别头 `Vue-Version: 3` 分流)
@@ -2189,40 +2176,10 @@ B GET /api/blade-visual/record/detail onlineDev.dataScreen platform
B POST /api/blade-visual/record/save onlineDev.dataScreen platform
B POST /api/blade-visual/record/update onlineDev.dataScreen platform
B POST /api/blade-visual/record/remove onlineDev.dataScreen platform
<!-- PACK:BEGIN -->
# 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改**
# (下次同步会被覆盖;改包就够)
A GET /api/ssw/asset/DataResource/List asset/DataResource asset
A POST /api/ssw/asset/DataResource/Save asset/DataResource asset
A DELETE /api/ssw/asset/DataResource/Delete asset/DataResource asset
A GET /api/ssw/books/Book/List books/Book books
A POST /api/ssw/books/Book/Save books/Book books
A DELETE /api/ssw/books/Book/Delete books/Book books
A GET /api/ssw/demo/DemoItem/List 登录 demo
A POST /api/ssw/demo/DemoItem/Save 登录 demo
A DELETE /api/ssw/demo/DemoItem/Delete 登录 demo
A GET /api/ssw/shop/Product/List shop/Product shop
A POST /api/ssw/shop/Product/Save shop/Product shop
A DELETE /api/ssw/shop/Product/Delete shop/Product shop
B GET /api/asset/DataResource permission.asset.dataResource asset
B POST /api/asset/DataResource permission.asset.dataResource asset
B DELETE /api/asset/DataResource/{id} permission.asset.dataResource asset
B GET /api/books/Book permission.books.book books
B POST /api/books/Book permission.books.book books
B DELETE /api/books/Book/{id} permission.books.book books
B GET /api/demo/DemoItem 登录 demo
B POST /api/demo/DemoItem 登录 demo
B DELETE /api/demo/DemoItem/{id} 登录 demo
B GET /api/shop/Product permission.shop.product shop
B POST /api/shop/Product permission.shop.product shop
B DELETE /api/shop/Product/{id} permission.shop.product shop
<!-- PACK:END -->
[FACE]
# face 条数 说明
A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条)
B 1019 面 B 专属(官方 JNPF 形状;批次 13 新增 Area 7 + Variate 7;批次 14 新增数据中心 29;批次 15 新增系统服务 39;批次 16 新增权限关系 26;批次 17 新增 onlineDev 78 + Report 23;批次 18 新增 core 22;批次 19 新增 workFlow 104;批次 20 新增 msgCenter 51(前端 50 + 动态路径别名 1);批次 21–23 新增 aiCenter 75 + extend 64 + teamwork 40 + 收尾 4;批次 24 新增官方移动端 40)
A 16 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条)
B 1007 面 B 专属(官方 JNPF 形状;批次 13 新增 Area 7 + Variate 7;批次 14 新增数据中心 29;批次 15 新增系统服务 39;批次 16 新增权限关系 26;批次 17 新增 onlineDev 78 + Report 23;批次 18 新增 core 22;批次 19 新增 workFlow 104;批次 20 新增 msgCenter 51(前端 50 + 动态路径别名 1);批次 21–23 新增 aiCenter 75 + extend 64 + teamwork 40 + 收尾 4;批次 24 新增官方移动端 40)
AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流)
[OFFICIAL]
@@ -3285,19 +3242,18 @@ POST /api/blade-visual/record/remove implemented VisualRecordController.java:111
[RULER]
# name 期望断言数(尺子**自己**断言的条数;跑出来的条数对不上 ⇒ 失败)
# 43 = react 版对齐的 32 条 + 真实业务模块 asset/DataResource 9 条 + 多应用 2 条
# (无 App-Code ⇒ 主系统 / App-Code: app-b ⇒ app-b)
perm-smoke.sh 43
# 🔴 21 = 平台权限闭环 17 条 + 防回流 4 条(2026-11-04 零业务清理)。
# 原 43 条里的 25 条示例业务 CRUD 已随示例包搬到技能仓;本尺子保留
# 登录/token/菜单树/授权/多应用/404,另逐一断言 4 个面 A 业务前缀恒 404。
perm-smoke.sh 21
# 23 = 原 18 条 + 多应用 1 条(App-Code: app-b ⇒ currentSystemId = app-b,与面 A 同一口径)
# + 用户 CRUD 4 条(详情无口令 / 改档只 SET 出现的键 / 批量启停 + 软删)
perm-smoke-jnpf.sh 23
# 🔴 **本仓现在有前端**(批次 12 起 `src/frontend` = React MVP 模板,
# 见 HANDOFF §0-ter)⇒ check-module 的前端接触点从 `⏭` 变成**真检查**,条数随之增加:
# 123 = demo 31 + shop 30 + books 30 + asset 30 + 全局面 A / 面 B 判别头 2
# 前端那几条的构成:demo 走「view 直连」4 条(契约 apiFile=无,本来就没有 api 层);
# 其余三个走「api 三导出(listX/saveX/deleteX)」3 条 + views 页面 1 条 + App.tsx 路由 1 条。
# (更早的 114 = 4 模块 × 28 + 2,那时本仓后端-only,前端 4×4 处全打 `⏭` 但仍计入条数。)
check-module.sh 123
# 🔴 3 = 平台包零业务的**防回流三条**(2026-11-04 清理):
# `packs/` 不存在 / `modules/` 无业务适配器 / 契约 [MODULE] 无数据行。
# 旧值 123 = 4 个业务模块 × ~30 个接触点;模块搬走后这把尺子改跑防回流分支,
# 分支条件本身即自证([MODULE] 只要出现一行数据就立刻回到 123 条的完整检查)。
check-module.sh 3
check-boundary.sh 12
check-contract.sh 10
check-citations.sh 4