Files
ssw-platform/CHANGELOG.md
T
admin 509c6b1d1f feat(db): v0.5.0 业务库操作收进同一个 Db —— query_json_raw / query_rows / lock_owned
- Db::query_json_raw:持 Db.lock、row_to_json 包裹、不做 JSON 键归一(给自带归一语义的厚业务仓)
- Db::query_rows:持锁返回原始 pglite::Row(pg_catalog 元数据 / 取首行首列)
- Db::lock_owned():与所有 Db::* / DbTransaction 共用同一把锁,guard 内可用裸句柄跑自有 SQL
- query_json_inner 拆出共用段 query_json_inner_raw ⇒ SQL 包裹只有一份,query_json* 行为未改
- 闸门 AR20(raw 不归一 / 共用段 / 8 个公开入口全持锁)+ 反自证 14 → 15 项
- 探针 db_raw_it(4 条):raw 不归一 · 归一路径同时成立 · guard 期间 Db::exec 被阻塞 · query_rows 读 pg_catalog
- 销掉 known-limitations 的「双锁」条;CHANGELOG / README 版本表升 0.5.0
- 验收:653 passed / 0 failed;verify.sh --smoke 14/14;check-arch 25/25 自证 15/15
2026-11-04 22:54:35 +08:00

3.7 KiB
Raw Blame History

CHANGELOG

v0.5.0(2026-11-04,业务库操作收进同一个 Db)

  • 新增 Db::query_json_raw(sql, params):持 Db.lock、row_to_json 包裹、不做 JSON 键归一(f_id 原样返回),给自带归一语义的厚业务仓用。
  • 新增 Db::query_rows(sql, params):持锁返回原始 pglite::Row(pg_catalog 元数据 / 取首行首列),业务仓经 sspf::pglite 引用类型、不必自己声明依赖。
  • 新增 Db::lock_owned() -> OwnedMutexGuard<()>:与所有 Db::* / DbTransaction 共用同一把锁;持 guard 期间可在裸句柄上跑自有 SQL。
  • query_json_inner 拆成共用的 query_json_inner_raw(包裹 + 反序列化)+ 归一那一层 ⇒ SQL 包裹只有一份;query_json* 行为一字未改。
  • 新增闸门 AR20(raw 不归一 / 共用包裹段 / 公开入口全持同一把锁)+ 反自证 15/15;新增探针 db_raw_it.rs(4 条:raw 键不归一、归一路径同时成立、guard 期间 Db::exec 被阻塞、query_rows 读 pg_catalog)。
  • Db::pg() 文档补「要与平台共用串行域该走哪个入口」的指路表;销掉 v0.3.0 的「双锁」已知局限(docs/known-limitations.md 的 (bq))。
  • 影响:面 A / 面 B 端点形状、码表、表结构零变化;Platform 的公开签名未改(Finish::default() 路径逐字等价)。sspf 版本 0.5.0。

v0.4.0(2026-11-04,平台包零业务清理)

  • 4 个示例业务包与 modules/ 的 4 个面 A 适配器整体移出本仓;packs/ 与 sspf-pack-* 依赖、 example-packs feature、门面 example_packs() 全部移除。
  • sspf-admin 改为纯平台装配:只剩 177 张平台表,面 A 无业务端点;业务改由 sspf::Platform::packs/ddl/menus/router 注入。
  • 生成器 pack-sync.py 把「零包」钉成合法目标态:四处派生位置恒空,出现业务包直接报错。
  • 静态闸门(CP1 / check-module / 契约反自证)与运行时尺子(面 A 21 条、包冒烟)改跑防回流断言:示例业务回流平台仓立即红。
  • 纯业务测试 crud_it.rs 与 new-pack 脚手架随示例移交技能仓;db_it / batch7_it / auth_it 改用平台内置夹具。
  • 门面 sspf 的 cargo 版本同步为 0.4.0(与 tag 一致);技能仓按 tag = "v0.4.0" 锁依赖。
  • 影响:本仓不再自带可跑的业务示例,集成测试数下降;verify.sh --smoke 需先 cargo build --release -p sspf-admin。

v0.3.0(2026-11-04)

  • 新增两阶段装配 Platform::assemble() / Assembled::finish() / serve() 与 Finish 注入点:自带状态类型的业务路由可挂进平台唯一装配链,业务状态可在开库后构造。
  • Db 改用 Arc<PGlite> 并公开 pg() ⇒ 业务仓与平台共用一个库句柄,不必另开 PGlite;Db::clone() 语义不变。
  • Extras 新增自带状态路由 / 可替换兜底 / 全局 middleware 层三个注入点;with_state 前移到 merge 之前,build_app() 默认路径行为不变。
  • 面 A / 面 B、base_* 表、cipher、602 码、panic ⇒ 200 + code=400 全部保持不变;v0.2.0 的公开签名未改。
  • 新增集成探针 business_composition_it.rs 与闸门 AR19(唯一装配链,反自证 14/14);sspf 版本 0.3.0。
  • 已知局限:Db::pg() 绕过 Db.lock 时,平台与业务各自的多语句事务可能交错;业务 413 响应由平台改写为信封。见 docs/known-limitations.md。

v0.2.0(2026-11-04)

  • 新增门面 crate sspf:业务仓唯一依赖,Platform builder + runtime 启动动作;sspf-admin 退化为 CLI 薄壳。
  • 4 个示例包降为 example-packs feature ⇒ 默认依赖树不含 sspf-pack-*;新增 AR17 / AR18 与仓外消费探针。