docs: v0.3.0 发布口径同步 —— 决策 D 变更为直接推送

- 需求稿 §7.4/§7.5/§11.1/§11.4/§11.6 改按已发布口径,补仓外 tag 探针实测
- HANDOFF 0-bis 同步发布范围;工作日志记离线模式无法 checkout file:// git 依赖
This commit is contained in:
admin committed 2026-11-04 18:27:56 +08:00
1 parent 6d6e0ee329
commit ca8abf9cc9
3 files changed
+41 -12

No files matched your search

+10
View File
@@ -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。
+4 -2
View File
@@ -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"` 锁依赖(仓外探针实测通过)。
---
+27 -10
View File
@@ -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<PGlite>` + `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<Assembled, String> { /* 只验编译 */ }
```
`cargo tree` 解析来源必须是 `(git?tag=v0.3.0#<sha>)`、`sspf v0.3.0`、0 个 `sspf-pack-*`;远端 tag 待用户自行 push 后再按 `http://127.0.0.1:13300/...` 复核一次。
`cargo tree` 解析来源必须是 `(git?tag=v0.3.0#<sha>)`、`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<Assembled, String> { /* 只验编译 */ }
| 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<AppState>(内部已烤入状态
`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#<sha>)`、
单测 3 passed、依赖树 0 个 `sspf-pack-*`。
- 本地 tag 因发布前重建过一次(把文档同步提交纳入 tag)⇒ tag 的 sha 与 §11.4 里
`file://` 探针那轮的 `6d6e0ee3` 不同,属预期,不是两套代码。
---
## 附录:本需求依据的文件出处(均可在两仓内核查)