chore: 收尾 sspf 改造前基线 —— dev 关闭增量编译 + 记录平台包调研结论

This commit is contained in:
admin committed 2026-11-04 17:07:23 +08:00
1 parent 1a0fdbf879
commit be82334972
2 files changed
+76

No files matched your search

+73
View File
@@ -0,0 +1,73 @@
# 2026-11-04 工作日志
## 架构方向(用户明确,待开工确认)
**sspf(ssw-platform)= JNPF 替代品,打成「标准平台包」被业务仓依赖;tdc-rs = 一个业务项目;单进程部署;兼容 JNPF。**
不再是「在 tdc-rs 内按 ssw-platform 形状重组」,而是平台/业务两仓分发:平台发布可版本锁定的 crate,业务仓 Cargo 依赖它,编成单二进制。
## 调研结论(跨会话有价值)
- `ssw-mvp`(Java monorepo):JNPF 7.0 **不是 fork**,是 `~/.m2` 的 jar 依赖 + `boot/ssw-admin` 复制的启动骨架;业务在 `boot/ssw-tdc`(27 实体 / 37 Controller / 36 个 `/api/ssw/tdc/**`)。天然分界:平台 jar ↔ 业务源码、`j7.base_*` ↔ `tdc.tdc_*`、`/api/oauth|permission|system` ↔ `/api/ssw/**`。
- `ssw-tdc-biz/pom.xml` V1.5.9 注释:独立 TDC 节点为「自闭环」引了 JNPF **全量** jar ⇒ 兼容范围必须是整套平台能力,不能只做登录。
- `jweb/apps/jnpf-web-apps-main/src/views/ssw/api/tdc.ts` 是 tdc 业务契约真源(CRUD 六件套);Java 侧对应 `TdcCrudController`。
- sspf 已有 JNPF 兼容面:面 B 346 端点、`Vue-Version: 3` 判别、`base_*` 逐字、同一把 cipher、`{code,msg,data}`、602 码 ⇒ 不用从零做。
- **跨仓 path 依赖已实测可行**:`/tmp/sspf-probe` 引用 `sspf-contract` + `sspf-sdk`,`cargo check --offline` 13.23s 通过;`version.workspace = true` 会解析回 ssw-platform 自己的 workspace 根。
- **坑**:ssw-platform 锁 `rustc 1.95.0`(`rust-toolchain.toml`),tdc-rs 无 toolchain 文件 ⇒ 单进程链接前必须补齐同一个。
- **必须先解耦**:`src/backend` 内核 lib 编译期依赖 `packs/{asset,demo,shop,books}` + `modules/mod.rs` 生成段 ⇒ 业务仓一依赖门面就会拖进四个示例包。解法:业务清单改 builder 注入,示例包降为可选 feature。
## 分批计划(尚未动代码)
- P0 sspf 门面 crate `crates/sspf/` + 内核业务层注入化 + 打 tag `v0.2.0`;出口:704 测试 / 12 闸门全绿、外部探针能 `use sspf::Platform`
- P1 tdc-rs 补 toolchain + 依赖 sspf + `main.rs` 换装配;自研 `src/platform/`(4.6k 行)退场(先留适配层);出口:单进程起得来、246 测试 + 五把尺子全绿
- P2 18 实体 → `packs/tdc` 的 EntitySpec + DDL 跟包走,自定义端点归扩展 crate
- P3 面 B + tdc 契约双跑:一个端口同时接 jweb 官方页与 tdc 业务页
## git 状态
两仓 `git fetch` 均 `Already up to date`(ssw-platform `acf076d`、tdc-rs `1a0fdbf`)。tdc-rs 有本地未提交改动:`Cargo.toml` 加 `[profile.dev] incremental = false`(未动)。
## 交付:SSPF 平台包 P0 需求文档(用户要求「写一个文档,我到那个仓做」)
写入 `/Users/xs/Desktop/workspace/ssw-platform/docs/SSPF-PLATFORM-PACKAGE.md`(**本轮唯一文件改动**,两仓代码零改动)。
内容:P0 交付物 6 项、7 条硬约束、门面 crate `crates/sspf/` 规格与必须公开的 API、装配顺序、逐文件改造清单、验收判据、发布 tag `v0.2.0` 与业务仓依赖写法、明确不做、P1–P3 并行计划、风险表、事实出处附录。
### 核准后的新增结论(跨会话有价值)
- **pglite-rs 0.2 每进程只允许一个实例**(`tdc-rs/src/main.rs:111` 注释 + `static OPEN`)⇒ 平台与业务必须共用同一个 `Db`/`AppState`,业务 DDL 需注入同一库,禁止业务仓自己 `PGlite::open()`。这是「单进程部署」最硬的约束。
- **release profile 由业务仓根决定**:tdc-rs 现有 `[profile.release] panic = "abort"` 会让 sspf 的 `catch_unwind`/catch-all 中间件失效(契约 §6.5 panic ⇒ HTTP 200 + code=400)⇒ P1 必须删掉,并照抄 sspf 的 release 设置。
- **`build_app` 是唯一权威装配链**(`routes.rs:2542`:`fallback` 在两个 `layer` 之前、`with_state` 链尾);业务 Router / SPA fallback 必须由门面注入 merge,业务仓不得重抄。
- `bootstrap.rs:45` 的 `PACKS: OnceLock` 是 **first-call-wins** ⇒ builder 注入必须在首次 `packs()` 调用前完成,否则静默失效。
- sspf 基线:`cargo test --workspace` 704 passed、`check-arch.sh` 21/21、`/api/health` 181 张表、面 B 尺子 18 条(`HANDOFF.md:18,30`);6 把静态闸门 + 6 把运行时尺子(`scripts/verify.sh` 头注)。
- `sspf-admin` CLI 实际是 `--enc` / `--mcp [--with-http]` / `--seed-lowcode-demo [--dry-run]`(`main.rs:222-276`),抽 `run()` 时保留这些。
- `load_static` 签名:`(app, manifest_json, Box<dyn BusinessPack>, &[(&str,&str)], kernel_version)`(`sspf-plugin/src/lib.rs:492`);内部 `Path::new("packs").join(app)` 只用于报错路径,不读文件 ⇒ 外部包可用。
- 跨仓 path 依赖已实测(`/tmp/sspf-probe`);**git tag 依赖尚未实测**,文档已列为 P0 需验项。
### 待用户决定
按用户「可以同步或者等他们做完」:可选 ① 现在同步开工 tdc-rs 侧 P1 准备(toolchain / profile / 契约冻结 / `packs/tdc` 骨架,不依赖 P0);② 等 `v0.2.0` tag 后再动。**未擅自开工,等回复。**
## P0 交付验收(用户说「已经做完了,你看看是否满足」)
ssw-platform 侧提交 `9083394`(门面)+ `3d3fd69`(文档/记忆),工作区干净。**代码层面满足且严于原稿,发布层面有 4 处缺口。**
独立复跑通过:`cargo test --workspace` exit 0 → **710 passed / 0 failed / 5 ignored**(基线 704);`external_consumer_it` 1/1(起单端口、注入 DDL 同库、面 B 登录 200、示例包端点/表不存在);`check-arch.sh` 29/29 + `--self-test` 13/13;`verify.sh --fast` 8 步全绿 70.4s;`pack-sync.py --check` 4 处一致;`cargo tree -p sspf`/`-p ssw-platform` 依赖树 **0 个 `sspf-pack-*`**(`sspf-admin` 4 个属预期);仓外探针 `/tmp/sspf-consumer-check` 只依赖 `sspf` → `cargo check --offline` + 单测通过、依赖树 0 示例包;门面源码 `grep tdc` 无输出。
门面 API 四类齐全:契约/包类型(含 `PackRegistry`/`load_static`/`merge`)、运行时类型(`AppState`/`Db`/`Config`/`SessionStore`/`seed`/`crud`/`guard`/`cipher`)、builder 8 注入点全有(`packs`/`pack`/`ddl(table,sql)`/`menus`/`router`/`static_dir`/`on_ready`/`build_app`/`serve`,另多 `config`/`project_dir`/`serve_mcp`)、启动动作在 `platform.rs::boot` + `runtime.rs`。`sspf-admin` 1111 → 427 行只留 CLI。
实施记录 §10.2 四处偏离均合理(收 `PackRegistry` 不收 `PackSource`;白名单自检留内核;`.ddl` 要表名;SPA 手写不引 tower-http);§10.3 加强更关键:**feature unification 会让 `example-packs` 静默进门面**,解法是门面一次都不读 `bootstrap::packs()` 的 `OnceLock`,全程显式 `PackRegistry` 默认空 ⇒ 默认装配恒零业务。
**4 处发布缺口(卡 P1 的 git 依赖写法)**:① `git tag -l 'v0.2*'` **为空,没有 v0.2.0 tag**,但文档第 3 行与 §10 标题已写「tag v0.2.0」⇒ 文档与事实不符;② 本地领先 `origin/main` **2 个提交未推送**(`0 2`)⇒ 业务仓 `git = ..., tag = "v0.2.0"` 拉不到;③ **无 CHANGELOG 文件**(§6 要求 5–8 行),发布说明只写在文档 §10.4;④ §6 ⚠️「git 依赖实测一次」**未做**(tag 不存在也没法做)。
未独立复跑:`verify.sh --smoke` 运行时 6 把尺子、`perm-smoke-jnpf.sh` 面 B 23/23(实施记录 §10.4 声称全绿)。**tdc-rs 侧仍零代码改动**;若先用 path 依赖,P1 可立即开工,不受 tag 阻塞。
## P0 发布补齐复核(用户「已经打tag了,你看看」)
**4 处缺口已补 3 处 + 1 处形式残留,P0 判据全部通过,P1 阻塞解除。**
- `v0.2.0` 是 **annotated tag**(`refs/tags/v0.2.0` → `9083394`),`git ls-remote --tags origin` 有 `refs/tags/v0.2.0` 与 `^{}` ⇒ **已推远程**。
- 本地 `main` 与 `origin/main` **0/0 同步**;新增 `2b4f4d1`(docs:记录已发布 + git 依赖实测,只改 HANDOFF / 文档 / 本仓 memory)。tag 指向 9083394,即上一轮已全量验过的那版代码,tag tree 内含 `crates/sspf/{Cargo.toml,lib.rs,platform.rs,runtime.rs}`,`version = "0.2.0"` 显式写死(不用 `version.workspace`)。
- **§6 git 依赖实测由本仓独立复现通过**:`/tmp/sspf-git-probe-verify` 只写 `sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", tag = "v0.2.0" }`;`CARGO_NET_GIT_FETCH_WITH_CLI=true NO_PROXY=127.0.0.1,localhost cargo check` 52.86s 通过,单测 1/1,依赖树 **0 个 `sspf-pack-*`**,解析来源 `(git?tag=v0.2.0#9083394b)`。⇒ git tag 依赖与 path 依赖等价,workspace 根解析正确。
- 形式残留:**仍无独立 `CHANGELOG*` 文件**;5 行发布说明写在 `docs/SSPF-PLATFORM-PACKAGE.md` §10.4 + HANDOFF §0 + 本仓 memory。实质信息齐备,不阻塞。
- 注意:门面 `rust-version = "1.85"` 是 MSRV;**ssw-platform 的 `rust-toolchain.toml` 仍锁 1.95.0**(L3 dylib ABI),tdc-rs 单进程链接要按 1.95.0 对齐,不是 1.85。
**tdc-rs 现状(P1 待办,本轮未动代码)**:无 `rust-toolchain.toml`;`Cargo.toml:56` 的 `panic = "abort"` 仍在(会破 sspf catch-all 契约);尚未依赖 sspf;工作区仅有此前 `[profile.dev] incremental = false` 一处本地改动。
+3
View File
@@ -55,3 +55,6 @@ lto = "thin"
strip = "symbols" # 发布包剥离符号表,体积减半以上
panic = "abort" # 不生成 unwind 表,进一步缩小
codegen-units = 16
[profile.dev]
incremental = false