docs(memory): 记录第二份平台侧需求(业务自带状态装配)与 axum 类型链实测

This commit is contained in:
admin committed 2026-11-04 17:30:11 +08:00
1 parent 8a351b7de9
commit 044ddc5f28
1 file changed
+18
+18
View File
@@ -93,3 +93,21 @@ ssw-platform 侧提交 `9083394`(门面)+ `3d3fd69`(文档/记忆),工
**可行路径(需 sspf 侧再开一份需求,类似 P0)**:① `Platform` 增加「业务 Router 自带状态」入口(收 `Router<()>`:平台先把自有路由 `with_state(sspf_state)` 变 `Router<()>` 再 merge,需重新论证 S25 的 fallback/layer 顺序);② `Db` 暴露 `pg()` / `into_inner()` 让业务复用同一个 pglite 句柄;③ 或 tdc 全量把 handler 状态换成 sspf `AppState` + `Extension<TdcState>`(12k 行重写级,不推荐)。
**结论**:P1 第一批已把「依赖可链接 + 平台包可用 + 契约基线冻结」做完;`main.rs` 换装配**不能在平台侧不改的前提下硬上**,否则会把 132 条端点契约改坏。
## 第二份平台侧需求(用户「继续」= 点头写文档,2026-11-04)
写入 `/Users/xs/Desktop/workspace/ssw-platform/docs/SSPF-BUSINESS-COMPOSITION.md`(**新增文档,两仓代码零改动,未提交**)。目标 tag **`v0.3.0`**:让平台包承载已有厚业务仓的路由。
**核准后新增两条冲突(P0 文档没覆盖)**:
- **兜底/middleware 是两套**:tdc `main.rs:192-229` 有完整自有装配链;`api_not_found`(`platform/fallback.rs:96`)是**裸三键 404**,与 sspf 信封 404 形状不同;`spa_fallback()`(`fallback.rs:120`,返回 `Router<()>`)带 `ddl_guard` + ServeDir + 深链决策 ⇒ 平台默认 `fallback_response` 不能覆盖业务兜底,且 `Router::merge` 遇到两个 fallback 会 panic(只能挂一个)。
- **鸡生蛋**:tdc `TdcState` 依赖 `BootstrapIdentity`,引导要跑 DB 写(`main.rs:119-144`)⇒ 业务 Router 必须等平台 boot 完才能构造 ⇒ `v0.2.0` 那种「builder 全在 boot 前求值 + `build_app()` 一步到位」不够,**必须两阶段装配**。
**关键有利发现**:`routes.rs:2770,2816` 的 `m_status_rewrite()` / `catch_all()` 返回 `FromFnLayer<MwFn, (), (Request,)>`,状态类型是 `()`、`catch_all_inner` 只 `next.run(req)` + `catch_unwind` ⇒ 在 `Router<()>` 上挂与在 `Router<AppState>` 上挂**等价** ⇒ 「平台先 `with_state` 降型 → merge 业务 → fallback → layers」成立,S25 的 fallback 在两个 layer 之前仍保得住。
**类型链已实测**:`/tmp/sspf-compose-probe`(axum 0.8.9 独立 crate)按 §5 完整顺序编译 + `cargo test --offline` → **1 passed / exit 0**(22.12s)。验证:两侧各自 `with_state` 成 `Router<()>` 后可 merge 且业务 handler 仍取自己的 `State`;`Router<()>` 可作 `fallback_service` 参数;`Vec<Box<dyn FnOnce(Router<()>)->Router<()>+Send+Sync>>` 可编译;链尾返回 `Router<()>`。
**推荐 API(写进文档可照抄)**:R1 `Db.pg: Arc<PGlite>` + `pub fn pg() -> Arc<PGlite>`(现有 `self.pg.*()` 调用经 Deref 一行不用改);R2 两阶段 `Platform::assemble() -> Assembled` + `Assembled::finish(Finish)` / `serve(Finish)`;R3 `Extras` 加 `router_owned: Option<Router<()>>` / `fallback: Option<Router<()>>` / `layers: Vec<LayerFn>`;R4 `build_app_with` 仍是唯一权威装配链,`Finish::default()` 与 v0.2.0 逐字等价;R5 新增 `business_composition_it` 探针 + AR19;R6 仓外 git-tag 探针 + 补 `CHANGELOG.md`。**不动 `v0.2.0` 任何已发布签名**。
验收基线:sspf 710 测试 / 29→30 闸门 / 面 B 23/23 / 181 张表;tdc 280 测试 / 五把尺子(smoke 80/80、132 端点)/ 401·403 裸三键 / SPA 深链 / 面 B 登录同端口。
**tdc-rs 侧仍零新改动**(HEAD `8a351b7`,工作区干净);P1 剩余装配切换等 `v0.3.0`。