From dc54e8bd1df49641fd50732eaaebc3c1aeab2b20 Mon Sep 17 00:00:00 2001 From: admin Date: Thu, 5 Nov 2026 09:28:48 +0800 Subject: [PATCH] =?UTF-8?q?refactor(dep):=20=E5=B9=B3=E5=8F=B0=E4=BE=9D?= =?UTF-8?q?=E8=B5=96=E6=94=B9=E4=B8=BA=20vendor=20=E5=8F=91=E5=B8=83?= =?UTF-8?q?=E5=8C=85=EF=BC=8C=E5=8E=BB=E6=8E=89=20git=20=E4=BE=9D=E8=B5=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Cargo.toml 的 sspf 由 git tag 改为 path 指向 vendor/sspf-v0.5.0/crates/sspf。 - 新增 scripts/fetch-platform.sh:解包平台发布包到 vendor/(含离线校验)。 - [workspace] exclude vendor/,避免包内 crate 被误并入职本仓 workspace。 - .gitignore 忽略 vendor/;SKILL/README/CLAUDE/HANDOFF/runbook 同步说明新模型。 --- .gitignore | 4 +++ CLAUDE.md | 12 ++++---- Cargo.lock | 18 ------------ Cargo.toml | 13 ++++++-- HANDOFF.md | 4 +-- README.md | 16 ++++++---- SKILL.md | 22 ++++++++------ docs/runbook.md | 2 +- scripts/fetch-platform.sh | 62 +++++++++++++++++++++++++++++++++++++++ 9 files changed, 110 insertions(+), 43 deletions(-) create mode 100755 scripts/fetch-platform.sh diff --git a/.gitignore b/.gitignore index e35f14e..5052d33 100644 --- a/.gitignore +++ b/.gitignore @@ -2,6 +2,10 @@ target/ **/target/ +# 🔴 平台发布包(2026-11-05 依赖模型变更):由 scripts/fetch-platform.sh 解包进来, +# 不进版本库。升版本重跑 fetch 即可,Cargo.toml 的行指向新目录。 +vendor/ + # 运行期数据(pglite 数据目录) src/backend/data/ src/backend/data.bak-*/ diff --git a/CLAUDE.md b/CLAUDE.md index 5f1725c..e01a8b2 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,8 +8,10 @@ **ssw-jnpf-lite-rust** = **JNPF 兼容契约的 Rust 业务样板**(单二进制、零外部服务)。 -🔴 **平台不在本仓**(2026-11-04 架构变更):登录 / 权限 / 面 A·B / 低代码 / MCP / 177 张 -`base_*` 表在**已发布的 `sspf` 包**里(`Cargo.toml` 的 `git` + `tag = "v0.5.0"`)。 +🔴 **平台不在本仓**(2026-11-04 → 2026-11-05 架构变更):登录 / 权限 / 面 A·B / 低代码 / MCP / 177 张 +`base_*` 表在**已发布的 `sspf` 包**里——平台仓每版本 `bash scripts/release.sh` 打出自包含发布包, +本仓 `bash scripts/fetch-platform.sh vX.Y.Z` 解包到 `vendor/sspf-vX.Y.Z/`,`Cargo.toml` 用 `path` 指进去 +(**不再直接依赖 git 仓**)。 本仓只有 **业务包 `packs/` + 面 A 适配器 `modules/` + 薄装配 `main.rs` + 前端产物 + 两把尺子**。 以前这里有一份 4000 行的平台实现(`src/backend/src/platform/` + `routes.rs`),已整体删除 —— **不要把它抄回来**:`python3 scripts/check-scaffold.py` 的 SC1 会立刻红。 @@ -84,8 +86,8 @@ ssw-jnpf-lite-rust/ # 【仓根 = 技能根】三处软链 ~/.agents · ├── MIGRATION.md # 迁移指南(Rust ⇄ NestJS ⇄ 官方 JNPF Java) ├── JNPF_SOURCE_AUDIT.md # 官方源码逐行核对报告 ├── JNPF_COMPAT_SURFACE.md # 面 B 规格书 + 落地顺序 S1–S6 -├── Cargo.toml # 【workspace 根】members = ["src/backend", "packs/*"] -│ # 🔴 唯一的平台依赖:sspf = { git = "...", tag = "v0.5.0" } +├── Cargo.toml # 【workspace 根】members = ["src/backend", "packs/*"],exclude = ["vendor"] +│ # 🔴 唯一的平台依赖:sspf = { path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5" } ├── CLAUDE.md / HANDOFF.md # 本文件 / 交接文档 ├── run.sh # install / build / dev / backend / frontend / stop / logs ├── packs/ # 【业务真源】整目录可搬;每个包只依赖 sspf 门面 @@ -154,7 +156,7 @@ ssw-jnpf-lite-rust/ # 【仓根 = 技能根】三处软链 ~/.agents · 11. 🔴 **面 B 未登录返 `code=602`**,不是 `600`。官方前端 `request.ts` 只对 `601`/`602` 清 token ⇒ 返 `600` 会让官方前端卡死不跳登录页。面 A 仍是 `600`(**冻结**)。 12. 🔴 **平台 / 业务分离(靠仓库边界,不靠目录纪律)。** - - **平台** = 已发布的 `sspf` 包(`Cargo.toml` 的 git tag)—— **不在本仓**。 + - **平台** = 已发布的 `sspf` 包(本仓 `vendor/sspf-vX.Y.Z/`,由平台仓出包、本仓 `fetch-platform.sh` 解包)—— **不在本仓**。 它自带登录 / 权限 / `base_*` / 面 B / CRUD 引擎 / 177 张表。 - **业务** = `packs//`(真源:表 DDL + 列 + 菜单 + 面 B 路由)+ `src/backend/src/modules/.rs`(面 A 适配器,只 `pub use` 转发 spec)。 diff --git a/Cargo.lock b/Cargo.lock index 61139d7..65bbaca 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1069,7 +1069,6 @@ dependencies = [ [[package]] name = "sspf" version = "0.5.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "axum", "libc", @@ -1086,7 +1085,6 @@ dependencies = [ [[package]] name = "sspf-compat-core" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "axum", "serde", @@ -1098,7 +1096,6 @@ dependencies = [ [[package]] name = "sspf-compat-ext" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "axum", "chrono", @@ -1114,7 +1111,6 @@ dependencies = [ [[package]] name = "sspf-compat-msg" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "axum", "chrono", @@ -1128,7 +1124,6 @@ dependencies = [ [[package]] name = "sspf-compat-onlinedev" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "axum", "serde", @@ -1141,7 +1136,6 @@ dependencies = [ [[package]] name = "sspf-compat-permission" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "axum", "chrono", @@ -1157,7 +1151,6 @@ dependencies = [ [[package]] name = "sspf-compat-system" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "axum", "chrono", @@ -1172,7 +1165,6 @@ dependencies = [ [[package]] name = "sspf-compat-workflow" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "aes", "axum", @@ -1189,7 +1181,6 @@ dependencies = [ [[package]] name = "sspf-contract" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "http", "serde", @@ -1200,7 +1191,6 @@ dependencies = [ [[package]] name = "sspf-core" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "aes", "axum", @@ -1221,7 +1211,6 @@ dependencies = [ [[package]] name = "sspf-lowcode" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "serde", "serde_json", @@ -1231,7 +1220,6 @@ dependencies = [ [[package]] name = "sspf-lowcode-exec" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "chrono", "pglite-rs", @@ -1245,7 +1233,6 @@ dependencies = [ [[package]] name = "sspf-mcp" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "serde", "serde_json", @@ -1256,7 +1243,6 @@ dependencies = [ [[package]] name = "sspf-mcp-adapter" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "axum", "pglite-rs", @@ -1303,7 +1289,6 @@ dependencies = [ [[package]] name = "sspf-plugin" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "serde", "serde_json", @@ -1314,7 +1299,6 @@ dependencies = [ [[package]] name = "sspf-sdk" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "sspf-contract", ] @@ -1322,7 +1306,6 @@ dependencies = [ [[package]] name = "sspf-store" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "chrono", "pglite-rs", @@ -1347,7 +1330,6 @@ dependencies = [ [[package]] name = "ssw-platform" version = "0.1.0" -source = "git+http://127.0.0.1:13300/ssw/ssw-platform.git?tag=v0.5.0#509c6b1d1fe76809c805c7e5c46a7d29a58420a6" dependencies = [ "aes", "axum", diff --git a/Cargo.toml b/Cargo.toml index e9def11..bc6fbff 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -14,6 +14,11 @@ [workspace] members = ["src/backend", "packs/*"] +# 🔴 **exclude vendor/**:平台发布包解包在这里(`vendor/sspf-vX.Y.Z/`),它自带 +# 自己的 workspace 根(含 `[workspace.dependencies]`)。若不 exclude,cargo 会把 +# 包内 crate 误并入职本仓 workspace,导致 `libc` 等 `workspace = true` 继承解析失败。 +# exclude 后,包内 crate 用包自己的 workspace 根解析,path 依赖照常工作。 +exclude = ["vendor"] resolver = "2" [workspace.package] @@ -24,8 +29,12 @@ rust-version = "1.85" [workspace.dependencies] # 🔴 **平台包**:业务仓 / 技能仓唯一该依赖的东西。 -# 升版本 = 改这个 tag(平台仓 `git tag` 已发布的那一个)。 -sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", tag = "v0.5.0" } +# 依赖模型(2026-11-05 变更):不再直接依赖 git 仓,改为平台仓每版本打出的 +# **自包含发布包**(见平台仓 `docs/SSPF-PLATFORM-PACKAGE.md` §6)。 +# 包由 `bash scripts/fetch-platform.sh vX.Y.Z` 解包到 `vendor/sspf-vX.Y.Z/`, +# 本行用 path 指进去;版本按目录名钉死。 +# 升版本 = 改这一行(路径 + version 一起改),不许在任何成员里写第二份。 +sspf = { path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5" } # 🔴 业务侧还需要的东西(平台不替我们决定 web 框架的版本) axum = "0.8" diff --git a/HANDOFF.md b/HANDOFF.md index d1c6f83..adc7cee 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -17,7 +17,7 @@ `bootstrap.rs`、`db/schema.sql`、`tests/`(7 个集成测试,测的是被删的那份实现)。 备份在 `/tmp/skill-backup/backend-2216/`。 2. **平台改为依赖已发布包**:根 `Cargo.toml` 的 - `[workspace.dependencies] sspf = { git = ".../ssw-platform.git", tag = "v0.4.0" }`, + `[workspace.dependencies] sspf = { path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5" }`(由 `scripts/fetch-platform.sh` 解包进来), 成员一律 `sspf = { workspace = true }`。解析结果: `sspf v0.4.0 (...?tag=v0.4.0#ff34ca50)`,**0 个 `sspf-pack-*` 被平台带进来**。 3. **示例业务包迁入**:`packs/{demo,shop,books,asset}/`(表 DDL + 列 + 菜单 + 面 B 路由), @@ -44,7 +44,7 @@ | 项 | 结果 | |---|---| -| `cargo check --workspace` / `cargo build --release` | ✅ 通过(首次拉 git 依赖,之后走 `~/.cargo/git` 缓存) | +| `cargo check --workspace` / `cargo build --release` | ✅ 通过(平台来自 `vendor/sspf-v0.5.0/` 的 path 依赖,无需 Gitea;`cargo build --offline` 亦可) | | `cargo test --workspace` | ✅ 全绿(4 个包各自 14/14/3/3 条包自检 + 应用单测) | | `python3 scripts/check-scaffold.py` | ✅ PASS=6 FAIL=0 | | `python3 scripts/check-scaffold.py --self-test` | ✅ 反自证 6/6 | diff --git a/README.md b/README.md index bea1c69..1ebdb8d 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,16 @@ # ssw-jnpf-lite-rust · Rust 全栈 MVP -**平台来自已发布的 `sspf` 包**(`Cargo.toml` 里 `git` + `tag = "v0.5.0"`),本仓只有 +**平台来自 `sspf` 发布包**(`vendor/sspf-v0.5.0/` 由平台仓 `scripts/release.sh` 产出、本仓 +`scripts/fetch-platform.sh` 解包,不再直接依赖 git 仓),本仓只有 **业务样板(`packs/`)+ 面 A 适配器 + 薄装配 + 前端产物 + 两把运行时尺子**。 数据库仍是**进程内原生 PostgreSQL**(由平台包提供),除 Node 外无需装任何东西。 -> 🔴 **2026-11-04 架构变更**:以前本仓自带一份平台实现(`src/backend/src/platform/` + `routes.rs`,约 4000 行), -> 那是「示例仓里躺着一份会分叉的平台」。现在平台只在 `sspf` 一处演进,本仓锁 tag; -> 升级平台 = 改 `Cargo.toml` 里那一行,业务代码不动。 +> 🔴 **2026-11-04 → 2026-11-05 架构变更**:以前本仓自带一份平台实现(`src/backend/src/platform/` + `routes.rs`,约 4000 行), +> 那是「示例仓里躺着一份会分叉的平台」。2026-11-04 平台搬进 `sspf` 一处演进,本仓**锁 git tag**; +> 2026-11-05 进一步改为**每版本出包**(平台仓 `scripts/release.sh` 打 `dist/sspf-vX.Y.Z.tar.gz`,本仓 +> `scripts/fetch-platform.sh` 解包到 `vendor/sspf-vX.Y.Z/`),`Cargo.toml` 用 `path` 指进去—— +> **不再需要 Gitea 访问、不再 clone 整个 monorepo、不再每次重编 20+ crate**。 +> 升级平台 = 改 `Cargo.toml` 里那一行 `path`(路径 + version 一起改),业务代码不动。 > 判据:`python3 scripts/check-scaffold.py`(本仓出现 `platform/` / `routes.rs` / `crates/` 立刻红)。 来自 `ssw-jnpf-lite-react`(NestJS + React)的 **Rust 全栈 counterpart**——两者是**并列可选**的独立技能, @@ -68,7 +72,7 @@ ssw-jnpf-lite-rust/ ← 仓根 = 技能根(三处软链指向这里 ├── JNPF_COMPAT_SURFACE.md # 面 B 规格书:官方形状端点 + 落地顺序 S1–S6 ├── CLAUDE.md / HANDOFF.md # 项目级 agent 指引 / 交接文档 ├── run.sh # install / build / dev / backend / frontend / stop / logs -├── Cargo.toml # 🔴 workspace 根:**唯一的平台依赖**(sspf 的 git tag)就在这儿 +├── Cargo.toml # 🔴 workspace 根:**唯一的平台依赖**(sspf 的 path 指向 vendor/sspf-vX.Y.Z)就在这儿 ├── .env.example # PORT / BIND_ADDR / PGLITE_DIR ├── scripts/ │ ├── verify.sh # 一键验收(静态 + 全量测试 + 两把运行时尺子) @@ -143,7 +147,7 @@ cd "$PROJ" && cp .env.example .env && ./run.sh install && ./run.sh dev > ⚠️ **只复制脚手架本体**——`*.md` / `references/` / `template-boot-jnpf/` / `docs/` 是技能资产, > 留在技能目录只读引用。全量 `cp -R` 会让项目目录混满技能噪音,日后技能升级也灌不进项目。 > 🔴 **`packs/` 必须一起复制**:业务真源在包里 ⇒ 少了它应用能起但**面 A 全 404**。 -> 🔴 **`Cargo.toml`(workspace 根)别漏**:`sspf` 的 git tag 就在里面, +> 🔴 **`Cargo.toml`(workspace 根)别漏**:`sspf` 的 `path` 依赖(指向 `vendor/sspf-vX.Y.Z/crates/sspf`)就在里面, > 缺了它 `src/backend` 的 `workspace = true` 继承无处可依 ⇒ 编译不起来。 ## 验收门 diff --git a/SKILL.md b/SKILL.md index ce32ce0..4c63d03 100644 --- a/SKILL.md +++ b/SKILL.md @@ -1,6 +1,6 @@ --- name: ssw-jnpf-lite-rust -description: Rust 全栈 MVP 脚手架(**平台来自已发布的 sspf 包,锁 git tag**;本仓只有业务样板 + 薄装配 + 前端产物 + 尺子),契约与数据模型从第一天起对齐 JNPF 标准版(cipher / ActionResult / f_ 列 / varchar(50) UUID / base_* 权限表 / 进程内原生 PostgreSQL),前后端同一进程同时提供「面 A(ssw 契约 30 条)」与「面 B(官方 JNPF 形状 5 条 + 2 条共用按 Vue-Version 头分流)」两套契约。适用于「AI 开发 MVP 阶段要 Rust 全栈快速迭代、稳定后迁 JNPF 标准栈」的场景,含用户/角色/机构/菜单/授权五套管理页与四源合并菜单守卫。加业务模块见同目录 HOWTO_MODULE.md。 +description: Rust 全栈 MVP 脚手架(**平台来自 sspf 发布包,vendor/ 解包,不再依赖 git 仓**;本仓只有业务样板 + 薄装配 + 前端产物 + 尺子),契约与数据模型从第一天起对齐 JNPF 标准版(cipher / ActionResult / f_ 列 / varchar(50) UUID / base_* 权限表 / 进程内原生 PostgreSQL),前后端同一进程同时提供「面 A(ssw 契约 30 条)」与「面 B(官方 JNPF 形状 5 条 + 2 条共用按 Vue-Version 头分流)」两套契约。适用于「AI 开发 MVP 阶段要 Rust 全栈快速迭代、稳定后迁 JNPF 标准栈」的场景,含用户/角色/机构/菜单/授权五套管理页与四源合并菜单守卫。加业务模块见同目录 HOWTO_MODULE.md。 type: skill --- @@ -8,15 +8,19 @@ type: skill **技能 = 业务样板 + 薄装配 + 前端产物 + 两把尺子**;**平台不在本仓**。 平台(登录 / 权限 / 面 A·B / 低代码 / MCP / 177 张 `base_*` 表 / 进程内原生 PostgreSQL) -来自**已发布的 `sspf` 包**(`Cargo.toml` 里的 `git` + `tag = "v0.5.0"`)。 +来自**已发布的 `sspf` 包**(平台仓每版本打出的**自包含发布包**,不是直接依赖 git 仓)。 -> 🔴 **这条是 2026-11-04 的架构变更**:以前本技能自带一份平台实现(`src/backend/src/platform/`), -> 结果是「示例仓里躺着一份会分叉的平台」。现在平台只在 `sspf` 一处演进,本仓锁 **tag**; -> 升级平台 = 改 `Cargo.toml` 里那一行 tag,业务代码不动。 +> 🔴 **这条是 2026-11-04 → 2026-11-05 的架构变更**: +> - 2026-11-04:平台从「本仓自带一份实现」搬进 `sspf` 一处演进,本仓**锁 git tag** 依赖。 +> - 2026-11-05:进一步改为**每版本出包**——平台仓 `bash scripts/release.sh` 产出 +> `dist/sspf-vX.Y.Z.tar.gz`(预编译 `sspf-admin` 二进制 + 平台 crate 源码 + `Cargo.lock`), +> 本仓用 `bash scripts/fetch-platform.sh vX.Y.Z` 解包到 `vendor/sspf-vX.Y.Z/`, +> `Cargo.toml` 用 `path` 指进去。**不再需要访问 git 服务、不再 clone 整个 monorepo、不再每次重编 20+ crate**。 +> - 升级平台 = 改 `Cargo.toml` 那一行 `path`(路径 + version 一起改),业务代码不动。 > 判据:`python3 scripts/check-scaffold.py`(本仓出现 `platform/` / `routes.rs` / `crates/` 立刻红)。 > -> **依赖前提**:能访问 `http://127.0.0.1:13300/ssw/ssw-platform.git`(本机 Gitea)。 -> 首次 `cargo build` 会拉一次 git 依赖,之后走 `~/.cargo/git` 缓存。 +> 🔴 **依赖前提变了**:不再需要 Gitea 访问;只要 `vendor/sspf-vX.Y.Z/` 已解包(`scripts/fetch-platform.sh` 自动完成), +> `cargo build --offline` 也能编(包自带 `Cargo.lock`)。 来自 `ssw-jnpf-lite-react`(NestJS + React)的 **Rust 全栈 counterpart**——两者是**并列可选**的独立技能, 不是依赖关系:要 MVP 期就用 Node 栈选 `ssw-jnpf-lite-react`,要 MVP 期用 Rust 栈选本技能。 @@ -87,7 +91,7 @@ cd "$PROJ" && cp .env.example .env && ./run.sh install && ./run.sh dev ``` Cargo.toml workspace 根:【唯一的平台依赖就在这儿】 - sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", tag = "v0.5.0" } + sspf = { path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5" } # 由 scripts/fetch-platform.sh 解包进来;升版本改这一行 src/backend/ 示例应用(薄壳,~500 行) src/main.rs 解析 --enc/--help + 把「配置 + 包 + 面 A 路由 + 前端」交给 sspf::Platform::new().config().packs().router().static_dir().serve() @@ -163,7 +167,7 @@ template-boot-jnpf/ JNPF 标准栈最小可运行骨架(Java)—— 迁官 | | `scripts/check-scaffold.py` | `cargo test --workspace` | `scripts/perm-smoke.sh` | `scripts/perm-smoke-jnpf.sh` | |---|---|---|---|---| | 类别 | 静态判据 | 单元 / 集成测试 | **运行时尺子·面 A** | **运行时尺子·面 B** | -| 测什么 | **本仓只准有业务**(SC1–SC6:没有 platform/、没有 `base_*` 建表、应用只依赖门面、包只依赖门面、`sspf` 锁 git tag、生成物不漂移) | 包自检(列/DDL/路由形状)+ 应用装配 + spec 唯一性 + sync 一致性 | 面 A 契约 32 条 | 官方 JNPF 形状 18 条 | +| 测什么 | **本仓只准有业务**(SC1–SC6:没有 platform/、没有 `base_*` 建表、应用只依赖门面、包只依赖门面、`sspf` 锁 vendor 包版本、生成物不漂移) | 包自检(列/DDL/路由形状)+ 应用装配 + spec 唯一性 + sync 一致性 | 面 A 契约 32 条 | 官方 JNPF 形状 18 条 | | 起后端 | 否 | 否 | 是(**默认自起隔离实例**) | 是(**默认自起隔离实例**) | | 断言数 | **6**(+ 反自证 **6/6**) | 按 workspace | **32** | **18** | diff --git a/docs/runbook.md b/docs/runbook.md index 60db954..f9c71bc 100644 --- a/docs/runbook.md +++ b/docs/runbook.md @@ -210,7 +210,7 @@ python3 scripts/check-scaffold.py --self-test # 期望:反自证 6/6 | **SC2** | 业务侧没有 `base_*` 建表语句(`docs/` 里的参考 DDL 不算 —— 它不参与运行) | | **SC3** | 应用 crate 只依赖门面 `sspf`(+ axum/tokio + 业务包),不直接依赖 `sspf-*` 内部 crate | | **SC4** | 每个业务包只依赖 `sspf`,且 `Cargo.toml` / `pack.toml` / `schema/001_init.sql` / `src/lib.rs` 齐全 | -| **SC5** | `sspf` 只从 workspace 的 **git tag** 来;成员不许另写 `git` / `path` / `version` | +| **SC5** | `sspf` 只从 workspace 根的 **vendor 包 path** 来(`vendor/sspf-vX.Y.Z/crates/sspf`);成员不许另写 `git` / `path` / `version` | | **SC6** | 生成物与 `packs/*` 不漂移(复用 `pack-sync.py --check`) | 🔴 **反自证**:`--self-test` 给 6 条判据各造一个**真实违规**(抄回 `platform/`、写 diff --git a/scripts/fetch-platform.sh b/scripts/fetch-platform.sh new file mode 100755 index 0000000..bf78ba5 --- /dev/null +++ b/scripts/fetch-platform.sh @@ -0,0 +1,62 @@ +#!/usr/bin/env bash +# +# fetch-platform.sh —— 把平台「自包含发布包」解包到 vendor/,让本仓用 path 依赖吃 sspf +# +# 背景(2026-11-05 依赖模型变更):平台仓每个版本产出一个自包含包 +# `dist/sspf-vX.Y.Z.tar.gz`(预编译 sspf-admin 二进制 + 平台 crate 源码 + Cargo.lock), +# 本仓**不再直接依赖 git 仓**,而是把它解包到 vendor/ 后用 path 依赖指进去。 +# +# 用法: +# bash scripts/fetch-platform.sh 0.5.0 # 解包 sspf-v0.5.0 → vendor/sspf-v0.5.0/ +# bash scripts/fetch-platform.sh # 默认从 Cargo.toml 推断 sspf 版本 +# +# 包来源(按优先级): +# 1. 环境变量 SSPF_DIST_DIR 指向目录里的 sspf-vX.Y.Z.tar.gz +# 2. 默认:$HOME/Desktop/workspace/ssw-platform/dist/ +# (未来可扩展为从内网 Gitea release 下载;此处先走本地 dist,单机开发够用) +# +set -euo pipefail +cd "$(dirname "$0")/.." +SKILL_ROOT="$(pwd)" + +# ── 版本号 ────────────────────────────────────────────────────── +if [[ $# -ge 1 ]]; then + VERSION="$1" +else + VERSION="$(grep -oE 'sspf-v[0-9]+\.[0-9]+\.[0-9]+' Cargo.toml 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)" + if [[ -z "${VERSION}" ]]; then + VERSION="$(grep -oE 'tag = "v[0-9.]+"' Cargo.toml 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)" + fi + if [[ -z "${VERSION}" ]]; then + echo "!! 无法从 Cargo.toml 推断版本,请显式传版本:bash scripts/fetch-platform.sh 0.5.0" >&2 + exit 1 + fi +fi +# 🔴 目录/包名带 v 前缀,与 git tag(vX.Y.Z)对齐;crate 自身 version 是无 v 的 X.Y.Z +PKG="sspf-v${VERSION}" +TAR="${PKG}.tar.gz" + +# ── 定位包 ────────────────────────────────────────────────────── +DIST_DIR="${SSPF_DIST_DIR:-$HOME/Desktop/workspace/ssw-platform/dist}" +if [[ ! -f "${DIST_DIR}/${TAR}" ]]; then + echo "!! 找不到包: ${DIST_DIR}/${TAR}" >&2 + echo " 用环境变量 SSPF_DIST_DIR 指定平台仓 dist 目录,或先在平台仓跑过 bash scripts/release.sh" >&2 + exit 1 +fi + +# ── 解包 ──────────────────────────────────────────────────────── +echo "==> 解包 ${DIST_DIR}/${TAR} → ${SKILL_ROOT}/vendor/${PKG}/" +mkdir -p vendor +tar -xzf "${DIST_DIR}/${TAR}" -C vendor +echo "${VERSION}" > "vendor/VERSION" + +# ── 校验 ──────────────────────────────────────────────────────── +if [[ ! -f "vendor/${PKG}/crates/sspf/Cargo.toml" ]]; then + echo "!! 解包结果异常:vendor/${PKG}/crates/sspf/Cargo.toml 不存在" >&2 + exit 1 +fi +PKGVER="$(grep -m1 '^version' "vendor/${PKG}/crates/sspf/Cargo.toml" | sed -E 's/.*"([^"]+)".*/\1/')" +echo "==> 已就绪:vendor/${PKG}/crates/sspf(包内 sspf 版本 ${PKGVER})" +echo " Cargo.toml 里应写:" +echo " sspf = { path = \"vendor/${PKG}/crates/sspf\", version = \"${VERSION%.*}\" }" +echo " 并确认 .gitignore 含 vendor/"