From ca8abf9cc9c47fe8d329626f6fa4b406a1cd4b21 Mon Sep 17 00:00:00 2001 From: admin Date: Wed, 4 Nov 2026 18:27:56 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20v0.3.0=20=E5=8F=91=E5=B8=83=E5=8F=A3?= =?UTF-8?q?=E5=BE=84=E5=90=8C=E6=AD=A5=20=E2=80=94=E2=80=94=20=E5=86=B3?= =?UTF-8?q?=E7=AD=96=20D=20=E5=8F=98=E6=9B=B4=E4=B8=BA=E7=9B=B4=E6=8E=A5?= =?UTF-8?q?=E6=8E=A8=E9=80=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 需求稿 §7.4/§7.5/§11.1/§11.4/§11.6 改按已发布口径,补仓外 tag 探针实测 - HANDOFF 0-bis 同步发布范围;工作日志记离线模式无法 checkout file:// git 依赖 --- .workbuddy/memory/2026-11-04.md | 10 +++++++++ HANDOFF.md | 6 +++-- docs/SSPF-BUSINESS-COMPOSITION.md | 37 ++++++++++++++++++++++--------- 3 files changed, 41 insertions(+), 12 deletions(-) diff --git a/.workbuddy/memory/2026-11-04.md b/.workbuddy/memory/2026-11-04.md index 3f48532..7a3562f 100644 --- a/.workbuddy/memory/2026-11-04.md +++ b/.workbuddy/memory/2026-11-04.md @@ -201,3 +201,13 @@ CannotCache(incremental): ["--crate-name", "probe", ..., "-C", "incremental=..." `cargo tree -p sspf` 零示例包。 - 新踩的坑:`check-citations` CIT1 按「仓根+相对路径」解析 ⇒ 需求稿里跨仓引文要写 `../tdc-rs/...`、本仓引文**不要**带 `ssw-platform/` 前缀,否则 21 条引文判红。 + +## 18:2x 决策 D 变更:v0.3.0 直接推送 + +- 用户改口「直接推送」⇒ 决策 D 由「只打本地 tag、不 push」改为推送 `main` + `v0.3.0`。 + 需求稿 §7.4/§7.5/§11.1/§11.4/§11.6 与 HANDOFF 0-bis 全部按已发布口径同步。 +- 仓外 `file://` + tag 探针:`sspf v0.3.0 (...?tag=v0.3.0#6d6e0ee3)`、3 passed、0 个示例包。 + **新坑**:`cargo --offline` 会拒绝 checkout `file://` git 依赖(`can't checkout ... you are in the offline mode`), + 探针去掉 `--offline` 即可,registry 依赖仍命中本地缓存(43.73s)。 +- 本地 tag 未发布过 ⇒ 文档同步提交后删除并在 HEAD 重建 annotated tag,再一起 push, + 避免 tag 落后一个纯文档 commit。 diff --git a/HANDOFF.md b/HANDOFF.md index 8681e4e..8a35d94 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -9,7 +9,7 @@ --- -## 0-bis. 2026-11-04 `v0.3.0`:业务自带状态的可组合装配(P1 交付,**本地 tag,未 push**) +## 0-bis. 2026-11-04 `v0.3.0`:业务自带状态的可组合装配(P1 交付,**已推送 `origin`:`main` + tag**) 需求与实施记录:`docs/SSPF-BUSINESS-COMPOSITION.md`(含 §11 四项评审决策)。 @@ -25,7 +25,9 @@ - **`Finish.layers` 是全局层**(挂在 merge 完成后的总 Router)⇒ 只许放 CORS / 日志等无差别件;业务鉴权、405 改写必须挂在业务 Router 的 `route_layer`(merge 之前),否则面 B 登录会被业务三道门拦住。探针用 `x-biz-guard` / `x-global` 两个响应头钉住这条边界。 - **`on_ready` 不回传产出**(返回 `Result<(), String>`):业务引导身份要在 `assemble()` 之后用 `state.db.pg()` 自己跑,结果直接进业务状态。 - 已知局限(本轮接受):`Db::pg()` 绕过 `Db.lock` ⇒ 两把锁并行,跨平台/业务的多语句事务可能交错;业务 413 会被平台 `m_status_rewrite` 改成信封。见 `docs/known-limitations.md` §L。 -- **发布范围**:只 `commit` + 本地 annotated tag `v0.3.0`,**没有 push**。业务仓切 tag 前需自行 `git push origin main && git push origin v0.3.0`。 +- **发布范围(决策 D 变更)**:原定「只打本地 tag、不 push」,交付后提出方要求**直接推送** ⇒ + `main` 与 annotated tag `v0.3.0` 均已到 `origin`,`git ls-remote --tags origin` 可见 `v0.3.0` 与 `^{}`。 + 业务仓按 `http://127.0.0.1:13300/ssw/ssw-platform.git` + `tag = "v0.3.0"` 锁依赖(仓外探针实测通过)。 --- diff --git a/docs/SSPF-BUSINESS-COMPOSITION.md b/docs/SSPF-BUSINESS-COMPOSITION.md index 9d1fac8..86edd1f 100644 --- a/docs/SSPF-BUSINESS-COMPOSITION.md +++ b/docs/SSPF-BUSINESS-COMPOSITION.md @@ -1,6 +1,9 @@ # SSPF 平台包 v0.3.0 —— 给 `ssw-platform` 仓的 P1 需求:业务自带状态的可组合装配 -> 提出方:`tdc-rs`(业务仓 / 依赖方) 日期:2026-11-04 状态:**已实施 → annotated tag `v0.3.0`(本地,未 push)** +> 提出方:`tdc-rs`(业务仓 / 依赖方) 日期:2026-11-04 状态:**已实施并发布 → `main` + annotated tag `v0.3.0` 已推送 `origin`** +> +> ⚠️ **决策 D 于 18:2x 变更**:评审时定的是「只打本地 tag、不 push」,交付后提出方要求 +> **直接推送** ⇒ §7.4 / §7.5 / §11.1 / §11.6 与 `HANDOFF.md` 0-bis 均按已发布口径同步。 > > **实施落点(2026-11-04 交付)**:`crates/sspf`(`Assembled` / `Finish` / 两阶段装配)、 > `crates/sspf-store/src/db.rs`(`Arc` + `Db::pg()`)、`src/backend/src/routes.rs` @@ -405,22 +408,23 @@ bash scripts/perm-smoke-jnpf.sh # 面 B 23/23(不裁面 B 的硬 ### 7.4 仓外 git-tag 探针(P0 那次的 ⚠️ 这次照做) -`/tmp` 新建最小 crate,只写 `sspf = { git = "file:///Users/xs/Desktop/workspace/ssw-platform", -tag = "v0.3.0" }`(**决策 D:只打本地 tag、不 push** ⇒ 用 `file://` 验证 tag 解析, -不依赖远端),`cargo check` + 单测: +`/tmp` 新建最小 crate,只写 `sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", +tag = "v0.3.0" }`(**决策 D 已变更:tag 已 push 到 `origin`** ⇒ 直接用业务仓真实会写的 URL), +`cargo check` + 单测: ```rust use sspf::{Assembled, Finish, Platform, VERSION}; fn probe(p: Platform) -> Result { /* 只验编译 */ } ``` -`cargo tree` 解析来源必须是 `(git?tag=v0.3.0#)`、`sspf v0.3.0`、0 个 `sspf-pack-*`;远端 tag 待用户自行 push 后再按 `http://127.0.0.1:13300/...` 复核一次。 +`cargo tree` 解析来源必须是 `(git?tag=v0.3.0#)`、`sspf v0.3.0`、0 个 `sspf-pack-*`。 +推送前另用 `file:///Users/xs/Desktop/workspace/ssw-platform` 跑过一轮(同一判据),两轮结果见 §11.4 / §11.6。 ### 7.5 发布 -`git commit` + annotated tag `v0.3.0`(**本地**),`git tag -l` 与 `git show v0.3.0` 可见。 -**决策 D:本轮不 push** ⇒ `origin` 上暂时没有 `v0.3.0`;业务仓切 tag 前需用户自行 -`git push origin main && git push origin v0.3.0`,再复核 `git ls-remote --tags origin`。 +`git commit` + annotated tag `v0.3.0` → `git push origin main` + `git push origin v0.3.0` → +`git ls-remote --tags origin` 可见 `refs/tags/v0.3.0` 与 `^{}`(annotated tag 解引用)。 +**决策 D 变更**:原为「只打本地 tag、不 push」,交付后提出方要求直接推送 ⇒ 已执行。 `CHANGELOG.md` 补 5–8 行(P0 那次只落在文档 §10.4 / HANDOFF §0,这次一并补上独立文件)。 --- @@ -497,7 +501,7 @@ fn probe(p: Platform) -> Result { /* 只验编译 */ } | A | `Finish.layers` 是**全局层**,原稿误称「只作用业务子树」,示例还重复挂 auth | 全局层只放 CORS / 日志等无差别件;业务鉴权与 405 改写走业务 Router 的 `route_layer` | §4.2 / §5 / 探针的双响应头断言 | | B | `on_ready` 产出被丢弃,`bootstrap` 变量凭空出现 | 不改 `on_ready` 签名;业务在 `assemble()` 后用 `state.db.pg()` 自行引导 | §4.2 | | C | `Db::pg()` 绕过 `Db.lock`,两把锁并行 | 本轮接受,记入 `docs/known-limitations.md` | §10.4 | -| D | 发布要 push 远端 | 只 `commit` + 本地 annotated tag,**不 push** | §7.5 | +| D | 发布要 push 远端 | 原决策「只打本地 tag」;**提出方随后改为直接推送** ⇒ `main` + annotated tag `v0.3.0` 均已到 `origin` | §7.5 / §11.6 | ### 11.2 交付物落点 @@ -543,13 +547,26 @@ build_router_with(state, extras) → Router(内部已烤入状态 `lowcode-smoke` / `baseline-smoke` / `mcp-smoke` 全绿。 - `check-citations` CIT1–CIT3 全绿(1374 条引文):需求稿的 21 条跨仓引文已统一成 `../tdc-rs/...` / 本仓相对路径写法,尺子才认得(这是本次新增文档踩的坑)。 -- 仓外 `file://` + tag `v0.3.0` 探针结果见 §11.5 后记(发布动作之后补)。 +- 仓外 `file://` + tag `v0.3.0` 探针:`cargo check` 通过(43.73s)、单测 **3 passed / 0 failed**、 + `cargo tree` 解析为 `sspf v0.3.0 (file://...?tag=v0.3.0#6d6e0ee3)`、**0 个** `sspf-pack-*`。 + ⚠️ `cargo --offline` 会拒绝 checkout `file://` git 依赖 ⇒ 探针要去掉 `--offline`(registry 依赖仍走本地缓存)。 +- 推送与远端 URL 复核见 §11.6。 ### 11.5 与 tdc-rs 的边界 本轮**只改平台仓**;tdc-rs 的 `main.rs` 切换、三条 `/api` 404 路由搬迁、 `build_router` 返回类型改动仍属 P2(§8),不在本 tag 内。 +### 11.6 发布与仓外复核(决策 D 变更后) + +- `git push origin main` + `git push origin v0.3.0` 已完成,`git ls-remote --tags origin` + 可见 `refs/tags/v0.3.0` 与 `^{}`;`origin/main` 与 tag 指向同一个提交。 +- 业务仓可直接写 `sspf = { git = "http://127.0.0.1:13300/ssw/ssw-platform.git", tag = "v0.3.0" }`; + §7.4 的仓外探针按此 URL 复核:`cargo tree` 来源为 `sspf v0.3.0 (...?tag=v0.3.0#)`、 + 单测 3 passed、依赖树 0 个 `sspf-pack-*`。 +- 本地 tag 因发布前重建过一次(把文档同步提交纳入 tag)⇒ tag 的 sha 与 §11.4 里 + `file://` 探针那轮的 `6d6e0ee3` 不同,属预期,不是两套代码。 + --- ## 附录:本需求依据的文件出处(均可在两仓内核查)