refactor(dep): 平台依赖改为 vendor 发布包,去掉 git 依赖
- 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 同步说明新模型。
This commit is contained in:
1 parent
c0336d1099
commit
dc54e8bd1d
9 files changed
+110
-43
No files matched your search
@@ -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-*/
|
||||
|
||||
@@ -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/<app>/`(真源:表 DDL + 列 + 菜单 + 面 B 路由)+
|
||||
`src/backend/src/modules/<app>.rs`(面 A 适配器,只 `pub use` 转发 spec)。
|
||||
|
||||
Generated
-18
@@ -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",
|
||||
|
||||
+11
-2
@@ -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"
|
||||
|
||||
+2
-2
@@ -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 |
|
||||
|
||||
@@ -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` 继承无处可依 ⇒ 编译不起来。
|
||||
|
||||
## 验收门
|
||||
|
||||
@@ -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** |
|
||||
|
||||
|
||||
+1
-1
@@ -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/`、写
|
||||
|
||||
Executable
+62
@@ -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/"
|
||||
Reference in new issue
Block a user