docs(spec): 修正 id 生成、模块划分、CRUD 两处上游缺陷与 DDL 实测计数
- §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 <[email protected]>
This commit is contained in:
1 parent
b418621314
commit
1e1bacf094
1 file changed
+14
-5
@@ -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
|
||||
|
||||
|
||||
Reference in new issue
Block a user