平台包零业务:示例移到技能仓、解绑 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
@@ -1,154 +0,0 @@
|
||||
# ssw-jnpf-lite-rust
|
||||
|
||||
**JNPF 兼容契约的 Rust 实现** —— 单二进制、零外部服务(进程内原生 PostgreSQL)。
|
||||
|
||||
它的存在意义只有一条:**让「用 Rust 写业务」和「迁回官方 JNPF(Java)」之间是机械翻译,而不是重写。**
|
||||
为此本仓的**数据模型(`base_*` 表名/列名/语义)与 HTTP 契约**从第一天起就锁死成官方 JNPF 的形状。
|
||||
|
||||
本仓是**双面后端**:**同一进程**同时提供
|
||||
**面 A**(ssw/react 契约,27 条路由,冻结)与 **面 B**(官方 JNPF 契约,5 条路由 + 2 条共用路由按 `Vue-Version: 3` 分流),
|
||||
共用同一套 `base_*` 表 / cipher / seed,但**权限判据不同**(面 A 按菜单路径 / 面 B 按 `f_en_code` 点权限)。
|
||||
⇒ 既是「Rust ⇒ 官方 JNPF」的**可移植性验证床**,也是「官方 JNPF / React 版 ⇒ 打到本框架跑」的**对照靶场**。
|
||||
|
||||
- 📘 **契约唯一真源**:[`docs/contract.md`](contract.md) —— 与本文件冲突时以契约为准。
|
||||
- 🧭 **agent 指引**:[`CLAUDE.md`](../CLAUDE.md)(红线 / 踩坑 / 端点全表)· [`HANDOFF.md`](../HANDOFF.md)(交接)。
|
||||
- 🛠 **怎么起 / 怎么冒烟 / 常见故障**:[`docs/runbook.md`](runbook.md)。
|
||||
- 💾 **编译膨胀问题及处理**:[`docs/build-bloat.md`](build-bloat.md)(`target/` 58G → 1.2G 的根因、处置与规矩)。
|
||||
- 🧾 **实施期裁决(98 条「什么—为什么—代价」)**:[`docs/decisions.md`](decisions.md)
|
||||
· **分支级已知限制**:[`docs/known-limitations.md`](known-limitations.md)。
|
||||
|
||||
---
|
||||
|
||||
## 快速开始
|
||||
|
||||
```bash
|
||||
# 一次性:装依赖(cargo fetch + npm install)+ 构建(cargo build --release + vite build)
|
||||
bash run.sh install
|
||||
bash run.sh build
|
||||
|
||||
# 日常:后台起后端(30010) + 前端(5173),日志在 .logs/,PID 在 .run/
|
||||
bash run.sh dev
|
||||
# 前端 http://127.0.0.1:5173 后端 http://127.0.0.1:30010
|
||||
# 账号 admin / 123456
|
||||
# (**后端与前端都就绪**才算成功;任一没就绪 ⇒ 退出码 1 并打印对应日志尾部)
|
||||
|
||||
bash run.sh stop # 停(幂等)
|
||||
bash run.sh logs # 看日志尾部
|
||||
```
|
||||
|
||||
| 端口 | 谁 | 说明 |
|
||||
|---|---|---|
|
||||
| `30010` | 后端(Rust) | **硬约定**:`run.sh` 的端口不许改 —— `PORT` ≠ 30010 时 `run.sh dev` / `run.sh backend` 报错退出 2(要换端口请**直接跑二进制**)。**后端二进制本身**吃 `PORT`(非法值回落 30010)。默认**只监听 `127.0.0.1`**;`BIND_ADDR=0.0.0.0` 才对外暴露 |
|
||||
| `5173` | 前端(vite dev) | `strictPort: true` ⇒ 端口被占直接报错,不自动换端口 |
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
```
|
||||
ssw-jnpf-lite-rust/
|
||||
├── Cargo.toml # cargo workspace 根(成员 = src/backend)+ release profile
|
||||
├── run.sh # install / build / dev / backend / frontend / stop / logs
|
||||
├── .env.example # PORT / BIND_ADDR / PGLITE_DIR(PGLITE_DIR 只能写绝对路径或 memory://)
|
||||
├── src/backend/ # Rust 后端(axum 0.8 + pglite-rs 0.2,10 张表,32 条路由 = 面 A 27 + 面 B 5)
|
||||
├── src/frontend/ # react 技能前端**逐字复制**(只改 vite 代理端口 30000 → 30010)
|
||||
├── scripts/perm-smoke.sh # 权限闭环冒烟(32 条断言,零 node 依赖)—— 面 A 尺子
|
||||
├── scripts/perm-smoke-jnpf.sh # 官方 JNPF 形状冒烟(18 条断言)—— 面 B 尺子(**已全绿 18/18**)
|
||||
├── scripts/smoke_backend.sh # 两把尺子的「隔离后端」自启动助手(默认自起 ⇒ CI 可跑)
|
||||
├── scripts/check-module.sh # 业务模块 9 接触点静态自检(纯静态,不起后端)
|
||||
└── docs/ # contract.md(契约)· runbook.md(运维)· decisions.md(裁决)· known-limitations.md(已知限制)
|
||||
# build-bloat.md(编译膨胀问题及处理)
|
||||
# JNPF_SOURCE_AUDIT.md(官方源码逐行核对)· JNPF_COMPAT_SURFACE.md(面 B 规格)· MIGRATION.md(迁移指南)· ddl/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 它做了什么(v1 = 全量契约对齐)
|
||||
|
||||
- **登录 / `CurrentUser`**:`POST /api/oauth/Login`(form-urlencoded,密文 hex)⇒ `{token, expiresIn:7200, tokenTypeName:'bearer'}`;
|
||||
`GET /api/oauth/CurrentUser` ⇒ `{userInfo, menuList}`。
|
||||
- **5 组 `base_*` 管理 CRUD**:用户 / 角色 / 机构 / 菜单 / 授权。
|
||||
- **统一授权**:`PUT /api/permission/Authority/Data/{objectId}`(body `{objectType:'role', module:[...]}`,**小写 + 一维数组**)。
|
||||
- **四源权限合并**:用户直授 + 角色 + 组织 + 岗位;**管理员在任何 SQL 之前短路放行**;**菜单未映射 ⇒ 放行**。
|
||||
- **两段式种子**:`ensure_base`(每次启动补内置角色/菜单/授权)+ `first_seed`(仅首次建 `admin/123456`)。
|
||||
- **3 个业务模块**(spec 驱动 CRUD 引擎):`demo/DemoItem` · `shop/Product` · `books/Book`。
|
||||
|
||||
### 契约红线(摘要,完整版见 `CLAUDE.md`)
|
||||
|
||||
1. **业务失败一律 HTTP 200 + `{code,msg,data}`**;成败只看 body 的 `code`。
|
||||
唯一例外:**未知路由 = HTTP 404**(body 仍是信封)。鉴权失败也是 200(`600` 未登录 / `403` 无菜单权限)。
|
||||
2. **`base_*` 表名/列名逐字对齐官方 JNPF DDL**(含两个「故意不修正」的陷阱,见 `CLAUDE.md`)。
|
||||
3. **numeric 列必须是 JSON 字符串**(`"9.90"`,不是 `9.9`);int 列保持数字。
|
||||
4. **口令不得外泄**:库里存 `md5(明文)`,对外响应手工挑字段(用户列表去掉 `password`)。
|
||||
5. **schema DDL 绝不可从 HTTP 下载**。
|
||||
|
||||
---
|
||||
|
||||
## 验收门
|
||||
|
||||
| 门 | 命令 | 通过标准 |
|
||||
|---|---|---|
|
||||
| ① 编译 | `cargo build --release` | 0 error **0 warning** |
|
||||
| ② 单测 | `cargo test` | 全绿(当前 **197 passed / 0 failed**) |
|
||||
| ③ 冒烟 | `bash scripts/perm-smoke.sh` | **PASS=32 FAIL=0**(🔴 **后端不用先起** —— `:30010` 不通 ⇒ 尺子自起隔离实例,跑完即删) |
|
||||
| ③' 冒烟(面 B) | `bash scripts/perm-smoke-jnpf.sh` | **PASS=18 FAIL=0 SKIP=0**(**已达标**;同样默认自起隔离实例) |
|
||||
| ④ 前端手验 | `bash run.sh dev` | `http://127.0.0.1:5173` → `admin/123456` 登录 → 菜单树正确 → 5 个管理页可增删改 → DemoItem/Product/Book 三页可用 → 退出再登录 |
|
||||
|
||||
外加:`bash scripts/check-module.sh`(9 接触点静态自检)—— 加业务模块后立刻跑的前置闸门。
|
||||
|
||||
### 第二把尺子(面 B:官方 JNPF 形状)
|
||||
|
||||
```bash
|
||||
bash scripts/perm-smoke-jnpf.sh # 18 条断言,打印「面 B 覆盖 N/18」
|
||||
```
|
||||
|
||||
**面 B = 官方 JNPF 契约面**(官方形状的端点 / 响应 / 码表),规格见 `../JNPF_COMPAT_SURFACE.md`。
|
||||
✅ **已落地**(`src/backend/src/platform/jnpf.rs`,S1–S6 全完成)⇒ 当前报 **`PASS=18 FAIL=0 SKIP=0`(面 B 覆盖 18/18)**。
|
||||
面 B 的判别头是 **`Vue-Version: 3`**(官方前端必发,本仓前端**唯一不发**的一头 ⇒ 零歧义)。
|
||||
面 A 27 条路由**冻结**、面 B 5 条新增 ⇒ **同一进程**同时提供两套契约。
|
||||
|
||||
> 本机 curl 走系统代理 ⇒ 打 localhost **必须**加 `--noproxy '*'`。
|
||||
|
||||
---
|
||||
|
||||
## 三个参照物(各司其职,别混)
|
||||
|
||||
| 参照物 | 地位 |
|
||||
|---|---|
|
||||
| 官方 JNPF 源码 + DDL(`~/Desktop/workspace/jnpf/`) | **数据模型真源**(`base_*` 表名/列名) |
|
||||
| `ssw-jnpf-lite-react` 技能(`~/Desktop/workspace/skills/ssw-jnpf-lite-react/`) | **行为真源**(NestJS 版把契约跑起来了);本仓前端是它的**逐字复制** |
|
||||
| `tdc-rs` 兄弟项目(`~/Desktop/workspace/tdc-rs/`) | **只抄工程手法**;不共享代码 / 端口 / 数据目录 |
|
||||
|
||||
---
|
||||
|
||||
## 已知限制(分支级)
|
||||
|
||||
- **面 B 的 10 条已知偏差**(B1–B10,逐条见 `../JNPF_COMPAT_SURFACE.md` §8 与 `docs/known-limitations.md` §H):
|
||||
授权读 `list` 返空数组 · `sysConfigInfo` 返 `{}` · `currentSystemId` 固定 ·
|
||||
**无按钮/列/表单/数据级权限** · 三个业务菜单的 `f_en_code` 是自拟占位 ·
|
||||
`permissionList` 粒度 = 每菜单一条(`modelId` = 菜单 id)· `Organize/AsyncList` 未分页。
|
||||
- **口令存储缺官方 `secretkey` 一步**:本仓存 `md5(明文)`,官方存 `md5(md5(明文)+secretkey)`。
|
||||
迁官方时**一次性换算**即可,**不需要明文**(见 `../MIGRATION.md` §7)。
|
||||
- **两套权限判据并存**:面 A 按菜单路径(`f_url_address`)、面 B 按点权限编码(`f_en_code`)。
|
||||
⇒ 同一用户可能**面 A 通、面 B 拒**(这是设计,不是 bug);种子菜单已补 `f_en_code`(8 条),
|
||||
业务菜单的 `f_en_code` 仍是自拟值,迁官方前须换成官方真实编码。
|
||||
|
||||
- **release 二进制没有 catch-all 的自动化覆盖**:触发 panic 的端点是 `#[cfg(test)]` 专属;
|
||||
catch-all 中间件代码在测试构建与 release 构建里逐字相同,且 release profile **无** `panic = "abort"` ⇒ 行为等价。
|
||||
- **`Path<String>` 遇畸形百分号编码** ⇒ **实测 axum 0.8.9 接受该转义**:`PUT /api/permission/Authority/Data/%zz`
|
||||
返回 **HTTP 200 + `{"code":600,"msg":"未登录","data":null}`**(信封,正常)⇒ **不存在**「返非信封 400」这种破口。
|
||||
- **token 的真实寿命 = 后端进程寿命**(`session.rs` 是内存 token 表、**没有 TTL**):
|
||||
登录响应里的 `expiresIn: 7200` 是**契约 §6.1 逐字定死**的字面量、**不会被强制执行**
|
||||
(进程不重启就永不过期);契约未覆盖 TTL ⇒ 不改。
|
||||
- **冒烟脚本每次跑会往库里留一行** `shop_product` + 一行 `book_shop_book` + 一行 `smoke_user`(react 同款行为,契约未要求清理)。
|
||||
🔴 **但只在「复用外部后端」时**:尺子**默认自起隔离实例**(临时数据目录)⇒ 跑完即删、**不留脏数据**、
|
||||
两把尺子**互不污染**、**CI 可跑**;显式给了 `B` 才打外部库。
|
||||
- 冒烟脚本在「重复账号 curl 超时」场景下 stderr 会多一行 `cat: … No such file`(观感,判据不受影响)。
|
||||
- 冒烟脚本在「空 body 前置失败」时 jq / python 两条路径的前置提示文案不同(退出码都是 2)。
|
||||
|
||||
---
|
||||
|
||||
## 技术栈
|
||||
|
||||
Rust 2021 · axum 0.8 · tokio · pglite-rs 0.2(进程内原生 PostgreSQL,零服务/零 Docker/零 WASM)·
|
||||
aes 0.8 + ecb 0.1 + md-5 0.10 · React 18 + Vite 5(逐字复用)
|
||||
@@ -8,6 +8,10 @@
|
||||
> 与原稿的三处**有意偏离**见 §10。
|
||||
>
|
||||
> 适用范围:本仓(`ssw-platform`)。本轮**不碰 tdc-rs 代码**,也不改面 A / 面 B 的任何对外行为。
|
||||
>
|
||||
> ⚠️ 本稿 §2–§6 的「现状」行号是 **v0.2.0 交付前**的快照。2026-11-04 的零业务清理
|
||||
> 已把 `packs/` 与 `modules/*.rs` 搬到技能仓,这几处源码的行号与结构均已变化 ⇒
|
||||
> 引文改为**不带行号的路径**(保留文件级定位,不再对失效的旧行号做核对)。
|
||||
> 结论先行:sspf 已有的平台能力(面 B 全套、`base_*` 181 张表、cipher、602 码、704 测试)都不用重做,
|
||||
> **缺的只有一层「可被外部仓依赖 + 可被业务仓装配」的门面**。
|
||||
|
||||
@@ -73,7 +77,7 @@ sspf::Platform::new()
|
||||
独立 TDC 节点为自闭环引的是**全量 JNPF jar** ⇒ 面 B 全套平台能力要随平台包一起进业务二进制。
|
||||
|
||||
**C4 · 平台包里零业务。**
|
||||
`ssw_platform` 现在编译期依赖 `packs/{asset,demo,shop,books}`(`src/backend/Cargo.toml:81-84`)
|
||||
`ssw_platform` 现在编译期依赖 `packs/{asset,demo,shop,books}`(`src/backend/Cargo.toml`(生成段))
|
||||
+ `modules/mod.rs` 生成段。业务仓一依赖门面就会被拖进四个示例包 ⇒ 改为 **builder 注入**。
|
||||
默认 feature 下 `cargo tree -p sspf | grep sspf-pack` 必须**无输出**;这正是 AR9 想要的终局。
|
||||
|
||||
@@ -177,11 +181,11 @@ libc = { workspace = true }
|
||||
|
||||
| 文件 | 现状 | P0 改法 |
|
||||
|---|---|---|
|
||||
| `src/backend/Cargo.toml:76-85` | 生成段写死 4 个 `sspf-pack-*` 依赖 | 改为 `optional = true` + `[features] example-packs = [...]`;**同步改 `scripts/pack-sync.py`**,否则下次生成会覆盖回去 |
|
||||
| `src/backend/src/packs_gen.rs:22-62` | `registry()` 硬编码 4 次 `load_static` | 提供 `registry_from(Vec<PackSource>)`;`registry()` 在 `#[cfg(feature="example-packs")]` 下才装 4 包,否则返回空注册表 |
|
||||
| `src/backend/src/modules/mod.rs:33-112` | 生成段 `ALL_SPECS/ROUTES/MENUS/router()` | `all_menus()` / `router()` 改为「默认空 + 由 builder 注入」;`modules` 测试里断言 4 个基准模块的用例迁到示例包自身或加 `cfg`,**别让闸门变假** |
|
||||
| `src/backend/src/routes.rs:1252, 2522, 2542` | `.merge(modules::router())`、`pack_router_or_empty()` | 新增 `build_app_with(state, extras)` 承载注入;`build_app(state)` 保留为「extras 为空」的薄封装 ⇒ 704 个测试一行不用改 |
|
||||
| `src/backend/src/bootstrap.rs:86, 177` | `ensure_base(db, modules::all_menus())`、`ensure_schema_all(db)` | 参数化:`ensure_base(db, menus)`、`ensure_schema_all(db, reg, extra_ddls)`;保留旧签名薄封装 |
|
||||
| `src/backend/Cargo.toml` | 生成段写死 4 个 `sspf-pack-*` 依赖 | 改为 `optional = true` + `[features] example-packs = [...]`;**同步改 `scripts/pack-sync.py`**,否则下次生成会覆盖回去 |
|
||||
| `src/backend/src/packs_gen.rs` | `registry()` 硬编码 4 次 `load_static` | 提供 `registry_from(Vec<PackSource>)`;`registry()` 在 `#[cfg(feature="example-packs")]` 下才装 4 包,否则返回空注册表 |
|
||||
| `src/backend/src/modules/mod.rs` | 生成段 `ALL_SPECS/ROUTES/MENUS/router()` | `all_menus()` / `router()` 改为「默认空 + 由 builder 注入」;`modules` 测试里断言 4 个基准模块的用例迁到示例包自身或加 `cfg`,**别让闸门变假** |
|
||||
| `src/backend/src/routes.rs` | `.merge(modules::router())`、`pack_router_or_empty()` | 新增 `build_app_with(state, extras)` 承载注入;`build_app(state)` 保留为「extras 为空」的薄封装 ⇒ 704 个测试一行不用改 |
|
||||
| `src/backend/src/bootstrap.rs` | `ensure_base(db, modules::all_menus())`、`ensure_schema_all(db)` | 参数化:`ensure_base(db, menus)`、`ensure_schema_all(db, reg, extra_ddls)`;保留旧签名薄封装 |
|
||||
| `crates/sspf-admin/src/main.rs:1-46` | `run()` 含全部进程级动作 | 抽到 `sspf::runtime::serve`;本文件只留 CLI(实施后 381 行,启动动作见 `crates/sspf/src/platform.rs:251`) |
|
||||
| `crates/tests/tests/` | 37 个集成测试 | 新增 `external_consumer_it.rs`:只 `use sspf::Platform`,断言①示例包路由/表不存在②面 B 全套仍 200③一个 `Db` 一个端口 |
|
||||
| `scripts/check-arch.sh` | AR1–AR16 + MEM1/2 | 新增 **AR17**(内核默认 feature 下不得编译期依赖 `packs/*`)、**AR18**(门面 crate 不得出现 `tdc` / 业务表名 / 端点字面量);两条都要 `--self-test` 反自证注入 |
|
||||
@@ -355,9 +359,9 @@ lowcode-smoke 15/15、baseline-smoke 10/10、mcp-smoke 14/14;
|
||||
|
||||
| 事实 | 出处 |
|
||||
|---|---|
|
||||
| 内核编译期依赖 4 包 | `src/backend/Cargo.toml:76-85`、`src/backend/src/packs_gen.rs:22-62` |
|
||||
| 业务层清单生成段 | `src/backend/src/modules/mod.rs:33-112` |
|
||||
| 唯一装配链 / 业务 merge 点 | `src/backend/src/routes.rs:1252, 2522, 2542` |
|
||||
| 内核编译期依赖 4 包 | `src/backend/Cargo.toml`、`src/backend/src/packs_gen.rs` |
|
||||
| 业务层清单生成段 | `src/backend/src/modules/mod.rs` |
|
||||
| 唯一装配链 / 业务 merge 点 | `src/backend/src/routes.rs` |
|
||||
| 两段种子 / 建库 / 包单例 | `src/backend/src/bootstrap.rs:45, 86, 177` |
|
||||
| 进程级 7 步启动 | `crates/sspf/src/platform.rs:251`(`boot` 的 1–6 步)+ `crates/sspf/src/runtime.rs:30`(绑端口 / 停机 / 关库) |
|
||||
| `load_static` 签名 | `crates/sspf-plugin/src/lib.rs:492-517` |
|
||||
|
||||
+21
-65
@@ -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
|
||||
|
||||
@@ -76,8 +76,8 @@
|
||||
## H. 官方 JNPF 对齐(面 B)—— 2026-10-26
|
||||
|
||||
> 本节是**「把官方 JNPF 前端跑进本仓」**这条线的已知限制。三份配套文档:
|
||||
> 官方源码核对 [`JNPF_SOURCE_AUDIT.md`](../JNPF_SOURCE_AUDIT.md) · 面 B 规格
|
||||
> [`JNPF_COMPAT_SURFACE.md`](../JNPF_COMPAT_SURFACE.md) · 迁移指南 [`MIGRATION.md`](../MIGRATION.md)。
|
||||
> 官方源码核对 `JNPF_SOURCE_AUDIT.md`(技能仓 `ssw-jnpf-lite-rust`) · 面 B 规格
|
||||
> `JNPF_COMPAT_SURFACE.md`(技能仓 `ssw-jnpf-lite-rust`) · 迁移指南 `MIGRATION.md`(技能仓 `ssw-jnpf-lite-rust`)。
|
||||
|
||||
| # | 限制 | 出处 | 为什么接受 / 代价 |
|
||||
|---|---|---|---|
|
||||
|
||||
Reference in new issue
Block a user