diff --git a/.workbuddy/memory/2026-11-04.md b/.workbuddy/memory/2026-11-04.md index 2b46be1..7f9e870 100644 --- a/.workbuddy/memory/2026-11-04.md +++ b/.workbuddy/memory/2026-11-04.md @@ -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`(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`,状态类型是 `()`、`catch_all_inner` 只 `next.run(req)` + `catch_unwind` ⇒ 在 `Router<()>` 上挂与在 `Router` 上挂**等价** ⇒ 「平台先 `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)->Router<()>+Send+Sync>>` 可编译;链尾返回 `Router<()>`。 + +**推荐 API(写进文档可照抄)**:R1 `Db.pg: Arc` + `pub fn pg() -> Arc`(现有 `self.pg.*()` 调用经 Deref 一行不用改);R2 两阶段 `Platform::assemble() -> Assembled` + `Assembled::finish(Finish)` / `serve(Finish)`;R3 `Extras` 加 `router_owned: Option>` / `fallback: Option>` / `layers: Vec`;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`。