diff --git a/.workbuddy/memory/2026-11-04.md b/.workbuddy/memory/2026-11-04.md index 6f080e7..db8cfdb 100644 --- a/.workbuddy/memory/2026-11-04.md +++ b/.workbuddy/memory/2026-11-04.md @@ -91,3 +91,61 @@ CannotCache(incremental): ["--crate-name", "probe", ..., "-C", "incremental=..." | 周度自动化是否存在 | `ls ~/Library/LaunchAgents/` + `crontab -l` | **不存在** | | 技能表述是否一致 | grep 技能里 `reclaim` | 技能写「xstudio 工作区还有…」,未说「唯一」⇒ 一致,无需改技能 | | 软链是否完好 | `readlink ~/.claude/CLAUDE.md` | ✅ 指向 MEMORY.md | + +--- + +## 11:20 结构三改(用户点名三条):onlinedev 正名 / 测试剥离 / 默认装配 sspf-admin + +**做了什么** + +1. `crates/sspf-compat-online_dev` → `crates/sspf-compat-onlinedev`。不只改包名: + 模块 `online_dev` → `onlinedev`、文件 `online_dev.rs` → `onlinedev.rs`、 + `compat::online_dev::` → `compat::onlinedev::`(routes.rs 48 处)。 + 理由:官方拼写是 `onlineDev`,同族 `sspf-compat-{system,ext}` 都是「去分隔符」。 +2. 37 个集成测试从 `src/backend/tests/` → `crates/tests/tests/`(package `sspf-tests`, + 全部 `[dev-dependencies]`)。测试是被测对象的**消费者**,不该登记成内核包的实现细节。 +3. `src/backend/src/main.rs` → `crates/sspf-admin/src/main.rs`,bin 名 `sspf-admin`; + 内核只剩 lib ⇒ `cargo run -p sspf-admin` 独立可跑(实测 health = 181 表)。 +4. 新增 **AR16** 闸门(内核不许 `[[bin]]` / `src/backend/tests/` 不许回流 / `sspf-admin` 必须有 bin) + + 反自证 11/11;顺手修了 AR15 自证的注入点(原来写死 `$KERNEL/tests`,目录搬走后静默失效—— + **但自证仍报绿**,因为另一处注入还在 ⇒ 这正是「单点注入会漏判」的实例)。 + +**坑 / 判据** + +- 产物名变了:`target/{debug,release}/sspf-admin`。脚本里 `target/*/ssw-platform` 共 13 个文件 + 引用,全部批量替换;`run.sh stop` 保留旧名 `ssw-platform` 的 pkill 兜底。 +- 测试搬包**不需要**改测试代码:它们只用 `ssw_platform` 的 pub API(`test_support` 是 + `#[cfg(test)]` 私有,实测没人用)⇒ 零改动。 +- 文档引文闸门会立刻红(`docs/verify-report-2026-11-02.md` 引了旧 crate 路径), + **改路径即可**(renamed-only,行号不变)。 +- 参考:`.workbuddy/memory` 里 2026-11-03 记的「集成测试 344 个留壳侧」是当时决策,**已作废**。 + +**回归**:`cargo test --workspace` 695 passed / 0 failed;`check-arch.sh` 21/21(自证 11/11); +其余五把闸门全绿;`verify.sh --fast` 50.3s 全绿。 + +--- + +## 12:45 示例搬成业务包(demo / shop / books)+ 修一个静默洞 + +**做了什么** + +1. 三个示例模块的 spec / 菜单 / DDL / 面 B 路由搬进 `packs/{demo,shop,books}` + (各 4 个文件,只依赖 `sspf-sdk`)。内核 `modules/*.rs` 缩成「面 A 适配器 + pub use 转发」 + ⇒ **内核里没有任何 spec**(PACK1 钉住),示例可整目录搬去技能。 +2. 面 B 新增 9 条:`/api/{demo,shop,books}/{实体}` + `/{id}`;面 A 一字未改,前端零改动。 +3. DDL 从 `db/schema.sql` 移走(180 → 177 张);按包 DDL 硬闸门补 + `f_tenant_id DEFAULT '0'` + 复合主键,**spec 列清单不加** ⇒ JSON 键零变化。 +4. `pack-sync.py` 两处判据修正:`module_key: None` 的包按「唯一菜单」落 urlAddress/menuId + (否则 CP6 假红);`apiFile` 改成查文件存在(否则 demo 假红)。 + +**踩到的真洞** + +`is_builtin_table` 原来 = `ddl_tables()`(只认 schema.sql),而批次 12 之后业务表 DDL +跟着包走 ⇒ **asset_data_resource 一直能被建模页删掉**(HANDOFF 里那句「业务包建的表会 +自动变成内置表」是错的)。示例表搬走后 `batch7_it` 两条当场抓到。 +修法:`sspf_store::db::is_protected_table` = 平台 DDL ∪ 包表,装配根在 +`ensure_pack_schema` 里 `register_pack_tables`(OnceLock 一次;**不给 AppState 加字段**, +它有 59 个构造点)。 + +**回归**:`cargo test --workspace` 704 passed / 0 failed(+9 条包内单测); +`verify.sh --fast` 全绿;health 181 张表不变;四个包面 A/面 B 运行时全 200。 diff --git a/CLAUDE.md b/CLAUDE.md index cb183e6..b4ee5bc 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -108,35 +108,37 @@ ssw-platform/ │ ├── sspf-compat-msg/ # 🔴 契约面(M4):message + msg_center │ ├── sspf-compat-workflow/ # 🔴 契约面(M4):workflow + report + visualdata │ ├── sspf-compat-ext/ # 🔴 契约面(M4):extend + teamwork + ai + mobile -│ ├── sspf-compat-online_dev/# 🔴 契约面(M4):online_dev(🔴 包名不能带连字符) +│ ├── sspf-compat-onlinedev/# 🔴 契约面(M4):onlinedev(官方模块名 onlineDev) │ ├── sspf-lowcode/ # (P2)元数据引擎 + Rhai 沙箱(**纯计算**,AR7) │ ├── sspf-lowcode-exec/ # 🔴 低代码**执行层**(M5):连库/跑 SQL/校验/回写模型 │ │ # `src/backend/src/lowcode_*.rs` 只是转发壳 │ ├── sspf-plugin/ # (P3)业务包加载器:静态 / dylib / wasm │ ├── sspf-mcp/ # (P1)MCP 2.0 元工具层 -│ └── sspf-mcp-adapter/ # (M6)MCP 适配层:NativeAdapter + 契约面 handler 直调 -│ # 壳侧 `src/backend/src/mcp_{adapter,compat}.rs` 只是转发壳 +│ ├── sspf-mcp-adapter/ # (M6)MCP 适配层:NativeAdapter + 契约面 handler 直调 +│ │ # 壳侧 `src/backend/src/mcp_{adapter,compat}.rs` 只是转发壳 +│ ├── sspf-admin/ # 🔴 **默认装配**:bin `sspf-admin`(进程级的事都在这) +│ │ # 定位项目根 / 读环境 / 开库 / 种子 / 自检 / 绑端口 / 优雅停机 +│ └── tests/ # 🔴 **集成测试宿主**(package `sspf-tests`):37 个 `*_it.rs` +│ # 测的是「装配好的平台」,不是内核的私有实现 ⇒ 不挂在内核包里 ├── packs/ # 【业务包】整目录可搬(jnpf ⇄ sspf 双向) │ └── asset/ # 样板:Cargo.toml + pack.toml + src/lib.rs │ # 只依赖 sspf-sdk(AR2)⇒ 可独立 cargo build ├── src/ -│ ├── backend/ # 内核 crate(package 名仍是 ssw-platform) +│ ├── backend/ # 内核 crate(package `ssw-platform`,**只有 lib 目标**) │ │ ├── Cargo.toml │ │ ├── src/ -│ │ │ ├── main.rs # 启动装配 │ │ │ ├── lib.rs # pub mod bootstrap / compat / modules / routes │ │ │ ├── compat.rs # 【面 B 契约面**别名表**】M7 起:16 个域聚成 `compat::<域>::` │ │ │ │ │ # 真源在 `crates/sspf-compat-*/src/`;这里只做 `pub use` 名字映射 │ │ │ │ │ # ⇒ 路由注册的 1,010 处 `compat::<域>::` **一个字都不用改** │ │ │ │ │ # 🔴 不许在这里写实现(AR9/AR10 会红) │ │ │ ├── test_support.rs # 测试用**进程级共享** pglite(依赖装配根 ⇒ 留壳层) -│ │ │ ├── modules/ # 【业务层】加业务模块只改这里 -│ │ │ │ ├── mod.rs # ALL_SPECS / ALL_MENUS / ALL_ROUTES / router() 汇总 -│ │ │ │ ├── demo.rs / shop.rs / books.rs # 模板模块(不进生产) -│ │ │ │ ├── asset.rs # 🔴 真实业务:DataResource(数据资源,本体对齐) -│ │ │ │ └── .rs # 尚数网业务模块(Phase 3 起) -│ │ │ ├── mcp_adapter.rs # 【MCP 适配层】M6 起真源在 `crates/sspf-mcp-adapter/src/` -│ │ │ ├── mcp_compat.rs # 这里两个 .rs 只是转发壳(`pub use sspf_mcp_adapter::::*;`) +│ │ │ ├── modules/ # 【业务层】**每个模块都是「面 A 适配器 + pub use 转发」** +│ │ │ │ ├── mod.rs # ALL_SPECS / ALL_MENUS / ALL_ROUTES / router() 汇总(生成段) +│ │ │ │ ├── asset.rs # 🔴 真实业务:DataResource(本体对齐)→ packs/asset +│ │ │ │ ├── demo.rs / shop.rs / books.rs # 示例包 → packs/{demo,shop,books} +│ │ │ │ └── .rs # 尚数网业务模块(`new-pack.sh` 生成) +│ │ │ ├── forward.rs # 6 个转发壳(低代码 4 + MCP 2)—— 只有 `pub use` │ │ │ ├── routes.rs # 路由装配(平台 27 条 + 面 B 14 条 + merge 业务路由) │ │ │ └── bootstrap.rs # 【装配根】唯一同时认识两层;把业务菜单注入种子 │ │ ├── db/schema.sql # 完整 DDL(base_* 8 + 业务 N) @@ -156,7 +158,7 @@ ssw-platform/ **手改会被覆盖**,而 `verify.sh` 第一步 `pack-sync.py --check` 会把「忘了同步」判红 —— 因为漏同步的后果是**静默 404 / 越权放行**,不是编译错误。 - **两档验证,分工别混**:`verify.sh --fast`(纯静态)证明「**该接的地方接上了**」; - `verify.sh --lib`(+ 单测 + 包冒烟 `tests/pack_smoke_it.rs`)证明「**接上的活真能应答**」。 + `verify.sh --lib`(+ 单测 + 包冒烟 `crates/tests/tests/pack_smoke_it.rs`)证明「**接上的活真能应答**」。 后者遍历全部包真打 `List`(面 A + 面 B)—— 表没建出来 / 路由没 merge / 守卫指错菜单 这三种**静态闸门全绿**、页面空着,只有它会红。**加包后两档都要跑。** - **双面契约同一进程**:面 A(ssw 形状,冻结)+ 面 B(官方 JNPF 形状)。判别头 = `Vue-Version: 3`(官方前端必带、本仓前端唯一不发)。 @@ -243,10 +245,10 @@ ssw-platform/ 每把尺子结尾比对「实际断言数 vs 契约登记数」,对不上即失败 —— 尺子不会被悄悄改弱。 **加任何业务模块 / 改任何契约 / 加任何 crate 依赖 / 改任何内部标识 / 加任何表,十二道闸门必须全绿才算完成。** -🔴 **`cargo test --workspace` 当前 654 条**(内核 + contract 13 + store 17 + sdk 2 + pack-asset 5 + mcp 52 + adapter-baseline 19 + lowcode 112 + 集成测试)—— +🔴 **`cargo test --workspace` 当前 695 条**(内核单测 + 各 crate 单测 + `crates/tests` 的 37 个集成测试二进制)—— 拆 crate 后总数会变,**不许把断言数写死**,跑一遍看实际值。 -cipher 自证(免 node):`./target/release/ssw-platform --enc 123456`。 +cipher 自证(免 node):`./target/release/sspf-admin --enc 123456`。 --- @@ -314,8 +316,8 @@ bash scripts/baseline-smoke.sh # 双后端契约 10 条(HTTP 适配器 cargo build -p sspf-adapter-baseline --example probe # baseline-smoke 依赖的探针 bash scripts/mem-budget.sh # 空载内存实测(P0 出口判据,预算 40 MB) cargo test -p sspf-pack-asset # 业务包独立可编(业务包剥离的硬证据) -./target/release/ssw-platform --mcp # 起 MCP stdio 服务(供 AI 直接驱动,见 docs/mcp.md) -./target/release/ssw-platform --enc 123456 # cipher 自证 +./target/release/sspf-admin --mcp # 起 MCP stdio 服务(供 AI 直接驱动,见 docs/mcp.md) +./target/release/sspf-admin --enc 123456 # cipher 自证 ``` > 本机 curl 走系统代理,测 localhost 必须加 `--noproxy '*'`。 diff --git a/Cargo.lock b/Cargo.lock index 0f7c677..d970ef4 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1083,6 +1083,19 @@ dependencies = [ "tokio", ] +[[package]] +name = "sspf-admin" +version = "0.1.0" +dependencies = [ + "axum", + "libc", + "pglite-rs", + "sspf-core", + "sspf-mcp", + "ssw-platform", + "tokio", +] + [[package]] name = "sspf-compat-core" version = "0.1.0" @@ -1123,7 +1136,7 @@ dependencies = [ ] [[package]] -name = "sspf-compat-online_dev" +name = "sspf-compat-onlinedev" version = "0.1.0" dependencies = [ "axum", @@ -1249,7 +1262,7 @@ dependencies = [ "pglite-rs", "serde_json", "serde_urlencoded", - "sspf-compat-online_dev", + "sspf-compat-onlinedev", "sspf-compat-permission", "sspf-compat-system", "sspf-compat-workflow", @@ -1266,6 +1279,27 @@ dependencies = [ "sspf-sdk", ] +[[package]] +name = "sspf-pack-books" +version = "0.1.0" +dependencies = [ + "sspf-sdk", +] + +[[package]] +name = "sspf-pack-demo" +version = "0.1.0" +dependencies = [ + "sspf-sdk", +] + +[[package]] +name = "sspf-pack-shop" +version = "0.1.0" +dependencies = [ + "sspf-sdk", +] + [[package]] name = "sspf-plugin" version = "0.1.0" @@ -1295,6 +1329,20 @@ dependencies = [ "tokio", ] +[[package]] +name = "sspf-tests" +version = "0.1.0" +dependencies = [ + "axum", + "serde_json", + "serde_urlencoded", + "sspf-core", + "sspf-lowcode", + "sspf-mcp", + "ssw-platform", + "tokio", +] + [[package]] name = "ssw-platform" version = "0.1.0" @@ -1304,7 +1352,6 @@ dependencies = [ "chrono", "ecb", "hex", - "libc", "md-5 0.10.6", "pglite-rs", "rand 0.8.8", @@ -1314,7 +1361,7 @@ dependencies = [ "sspf-compat-core", "sspf-compat-ext", "sspf-compat-msg", - "sspf-compat-online_dev", + "sspf-compat-onlinedev", "sspf-compat-permission", "sspf-compat-system", "sspf-compat-workflow", @@ -1325,6 +1372,9 @@ dependencies = [ "sspf-mcp", "sspf-mcp-adapter", "sspf-pack-asset", + "sspf-pack-books", + "sspf-pack-demo", + "sspf-pack-shop", "sspf-plugin", "sspf-store", "tokio", diff --git a/Cargo.toml b/Cargo.toml index f62fe96..5f7df0f 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -50,7 +50,7 @@ pglite-rs = "0.2" chrono = "0.4" http = "1" async-trait = "0.1" -# 只用于「MCP 模式下把 fd 1 让给 stderr」这一个系统调用(见 main.rs 的注释)。 +# 只用于「MCP 模式下把 fd 1 让给 stderr」这一个系统调用(见 crates/sspf-admin/src/main.rs 的注释)。 libc = "0.2" [profile.dev] diff --git a/HANDOFF.md b/HANDOFF.md index acb466b..ed6cb2e 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -9,6 +9,28 @@ --- +## 0-0-pre-pre. 2026-11-04 11:20 结构三改:onlinedev 正名 / 测试剥离 / 默认装配 `sspf-admin` + +- `crates/sspf-compat-online_dev` → **`crates/sspf-compat-onlinedev`**(包名 / 模块 / 文件名 / `compat::onlinedev::` 全同步)。理由:与官方 `onlineDev` 拼写一致,也与同族 `sspf-compat-{system,ext}` 的「去分隔符」惯例一致。 +- **37 个集成测试**从 `src/backend/tests/*.rs` → **`crates/tests/tests/`**(package `sspf-tests`,全部走 `[dev-dependencies]`)。它们测的是「装配好的平台」,不该登记成内核包的实现细节。跑法:`cargo test -p sspf-tests`。 +- **`src/backend/src/main.rs` → `crates/sspf-admin/src/main.rs`**,bin 名 **`sspf-admin`**;`src/backend` 只剩 lib ⇒ `cargo run -p sspf-admin` 自己就能跑。🔴 **产物路径变了**:`target/{debug,release}/sspf-admin`(`run.sh` / 4 个冒烟脚本 / 文档已同步;`run.sh stop` 仍兜底收旧名 `ssw-platform`)。 +- 新增 **AR16** 钉住三条边界:内核不许 `[[bin]]`、`src/backend/tests/` 不许回流 `.rs`、`crates/sspf-admin` 必须产出 bin(含反自证 11/11)。 +- 回归:`cargo test --workspace` **695 passed / 0 failed**;`check-arch.sh` **21/21**;其余五把闸门全绿;`/api/health` = `{"ok":true,"tables":181}`。 +- 已知残留(**故意没动**):技能目录 `~/.agents/skills/ssw-jnpf-lite-rust` 仍是旧形状(内核带 bin、tests 挂内核包)——本仓已与它**分叉**,技能要跟就得单独同步,改本仓不会改到技能。 + +--- + +## 0-0-pre-pre-pre. 2026-11-04 12:4x 示例搬成业务包(demo / shop / books)+ 修好一个静默洞 + +- 三个示例模块的 **spec / 菜单 / DDL / 面 B 路由**全部搬进 `packs/{demo,shop,books}`(各 4 个文件,只依赖 `sspf-sdk`);内核 `src/backend/src/modules/*.rs` 缩成「面 A 适配器 + `pub use` 转发」⇒ **内核里再没有任何 spec**,示例可整目录搬去技能。 +- **面 B 新增 9 条端点**:`/api/{demo,shop,books}/{DemoItem,Product,Book}` + `/{id}`。面 A(`/api/ssw/...`)**一字未改**,前端零改动。 +- DDL 从 `db/schema.sql` 移走(177 张表,比之前少 3 张),并**按平台规则**补 `f_tenant_id DEFAULT '0'` + 复合主键 —— 这是包 DDL 的硬闸门。spec 列清单**没加** tenant ⇒ JSON 键与响应零变化;react 侧多一列有默认值的列,仍可同库。 +- 🔴 **顺带修掉一个静默洞**:`is_builtin_table` 原来只认 `schema.sql`,而批次 12 之后业务表 DDL 跟着包走 ⇒ **`asset_data_resource` 一直能被建模页删掉**。现在 `sspf_store::db::is_protected_table` = 平台 DDL ∪ 包表(装配根在 `ensure_pack_schema` 里登记,`OnceLock` 只写一次)。两个集成测试(`batch7_it`)当场抓到,不是测试写错。 +- `pack-sync.py` 补两个判据:`module_key: None` 的包要按「唯一菜单」落 `urlAddress/menuId`(否则 CP6 假红);`apiFile` 改成**查文件是否存在**(否则 demo 假红)。 +- 回归:`cargo test --workspace` **704 passed / 0 failed**(+9 条包内单测);`verify.sh --fast` 全绿;运行时 `/api/health` = 181 张表,四个包的面 A / 面 B 全部 200。 + +--- + ## 0-0-pre. 2026-11-03 12:15 打 tag `v0.1.0` + 制定「平台能力全迁 crates/」计划 **做了什么**:① 在 `b957a11` 上打**迁移前基线 tag** `v0.1.0`(已推 `origin`); @@ -176,11 +198,11 @@ M2 的「转发壳 + 闸门扫真源 + 反自证两处注入」套路**直接复 | `sspf-compat-msg` | message + msg_center | 6,053 | chrono | | `sspf-compat-workflow` | workflow + report + visualdata | 8,729 | chrono + aes/ecb/hex | | `sspf-compat-ext` | extend + teamwork + ai + mobile | 8,142 | **system + msg**(2 函数)+ chrono | -| `sspf-compat-online_dev` | online_dev | 3,175 | — | +| `sspf-compat-onlinedev` | onlinedev | 3,175 | — | **实际做法与原计划的差异**(实测依赖图,非拍脑袋): - ① 计划的分组按「官方模块名」切,实测后把**无跨包依赖**的 `scheduletask`/`core` 并进 system ⇒ 少两条 crate 边; -- ② 🔴 **`sspf-compat-online-dev` 改名 `sspf-compat-online_dev`** —— Rust 包名不能带连字符(`use sspf-compat-online-dev::…` 编译不过); +- ② 🔴 **`sspf-compat-online-dev` → `sspf-compat-onlinedev`** —— Rust 包名不能带连字符(`use sspf-compat-online-dev::…` 编译不过);官方拼写 `onlineDev` 去分隔符即 `onlinedev`(2026-11-04 由中间态 `online_dev` 统一回来); - ③ 跨包依赖只有 **3 条**,全是单向 ⇒ 不成环:`permission→system`、`ext→system`、`ext→msg`。 **闸门改造**: @@ -272,13 +294,13 @@ M2/M3 搬迁后闸门都报红(正常),M4 首次跑就 10/10 ⇒ 反而是 |---|---| | `sspf-mcp` | `PlatformAdapter` / `ToolError` / `EnvInfo` —— 工具契约层 | | `sspf-core` | `AppState` / `Db` / `ids::new_uuid` / `cipher::md5_hex` / `envelope::ActionResult` | -| `sspf-compat-{system,permission,workflow,online_dev}` | `mcp_compat.rs` **直调它们的 handler**(与 HTTP 路由同一个函数 ⇒ 语义零漂移) | +| `sspf-compat-{system,permission,workflow,onlinedev}` | `mcp_compat.rs` **直调它们的 handler**(与 HTTP 路由同一个函数 ⇒ 语义零漂移) | | `sspf-lowcode` + `sspf-lowcode-exec` | 动态 CRUD 工具:解析设计稿(纯计算)+ 连库执行 | | `axum` | handler 的 extractor(`State` / `Path` / `RawQuery` / `HeaderMap`)与 `Json` | | `pglite-rs` | `ToSql` 参数绑定(把 JSON 值转成 SQL 参数) | **与原计划的差异**:原计划写「依赖 sspf-mcp + sspf-core + sspf-compat-*」, -实际只依赖**四个** compat 域包(`system` / `permission` / `workflow` / `online_dev`)—— +实际只依赖**四个** compat 域包(`system` / `permission` / `workflow` / `onlinedev`)—— `mcp_compat.rs` 真正调到的就这四个域,`msg` / `ext` / `compat-core` **不必依赖**(少三个边 ⇒ 依赖图更瘦)。 另外**未提权任何 `pub(crate)`**(两个文件的对外接口本来就是 `pub`)。 @@ -443,7 +465,7 @@ M7 把平台核心也变成两段(`sspf_core::sys::user_list`)⇒ 旧规则 三族里约 150 条是薄封装;有业务语义的动作(版本、复制、分享、回收站、切片/召回、日程)手写。 🔴 **新增表的登记**:`ext_*` 18 张既不是 `base_*` 平台表、也不是业务包表 ⇒ -在 `sspf_store::db::{EXTEND_TABLES, TEAMWORK_TABLES}` 登记,并在 `main.rs` 的 +在 `sspf_store::db::{EXTEND_TABLES, TEAMWORK_TABLES}` 登记,并在 `crates/sspf-admin/src/main.rs` 的 **孤儿 DDL 闸门**里放行(与 `REPORT_TABLES` / `WORKFLOW_TABLES` 同一套机制)。 🔴 **诚实失败**(见 `docs/known-limitations.md` §I):LLM 推理、供应商连通性、MCP 同步、 @@ -1329,7 +1351,7 @@ React 模板的加模块成本 = **改/加 8 个文件、15~20 分钟**(`HOWTO 写新表时要一起检查。) 2. **`sspf-store` 的表数断言停在 37** ⇒ `cargo test --workspace` 直接红 2 条 (`schema_sql_has_expected_table_count` / `ddl_tables_parses_every_create_table`)。 - 🔴 **加表必须同时改三处**:`schema.sql`、`main.rs` 的 `BASE_TABLES`、 + 🔴 **加表必须同时改三处**:`schema.sql`、`crates/sspf-admin/src/main.rs` 的 `BASE_TABLES`、 **`crates/sspf-store/src/db.rs` 的两处断言**(后者容易漏 —— 它在另一个 crate 里)。 ### 批次 10(2026-11-01)—— 权限配置族(电子签章 / 按钮 / 列表 / 表单 / 高级查询) @@ -1398,7 +1420,7 @@ React 模板的加模块成本 = **改/加 8 个文件、15~20 分钟**(`HOWTO and the Postgres type int8` ⇒ 写成 `LIMIT ${}::text::integer OFFSET ${}::text::integer`。 3. 🔴 **`base_module_form.f_sort_code` 是 `BIGINT`** —— 抄 DDL 时手误写成 `BIGIG` 会被 PG 直接拒。 4. 🔴 **加表仍然是三处**(批次 9 已经踩过一次,这里再确认): - `schema.sql` + `main.rs` 的 `BASE_TABLES` + `crates/sspf-store/src/db.rs` 的两处断言。 + `schema.sql` + `crates/sspf-admin/src/main.rs` 的 `BASE_TABLES` + `crates/sspf-store/src/db.rs` 的两处断言。 本批 43 → **49**,另加 `src/backend/tests/batch6_it.rs` 与 `routes.rs` health 测试里的表数断言。 ### 批次 11(2026-11-01)—— 数据权限三件套(字段 / 方案 / 数据连接) @@ -1807,14 +1829,14 @@ cd ~/Desktop/workspace/ssw-platform RUSTC_WRAPPER=sccache cargo build --manifest-path src/backend/Cargo.toml # 改代码后 # 🔴 **尺子跑的是 release 产物** ⇒ 跑尺子前必须 `cargo build --release` RUSTC_WRAPPER=sccache cargo build --release --manifest-path src/backend/Cargo.toml -nohup env PORT=30000 ./target/debug/ssw-platform > /tmp/ssw-backend.log 2>&1 & # 后台起 +nohup env PORT=30000 ./target/debug/sspf-admin > /tmp/ssw-backend.log 2>&1 & # 后台起 curl -s http://127.0.0.1:30000/api/health # 期望 {"ok":true,"tables":43,...} ``` 拿 token(面 B): ```bash -ENC=$(./target/debug/ssw-platform --enc 123456) +ENC=$(./target/debug/sspf-admin --enc 123456) curl -s -X POST http://127.0.0.1:30000/api/oauth/Login \ -H 'Content-Type: application/x-www-form-urlencoded' \ -H 'Vue-Version: 3' -H 'App-Code: mainSystem' \ @@ -1849,7 +1871,7 @@ cd ~/Desktop/workspace/jnpf/7.0/frontend/web/jnpf-web-monorepo-framework env -u NODE_OPTIONS nohup pnpm dev:main > /tmp/vite-main.log 2>&1 & # 后端 cd ~/Desktop/workspace/ssw-platform -nohup env PORT=30000 ./target/debug/ssw-platform > /tmp/ssw-backend.log 2>&1 & +nohup env PORT=30000 ./target/debug/sspf-admin > /tmp/ssw-backend.log 2>&1 & ``` 两个都起好后,浏览器会话 `aix --session ssw` 可以直接复用(登录态在 localStorage)。 @@ -1978,7 +2000,7 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c ' 12. 🔴🔴 **【批次 12 = 下一轮优先做】框架固定包 + 业务模块链接就好** —— 不是补端点,是**改「加业务的成本结构」**:加一个业务模块从现在的 **改 6~8 处**(两份 spec 拷贝 + 手抄 DDL + 手抄契约表 + 改 `schema.sql` + - 改 `main.rs` BASE_TABLES + 改 `sspf-store/db.rs` 两处表数断言) + 改 `crates/sspf-admin/src/main.rs` BASE_TABLES + 改 `sspf-store/db.rs` 两处表数断言) 降到 **写 1 个包文件 + 改 2 处**。 🔴 **四件事**:① `sspf-sdk` 补 `routes()` + 新建 `crates/sspf-plugin`(L2 静态装载器) ② 打通两份拷贝(`modules/asset.rs` 改 re-export)+ **补 PACK1 闸门** @@ -2050,7 +2072,7 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c ' | 契约扫描器**只扫 `modules/*.rs`** | `check-contract-scan.py:369` 只遍历 `src/backend/src/modules/`(除 `mod.rs`) | 业务包若搬到 `packs/`,路由**不在扫描范围** ⇒ CC2/CC3 判「契约多 / 代码少」⇒ **假漂移** | | 静态闸门**最慢 66.6s** | 实测 `check-contract.sh` 66.6s(静态解析 659 个路由);`check-module` 25.8s | 每次改代码都等 ⇒ 「快速验证」体感差 | | 运行时尺子**都很快** | `perm-smoke` 6.0s / `perm-smoke-jnpf` 4.8s / `lowcode` 1.9s / `baseline` 3.3s / `mcp` 2.9s | **「快验证」的成本在静态闸门,不在运行时** | -| 业务 DDL 要**手抄进 schema.sql** | `schema.sql:879/888/897/920` 四张业务表 | 加一张表要改 schema.sql + `main.rs` BASE_TABLES + `sspf-store/db.rs` **两处**断言(批次 9/10 各踩一次) | +| 业务 DDL 要**手抄进 schema.sql** | `schema.sql:879/888/897/920` 四张业务表 | 加一张表要改 schema.sql + `crates/sspf-admin/src/main.rs` BASE_TABLES + `sspf-store/db.rs` **两处**断言(批次 9/10 各踩一次) | | 业务表数**写死 52** | `crates/sspf-store/src/db.rs:1226,1233` | 加表必红 ⇒ 又一处「记得改」 | #### 本批交付物(4 件事,按依赖顺序做) @@ -2281,7 +2303,7 @@ bash scripts/verify.sh --lib # + 单测 + **包冒烟**(真起库 🔴 **前端接入的两个坑(已修,别再踩)**: 1. **端口**:React 技能模板的 vite proxy 指 NestJS `:30000`,本仓 Rust 后端是 **`:30010`** - (`main.rs` 的 `PORT` 缺省值)⇒ 照抄会在浏览器里表现成 `Network Error`, + (`crates/sspf-admin/src/main.rs` 的 `PORT` 缺省值)⇒ 照抄会在浏览器里表现成 `Network Error`, 最容易误判成「跨域 / 认证」,其实只是端口抄错。 2. **api 文件名**:`check-module.sh` 用 `lower(Entity)` 推文件名 ⇒ `DataResource` 要的是 `api/dataresource.ts`(**全小写**,不是 `dataResource.ts`)。`new-page.sh` 已按此生成。 @@ -2441,7 +2463,7 @@ cd ~/Desktop/workspace/ssw-platform # 1) 实现 → 编译 RUSTC_WRAPPER=sccache cargo build --manifest-path src/backend/Cargo.toml # 2) 重启后端(老进程先 kill) -PORT=30000 ./target/debug/ssw-platform & +PORT=30000 ./target/debug/sspf-admin & # 3) 运行时验证(比静态比对权威) python3 scripts/probe-page.py docs/fe/page-user.tsv # 4) 单测 + 六闸 @@ -2450,7 +2472,7 @@ RUSTC_WRAPPER=sccache cargo test --manifest-path src/backend/Cargo.toml RUSTC_WRAPPER=sccache cargo build --release --manifest-path src/backend/Cargo.toml for s in check-module check-boundary check-contract check-citations; do bash scripts/$s.sh; done bash scripts/perm-smoke.sh -ENC_BIN="$PWD/target/debug/ssw-platform" bash scripts/perm-smoke-jnpf.sh +ENC_BIN="$PWD/target/debug/sspf-admin" bash scripts/perm-smoke-jnpf.sh ``` 新增/变更端点必须同步三处,否则闸门必红: @@ -2500,7 +2522,7 @@ ENC_BIN="$PWD/target/debug/ssw-platform" bash scripts/perm-smoke-jnpf.sh - 🔴 **Bash 里写多层嵌套引号的 curl + python 验证脚本很容易引号不闭合**(`bash -n` 报 `unexpected EOF` 但**定位不到行**)⇒ **直接用 Python 写验证器**(`urllib` + `ProxyHandler({})` 绕过本机代理),别跟 bash 引号较劲。 -- 🔴 **尺子用的是 `target/release/ssw-platform`**,不是 debug 产物 ⇒ 改完代码跑尺子前 +- 🔴 **尺子用的是 `target/release/sspf-admin`**,不是 debug 产物 ⇒ 改完代码跑尺子前 **必须 `cargo build --release`**,否则尺子跑的是旧二进制(表现为「刚修好的端点还是 405」)。 ### 批次 11 新增的坑 diff --git a/HOWTO_MODULE.md b/HOWTO_MODULE.md index cf4a206..658ebf1 100644 --- a/HOWTO_MODULE.md +++ b/HOWTO_MODULE.md @@ -13,7 +13,7 @@ > > 🔴 **两道都要过**:`--fast` 只证明「该接的地方都接上了」,**证明不了「接的活能应答」** > —— 表没建出来 / 面 B 路由没 merge / `module_key` 指向不存在的菜单,这三种 -> **静态闸门全绿**,只有 `--lib` 里的包冒烟(`tests/pack_smoke_it.rs`)会红。 +> **静态闸门全绿**,只有 `--lib` 里的包冒烟(`crates/tests/tests/pack_smoke_it.rs`)会红。 > > 它建 `packs//`(**真源**)+ `modules/.rs`(面 A 适配器), > 再把**四处生成位置**补齐(`packs_gen.rs` / `modules/mod.rs` 五段 / @@ -55,7 +55,7 @@ | 8(Cargo 依赖) | 编译失败 | ✅ 报 | 编译 | | 9(契约) | `check-contract` 红 | ✅ 报 | `verify.sh --fast` | -🔴 **平台层(`src/platform/`)与入口文件(`src/backend/src/main.rs`)一个字都不用改** —— +🔴 **平台层(`src/platform/`)与入口文件(`crates/sspf-admin/src/main.rs`)一个字都不用改** —— 加业务模块**不碰平台层**,由尺子 `bash scripts/check-boundary.sh`(CP1–CP6)钉住: 平台层出现任何业务标识符(表名 / 实体名 / 路由前缀 / 菜单 id / url / en_code)⇒ 红。 @@ -92,9 +92,9 @@ **外加两条一致性**: 1. `spec.module_key` == `menu.url_address` == `App.tsx` 的 Route path —— **三处一字不差**。 不一致的后果是**静默放行**(未映射到菜单就放行,不报错)。 -2. 🔴 **入口文件也不碰**:`main.rs` 的 `BASE_TABLES` 只列 8 张 `base_*`(8 张全部逐字对齐官方 DDL,含多应用注册表 `base_system`), +2. 🔴 **入口文件也不碰**:`crates/sspf-admin/src/main.rs` 的 `BASE_TABLES` 只列 8 张 `base_*`(8 张全部逐字对齐官方 DDL,含多应用注册表 `base_system`), 业务表由 `modules::all_specs()` 派生并与 `db/schema.sql` 双向对账 - ⇒ 加业务表**不用**改 `main.rs`。 + ⇒ 加业务表**不用**改 `crates/sspf-admin/src/main.rs`。 🔴 **分层铁律**:后端代码分两层—— @@ -264,7 +264,7 @@ pub fn router() -> Router { ``` 🔴 **`ALL_SPECS` 漏了** ⇒ 启动时的标识符白名单自检会失败(`spec 表 … 在 db/schema.sql 里没有 CREATE TABLE`)—— - 记得同时把新表加进 `src/backend/db/schema.sql`(**`main.rs` 不用改** ⇒ 业务表由 spec 派生)。 + 记得同时把新表加进 `src/backend/db/schema.sql`(**`crates/sspf-admin/src/main.rs` 不用改** ⇒ 业务表由 spec 派生)。 🔴 **`ALL_MENUS` 漏了** ⇒ 菜单**不会被种**、admin **少一条授权** ⇒ 侧栏少一项。 🔴 **`router()` 漏了 merge** ⇒ 端点 404。 🔴 **`ALL_ROUTES` 漏了** ⇒ 路由表钉子测试**不会报错**(它只遍历这张表)⇒ 静默失去覆盖 ⇒ 一定要加。 @@ -441,7 +441,7 @@ bash scripts/perm-smoke-jnpf.sh # 契约尺子·面 B:19 条(面 A 不受 |---|---|---| | 端点 404 | 忘了在 `modules/.rs` 里写 `router()` / 忘了在 `modules/mod.rs` 里 merge | 补 `router()` + 补 merge 行 | | 端点 500 | 表不存在 / spec 没进 `ALL_SPECS` | 补 `schema.sql` + 补 `ALL_SPECS` | -| 启动即退(白名单自检失败) | 新表没进 `db/schema.sql`(或 spec 拼错表名) | 补 DDL / 改 spec 表名(`main.rs` **不用改**) | +| 启动即退(白名单自检失败) | 新表没进 `db/schema.sql`(或 spec 拼错表名) | 补 DDL / 改 spec 表名(`crates/sspf-admin/src/main.rs` **不用改**) | | 页面 404 | `App.tsx` 的 Route path ≠ 菜单 `url_address` | 三处对齐 | | 侧栏没有这个菜单 | `modules/.rs` 没声明 `*_MENU` / 没进 `ALL_MENUS` / 没重启回灌 | 补声明 + 补 `ALL_MENUS` + **重启进程**(不必删库) | | `check-boundary.sh` 报业务标识符泄漏 | 业务知识写进了平台层(表名 / 菜单 key / 路由前缀) | 挪回业务层;平台层只留**类型**(`EntitySpec` / `MenuSpec`) | diff --git a/MIGRATION.md b/MIGRATION.md index d690803..c0fd28e 100644 --- a/MIGRATION.md +++ b/MIGRATION.md @@ -49,7 +49,7 @@ | 本仓(Rust / axum 0.8) | 官方 JNPF Java | 说明 | |---|---|---| -| `main.rs`(装配 + `--enc`) | `ssw-admin`(`@SpringBootApplication`) | 启动入口 | +| `crates/sspf-admin/src/main.rs`(装配 + `--enc`) | `ssw-admin`(`@SpringBootApplication`) | 启动入口 | | `routes.rs`(`Router` 32 条路径 = 面 A 27 + 面 B 5) | `ssw-{appCode}` 的 `@RestController` | **路径按官方风格改**(见 §2.3) | | `modules/.rs` 里的 `EntitySpec` / `ColumnSpec` | Java 实体 `extends SuperBaseEntity` + `@TableField("f_title")` | **一个 spec ≈ 一个实体类**:列清单逐字对应 | | `crud.rs`(spec 驱动的 CRUD 引擎) | `XxxService extends SuperServiceImpl` + `XxxMapper extends SuperMapper` | 官方是 **MyBatis-Plus Join**,不是 JPA | @@ -194,7 +194,7 @@ **(a) 给本仓加一个 `--dump` 子命令(推荐)** -在 `main.rs` 的 `parse_args`(现只有 `--enc`)旁加一个 `Cmd::Dump`, +在 `crates/sspf-admin/src/main.rs` 的 `parse_args`(现只有 `--enc`)旁加一个 `Cmd::Dump`, 用 `db.rs` 里现成的执行入口跑: ```sql diff --git a/README.md b/README.md index 4cac13b..4172bf0 100644 --- a/README.md +++ b/README.md @@ -6,9 +6,13 @@ 来自 `ssw-jnpf-lite-react`(NestJS + React)的 **Rust 全栈 counterpart**——两者是**并列可选**的独立技能, 不是依赖关系:要 MVP 期就用 Node 栈选 `ssw-jnpf-lite-react`,要 MVP 期用 Rust 栈选本技能。 -> 📌 **本仓 = 技能本体**(不是「技能的项目副本」):仓根就是技能目录(`SKILL.md` 在仓根), -> 三处软链 `~/.agents/skills/` · `~/.claude/skills/` · `~/.workbuddy/skills/` 均指向本仓, -> 所以**改一次仓 = 改一次技能**。 +> 📌 **本仓 = 项目(ssw-platform),不是技能本体**(2026-11-04 澄清)。 +> 脚手架来自技能 `ssw-jnpf-lite-rust`(`~/.agents/skills/ssw-jnpf-lite-rust`), +> 但本仓已按项目需要演进,**与技能形状不再一致**,改本仓**不会**改到技能: +> - 内核 `src/backend`(lib `ssw_platform`)**只有 lib 目标**,不再自带二进制; +> - **默认装配 = `crates/sspf-admin`**(bin `sspf-admin`)—— 进程级的事都在这儿,**自己就能跑**; +> - **集成测试宿主 = `crates/tests`**(package `sspf-tests`)—— 测的是装配好的平台,不再挂在内核包里。 +> 三条边界由 `scripts/check-arch.sh` 的 **AR16** 钉住(踩线即红,不会被悄悄改回去)。 ## 设计原则:MVP = JNPF 的 Rust 版垫片 @@ -52,8 +56,10 @@ ## 目录 ``` -ssw-jnpf-lite-rust/ ← 仓根 = 技能根(三处软链指向这里) -├── SKILL.md # 入口:是什么 / 何时用 / 契约红线 / 六道闸门 +ssw-platform/ ← 仓根 = 项目根(技能在 ~/.agents/skills/ssw-jnpf-lite-rust) +├── crates/sspf-admin/ # 🔴 默认装配(bin `sspf-admin`):cargo run -p sspf-admin +├── crates/tests/ # 🔴 集成测试宿主(package `sspf-tests`):cargo test -p sspf-tests +├── src/backend/ # 内核 lib(`ssw_platform`)+ 业务层 modules/ + 平台 DDL ├── README.md # 本文件:选型 / 运行 / 验收门 / 已知限制 ├── HOWTO_MODULE.md # 加一个业务模块的操作手册(8 个文件 / 10 个接触点) ├── PERMISSION.md # 权限模版:表结构 / 四源合并 / 码表 @@ -104,6 +110,10 @@ ssw-jnpf-lite-rust/ ← 仓根 = 技能根(三处软链指向这里 ## 快速开始 ```bash +# 最短路径:只跑后端(默认装配 sspf-admin,零外部服务) +cargo run -p sspf-admin # http://127.0.0.1:30010,账号 admin / 123456 +# 等价于 ./target/debug/sspf-admin;PGLITE_DIR=memory:// 用临时库(进程退出即销毁) + # 一次性:装依赖(cargo fetch + npm install) bash run.sh install # 构建(cargo build --release + vite build) @@ -129,7 +139,7 @@ bash run.sh logs # 看日志尾部 ## 把脚手架复制到新项目 ```bash -SKILL=~/.agents/skills/ssw-jnpf-lite-rust # 软链 ⇒ 实际指向本仓 +SKILL=~/.agents/skills/ssw-jnpf-lite-rust # 技能目录(独立于本仓) PROJ=~/Desktop/my-app mkdir -p "$PROJ/src" # 脚手架固定进 src/:没有则创建,已有则并入 rsync -a --exclude node_modules --exclude dist --exclude target --exclude data --exclude .DS_Store \ @@ -147,7 +157,7 @@ cd "$PROJ" && cp .env.example .env && ./run.sh install && ./run.sh dev | 门 | 命令 | 通过标准 | |---|---|---| | ① 编译 | `cargo build --release` | 0 error **0 warning** | -| ② 单测 | `cargo test` | 全绿(当前 **220 passed / 0 failed**) | +| ② 单测 | `cargo test --workspace` | 全绿(当前 **695 passed / 0 failed**:内核单测 + `crates/tests` 的 37 个集成测试二进制) | | ③ 冒烟(面 A) | `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 三页可用 → 退出再登录 | @@ -209,7 +219,7 @@ cd "$PROJ" && cp .env.example .env && ./run.sh install && ./run.sh dev | 端口 | **30000** | **30010** | | 契约 | 同一套(面 A) | 同一套(面 A) | | 前端 | 同一份 React 产物 | 同一份 React 产物 | -| 业务表名 | `demo_item` / `shop_product` / `book_shop_book` | **同名** ⇒ 两版后端能开同一个库 | +| 业务表名 | `demo_item` / `shop_product` / `book_shop_book` | **同名** ⇒ 两版后端能开同一个库(2026-11-04 起多一列 `f_tenant_id DEFAULT '0'`,react 侧可忽略) | | 尺子 | `perm-smoke.sh`(22 条基线) | `perm-smoke.sh`(32 条)+ `perm-smoke-jnpf.sh`(18 条) | 🔴 **两版之间不共享代码、不共享端口、不共享数据目录**。 diff --git a/crates/sspf-adapter-baseline/examples/probe.rs b/crates/sspf-adapter-baseline/examples/probe.rs index 72933ab..aa26cf7 100644 --- a/crates/sspf-adapter-baseline/examples/probe.rs +++ b/crates/sspf-adapter-baseline/examples/probe.rs @@ -12,10 +12,10 @@ //! //! ```bash //! # 1. 起一个 HTTP 后端(它就是契约的实现,可以是被测的基线平台,也可以是本仓内核) -//! PGLITE_DIR=/tmp/db PORT=30994 ./target/debug/ssw-platform & +//! PGLITE_DIR=/tmp/db PORT=30994 ./target/debug/sspf-admin & //! //! # 2. 取密文口令 -//! ENC=$(./target/debug/ssw-platform --enc 123456) +//! ENC=$(./target/debug/sspf-admin --enc 123456) //! //! # 3. 探针(账号 + 密文 ⇒ 自动登录) //! cargo run -p sspf-adapter-baseline --example probe -- \ diff --git a/crates/sspf-adapter-baseline/src/lib.rs b/crates/sspf-adapter-baseline/src/lib.rs index 3e01eb2..92ec55e 100644 --- a/crates/sspf-adapter-baseline/src/lib.rs +++ b/crates/sspf-adapter-baseline/src/lib.rs @@ -31,7 +31,7 @@ //! ⇒ 密文由内核生成,调用方传进来: //! //! ```bash -//! ENC=$(./target/release/ssw-platform --enc 123456) +//! ENC=$(./target/release/sspf-admin --enc 123456) //! # ENC 就是参数 passwordCipher //! ``` //! diff --git a/crates/sspf-admin/Cargo.toml b/crates/sspf-admin/Cargo.toml new file mode 100644 index 0000000..e4d1553 --- /dev/null +++ b/crates/sspf-admin/Cargo.toml @@ -0,0 +1,44 @@ +[package] +name = "sspf-admin" +version.workspace = true +edition.workspace = true +rust-version.workspace = true + +# 🔴 **默认装配**(2026-11-04 从 `src/backend/src/main.rs` 剥出)。 +# +# 分层(对齐官方 JNPF 的 `jnpf-common` + `jnpf-system` / `jnpf-admin`): +# crates/sspf-* 能力层(平台核心 / 契约面 / 低代码 / MCP)—— 不认识「一个应用」 +# src/backend 内核 lib(`ssw_platform`):装配根 + 路由 + 业务层 +# packs/* 业务包(只依赖 sspf-sdk) +# crates/sspf-admin **本包 = 一个能跑的应用**:把上面全部装进一个进程, +# 负责「进程级」的事(定位项目根 / 读环境变量 / 开库 / 种子 / +# 自检 / 绑端口 / 优雅停机),内核不碰这些。 +# +# 🔴 **为什么要单独一个包,而不是把 bin 留在内核里**: +# ① 内核是**库**(可被 CLI、MCP 适配器、测试、别的应用复用); +# 一旦它自带 `[[bin]]`,`cargo add` 一个库就顺带下载了一个服务器。 +# ② 「跑起来」是一份**装配选择**(读哪些环境变量、种子灌不灌、监听哪), +# 不是一个能力。换成「只读线上库的巡检程序」时,应该另起一个 admin 包, +# 而不是改内核。 +# ③ 测试宿主(`crates/tests`)与运行入口解耦:测试直接 `use ssw_platform::routes`, +# 不需要起进程。 +# +# 🔴 **加一个应用**:复制本目录改名(如 `sspf-portal`),改 `[package].name` +# 与下面的路径即可 —— 内核与业务包一行都不用动。 +[[bin]] +name = "sspf-admin" +path = "src/main.rs" + +[dependencies] +# 内核 lib:装配根(bootstrap) / 路由(routes) / 业务层(modules) / MCP 适配壳 +ssw-platform = { path = "../../src/backend" } +# 平台核心:cipher / config / db / guard / seed / session / state +sspf-core = { path = "../sspf-core" } +# MCP 工具层(`--mcp` 形态直接起 stdio 服务) +sspf-mcp = { path = "../sspf-mcp" } + +axum = { workspace = true } +tokio = { workspace = true } +# 仅用于 MCP 模式的 `dup2`(把 fd 1 让给 stderr,见 src/main.rs) +libc = { workspace = true } +pglite-rs = { workspace = true } diff --git a/src/backend/src/main.rs b/crates/sspf-admin/src/main.rs similarity index 97% rename from src/backend/src/main.rs rename to crates/sspf-admin/src/main.rs index a2bbffe..3bb15a8 100644 --- a/src/backend/src/main.rs +++ b/crates/sspf-admin/src/main.rs @@ -1,4 +1,7 @@ -//! ssw-platform 二进制入口 —— 启动装配(契约 §10)。 +//! sspf-admin —— **默认装配**的二进制入口(启动装配,契约 §10)。 +//! +//! 🔴 本文件 2026-11-04 从 `src/backend/src/main.rs` 剥出:内核是 lib(可复用), +//! 「怎么跑起来」是应用的选择 ⇒ 归 `crates/sspf-admin`。 //! //! 装配顺序(契约 §10,逐字): //! 1. [`resolve_project_dir`] —— 从可执行文件向上找锚点(`/src/backend/db/schema.sql` @@ -338,18 +341,18 @@ async fn main() { /// 打印用法(`--help` / 未知参数)。 fn print_usage() { println!( - "ssw-platform {} —— JNPF 兼容契约的 Rust 实现(单二进制、零外部服务)", + "sspf-admin {} —— JNPF 兼容契约的 Rust 实现(单二进制、零外部服务)", env!("CARGO_PKG_VERSION") ); println!(); println!("用法:"); - println!(" ssw-platform 启动 HTTP 服务(默认端口 30010)"); - println!(" ssw-platform --mcp 启动 MCP stdio 服务(供 AI 驱动,不监听端口)"); - println!(" ssw-platform --mcp --with-http 同时起 MCP 与 HTTP(同一进程、同一个库)"); - println!(" ssw-platform --enc <明文> 打印登录口令密文(hex),退出码 0"); - println!(" ssw-platform --seed-lowcode-demo 灌入低代码示例功能(开发档专用,建表 + 写功能定义)"); - println!(" ssw-platform --seed-lowcode-demo --dry-run 只看要建什么表,不碰库"); - println!(" ssw-platform --help 打印本用法,退出码 0"); + println!(" sspf-admin 启动 HTTP 服务(默认端口 30010)"); + println!(" sspf-admin --mcp 启动 MCP stdio 服务(供 AI 驱动,不监听端口)"); + println!(" sspf-admin --mcp --with-http 同时起 MCP 与 HTTP(同一进程、同一个库)"); + println!(" sspf-admin --enc <明文> 打印登录口令密文(hex),退出码 0"); + println!(" sspf-admin --seed-lowcode-demo 灌入低代码示例功能(开发档专用,建表 + 写功能定义)"); + println!(" sspf-admin --seed-lowcode-demo --dry-run 只看要建什么表,不碰库"); + println!(" sspf-admin --help 打印本用法,退出码 0"); println!(); println!("环境变量:"); println!(" PORT 监听端口(缺省 30010)"); @@ -698,7 +701,7 @@ async fn run(mode: RunMode) -> Result<(), String> { addr.ip().to_string() }; println!( - "ssw-platform {} 已启动:http://{url_host}:{}(数据目录 {})", + "sspf-admin {} 已启动:http://{url_host}:{}(数据目录 {})", env!("CARGO_PKG_VERSION"), addr.port(), config.pg_dir.display() @@ -759,11 +762,11 @@ async fn shutdown_pg(db: &Db, pg_dir: &std::path::Path) { } if !pid_file_known { - println!("ssw-platform 已停止(临时库模式:数据目录不可知,未校验嵌入式 PostgreSQL 的关库状态)。"); + println!("sspf-admin 已停止(临时库模式:数据目录不可知,未校验嵌入式 PostgreSQL 的关库状态)。"); } else if pid_file.exists() { eprintln!("[停机] ⚠️ 嵌入式 PostgreSQL 未在 3 秒内干净关库(`postmaster.pid` 仍在)"); } else { - println!("ssw-platform 已停止(嵌入式 PostgreSQL 已优雅关闭)。"); + println!("sspf-admin 已停止(嵌入式 PostgreSQL 已优雅关闭)。"); } } diff --git a/crates/sspf-compat-online_dev/Cargo.toml b/crates/sspf-compat-onlinedev/Cargo.toml similarity index 97% rename from crates/sspf-compat-online_dev/Cargo.toml rename to crates/sspf-compat-onlinedev/Cargo.toml index 25fbfcd..f6138e8 100644 --- a/crates/sspf-compat-online_dev/Cargo.toml +++ b/crates/sspf-compat-onlinedev/Cargo.toml @@ -1,5 +1,5 @@ [package] -name = "sspf-compat-online_dev" +name = "sspf-compat-onlinedev" version.workspace = true edition.workspace = true rust-version.workspace = true diff --git a/crates/sspf-compat-online_dev/src/lib.rs b/crates/sspf-compat-onlinedev/src/lib.rs similarity index 77% rename from crates/sspf-compat-online_dev/src/lib.rs rename to crates/sspf-compat-onlinedev/src/lib.rs index cdf994b..431f286 100644 --- a/crates/sspf-compat-online_dev/src/lib.rs +++ b/crates/sspf-compat-onlinedev/src/lib.rs @@ -1,4 +1,4 @@ -//! # sspf-compat-online_dev —— 契约面「online-dev」域 +//! # sspf-compat-onlinedev —— 契约面「onlineDev」域 //! //! 在线开发域(官方 `api/onlineDev/**`):在线表单设计器 / 报表配置 //! @@ -10,7 +10,7 @@ //! 禁止依赖其它 `sspf-compat-*` 包(唯一的单向例外已在 Cargo.toml 里注明白名单)。 //! //! 🔴 **`src/backend/src/platform/compat/<模块>.rs` 只是转发壳** -//! (`pub use sspf_compat_online-dev::<模块>::*;`)⇒ 路由注册 `compat::<模块>::` +//! (`pub use sspf_compat_onlinedev::<模块>::*;`)⇒ 路由注册 `compat::<模块>::` //! **不用改**(M7 删壳时才统一改 import)。 -pub mod online_dev; +pub mod onlinedev; diff --git a/crates/sspf-compat-online_dev/src/online_dev.rs b/crates/sspf-compat-onlinedev/src/onlinedev.rs similarity index 99% rename from crates/sspf-compat-online_dev/src/online_dev.rs rename to crates/sspf-compat-onlinedev/src/onlinedev.rs index 5a50fad..6cb4dcf 100644 --- a/crates/sspf-compat-online_dev/src/online_dev.rs +++ b/crates/sspf-compat-onlinedev/src/onlinedev.rs @@ -1,4 +1,4 @@ -//! online_dev —— 官方面 B 的 **onlineDev** 端点集。 +//! onlinedev —— 官方面 B 的 **onlineDev** 端点集。 //! //! 🔴 **覆盖官方前端 `api/onlineDev/**` 的 6 个文件**: //! `visualDev.ts`(表单设计 + 在线日志 + 个性化视图 + 分享 + 代码生成 + OCR)、 diff --git a/crates/sspf-compat-system/src/system.rs b/crates/sspf-compat-system/src/system.rs index 12fcf3d..13ebdb6 100644 --- a/crates/sspf-compat-system/src/system.rs +++ b/crates/sspf-compat-system/src/system.rs @@ -5838,12 +5838,16 @@ pub async fn data_model_preview( ok(page_list(paging.current_page, paging.page_size, total, rows)) } -/// 内置表判据 —— `schema.sql` 里 `CREATE TABLE` 过的**全部**表名(当前 35 张)。 +/// 内置表判据 —— **平台 DDL 表 ∪ 业务包声明的表**(见 [`sspf_store::db::is_protected_table`])。 /// -/// 🔴 判据取自 DDL 真源([`sspf_store::db::ddl_tables`])而不是在这里再抄一份清单: +/// 🔴 判据取自 DDL 真源而不是在这里再抄一份清单: /// 抄一份的后果是「加了表忘了加护栏」⇒ 新表可以被用户从建模页删掉。 +/// +/// 🔴 **2026-11-04 修正**:原来只认 `schema.sql`(`ddl_tables()`), +/// 而批次 12 之后**业务表的 DDL 跟着包走** ⇒ 包建的表**从来没被保护过**。 +/// 示例表搬进包之后两个集成测试当场抓到 ⇒ 改成并集判据。 fn is_builtin_table(table: &str) -> bool { - sspf_store::db::ddl_tables().iter().any(|t| t == table) + sspf_store::db::is_protected_table(table) } /// 表存在吗(表 / 视图 / 物化视图都算)。 diff --git a/crates/sspf-mcp-adapter/Cargo.toml b/crates/sspf-mcp-adapter/Cargo.toml index 53cf278..8771ba3 100644 --- a/crates/sspf-mcp-adapter/Cargo.toml +++ b/crates/sspf-mcp-adapter/Cargo.toml @@ -17,7 +17,7 @@ rust-version.workspace = true # (`sspf-lowcode-exec`)。它站在这四者**之上**,把它们编排成一个 `PlatformAdapter`。 # # 🔴 **它是全仓唯一「知道全部包」的 crate**: -# `mcp_compat.rs` 要直调 workflow / system / permission / online_dev 四个域的 +# `mcp_compat.rs` 要直调 workflow / system / permission / onlinedev 四个域的 # handler ⇒ 它依赖**所有**契约面包。这在依赖图上是**顶层汇聚点**, # 不是环(被依赖方谁都不认识它)⇒ 方向依然单一。 # @@ -38,7 +38,7 @@ sspf-core = { path = "../sspf-core" } sspf-compat-system = { path = "../sspf-compat-system" } sspf-compat-permission = { path = "../sspf-compat-permission" } sspf-compat-workflow = { path = "../sspf-compat-workflow" } -sspf-compat-online_dev = { path = "../sspf-compat-online_dev" } +sspf-compat-onlinedev = { path = "../sspf-compat-onlinedev" } # 低代码引擎(纯计算:解析 / 校验设计稿) sspf-lowcode = { path = "../sspf-lowcode" } diff --git a/crates/sspf-mcp-adapter/src/mcp_compat.rs b/crates/sspf-mcp-adapter/src/mcp_compat.rs index bb5457b..c975ae4 100644 --- a/crates/sspf-mcp-adapter/src/mcp_compat.rs +++ b/crates/sspf-mcp-adapter/src/mcp_compat.rs @@ -406,7 +406,7 @@ pub async fn user_delete(state: &AppState, args: Value) -> Result Result { let body = body_of(&args)?; - let r = sspf_compat_online_dev::online_dev::visual_dev_create( + let r = sspf_compat_onlinedev::onlinedev::visual_dev_create( State(state.clone()), headers(state, &args).await, body, @@ -418,7 +418,7 @@ pub async fn form_create(state: &AppState, args: Value) -> Result Result { let id = need_str(&args, "id")?; let body = body_of(&args)?; - let r = sspf_compat_online_dev::online_dev::visual_dev_update( + let r = sspf_compat_onlinedev::onlinedev::visual_dev_update( State(state.clone()), headers(state, &args).await, Path(id), @@ -430,7 +430,7 @@ pub async fn form_update(state: &AppState, args: Value) -> Result Result { let id = need_str(&args, "id")?; - let r = sspf_compat_online_dev::online_dev::visual_dev_delete( + let r = sspf_compat_onlinedev::onlinedev::visual_dev_delete( State(state.clone()), headers(state, &args).await, Path(id), @@ -441,7 +441,7 @@ pub async fn form_delete(state: &AppState, args: Value) -> Result Result { let id = need_str(&args, "id")?; - let r = sspf_compat_online_dev::online_dev::visual_dev_release( + let r = sspf_compat_onlinedev::onlinedev::visual_dev_release( State(state.clone()), headers(state, &args).await, Path(id), @@ -587,7 +587,7 @@ pub async fn form_selector(state: &AppState, args: Value) -> Result/schema/*.sql` /// ⇒ 加包**不该**改内核 ⇒ 数量写死是**错误的耦合**。 pub const BASE_TABLE_COUNT: usize = 123; -/// 🔴 **面 A 内嵌业务表**(留在内核 `schema.sql` 里的那几张)。 +/// 🔴 **面 A 内嵌业务表** —— **2026-11-04 起为空**。 /// -/// 🔴 它们是 **react 版的逐字对齐基准**(`demo_item` / `shop_product` / -/// `book_shop_book`)⇒ 留在内核侧 ⇒ 不跟着包走。 +/// 原来这里写着 `demo_item` / `shop_product` / `book_shop_book` 三张"留在内核 +/// `schema.sql` 里"的示例表。它们已经搬进示例业务包 +/// (`packs/{demo,shop,books}/schema/001_init.sql`)—— +/// 理由:示例要能**整目录搬去技能**当样板,DDL 留在内核就等于「搬不干净」。 /// -/// 🔴 **业务包的表**(`asset_data_resource` 等)**不在这里** —— 那些住 `packs/`。 -pub const EMBEDDED_BUSINESS_TABLES: [&str; 3] = ["demo_item", "shop_product", "book_shop_book"]; +/// 🔴 保留这个常量(空数组)而不是删掉:`schema_sql_has_expected_table_count` +/// 与 `ddl_tables_parses_every_create_table` 都用它做「业务表必须恰好是这些」 +/// 的对账口径 —— 留着它,**以后真有「必须住在内核侧的例外」时有落点**, +/// 而不是又去改两处断言。 +pub const EMBEDDED_BUSINESS_TABLES: [&str; 0] = []; /// 🔴 **在线报表元数据表**(官方 `/api/Report/*` 的落库载体)。 /// @@ -929,6 +935,65 @@ pub fn ddl_tables() -> Vec { out } +// ---------------------------------------------------------------- 受保护的表 +// +// 🔴 **为什么需要这一层**(2026-11-04 补):低代码建模页的护栏(`is_builtin_table`) +// 原来只认 `schema.sql` 里的表。批次 12 之后**业务表的 DDL 跟着包走** +// ⇒ 包建的表**从来没被保护过**(`asset_data_resource` 可以被建模页删掉, +// 一直是静默洞)。示例表(`demo_item` 等)搬进包之后也掉了出去, +// 两个集成测试当场抓到 ⇒ 这里把「平台 DDL ∪ 包声明的表」合成一个判据。 +// +// 🔴 **为什么用 `OnceLock` 而不是给 `AppState` 加字段**: +// `AppState` 有 59 个构造点(15 个集成测试文件 + 入口 + 各处夹具)—— +// 加字段等于改 59 处,而这张表**运行期不会变**(包清单是编译进二进制的常量)。 +// 写入方只有装配根一处(`bootstrap::ensure_pack_schema`)⇒ 语义上是常量。 +// +// 🔴 **为什么放在 store 而不是内核**:`is_builtin_table` 住在 +// `sspf-compat-system`(契约面),它**不许**依赖内核或业务包(AR12/AR9) +// ⇒ 只能通过 store 这层纯数据的中转站拿到「哪些表归平台/包所有」。 +static PACK_TABLES: OnceLock> = OnceLock::new(); + +/// 登记**业务包声明的表名**(进程级只写一次)。 +/// +/// 🔴 由装配根在装载完包之后调用(见 `bootstrap::ensure_pack_schema`)—— +/// 重复调用是**无害的空操作**(`OnceLock` 只认第一次), +/// 这样测试与生产的多条建库路径都能各自注册,不用互相约定顺序。 +pub fn register_pack_tables(tables: I) +where + I: IntoIterator, +{ + let _ = PACK_TABLES.set(tables.into_iter().collect()); +} + +/// **受保护的表** = `schema.sql` 的 DDL 表 ∪ 业务包声明的表。 +/// +/// 顺序:先平台表(DDL 顺序),再包表(`app_code` 顺序)—— 只影响展示,不影响判据。 +pub fn protected_tables() -> Vec { + let mut out = ddl_tables(); + if let Some(extra) = PACK_TABLES.get() { + for t in extra { + if !out.iter().any(|x| x == t) { + out.push(t.clone()); + } + } + } + out +} + +/// 这张表是**平台或业务包**声明的吗(⇒ 用户不许从建模页改/删)。 +/// +/// 🔴 判据只读常量清单,**不查库** —— 建模页每次列表都要判 N 张表, +/// 查库会把一次列表变成 N 次往返。 +pub fn is_protected_table(table: &str) -> bool { + if ddl_tables().iter().any(|t| t == table) { + return true; + } + PACK_TABLES + .get() + .map(|extra| extra.iter().any(|t| t == table)) + .unwrap_or(false) +} + /// 字面量感知的 SQL 切分。 /// /// 单引号串(含 `E'...'` 的反斜杠转义)、双引号标识符、`$$...$$` / `$tag$...$tag$`、 @@ -1335,7 +1400,7 @@ mod tests { // // ⇒ 这个文件里现在只有两类表: // ① **平台表**(`base_*`)—— 数量**写死**(`BASE_TABLE_COUNT` 张):加一张平台表是 - // **平台层**的责任 ⇒ 必须同时改 `main.rs` 的 `BASE_TABLES` + // **平台层**的责任 ⇒ 必须同时改 `crates/sspf-admin/src/main.rs` 的 `BASE_TABLES` // (闸门查「孤儿 DDL」会红 ⇒ 两处都改才算登记完成); // ② **面 A 内嵌业务表**(3 张)—— 清单**写死**(名字列表,不是数字): // 它们是 react 版的**对齐基准**,留在内核侧; @@ -1349,7 +1414,7 @@ mod tests { assert_eq!( base.len(), BASE_TABLE_COUNT, - "平台表(base_*)应有 {BASE_TABLE_COUNT} 张(加平台表要同时改 main.rs 的 BASE_TABLES)" + "平台表(base_*)应有 {BASE_TABLE_COUNT} 张(加平台表要同时改 crates/sspf-admin/src/main.rs 的 BASE_TABLES)" ); // 🔴 非平台表必须**恰好**是那 3 张面 A 内嵌业务表 **+ 2 张报表元数据表 @@ -1371,7 +1436,7 @@ mod tests { + extend 示例 16 + teamwork 3 + 大屏 9(业务包表住 packs/)" ); - // 🔴 与 main.rs 的 BASE_TABLES 对账的另一半在那边(孤儿 DDL 闸门)。 + // 🔴 与 crates/sspf-admin/src/main.rs 的 BASE_TABLES 对账的另一半在那边(孤儿 DDL 闸门)。 // 这里只保证「本文件解析出的表 = 文件里 CREATE TABLE 的条数」。 assert_eq!( tables.len(), diff --git a/crates/tests/Cargo.toml b/crates/tests/Cargo.toml new file mode 100644 index 0000000..5546c64 --- /dev/null +++ b/crates/tests/Cargo.toml @@ -0,0 +1,39 @@ +[package] +name = "sspf-tests" +version.workspace = true +edition.workspace = true +rust-version.workspace = true +# 🔴 只在本仓用:不是一个可发布的能力层,只是集成测试的宿主。 +publish = false + +# 🔴 **为什么测试要单独一个包**(2026-11-04 拆出来): +# `src/backend/tests/` 是**内核包**的 integration test 目录 —— 它测的却是 +# 「装配好的平台」(内核 + 契约面 + 业务包 + HTTP 路由),不是内核这一个 crate 的私有行为。 +# ⇒ 放在内核包里,等于宣称「这些是内核的实现细节」: +# ① 内核改名 / 拆包时,37 个测试文件跟着一起搬(历史上真搬过 3 次); +# ② `cargo test -p ssw-platform` 语义被污染(既跑内核单测,又跑全平台集成测试); +# ③ 业务方想「只测我的包」时没有干净的落点。 +# 现在:**测试是被测对象的消费者** ⇒ 单独一个 crate,依赖它要测的所有东西。 +# +# 🔴 **约定**:本包的 `tests/` 里只放 `*_it.rs`(集成测试),不放共享 helper +# (helper 放 `src/lib.rs`,需要时由各测试 `use sspf_tests::…`)。 +# 文件名以 `_it.rs` 结尾这条约定被 `scripts/check-arch.sh` 的 MEM1 用来跳过测试代码。 +[lib] +name = "sspf_tests" +path = "src/lib.rs" + +# 🔴 全部走 `[dev-dependencies]`:只给 `tests/*.rs` 用,lib 目标本身零依赖。 +[dev-dependencies] +# 被测对象:内核(lib `ssw_platform`)—— 装配根 / 路由 / 业务层 / MCP 适配壳 +ssw-platform = { path = "../../src/backend" } +# 平台核心(信封 / 登录 / 权限 / base_* / CRUD 引擎) +sspf-core = { path = "../sspf-core" } +# 低代码纯计算层(FormSchema / ModelSchema 的解析与校验) +sspf-lowcode = { path = "../sspf-lowcode" } +# MCP 工具契约层(工具名 / ToolError 形状) +sspf-mcp = { path = "../sspf-mcp" } + +axum = { workspace = true } +tokio = { workspace = true } +serde_json = { workspace = true } +serde_urlencoded = { workspace = true } diff --git a/crates/tests/src/lib.rs b/crates/tests/src/lib.rs new file mode 100644 index 0000000..d4d3b09 --- /dev/null +++ b/crates/tests/src/lib.rs @@ -0,0 +1,13 @@ +//! sspf-tests —— **平台集成测试的宿主包**(只有 lib 壳,逻辑全在 `tests/`)。 +//! +//! 🔴 本文件**刻意是空的**:存在的唯一理由是给 `tests/*.rs` 一个合法的包主体 +//! (cargo 要求包至少有一个目标),并给未来的共享测试工具留落点。 +//! +//! 🔴 **不要把断言逻辑写在这里** —— 集成测试的价值在于「一个文件 = 一个可独立运行的场景组」, +//! 塞进 lib 之后就变成「隐式共享状态」,测试之间开始互相影响。 +//! +//! 跑法: +//! ```text +//! cargo test -p sspf-tests # 全部集成测试 +//! cargo test -p sspf-tests --test pack_smoke_it +//! ``` diff --git a/src/backend/tests/auth_it.rs b/crates/tests/tests/auth_it.rs similarity index 100% rename from src/backend/tests/auth_it.rs rename to crates/tests/tests/auth_it.rs diff --git a/src/backend/tests/batch10_it.rs b/crates/tests/tests/batch10_it.rs similarity index 100% rename from src/backend/tests/batch10_it.rs rename to crates/tests/tests/batch10_it.rs diff --git a/src/backend/tests/batch11_it.rs b/crates/tests/tests/batch11_it.rs similarity index 100% rename from src/backend/tests/batch11_it.rs rename to crates/tests/tests/batch11_it.rs diff --git a/src/backend/tests/batch13_it.rs b/crates/tests/tests/batch13_it.rs similarity index 100% rename from src/backend/tests/batch13_it.rs rename to crates/tests/tests/batch13_it.rs diff --git a/src/backend/tests/batch14_it.rs b/crates/tests/tests/batch14_it.rs similarity index 100% rename from src/backend/tests/batch14_it.rs rename to crates/tests/tests/batch14_it.rs diff --git a/src/backend/tests/batch15_it.rs b/crates/tests/tests/batch15_it.rs similarity index 100% rename from src/backend/tests/batch15_it.rs rename to crates/tests/tests/batch15_it.rs diff --git a/src/backend/tests/batch16_it.rs b/crates/tests/tests/batch16_it.rs similarity index 100% rename from src/backend/tests/batch16_it.rs rename to crates/tests/tests/batch16_it.rs diff --git a/src/backend/tests/batch17_it.rs b/crates/tests/tests/batch17_it.rs similarity index 100% rename from src/backend/tests/batch17_it.rs rename to crates/tests/tests/batch17_it.rs diff --git a/src/backend/tests/batch18_it.rs b/crates/tests/tests/batch18_it.rs similarity index 100% rename from src/backend/tests/batch18_it.rs rename to crates/tests/tests/batch18_it.rs diff --git a/src/backend/tests/batch19_it.rs b/crates/tests/tests/batch19_it.rs similarity index 100% rename from src/backend/tests/batch19_it.rs rename to crates/tests/tests/batch19_it.rs diff --git a/src/backend/tests/batch20_it.rs b/crates/tests/tests/batch20_it.rs similarity index 100% rename from src/backend/tests/batch20_it.rs rename to crates/tests/tests/batch20_it.rs diff --git a/src/backend/tests/batch2_it.rs b/crates/tests/tests/batch2_it.rs similarity index 100% rename from src/backend/tests/batch2_it.rs rename to crates/tests/tests/batch2_it.rs diff --git a/src/backend/tests/batch3_it.rs b/crates/tests/tests/batch3_it.rs similarity index 100% rename from src/backend/tests/batch3_it.rs rename to crates/tests/tests/batch3_it.rs diff --git a/src/backend/tests/batch4_it.rs b/crates/tests/tests/batch4_it.rs similarity index 100% rename from src/backend/tests/batch4_it.rs rename to crates/tests/tests/batch4_it.rs diff --git a/src/backend/tests/batch5_it.rs b/crates/tests/tests/batch5_it.rs similarity index 100% rename from src/backend/tests/batch5_it.rs rename to crates/tests/tests/batch5_it.rs diff --git a/src/backend/tests/batch6_it.rs b/crates/tests/tests/batch6_it.rs similarity index 100% rename from src/backend/tests/batch6_it.rs rename to crates/tests/tests/batch6_it.rs diff --git a/src/backend/tests/batch7_it.rs b/crates/tests/tests/batch7_it.rs similarity index 100% rename from src/backend/tests/batch7_it.rs rename to crates/tests/tests/batch7_it.rs diff --git a/src/backend/tests/batch8_it.rs b/crates/tests/tests/batch8_it.rs similarity index 100% rename from src/backend/tests/batch8_it.rs rename to crates/tests/tests/batch8_it.rs diff --git a/src/backend/tests/batch9_it.rs b/crates/tests/tests/batch9_it.rs similarity index 100% rename from src/backend/tests/batch9_it.rs rename to crates/tests/tests/batch9_it.rs diff --git a/src/backend/tests/crud_it.rs b/crates/tests/tests/crud_it.rs similarity index 100% rename from src/backend/tests/crud_it.rs rename to crates/tests/tests/crud_it.rs diff --git a/src/backend/tests/db_it.rs b/crates/tests/tests/db_it.rs similarity index 100% rename from src/backend/tests/db_it.rs rename to crates/tests/tests/db_it.rs diff --git a/src/backend/tests/ext_batches_it.rs b/crates/tests/tests/ext_batches_it.rs similarity index 100% rename from src/backend/tests/ext_batches_it.rs rename to crates/tests/tests/ext_batches_it.rs diff --git a/src/backend/tests/guard_it.rs b/crates/tests/tests/guard_it.rs similarity index 100% rename from src/backend/tests/guard_it.rs rename to crates/tests/tests/guard_it.rs diff --git a/src/backend/tests/lowcode_crud_it.rs b/crates/tests/tests/lowcode_crud_it.rs similarity index 100% rename from src/backend/tests/lowcode_crud_it.rs rename to crates/tests/tests/lowcode_crud_it.rs diff --git a/src/backend/tests/lowcode_ddl_it.rs b/crates/tests/tests/lowcode_ddl_it.rs similarity index 100% rename from src/backend/tests/lowcode_ddl_it.rs rename to crates/tests/tests/lowcode_ddl_it.rs diff --git a/src/backend/tests/lowcode_ddl_kernel_it.rs b/crates/tests/tests/lowcode_ddl_kernel_it.rs similarity index 100% rename from src/backend/tests/lowcode_ddl_kernel_it.rs rename to crates/tests/tests/lowcode_ddl_kernel_it.rs diff --git a/src/backend/tests/lowcode_seed_it.rs b/crates/tests/tests/lowcode_seed_it.rs similarity index 100% rename from src/backend/tests/lowcode_seed_it.rs rename to crates/tests/tests/lowcode_seed_it.rs diff --git a/src/backend/tests/mcp_tools_it.rs b/crates/tests/tests/mcp_tools_it.rs similarity index 100% rename from src/backend/tests/mcp_tools_it.rs rename to crates/tests/tests/mcp_tools_it.rs diff --git a/src/backend/tests/mobile_it.rs b/crates/tests/tests/mobile_it.rs similarity index 100% rename from src/backend/tests/mobile_it.rs rename to crates/tests/tests/mobile_it.rs diff --git a/src/backend/tests/pack_smoke_it.rs b/crates/tests/tests/pack_smoke_it.rs similarity index 100% rename from src/backend/tests/pack_smoke_it.rs rename to crates/tests/tests/pack_smoke_it.rs diff --git a/src/backend/tests/permission_it.rs b/crates/tests/tests/permission_it.rs similarity index 100% rename from src/backend/tests/permission_it.rs rename to crates/tests/tests/permission_it.rs diff --git a/src/backend/tests/schema_upgrade_it.rs b/crates/tests/tests/schema_upgrade_it.rs similarity index 100% rename from src/backend/tests/schema_upgrade_it.rs rename to crates/tests/tests/schema_upgrade_it.rs diff --git a/src/backend/tests/seed_it.rs b/crates/tests/tests/seed_it.rs similarity index 100% rename from src/backend/tests/seed_it.rs rename to crates/tests/tests/seed_it.rs diff --git a/src/backend/tests/self_it.rs b/crates/tests/tests/self_it.rs similarity index 100% rename from src/backend/tests/self_it.rs rename to crates/tests/tests/self_it.rs diff --git a/src/backend/tests/sys_it.rs b/crates/tests/tests/sys_it.rs similarity index 100% rename from src/backend/tests/sys_it.rs rename to crates/tests/tests/sys_it.rs diff --git a/src/backend/tests/verify_fixes_it.rs b/crates/tests/tests/verify_fixes_it.rs similarity index 100% rename from src/backend/tests/verify_fixes_it.rs rename to crates/tests/tests/verify_fixes_it.rs diff --git a/src/backend/tests/visualdata_it.rs b/crates/tests/tests/visualdata_it.rs similarity index 100% rename from src/backend/tests/visualdata_it.rs rename to crates/tests/tests/visualdata_it.rs diff --git a/docs/CRATES-MIGRATION.md b/docs/CRATES-MIGRATION.md index fb29b07..23c2ef9 100644 --- a/docs/CRATES-MIGRATION.md +++ b/docs/CRATES-MIGRATION.md @@ -131,7 +131,7 @@ system.rs:26 use super::helper::{EN_MENU, EN_USER, ..., guard, guard_any, ...}; **依赖广度证据**(实测,**14/14** 个 compat 模块都依赖 helper): ``` ai.rs:1 extend.rs:1 message.rs:1 mobile.rs:1 msg_center.rs:1 -online_dev.rs:1 permission.rs:1 report.rs:1 res.rs:1 +onlinedev.rs:1 permission.rs:1 report.rs:1 res.rs:1 scheduletask.rs:1 system.rs:1 teamwork.rs:1 visualdata.rs:1 workflow.rs:1 ``` ⇒ **helper 必须是所有 compat 包的公共底座** ⇒ 它**必须**独立成一个 crate。 @@ -232,7 +232,7 @@ ssw-platform/ │ ├── 🆕 sspf-compat-workflow/ # 契约面:workflow + report + visualdata │ ├── 🆕 sspf-compat-msg/ # 契约面:message + msg_center + scheduletask │ ├── 🆕 sspf-compat-ext/ # 契约面:extend + teamwork + ai + mobile + core + res -│ └── 🆕 sspf-compat-online-dev/ # 契约面:online_dev +│ └── 🆕 sspf-compat-onlinedev/ # 契约面:onlinedev(官方 onlineDev) │ ├── packs/ # 【业务包】不变 └── src/backend/ # 【薄壳】只剩这些 @@ -396,7 +396,7 @@ ssw-platform/ | `sspf-compat-msg` | message + msg_center | 2,662 + 3,391 | compat-core + core + chrono | | `sspf-compat-workflow` | workflow + report + visualdata | 4,171 + 1,438 + 3,120 | compat-core + core + chrono + aes/ecb/hex | | `sspf-compat-ext` | extend + teamwork + ai + mobile | 2,073 + 3,479 + 1,377 + 1,213 | compat-core + core + **system + msg** + chrono | -| `sspf-compat-online_dev` | online_dev | 3,175 | compat-core + core | +| `sspf-compat-onlinedev` | onlinedev | 3,175 | compat-core + core | 合计 **14 个模块 / ~49,000 行**。原 `src/backend/src/platform/compat/<模块>.rs` 全部变成 5 行转发壳(`pub use sspf_compat_<域>::<模块>::*;`)。 @@ -407,7 +407,7 @@ ssw-platform/ | `system` 只含 system.rs | 追加 `scheduletask` + `core` | 这两个模块**不依赖**任何其它契约面模块 ⇒ 与 system 同属「无跨包依赖」组,合并可少一条 crate 边 | | `msg` 含 scheduletask | scheduletask 归 system | 同上 | | `ext` 含 core | core 归 system | 同上 | -| `sspf-compat-online-dev` | **`sspf-compat-online_dev`** | 🔴 **Rust 包名不能带连字符**(`use sspf-compat-online-dev::…` 编译不过)⇒ 目录名与包名都改下划线 | +| `sspf-compat-online-dev` | **`sspf-compat-onlinedev`** | 🔴 **Rust 包名不能带连字符**(`use sspf-compat-online-dev::…` 编译不过)⇒ 目录名与包名都去连字符。**2026-11-04 二次改名**:中间态曾叫 `sspf-compat-online_dev`(下划线版),与官方 `onlineDev` 拼写不一致、也与同族 `sspf-compat-{system,ext}` 的「去分隔符」惯例不符 ⇒ 统一为 `onlinedev`(模块名/文件名同步) | | 6 包互相独立 | 3 条**单向**跨包依赖 | 实测扫描得出:`permission→system`(4 符号)、`mobile→system`+`mobile→msg`(2 函数)。方向单一 ⇒ 不成环 | **新增 AR12(防环回流闸门)**:`crates/sspf-compat-*` 之间不许互相依赖,白名单只放那 3 条单向边(`permission→system`、`ext→system`、`ext→msg`)。判据在 **Cargo.toml 级**(不是 grep 源码)⇒ 改依赖即被抓。 @@ -488,7 +488,7 @@ ssw-platform/ **迁入**:`mcp_adapter.rs`(2,652 行)+ `mcp_compat.rs`(631 行)⇒ 共 3,283 行 -**新 crate**:`crates/sspf-mcp-adapter`(依赖 sspf-mcp + sspf-core + sspf-compat-{system,permission,workflow,online_dev} + sspf-lowcode + sspf-lowcode-exec + axum + pglite-rs) +**新 crate**:`crates/sspf-mcp-adapter`(依赖 sspf-mcp + sspf-core + sspf-compat-{system,permission,workflow,onlinedev} + sspf-lowcode + sspf-lowcode-exec + axum + pglite-rs) > 🔴 `mcp_compat.rs` 直调 `platform::compat::*` 的 handler ⇒ 它依赖**所有** compat 包。 > 这是唯一「知道全部包」的 crate ⇒ 它属于壳还是能力? @@ -740,9 +740,9 @@ bash scripts/verify.sh --smoke # 14 步全绿 删壳时 AR9/AR10/CP1/CP2 的「两处都扫」收敛为只扫 `crates/`(壳没了)。 - **M7 出口判据**:`src/backend/src/platform/` 目录整个删除;全仓无 `crate::platform::` 引用。 -2. ✅ **compat 拆 6 个包**(按官方模块名):`sspf-compat-{system,permission,msg,workflow,ext,online_dev}`。 +2. ✅ **compat 拆 6 个包**(按官方模块名):`sspf-compat-{system,permission,msg,workflow,ext,onlinedev}`。 - 边界清晰、与官方前端 `api/` 目录一一对应。 - - ⚠️ **实际落地时 `online-dev` 改名 `online_dev`** —— Rust 包名不能带连字符(`use sspf-compat-online-dev::…` 编译不过)。 + - ⚠️ **实际落地时 `online-dev` → `onlinedev`** —— Rust 包名不能带连字符(`use sspf-compat-online-dev::…` 编译不过);官方拼写 `onlineDev` 去分隔符后即 `onlinedev`。 - **M4 已同步**:`check-contract-scan.py` 动态收编 6 个包 + 重跑 `--self-test`(12 例全过)。 3. ✅ **`mcp_compat.rs` 放 crates**(`sspf-mcp-adapter`)。 @@ -754,6 +754,8 @@ bash scripts/verify.sh --smoke # 14 步全绿 (认识业务 DDL)⇒ 拆测试必须先把「测试建库」改成**各 crate 自足**(core 的测试用 `seed::ensure_base(db, &[])`;compat 的测试建自己的契约面表;业务集成测试留壳侧测装配)。 - **分层**:单元测试随代码进各 crate;**集成测试**(测「装配后的整体」,如 `pack_smoke_it.rs`)**留壳侧**。 + ⚠️ **2026-11-04 修正**:壳侧已经不够了 —— 集成测试有自己的宿主包 `crates/tests`(package `sspf-tests`), + 不再挂在 `src/backend/tests/`(理由见 `crates/tests/Cargo.toml` 顶部;由 AR16 钉住)。 --- diff --git a/docs/contract.md b/docs/contract.md index 327476a..d19db8a 100644 --- a/docs/contract.md +++ b/docs/contract.md @@ -922,7 +922,7 @@ pub(crate) async fn handle_delete(state: &AppState, headers: &HeaderMap, spec: & ```rust pub fn build_router(state: AppState) -> Router; ``` -(`with_state` 由 `main.rs` 在**链尾**调用; +(`with_state` 由 `crates/sspf-admin/src/main.rs` 在**链尾**调用; 业务路由由 `routes.rs` 的 `.merge(modules::router())` 一次并入 ⇒ **加业务模块不动平台层**。) ### AppState(`crates/sspf-core/src/state.rs`) @@ -941,7 +941,7 @@ pub struct AppState { --- -## 10. 启动装配(main.rs) +## 10. 启动装配(crates/sspf-admin/src/main.rs) 顺序: 1. `resolve_project_dir()` —— 从可执行文件向上找锚点文件(`src/backend/db/schema.sql` + 根 `Cargo.toml`),**与 cwd 解耦** @@ -1071,7 +1071,7 @@ react 版 `scripts/perm-smoke.sh` 实际有 **32 条断言**。移植后一条 | 43 | 多应用:`CurrentUser` 带 `App-Code: app-b` | `data.currentSystemId = "app-b"`(应用路由生效) | **脚本不得依赖 node**(react 版依赖 `node` + `crypto-js` + `src/backend/node_modules`,本仓一律不用): -- **cipher 加密** ⇒ 调用后端自证:`./target/release/ssw-platform --enc '<明文>'` 输出 hex(退出码 0)。 +- **cipher 加密** ⇒ 调用后端自证:`./target/release/sspf-admin --enc '<明文>'` 输出 hex(退出码 0)。 (冒烟脚本自带 `--enc` 的向量自检,**不**假设 node 存在。) - **JSON 取值** ⇒ `jq`(若已装)或 `python3`(macOS 自带)写的取字段小工具;**不得**用 node。 - **期望菜单树** ⇒ **从附录 A 的 `[MENU_TREE]` 区段读**(不是写死在脚本里)—— @@ -1113,14 +1113,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 -m_demo Demo 示例 permission.demo demo-item 0 2 app 6 -m_product 产品管理 permission.shop.product shop/Product 0 2 app 7 -m_book 图书超市 permission.books.book books/Book 0 2 app 8 # 🔴 以下由 `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 [MENU_TREE] @@ -1131,14 +1131,14 @@ m_resource 数据资源 permission.asset.dataResource asset/DataResource 0 2 app # moduleKey = 该模块的守卫菜单 key;`None` = 仅需登录(无菜单权限要求) # apiFile = 前端**应不应该**有 `src/frontend/src/api/.ts`(`有` / `无`) # rsFile = 业务模块源文件 `src/backend/src/modules/.rs` -demo DemoItem demo_item demo-item None m_demo 无 demo.rs -shop Product shop_product shop/Product shop/Product m_product 有 shop.rs -books Book book_shop_book books/Book books/Book m_book 有 books.rs # 🔴 以下由 `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 [ENDPOINT] @@ -2208,12 +2208,21 @@ 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 [FACE] # face 条数 说明 A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条) -B 1010 面 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) +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) AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流) [OFFICIAL] diff --git a/docs/mcp.md b/docs/mcp.md index a72ac95..74f326f 100644 --- a/docs/mcp.md +++ b/docs/mcp.md @@ -13,7 +13,7 @@ cargo build --release # 手动跑一次(可选)—— 应该立刻回一行 initialize 的 JSON printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \ - | ./target/release/ssw-platform --mcp 2>/dev/null + | ./target/release/sspf-admin --mcp 2>/dev/null ``` ### Claude Code / 通用 MCP 客户端 @@ -40,7 +40,7 @@ printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \ ### 想同时用浏览器看效果? ```bash -./target/release/ssw-platform --mcp --with-http +./target/release/sspf-admin --mcp --with-http ``` **同一进程、同一个 `AppState`、同一个库**:AI 通过 MCP 建的表 / 写的菜单, @@ -280,8 +280,8 @@ dry-run 的意义就是让人核对真实值,遮掉反而看不出写错在哪 ### 造一份示例功能:`--seed-lowcode-demo` ```bash -PGLITE_DIR=/tmp/sspf-demo ./target/debug/ssw-platform --seed-lowcode-demo # 建表 + 写功能定义 -PGLITE_DIR=/tmp/sspf-demo ./target/debug/ssw-platform --seed-lowcode-demo --dry-run # 只看不碰库(连库都不开) +PGLITE_DIR=/tmp/sspf-demo ./target/debug/sspf-admin --seed-lowcode-demo # 建表 + 写功能定义 +PGLITE_DIR=/tmp/sspf-demo ./target/debug/sspf-admin --seed-lowcode-demo --dry-run # 只看不碰库(连库都不开) ``` - 固定 `id=lowcode-demo-receivable` + `enCode=receivableDemo` ⇒ **幂等**(重复跑是更新同一条) @@ -374,9 +374,9 @@ organize → organizeId ```bash # 探针:用它打任意实现了契约的 HTTP 后端 -PGLITE_DIR=/tmp/db PORT=30994 ./target/release/ssw-platform & +PGLITE_DIR=/tmp/db PORT=30994 ./target/release/sspf-admin & cargo run -p sspf-adapter-baseline --example probe -- \ - http://127.0.0.1:30994 admin "$(./target/release/ssw-platform --enc 123456)" + http://127.0.0.1:30994 admin "$(./target/release/sspf-admin --enc 123456)" ``` 🔴 口令要传**密文**(`--enc` 生成)。适配器不复制 cipher 逻辑 —— diff --git a/docs/verify-report-2026-11-02.md b/docs/verify-report-2026-11-02.md index 85236a8..58b5de1 100644 --- a/docs/verify-report-2026-11-02.md +++ b/docs/verify-report-2026-11-02.md @@ -96,8 +96,8 @@ | # | 端点 | 代码位置 | 服务端日志 | |---|---|---|---| -| 1 | `GET /api/visualdev/OnlineLog` | `crates/sspf-compat-online_dev/src/online_dev.rs:2333-2350` | `[face-b] 在线日志总数查询失败: statement takes 0 parameters, 1 given` | -| 2 | `GET /api/visualdev/share/Selector` | `crates/sspf-compat-online_dev/src/online_dev.rs:2261-2272` | `[face-b] 跨应用功能查询失败: statement takes 0 parameters, 1 given` | +| 1 | `GET /api/visualdev/OnlineLog` | `crates/sspf-compat-onlinedev/src/onlinedev.rs:2333-2350` | `[face-b] 在线日志总数查询失败: statement takes 0 parameters, 1 given` | +| 2 | `GET /api/visualdev/share/Selector` | `crates/sspf-compat-onlinedev/src/onlinedev.rs:2261-2272` | `[face-b] 跨应用功能查询失败: statement takes 0 parameters, 1 given` | | 3 | `GET /api/message/Monitor/{id}/RecordList` | `crates/sspf-compat-msg/src/msg_center.rs:180`(`paged_query` 的 count 分支) | `[face-b] 消息发送记录列表总数查询失败: statement takes 0 parameters, 1 given` | 复现(三条都不依赖库里有没有数据): diff --git a/packs/books/Cargo.toml b/packs/books/Cargo.toml new file mode 100644 index 0000000..25f9b0c --- /dev/null +++ b/packs/books/Cargo.toml @@ -0,0 +1,11 @@ +[package] +name = "sspf-pack-books" +version.workspace = true +edition.workspace = true +rust-version.workspace = true + +# 🔴 AR2:业务包只允许依赖 `sspf-sdk`(+ serde)。 +# 出现 axum / tokio / pglite ⇒ `check-arch.sh` 直接红。 +# 这是「整目录可搬走」的技术保证。 +[dependencies] +sspf-sdk = { path = "../../crates/sspf-sdk" } diff --git a/packs/books/pack.toml b/packs/books/pack.toml new file mode 100644 index 0000000..f4bf316 --- /dev/null +++ b/packs/books/pack.toml @@ -0,0 +1,31 @@ +# 业务包清单 —— **示例包**(可整目录搬走,技能带它当样板)。 +# 🔴 本文件不是给 cargo 读的,是给 `sspf pack export/import` 与内核装载器读的。 + +[pack] +app_code = "books" +name = "图书超市" +version = "1.0.0" +kernel = ">=0.4,<0.5" # 契约版本区间(不是 cargo 版本,见 bootstrap::kernel_version) +migratable = true # 允许导出到基线平台 + +[pack.compat] +baseline = "react-demo" # 对齐基准 +frontend = "vue3" # 前端族(决定表单 JSON 方言) +tenant = false # 本期单租户(列仍带 f_tenant_id,见 DDL 注释) + +# 物理表:name = 本平台表名;baseline_table = 基线平台上的表名(导出时映射) +[[pack.tables]] +name = "book_shop_book" +ddl = "schema/001_init.sql" +baseline_table = "book_shop_book" + +[pack.metadata] +# 低代码元数据(与基线平台 visualdev 同构的 JSON)。纯手写 spec ⇒ 留空。 +forms = [] +models = [] +menus = [] +flows = [] + +[pack.build] +# 纯元数据包(L0):无 Rust 代码要编译,spec 直接链进内核。 +kind = "none" diff --git a/packs/books/schema/001_init.sql b/packs/books/schema/001_init.sql new file mode 100644 index 0000000..0ecdc11 --- /dev/null +++ b/packs/books/schema/001_init.sql @@ -0,0 +1,33 @@ +-- book_shop_book —— 图书超市(业务包自带的 DDL)。 +-- +-- 🔴 **DDL 跟着包走**:本文件在 `packs/books/schema/` 下,由 `packs/books/src/lib.rs` +-- 用 `include_str!` **编译进二进制** ⇒ 内核启动时按包顺序幂等执行 +-- ⇒ 不再手抄进 `db/schema.sql`。 +-- +-- 🔴 **列名 / 列序逐字对齐 react 版 TypeORM entity**(`books.entity.ts`)—— +-- 这是「两版后端能开同一个库」的前提 ⇒ **业务列一个都不许改名**。 +-- +-- 🔴 **2026-11-04 的两处差异**(搬成包时按平台规则补的,见 `HANDOFF.md`): +-- ① 追加 `f_tenant_id`(`DEFAULT '0' NOT NULL`)并进入复合主键 —— +-- 包 DDL 的硬闸门(`bootstrap::pack_ddls_carry_tenant_id_and_composite_key`) +-- 要求每张业务表都带它;react 侧不认识这一列,但读不读都行、写不写都行 +-- (有默认值),⇒ 同库兼容性仍然成立; +-- ② `f_id` 从 `PRIMARY KEY` 改成 `NOT NULL` + 末尾复合主键。 +-- 🔴 **spec 的列清单没有加 `f_tenant_id`** ⇒ 面 A / 面 B 的 JSON 键与响应**零变化**。 +-- +-- 🔴 **本文件只许建本包自己的表**,**不许建 `base_*`**(装载器会拦)。 + +CREATE TABLE IF NOT EXISTS book_shop_book ( + f_id VARCHAR(50) NOT NULL, + f_title VARCHAR(255), + f_author VARCHAR(100), + f_isbn VARCHAR(32), + f_category VARCHAR(50), + f_price NUMERIC(12,2), + f_stock INTEGER DEFAULT 0, + f_creator_user_id VARCHAR(50), + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_mark INTEGER DEFAULT 0, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); diff --git a/packs/books/src/lib.rs b/packs/books/src/lib.rs new file mode 100644 index 0000000..f8df1cb --- /dev/null +++ b/packs/books/src/lib.rs @@ -0,0 +1,229 @@ +//! books —— 图书超市业务包(**示例包**)。 +//! +// 🔴 **本包是「示例」,不是业务真源**:它演示「一个业务包只依赖 `sspf-sdk` +//! 就能声明完整的业务(表 + 列 + 菜单 + 面 B 路由)」。 +//! 技能把这套示例带走时,**整个 `packs/books` 目录一起搬**即可 —— 内核零改动。 +//! +//! 🔴 **依赖纪律(AR2)**:只允许 `sspf-sdk`。出现 axum / tokio / pglite +//! ⇒ `check-arch.sh` 直接红 —— 这是「整目录可搬走」的技术保证。 +//! 🔴 **守卫**:菜单 `books/Book`(`module_key`)⇒ 非管理员未授权 ⇒ `code=403`。 +//! 🔴 `f_price` 是 **numeric**(JSON 字符串 `"9.90"`)· `f_stock` 是 **int**(JSON 数字 `100`)。 +//! +//! 🔴 **DDL 跟着包走**:`schema/001_init.sql` 用 `include_str!` 编译进二进制, +//! 内核启动时幂等执行 ⇒ 不再手抄进 `db/schema.sql`。 + +use sspf_sdk::{ + BusinessPack, ColumnSpec, EntitySpec, HttpMethod, Manifest, MenuSpec, PackRoute, RouteAction, + RouteGuard, +}; + +/// 🔴 **本包自带的 DDL**(编译进二进制 ⇒ 包目录可整目录搬走)。 +pub const BOOK_DDL: &str = include_str!("../schema/001_init.sql"); + +/// 🔴 **包的统一 DDL 出口**(`表名 → DDL 文本`)—— 内核**只认这一种写法**。 +/// 常量名固定、形状固定 ⇒ 内核/生成器可以无脑遍历(加包不用改内核)。 +pub const DDLS: &[(&str, &str)] = &[("book_shop_book", BOOK_DDL)]; + +/// `book_shop_book` 的列清单(**顺序 = 响应 JSON 的键序**)。 +/// +/// 🔴 **不含 `f_tenant_id`**:该列在 DDL 里(平台硬要求),但不进投影 / 不进出参 +/// ⇒ 响应形状与面 A 的历史行为**逐字不变**(`db/schema.sql` 时代的 JSON 长什么样, +/// 现在还是什么样)。 +const BOOK_COLUMNS: &[ColumnSpec] = &[ + ColumnSpec { + column: "f_id", + json_key: "id", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_title", + json_key: "title", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_author", + json_key: "author", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_isbn", + json_key: "isbn", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_category", + json_key: "category", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_price", + json_key: "price", + default: Some("0.00"), + numeric: true, + }, + ColumnSpec { + column: "f_stock", + json_key: "stock", + default: Some("0"), + numeric: false, + }, + ColumnSpec { + column: "f_creator_user_id", + json_key: "creatorUserId", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_creator_time", + json_key: "creatorTime", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_delete_mark", + json_key: "deleteMark", + default: Some("0"), + numeric: false, + }, +]; + +/// `book_shop_book` 的 spec。 +pub const BOOK_SPEC: EntitySpec = EntitySpec { + app_code: "books", + entity: "Book", + table: "book_shop_book", + module_key: Some("books/Book"), + columns: BOOK_COLUMNS, + numeric_columns: &["f_price"], + creator_fixed: None, +}; + +/// 本包的内置菜单。 +/// +/// 🔴 `url_address` 与 [`BOOK_SPEC`] 的 `module_key` 必须**一字不差** +/// (面 A 的菜单守卫靠它命中);`module_key: None` 的包(如 demo)走「仅登录」。 +pub const BOOK_MENU: MenuSpec = MenuSpec { + id: "m_book", + full_name: "图书超市", + en_code: "permission.books.book", + url_address: "books/Book", + parent_id: "0", + menu_type: 2, + icon: Some("app"), + sort_code: 8, + // 🔴 字面量而非引用内核常量:业务包不许依赖内核(AR2)。 + // `mainSystem` 是基线平台的官方常量值,属于契约字面量,可以写死。 + system_en_code: "mainSystem", +}; + +/// 包清单(与 `pack.toml` 的 `[pack]` 段一致)。 +const MANIFEST: Manifest = Manifest { + app_code: "books", + name: "图书超市", + version: "1.0.0", + kernel_req: ">=0.4,<0.5", + migratable: true, +}; + +// ---------------------------------------------------------------- 路由声明 +// +// 🔴 **面 B 必须是官方 RESTful 形状**:`GET/POST /api/{模块}/{资源}` + +// `DELETE /api/{模块}/{资源}/{id}` —— **不是**面 A 的 `/api/ssw/...`。 +// 面 A 由内核的 `src/backend/src/modules/books.rs` 提供(本仓自造约定)。 +// +// 🔴 **路由是「声明」,不是 handler** —— `PackRoute` 里没有 axum 类型 +// ⇒ 业务包不需要依赖 axum;内核按声明 + spec 生成真正的 handler +// (`sspf_core::crud::crud_router`)。 +// 🔴 **面 B 的判据 = 点权限(`f_en_code`)** —— 同上,与面 A 的菜单路径并存。 + +/// `GET /api/books/Book` —— 列表。 +pub const BOOK_LIST_ROUTE: PackRoute = PackRoute { + path: "/api/books/Book", + method: HttpMethod::Get, + entity: "Book", + action: RouteAction::List, + guard: RouteGuard::EnCode("permission.books.book"), +}; + +/// `POST /api/books/Book` —— 新建 / 更新(body 里带 `id` 就是更新)。 +pub const BOOK_SAVE_ROUTE: PackRoute = PackRoute { + path: "/api/books/Book", + method: HttpMethod::Post, + entity: "Book", + action: RouteAction::Save, + guard: RouteGuard::EnCode("permission.books.book"), +}; + +/// `DELETE /api/books/Book/{id}` —— 软删。 +pub const BOOK_DELETE_ROUTE: PackRoute = PackRoute { + path: "/api/books/Book/{id}", + method: HttpMethod::Delete, + entity: "Book", + action: RouteAction::Delete, + guard: RouteGuard::EnCode("permission.books.book"), +}; + +/// 本包声明的全部路由(每条实体恰好 3 条 —— 内核的装载自检钉住这个数)。 +pub const BOOK_ROUTES: &[PackRoute] = &[ + BOOK_LIST_ROUTE, + BOOK_SAVE_ROUTE, + BOOK_DELETE_ROUTE, +]; + +/// 业务包本体。 +/// +/// 🔴 **类型名固定为 `Pack`** —— 内核的 `packs_gen.rs` 是生成的, +/// 生成器按 `sspf_pack_::Pack` 拼路径 ⇒ 每个包都用同一个名字。 +pub struct Pack; + +impl BusinessPack for Pack { + fn manifest(&self) -> &'static Manifest { + &MANIFEST + } + + fn entities(&self) -> &'static [EntitySpec] { + &[BOOK_SPEC] + } + + fn menus(&self) -> &'static [MenuSpec] { + &[BOOK_MENU] + } + + fn routes(&self) -> &'static [PackRoute] { + BOOK_ROUTES + } +} + +#[cfg(test)] +mod tests { + use super::*; + + /// 列名全部 `f_` 前缀,且第一列是 `f_id`(响应键序的第一位)。 + #[test] + fn columns_are_prefixed_and_have_id() { + assert_eq!(BOOK_COLUMNS[0].column, "f_id"); + for c in BOOK_COLUMNS { + assert!(c.column.starts_with("f_"), "列名必须 f_ 前缀: {}", c.column); + } + } + + /// spec 的 `module_key` 与菜单 `url_address` 一致(`None` 的包只校验菜单本身)。 + #[test] + fn module_key_matches_menu_url_address() { + match BOOK_SPEC.module_key { + Some(key) => assert_eq!(key, BOOK_MENU.url_address), + None => assert_eq!(BOOK_MENU.url_address, "books/Book"), + } + } + + /// 路由条数固定 3(List / Save / Delete)—— 少一条 ⇒ 某动作静默 404。 + #[test] + fn declares_exactly_three_routes() { + assert_eq!(BOOK_ROUTES.len(), 3); + } +} diff --git a/packs/demo/Cargo.toml b/packs/demo/Cargo.toml new file mode 100644 index 0000000..965b365 --- /dev/null +++ b/packs/demo/Cargo.toml @@ -0,0 +1,11 @@ +[package] +name = "sspf-pack-demo" +version.workspace = true +edition.workspace = true +rust-version.workspace = true + +# 🔴 AR2:业务包只允许依赖 `sspf-sdk`(+ serde)。 +# 出现 axum / tokio / pglite ⇒ `check-arch.sh` 直接红。 +# 这是「整目录可搬走」的技术保证。 +[dependencies] +sspf-sdk = { path = "../../crates/sspf-sdk" } diff --git a/packs/demo/pack.toml b/packs/demo/pack.toml new file mode 100644 index 0000000..a3eab42 --- /dev/null +++ b/packs/demo/pack.toml @@ -0,0 +1,31 @@ +# 业务包清单 —— **示例包**(可整目录搬走,技能带它当样板)。 +# 🔴 本文件不是给 cargo 读的,是给 `sspf pack export/import` 与内核装载器读的。 + +[pack] +app_code = "demo" +name = "Demo 示例" +version = "1.0.0" +kernel = ">=0.4,<0.5" # 契约版本区间(不是 cargo 版本,见 bootstrap::kernel_version) +migratable = true # 允许导出到基线平台 + +[pack.compat] +baseline = "react-demo" # 对齐基准 +frontend = "vue3" # 前端族(决定表单 JSON 方言) +tenant = false # 本期单租户(列仍带 f_tenant_id,见 DDL 注释) + +# 物理表:name = 本平台表名;baseline_table = 基线平台上的表名(导出时映射) +[[pack.tables]] +name = "demo_item" +ddl = "schema/001_init.sql" +baseline_table = "demo_item" + +[pack.metadata] +# 低代码元数据(与基线平台 visualdev 同构的 JSON)。纯手写 spec ⇒ 留空。 +forms = [] +models = [] +menus = [] +flows = [] + +[pack.build] +# 纯元数据包(L0):无 Rust 代码要编译,spec 直接链进内核。 +kind = "none" diff --git a/packs/demo/schema/001_init.sql b/packs/demo/schema/001_init.sql new file mode 100644 index 0000000..594dcb4 --- /dev/null +++ b/packs/demo/schema/001_init.sql @@ -0,0 +1,29 @@ +-- demo_item —— Demo 示例(业务包自带的 DDL)。 +-- +-- 🔴 **DDL 跟着包走**:本文件在 `packs/demo/schema/` 下,由 `packs/demo/src/lib.rs` +-- 用 `include_str!` **编译进二进制** ⇒ 内核启动时按包顺序幂等执行 +-- ⇒ 不再手抄进 `db/schema.sql`。 +-- +-- 🔴 **列名 / 列序逐字对齐 react 版 TypeORM entity**(`demo.entity.ts`)—— +-- 这是「两版后端能开同一个库」的前提 ⇒ **业务列一个都不许改名**。 +-- +-- 🔴 **2026-11-04 的两处差异**(搬成包时按平台规则补的,见 `HANDOFF.md`): +-- ① 追加 `f_tenant_id`(`DEFAULT '0' NOT NULL`)并进入复合主键 —— +-- 包 DDL 的硬闸门(`bootstrap::pack_ddls_carry_tenant_id_and_composite_key`) +-- 要求每张业务表都带它;react 侧不认识这一列,但读不读都行、写不写都行 +-- (有默认值),⇒ 同库兼容性仍然成立; +-- ② `f_id` 从 `PRIMARY KEY` 改成 `NOT NULL` + 末尾复合主键。 +-- 🔴 **spec 的列清单没有加 `f_tenant_id`** ⇒ 面 A / 面 B 的 JSON 键与响应**零变化**。 +-- +-- 🔴 **本文件只许建本包自己的表**,**不许建 `base_*`**(装载器会拦)。 + +CREATE TABLE IF NOT EXISTS demo_item ( + f_id VARCHAR(50) NOT NULL, + f_title VARCHAR(255), + f_status VARCHAR(32), + f_creator_user_id VARCHAR(50), + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_mark INTEGER DEFAULT 0, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); diff --git a/packs/demo/src/lib.rs b/packs/demo/src/lib.rs new file mode 100644 index 0000000..a55befc --- /dev/null +++ b/packs/demo/src/lib.rs @@ -0,0 +1,207 @@ +//! demo —— Demo 示例业务包(**示例包**)。 +//! +// 🔴 **本包是「示例」,不是业务真源**:它演示「一个业务包只依赖 `sspf-sdk` +//! 就能声明完整的业务(表 + 列 + 菜单 + 面 B 路由)」。 +//! 技能把这套示例带走时,**整个 `packs/demo` 目录一起搬**即可 —— 内核零改动。 +//! +//! 🔴 **依赖纪律(AR2)**:只允许 `sspf-sdk`。出现 axum / tokio / pglite +//! ⇒ `check-arch.sh` 直接红 —— 这是「整目录可搬走」的技术保证。 +//! 🔴 **本包的特别规则(裁决 S22)**:`f_creator_user_id` **恒为 `'admin'`** +//! (不看 body)⇒ 由 spec 的 `creator_fixed` 声明,引擎不认 app_code。 +//! 🔴 **本包仅登录**(`module_key: None`)⇒ 面 A 走「登录即可」,面 B 走 `RouteGuard::Login`。 +//! +//! 🔴 **DDL 跟着包走**:`schema/001_init.sql` 用 `include_str!` 编译进二进制, +//! 内核启动时幂等执行 ⇒ 不再手抄进 `db/schema.sql`。 + +use sspf_sdk::{ + BusinessPack, ColumnSpec, EntitySpec, HttpMethod, Manifest, MenuSpec, PackRoute, RouteAction, + RouteGuard, +}; + +/// 🔴 **本包自带的 DDL**(编译进二进制 ⇒ 包目录可整目录搬走)。 +pub const DEMO_DDL: &str = include_str!("../schema/001_init.sql"); + +/// 🔴 **包的统一 DDL 出口**(`表名 → DDL 文本`)—— 内核**只认这一种写法**。 +/// 常量名固定、形状固定 ⇒ 内核/生成器可以无脑遍历(加包不用改内核)。 +pub const DDLS: &[(&str, &str)] = &[("demo_item", DEMO_DDL)]; + +/// `demo_item` 的列清单(**顺序 = 响应 JSON 的键序**)。 +/// +/// 🔴 **不含 `f_tenant_id`**:该列在 DDL 里(平台硬要求),但不进投影 / 不进出参 +/// ⇒ 响应形状与面 A 的历史行为**逐字不变**(`db/schema.sql` 时代的 JSON 长什么样, +/// 现在还是什么样)。 +const DEMO_COLUMNS: &[ColumnSpec] = &[ + ColumnSpec { + column: "f_id", + json_key: "id", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_title", + json_key: "title", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_status", + json_key: "status", + default: Some("草稿"), + numeric: false, + }, + ColumnSpec { + column: "f_creator_user_id", + json_key: "creatorUserId", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_creator_time", + json_key: "creatorTime", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_delete_mark", + json_key: "deleteMark", + default: Some("0"), + numeric: false, + }, +]; + +/// `demo_item` 的 spec。 +pub const DEMO_SPEC: EntitySpec = EntitySpec { + app_code: "demo", + entity: "DemoItem", + table: "demo_item", + module_key: None, + columns: DEMO_COLUMNS, + numeric_columns: &[], + creator_fixed: Some("admin"), +}; + +/// 本包的内置菜单。 +/// +/// 🔴 `url_address` 与 [`DEMO_SPEC`] 的 `module_key` 必须**一字不差** +/// (面 A 的菜单守卫靠它命中);`module_key: None` 的包(如 demo)走「仅登录」。 +pub const DEMO_MENU: MenuSpec = MenuSpec { + id: "m_demo", + full_name: "Demo 示例", + en_code: "permission.demo", + url_address: "demo-item", + parent_id: "0", + menu_type: 2, + icon: Some("app"), + sort_code: 6, + // 🔴 字面量而非引用内核常量:业务包不许依赖内核(AR2)。 + // `mainSystem` 是基线平台的官方常量值,属于契约字面量,可以写死。 + system_en_code: "mainSystem", +}; + +/// 包清单(与 `pack.toml` 的 `[pack]` 段一致)。 +const MANIFEST: Manifest = Manifest { + app_code: "demo", + name: "Demo 示例", + version: "1.0.0", + kernel_req: ">=0.4,<0.5", + migratable: true, +}; + +// ---------------------------------------------------------------- 路由声明 +// +// 🔴 **面 B 必须是官方 RESTful 形状**:`GET/POST /api/{模块}/{资源}` + +// `DELETE /api/{模块}/{资源}/{id}` —— **不是**面 A 的 `/api/ssw/...`。 +// 面 A 由内核的 `src/backend/src/modules/demo.rs` 提供(本仓自造约定)。 +// +// 🔴 **路由是「声明」,不是 handler** —— `PackRoute` 里没有 axum 类型 +// ⇒ 业务包不需要依赖 axum;内核按声明 + spec 生成真正的 handler +// (`sspf_core::crud::crud_router`)。 +// 🔴 **面 B 的守卫是 `Login`**:官方对 demo 这种「示例/工具类」端点不打 +// `@SaCheckPermission` ⇒ 登录即可。 + +/// `GET /api/demo/DemoItem` —— 列表。 +pub const DEMO_LIST_ROUTE: PackRoute = PackRoute { + path: "/api/demo/DemoItem", + method: HttpMethod::Get, + entity: "DemoItem", + action: RouteAction::List, + guard: RouteGuard::Login, +}; + +/// `POST /api/demo/DemoItem` —— 新建 / 更新(body 里带 `id` 就是更新)。 +pub const DEMO_SAVE_ROUTE: PackRoute = PackRoute { + path: "/api/demo/DemoItem", + method: HttpMethod::Post, + entity: "DemoItem", + action: RouteAction::Save, + guard: RouteGuard::Login, +}; + +/// `DELETE /api/demo/DemoItem/{id}` —— 软删。 +pub const DEMO_DELETE_ROUTE: PackRoute = PackRoute { + path: "/api/demo/DemoItem/{id}", + method: HttpMethod::Delete, + entity: "DemoItem", + action: RouteAction::Delete, + guard: RouteGuard::Login, +}; + +/// 本包声明的全部路由(每条实体恰好 3 条 —— 内核的装载自检钉住这个数)。 +pub const DEMO_ROUTES: &[PackRoute] = &[ + DEMO_LIST_ROUTE, + DEMO_SAVE_ROUTE, + DEMO_DELETE_ROUTE, +]; + +/// 业务包本体。 +/// +/// 🔴 **类型名固定为 `Pack`** —— 内核的 `packs_gen.rs` 是生成的, +/// 生成器按 `sspf_pack_::Pack` 拼路径 ⇒ 每个包都用同一个名字。 +pub struct Pack; + +impl BusinessPack for Pack { + fn manifest(&self) -> &'static Manifest { + &MANIFEST + } + + fn entities(&self) -> &'static [EntitySpec] { + &[DEMO_SPEC] + } + + fn menus(&self) -> &'static [MenuSpec] { + &[DEMO_MENU] + } + + fn routes(&self) -> &'static [PackRoute] { + DEMO_ROUTES + } +} + +#[cfg(test)] +mod tests { + use super::*; + + /// 列名全部 `f_` 前缀,且第一列是 `f_id`(响应键序的第一位)。 + #[test] + fn columns_are_prefixed_and_have_id() { + assert_eq!(DEMO_COLUMNS[0].column, "f_id"); + for c in DEMO_COLUMNS { + assert!(c.column.starts_with("f_"), "列名必须 f_ 前缀: {}", c.column); + } + } + + /// spec 的 `module_key` 与菜单 `url_address` 一致(`None` 的包只校验菜单本身)。 + #[test] + fn module_key_matches_menu_url_address() { + match DEMO_SPEC.module_key { + Some(key) => assert_eq!(key, DEMO_MENU.url_address), + None => assert_eq!(DEMO_MENU.url_address, "demo-item"), + } + } + + /// 路由条数固定 3(List / Save / Delete)—— 少一条 ⇒ 某动作静默 404。 + #[test] + fn declares_exactly_three_routes() { + assert_eq!(DEMO_ROUTES.len(), 3); + } +} diff --git a/packs/shop/Cargo.toml b/packs/shop/Cargo.toml new file mode 100644 index 0000000..ff198f0 --- /dev/null +++ b/packs/shop/Cargo.toml @@ -0,0 +1,11 @@ +[package] +name = "sspf-pack-shop" +version.workspace = true +edition.workspace = true +rust-version.workspace = true + +# 🔴 AR2:业务包只允许依赖 `sspf-sdk`(+ serde)。 +# 出现 axum / tokio / pglite ⇒ `check-arch.sh` 直接红。 +# 这是「整目录可搬走」的技术保证。 +[dependencies] +sspf-sdk = { path = "../../crates/sspf-sdk" } diff --git a/packs/shop/pack.toml b/packs/shop/pack.toml new file mode 100644 index 0000000..a9e998b --- /dev/null +++ b/packs/shop/pack.toml @@ -0,0 +1,31 @@ +# 业务包清单 —— **示例包**(可整目录搬走,技能带它当样板)。 +# 🔴 本文件不是给 cargo 读的,是给 `sspf pack export/import` 与内核装载器读的。 + +[pack] +app_code = "shop" +name = "产品管理" +version = "1.0.0" +kernel = ">=0.4,<0.5" # 契约版本区间(不是 cargo 版本,见 bootstrap::kernel_version) +migratable = true # 允许导出到基线平台 + +[pack.compat] +baseline = "react-demo" # 对齐基准 +frontend = "vue3" # 前端族(决定表单 JSON 方言) +tenant = false # 本期单租户(列仍带 f_tenant_id,见 DDL 注释) + +# 物理表:name = 本平台表名;baseline_table = 基线平台上的表名(导出时映射) +[[pack.tables]] +name = "shop_product" +ddl = "schema/001_init.sql" +baseline_table = "shop_product" + +[pack.metadata] +# 低代码元数据(与基线平台 visualdev 同构的 JSON)。纯手写 spec ⇒ 留空。 +forms = [] +models = [] +menus = [] +flows = [] + +[pack.build] +# 纯元数据包(L0):无 Rust 代码要编译,spec 直接链进内核。 +kind = "none" diff --git a/packs/shop/schema/001_init.sql b/packs/shop/schema/001_init.sql new file mode 100644 index 0000000..e8be836 --- /dev/null +++ b/packs/shop/schema/001_init.sql @@ -0,0 +1,29 @@ +-- shop_product —— 产品管理(业务包自带的 DDL)。 +-- +-- 🔴 **DDL 跟着包走**:本文件在 `packs/shop/schema/` 下,由 `packs/shop/src/lib.rs` +-- 用 `include_str!` **编译进二进制** ⇒ 内核启动时按包顺序幂等执行 +-- ⇒ 不再手抄进 `db/schema.sql`。 +-- +-- 🔴 **列名 / 列序逐字对齐 react 版 TypeORM entity**(`shop.entity.ts`)—— +-- 这是「两版后端能开同一个库」的前提 ⇒ **业务列一个都不许改名**。 +-- +-- 🔴 **2026-11-04 的两处差异**(搬成包时按平台规则补的,见 `HANDOFF.md`): +-- ① 追加 `f_tenant_id`(`DEFAULT '0' NOT NULL`)并进入复合主键 —— +-- 包 DDL 的硬闸门(`bootstrap::pack_ddls_carry_tenant_id_and_composite_key`) +-- 要求每张业务表都带它;react 侧不认识这一列,但读不读都行、写不写都行 +-- (有默认值),⇒ 同库兼容性仍然成立; +-- ② `f_id` 从 `PRIMARY KEY` 改成 `NOT NULL` + 末尾复合主键。 +-- 🔴 **spec 的列清单没有加 `f_tenant_id`** ⇒ 面 A / 面 B 的 JSON 键与响应**零变化**。 +-- +-- 🔴 **本文件只许建本包自己的表**,**不许建 `base_*`**(装载器会拦)。 + +CREATE TABLE IF NOT EXISTS shop_product ( + f_id VARCHAR(50) NOT NULL, + f_title VARCHAR(255), + f_price NUMERIC(12,2), + f_creator_user_id VARCHAR(50), + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_mark INTEGER DEFAULT 0, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); diff --git a/packs/shop/src/lib.rs b/packs/shop/src/lib.rs new file mode 100644 index 0000000..f1b3d62 --- /dev/null +++ b/packs/shop/src/lib.rs @@ -0,0 +1,206 @@ +//! shop —— 产品管理业务包(**示例包**)。 +//! +// 🔴 **本包是「示例」,不是业务真源**:它演示「一个业务包只依赖 `sspf-sdk` +//! 就能声明完整的业务(表 + 列 + 菜单 + 面 B 路由)」。 +//! 技能把这套示例带走时,**整个 `packs/shop` 目录一起搬**即可 —— 内核零改动。 +//! +//! 🔴 **依赖纪律(AR2)**:只允许 `sspf-sdk`。出现 axum / tokio / pglite +//! ⇒ `check-arch.sh` 直接红 —— 这是「整目录可搬走」的技术保证。 +//! 🔴 **守卫**:菜单 `shop/Product`(`module_key`)⇒ 非管理员未授权 ⇒ `code=403`。 +//! 🔴 `f_price` 是 **numeric**(JSON 字符串 `"9.90"`)⇒ 进 `numeric_columns`。 +//! +//! 🔴 **DDL 跟着包走**:`schema/001_init.sql` 用 `include_str!` 编译进二进制, +//! 内核启动时幂等执行 ⇒ 不再手抄进 `db/schema.sql`。 + +use sspf_sdk::{ + BusinessPack, ColumnSpec, EntitySpec, HttpMethod, Manifest, MenuSpec, PackRoute, RouteAction, + RouteGuard, +}; + +/// 🔴 **本包自带的 DDL**(编译进二进制 ⇒ 包目录可整目录搬走)。 +pub const PRODUCT_DDL: &str = include_str!("../schema/001_init.sql"); + +/// 🔴 **包的统一 DDL 出口**(`表名 → DDL 文本`)—— 内核**只认这一种写法**。 +/// 常量名固定、形状固定 ⇒ 内核/生成器可以无脑遍历(加包不用改内核)。 +pub const DDLS: &[(&str, &str)] = &[("shop_product", PRODUCT_DDL)]; + +/// `shop_product` 的列清单(**顺序 = 响应 JSON 的键序**)。 +/// +/// 🔴 **不含 `f_tenant_id`**:该列在 DDL 里(平台硬要求),但不进投影 / 不进出参 +/// ⇒ 响应形状与面 A 的历史行为**逐字不变**(`db/schema.sql` 时代的 JSON 长什么样, +/// 现在还是什么样)。 +const PRODUCT_COLUMNS: &[ColumnSpec] = &[ + ColumnSpec { + column: "f_id", + json_key: "id", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_title", + json_key: "title", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_price", + json_key: "price", + default: Some("0.00"), + numeric: true, + }, + ColumnSpec { + column: "f_creator_user_id", + json_key: "creatorUserId", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_creator_time", + json_key: "creatorTime", + default: None, + numeric: false, + }, + ColumnSpec { + column: "f_delete_mark", + json_key: "deleteMark", + default: Some("0"), + numeric: false, + }, +]; + +/// `shop_product` 的 spec。 +pub const PRODUCT_SPEC: EntitySpec = EntitySpec { + app_code: "shop", + entity: "Product", + table: "shop_product", + module_key: Some("shop/Product"), + columns: PRODUCT_COLUMNS, + numeric_columns: &["f_price"], + creator_fixed: None, +}; + +/// 本包的内置菜单。 +/// +/// 🔴 `url_address` 与 [`PRODUCT_SPEC`] 的 `module_key` 必须**一字不差** +/// (面 A 的菜单守卫靠它命中);`module_key: None` 的包(如 demo)走「仅登录」。 +pub const PRODUCT_MENU: MenuSpec = MenuSpec { + id: "m_product", + full_name: "产品管理", + en_code: "permission.shop.product", + url_address: "shop/Product", + parent_id: "0", + menu_type: 2, + icon: Some("app"), + sort_code: 7, + // 🔴 字面量而非引用内核常量:业务包不许依赖内核(AR2)。 + // `mainSystem` 是基线平台的官方常量值,属于契约字面量,可以写死。 + system_en_code: "mainSystem", +}; + +/// 包清单(与 `pack.toml` 的 `[pack]` 段一致)。 +const MANIFEST: Manifest = Manifest { + app_code: "shop", + name: "产品管理", + version: "1.0.0", + kernel_req: ">=0.4,<0.5", + migratable: true, +}; + +// ---------------------------------------------------------------- 路由声明 +// +// 🔴 **面 B 必须是官方 RESTful 形状**:`GET/POST /api/{模块}/{资源}` + +// `DELETE /api/{模块}/{资源}/{id}` —— **不是**面 A 的 `/api/ssw/...`。 +// 面 A 由内核的 `src/backend/src/modules/shop.rs` 提供(本仓自造约定)。 +// +// 🔴 **路由是「声明」,不是 handler** —— `PackRoute` 里没有 axum 类型 +// ⇒ 业务包不需要依赖 axum;内核按声明 + spec 生成真正的 handler +// (`sspf_core::crud::crud_router`)。 +// 🔴 **面 B 的判据 = 点权限(`f_en_code`)** —— 官方 `@SaCheckPermission` 那套; +// 面 A 的菜单路径(`f_url_address`)是另一套判据 ⇒ 两套并存,互不影响。 + +/// `GET /api/shop/Product` —— 列表。 +pub const PRODUCT_LIST_ROUTE: PackRoute = PackRoute { + path: "/api/shop/Product", + method: HttpMethod::Get, + entity: "Product", + action: RouteAction::List, + guard: RouteGuard::EnCode("permission.shop.product"), +}; + +/// `POST /api/shop/Product` —— 新建 / 更新(body 里带 `id` 就是更新)。 +pub const PRODUCT_SAVE_ROUTE: PackRoute = PackRoute { + path: "/api/shop/Product", + method: HttpMethod::Post, + entity: "Product", + action: RouteAction::Save, + guard: RouteGuard::EnCode("permission.shop.product"), +}; + +/// `DELETE /api/shop/Product/{id}` —— 软删。 +pub const PRODUCT_DELETE_ROUTE: PackRoute = PackRoute { + path: "/api/shop/Product/{id}", + method: HttpMethod::Delete, + entity: "Product", + action: RouteAction::Delete, + guard: RouteGuard::EnCode("permission.shop.product"), +}; + +/// 本包声明的全部路由(每条实体恰好 3 条 —— 内核的装载自检钉住这个数)。 +pub const PRODUCT_ROUTES: &[PackRoute] = &[ + PRODUCT_LIST_ROUTE, + PRODUCT_SAVE_ROUTE, + PRODUCT_DELETE_ROUTE, +]; + +/// 业务包本体。 +/// +/// 🔴 **类型名固定为 `Pack`** —— 内核的 `packs_gen.rs` 是生成的, +/// 生成器按 `sspf_pack_::Pack` 拼路径 ⇒ 每个包都用同一个名字。 +pub struct Pack; + +impl BusinessPack for Pack { + fn manifest(&self) -> &'static Manifest { + &MANIFEST + } + + fn entities(&self) -> &'static [EntitySpec] { + &[PRODUCT_SPEC] + } + + fn menus(&self) -> &'static [MenuSpec] { + &[PRODUCT_MENU] + } + + fn routes(&self) -> &'static [PackRoute] { + PRODUCT_ROUTES + } +} + +#[cfg(test)] +mod tests { + use super::*; + + /// 列名全部 `f_` 前缀,且第一列是 `f_id`(响应键序的第一位)。 + #[test] + fn columns_are_prefixed_and_have_id() { + assert_eq!(PRODUCT_COLUMNS[0].column, "f_id"); + for c in PRODUCT_COLUMNS { + assert!(c.column.starts_with("f_"), "列名必须 f_ 前缀: {}", c.column); + } + } + + /// spec 的 `module_key` 与菜单 `url_address` 一致(`None` 的包只校验菜单本身)。 + #[test] + fn module_key_matches_menu_url_address() { + match PRODUCT_SPEC.module_key { + Some(key) => assert_eq!(key, PRODUCT_MENU.url_address), + None => assert_eq!(PRODUCT_MENU.url_address, "shop/Product"), + } + } + + /// 路由条数固定 3(List / Save / Delete)—— 少一条 ⇒ 某动作静默 404。 + #[test] + fn declares_exactly_three_routes() { + assert_eq!(PRODUCT_ROUTES.len(), 3); + } +} diff --git a/run.sh b/run.sh index c7d55b4..8c6fc9b 100755 --- a/run.sh +++ b/run.sh @@ -1,5 +1,5 @@ #!/usr/bin/env bash -# ssw-platform 一键脚本 +# ssw-platform 一键脚本(后端二进制 = `sspf-admin` 默认装配) # # 后端 = Rust 单二进制(cargo workspace 根 = 仓库根 ⇒ target/ 在仓库根)。 # 数据库为嵌入式 pglite-rs(进程内原生 PostgreSQL),零服务 / 零 Docker / 零 WASM。 @@ -29,7 +29,7 @@ FRONTEND_PORT=5173 # 🔴 kill_ports 用的是 kill -9 ⇒ 端口列表**只能是本仓自己的这两个端口**。 # 不许把兄弟项目 tdc-rs 的端口写进来(打死它就是破坏兄弟项目)。 -BACKEND_BIN="$ROOT/target/release/ssw-platform" +BACKEND_BIN="$ROOT/target/release/sspf-admin" # 加载项目根 .env(后端不 import dotenv,靠这里把 PORT / PGLITE_DIR 导出给子进程) if [ -f "$ROOT/.env" ]; then @@ -121,9 +121,9 @@ wait_frontend_ready() { } # 用 PID 文件优雅停(先 SIGTERM,宽限期内还在才 SIGKILL),清理 root 进程树 -# 🔴 宽限期**可按进程给**:后端的优雅停机要「关嵌入式 PostgreSQL」(main.rs 给 PG 的预算是 3 秒), +# 🔴 宽限期**可按进程给**:后端的优雅停机要「关嵌入式 PostgreSQL」(crates/sspf-admin/src/main.rs 给 PG 的预算是 3 秒), # 若这里只等 1 秒就 SIGKILL ⇒ 正好把 M-9 要修的「PG 被 SIGKILL 打断 ⇒ crash recovery」又打回来。 -# ⇒ 后端给 3 秒(与 main.rs 的预算对齐);前端(npm/vite)1 秒足够。 +# ⇒ 后端给 3 秒(与 crates/sspf-admin/src/main.rs 的预算对齐);前端(npm/vite)1 秒足够。 stop_pid() { local f="$1" grace="${2:-1}" [ -f "$f" ] || return 0 @@ -189,7 +189,7 @@ case "${1:-}" in mkdir -p "$LOGS" "$RUN" # 🔴 后端 cwd = 仓库根(dir=".")⇒ 相对路径的 PGLITE_DIR 也落在仓库内。 # 🔴 命令行**不带** PORT= 前缀 —— PORT 已由 .env / export 导出,子进程继承。 - start_logged . "./target/release/ssw-platform" backend + start_logged . "./target/release/sspf-admin" backend start_logged src/frontend "npm run dev" frontend # 🔴 就绪校验:后端没真正起来 ⇒ **不许**报成功。 if ! wait_backend_ready; then @@ -239,7 +239,7 @@ case "${1:-}" in fi kill_ports "$BACKEND_PORT" # 🔴 用 exec ⇒ 后端**自己的**退出码原样透传(本仓二进制 panic 时是 101,不是 1)。 - (cd "$ROOT" && exec ./target/release/ssw-platform) + (cd "$ROOT" && exec ./target/release/sspf-admin) ;; frontend) kill_ports "$FRONTEND_PORT" @@ -258,9 +258,11 @@ case "${1:-}" in # 只匹配后端本体的完整路径(cargo/rustc 的 argv 里是目录名与下划线形式,都不匹配)。 # 🔴 vite **不**用 pkill 收 —— 它由上面的 kill_ports 5173 按**端口**收, # 不会误杀别的项目的 vite dev server。 - pkill -f "target/release/ssw-platform" 2>/dev/null || true - # 🔴 旧名兜底:名称历经 `tds-lite-rs` → `ssw-jnpf-lite-rust` → `ssw-platform`, + pkill -f "target/release/sspf-admin" 2>/dev/null || true + # 🔴 旧名兜底:名称历经 `tds-lite-rs` → `ssw-jnpf-lite-rust` → `ssw-platform` + # → **`sspf-admin`**(2026-11-04 默认装配独立成 crate,bin 名随之改), # 改名之前起的后端进程不会被上一行 pkill 匹配到 ⇒ 这里补收一次。 + pkill -f "target/release/ssw-platform" 2>/dev/null || true pkill -f "target/release/tds-lite-rs" 2>/dev/null || true echo "stopped" ;; diff --git a/scripts/baseline-smoke.sh b/scripts/baseline-smoke.sh index 56d6257..118d7df 100755 --- a/scripts/baseline-smoke.sh +++ b/scripts/baseline-smoke.sh @@ -27,8 +27,8 @@ cd "$ROOT" || exit 1 PORT="${1:-30993}" # 优先 debug(开发期常用),回落到 release -BIN="$ROOT/target/debug/ssw-platform" -[ -x "$BIN" ] || BIN="$ROOT/target/release/ssw-platform" +BIN="$ROOT/target/debug/sspf-admin" +[ -x "$BIN" ] || BIN="$ROOT/target/release/sspf-admin" PROBE="$ROOT/target/debug/examples/probe" [ -x "$PROBE" ] || PROBE="$ROOT/target/release/examples/probe" diff --git a/scripts/check-arch.sh b/scripts/check-arch.sh index 709f553..4e014fd 100755 --- a/scripts/check-arch.sh +++ b/scripts/check-arch.sh @@ -48,6 +48,10 @@ # 且 `src/backend/src/platform/` 目录不许存在 # —— M7 删掉了 38 个转发壳;重建壳 + 改回 import 会**一切照常编译、测试全绿** # ⇒ 没有这条闸门,M2–M7 的架构收益会**静默蒸发** +# AR16 内核只有 lib(`src/backend/Cargo.toml` 不许 `[[bin]]`)、集成测试不许回流 +# 到 `src/backend/tests/`、`crates/sspf-admin` 必须存在且产出 bin +# —— 「内核是库、装配是应用、测试是消费者」这三条边界都是**文件位置** +# ⇒ 没有任何编译错误会提示你踩线,只有结构慢慢退回原样 # # 🔴 AR1–AR5 是 PLAN.md §3.2 的分层纪律;MEM1–MEM2 是判断 ⑥ 的四条内存红线的静态部分。 @@ -454,7 +458,7 @@ check_ar13() { # **MCP 适配层的依赖白名单**(M6 把 `mcp_{adapter,compat}.rs` 下沉到 `sspf-mcp-adapter`)。 # # 🔴 **为什么需要**:`sspf-mcp-adapter` 是**全仓唯一「知道全部包」的 crate** —— -# `mcp_compat.rs` 直调 workflow / system / permission / online_dev 四个契约面域包 +# `mcp_compat.rs` 直调 workflow / system / permission / onlinedev 四个契约面域包 # 的 handler ⇒ 依赖图上它是**顶层汇聚点**。 # 这本身**不是环**(被依赖方谁都不认识它 ⇒ 方向单一),但它有两个真实风险: # ① 依赖面失控 —— 一旦拖进业务包(`sspf_pack_*`),适配层就开始认识业务 @@ -480,7 +484,7 @@ check_ar14() { # + 契约面四个域包(handler 直调对象)+ 低代码两层(动态 CRUD 工具) # + axum(handler 的 extractor / 信封)+ pglite-rs(ToSql 参数绑定)+ 序列化。 # **不许** sspf_pack_*(业务包)/ sspf-contract(间接依赖即可)/ sspf-plugin。 - if subset_of "$deps" "sspf-mcp sspf-core sspf-compat-system sspf-compat-permission sspf-compat-workflow sspf-compat-online_dev sspf-lowcode sspf-lowcode-exec axum pglite-rs serde_json serde_urlencoded"; then + if subset_of "$deps" "sspf-mcp sspf-core sspf-compat-system sspf-compat-permission sspf-compat-workflow sspf-compat-onlinedev sspf-lowcode sspf-lowcode-exec axum pglite-rs serde_json serde_urlencoded"; then ok "AR14 sspf-mcp-adapter 依赖干净([$deps])" else bad "AR14 sspf-mcp-adapter 依赖越界:[$deps] —— 只许 {mcp, core, compat-*, lowcode*, axum, pglite-rs, serde*}" @@ -702,12 +706,63 @@ PY fi } +# ---------------------------------------------------------------- AR16 +# **内核只是库,可执行的装配只有一个,集成测试不挂在内核包里**(2026-11-04 定)。 +# +# 🔴 **为什么需要**:这三件事在 2026-11-04 之前是**反的**,而且没有任何闸门会红: +# ① `src/backend` 自带 `[[bin]]` ⇒ 内核既是库又是服务器。谁想复用内核 +# (CLI / MCP 适配器 / 另一个应用 / 测试)都得连带享受一份「启动即开库、 +# 即绑端口」的语义;`cargo add` 一个库顺带下载一个服务器。 +# ② 37 个集成测试(`*_it.rs`)摆在 `src/backend/tests/` ⇒ 它们测的是 +# 「装配好的平台」(内核 + 契约面 + 业务包 + 路由),却被登记成**内核的实现细节**: +# 内核改一次名/拆一次包,37 个文件跟着搬(历史上真搬过 3 次)。 +# ③ 于是「默认装配」散落在各处:进程级的事(读环境变量 / 开库 / 种子 / 绑端口 / +# 优雅停机)写在 `main.rs` 里,而 `main.rs` 在内核包里 ⇒ 没有一个地方叫「应用」。 +# ⇒ 现在:内核 = lib;`crates/sspf-admin` = 默认装配(bin);`crates/tests` = 测试宿主。 +# +# 判据: +# ① `src/backend/Cargo.toml` 里**不许**有 `[[bin]]`; +# ② `src/backend/tests/` 里**不许**有 `.rs`(测试宿主在 `crates/tests/tests/`); +# ③ `crates/sspf-admin/Cargo.toml` **必须存在**且声明 `[[bin]]`(默认装配不许被删)。 +check_ar16() { + local hits="" + local kernel_toml="$KERNEL/Cargo.toml" + if [ -f "$kernel_toml" ]; then + local binln + binln="$(grep -nE '^\[\[bin\]\]' "$kernel_toml" 2>/dev/null | head -1)" + if [ -n "$binln" ]; then + hits="src/backend/Cargo.toml:${binln%%:*}: 内核声明了 [[bin]](内核只能是 lib ⇒ 装配归 crates/sspf-admin)" + fi + fi + # ⚠️ 只看「有 .rs 文件」:git 不跟踪空目录 ⇒ 空目录残留不算违规(与 AR15 同款)。 + if [ -d "$KERNEL/tests" ]; then + local trs + trs="$(find "$KERNEL/tests" -name '*.rs' -type f 2>/dev/null | head -3)" + if [ -n "$trs" ]; then + hits="${hits:+$hits$'\n'}src/backend/tests: 集成测试回到了内核包(宿主是 crates/tests/tests/):$(printf '%s' "$trs" | tr '\n' ' ')" + fi + fi + local admin="$CRATES/sspf-admin/Cargo.toml" + if [ ! -f "$admin" ]; then + hits="${hits:+$hits$'\n'}crates/sspf-admin/Cargo.toml: 不存在(默认装配缺失 ⇒ 全仓没有可执行入口)" + elif ! grep -qE '^\[\[bin\]\]' "$admin" 2>/dev/null; then + hits="${hits:+$hits$'\n'}crates/sspf-admin/Cargo.toml: 没有 [[bin]](默认装配必须产出可执行文件)" + fi + + if [ -z "$hits" ]; then + ok "AR16 内核只有 lib + 默认装配在 crates/sspf-admin + 集成测试在 crates/tests" + else + bad "AR16 内核/装配/测试的边界被打破:" + printf '%s\n' "$hits" | sed 's/^/ /' + fi +} + # ---------------------------------------------------------------- 反自证 # 🔴 永远返回「干净」的尺子 = 没有尺子。造明知违规的输入,必须被抓到。 self_test() { local rc=0 - echo "── 反自证 1/10:造一个依赖越界的假 pack,AR2 必须报 ❌ ──" + echo "── 反自证 1/11:造一个依赖越界的假 pack,AR2 必须报 ❌ ──" local tmp="$ROOT/packs/__arch_selftest__" mkdir -p "$tmp" cat > "$tmp/Cargo.toml" <<'TOML' @@ -733,7 +788,7 @@ TOML rc=1 fi - echo "── 反自证 2/10:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──" + echo "── 反自证 2/11:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──" # # 🔴 **为什么必须自证 AR9**:它的判据是 `grep 目录`。 # 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"**。 @@ -772,7 +827,7 @@ TOML rc=1 fi - echo "── 反自证 3/10:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──" + echo "── 反自证 3/11:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──" # # 🔴 造在**临时模块文件**上(不动真文件):只要它同时有 `pub use sspf_pack_` # 和 `= EntitySpec {`,PACK1 就必须红。 @@ -798,7 +853,7 @@ RS echo "⏭ 跳过 PACK1 反自证(业务模块目录不存在)" fi - echo "── 反自证 4/10:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──" + echo "── 反自证 4/11:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──" local pfile="$CRATES/sspf-plugin/Cargo.toml" if [ -f "$pfile" ]; then cp "$pfile" "$pfile.bak" @@ -819,7 +874,7 @@ RS echo "⏭ 跳过 AR8 反自证(sspf-plugin 不存在)" fi - echo "── 反自证 5/10:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──" + echo "── 反自证 5/11:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──" # # 🔴 **必须自证 AR10**:它的判据是「扫平台层目录找契约面引用」。 # 目录名写错 / 路径拼错 ⇒ 扫描永远返回空 ⇒ **永远"通过"** ⇒ 虚假安全感。 @@ -855,7 +910,7 @@ RS rc=1 fi - echo "── 反自证 6/10:往契约面底座塞 use super::system,AR11 必须报 ❌ ──" + echo "── 反自证 6/11:往契约面底座塞 use super::system,AR11 必须报 ❌ ──" # # 🔴🔴 **M7 起底座只有一处**:真源 `crates/sspf-compat-core/src/helper.rs` # (转发壳 `src/backend/src/platform/compat/helper.rs` 已随 M7 删除)。 @@ -878,7 +933,7 @@ RS rc=1 fi - echo "── 反自证 7/10:往壳里写 crate::platform::,AR15 必须报 ❌ ──" + echo "── 反自证 7/11:往壳里写 crate::platform::,AR15 必须报 ❌ ──" # # 🔴 **必须自证 AR15**:删掉 `platform/` 转发壳之后,旧路径就**没有编译器**兜底了 # —— 只要有人重建壳目录并把 import 改回去,**一切照常编译、测试照常全绿**, @@ -889,12 +944,16 @@ RS # ③ 重建 `src/backend/src/platform/` 目录 ⇒ 目录级判据要抓到。 local a15ok=0 local a15probe="$KERNEL/src/__ar15_selftest.rs" - local a15test="$KERNEL/tests/__ar15_selftest.rs" + # 🔴 **2026-11-04 起集成测试宿主在 `crates/tests/tests/`**(AR16)—— + # 探针必须打在**真在扫描面里**的目录上:AR15 的 roots 含 `$CRATES`, + # 所以打到 `crates/tests/tests/` 才证明「测试里的旧路径也被抓」。 + local a15testdir="$ROOT/crates/tests/tests" + local a15test="$a15testdir/__ar15_selftest.rs" local a15dir="$KERNEL/src/platform" local a15had_dir=0 [ -d "$a15dir" ] && a15had_dir=1 printf 'use crate::platform::sys::user_list;\n' > "$a15probe" - printf 'use ssw_platform::platform::db::Db;\n' > "$a15test" + [ -d "$a15testdir" ] && printf 'use ssw_platform::platform::db::Db;\n' > "$a15test" mkdir -p "$a15dir" printf '//! 探针\n' > "$a15dir/__ar15_selftest.rs" local a15out @@ -916,7 +975,7 @@ RS rc=1 fi - echo "── 反自证 8/10:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──" + echo "── 反自证 8/11:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──" # # 🔴 **为什么必须自证 AR12**:它的判据是「读 Cargo.toml 找 sspf-compat-* 依赖」。 # 若 grep 模式写错(包名含连字符/下划线混用)⇒ 永远扫不到依赖 ⇒ @@ -943,7 +1002,7 @@ RS rc=1 fi - echo "── 反自证 9/10:给执行层塞一个越界依赖 + 一条业务包引用,AR13 必须报 ❌ ──" + echo "── 反自证 9/11:给执行层塞一个越界依赖 + 一条业务包引用,AR13 必须报 ❌ ──" # # 🔴 **必须自证 AR13**:它的判据是「读 Cargo.toml + grep 源码」。 # 两种失效模式都得堵: @@ -976,7 +1035,7 @@ RS rc=1 fi - echo "── 反自证 10/10:给适配层塞一个越界依赖 + 一条业务包引用,AR14 必须报 ❌ ──" + echo "── 反自证 10/11:给适配层塞一个越界依赖 + 一条业务包引用,AR14 必须报 ❌ ──" # # 🔴 **必须自证 AR14**:它是 M6 新增的判据,守护的是「全仓唯一知道全部包的 # 汇聚点」的依赖面。两种失效模式都得堵: @@ -1009,6 +1068,40 @@ RS rc=1 fi + echo "── 反自证 11/11:内核加回 [[bin]] + 塞回 tests/*.rs,AR16 必须两处都报 ❌ ──" + # + # 🔴 **必须自证 AR16**:它的三条判据全是「文件/目录在不在」—— + # 路径写错(比如把 $KERNEL 拼成别的名字)⇒ 永远判「没问题」⇒ + # 结构会静默退回到 2026-11-04 之前的样子(内核自带 bin、测试挂内核包)。 + # ⇒ 两处都注入、两处都被抓到才算尺子有效。 + local a16ok=0 + local a16toml="$KERNEL/Cargo.toml" + local a16dir="$KERNEL/tests" + local a16need=0 a16c=0 a16before a16out="" + if [ -f "$a16toml" ]; then + a16before=$FAIL + cp "$a16toml" "$a16toml.bak" + printf '\n[[bin]]\nname = "__ar16_selftest"\npath = "src/lib.rs"\n' >> "$a16toml" + a16need=$((a16need + 1)) + mkdir -p "$a16dir" + printf '// AR16 自证用,跑完即删\n' > "$a16dir/__ar16_selftest.rs" + a16need=$((a16need + 1)) + a16out="$(check_ar16 2>&1 || true)" + [ -f "$a16toml.bak" ] && mv "$a16toml.bak" "$a16toml" + rm -f "$a16dir/__ar16_selftest.rs" + rmdir "$a16dir" 2>/dev/null || true + FAIL=$a16before + echo "$a16out" | grep -qF '内核声明了 [[bin]]' && a16c=$((a16c + 1)) + echo "$a16out" | grep -qF '集成测试回到了内核包' && a16c=$((a16c + 1)) + [ "$a16need" -gt 0 ] && [ "$a16c" -ge "$a16need" ] && a16ok=1 + fi + if [ "$a16ok" -eq 1 ]; then + echo "✅ 反自证通过:AR16 抓到了内核里的 [[bin]] 与回流的 tests/*.rs" + else + echo "❌ 反自证失败:AR16 没抓到内核 [[bin]] / 回流的 tests(或漏判了其中一处)⇒ 尺子是假的" + rc=1 + fi + return $rc } @@ -1031,6 +1124,7 @@ check_ar12 check_ar13 check_ar14 check_ar15 +check_ar16 check_pack1 check_mem1 check_mem2 diff --git a/scripts/check-contract-scan.py b/scripts/check-contract-scan.py index c1132fa..727fb26 100644 --- a/scripts/check-contract-scan.py +++ b/scripts/check-contract-scan.py @@ -44,7 +44,7 @@ import contract_expect # noqa: E402 (同目录) ROUTE_CALL_RE = re.compile(r'\.route\(') # 路由后面的 handler 表达式:`sys::user_list` / `demo_item_list` / `|State(..)| ..`(闭包) # -# 🔴 **三段路径**(批次 17 补):`compat::online_dev::visual_dev_list` —— +# 🔴 **三段路径**(批次 17 补):`compat::onlinedev::visual_dev_list` —— # 契约面的实现按官方模块名分文件(`platform/compat/<模块>.rs`), # 路由注册时写成 `compat::<模块>::` ⇒ 只认**第一段**会拿到 # `compat`(一个目录,不是文件)⇒ 守卫推导**全部推不出**(静默失效)。 @@ -287,8 +287,8 @@ def scan_routes(path, owner): mod, fn, closure = None, None, True mod_path = None if hm and hm.group(3): - # 🔴 **三段路径**(批次 17 补):`compat::online_dev::visual_dev_list` - # ⇒ `mod_path` = `compat::online_dev`、`mod` = `online_dev` + # 🔴 **三段路径**(批次 17 补):`compat::onlinedev::visual_dev_list` + # ⇒ `mod_path` = `compat::onlinedev`、`mod` = `onlinedev` # (真正的文件名);两段 `sys::user_list` ⇒ `mod` = `sys`。 if hm.group(2): mod_path = "%s::%s" % (hm.group(1), hm.group(2)) @@ -388,10 +388,10 @@ def guard_of_platform(plat_files, mod, fn, mod_path=None, plat_consts=None): `plat_files` = {"sys": (orig, masked), "face_b": (orig, masked), ...} 🔴 **模块定位有两种形态**(批次 17 补): - - `mod_path` 是两段以上(`compat::online_dev`)⇒ 契约面实现文件在 + - `mod_path` 是两段以上(`compat::onlinedev`)⇒ 契约面实现文件在 `platform/compat/<模块>.rs` ⇒ key = `compat__<模块>`。 - `mod_path` 是一段(`sys`)⇒ 平台层根目录 `platform/<模块>.rs`。 - ⇒ 旧实现只拿 `mod` 查 ⇒ `online_dev` 找不到 `compat__online_dev` + ⇒ 旧实现只拿 `mod` 查 ⇒ `onlinedev` 找不到 `compat__onlinedev` ⇒ 守卫**全部推不出**(CC6 静默退化成全是 WARN)。 """ if mod == "auth" and fn == "login_handler": @@ -410,7 +410,7 @@ def guard_of_platform(plat_files, mod, fn, mod_path=None, plat_consts=None): return None return "无" # 🔴 **契约面实现文件**(批次 17 补):`platform/compat/<模块>.rs` —— - # key 形如 `compat__online_dev` ⇒ 与 `jnpf` / `face_b` **同一套**推导规则 + # key 形如 `compat__onlinedev` ⇒ 与 `jnpf` / `face_b` **同一套**推导规则 # (`guard` / `guard_any` / `require_login_face_b`)。 # # 🔴🔴 **M7 起:按「crate 名」判定,不再按「路径段数」猜**。 @@ -889,7 +889,7 @@ def scan_code(src_dir, packs_dir=None): p = os.path.join(core_dir, name) _absorb(name[:-3], read(p)) # 🔴 **契约面实现文件**(批次 17 补):`platform/compat/<模块>.rs` —— - # 契约面按官方模块名分文件(`online_dev.rs` / `report.rs` / `system.rs` …), + # 契约面按官方模块名分文件(`onlinedev.rs` / `report.rs` / `system.rs` …), # 路由注册写 `compat::<模块>::` ⇒ 这些文件**必须**进 `plat_files`, # 否则守卫推导**全部推不出**(CC6 退化成「全是 WARN」⇒ 静默失效)。 # 🔴 **M3 起契约面底座真源在 `crates/sspf-compat-core/src/`**(`helper.rs` 装守卫常量 @@ -1385,7 +1385,7 @@ def self_test(contract=None, src_dir=None, packs_dir=None): ("sspf_core::auth", "auth", "平台核心两段(auth)"), ("sspf_store::db", "db", "存储层两段"), ("compat::system", "compat__system", "契约面旧写法(compat::)"), - ("compat::online_dev", "compat__online_dev", "契约面旧写法(online_dev)"), + ("compat::onlinedev", "compat__onlinedev", "契约面旧写法(onlinedev)"), ("compat::helper", "compat__helper", "契约面底座(helper)"), ("sspf_compat_system::system", "compat__system", "契约面新写法(system)"), ("sspf_compat_system::scheduletask", "compat__scheduletask", "契约面新写法(scheduletask)"), @@ -1410,7 +1410,7 @@ def self_test(contract=None, src_dir=None, packs_dir=None): ("sys", "sspf_core::sys", "sys"), ("auth", "sspf_core::auth", "auth"), ("compat::system", "sspf_compat_system::system", "compat__system"), - ("compat::online_dev", "sspf_compat_online_dev::online_dev", "compat__online_dev"), + ("compat::onlinedev", "sspf_compat_onlinedev::onlinedev", "compat__onlinedev"), ("compat::helper", "sspf_compat_core::helper", "compat__helper"), ("compat::workflow", "sspf_compat_workflow::workflow", "compat__workflow"), ] diff --git a/scripts/lowcode-smoke.sh b/scripts/lowcode-smoke.sh index d97f43d..dd11648 100755 --- a/scripts/lowcode-smoke.sh +++ b/scripts/lowcode-smoke.sh @@ -32,8 +32,8 @@ set -u ROOT="$(cd "$(dirname "$0")/.." && pwd)" cd "$ROOT" || exit 1 -BIN="$ROOT/target/debug/ssw-platform" -[ -x "$BIN" ] || BIN="$ROOT/target/release/ssw-platform" +BIN="$ROOT/target/debug/sspf-admin" +[ -x "$BIN" ] || BIN="$ROOT/target/release/sspf-admin" FIX="$ROOT/crates/sspf-lowcode/tests/fixtures" if [ ! -x "$BIN" ]; then diff --git a/scripts/mcp-smoke.sh b/scripts/mcp-smoke.sh index e8b9c52..3828bf9 100755 --- a/scripts/mcp-smoke.sh +++ b/scripts/mcp-smoke.sh @@ -57,7 +57,7 @@ set -u ROOT="$(cd "$(dirname "$0")/.." && pwd)" -BIN="$ROOT/target/debug/ssw-platform" +BIN="$ROOT/target/debug/sspf-admin" PASS=0 FAIL=0 diff --git a/scripts/mem-budget.sh b/scripts/mem-budget.sh index 1a0efc3..400b512 100755 --- a/scripts/mem-budget.sh +++ b/scripts/mem-budget.sh @@ -22,7 +22,7 @@ set -u ROOT="$(cd "$(dirname "$0")/.." && pwd)" -BIN="$ROOT/target/release/ssw-platform" +BIN="$ROOT/target/release/sspf-admin" BUDGET_MB=40 PORT=30997 STARTUP_WAIT=25 diff --git a/scripts/pack-sync.py b/scripts/pack-sync.py index 970bfab..7db99b3 100755 --- a/scripts/pack-sync.py +++ b/scripts/pack-sync.py @@ -161,7 +161,17 @@ def gen_module_rows(packs): by_url = {m["urlAddress"]: m for m in p["menus"]} for e in p["entities"]: mk = e["module_key"] - menu = by_url.get(mk) if mk else None + # 🔴 **`module_key: None` 的包(如 demo)也要落 `urlAddress` / `menuId`**: + # 这类包「菜单有、守卫无」⇒ 按 `module_key` 查必然查不到, + # 但它声明的菜单就是自己的(通常恰好 1 条)⇒ 用它。 + # 以前这里直接给空串 ⇒ `check-boundary.sh` 的 CP6 会把 + # 「契约菜单 6 条 − 业务菜单 1 条」算错 ⇒ 假红(2026-11-04 踩过)。 + if mk: + menu = by_url.get(mk) + elif len(p["menus"]) == 1: + menu = p["menus"][0] + else: + menu = None rows.append([ e["app"], e["entity"], @@ -169,7 +179,12 @@ def gen_module_rows(packs): menu["urlAddress"] if menu else (mk or ""), mk if mk else "None", menu["id"] if menu else "", - "有", + # 🔴 `apiFile` = **真实存在性**,不是「包带来的都算有」: + # `check-module.sh` 的第 5 个接触点按这一列决定「缺文件算不算错」, + # 写死 `有` 会让没有 api 层的模块(demo 就是)**假红**(2026-11-04 踩过)。 + "有" if os.path.isfile( + os.path.join(ROOT, "src", "frontend", "src", "api", "%s.ts" % e["entity"].lower()) + ) else "无", "%s.rs" % p["app"], ]) return rows diff --git a/scripts/perm-smoke-jnpf.sh b/scripts/perm-smoke-jnpf.sh index 62719b8..9d23e03 100644 --- a/scripts/perm-smoke-jnpf.sh +++ b/scripts/perm-smoke-jnpf.sh @@ -39,7 +39,7 @@ ROOT="$(cd "$(dirname "$0")/.." && pwd)" # 🔴 记住「B 是不是用户显式给的」—— 显式给了就不自起隔离后端(尊重外部后端) B_RAW="${B:-}" B="${B:-http://127.0.0.1:30010}" -ENC_BIN="${ENC_BIN:-$ROOT/target/release/ssw-platform}" +ENC_BIN="${ENC_BIN:-$ROOT/target/release/sspf-admin}" TMP="$(mktemp -d)" # 🔴 退出时先停掉**自起的**隔离后端,再删临时目录(助手提供 kill;没自起就是空操作) diff --git a/scripts/perm-smoke.sh b/scripts/perm-smoke.sh index a1d105f..b964ef9 100755 --- a/scripts/perm-smoke.sh +++ b/scripts/perm-smoke.sh @@ -27,7 +27,7 @@ ROOT="$(cd "$(dirname "$0")/.." && pwd)" # 🔴 记住「B 是不是用户显式给的」—— 显式给了就不自起隔离后端(尊重外部后端) B_RAW="${B:-}" B="${B:-http://127.0.0.1:30010}" -ENC_BIN="${ENC_BIN:-$ROOT/target/release/ssw-platform}" +ENC_BIN="${ENC_BIN:-$ROOT/target/release/sspf-admin}" TMP="$(mktemp -d)" # 🔴 退出时先停掉**自起的**隔离后端,再删临时目录(助手提供 kill;没自起就是空操作) diff --git a/scripts/reap-ipc-leaks.sh b/scripts/reap-ipc-leaks.sh index db28280..f1bcf46 100755 --- a/scripts/reap-ipc-leaks.sh +++ b/scripts/reap-ipc-leaks.sh @@ -2,7 +2,7 @@ # 回收 macOS 上**泄漏的 SysV 信号量集**(PGlite 专用)。 # # 🔴 背景:macOS(XNU) 的 SysV 信号量集在创建进程退出后**不回收**,且不带 ipcrm。 -# 本仓的 `cargo test` 每轮会新建 7 个 PGlite 实例(`src/backend/tests/*.rs` 各 1 个 +# 本仓的 `cargo test` 每轮会新建 7 个 PGlite 实例(`crates/tests/tests/*.rs` 各 1 个 # `Db::open_temp()`;initdb 阶段 semget 一个 nsems=20 的 set) # ⇒ 跑够几千轮后 kern.sysv.semmns(87381) 被撑满 # ⇒ **任何新的 PostgreSQL 实例都起不来**(`semget: No space left on device`)。 diff --git a/scripts/verify.sh b/scripts/verify.sh index 4d1f19f..f35cc70 100755 --- a/scripts/verify.sh +++ b/scripts/verify.sh @@ -161,7 +161,7 @@ if [ "${MODE}" = "lib" ] || [ "${MODE}" = "full" ] || [ "${MODE}" = "smoke" ]; t # 它们全都**不会让静态闸门红**,只表现为「前端页面空着」。 # 代价实测 +1.3s(含起 pglite + 起 HTTP 服务)⇒ 放进中环完全值得。 run_step "包冒烟(每个包的 List 真应答,面 A + 面 B)" \ - cargo test --offline -p ssw-platform --test pack_smoke_it + cargo test --offline -p sspf-tests --test pack_smoke_it else run_step "全量测试(cargo test --workspace)" \ cargo test --offline --workspace diff --git a/src/backend/Cargo.toml b/src/backend/Cargo.toml index cb31b0c..e1c1e9a 100644 --- a/src/backend/Cargo.toml +++ b/src/backend/Cargo.toml @@ -1,8 +1,9 @@ -# ssw-platform 后端 crate +# ssw-platform 内核 crate # -# 单包双目标: -# - lib `ssw_platform`(src/lib.rs)—— 供集成测试 `use ssw_platform::…` -# - bin `ssw-platform`(src/main.rs)—— 薄壳,只做启动装配 +# 🔴 **只有 lib 目标**(`ssw_platform`)—— 可被 CLI / MCP 适配器 / 测试 / +# 任意应用 crate 复用。**可执行的装配在 `crates/sspf-admin`**(默认装配): +# 定位项目根、读环境变量、开库、种子、自检、绑端口、优雅停机 —— 那些是 +# 「进程级」的事,不是内核能力。 # # ⚠️ 这里不得写 [profile.*]:release profile 只在 workspace 根 Cargo.toml。 @@ -16,10 +17,6 @@ rust-version.workspace = true name = "ssw_platform" path = "src/lib.rs" -[[bin]] -name = "ssw-platform" -path = "src/main.rs" - [dependencies] axum = { workspace = true } tokio = { workspace = true } @@ -56,7 +53,7 @@ sspf-compat-permission = { path = "../../crates/sspf-compat-permission" } sspf-compat-msg = { path = "../../crates/sspf-compat-msg" } sspf-compat-workflow = { path = "../../crates/sspf-compat-workflow" } sspf-compat-ext = { path = "../../crates/sspf-compat-ext" } -sspf-compat-online_dev = { path = "../../crates/sspf-compat-online_dev" } +sspf-compat-onlinedev = { path = "../../crates/sspf-compat-onlinedev" } # MCP 工具层(元工具 + 分层加载)—— 内核实现它的 PlatformAdapter,反向依赖 sspf-mcp = { path = "../../crates/sspf-mcp" } @@ -82,7 +79,7 @@ sspf-plugin = { path = "../../crates/sspf-plugin" } # 且 `scripts/verify.sh` 第一步(`pack-sync.py --check`)会直接红。 # >>>GEN:PACK_DEPS sspf-pack-asset = { path = "../../packs/asset" } +sspf-pack-books = { path = "../../packs/books" } +sspf-pack-demo = { path = "../../packs/demo" } +sspf-pack-shop = { path = "../../packs/shop" } # <<>>GEN:PACK_DEPS` 段是 `pack-sync.py` 生成的 | 不手改(`new-pack.sh` 会写) | +| `src/routes.rs` | **唯一权威装配链**(面 A / 面 B 按判别头分流) | 不动 | +| `src/bootstrap.rs` | **装配根**:平台表 + 各包 DDL + 业务菜单注入种子 | 不动 | +| `src/compat.rs` | 契约面命名空间别名表(`compat::<域>::`,16 个域) | 不动 | +| `src/forward.rs` | 6 个转发壳(低代码 4 + MCP 2),只有 `pub use` | 不动 | +| `src/packs_gen.rs` | ⚠️ 生成物:业务包注册表 + `pack.toml` 快照 | 不手改 | +| `src/test_support.rs` | 内核**单测**共享的 pglite(`#[cfg(test)]`) | 不动 | +| `src/modules/` | **业务层**:4 个模块文件都是「面 A 适配器 + `pub use` 转发」→ `packs/{asset,demo,shop,books}` | ✅ **只动这里** | +| `db/schema.sql` | **平台表**(`base_*`)DDL 唯一真源;业务表的 DDL 跟着各自的包走 | 加平台表才动 | +| `data/` | 运行期数据目录(gitignore) | 不动 | + +## 测试 + +| 测什么 | 在哪 | 怎么跑 | +|---|---|---| +| 内核单测(102 条,含 `routes.rs` 的路由表钉死) | 各文件内联 `#[cfg(test)]` | `cargo test -p ssw-platform --lib` | +| 平台集成测试(37 个 `*_it.rs`,测「装配好的平台」) | [`crates/tests/tests/`](../../crates/tests) | `cargo test -p sspf-tests` | + +🔴 空的 `src/backend/tests/` **已删**:集成测试的宿主是 `crates/tests`, +放回这里会让「内核实现细节」与「平台契约」混在一起(历史上 37 个文件跟着内核搬过 3 次)。 +这条边界由 `scripts/check-arch.sh` 的 **AR16** 钉住。 + +## 不要在这里做的事 + +- ❌ 加 `[[bin]]`(AR16 红)→ 起新应用请复制 `crates/sspf-admin` +- ❌ 把集成测试放回 `tests/`(AR16 红) +- ❌ 在 `compat.rs` / 平台层里 `use sspf_pack_*`(AR9 红) +- ❌ 手改 `packs_gen.rs` 或 `Cargo.toml` 的 `>>>GEN:PACK_DEPS` 段(下次生成会覆盖) diff --git a/src/backend/db/schema.sql b/src/backend/db/schema.sql index 338974a..79c2e9e 100644 --- a/src/backend/db/schema.sql +++ b/src/backend/db/schema.sql @@ -863,50 +863,21 @@ CREATE TABLE base_data_set_relation ( ); -- ============================================================================ --- 业务表 3 张(demo_item / shop_product / book_shop_book) +-- 🔴 **示例业务表已搬进业务包**(2026-11-04): +-- `demo_item` / `shop_product` / `book_shop_book` 的 DDL 现在住在 +-- `packs/{demo,shop,books}/schema/001_init.sql`,由各包的 `include_str!` +-- 编译进二进制 ⇒ 内核启动时按包顺序幂等执行。 -- --- 🔴 逐字对齐 react 版 TypeORM entity(demo-item.entity.ts / product.entity.ts / --- book.entity.ts)—— 这是「两版后端可开同一个库」成立的**前提**: --- 两边必须是**同一张表**,否则 react 的 synchronize 会 ALTER 掉我们建的列。 --- 真源:docs/contract.md §5.1。 +-- 为什么搬:这三个是**示例装配**(技能要带走当样板),示例的 DDL 就该跟着 +-- 示例走 —— 否则「把 packs/demo 整目录搬去技能」这件事永远缺一块。 -- --- 🔴 有 DB 默认值的**只有两处**:f_delete_mark(三张表都有)与 book_shop_book.f_stock --- (react 的 book.entity.ts 上 stock 也有 default: 0 ⇒ TypeORM 建的库同样带这个默认值)。 --- §7.6 路径 2(带 id 但行不存在 ⇒ 用该 id 新建)依赖它们补出 0; --- 其余业务列一律不得有默认值(该路径要求「body 没给 ⇒ NULL」)。 +-- 🔴 **对 react 版的影响**(「两版后端能开同一个库」这条约定): +-- 业务列名 / 列序 / 类型**逐字未变**;只是按平台规则补了 +-- `f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL` 并进入复合主键。 +-- react 侧不认识这一列,但它有默认值 ⇒ 读写都不受影响。 +-- 三个包的 spec **没有**把 `f_tenant_id` 放进列清单 ⇒ 面 A 的 JSON 键零变化。 -- ============================================================================ -CREATE TABLE demo_item ( - f_id VARCHAR(50) PRIMARY KEY, - f_title VARCHAR(255), - f_status VARCHAR(32), - f_creator_user_id VARCHAR(50), - f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, - f_delete_mark INTEGER DEFAULT 0 -); - -CREATE TABLE shop_product ( - f_id VARCHAR(50) PRIMARY KEY, - f_title VARCHAR(255), - f_price NUMERIC(12,2), - f_creator_user_id VARCHAR(50), - f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, - f_delete_mark INTEGER DEFAULT 0 -); - -CREATE TABLE book_shop_book ( - f_id VARCHAR(50) PRIMARY KEY, - f_title VARCHAR(255), - f_author VARCHAR(100), - f_isbn VARCHAR(32), - f_category VARCHAR(50), - f_price NUMERIC(12,2), - f_stock INTEGER DEFAULT 0, - f_creator_user_id VARCHAR(50), - f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, - f_delete_mark INTEGER DEFAULT 0 -); - -- ---------------------------------------------------------------------------- -- 🔴 **业务包的表不在本文件里**(批次 12 交付物 ③「DDL 跟着包走」)。 -- @@ -917,9 +888,9 @@ CREATE TABLE book_shop_book ( -- 理由:加一张业务表不该改内核的 `schema.sql`(那是**平台层**的数据模型) -- ⇒ 业务表的 DDL 跟着**业务包**走 ⇒ 包目录能整目录搬走 ⇒ 单二进制部署。 -- --- 🔴 本文件现在只含**平台表**(`base_*`)+ 三个**面 A 内嵌业务表** --- (`demo_item` / `shop_product` / `book_shop_book` —— 它们是 react 版 --- 的对齐基准,留在内核侧)。 +-- 🔴 本文件现在只含**平台表**(`base_*`)+ 报表 / 流程 / extend / teamwork / 大屏 +-- 的元数据表(它们是**契约面**的表,跟着契约面走)。 +-- **业务表(示例包 + asset 包)一律不在本文件里** —— 见上面的搬迁说明。 -- ---------------------------------------------------------------------------- -- ============================================================ 低代码(P2) diff --git a/src/backend/src/bootstrap.rs b/src/backend/src/bootstrap.rs index aacf8c0..49d41a5 100644 --- a/src/backend/src/bootstrap.rs +++ b/src/backend/src/bootstrap.rs @@ -48,7 +48,7 @@ static PACKS: OnceLock> = OnceLock::new(); /// /// 🔴 **失败即「全进程不可用」** —— 业务包装载不过 ⇒ 它的端点不存在 /// ⇒ 前端一访问就是 404 ⇒ **必须响亮地失败**,不能悄悄降级。 -/// `main.rs` 的 `run()` 在**开库之前**调它 ⇒ 失败直接 `exit 1`(见契约 §10 第 3 步)。 +/// `crates/sspf-admin/src/main.rs` 的 `run()` 在**开库之前**调它 ⇒ 失败直接 `exit 1`(见契约 §10 第 3 步)。 pub fn packs() -> Result<&'static PackRegistry, &'static str> { PACKS .get_or_init(|| load_packs().map_err(|e| e.to_string())) @@ -130,7 +130,7 @@ pub fn pack_router(reg: &PackRegistry) -> Router { /// 这里只是**不让整个进程崩掉**(让启动自检有机会跑完并打印人话)。 /// /// 🔴 **为什么不能静默**:静默 ⇒ 路由少了 ⇒ 前端 404 ⇒ **看不出是装载失败**。 -/// ⇒ 启动自检必须先跑(见 `main.rs` 的第 3 步)。 +/// ⇒ 启动自检必须先跑(见 `crates/sspf-admin/src/main.rs` 的第 3 步)。 pub fn pack_router_or_empty() -> Router { match packs() { Ok(reg) => pack_router(reg), @@ -148,6 +148,11 @@ pub fn pack_router_or_empty() -> Router { /// /// 🔴 **不许碰 `base_*`** —— 装载器已在装载期拦过(`DdlTouchesBaseTable`)。 pub async fn ensure_pack_schema(db: &Db, reg: &PackRegistry) -> Result<(), pglite::Error> { + // 🔴 **先登记「包表归谁所有」**(低代码建模页的护栏要用): + // 包建的表对建模页来说必须**只读**(不许 ALTER / DROP), + // 判据在 `sspf_store::db::is_protected_table`(平台 DDL ∪ 包表)。 + // 这一步放在建表之前:建表失败也不能让护栏变成「谁都能删」。 + sspf_store::db::register_pack_tables(reg.ddls.iter().map(|d| d.table.clone())); for ddl in ®.ddls { // 🔴 一条 DDL 一条语句 ⇒ 用 `exec`(simple protocol)。 // 包里的 DDL 自己带 `IF NOT EXISTS` ⇒ 幂等。 @@ -162,13 +167,13 @@ pub async fn ensure_pack_schema(db: &Db, reg: &PackRegistry) -> Result<(), pglit /// 建库现在有**两段**(① `schema.sql` 的平台表 ② 业务包自带的 DDL)。 /// 测试与生产必须**走同一条路** ⇒ 否则测试里的库比线上少业务包建的表 /// ⇒ 冒烟测到的东西不是上线的东西(**静默**降级)。 -/// ⇒ 两段打包成一个函数 ⇒ 生产(`main.rs`)与测试(23 个集成测试文件)都调它。 +/// ⇒ 两段打包成一个函数 ⇒ 生产(`crates/sspf-admin/src/main.rs`)与测试(23 个集成测试文件)都调它。 /// /// - `db`:库句柄。 /// /// 🔴 **错误必须往上抛**:这里曾经写 `if let Ok(reg) = packs()` —— 业务包装载失败时 /// 只建平台表、不建业务表,启动却照常成功 ⇒ 业务包端点全在、表全无(`relation does not exist`)。 -/// ⇒ 现在 `packs()` 的 Err 直接转成返回值,由 `main.rs` 打印人话并退出。 +/// ⇒ 现在 `packs()` 的 Err 直接转成返回值,由 `crates/sspf-admin/src/main.rs` 打印人话并退出。 pub async fn ensure_schema_all(db: &Db) -> Result<(), String> { // ---- 第 1 段:平台表(`db/schema.sql`)---- db.ensure_schema() diff --git a/src/backend/src/compat.rs b/src/backend/src/compat.rs index 814e23b..f1934e7 100644 --- a/src/backend/src/compat.rs +++ b/src/backend/src/compat.rs @@ -33,7 +33,7 @@ //! | `message` / `msg_center` | `sspf-compat-msg` | `api/message/**`、`api/msgCenter/**` | //! | `workflow` / `report` / `visualdata` | `sspf-compat-workflow` | `api/workFlow/**`、`api/report/**` | //! | `ai` / `extend` / `teamwork` / `mobile` | `sspf-compat-ext` | `api/aiCenter/**`、`api/extend/**` | -//! | `online_dev` | `sspf-compat-online_dev` | `api/onlineDev/**` | +//! | `onlinedev` | `sspf-compat-onlinedev` | `api/onlineDev/**` | //! | `helper` / `res` | `sspf-compat-core` | 公共底座(不是官方模块) | // ---- 契约面公共底座(`sspf-compat-core`)---- @@ -123,6 +123,6 @@ pub mod mobile { } /// 在线开发域:在线表单设计器 / 报表配置(官方 `api/onlineDev/**`)。 -pub mod online_dev { - pub use sspf_compat_online_dev::online_dev::*; +pub mod onlinedev { + pub use sspf_compat_onlinedev::onlinedev::*; } diff --git a/src/backend/src/forward.rs b/src/backend/src/forward.rs new file mode 100644 index 0000000..a44b0c4 --- /dev/null +++ b/src/backend/src/forward.rs @@ -0,0 +1,60 @@ +//! forward —— **6 个转发壳**(低代码执行层 4 个 + MCP 适配层 2 个)。 +//! +//! 真源全部在 `crates/` 里,本文件**只做 `pub use`**,一行实现都没有。 +//! +//! ## 为什么要把 6 个壳收在一个文件里 +//! +//! 它们原本是 6 个独立的 5 行文件(`lowcode_check.rs` / `lowcode_crud.rs` / +//! `lowcode_ddl.rs` / `lowcode_seed.rs` / `mcp_adapter.rs` / `mcp_compat.rs`)。 +//! 对读代码的人是**噪音**:目录里 12 个 `.rs`,一半是「打开后发现只有一行 `pub use`」。 +//! 收进一个文件后:目录只剩 7 项,而「这 6 个路径都是壳」这件事**一眼可见**, +//! 不会再有人误以为 `src/backend/src/lowcode_crud.rs` 里有低代码实现。 +//! +//! ## 为什么还留着这些路径(不直接删壳) +//! +//! 调用方按 `ssw_platform::<模块>::` 写(如 `crates/sspf-admin` 的 +//! `ssw_platform::lowcode_seed::seed_lowcode_demo`、`ssw_platform::mcp_adapter::NativeAdapter`) +//! ⇒ 一旦删壳,这些路径全要改,而**收益只是少一个文件**。壳的价值是: +//! 「内核的对外形状」与「实现放在哪个 crate」解耦 —— 以后再把 +//! `sspf-lowcode-exec` 拆成两个 crate,调用方仍然零改动。 +//! +//! 🔴 **纪律**:壳里**只许有 `pub use`**。 +//! - `check-arch.sh` 的 **AR9** 会抓「平台层里出现 `use sspf_pack_*`」; +//! - 想改实现 ⇒ 去 `crates/` 里改(真源位置见下表); +//! - 想在壳里加一个「顺手写的辅助函数」⇒ 它会被下一次搬 crate 遗忘在半路。 +//! +//! | 本文件里的模块 | 真源 crate | +//! |---|---| +//! | [`lowcode_check`] / [`lowcode_crud`] / [`lowcode_ddl`] / [`lowcode_seed`] | `crates/sspf-lowcode-exec` | +//! | [`mcp_adapter`] / [`mcp_compat`] | `crates/sspf-mcp-adapter` | + +/// 转发壳:真源在 [`sspf_lowcode_exec::lowcode_check`](M5 低代码执行层下沉)。 +pub mod lowcode_check { + pub use sspf_lowcode_exec::lowcode_check::*; +} + +/// 转发壳:真源在 [`sspf_lowcode_exec::lowcode_crud`](M5 低代码执行层下沉)。 +/// CLI(`--seed-lowcode-demo`)与 MCP 适配器的调用路径不用改。 +pub mod lowcode_crud { + pub use sspf_lowcode_exec::lowcode_crud::*; +} + +/// 转发壳:真源在 [`sspf_lowcode_exec::lowcode_ddl`](M5 低代码执行层下沉)。 +pub mod lowcode_ddl { + pub use sspf_lowcode_exec::lowcode_ddl::*; +} + +/// 转发壳:真源在 [`sspf_lowcode_exec::lowcode_seed`](M5 低代码执行层下沉)。 +pub mod lowcode_seed { + pub use sspf_lowcode_exec::lowcode_seed::*; +} + +/// 转发壳:真源在 [`sspf_mcp_adapter::mcp_adapter`](M6 MCP 适配层下沉)。 +pub mod mcp_adapter { + pub use sspf_mcp_adapter::mcp_adapter::*; +} + +/// 转发壳:真源在 [`sspf_mcp_adapter::mcp_compat`](M6 MCP 适配层下沉)。 +pub mod mcp_compat { + pub use sspf_mcp_adapter::mcp_compat::*; +} diff --git a/src/backend/src/lib.rs b/src/backend/src/lib.rs index 22d072f..5a55140 100644 --- a/src/backend/src/lib.rs +++ b/src/backend/src/lib.rs @@ -1,48 +1,65 @@ -//! ssw-platform —— JNPF 兼容契约的 Rust 实现(库入口 / **装配根**)。 +//! ssw-platform —— 内核 lib(**装配根**)。平台能力全在 `crates/`,本 crate 只做三件事: +//! **装配**(把 crate 拼起来)、**路由注册**、**业务层**。 //! -//! 🔴 **M7 起:本 crate 是「壳」** —— 平台能力**全部**在 `crates/` 里, -//! 本 crate 只做三件事:**装配**(把 crate 拼起来)、**路由注册**、**业务层**。 +//! 🔴 可执行的入口**不在这里**:见 `crates/sspf-admin`(默认装配,bin `sspf-admin`)。 +//! 集成测试也不在这里:见 `crates/tests`(package `sspf-tests`)。 //! -//! M2–M6 期间存在的 `src/backend/src/platform/`(38 个转发壳)**已删除** ⇒ -//! 平台能力的路径变成 `sspf_core::…` / `sspf_compat_<包>::…`。 +//! ## 30 秒地图(先读这一页,别一个个点开文件) //! -//! ## 分层(对齐 `ssw-jnpf-lite-react` 的 `common`+`auth`+`sys` / `demo`+`shop`+`books`, -//! 以及官方 JNPF 的 `jnpf-common`+`jnpf-system` / `jnpf-admin`): -//! -//! | 层 | 位置 | 职责 | 加业务模块时 | +//! | 文件 | 是什么 | 真源 / 生成方式 | 加业务模块时 | //! |---|---|---|---| -//! | **平台核心** | `crates/sspf-core/` | 信封 / cipher / 登录 / 权限 / `base_*` 管理 / CRUD 引擎 | **不动** | -//! | **契约面** | `crates/sspf-compat-*/` | 官方兼容端点(面 B) | **不动** | -//! | **业务层** | [`modules`] | 业务实体 spec + 各自的 handler 与路由 | **只动这里** | +//! | **`lib.rs`** | 本页:导航 + 模块声明 | — | 不动 | +//! | **`routes.rs`** | 面 A / 面 B 路由装配(**唯一权威装配链**:`build_router` → 404 → 405/413 → catch-all → `with_state`) | 路由字面量真源 | 不动(业务路由由 `modules` 汇总后 merge) | +//! | **`bootstrap.rs`** | 装配根:平台表 + 各包 DDL + 业务菜单注入种子(**唯一同时认识平台层与业务层的地方**) | — | 不动 | +//! | **`compat.rs`** | 契约面**命名空间别名表**:`compat::<域>::` 共 16 个域 | `crates/sspf-compat-*` | 不动 | +//! | **`forward.rs`** | **6 个转发壳**(低代码 4 + MCP 2),只有 `pub use` | `crates/sspf-lowcode-exec`、`crates/sspf-mcp-adapter` | 不动 | +//! | **`packs_gen.rs`** | ⚠️ **生成物**:业务包注册表 + `pack.toml` 快照 | `scripts/pack-sync.py` 读 `packs/*` | **不手改**;改完 `packs/` 跑脚本 | +//! | **`test_support.rs`** | 内核**单测**共享的进程级 pglite(`#[cfg(test)]`,仅 `routes.rs` 的单测用) | — | 不动 | +//! | **`modules/`** | **业务层**(面 A):spec + 菜单 + 路由汇总 | 4 个模块文件都是「面 A 适配器 + `pub use` 转发」→ `packs/{asset,demo,shop,books}` | ✅ **只动这里** | //! -//! ## 本 crate 里的模块 +//! ## 三条边界(`scripts/check-arch.sh` 钉住,踩线即红) //! -//! | 模块 | 职责 | +//! - **AR9**:平台层(`crates/sspf-core` / `crates/sspf-compat-*` / 本 crate 的 `compat.rs`) +//! **不许** `use sspf_pack_*` —— 业务知识漏进平台层,「加包只链接就好」就成了假话。 +//! - **AR10**:平台层**不许**反向依赖契约面(`crate::platform::compat` / `crate::compat`)—— +//! 拆 crate 时那就是循环依赖。面 B 的分流点在 `routes.rs`。 +//! - **AR16**:本 crate **只有 lib 目标**(不许 `[[bin]]`)、**不许**把集成测试放回 +//! `src/backend/tests/`;默认装配必须在 `crates/sspf-admin`。 +//! +//! ## 本 crate 里没有的东西(别在这儿找) +//! +//! | 想找 | 去哪 | //! |---|---| -//! | [`routes`] | 路由装配(面 A / 面 B 按判别头分流) | -//! | [`bootstrap`] | **装配根**(唯一同时认识平台层与业务层的地方) | -//! | [`compat`] | 契约面**命名空间别名表**(`compat::<域>::`) | -//! | [`modules`] | 业务层(面 A) | -//! | [`mcp_adapter`] / [`mcp_compat`] | MCP 适配层的转发壳 | -//! | [`lowcode_*`] | 低代码执行层的转发壳 | -//! | [`test_support`] | 测试共享的 pglite 实例(**依赖装配根 ⇒ 留壳侧**) | +//! | 启动装配(读环境 / 开库 / 种子 / 绑端口 / 优雅停机 / `--enc` / `--mcp`) | `crates/sspf-admin/src/main.rs` | +//! | 集成测试(37 个 `*_it.rs`) | `crates/tests/tests/` | +//! | 平台核心(信封 / 登录 / 权限 / CRUD 引擎 / cipher) | `crates/sspf-core` | +//! | 面 B 各域实现(system / permission / msg / workflow / ext / onlinedev) | `crates/sspf-compat-*` | +//! | 业务包真源 | `packs/`;内核侧 `modules/.rs` 只是「面 A 适配器 + `pub use` 转发」 | //! -//! 🔴 另加 [`bootstrap`] = **装配根**(唯一同时认识平台层与业务层的地方)。 +//! ## 业务层当前长什么样(2026-11-04) +//! +//! `packs/` 下 4 个包:`asset`(真实业务:数据资源)+ `demo` / `shop` / `books` +//! (**示例包**,技能要带走当样板)。内核的 `modules/*.rs` 里**没有任何 spec** +//! (`check-arch.sh` 的 PACK1 钉住)—— 加业务模块跑 `bash scripts/new-pack.sh`。 pub mod bootstrap; /// 🔴 **契约面命名空间别名表**(M7 新增,取代已删的 `platform/compat/` 16 个转发壳)。 /// 详见本模块自身的文档。 pub mod compat; -pub mod lowcode_check; -pub mod lowcode_crud; -pub mod lowcode_ddl; -pub mod lowcode_seed; -pub mod mcp_adapter; -pub mod mcp_compat; + +/// 6 个转发壳(低代码执行层 4 + MCP 适配层 2)—— 只有 `pub use`,真源在 `crates/`。 +/// 收在一个文件里而不是 6 个 5 行文件:让「这些路径都是壳」一眼可见。 +mod forward; +pub use forward::{ + lowcode_check, lowcode_crud, lowcode_ddl, lowcode_seed, mcp_adapter, mcp_compat, +}; + pub mod modules; -// 🔴 **本文件是 `scripts/pack-sync.py` 生成的**(业务包清单 + `pack.toml` 快照) -// ⇒ 不要手改;加包跑 `bash scripts/new-pack.sh`。 +/// 🔴 **本文件是 `scripts/pack-sync.py` 生成的**(业务包清单 + `pack.toml` 快照) +/// ⇒ 不要手改;加包跑 `bash scripts/new-pack.sh`。 pub mod packs_gen; pub mod routes; +/// 内核**单测**共享的 pglite 实例(`routes.rs` 的 `#[cfg(test)]` 用)。 +/// 集成测试不在这里 —— 它们各自起库,见 `crates/tests`。 #[cfg(test)] pub mod test_support; diff --git a/src/backend/src/lowcode_check.rs b/src/backend/src/lowcode_check.rs deleted file mode 100644 index fa0266a..0000000 --- a/src/backend/src/lowcode_check.rs +++ /dev/null @@ -1,5 +0,0 @@ -//! lowcode_check —— **转发壳**:真源在 [`sspf_lowcode_exec::lowcode_check`](M5 低代码执行层下沉)。 -//! 🔴 只做转发、不含实现;CLI(`--seed-lowcode-demo`)与 MCP 适配器的调用路径不用改。 -//! 为什么留壳、闸门怎么改:见 `docs/CRATES-MIGRATION.md` §4 M5。 - -pub use sspf_lowcode_exec::lowcode_check::*; diff --git a/src/backend/src/lowcode_crud.rs b/src/backend/src/lowcode_crud.rs deleted file mode 100644 index aa0a4d0..0000000 --- a/src/backend/src/lowcode_crud.rs +++ /dev/null @@ -1,5 +0,0 @@ -//! lowcode_crud —— **转发壳**:真源在 [`sspf_lowcode_exec::lowcode_crud`](M5 低代码执行层下沉)。 -//! 🔴 只做转发、不含实现;CLI(`--seed-lowcode-demo`)与 MCP 适配器的调用路径不用改。 -//! 为什么留壳、闸门怎么改:见 `docs/CRATES-MIGRATION.md` §4 M5。 - -pub use sspf_lowcode_exec::lowcode_crud::*; diff --git a/src/backend/src/lowcode_ddl.rs b/src/backend/src/lowcode_ddl.rs deleted file mode 100644 index 2bff8c6..0000000 --- a/src/backend/src/lowcode_ddl.rs +++ /dev/null @@ -1,5 +0,0 @@ -//! lowcode_ddl —— **转发壳**:真源在 [`sspf_lowcode_exec::lowcode_ddl`](M5 低代码执行层下沉)。 -//! 🔴 只做转发、不含实现;CLI(`--seed-lowcode-demo`)与 MCP 适配器的调用路径不用改。 -//! 为什么留壳、闸门怎么改:见 `docs/CRATES-MIGRATION.md` §4 M5。 - -pub use sspf_lowcode_exec::lowcode_ddl::*; diff --git a/src/backend/src/lowcode_seed.rs b/src/backend/src/lowcode_seed.rs deleted file mode 100644 index a89f425..0000000 --- a/src/backend/src/lowcode_seed.rs +++ /dev/null @@ -1,5 +0,0 @@ -//! lowcode_seed —— **转发壳**:真源在 [`sspf_lowcode_exec::lowcode_seed`](M5 低代码执行层下沉)。 -//! 🔴 只做转发、不含实现;CLI(`--seed-lowcode-demo`)与 MCP 适配器的调用路径不用改。 -//! 为什么留壳、闸门怎么改:见 `docs/CRATES-MIGRATION.md` §4 M5。 - -pub use sspf_lowcode_exec::lowcode_seed::*; diff --git a/src/backend/src/mcp_adapter.rs b/src/backend/src/mcp_adapter.rs deleted file mode 100644 index 396611b..0000000 --- a/src/backend/src/mcp_adapter.rs +++ /dev/null @@ -1,5 +0,0 @@ -//! mcp_adapter —— **转发壳**:真源在 [`sspf_mcp_adapter::mcp_adapter`](M6 MCP 适配层下沉)。 -//! 🔴 只做转发、不含实现;别往壳里塞东西(`check-arch.sh` AR9/AR10 会红)。 -//! 为什么留壳、闸门怎么改:见 `docs/CRATES-MIGRATION.md` §4 M6。 - -pub use sspf_mcp_adapter::mcp_adapter::*; diff --git a/src/backend/src/mcp_compat.rs b/src/backend/src/mcp_compat.rs deleted file mode 100644 index 93ebb7d..0000000 --- a/src/backend/src/mcp_compat.rs +++ /dev/null @@ -1,5 +0,0 @@ -//! mcp_compat —— **转发壳**:真源在 [`sspf_mcp_adapter::mcp_compat`](M6 MCP 适配层下沉)。 -//! 🔴 只做转发、不含实现;别往壳里塞东西(`check-arch.sh` AR9/AR10 会红)。 -//! 为什么留壳、闸门怎么改:见 `docs/CRATES-MIGRATION.md` §4 M6。 - -pub use sspf_mcp_adapter::mcp_compat::*; diff --git a/src/backend/src/modules/books.rs b/src/backend/src/modules/books.rs index ef1800b..79f63e5 100644 --- a/src/backend/src/modules/books.rs +++ b/src/backend/src/modules/books.rs @@ -1,14 +1,20 @@ //! books —— 业务模块:Book(物理表 `book_shop_book`)。 //! -//! 🔴 **业务层模板**:加一个业务模块 = 照抄本文件建 `modules/.rs` -//! (spec + 3 个 handler + 自己的路由),**再在 [`crate::modules::mod`] 里挂一行**。 -//! **平台层(`platform/`)一个字都不用改。** +//! 🔴 **本文件是「面 A 适配器 + spec 的转发点」,不是 spec 的家**: +//! 真源在 `packs/books/src/lib.rs`(业务包,**只依赖 sspf-sdk**), +//! 本文件只做 `pub use` 转发 ⇒ **spec 只有一份**(`check-arch.sh` 的 PACK1 钉住)。 //! -//! 行为真源:`~/Desktop/workspace/skills/ssw-jnpf-lite-react/src/backend/src/books/book.entity.ts` -//! (**列名 / 列序逐字对齐** —— 两版后端要能开同一个库)。 +//! 🔴 **面 A 与面 B 各住一处**: +//! - **本文件 = 面 A**(`/api/ssw/books/Book/…`)—— 本仓自造的 ssw 约定, +//! 留给 Rust 终端场景,**一个字都不改**(前端在用它); +//! - **业务包 = 面 B**(`/api/books/Book`)—— 官方 JNPF 形状, +//! 集成到官方 Java 时能直接搬。 //! -//! 🔴 本模块的守卫:菜单 `books/Book`(`module_key`)⇒ 非管理员未授权 ⇒ `code=403`。 -//! 🔴 `f_price` 是 **numeric**(JSON 字符串 `"9.90"`)· `f_stock` 是 **int**(JSON 数字 `100`)。 +//! 🔴 **DDL 跟着包走**:`book_shop_book` 的建表语句在 `packs/books/schema/001_init.sql`, +//! 编译进二进制 ⇒ 不再手抄进 `db/schema.sql`。 +//! +//! 🔴 **本包是示例包**:`packs/books` 整目录可搬去技能当样板,本文件是它在本仓的 +//! 面 A 适配器(技能带走示例时,这份适配器可以不要)。 use axum::body::Bytes; use axum::extract::{RawQuery, State}; @@ -17,109 +23,17 @@ use axum::routing::{delete, get, post}; use axum::{Json, Router}; use sspf_core::crud::{handle_delete, handle_list, handle_save}; -use sspf_core::entity::{ColumnSpec, EntitySpec}; use sspf_core::envelope::ActionResult; -use sspf_core::menu::MenuSpec; use sspf_core::state::AppState; -use sspf_core::registry; -/// `book_shop_book` 的列清单(**顺序 = 响应 JSON 的键序**)。 -const BOOK_COLUMNS: &[ColumnSpec] = &[ - ColumnSpec { - column: "f_id", - json_key: "id", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_title", - json_key: "title", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_author", - json_key: "author", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_isbn", - json_key: "isbn", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_category", - json_key: "category", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_price", - json_key: "price", - default: Some("0.00"), - numeric: true, - }, - ColumnSpec { - column: "f_stock", - json_key: "stock", - default: Some("0"), - numeric: false, - }, - ColumnSpec { - column: "f_creator_user_id", - json_key: "creatorUserId", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_creator_time", - json_key: "creatorTime", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_delete_mark", - json_key: "deleteMark", - default: Some("0"), - numeric: false, - }, -]; +// 🔴 **spec 与菜单的单一真源 = 业务包** —— 这里只转发,不重写。 +pub use sspf_pack_books::BOOK_MENU; +pub use sspf_pack_books::BOOK_SPEC; -/// `book_shop_book` 的 spec。 -pub const BOOK_SPEC: EntitySpec = EntitySpec { - app_code: "books", - entity: "Book", - table: "book_shop_book", - module_key: Some("books/Book"), - columns: BOOK_COLUMNS, - numeric_columns: &["f_price"], - // 🔴 裁决 S22:非 demo 表 ⇒ `body.creatorUserId || 'admin'`。 - creator_fixed: None, -}; - -/// 🔴 **本模块的内置菜单**(契约 §8.4)—— 业务知识 ⇒ 住在**业务层**。 +/// 本模块的 3 条路由(**面 A**:业务层的路由表)—— 钉子测试遍历它。 /// -/// 🔴 **`url_address` 必须与 [`BOOK_SPEC`] 的 `module_key` 一字不差** -/// (都是 `books/Book`)—— 面 A 的菜单守卫靠它命中。 -pub const BOOK_MENU: MenuSpec = MenuSpec { - id: "m_book", - full_name: "图书超市", - // 🔴 **本仓自定的占位编码**(官方 JNPF 没有 books 模块)⇒ 见 `docs/known-limitations.md` §H。 - en_code: "permission.books.book", - url_address: "books/Book", - parent_id: "0", - menu_type: 2, - icon: Some("app"), - sort_code: 8, - system_en_code: registry::MAIN_SYSTEM_CODE, -}; - -/// 本模块的 3 条路由(**业务层的路由表**)—— 钉子测试遍历它。 -/// -/// 🔴 **业务路由清单住在业务层** ⇒ 平台层(`routes.rs`)不认业务路径 -/// ⇒ 加业务模块**不用改平台层**(平台层的钉子测试遍历本表)。 +/// 🔴 路径写字面量(不用下标):`scripts/check-contract-scan.py` 是静态解析, +/// 认不出数组下标 ⇒ 写下标会让契约闸门判「登记了、代码里没有」。 pub const ROUTES: [&str; 3] = [ "/api/ssw/books/Book/List", "/api/ssw/books/Book/Save", @@ -152,7 +66,7 @@ pub async fn book_delete( handle_delete(&state, &headers, &BOOK_SPEC, &raw).await } -/// 本模块的路由(`Router::merge` 进总路由,**对齐 NestJS 的 module 注册**)。 +/// 本模块的路由(**面 A**,`Router::merge` 进总路由)。 pub fn router() -> Router { Router::new() .route("/api/ssw/books/Book/List", get(book_list)) diff --git a/src/backend/src/modules/demo.rs b/src/backend/src/modules/demo.rs index 983b0d4..49462be 100644 --- a/src/backend/src/modules/demo.rs +++ b/src/backend/src/modules/demo.rs @@ -1,14 +1,20 @@ //! demo —— 业务模块:DemoItem(物理表 `demo_item`)。 //! -//! 🔴 **业务层模板**:加一个业务模块 = 照抄本文件建 `modules/.rs` -//! (spec + 3 个 handler + 自己的路由),**再在 [`crate::modules::mod`] 里挂一行**。 -//! **平台层(`platform/`)一个字都不用改。** +//! 🔴 **本文件是「面 A 适配器 + spec 的转发点」,不是 spec 的家**: +//! 真源在 `packs/demo/src/lib.rs`(业务包,**只依赖 sspf-sdk**), +//! 本文件只做 `pub use` 转发 ⇒ **spec 只有一份**(`check-arch.sh` 的 PACK1 钉住)。 //! -//! 行为真源:`~/Desktop/workspace/skills/ssw-jnpf-lite-react/src/backend/src/demo/demo-item.entity.ts` -//! (**列名 / 列序逐字对齐** —— 两版后端要能开同一个库)。 +//! 🔴 **面 A 与面 B 各住一处**: +//! - **本文件 = 面 A**(`/api/ssw/demo/DemoItem/…`)—— 本仓自造的 ssw 约定, +//! 留给 Rust 终端场景,**一个字都不改**(前端在用它); +//! - **业务包 = 面 B**(`/api/demo/DemoItem`)—— 官方 JNPF 形状, +//! 集成到官方 Java 时能直接搬。 //! -//! 🔴 本模块的特别规则(裁决 S22):`f_creator_user_id` **硬编码 `'admin'`** -//! (路径 1 完全不看 body)⇒ 由 spec 的 `creator_fixed` 声明,引擎不认 app_code。 +//! 🔴 **DDL 跟着包走**:`demo_item` 的建表语句在 `packs/demo/schema/001_init.sql`, +//! 编译进二进制 ⇒ 不再手抄进 `db/schema.sql`。 +//! +//! 🔴 **本包是示例包**:`packs/demo` 整目录可搬去技能当样板,本文件是它在本仓的 +//! 面 A 适配器(技能带走示例时,这份适配器可以不要)。 use axum::body::Bytes; use axum::extract::{RawQuery, State}; @@ -17,93 +23,17 @@ use axum::routing::{delete, get, post}; use axum::{Json, Router}; use sspf_core::crud::{handle_delete, handle_list, handle_save}; -use sspf_core::entity::{ColumnSpec, EntitySpec}; use sspf_core::envelope::ActionResult; -use sspf_core::menu::MenuSpec; -use sspf_core::registry; use sspf_core::state::AppState; -/// `demo_item` 的列清单(**顺序 = 响应 JSON 的键序**)。 -const DEMO_COLUMNS: &[ColumnSpec] = &[ - ColumnSpec { - column: "f_id", - json_key: "id", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_title", - json_key: "title", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_status", - json_key: "status", - default: Some("草稿"), - numeric: false, - }, - ColumnSpec { - column: "f_creator_user_id", - json_key: "creatorUserId", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_creator_time", - json_key: "creatorTime", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_delete_mark", - json_key: "deleteMark", - default: Some("0"), - numeric: false, - }, -]; +// 🔴 **spec 与菜单的单一真源 = 业务包** —— 这里只转发,不重写。 +pub use sspf_pack_demo::DEMO_MENU; +pub use sspf_pack_demo::DEMO_SPEC; -/// `demo_item` 的 spec。 +/// 本模块的 3 条路由(**面 A**:业务层的路由表)—— 钉子测试遍历它。 /// -/// 🔴 写成 **`const`**(而不是 `fn find_spec(..).expect(..)`)—— 非测试代码 -/// **零 `unwrap()` / `expect()` / `panic!()`** 是项目红线。 -pub const DEMO_SPEC: EntitySpec = EntitySpec { - app_code: "demo", - entity: "DemoItem", - table: "demo_item", - // 🔴 demo **仅登录**(无菜单守卫)。 - module_key: None, - columns: DEMO_COLUMNS, - numeric_columns: &[], - // 🔴 裁决 S22:demo 的 `f_creator_user_id` 恒为 `'admin'`(不看 body)。 - creator_fixed: Some("admin"), -}; - -/// 🔴 **本模块的内置菜单**(契约 §8.4)—— 业务知识 ⇒ 住在**业务层**。 -/// -/// 🔴 **为什么菜单也要下沉**:`f_url_address`(前端 Route path)与 `f_en_code` -/// (面 B 的点权限编码)都是**业务知识** ⇒ 写在平台层 ⇒ 加业务模块要改平台层 -/// ⇒ 违反红线 12(加一个业务模块只碰业务层)。 -/// -/// 🔴 **`url_address` = `demo-item`**(不是 `demo/DemoItem`)—— demo **仅登录**、 -/// 没有菜单守卫 ⇒ 它的 `f_url_address` 只用于菜单树展示 ⇒ 与前端 Route 一致。 -pub const DEMO_MENU: MenuSpec = MenuSpec { - id: "m_demo", - full_name: "Demo 示例", - // 🔴 **本仓自定的占位编码**(官方 JNPF 没有 demo 模块)⇒ 见 `docs/known-limitations.md` §H。 - en_code: "permission.demo", - url_address: "demo-item", - parent_id: "0", - menu_type: 2, - icon: Some("app"), - sort_code: 6, - system_en_code: registry::MAIN_SYSTEM_CODE, -}; - -/// 本模块的 3 条路由(**业务层的路由表**)—— 钉子测试遍历它。 -/// -/// 🔴 **业务路由清单住在业务层** ⇒ 平台层(`routes.rs`)不认业务路径 -/// ⇒ 加业务模块**不用改平台层**(平台层的钉子测试遍历本表)。 +/// 🔴 路径写字面量(不用下标):`scripts/check-contract-scan.py` 是静态解析, +/// 认不出数组下标 ⇒ 写下标会让契约闸门判「登记了、代码里没有」。 pub const ROUTES: [&str; 3] = [ "/api/ssw/demo/DemoItem/List", "/api/ssw/demo/DemoItem/Save", @@ -136,7 +66,7 @@ pub async fn demo_item_delete( handle_delete(&state, &headers, &DEMO_SPEC, &raw).await } -/// 本模块的路由(`Router::merge` 进总路由,**对齐 NestJS 的 module 注册**)。 +/// 本模块的路由(**面 A**,`Router::merge` 进总路由)。 pub fn router() -> Router { Router::new() .route("/api/ssw/demo/DemoItem/List", get(demo_item_list)) diff --git a/src/backend/src/modules/shop.rs b/src/backend/src/modules/shop.rs index 7f5fc29..744810e 100644 --- a/src/backend/src/modules/shop.rs +++ b/src/backend/src/modules/shop.rs @@ -1,13 +1,20 @@ //! shop —— 业务模块:Product(物理表 `shop_product`)。 //! -//! 🔴 **业务层模板**:加一个业务模块 = 照抄本文件建 `modules/.rs` -//! (spec + 3 个 handler + 自己的路由),**再在 [`crate::modules::mod`] 里挂一行**。 -//! **平台层(`platform/`)一个字都不用改。** +//! 🔴 **本文件是「面 A 适配器 + spec 的转发点」,不是 spec 的家**: +//! 真源在 `packs/shop/src/lib.rs`(业务包,**只依赖 sspf-sdk**), +//! 本文件只做 `pub use` 转发 ⇒ **spec 只有一份**(`check-arch.sh` 的 PACK1 钉住)。 //! -//! 行为真源:`~/Desktop/workspace/skills/ssw-jnpf-lite-react/src/backend/src/shop/product.entity.ts` -//! (**列名 / 列序逐字对齐** —— 两版后端要能开同一个库)。 +//! 🔴 **面 A 与面 B 各住一处**: +//! - **本文件 = 面 A**(`/api/ssw/shop/Product/…`)—— 本仓自造的 ssw 约定, +//! 留给 Rust 终端场景,**一个字都不改**(前端在用它); +//! - **业务包 = 面 B**(`/api/shop/Product`)—— 官方 JNPF 形状, +//! 集成到官方 Java 时能直接搬。 //! -//! 🔴 本模块的守卫:菜单 `shop/Product`(`module_key`)⇒ 非管理员未授权 ⇒ `code=403`。 +//! 🔴 **DDL 跟着包走**:`shop_product` 的建表语句在 `packs/shop/schema/001_init.sql`, +//! 编译进二进制 ⇒ 不再手抄进 `db/schema.sql`。 +//! +//! 🔴 **本包是示例包**:`packs/shop` 整目录可搬去技能当样板,本文件是它在本仓的 +//! 面 A 适配器(技能带走示例时,这份适配器可以不要)。 use axum::body::Bytes; use axum::extract::{RawQuery, State}; @@ -16,85 +23,17 @@ use axum::routing::{delete, get, post}; use axum::{Json, Router}; use sspf_core::crud::{handle_delete, handle_list, handle_save}; -use sspf_core::entity::{ColumnSpec, EntitySpec}; use sspf_core::envelope::ActionResult; -use sspf_core::menu::MenuSpec; use sspf_core::state::AppState; -use sspf_core::registry; -/// `shop_product` 的列清单(**顺序 = 响应 JSON 的键序**)。 -const PRODUCT_COLUMNS: &[ColumnSpec] = &[ - ColumnSpec { - column: "f_id", - json_key: "id", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_title", - json_key: "title", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_price", - json_key: "price", - default: Some("0.00"), - numeric: true, - }, - ColumnSpec { - column: "f_creator_user_id", - json_key: "creatorUserId", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_creator_time", - json_key: "creatorTime", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_delete_mark", - json_key: "deleteMark", - default: Some("0"), - numeric: false, - }, -]; +// 🔴 **spec 与菜单的单一真源 = 业务包** —— 这里只转发,不重写。 +pub use sspf_pack_shop::PRODUCT_MENU; +pub use sspf_pack_shop::PRODUCT_SPEC; -/// `shop_product` 的 spec。 -pub const PRODUCT_SPEC: EntitySpec = EntitySpec { - app_code: "shop", - entity: "Product", - table: "shop_product", - module_key: Some("shop/Product"), - columns: PRODUCT_COLUMNS, - numeric_columns: &["f_price"], - // 🔴 裁决 S22:非 demo 表 ⇒ `body.creatorUserId || 'admin'`。 - creator_fixed: None, -}; - -/// 🔴 **本模块的内置菜单**(契约 §8.4)—— 业务知识 ⇒ 住在**业务层**。 +/// 本模块的 3 条路由(**面 A**:业务层的路由表)—— 钉子测试遍历它。 /// -/// 🔴 **`url_address` 必须与 [`PRODUCT_SPEC`] 的 `module_key` 一字不差** -/// (都是 `shop/Product`)—— 面 A 的菜单守卫靠它命中。 -pub const PRODUCT_MENU: MenuSpec = MenuSpec { - id: "m_product", - full_name: "产品管理", - // 🔴 **本仓自定的占位编码**(官方 JNPF 没有 shop 模块)⇒ 见 `docs/known-limitations.md` §H。 - en_code: "permission.shop.product", - url_address: "shop/Product", - parent_id: "0", - menu_type: 2, - icon: Some("app"), - sort_code: 7, - system_en_code: registry::MAIN_SYSTEM_CODE, -}; - -/// 本模块的 3 条路由(**业务层的路由表**)—— 钉子测试遍历它。 -/// -/// 🔴 **业务路由清单住在业务层** ⇒ 平台层(`routes.rs`)不认业务路径 -/// ⇒ 加业务模块**不用改平台层**(平台层的钉子测试遍历本表)。 +/// 🔴 路径写字面量(不用下标):`scripts/check-contract-scan.py` 是静态解析, +/// 认不出数组下标 ⇒ 写下标会让契约闸门判「登记了、代码里没有」。 pub const ROUTES: [&str; 3] = [ "/api/ssw/shop/Product/List", "/api/ssw/shop/Product/Save", @@ -127,7 +66,7 @@ pub async fn product_delete( handle_delete(&state, &headers, &PRODUCT_SPEC, &raw).await } -/// 本模块的路由(`Router::merge` 进总路由,**对齐 NestJS 的 module 注册**)。 +/// 本模块的路由(**面 A**,`Router::merge` 进总路由)。 pub fn router() -> Router { Router::new() .route("/api/ssw/shop/Product/List", get(product_list)) diff --git a/src/backend/src/packs_gen.rs b/src/backend/src/packs_gen.rs index 9132627..0a7f06f 100644 --- a/src/backend/src/packs_gen.rs +++ b/src/backend/src/packs_gen.rs @@ -31,6 +31,33 @@ pub fn registry(kernel_version: &str) -> Result { kernel_version, )?); + // ---- books ---- + regs.push(sspf_plugin::load_static( + "books", + BOOKS_MANIFEST_JSON, + Box::new(sspf_pack_books::Pack), + sspf_pack_books::DDLS, + kernel_version, + )?); + + // ---- demo ---- + regs.push(sspf_plugin::load_static( + "demo", + DEMO_MANIFEST_JSON, + Box::new(sspf_pack_demo::Pack), + sspf_pack_demo::DDLS, + kernel_version, + )?); + + // ---- shop ---- + regs.push(sspf_plugin::load_static( + "shop", + SHOP_MANIFEST_JSON, + Box::new(sspf_pack_shop::Pack), + sspf_pack_shop::DDLS, + kernel_version, + )?); + Ok(sspf_plugin::merge(regs)) } @@ -58,3 +85,57 @@ const ASSET_MANIFEST_JSON: &str = r#"{ ] } }"#; + +/// `packs/books/pack.toml` 的编译期快照。 +const BOOKS_MANIFEST_JSON: &str = r#"{ + "pack": { + "app_code": "books", + "name": "图书超市", + "version": "1.0.0", + "kernel": ">=0.4,<0.5", + "migratable": true, + "tables": [ + { + "name": "book_shop_book", + "ddl": "schema/001_init.sql", + "baseline_table": "book_shop_book" + } + ] + } +}"#; + +/// `packs/demo/pack.toml` 的编译期快照。 +const DEMO_MANIFEST_JSON: &str = r#"{ + "pack": { + "app_code": "demo", + "name": "Demo 示例", + "version": "1.0.0", + "kernel": ">=0.4,<0.5", + "migratable": true, + "tables": [ + { + "name": "demo_item", + "ddl": "schema/001_init.sql", + "baseline_table": "demo_item" + } + ] + } +}"#; + +/// `packs/shop/pack.toml` 的编译期快照。 +const SHOP_MANIFEST_JSON: &str = r#"{ + "pack": { + "app_code": "shop", + "name": "产品管理", + "version": "1.0.0", + "kernel": ">=0.4,<0.5", + "migratable": true, + "tables": [ + { + "name": "shop_product", + "ddl": "schema/001_init.sql", + "baseline_table": "shop_product" + } + ] + } +}"#; diff --git a/src/backend/src/routes.rs b/src/backend/src/routes.rs index b49226b..295ca62 100644 --- a/src/backend/src/routes.rs +++ b/src/backend/src/routes.rs @@ -4,7 +4,7 @@ //! //! 🔴 **三层兜底的挂法**(控制器裁决 S25)—— **唯一真源**是 [`build_app`]: //! ```text -//! build_app(state) // ← 生产(main.rs)与单测都调它 +//! build_app(state) // ← 生产(crates/sspf-admin/src/main.rs)与单测都调它 //! build_router(state.clone()) //! .fallback(not_found_handler) // 404 兜底 //! .layer(m_status_rewrite()) // 405 / 413 改写中间件 @@ -1473,88 +1473,88 @@ pub fn build_router(state: AppState) -> axum::Router { // `onlineDev.formDesign` / `onlineDev.sysForm` / `generator.flowForm` / // `generator.webForm` 三选一(OR),`onlineDev.visualPortal` 单选。 - .route("/api/visualdev/Base", get(compat::online_dev::visual_dev_list)) - .route("/api/visualdev/Base/list", get(compat::online_dev::visual_dev_form_list)) - .route("/api/visualdev/Base/Selector", get(compat::online_dev::visual_dev_selector)) - .route("/api/visualdev/Base/getColumnList", get(compat::online_dev::visual_dev_column_list)) - .route("/api/visualdev/Base/getListBySystem", get(compat::online_dev::visual_dev_list_by_system)) - .route("/api/visualdev/Base", post(compat::online_dev::visual_dev_create)) - .route("/api/visualdev/Base/{id}", get(compat::online_dev::visual_dev_info)) - .route("/api/visualdev/Base/{id}", put(compat::online_dev::visual_dev_update)) - .route("/api/visualdev/Base/{id}", delete(compat::online_dev::visual_dev_delete)) - .route("/api/visualdev/Base/{id}/Actions/Copy", post(compat::online_dev::visual_dev_copy)) - .route("/api/visualdev/Base/{id}/Actions/Release", post(compat::online_dev::visual_dev_release)) - .route("/api/visualdev/Base/{id}/getReleaseMenu", get(compat::online_dev::visual_dev_release_menu)) - .route("/api/visualdev/Base/{id}/Actions/Module", post(compat::online_dev::visual_dev_create_menu)) - .route("/api/visualdev/Base/{id}/FormDataFields", get(compat::online_dev::visual_dev_form_data_fields)) - .route("/api/visualdev/Base/{id}/FieldDataSelect", get(compat::online_dev::visual_dev_field_data_select)) - .route("/api/visualdev/Generater/{id}/Actions/DownloadCode", post(compat::online_dev::generater_download_code)) - .route("/api/visualdev/Generater/{id}/Actions/CodePreview", post(compat::online_dev::generater_code_preview)) - .route("/api/visualdev/Generater/{id}/Alias/Info", get(compat::online_dev::generater_alias_info)) - .route("/api/visualdev/Generater/{id}/Alias/Save", post(compat::online_dev::generater_alias_save)) - .route("/api/visualdev/OnlineDev/{model_id}/Config", get(compat::online_dev::online_dev_config)) - .route("/api/visualdev/OnlineDev/Config", get(compat::online_dev::online_dev_config_by_menu)) - .route("/api/visualdev/OnlineDev/{model_id}/FormData", get(compat::online_dev::online_dev_form_data)) - .route("/api/visualdev/OnlineDev/{model_id}/List", post(compat::online_dev::online_dev_model_list)) - .route("/api/visualdev/OnlineDev/{model_id}", post(compat::online_dev::online_dev_create_model)) - .route("/api/visualdev/OnlineDev/{model_id}/{id}", put(compat::online_dev::online_dev_update_model)) - .route("/api/visualdev/OnlineDev/{model_id}/{id}", get(compat::online_dev::online_dev_model_info)) - .route("/api/visualdev/OnlineDev/{model_id}/{id}", delete(compat::online_dev::online_dev_delete_model)) - .route("/api/visualdev/OnlineDev/batchDelete/{model_id}", post(compat::online_dev::online_dev_batch_delete)) - .route("/api/visualdev/OnlineDev/{model_id}/DataChange", post(compat::online_dev::online_dev_data_change)) - .route("/api/visualdev/OnlineDev/{model_id}/Actions/ExportData", post(compat::online_dev::online_dev_export_model)) - .route("/api/visualdev/OnlineDev/{model_id}/Template", get(compat::online_dev::online_dev_template)) - .route("/api/visualdev/OnlineDev/{model_id}/Actions/Export", post(compat::online_dev::online_dev_export)) - .route("/api/visualdev/OnlineDev/{model_id}/actionLaunchFlow", post(compat::online_dev::online_dev_launch_flow)) - .route("/api/visualdev/OnlineDev/RelationQuery", post(compat::online_dev::online_dev_relation_query)) - .route("/api/visualdev/OnlineLog", get(compat::online_dev::online_log_list)) - .route("/api/visualdev/personal", get(compat::online_dev::personal_list)) - .route("/api/visualdev/personal", post(compat::online_dev::personal_create)) - .route("/api/visualdev/personal/{id}", put(compat::online_dev::personal_update)) - .route("/api/visualdev/personal/{id}/setDefault", put(compat::online_dev::personal_set_default)) - .route("/api/visualdev/personal/{id}", delete(compat::online_dev::personal_delete)) - .route("/api/visualdev/share", get(compat::online_dev::share_list)) - .route("/api/visualdev/share/SelectedList", post(compat::online_dev::share_selected_list)) - .route("/api/visualdev/share/save", post(compat::online_dev::share_save)) - .route("/api/visualdev/share/Selector", get(compat::online_dev::share_selector)) - .route("/api/visualdev/ocr", post(compat::online_dev::ocr_recognize)) - .route("/api/visualdev/ShortLink/{id}", get(compat::online_dev::short_link_info)) - .route("/api/visualdev/ShortLink", put(compat::online_dev::short_link_save)) - .route("/api/visualdev/ShortLink/getConfig/{id}", get(compat::online_dev::short_link_get_config)) - .route("/api/visualdev/ShortLink/{id}/Config", get(compat::online_dev::short_link_get_config)) - .route("/api/visualdev/ShortLink/checkPwd", post(compat::online_dev::short_link_check_pwd)) - .route("/api/visualdev/ShortLink/Config", get(compat::online_dev::short_link_config_data)) - .route("/api/visualdev/ShortLink/{id}/ListLink", post(compat::online_dev::short_link_model_list)) - .route("/api/visualdev/ShortLink/{id}", post(compat::online_dev::short_link_create_model)) - .route("/api/visualdev/ShortLink/{id}/{id}/DataChange", get(compat::online_dev::short_link_data_change)) - .route("/api/visualdev/Portal", get(compat::online_dev::portal_list)) - .route("/api/visualdev/Portal/{id}", get(compat::online_dev::portal_info)) - .route("/api/visualdev/Portal", post(compat::online_dev::portal_create)) - .route("/api/visualdev/Portal/{id}", put(compat::online_dev::portal_update)) - .route("/api/visualdev/Portal/{id}", delete(compat::online_dev::portal_delete)) - .route("/api/visualdev/Portal/{id}/Actions/Copy", post(compat::online_dev::portal_copy)) - .route("/api/visualdev/Portal/{id}/Actions/Export", post(compat::online_dev::portal_export)) - .route("/api/visualdev/Portal/Selector", get(compat::online_dev::portal_selector)) - .route("/api/visualdev/Portal/Selector/Menu", get(compat::online_dev::portal_home_list)) - .route("/api/visualdev/Portal/{id}/Actions/SetDefault", put(compat::online_dev::portal_set_default)) - .route("/api/visualdev/Portal/{id}/auth", get(compat::online_dev::portal_auth)) - .route("/api/visualdev/Portal/Custom/Save/{id}", put(compat::online_dev::portal_custom_save)) - .route("/api/visualdev/Portal/Actions/release/{id}", put(compat::online_dev::portal_release)) - .route("/api/visualdev/Portal/systemFilter/{id}", get(compat::online_dev::portal_system_filter)) - .route("/api/visualdev/Portal/manage/Selector/{system_id}", get(compat::online_dev::portal_manage_selector)) - .route("/api/system/PortalManage/list/{system_id}", get(compat::online_dev::portal_manage_list)) - .route("/api/system/PortalManage/{id}", get(compat::online_dev::portal_manage_info)) - .route("/api/system/PortalManage", post(compat::online_dev::portal_manage_create)) - .route("/api/system/PortalManage/{id}", put(compat::online_dev::portal_manage_update)) - .route("/api/system/PortalManage/{id}", delete(compat::online_dev::portal_manage_delete)) - .route("/api/visualdev/Dashboard/Notice", post(compat::online_dev::dashboard_notice)) - .route("/api/visualdev/Dashboard/Email", get(compat::online_dev::dashboard_email)) - .route("/api/system/atlas", get(compat::online_dev::atlas_list)) - .route("/api/system/atlas/geojson", get(compat::online_dev::atlas_geojson)) + .route("/api/visualdev/Base", get(compat::onlinedev::visual_dev_list)) + .route("/api/visualdev/Base/list", get(compat::onlinedev::visual_dev_form_list)) + .route("/api/visualdev/Base/Selector", get(compat::onlinedev::visual_dev_selector)) + .route("/api/visualdev/Base/getColumnList", get(compat::onlinedev::visual_dev_column_list)) + .route("/api/visualdev/Base/getListBySystem", get(compat::onlinedev::visual_dev_list_by_system)) + .route("/api/visualdev/Base", post(compat::onlinedev::visual_dev_create)) + .route("/api/visualdev/Base/{id}", get(compat::onlinedev::visual_dev_info)) + .route("/api/visualdev/Base/{id}", put(compat::onlinedev::visual_dev_update)) + .route("/api/visualdev/Base/{id}", delete(compat::onlinedev::visual_dev_delete)) + .route("/api/visualdev/Base/{id}/Actions/Copy", post(compat::onlinedev::visual_dev_copy)) + .route("/api/visualdev/Base/{id}/Actions/Release", post(compat::onlinedev::visual_dev_release)) + .route("/api/visualdev/Base/{id}/getReleaseMenu", get(compat::onlinedev::visual_dev_release_menu)) + .route("/api/visualdev/Base/{id}/Actions/Module", post(compat::onlinedev::visual_dev_create_menu)) + .route("/api/visualdev/Base/{id}/FormDataFields", get(compat::onlinedev::visual_dev_form_data_fields)) + .route("/api/visualdev/Base/{id}/FieldDataSelect", get(compat::onlinedev::visual_dev_field_data_select)) + .route("/api/visualdev/Generater/{id}/Actions/DownloadCode", post(compat::onlinedev::generater_download_code)) + .route("/api/visualdev/Generater/{id}/Actions/CodePreview", post(compat::onlinedev::generater_code_preview)) + .route("/api/visualdev/Generater/{id}/Alias/Info", get(compat::onlinedev::generater_alias_info)) + .route("/api/visualdev/Generater/{id}/Alias/Save", post(compat::onlinedev::generater_alias_save)) + .route("/api/visualdev/OnlineDev/{model_id}/Config", get(compat::onlinedev::online_dev_config)) + .route("/api/visualdev/OnlineDev/Config", get(compat::onlinedev::online_dev_config_by_menu)) + .route("/api/visualdev/OnlineDev/{model_id}/FormData", get(compat::onlinedev::online_dev_form_data)) + .route("/api/visualdev/OnlineDev/{model_id}/List", post(compat::onlinedev::online_dev_model_list)) + .route("/api/visualdev/OnlineDev/{model_id}", post(compat::onlinedev::online_dev_create_model)) + .route("/api/visualdev/OnlineDev/{model_id}/{id}", put(compat::onlinedev::online_dev_update_model)) + .route("/api/visualdev/OnlineDev/{model_id}/{id}", get(compat::onlinedev::online_dev_model_info)) + .route("/api/visualdev/OnlineDev/{model_id}/{id}", delete(compat::onlinedev::online_dev_delete_model)) + .route("/api/visualdev/OnlineDev/batchDelete/{model_id}", post(compat::onlinedev::online_dev_batch_delete)) + .route("/api/visualdev/OnlineDev/{model_id}/DataChange", post(compat::onlinedev::online_dev_data_change)) + .route("/api/visualdev/OnlineDev/{model_id}/Actions/ExportData", post(compat::onlinedev::online_dev_export_model)) + .route("/api/visualdev/OnlineDev/{model_id}/Template", get(compat::onlinedev::online_dev_template)) + .route("/api/visualdev/OnlineDev/{model_id}/Actions/Export", post(compat::onlinedev::online_dev_export)) + .route("/api/visualdev/OnlineDev/{model_id}/actionLaunchFlow", post(compat::onlinedev::online_dev_launch_flow)) + .route("/api/visualdev/OnlineDev/RelationQuery", post(compat::onlinedev::online_dev_relation_query)) + .route("/api/visualdev/OnlineLog", get(compat::onlinedev::online_log_list)) + .route("/api/visualdev/personal", get(compat::onlinedev::personal_list)) + .route("/api/visualdev/personal", post(compat::onlinedev::personal_create)) + .route("/api/visualdev/personal/{id}", put(compat::onlinedev::personal_update)) + .route("/api/visualdev/personal/{id}/setDefault", put(compat::onlinedev::personal_set_default)) + .route("/api/visualdev/personal/{id}", delete(compat::onlinedev::personal_delete)) + .route("/api/visualdev/share", get(compat::onlinedev::share_list)) + .route("/api/visualdev/share/SelectedList", post(compat::onlinedev::share_selected_list)) + .route("/api/visualdev/share/save", post(compat::onlinedev::share_save)) + .route("/api/visualdev/share/Selector", get(compat::onlinedev::share_selector)) + .route("/api/visualdev/ocr", post(compat::onlinedev::ocr_recognize)) + .route("/api/visualdev/ShortLink/{id}", get(compat::onlinedev::short_link_info)) + .route("/api/visualdev/ShortLink", put(compat::onlinedev::short_link_save)) + .route("/api/visualdev/ShortLink/getConfig/{id}", get(compat::onlinedev::short_link_get_config)) + .route("/api/visualdev/ShortLink/{id}/Config", get(compat::onlinedev::short_link_get_config)) + .route("/api/visualdev/ShortLink/checkPwd", post(compat::onlinedev::short_link_check_pwd)) + .route("/api/visualdev/ShortLink/Config", get(compat::onlinedev::short_link_config_data)) + .route("/api/visualdev/ShortLink/{id}/ListLink", post(compat::onlinedev::short_link_model_list)) + .route("/api/visualdev/ShortLink/{id}", post(compat::onlinedev::short_link_create_model)) + .route("/api/visualdev/ShortLink/{id}/{id}/DataChange", get(compat::onlinedev::short_link_data_change)) + .route("/api/visualdev/Portal", get(compat::onlinedev::portal_list)) + .route("/api/visualdev/Portal/{id}", get(compat::onlinedev::portal_info)) + .route("/api/visualdev/Portal", post(compat::onlinedev::portal_create)) + .route("/api/visualdev/Portal/{id}", put(compat::onlinedev::portal_update)) + .route("/api/visualdev/Portal/{id}", delete(compat::onlinedev::portal_delete)) + .route("/api/visualdev/Portal/{id}/Actions/Copy", post(compat::onlinedev::portal_copy)) + .route("/api/visualdev/Portal/{id}/Actions/Export", post(compat::onlinedev::portal_export)) + .route("/api/visualdev/Portal/Selector", get(compat::onlinedev::portal_selector)) + .route("/api/visualdev/Portal/Selector/Menu", get(compat::onlinedev::portal_home_list)) + .route("/api/visualdev/Portal/{id}/Actions/SetDefault", put(compat::onlinedev::portal_set_default)) + .route("/api/visualdev/Portal/{id}/auth", get(compat::onlinedev::portal_auth)) + .route("/api/visualdev/Portal/Custom/Save/{id}", put(compat::onlinedev::portal_custom_save)) + .route("/api/visualdev/Portal/Actions/release/{id}", put(compat::onlinedev::portal_release)) + .route("/api/visualdev/Portal/systemFilter/{id}", get(compat::onlinedev::portal_system_filter)) + .route("/api/visualdev/Portal/manage/Selector/{system_id}", get(compat::onlinedev::portal_manage_selector)) + .route("/api/system/PortalManage/list/{system_id}", get(compat::onlinedev::portal_manage_list)) + .route("/api/system/PortalManage/{id}", get(compat::onlinedev::portal_manage_info)) + .route("/api/system/PortalManage", post(compat::onlinedev::portal_manage_create)) + .route("/api/system/PortalManage/{id}", put(compat::onlinedev::portal_manage_update)) + .route("/api/system/PortalManage/{id}", delete(compat::onlinedev::portal_manage_delete)) + .route("/api/visualdev/Dashboard/Notice", post(compat::onlinedev::dashboard_notice)) + .route("/api/visualdev/Dashboard/Email", get(compat::onlinedev::dashboard_email)) + .route("/api/system/atlas", get(compat::onlinedev::atlas_list)) + .route("/api/system/atlas/geojson", get(compat::onlinedev::atlas_geojson)) // ---- 大屏 blade-visual(批次 25):官方 `jnpf-visualdata` 8 个 Controller ---- // // 🔴 **端点全集 53 条,其中 52 条本批新增**(`visual/Selector` 原先挂在 - // `compat::online_dev::datav_selector`,是「没有 DataV 组件库」的恒失败实现; + // `compat::onlinedev::datav_selector`,是「没有 DataV 组件库」的恒失败实现; // 本批**改由 `compat::visualdata::visual_selector` 真实实现** —— 官方该端点 // 就是「分类 → 大屏」两级下拉树,数据源是 `blade_visual_category` + // `blade_visual`,本仓**两张表都在** ⇒ 能做,不必降级)。 @@ -2530,7 +2530,7 @@ pub fn build_router(state: AppState) -> axum::Router { router.with_state(state) } -/// 完整装配(**唯一权威的装配链**)—— 生产(`main.rs`)与单测**都调它**。 +/// 完整装配(**唯一权威的装配链**)—— 生产(`crates/sspf-admin/src/main.rs`)与单测**都调它**。 /// /// 🔴 顺序即 S25 的要害:`.fallback()` 必须在两个 `.layer()` **之前** /// (axum:`layer` 只作用于**已注册**的路由)⇒ 否则 404 兜底不在中间件保护范围内。 @@ -2538,7 +2538,7 @@ pub fn build_router(state: AppState) -> axum::Router { /// 🔴 `with_state` 是**链尾**(唯一一次把类型落成 `Router<()>`)。 /// /// 🔴 **这条链在仓库里只有这一份** —— 生产与测试共用 ⇒ 改顺序时两边一起变, -/// 测试永远钉得住(不要在 `main.rs` 或测试里再抄一遍)。 +/// 测试永远钉得住(不要在 `crates/sspf-admin/src/main.rs` 或测试里再抄一遍)。 pub fn build_app(state: AppState) -> axum::Router { build_router(state.clone()) .fallback(not_found_handler) diff --git a/src/backend/src/test_support.rs b/src/backend/src/test_support.rs index facd40c..f642c49 100644 --- a/src/backend/src/test_support.rs +++ b/src/backend/src/test_support.rs @@ -26,7 +26,7 @@ pub async fn shared_db() -> &'static Db { .get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); // 🔴 **平台表 + 业务包的表**(批次 12 交付物 ③)—— - // 与 `main.rs` 的第 4 步**同一套装配**(同一个装配根) + // 与 `crates/sspf-admin/src/main.rs` 的第 4 步**同一套装配**(同一个装配根) // ⇒ 「测试里的库 == 线上库」这条约定是**结构性的**,不是靠人记得同步。 crate::bootstrap::ensure_schema_all(&db) .await diff --git a/src/frontend/vite.config.ts b/src/frontend/vite.config.ts index 47f914f..900e49d 100644 --- a/src/frontend/vite.config.ts +++ b/src/frontend/vite.config.ts @@ -12,7 +12,7 @@ export default defineConfig({ // // 🔴 **端口是 30010,不是技能模板里的 30000**: // React 技能模板的后端是 NestJS(:30000),而本仓后端换成了 Rust - // (`src/backend/src/main.rs` 的 `PORT` 缺省 **30010**)。 + // (`crates/sspf-admin/src/main.rs` 的 `PORT` 缺省 **30010**)。 // ⇒ 照抄模板不改这里,前端每个请求都会 502,而浏览器只会说「Network Error」 // —— 排查时最容易怀疑「跨域 / 认证」,其实只是端口抄错了。 // 改后端默认端口时,这里要跟着改(或用 `PORT=` 起后端时同样指定)。