From 1e1bacf09466e42c6904ea9bf3e3db0f71565256 Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 24 Oct 2026 12:21:28 +0800 Subject: [PATCH] =?UTF-8?q?docs(spec):=20=E4=BF=AE=E6=AD=A3=20id=20?= =?UTF-8?q?=E7=94=9F=E6=88=90=E3=80=81=E6=A8=A1=E5=9D=97=E5=88=92=E5=88=86?= =?UTF-8?q?=E3=80=81CRUD=20=E4=B8=A4=E5=A4=84=E4=B8=8A=E6=B8=B8=E7=BC=BA?= =?UTF-8?q?=E9=99=B7=E4=B8=8E=20DDL=20=E5=AE=9E=E6=B5=8B=E8=AE=A1=E6=95=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - §6:新增 id = 雪花号十进制串(上游 RandomUtil.uuId() = Yitter nextId),非 UUID - §3.1:新增 protocol.rs(协议版本闸门独立成模块),auth.rs 相应收窄 - §6:标注上游基类两处缺陷并给出 Rust 修正口径 (ApiConsumeLog 默认 keywordColumns 指向不存在的 f_name;filterColumns 对 smallint 列绑定失败) - §6/§12:DeliveryTask 的 no_create/no_delete 文案与 40 个 frozen_columns 口径 - §12.1/§12.2:DDL 实测计数 97 KB / 308 条可执行语句(原写 1233,实为朴素切分块数) Co-Authored-By: Claude Code --- .../2026-10-24-tdc-rs-align-v2-design.md | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/docs/superpowers/specs/2026-10-24-tdc-rs-align-v2-design.md b/docs/superpowers/specs/2026-10-24-tdc-rs-align-v2-design.md index f4b0bf0..8250040 100644 --- a/docs/superpowers/specs/2026-10-24-tdc-rs-align-v2-design.md +++ b/docs/superpowers/specs/2026-10-24-tdc-rs-align-v2-design.md @@ -120,7 +120,8 @@ src/ config.rs 环境配置 + 协议常量 db.rs PGlite 句柄 + query_json + 字面量感知 SQL 切分 envelope.rs ActionResult / 分页 / 错误码映射 - auth.rs 三道门 + 协议版本闸门 + 操作人解析 + auth.rs 三道门 + 操作人解析 + protocol.rs 协议版本闸门(InternalTokenSupport 的 Rust 等价物:版本解析 + warnOnce) session.rs X-Auth-Token 会话存储 registry.rs 18 实体 × 表元数据注册表 crud.rs 通用 CRUD 引擎 @@ -403,7 +404,7 @@ Rust 侧**一律不调用**。 | tenantId | 若 `tenant_column` 非空,**客户端传 `tenantId` 一律拒绝**(身份不可由客户端切换)⇒ HTTP 200 + `code:400` | | 排序 | `default_order_column` **倒序** | | 参数归一 | 空串 → `null`(trim 后) | -| 新增 | id = UUID;`f_delete_mark = null`;`f_creator_time = now`;`f_creator_user_id = 操作人`;`beforeSave(entity, true)` | +| 新增 | id = **雪花号十进制串**(上游 `RandomUtil.uuId()` = Yitter `nextId()` 的十进制形态,≤19 位数字,**不是 UUID**);`f_delete_mark = null`;`f_creator_time = now`;`f_creator_user_id = 操作人`;`beforeSave(entity, true)` | | 修改 | **只覆盖请求体里出现的字段**(null 值跳过,等价 MyBatis-Plus `NOT_NULL` 策略);系统列(`f_creator_time` / `f_creator_user_id` / `f_delete_mark` / `f_delete_time` / `f_delete_user_id`)**不可从请求体覆盖**;`beforeSave(entity, false)` | | 删除 | 逻辑删除:`f_delete_mark = 1` + `f_delete_time` + `f_delete_user_id`;`beforeDelete` → 落库 → `afterDelete` | | 详情 | 不存在或已删除 ⇒ `code:400` "记录不存在或已删除" | @@ -413,7 +414,15 @@ Rust 侧**一律不调用**。 - `tdc_api_consume_log` / `tdc_audit_log` / `tdc_destroy_log` / `tdc_delivery_log` / `tdc_policy_check_log` ⇒ `no_create`(系统写入)。 - `tdc_audit_log` ⇒ 另加 `no_update` / `no_delete`(append-only + 哈希链)。 - `tdc_dataset` ⇒ `readonly`(派生视图,写一律失败)。 -- `tdc_delivery_task` ⇒ `no_create` / `no_delete` / 约 40 个 `frozen_columns`。 +- `tdc_delivery_task` ⇒ `no_create`(POST 一律返回上游原文「该入口已废弃:交付任务只能由发起方经平台发起…」)/ `no_delete`(「交付任务记录是审计证据,不允许删除」)/ **40 个 `frozen_columns`**(`PUT` 时**只拒「值真的变化」**,未传/null 视为保持原值不算变化)。 + +⚠️ **上游基类的两处缺陷,Rust 侧按「修正」实现并在文档标注**(不照抄 bug): +1. `TdcCrudController.keywordColumns()` 默认返回 `{"f_name"}`,而 `tdc_api_consume_log` **没有 `f_name` 列** + ⇒ 上游对该表做关键字搜索会 PG `42703`(列不存在)。Rust 侧把 `ApiConsumeLog` 的关键字列改为 + `{"f_order_code", "f_app_id", "f_product_id"}`。 +2. 基类 `filterColumns()` 的值是 HTTP 字符串,MyBatis 以 varchar 绑定; + 对 `smallint` 列(`f_default_mark` / `f_read_mark`)比较会 PG「operator does not exist」。 + Rust 侧统一用 `CAST(col AS TEXT) = $1`(参数恒为 text),规避类型推断/绑定问题。 --- @@ -892,7 +901,7 @@ append-only + 哈希链。`tdc_audit_log` 禁止改 / 删。链指纹与载荷 1. 按版本序把上游 **82** 个迁移(`boot/db/tdc/` 76 个 + `boot/db/` 根目录 **6** 个)依次打进一个临时 PostgreSQL; 2. `pg_dump --schema-only --no-owner --no-privileges` 导出; 3. 剥掉 `\restrict` / `\unrestrict` / `SET` 前言 / `SELECT pg_catalog.set_config('search_path','',false)` / owner 语句; -4. 产物落 `static/migrate.sql`(**92 KB / 1233 条语句**); +4. 产物落 `static/migrate.sql`(**97 KB / 308 条可执行语句**:30 × `CREATE TABLE` + 31 × `ALTER TABLE` + 89 × `CREATE INDEX` + 158 × `COMMENT ON`); 5. `scripts/gen-migrate.sh` 保证可重放(上游再动就重跑脚本)。 ⚠️ `boot/db/` 根目录那 6 个(`V1.0.4` ~ `V1.0.9`)**易漏**——它们创建 `tdc_order` / `tdc_api_consume_log` / @@ -906,7 +915,7 @@ append-only + 哈希链。`tdc_audit_log` 禁止改 / 删。链指纹与载荷 | 82 个迁移打进 PG 16.14 | **零失败** | | 产出表 | **30 张** | | 与上游 box 快照 `deploy/box-pg/schema/tdc_box.sql` 对账 | **逐一同名,零差异** | -| 合并 DDL | 92 KB | +| 合并 DDL | 97 KB / **308 条可执行语句**(字面量感知切分后) | ### 12.3 本地扩展 DDL