diff --git a/docs/superpowers/2026-10-26-tdc-rs-upstream-diff.md b/docs/superpowers/2026-10-26-tdc-rs-upstream-diff.md new file mode 100644 index 0000000..9efb9d2 --- /dev/null +++ b/docs/superpowers/2026-10-26-tdc-rs-upstream-diff.md @@ -0,0 +1,750 @@ +# tdc-rs × 上游 Java TDC 差异表(B0 只读核查) + +> **生成日期**:2026-10-26 +> **上游只读快照**:`/tmp/sswtdc-probe`(`boot/db/` 迁移 82 个 + `boot/ssw-tdc/ssw-tdc-entity` 27 个实体 + `boot/ssw-tdc/ssw-tdc-controller` 32 个控制器) +> **本仓 commit**:`17a16ec9301b080c3f26d68c431a1837cff15e16`(分支 `feat/mvc-align-v3`,`git rev-parse HEAD`) +> **方法**:**静态解析 SQL 文本**,不建 PG 库、不执行 DDL。脚本在 `/tmp/tdc-b0/`(`parse_upstream.py` / `compare_cols.py` / `parse_ctrl.py` / `coverage.py`),可重放命令见 §8。 +> **本次改动**:只新增本文件,**未改任何 `src/` / `schema/` / `scripts/` / `tests/`**,**未 commit**。 + +## 0. 阅读须知:口径定义 + +| 口径 | 定义 | +|---|---| +| **建过** | 在 82 个迁移里出现过 `CREATE TABLE` 的表名**去重全集**(同一表被 DROP 后重建只算 1 张) | +| **活** | 按版本序重放到最后**仍然存在**的表名全集(建过且未被最终 DROP) | +| **已删** | 建过、但最终被某个迁移 `DROP TABLE` 掉的表名全集 | +| **上游最终列形状** | 某表的 `CREATE TABLE` 体内列 + 其后所有 `ALTER TABLE … ADD/DROP/ALTER COLUMN` 叠加后的结果 | +| **本仓列形状** | `schema/migrate.sql` 里 `CREATE TABLE public. ( … )` 体的列(pg_dump 格式) | +| **上游有效端点** | 控制器**自己声明**的方法级映射 + 从 `TdcCrudController` **继承**的 6 条通用 CRUD(被同名同法覆盖的不重复计) | +| **本仓端点** | `src/routes/*.rs` 里注册的方法级路由(含 `src/routes/crud.rs` 按注册表循环生成的 18×6 条) | + +### ⚠️ 静态解析要处理的 5 个上游坑(都已在脚本里修掉,否则数字会错) + +1. **V2.10.0 版本号重复**(`V2.10.0__tdc_order_contract_id.sql` 与 `V2.10.0__tdc_usage_metric.sql`)⇒ 必须按 `(major, minor, patch, 文件名)` **显式**排序,不能靠字符串排序(`scripts/gen-migrate.sh` 的 awk 兜底同理)。 +2. **引号修饰的限定名**:`ALTER TABLE "public"."tdc_datasource" ADD COLUMN …` —— 朴素正则匹配不到,会整条 ALTER 丢失。 + 上游共 **7 个**迁移用了这种写法:`V2.45.0__datasource_file_sftp.sql` / `V2.46.0__datasource_api_request.sql` / + `V2.48.0__sandbox_session.sql` / `V2.51.0__sandbox_fetch_key.sql` / `V2.70.0__sandbox_session_end.sql` / + `V2.71.0__sandbox_dataset_mode_and_fetch_counters.sql` / `V2.72.0__privacy_dev_and_audit.sql`。 +3. **`ADD COLUMN IF NOT EXISTS` 的幂等语义**:列已存在时**不覆盖**类型/约束(PG 实际行为)。上游共 **215** 处 + `ADD COLUMN IF NOT EXISTS`,其中实测 **4 处**因列已存在而成为空操作(解析器的 `ADD_COLUMN_EXISTS` 事件): + `tdc_delivery_task.f_delivery_type`(`V1.0.4__tdc_order.sql:70`)/ `tdc_delivery_task.f_result_uri`(同文件 `:70`)/ + `tdc_resource.f_datasource_id`(`V1.0.5__tdc_v012_publish.sql:8`)/ `tdc_product.f_desc`(同文件 `:16`)。 + 例:`V1.0.4__tdc_order.sql:71` 的 `ALTER TABLE tdc_delivery_task ADD COLUMN IF NOT EXISTS f_delivery_type varchar(32) NULL;` + **无效** ⇒ `tdc_delivery_task.f_delivery_type` 最终仍是 V1.0.0 建的 `varchar(20) NOT NULL DEFAULT 'API'`(`V1.0.0__tdc_schema.sql:482`)。 +4. **`DO $$ … $$` 块里的 DDL**(只有 `V2.78.0__contract_quota_anchor.sql` 一个文件):块内 `ALTER TABLE … DROP COLUMN a, DROP COLUMN b, …` 与 `ADD COLUMN` 必须单独抽出来重放,否则 `tdc_contract` 会算出 3 个已删列 + 缺 1 个锚点列。 +5. **多列 `DROP COLUMN` 一条语句**(V2.78.0)与 **`ADD` 逗号串**(V1.0.4 / V1.0.5 等):要按顶层逗号切分、逐条剥 `ADD`/`COLUMN`/`IF NOT EXISTS` 前缀。 + +> 上述 5 条修完后,解析器的「未解析列定义」计数为 **0**,30 张活表的上游列数合计 = **785**,与本仓 `schema/migrate.sql` 的 **785** 完全相等(§4)。 + +--- + +## 1. 结论摘要(数字表) + +### 1.1 表集 + +| 指标 | **实测** | spec 声称 | 一致? | +|---|---|---|---| +| 上游迁移文件数 | **82**(`boot/db/tdc/` 76 + `boot/db/` 根 6) | 82 | ✔ | +| 上游**建过**的表 | **43** | 43 | ✔ | +| 上游**活**的表(最终态) | **30** | 30 | ✔ | +| 上游**已删**的表(建过但最终不在) | **13** | 13 | ✔ | +| 本仓 `tdc_*` 表 | **30** | 30 | ✔ | +| **上游活 ∧ 本仓有**(同名) | **30** | — | — | +| **上游活 ∧ 本仓无**(本仓缺表) | **0** | — | — | +| **本仓有 ∧ 上游活无**(本仓多表) | **0** | — | — | +| 上游活表列数合计 vs 本仓 | **785 = 785** | — | ✔ | + +### 1.2 列级差异 + +| 指标 | **实测** | +|---|---| +| 同名表**缺列**(上游有、本仓无) | **0** | +| 同名表**多列**(本仓有、上游无) | **0** | +| 同名表**类型不同** | **0** | +| 同名表**可空性不同** | **5**,**全部**是 `f_id` 的 `PRIMARY KEY` ⇒ `NOT NULL` 的 **pg_dump 表示法差异**,非真实差异(见 §4.2) | + +### 1.3 实体 + +| 指标 | **实测** | spec 声称 | 一致? | +|---|---|---|---| +| 上游 Java 实体 | **27** | 27 | ✔ | +| 本仓注册实体 | **18**(对应 **17** 张物理表:`Resource` 与 `Dataset` 同表 `tdc_resource`) | 18 | ✔ | +| 上游实体**本仓无独立实体** | **10** | 9 | ✘ **差 1**(见 §5.2) | +| ├ 其中**纯子表**(上游也无独立控制器,走父实体聚合) | **7** | 7 | ✔ | +| ├ 其中**会话日志表**(`tdc_p2p_session`,上游也只在 `P2PChannelController` 内部读写) | **1** | 未列 | — | +| └ 其中**作业记录表**(`tdc_sandbox_exec_run` / `tdc_privacy_exec_run`;spec §43 要求「本仓照常提供 CRUD」) | **2** | 未列 | — | +| 本仓有、上游无的实体 | **0** | — | — | + +### 1.4 控制器 + +| 指标 | **实测** | spec 声称 | 一致? | +|---|---|---|---| +| 上游控制器(`controller/` 包内 `.java`) | **32**(= 31 个 `@RestController` + 1 个抽象模板 `TdcCrudController.java:57`;模块内共 35 个 `.java`,另 3 个是 `NotifyDispatcher` + 2 个 ticker) | 33 | ✘ **差 1** | +| 上游控制器**自己声明**的方法级端点 | **168**(含模板自身 6 条) | — | — | +| 上游**有效端点**(含 18 个控制器各继承的 6 条通用 CRUD,扣掉抽象模板自身的 6 条) | **259** | — | — | +| 本仓方法级端点 | **132** | — | — | +| 上游有效端点**被本仓覆盖** | **124**(47.9%) | — | — | +| 上游有效端点**未覆盖** | **135** | — | — | +| **完全覆盖**的控制器 | **6 / 32**(ApiConsumeLog / Auth / Billing / DestroyLog / PolicyCheckLog / ServiceCatalog) | — | — | +| **有缺口**的控制器 | **25 / 32** | ≈11 | ✘ **多 14 个** | + +### 1.5 一句话结论 + +> **Schema 层面本仓已经追平上游**(30 表逐名逐列 100% 一致,唯一差异是 pg_dump 对 `PRIMARY KEY` 的 `NOT NULL` 表示法)。 +> **差距全在「动作端点」与「实体暴露面」**:上游 259 条有效端点,本仓覆盖 124 条;25 个控制器有缺口;10 个上游实体没有独立实体(7 个是子表、2 个是作业记录表、1 个是 P2P 会话日志)。 + +--- + +## 2. 上游表集:建过 / 活 / 已删 + +### 2.1 建过 43 张(按创建迁移的版本序) + +| # | 表名 | 创建迁移(行号) | 最终态 | +|---|---|---|---| +| 1 | `tdc_api_service` | `boot/db/tdc/V1.0.0__tdc_schema.sql:434` | **DEAD** | +| 2 | `tdc_identity` | `boot/db/tdc/V1.0.0__tdc_schema.sql:35` | ALIVE | +| 3 | `tdc_datasource` | `boot/db/tdc/V1.0.0__tdc_schema.sql:89` | ALIVE | +| 4 | `tdc_resource` | `boot/db/tdc/V1.0.0__tdc_schema.sql:133` | ALIVE | +| 5 | `tdc_resource_field` | `boot/db/tdc/V1.0.0__tdc_schema.sql:183` | ALIVE(**后被重建**,见 §2.3) | +| 6 | `tdc_mask_rule` | `boot/db/tdc/V1.0.0__tdc_schema.sql:219` | **DEAD** | +| 7 | `tdc_product` | `boot/db/tdc/V1.0.0__tdc_schema.sql:251` | ALIVE | +| 8 | `tdc_contract` | `boot/db/tdc/V1.0.0__tdc_schema.sql:305` | ALIVE | +| 9 | `tdc_policy` | `boot/db/tdc/V1.0.0__tdc_schema.sql:355` | ALIVE | +| 10 | `tdc_policy_check_log` | `boot/db/tdc/V1.0.0__tdc_schema.sql:392` | ALIVE | +| 11 | `tdc_delivery_task` | `boot/db/tdc/V1.0.0__tdc_schema.sql:475` | ALIVE | +| 12 | `tdc_delivery_log` | `boot/db/tdc/V1.0.0__tdc_schema.sql:527` | ALIVE | +| 13 | `tdc_sync_log` | `boot/db/tdc/V1.0.0__tdc_schema.sql:556` | ALIVE | +| 14 | `tdc_audit_log` | `boot/db/tdc/V1.0.0__tdc_schema.sql:594` | ALIVE | +| 15 | `tdc_order` | `boot/db/V1.0.4__tdc_order.sql:10` | ALIVE | +| 16 | `tdc_role_apply` | `boot/db/V1.0.7__tdc_portal_role.sql:7` | **DEAD** | +| 17 | `tdc_role_grant` | `boot/db/V1.0.7__tdc_portal_role.sql:37` | **DEAD** | +| 18 | `tdc_member` | `boot/db/V1.0.7__tdc_portal_role.sql:59` | **DEAD** | +| 19 | `tdc_demand` | `boot/db/V1.0.8__tdc_b6_p1.sql:15` | **DEAD** | +| 20 | `tdc_api_consume_log` | `boot/db/V1.0.9__tdc_b7_p2.sql:24` | ALIVE | +| 21 | `tdc_notify` | `boot/db/tdc/V1.1.0__tdc_p0.sql:8` | ALIVE | +| 22 | `tdc_destroy_log` | `boot/db/tdc/V1.1.0__tdc_p0.sql:40` | ALIVE | +| 23 | `tdc_sync_task` | `boot/db/tdc/V2.0.0__tdc_governance.sql:10` | **DEAD** | +| 24 | `tdc_quality_rule` | `boot/db/tdc/V2.0.0__tdc_governance.sql:35` | **DEAD** | +| 25 | `tdc_quality_report` | `boot/db/tdc/V2.0.0__tdc_governance.sql:58` | **DEAD** | +| 26 | `tdc_prod_task` | `boot/db/tdc/V2.1.0__tdc_prod.sql:7` | **DEAD** | +| 27 | `tdc_prod_run_log` | `boot/db/tdc/V2.1.0__tdc_prod.sql:32` | **DEAD** | +| 28 | `tdc_analysis_job` | `boot/db/tdc/V2.2.0__tdc_analysis.sql:7` | **DEAD** | +| 29 | `tdc_p2p_session` | `boot/db/tdc/V2.3.0__tdc_p2p_log.sql:7` | ALIVE | +| 30 | `tdc_sync_run_log` | `boot/db/tdc/V2.4.0__tdc_sync_run_log.sql:7` | **DEAD** | +| 31 | `tdc_credential` | `boot/db/tdc/V2.5.0__tdc_credential.sql:9` | ALIVE | +| 32 | `tdc_demo_car_insurance` | `boot/db/tdc/V2.6.0__tdc_delivery_data_demo.sql:16` | ALIVE | +| 33 | `tdc_demo_pii` | `boot/db/tdc/V2.7.0__tdc_demo_pii.sql:9` | ALIVE | +| 34 | `tdc_delivery_outbox` | `boot/db/tdc/V2.54.0__delivery_task_state_authority.sql:36` | ALIVE | +| 35 | `tdc_delivery_task_participant` | `boot/db/tdc/V2.66.0__delivery_task_multiparty.sql:30` | ALIVE | +| 36 | `tdc_demo_insurance_claims` | `boot/db/tdc/V2.81.0__sandbox_demo_insurance_claims.sql:15` | ALIVE | +| 37 | `tdc_sandbox_exec_run` | `boot/db/tdc/V2.86.0__sandbox_exec_run.sql:36` | ALIVE | +| 38 | `tdc_privacy_exec_run` | `boot/db/tdc/V2.87.0__privacy_exec_run.sql:23` | ALIVE | +| 39 | `tdc_data_interface` | `boot/db/tdc/V2.88.0__data_interface.sql:9` | ALIVE | +| 40 | `tdc_data_interface_param` | `boot/db/tdc/V2.88.0__data_interface.sql:43` | ALIVE | +| 41 | `tdc_data_interface_field` | `boot/db/tdc/V2.88.0__data_interface.sql:62` | ALIVE | +| 42 | `tdc_resource_mask_rule` | `boot/db/tdc/V2.89.0__data_asset_5_2.sql:62` | ALIVE | +| 43 | `tdc_policy_template` | `boot/db/tdc/V2.90.0__data_product_5_4.sql:32` | ALIVE | + +### 2.2 活着的 30 张(= 本仓 30 张,逐名相同) + +``` +tdc_api_consume_log tdc_audit_log tdc_contract tdc_credential +tdc_data_interface tdc_data_interface_field tdc_data_interface_param tdc_datasource +tdc_delivery_log tdc_delivery_outbox tdc_delivery_task tdc_delivery_task_participant +tdc_demo_car_insurance tdc_demo_insurance_claims tdc_demo_pii tdc_destroy_log +tdc_identity tdc_notify tdc_order tdc_p2p_session +tdc_policy tdc_policy_check_log tdc_policy_template tdc_privacy_exec_run +tdc_product tdc_resource tdc_resource_field tdc_resource_mask_rule +tdc_sandbox_exec_run tdc_sync_log +``` + +### 2.3 被后续迁移 DROP 掉的 13 张 + +| 表名 | 建于 | 被谁 DROP(文件:行) | +|---|---|---| +| `tdc_api_service` | `V1.0.0__tdc_schema.sql:434` | `V1.0.0__tdc_schema.sql:19`(同文件开头的旧表清理)、`V2.55.0__field_cleanup_dead_cols.sql:41` | +| `tdc_mask_rule` | `V1.0.0__tdc_schema.sql:219` | `V1.0.0__tdc_schema.sql:24`、`V2.92.0__drop_dev_center_tables.sql:11` | +| `tdc_role_apply` | `V1.0.7__tdc_portal_role.sql:7` | `V2.42.1__drop_member_role_tables.sql:6` | +| `tdc_role_grant` | `V1.0.7__tdc_portal_role.sql:37` | `V2.42.1__drop_member_role_tables.sql:7` | +| `tdc_member` | `V1.0.7__tdc_portal_role.sql:7`…`:59` | `V2.42.1__drop_member_role_tables.sql:8` | +| `tdc_demand` | `V1.0.8__tdc_b6_p1.sql:15` | `V2.94.0__drop_tdc_demand.sql:12` | +| `tdc_sync_task` | `V2.0.0__tdc_governance.sql:10` | `V2.92.0__drop_dev_center_tables.sql:4` | +| `tdc_quality_rule` | `V2.0.0__tdc_governance.sql:35` | `V2.92.0__drop_dev_center_tables.sql:6` | +| `tdc_quality_report` | `V2.0.0__tdc_governance.sql:58` | `V2.92.0__drop_dev_center_tables.sql:7` | +| `tdc_prod_task` | `V2.1.0__tdc_prod.sql:7` | `V2.92.0__drop_dev_center_tables.sql:8` | +| `tdc_prod_run_log` | `V2.1.0__tdc_prod.sql:32` | `V2.92.0__drop_dev_center_tables.sql:9` | +| `tdc_analysis_job` | `V2.2.0__tdc_analysis.sql:7` | `V2.92.0__drop_dev_center_tables.sql:10` | +| `tdc_sync_run_log` | `V2.4.0__tdc_sync_run_log.sql:7` | `V2.92.0__drop_dev_center_tables.sql:5` | + +**唯一「DROP 后重建」的表**:`tdc_resource_field` +`V1.0.0__tdc_schema.sql:183`(初建,26 列)→ `V2.55.0__field_cleanup_dead_cols.sql:42`(DROP)→ `V2.89.0__data_asset_5_2.sql:48`(同名重建,**7 列**)。 +⇒ **最终形状以 V2.89.0 的 7 列为准**,本仓 `schema/migrate.sql:1960` 正是这 7 列 ⇒ 一致。 + +--- + +## 3. 表名对账(三个差集) + +| 差集 | 数量 | 名单 | +|---|---|---| +| **上游活 ∧ 本仓有**(同名) | **30** | 见 §2.2,两侧表名**逐字相同** | +| **上游活 ∧ 本仓无**(本仓缺表) | **0** | — | +| **本仓有 ∧ 上游活无**(本仓多表 / 形状过时) | **0** | — | + +### 3.1 本仓 30 张表 ↔ `schema/migrate.sql` 行号 ↔ 上游活表 + +| 本仓表 | `schema/migrate.sql` 行 | 上游活表 | 本仓注册实体(`src/registry.rs` 行) | +|---|---|---|---| +| `tdc_api_consume_log` | `:16` | ✔ | `ApiConsumeLog`(`:274`) | +| `tdc_audit_log` | `:98` | ✔ | `AuditLog`(`:298`) | +| `tdc_contract` | `:197` | ✔ | `Contract`(`:321`) | +| `tdc_credential` | `:284` | ✔ | `Credential`(`:349`) | +| `tdc_data_interface` | `:378` | ✔ | `DataInterface`(`:371`) | +| `tdc_data_interface_field` | `:439` | ✔ | **无实体**(子表,见 §5.2) | +| `tdc_data_interface_param` | `:459` | ✔ | **无实体**(子表,见 §5.2) | +| `tdc_datasource` | `:487` | ✔ | `Datasource`(`:401`) | +| `tdc_delivery_log` | `:584` | ✔ | `DeliveryLog`(`:421`) | +| `tdc_delivery_outbox` | `:624` | ✔ | **无实体**(子表,见 §5.2) | +| `tdc_delivery_task` | `:648` | ✔ | `DeliveryTask`(`:440`) | +| `tdc_delivery_task_participant` | `:951` | ✔ | **无实体**(子表,见 §5.2) | +| `tdc_demo_car_insurance` | `:1083` | ✔ | **无实体**(子表,见 §5.2) | +| `tdc_demo_insurance_claims` | `:1115` | ✔ | **无实体**(demo 数据表) | +| `tdc_demo_pii` | `:1160` | ✔ | **无实体**(demo 数据表) | +| `tdc_destroy_log` | `:1189` | ✔ | `DestroyLog`(`:476`) | +| `tdc_identity` | `:1215` | ✔ | `Identity`(`:495`) | +| `tdc_notify` | `:1329` | ✔ | `Notification`(`:523`) | +| `tdc_order` | `:1359` | ✔ | `Order`(`:545`) | +| `tdc_p2p_session` | `:1416` | ✔ | **无实体**(P2P 会话日志,见 §5.2) | +| `tdc_policy` | `:1468` | ✔ | `Policy`(`:571`) | +| `tdc_policy_check_log` | `:1514` | ✔ | `PolicyCheckLog`(`:590`) | +| `tdc_policy_template` | `:1570` | ✔ | `PolicyTemplate`(`:610`) | +| `tdc_privacy_exec_run` | `:1628` | ✔ | **无实体**(作业记录表,见 §5.2) | +| `tdc_product` | `:1721` | ✔ | `Product`(`:625`) | +| `tdc_resource` | `:1849` | ✔ | `Resource`(`:649`)+ `Dataset`(`:386`,同表只读视图) | +| `tdc_resource_field` | `:1960` | ✔ | **无实体**(子表,走 `Resource/{id}/Detail` 聚合,见 §5.2) | +| `tdc_resource_mask_rule` | `:1975` | ✔ | **无实体**(子表,走 `Resource/{id}/Detail` 聚合,见 §5.2) | +| `tdc_sandbox_exec_run` | `:1991` | ✔ | **无实体**(作业记录表,见 §5.2) | +| `tdc_sync_log` | `:2089` | ✔ | **无实体**(上游也无独立控制器) | + +--- + +## 4. 同名表的列级差异 + +### 4.1 汇总 + +| 差异类型 | 数量 | +|---|---| +| 缺列(上游有、本仓无) | **0** | +| 多列(本仓有、上游无) | **0** | +| 类型不同 | **0** | +| 可空性不同 | **5**(**全部**是 `f_id` 的 pg_dump 表示法差异,见 §4.2) | + +**逐表列数对账(30/30 一致)**: + +| 表 | 上游列数 | 本仓列数 | | 表 | 上游列数 | 本仓列数 | +|---|---|---|---|---|---|---| +| `tdc_api_consume_log` | 25 | 25 | | `tdc_notify` | 22 | 22 | +| `tdc_audit_log` | 35 | 35 | | `tdc_order` | 35 | 35 | +| `tdc_contract` | 37 | 37 | | `tdc_p2p_session` | 23 | 23 | +| `tdc_credential` | 23 | 23 | | `tdc_policy` | 24 | 24 | +| `tdc_data_interface` | 18 | 18 | | `tdc_policy_check_log` | 27 | 27 | +| `tdc_data_interface_field` | 5 | 5 | | `tdc_policy_template` | 15 | 15 | +| `tdc_data_interface_param` | 6 | 6 | | `tdc_privacy_exec_run` | 29 | 29 | +| `tdc_datasource` | 47 | 47 | | `tdc_product` | 50 | 50 | +| `tdc_delivery_log` | 18 | 18 | | `tdc_resource` | 40 | 40 | +| `tdc_delivery_outbox` | 9 | 9 | | `tdc_resource_field` | 7 | 7 | +| `tdc_delivery_task` | 99 | 99 | | `tdc_resource_mask_rule` | 8 | 8 | +| `tdc_delivery_task_participant` | 33 | 33 | | `tdc_sandbox_exec_run` | 27 | 27 | +| `tdc_demo_car_insurance` | 17 | 17 | | `tdc_sync_log` | 22 | 22 | +| `tdc_demo_insurance_claims` | 9 | 9 | | `tdc_destroy_log` | 18 | 18 | +| `tdc_demo_pii` | 14 | 14 | | `tdc_identity` | 43 | 43 | +| | | | | **合计** | **785** | **785** | + +### 4.2 那 5 处「可空性不同」不是真差异 + +| 表 | 列 | 上游写法 | 本仓写法 | 判定 | +|---|---|---|---|---| +| `tdc_api_consume_log` | `f_id` | `varchar(50)` +(后续 `PRIMARY KEY`)`V1.0.9__tdc_b7_p2.sql:24` | `character varying(50) NOT NULL`(`schema/migrate.sql:17`) | pg_dump 表示法 | +| `tdc_destroy_log` | `f_id` | `varchar(50) PRIMARY KEY`(`V1.1.0__tdc_p0.sql:40`) | `character varying(50) NOT NULL`(`schema/migrate.sql:1190`) | pg_dump 表示法 | +| `tdc_notify` | `f_id` | `varchar(50) PRIMARY KEY`(`V1.1.0__tdc_p0.sql:8`) | `character varying(50) NOT NULL`(`schema/migrate.sql:1330`) | pg_dump 表示法 | +| `tdc_order` | `f_id` | `varchar(50) PRIMARY KEY`(`V1.0.4__tdc_order.sql:10`) | `character varying(50) NOT NULL`(`schema/migrate.sql:1360`) | pg_dump 表示法 | +| `tdc_p2p_session` | `f_id` | `varchar(50) PRIMARY KEY`(`V2.3.0__tdc_p2p_log.sql:7`) | `character varying(50) NOT NULL`(`schema/migrate.sql:1417`) | pg_dump 表示法 | + +**理由**:PostgreSQL 里 `PRIMARY KEY` **隐含** `NOT NULL`,`pg_dump` 导出时会把 PK 列写成显式 `NOT NULL`。 +上游手写 DDL 只写 `PRIMARY KEY` 不写 `NOT NULL`,⇒ **建出来的库完全等价**,不是差异。 +⇒ **结论:本仓 schema 与上游最终形状 100% 一致,B2(schema 追平)在本仓侧无「补表 / 补列」工作量。** + +### 4.3 上游被丢弃的列(本仓正确地没有) + +上游共有 **13 个**迁移执行过 `ALTER TABLE … DROP COLUMN`,合计删除 **54 列**(52 条语句,其中 +`V2.78.0__contract_quota_anchor.sql:57` 一条语句删 3 列): + +| 迁移 | 删列数 | +|---|---| +| `V2.45.0__datasource_file_sftp.sql` | 2 | +| `V2.52.0__drop_redundant_fields.sql` | 16 | +| `V2.55.0__field_cleanup_dead_cols.sql` | 14 | +| `V2.78.0__contract_quota_anchor.sql` | 3 | +| `V2.79.0__identity_drop_org_name.sql` | 1 | +| `V2.80.0__four_types_quota_and_fixed_billing.sql` | 2 | +| `V2.83.0__drop_resource_dead_cols.sql` | 2 | +| `V2.85.0__drop_sandbox_dataset_and_fetch_cols.sql` | 5 | +| `V2.86.1__drop_sandbox_work_ref_and_export_cols.sql` | 4 | +| `V2.88.1__data_interface_drop_paged.sql` | 1 | +| `V2.89.1__drop_resource_mask_config.sql` | 1 | +| `V2.90.1__drop_policy_template_shim_cols.sql` | 2 | +| `V2.91.0__drop_identity_type.sql` | 1 | + +本仓**一列都没保留**(§4.1 的「多列 = 0」就是这条的镜像)⇒ 本仓 schema 是**追平到最新上游**的,不含任何历史残留列。 +另有 **8 处** `ALTER COLUMN … TYPE`(上游改过类型,本仓类型已与最终值一致 ⇒ §4.1 的「类型差 = 0」)。 + +--- + +## 5. 实体覆盖差(27 ↔ 18) + +### 5.1 已覆盖的 17 个(上游 17 个实体 ↔ 本仓 18 个注册实体) + +| 上游实体文件(`ssw-tdc-entity/…/entity/`) | `@TableName`(行号) | 本仓注册实体 | 本仓表 | +|---|---|---|---| +| `ApiConsumeLogEntity.java` | `tdc_api_consume_log`(`:24`) | `ApiConsumeLog` | `tdc_api_consume_log` | +| `ContractEntity.java` | `tdc_contract`(`:26`) | `Contract` | `tdc_contract` | +| `CredentialEntity.java` | `tdc_credential`(`:26`) | `Credential` | `tdc_credential` | +| `DataInterfaceEntity.java` | `tdc_data_interface`(`:26`) | `DataInterface` | `tdc_data_interface` | +| `DatasourceEntity.java` | `tdc_datasource`(`:26`) | `Datasource` | `tdc_datasource` | +| `DeliveryLogEntity.java` | `tdc_delivery_log`(`:24`) | `DeliveryLog` | `tdc_delivery_log` | +| `DeliveryTaskEntity.java` | `tdc_delivery_task`(`:27`) | `DeliveryTask` | `tdc_delivery_task` | +| `DestroyLogEntity.java` | `tdc_destroy_log`(`:21`) | `DestroyLog` | `tdc_destroy_log` | +| `IdentityEntity.java` | `tdc_identity`(`:26`) | `Identity` | `tdc_identity` | +| `NotifyEntity.java` | `tdc_notify`(`:24`) | `Notification` | `tdc_notify` | +| `OrderEntity.java` | `tdc_order`(`:29`) | `Order` | `tdc_order` | +| `PolicyCheckLogEntity.java` | `tdc_policy_check_log`(`:25`) | `PolicyCheckLog` | `tdc_policy_check_log` | +| `PolicyEntity.java` | `tdc_policy`(`:26`) | `Policy` | `tdc_policy` | +| `PolicyTemplateEntity.java` | `tdc_policy_template`(`:28`) | `PolicyTemplate` | `tdc_policy_template` | +| `ProductEntity.java` | `tdc_product`(`:26`) | `Product` | `tdc_product` | +| `ResourceEntity.java` | `tdc_resource`(`:25`) | `Resource` **+** `Dataset`(同表只读视图) | `tdc_resource` | +| `TdcAuditLogEntity.java` | `tdc_audit_log`(`:26`) | `AuditLog` | `tdc_audit_log` | + +> 本仓 18 个注册实体对应 **17** 张上游表:`Dataset` 与 `Resource` 共表 `tdc_resource`(`src/registry.rs:386-388`),与上游 `DatasetController` 复用 `ResourceEntity` 的口径一致。 + +### 5.2 上游有、本仓**无独立实体**的 10 个 + +| # | 上游实体文件 | 表 | 上游给它独立控制器吗? | 分类 | 本仓现状 | +|---|---|---|---|---|---| +| 1 | `ResourceFieldEntity.java:28` | `tdc_resource_field` | ❌(只有 `ResourceController#fields` `:532` 与聚合详情) | **子表** | 已由 `Resource/{id}/Detail` 聚合(`src/crud.rs:967-975` `child_tables()`) | +| 2 | `ResourceMaskRuleEntity.java:35` | `tdc_resource_mask_rule` | ❌(只有 `ResourceController#maskRulesOf` `:222`) | **子表** | 已由 `Resource/{id}/Detail` 聚合(同上) | +| 3 | `DataInterfaceFieldEntity.java:23` | `tdc_data_interface_field` | ❌(只有 `DataInterfaceController#export` `:172` / `preview` `:191`) | **子表** | ❌ 未聚合 | +| 4 | `DataInterfaceParamEntity.java:22` | `tdc_data_interface_param` | ❌(同上) | **子表** | ❌ 未聚合 | +| 5 | `TdcDeliveryTaskParticipantEntity.java:30` | `tdc_delivery_task_participant` | ❌(只被 `PrivacyComputServiceImpl` 内部读写) | **子表** | ❌ 未聚合 | +| 6 | `TdcDeliveryOutboxEntity.java:28` | `tdc_delivery_outbox` | ❌(只被 `DeliveryOutboxRetryTicker` / `DeliveryTaskServiceImpl` 内部读写) | **子表** | ❌ 未聚合 | +| 7 | `DemoCarInsuranceEntity.java:25` | `tdc_demo_car_insurance` | ❌(只被 `SandboxSessionServiceImpl` 内部读写) | **子表**(demo 数据) | ❌ 未聚合 | +| 8 | `P2pSessionEntity.java:25` | `tdc_p2p_session` | ❌(只在 `P2PChannelController` 内部读写,`:157/:195/:250/:289/:421`) | **会话日志表**(随 P2P 通道一起缺) | ❌ 未聚合 | +| 9 | `SandboxExecRunEntity.java:37` | `tdc_sandbox_exec_run` | ❌(只在 `ssw-tdc-biz` 内部引用:`SandboxExecCollector` / `DeliveryTaskServiceImpl` / `SandboxSessionServiceImpl` / `PrivacyComputServiceImpl`) | **作业记录表**(spec §43:*「照常提供 CRUD」*) | ❌ 无实体 | +| 10 | `PrivacyExecRunEntity.java:42` | `tdc_privacy_exec_run` | ❌(只在 `ssw-tdc-biz` 内部引用:`PrivacyExecCollector` / `PrivacyComputServiceImpl` / `PrivacyRedispatchTicker`) | **作业记录表**(spec §43:*「照常提供 CRUD」*) | ❌ 无实体 | + +> **与 spec 的差异**:spec §6.1 写「上游 27 个 Java 实体中,tdc-rs 未暴露的 **9** 个里 **7** 个是子表」。 +> **实测是 10 个**(不是 9 个):spec 列出的 7 个子表(`ResourceField` / `ResourceMaskRule` / `DataInterfaceField` / `DataInterfaceParam` / `DeliveryTaskParticipant` / `DeliveryOutbox` / `DemoCarInsurance`)与实测完全一致, +> 但**另外还有 3 个**:`tdc_p2p_session`(会话日志)、`tdc_sandbox_exec_run` + `tdc_privacy_exec_run`(作业记录表,spec §43 自己写了「本仓照常提供 CRUD」却没把它们算进实体缺口清单)。 +> ⇒ **B3/B4 的实体清单要按 10 个算,不是 9 个。** + +> **硬证据(可复跑)**:这 10 张表对应的实体类在**上游 `ssw-tdc-controller` 模块内零引用** +> (`grep -rl '' --include='*.java' ssw-tdc-controller/` 对 9 个实体全部无命中; +> 唯一例外是 `P2pSessionEntity`,它被 `P2PChannelController.java:23` import,但只在**方法体内部**读写, +> **没有** `@RequestMapping`/`@GetMapping`… 映射 ⇒ 仍然没有独立 CRUD 端点)。 +> 9 个实体全部只出现在 `ssw-tdc-entity`(自身)+ `ssw-tdc-biz`(service / mapper / ticker)。 +> ⇒ **上游确实不存在这 10 张表的独立控制器**,本仓是否暴露它们是**自主决策**,不是「漏实现」。 + +### 5.3 本仓有、上游无的实体 + +**0 个。** 本仓 18 个注册实体全部能在上游找到对应实体或同表视图。 + +### 5.4 上游无实体的活表 vs 本仓 + +上游 27 个实体覆盖 **27 张**活表 ⇒ 上游有 **3 张**活表**没有**任何 Java 实体: + +| 表 | 上游情况 | 本仓情况 | 一致? | +|---|---|---|---| +| `tdc_demo_insurance_claims` | 无实体,**Java/XML 里零引用**(`grep -rl 'tdc_demo_insurance_claims' --include='*.java' --include='*.xml'` 无命中) | 无实体 | ✔ | +| `tdc_demo_pii` | 无实体,**Java/XML 里零引用** | 无实体 | ✔ | +| `tdc_sync_log` | 无实体,**Java/XML 里零引用** | 无实体 | ✔ | + +⇒ **两侧口径一致**(这 3 张表只进库、不开放端点)。注意这 3 张**不在** §5.2 的「10 个缺口」里 —— +它们是**上游自己也没有**实体,属「从来就没有」,不是「本仓漏了」。 + +--- + +## 6. 控制器覆盖差(32 ↔ 本仓) + +### 6.1 总量 + +| 指标 | 数值 | +|---|---| +| 上游 `controller/` 包内控制器 | **32**(31 个 `@RestController` + 1 个抽象模板 `TdcCrudController.java:57`) | +| ├ 自声明方法级端点 | **168**(含模板自身 6 条) | +| ├ 从 `TdcCrudController` 继承的通用 CRUD | 6 条/个 × **18** 个子类(其中 **11** 条被子类同名方法覆盖,只计一次) | +| └ **有效端点合计**(去掉抽象模板自身的 6 条) | **259** | +| 本仓方法级端点 | **132** | +| ├ 覆盖上游 | **124** | +| └ 本仓独有(`/api/health`、`/api/oauth/Login`、`/api/permission/Users*` 共 8 条) | **8** | +| **未覆盖上游端点** | **135**(52.1%) | +| **完全覆盖的控制器** | **6 / 32** | + +> 上游 18 个继承 `TdcCrudController` 的控制器(`ApiConsumeLog` / `AuditLog` / `Contract` / `Credential` / `DataInterface` / `Dataset` / `Datasource` / `DeliveryLog` / `DeliveryTask` / `DestroyLog` / `Identity` / `Notification` / `Order` / `Policy` / `PolicyCheckLog` / `PolicyTemplate` / `Product` / `Resource`) +> ⇒ **恰好等于本仓 18 个注册实体**,通用 CRUD 6 条(列表 / `All` / 详情 / 新增 / 修改 / 删除)**本仓全部实现**(`src/routes/crud.rs:31/52/64/107/120` 按 `REGISTRY` 循环生成)。 + +### 6.2 逐控制器覆盖表 + +| 上游控制器 | base | 自声明 | 有效 | 覆盖 | **未覆盖** | 判定 | +|---|---|---|---|---|---|---| +| `ApiConsumeLogController.java` | `/api/ssw/tdc/ApiConsumeLog` | 0 | 6 | 6 | 0 | ✔ 全覆盖 | +| `AuthController.java` | `/api/ssw/tdc/Auth` | 4 | 4 | 4 | 0 | ✔ 全覆盖 | +| `BillingController.java` | `/api/ssw/tdc/Billing` | 7 | 7 | 7 | 0 | ✔ 全覆盖 | +| `DestroyLogController.java` | `/api/ssw/tdc/DestroyLog` | 0 | 6 | 6 | 0 | ✔ 全覆盖 | +| `PolicyCheckLogController.java` | `/api/ssw/tdc/PolicyCheckLog` | 0 | 6 | 6 | 0 | ✔ 全覆盖 | +| `ServiceCatalogController.java` | `/api/ssw/tdc/ServiceCatalog` | 3 | 3 | 3 | 0 | ✔ 全覆盖 | +| `ApiDocController.java` | `/api/ssw/tdc/DeliveryTask` | 1 | 1 | 0 | **1** | ✘ | +| `ApiGatewayController.java` | `/api/ssw/tdc/Gateway` | 2 | 2 | 0 | **2** | ✘ | +| `ContractController.java` | `/api/ssw/tdc/Contract` | 22 | 28 | 6 | **22** | ✘ | +| `CredentialController.java` | `/api/ssw/tdc/Credential` | 2 | 8 | 6 | **2** | ✘ | +| `DataInterfaceController.java` | `/api/ssw/tdc/DataInterface` | 6 | 12 | 6 | **6** | ✘ | +| `DatasetController.java` | `/api/ssw/tdc/Dataset` | 5 | 8 | 7 | **1** | ✘ | +| `DatasourceController.java` | `/api/ssw/tdc/Datasource` | 6 | 12 | 6 | **6** | ✘ | +| `DeliveryLogController.java` | `/api/ssw/tdc/DeliveryLog` | 1 | 7 | 6 | **1** | ✘ | +| `DeliveryTaskController.java` | `/api/ssw/tdc/DeliveryTask` | 27 | 29 | 6 | **23** | ✘ | +| `EngineJobController.java` | `/api/ssw/tdc` | 3 | 3 | 0 | **3** | ✘ | +| `FileController.java` | `/api/ssw/tdc/File` | 2 | 2 | 0 | **2** | ✘ | +| `IdentityController.java` | `/api/ssw/tdc/Identity` | 8 | 14 | 6 | **8** | ✘ | +| `NotificationController.java` | `/api/ssw/tdc/Notification` | 2 | 8 | 6 | **2** | ✘ | +| `OrderController.java` | `/api/ssw/tdc/Order` | 5 | 10 | 6 | **4** | ✘ | +| `P2PChannelController.java` | `/api/ssw/tdc/P2P` | 6 | 6 | 0 | **6** | ✘ | +| `PolicyController.java` | `/api/ssw/tdc/Policy` | 3 | 9 | 6 | **3** | ✘ | +| `PolicyTemplateController.java` | `/api/ssw/tdc/PolicyTemplate` | 1 | 7 | 6 | **1** | ✘ | +| `PortalController.java` | `/api/ssw/tdc/Portal` | 2 | 2 | 0 | **2** | ✘ | +| `ProductController.java` | `/api/ssw/tdc/Product` | 13 | 19 | 6 | **13** | ✘ | +| `ResourceController.java` | `/api/ssw/tdc/Resource` | 18 | 21 | 7 | **14** | ✘ | +| `SandboxSessionController.java` | `/api/ssw/tdc/SandboxSession` | 6 | 6 | 0 | **6** | ✘ | +| `TdcAuditLogController.java` | `/api/ssw/tdc/AuditLog` | 2 | 8 | 6 | **2** | ✘ | +| `TopologyController.java` | `/api/ssw/tdc/Topology` | 1 | 1 | 0 | **1** | ✘ | +| `TradeOrderBridgeController.java` | `/api/ssw/tdc/TradeOrderBridge` | 3 | 3 | 0 | **3** | ✘ | +| `UsageMetricReportController.java` | `/api/ssw/tdc/UsageMetric` | 1 | 1 | 0 | **1** | ✘ | +| `TdcCrudController.java` | (模板,无 base) | 6 | — | — | — | 通用 CRUD 模板,18 个子类共享 ⇒ 本仓已由 `src/routes/crud.rs` 通用路由覆盖 | + +### 6.3 未覆盖端点明细(135 条,按控制器) + +> 路径左侧是上游声明的**完整**路径(含类级 `@RequestMapping`),右侧是上游源文件:行号。 + +#### `ApiDocController.java`(1) +- `GET /api/ssw/tdc/DeliveryTask/{id}/ApiDoc` — `ApiDocController.java:42` + +#### `ApiGatewayController.java`(2) +- `POST /api/ssw/tdc/Gateway/Invoke` — `ApiGatewayController.java:79` +- `POST /api/ssw/tdc/Gateway/ProviderInvoke` — `ApiGatewayController.java:349` + +#### `ContractController.java`(22) +- `PUT /api/ssw/tdc/Contract/{id}/Sync` — `:166` +- `PUT /api/ssw/tdc/Contract/{id}/Effective` — `:184` +- `POST /api/ssw/tdc/Contract/LocalSign` — `:222` +- `POST /api/ssw/tdc/Contract/Proposal` — `:406` +- `POST /api/ssw/tdc/Contract/CreateByProposal` — `:478` +- `POST /api/ssw/tdc/Contract/MultiParty/CreateByConnector` — `:605` +- `POST /api/ssw/tdc/Contract/ConnectorSign` — `:700` +- `GET /api/ssw/tdc/Contract/MyOrders` — `:767` +- `POST /api/ssw/tdc/Contract/InitiateTask` — `:810` +- `POST /api/ssw/tdc/Contract/{id}/Initiate` — `:859` +- `GET /api/ssw/tdc/Contract/Initiables` — `:895` +- `GET /api/ssw/tdc/Contract/UsageMetrics` — `:934` +- `POST /api/ssw/tdc/Contract/{id}/Negotiate` — `:963` +- `POST /api/ssw/tdc/Contract/{id}/NegotiateRespond` — `:988` +- `GET /api/ssw/tdc/Contract/{id}/Negotiations` — `:1015` +- `GET /api/ssw/tdc/Contract/{id}/Negotiation/Status` — `:1038` +- `GET /api/ssw/tdc/Contract/{id}/Negotiation/Summary` — `:1052` +- `GET /api/ssw/tdc/Contract/{id}/Parties` — `:1066` +- `POST /api/ssw/tdc/Contract/{id}/Change` — `:1085` +- `POST /api/ssw/tdc/Contract/{id}/ChangeCancel` — `:1111` +- `POST /api/ssw/tdc/Contract/{id}/Terminate` — `:1134` +- `POST /api/ssw/tdc/Contract/{id}/Resign` — `:1186` + +#### `CredentialController.java`(2) +- `POST /api/ssw/tdc/Credential/Verify` — `:105` +- `PUT /api/ssw/tdc/Credential/{id}/Revoke` — `:155` + +#### `DataInterfaceController.java`(6) +- `PUT /api/ssw/tdc/DataInterface/{id}/Enable` — `:134` +- `PUT /api/ssw/tdc/DataInterface/{id}/Disable` — `:140` +- `POST /api/ssw/tdc/DataInterface/{id}/Copy` — `:163` +- `GET /api/ssw/tdc/DataInterface/{id}/Export` — `:172` +- `POST /api/ssw/tdc/DataInterface/Import` — `:183` +- `POST /api/ssw/tdc/DataInterface/{id}/Preview` — `:191` + +#### `DatasetController.java`(1) +- `GET /api/ssw/tdc/Dataset/{id}/Sample` — `:153` + +#### `DatasourceController.java`(6) +- `GET /api/ssw/tdc/Datasource/Types` — `:214` +- `PUT /api/ssw/tdc/Datasource/{id}/Test` — `:220` +- `PUT /api/ssw/tdc/Datasource/{id}/Sync` — `:246` +- `PUT /api/ssw/tdc/Datasource/{id}/Enable` — `:373` +- `PUT /api/ssw/tdc/Datasource/{id}/Disable` — `:383` +- `GET /api/ssw/tdc/Datasource/Enabled` — `:401` + +#### `DeliveryLogController.java`(1) +- `GET /api/ssw/tdc/DeliveryLog/ByTask/{taskId}` — `:89` + +#### `DeliveryTaskController.java`(23) +- `GET /api/ssw/tdc/DeliveryTask/EngineSelfCheck` — `:147` +- `POST /api/ssw/tdc/DeliveryTask/{tdsTaskId}/EngineJobs/Dispatch` — `:319` +- `PUT /api/ssw/tdc/DeliveryTask/{id}/Finish` — `:557` +- `POST /api/ssw/tdc/DeliveryTask/{id}/DataSetDeliver` — `:597` +- `PUT /api/ssw/tdc/DeliveryTask/{id}/Cancel` — `:612` +- `PUT /api/ssw/tdc/DeliveryTask/{id}/ReDeliver` — `:642` +- `PUT /api/ssw/tdc/DeliveryTask/{id}/Destroy` — `:740` +- `POST /api/ssw/tdc/DeliveryTask/{id}/Event` — `:770` +- `POST /api/ssw/tdc/DeliveryTask/CountRunning` — `:786` +- `POST /api/ssw/tdc/DeliveryTask/DestroyScan` — `:834` +- `POST /api/ssw/tdc/DeliveryTask/{id}/Dev/Open` — `:1133` +- `POST /api/ssw/tdc/DeliveryTask/{id}/Dev/AuditResult` — `:1151` +- `POST /api/ssw/tdc/DeliveryTask/{id}/Dev/Submit` — `:1184` +- `GET /api/ssw/tdc/DeliveryTask/{id}/Result/Summary` — `:1201` +- `POST /api/ssw/tdc/DeliveryTask/{id}/Result/Pull` — `:1217` +- `GET /api/ssw/tdc/DeliveryTask/{id}/Dev/Artifact` — `:1233` +- `GET /api/ssw/tdc/DeliveryTask/{id}/Result/Artifact` — `:1260` +- `GET /api/ssw/tdc/DeliveryTask/{id}/Result/Artifact/Proxy` — `:1273` +- `POST /api/ssw/tdc/DeliveryTask/{id}/RequestClose` — `:1286` +- `POST /api/ssw/tdc/DeliveryTask/{id}/Exec/Start` — `:1311` +- `POST /api/ssw/tdc/DeliveryTask/Internal/VoidAlgorithm` — `:1335` +- `GET /api/ssw/tdc/DeliveryTask/{id}/Exec/Status` — `:1359` +- `GET /api/ssw/tdc/DeliveryTask/{id}/Result/Download` — `:1374` + +#### `EngineJobController.java`(3) +- `POST /api/ssw/tdc/NaxJob` — `:51` +- `POST /api/ssw/tdc/Nax2PJob` — `:62` +- `POST /api/ssw/tdc/TeeJob` — `:73` + +#### `FileController.java`(2) +- `POST /api/ssw/tdc/File/Upload` — `:42` +- `POST /api/ssw/tdc/File/{fileId}/Discard` — `:55` + +#### `IdentityController.java`(8) +- `POST /api/ssw/tdc/Identity/{id}/RotateSecret` — `:172` +- `GET /api/ssw/tdc/Identity/Default` — `:195` +- `PUT /api/ssw/tdc/Identity/{id}/Default` — `:207` +- `PUT /api/ssw/tdc/Identity/{id}/Register` — `:231` +- `PUT /api/ssw/tdc/Identity/{id}/RegisterCallback` — `:247` +- `POST /api/ssw/tdc/Identity/AutoProvision` — `:277` +- `POST /api/ssw/tdc/Identity/Internal/Deregister` — `:321` +- `PUT /api/ssw/tdc/Identity/{id}/Heartbeat` — `:337` + +#### `NotificationController.java`(2) +- `PUT /api/ssw/tdc/Notification/{id}/Read` — `:83` +- `GET /api/ssw/tdc/Notification/UnreadCount` — `:98` + +#### `OrderController.java`(4) +- `PUT /api/ssw/tdc/Order/{id}/Reject` — `:181` +- `PUT /api/ssw/tdc/Order/{id}/ConfirmPayment` — `:196` +- `PUT /api/ssw/tdc/Order/{id}/Sign` — `:216` +- `GET /api/ssw/tdc/Order/{id}/Delivery` — `:402` + +#### `P2PChannelController.java`(6) +- `POST /api/ssw/tdc/P2P/Handshake` — `:144` +- `POST /api/ssw/tdc/P2P/Transfer/Prepare` — `:187` +- `POST /api/ssw/tdc/P2P/Transfer/{deliveryId}/Chunk` — `:209` +- `POST /api/ssw/tdc/P2P/Transfer/{deliveryId}/Receipt` — `:261` +- `POST /api/ssw/tdc/P2P/Download/{taskId}` — `:342` +- `GET /api/ssw/tdc/P2P/Status/{taskId}` — `:418` + +#### `PolicyController.java`(3) +- `POST /api/ssw/tdc/Policy/GateCheck` — `:77` +- `PUT /api/ssw/tdc/Policy/{id}/Enable` — `:172` +- `POST /api/ssw/tdc/Policy/Check` — `:194` + +#### `PolicyTemplateController.java`(1) +- `GET /api/ssw/tdc/PolicyTemplate/Options` — `:66` + +#### `PortalController.java`(2) +- `GET /api/ssw/tdc/Portal/Resources` — `:59` +- `GET /api/ssw/tdc/Portal/Resource/{id}` — `:97` + +#### `ProductController.java`(13) +- `PUT /api/ssw/tdc/Product/{id}/PublishCallback` — `:97` +- `PUT /api/ssw/tdc/Product/{id}/Audit` — `:143` +- `PUT /api/ssw/tdc/Product/{id}/AuditReject` — `:160` +- `PUT /api/ssw/tdc/Product/{id}/Enable` — `:180` +- `GET /api/ssw/tdc/Product/Catalog` — `:198` +- `PUT /api/ssw/tdc/Product/{id}/Offline` — `:215` +- `PUT /api/ssw/tdc/Product/{id}/OnShelf` — `:244` +- `PUT /api/ssw/tdc/Product/{id}/OffShelf` — `:259` +- `PUT /api/ssw/tdc/Product/{id}/PublishNewVersion` — `:282` +- `POST /api/ssw/tdc/Product/{id}/PublishToTds` — `:303` +- `PUT /api/ssw/tdc/Product/{id}/UploadCover` — `:321` +- `GET /api/ssw/tdc/Product/{id}/Cover` — `:340` +- `POST /api/ssw/tdc/Product/Internal/ForceOffline` — `:382` + +#### `ResourceController.java`(14) +- `PUT /api/ssw/tdc/Resource/{id}/MountData` — `:182` +- `GET /api/ssw/tdc/Resource/{id}/MaskRules` — `:222` +- `PUT /api/ssw/tdc/Resource/{id}/Sync` — `:243` +- `PUT /api/ssw/tdc/Resource/{id}/Classify` — `:254` +- `PUT /api/ssw/tdc/Resource/{id}/Mount` — `:300` +- `GET /api/ssw/tdc/Resource/{id}/Sample` — `:336` +- `GET /api/ssw/tdc/Resource/Sample/{productId}` — `:365` +- `PUT /api/ssw/tdc/Resource/{id}/Enable` — `:414` +- `PUT /api/ssw/tdc/Resource/{id}/Disable` — `:425` +- `GET /api/ssw/tdc/Resource/Enabled` — `:435` +- `PUT /api/ssw/tdc/Resource/{id}/MarkCipher` — `:445` +- `GET /api/ssw/tdc/Resource/Search` — `:467` +- `POST /api/ssw/tdc/Resource/{id}/Cipher/Query` — `:487` +- `GET /api/ssw/tdc/Resource/{id}/Fields` — `:532` + +#### `SandboxSessionController.java`(6) +- `POST /api/ssw/tdc/SandboxSession/Start` — `:57` +- `POST /api/ssw/tdc/SandboxSession/Open` — `:79` +- `POST /api/ssw/tdc/SandboxSession/{tdsTaskId}/Close` — `:102` +- `POST /api/ssw/tdc/SandboxSession/{tdsTaskId}/SubmitReview` — `:121` +- `GET /api/ssw/tdc/SandboxSession/{tdsTaskId}/Versions` — `:142` +- `GET /api/ssw/tdc/SandboxSession/{tdsTaskId}` — `:152` + +#### `TdcAuditLogController.java`(2) +- `POST /api/ssw/tdc/AuditLog/ReportNow` — `:134` +- `GET /api/ssw/tdc/AuditLog/Verify` — `:140` + +#### `TopologyController.java`(1) +- `GET /api/ssw/tdc/Topology/Internal/TopologyCheck` — `:50` + +#### `TradeOrderBridgeController.java`(3) +- `POST /api/ssw/tdc/TradeOrderBridge/DeliveryTask` — `:92` +- `POST /api/ssw/tdc/TradeOrderBridge/DeliveryTask/Status` — `:225` +- `POST /api/ssw/tdc/TradeOrderBridge/Contract/{contractId}/Terminated` — `:237` + +#### `UsageMetricReportController.java`(1) +- `POST /api/ssw/tdc/UsageMetric/Report` — `:31` + +### 6.4 本仓端点清单(132 条)与来源 + +| 来源文件 | 条数 | 明细 | +|---|---|---| +| `src/routes/crud.rs:31/52/64/107/120` | **110** | 18 实体 × 6 条通用 CRUD(`{path}` / `{path}/All` / `{path}/{id}` × GET·POST·PUT·DELETE)+ `Resource/{id}/Detail` + `Dataset/{id}/Detail` | +| `src/routes/tds_biz.rs:35-51` | **10** | `ServiceCatalog`(3)+ `Billing`(7) | +| `src/routes/auth.rs:11-14` | **4** | `Auth/Login` · `Auth/Me` · `Auth/Spaces` · `Auth/SsoConfig` | +| `src/routes/account.rs:36-46` | **7** | `/api/oauth/Login` + `/api/permission/Users`(列表/新建)+ `/Users/{id}`(改/删)+ `/ResetPassword` + `/State` | +| `src/routes/health.rs:10` | **1** | `GET /api/health` | +| **合计** | **132** | 其中 **124** 对得上上游,**8** 条本仓独有 | + +--- + +## 7. 对 B2(schema 追平)的影响清单 + +### 7.1 表:无需补 + +| 项 | 结论 | +|---|---| +| 本仓要补的表 | **0 张** | +| 本仓要删的表 | **0 张** | +| 本仓要改名的表 | **0 张** | + +⇒ **B2 的「表集追平」部分工作量 = 0。** +`schema/migrate.sql` 已经等于「按版本序重放上游 82 个迁移」的最终产物(30 表 / 785 列)。 +**推论**:`scripts/gen-migrate.sh` 现在跑一遍应当**得到同一份 schema**(若本机有 PG)。⇒ B2 只需加一条「重放结果与仓库内 `schema/migrate.sql` 逐字比对」的回归断言,而不是改 DDL。 + +### 7.2 列:无需补 + +| 项 | 结论 | +|---|---| +| 本仓要补的列 | **0 个** | +| 本仓要删的列 | **0 个** | +| 本仓要改类型的列 | **0 个** | +| 本仓要改可空性的列 | **0 个**(§4.2 那 5 处是 pg_dump 表示法,库级等价) | + +⇒ **B2 的「列追平」部分工作量 = 0。** + +### 7.3 B2 里真正还要做的事(不是 schema,是 §3.2 的 `base_*` 表) + +spec §3.2 提到上游 j7 的 `base_user` / `base_role` / `base_role_relation` 要入 `migrate.sql`。 +本 B0 **只核查 TDC 快照**(`/tmp/sswtdc-probe` 里没有 j7 的 DDL)⇒ **这部分不在本报告结论范围**,需单独取 j7 真源。 + +### 7.4 真正的工作量在别处(给 B3/B4 的输入) + +| 批次 | 依据(本文档) | 建议口径 | +|---|---|---| +| **B3(实体暴露面补齐)** | §5.2:10 个上游实体无独立实体 | **实体缺口清单按 10 个算**(spec 写 9,**漏了 `tdc_p2p_session` + `tdc_sandbox_exec_run` + `tdc_privacy_exec_run`**)。其中:① **7 个纯子表**(spec 清单已含)——本仓当前只聚合了 2 个(`tdc_resource_field` / `tdc_resource_mask_rule`,`src/crud.rs:967-975`),**还差 5 个**(`tdc_data_interface_field` / `tdc_data_interface_param` / `tdc_delivery_task_participant` / `tdc_delivery_outbox` / `tdc_demo_car_insurance`);② **2 个作业记录表**(spec §43 要求「照常提供 CRUD」)⇒ **新增独立实体**;③ **1 个 P2P 会话日志表** ⇒ 随 P2P 通道一起决策 | +| **B4(动作端点)** | §6.3:135 条未覆盖端点 | 缺口集中在 5 个控制器:`DeliveryTask`(23) / `Contract`(22) / `Resource`(14) / `Product`(13) / `Identity`(8) ⇒ **80 条(59.3%)**;另有 **10** 个控制器**零覆盖**(`ApiDoc` 1 / `ApiGateway` 2 / `EngineJob` 3 / `File` 2 / `P2PChannel` 6 / `Portal` 2 / `SandboxSession` 6 / `Topology` 1 / `TradeOrderBridge` 3 / `UsageMetricReport` 1 = 27 条)——这些多依赖 Nax 引擎 / scard 软 PKI,spec §43 已列为**不做**范围 | +| **写能力分档** | `src/registry.rs` 现有 `no_create`/`no_update`/`no_delete` | 本仓 18 实体已按上游口径分档(`Dataset` 全只读、`ApiConsumeLog`/`AuditLog`/`DeliveryTask`/`DestroyLog`/`DeliveryLog`/`PolicyCheckLog`/`Contract` 禁删等)⇒ **B4 新增动作端点时必须同步补 `no_*` 分档**,否则会开出上游没有的写口 | + +### 7.5 ⚠️ 给 B2 的一个**前置提醒** + +`schema/migrate.sql` 是 `include_str!` 内嵌进二进制的(`src/db.rs`),改它**必须清空 `data/` 重建**。 +但**本 B0 的结论是 schema 一条都不用改** ⇒ B2 不应产生任何 `data/` 重建动作; +B2 真正要加的是 **`base_*` 三张表**(外加 `sys_config` 种子),那部分才会触发重建。 + +--- + +## 8. 方法与可重放命令 + +### 8.1 脚本(本次产物,未进仓库,放在 `/tmp/tdc-b0/`) + +| 脚本 | 作用 | +|---|---| +| `parse_upstream.py` | 静态重放 82 个迁移 → 建过/活/已删表集 + 每表最终列形状 + `upstream.json` | +| `compare_cols.py` | 解析本仓 `schema/migrate.sql`(pg_dump 格式)→ 与上游逐列对账 → `colcmp.json` | +| `parse_ctrl.py` | 抽取上游 32 个控制器的类级 `@RequestMapping` 与方法级映射 → `controllers.json` | +| `coverage.py` | 展开 18 个控制器的继承 CRUD ⇒ 上游有效端点;与本仓 `src/routes/*.rs` 的路由表对账 → `coverage.json` | + +### 8.2 重放命令 + +```bash +# ① 上游表集(建过/活/删 + 列形状) +python3 /tmp/tdc-b0/parse_upstream.py +# ⇒ stdout: 未解析列定义: 0 +# 建过: 43 活: 30 最终已删: 13 +# ⇒ /tmp/tdc-b0/upstream.json + +# ② 与本仓 schema 逐列对账 +python3 /tmp/tdc-b0/compare_cols.py +# ⇒ stdout: 本地表: 30 上游活: 30 同名: 30 仅上游: [] 仅本地: [] +# 写 colcmp.json +# (差值在 colcmp.json 的 report 里逐表给出:缺列 0 / 多列 0 / 类型差 0 / 可空差 5) + +# ③ 上游控制器端点 +python3 /tmp/tdc-b0/parse_ctrl.py +# ⇒ stdout: 控制器数: 32 方法级端点总数: 168 +# ⇒ /tmp/tdc-b0/controllers.json + +# ④ 覆盖率对账 +python3 /tmp/tdc-b0/coverage.py +# ⇒ stdout: 本仓实体数: 18 +# 本仓端点(方法级)总数: 132 +# 上游有效端点(含继承CRUD) 265 / 本仓覆盖 124 / 未覆盖 141 +# 控制器 32,其中继承CRUD的 18 +# ⇒ /tmp/tdc-b0/coverage.json +# +# ⚠️ 脚本原样打印的 265 / 141 **含抽象模板 `TdcCrudController` 自身的 6 条** +# (无 base path,非真实端点)⇒ 本文档口径: +# 有效端点 259 = 265 - 6 +# 未覆盖 135 = 141 - 6 +# 124 + 135 = 259 ✔ +``` + +### 8.3 排序规则(与 `scripts/gen-migrate.sh` 一致) + +```bash +# 迁移排序:版本三元组 + 文件名兜底(处理 V2.10.0 版本号重复) +ls -1 /tmp/sswtdc-probe/boot/db/tdc/V*.sql /tmp/sswtdc-probe/boot/db/V*.sql | awk -F/ ' + { file=$NF; if (match(file, /^V[0-9]+\.[0-9]+\.[0-9]+__/)==0) {next} + ver=substr(file,2,RLENGTH-3); split(ver,p,".") + printf "%010d.%010d.%010d\t%s\t%s\n", p[1],p[2],p[3],file,$0 }' | sort | cut -f3- +``` + +### 8.4 关键校验(本次做过的交叉验证) + +1. **未解析列定义 = 0** ⇒ 上游 30 张活表的每一列都被解析到(否则列数会偏小)。 +2. **785 = 785** ⇒ 上游活表列数合计与本仓 `schema/migrate.sql` 相等。 +3. **表名差集双向为空** ⇒ 30/30 同名。 +4. **`ADD COLUMN IF NOT EXISTS` 幂等**已按 PG 实际语义实现 ⇒ 避免了 V1.0.4 / V1.0.5 的伪类型覆盖(否则会误报 3 处类型差异)。 +5. **DO 块 DDL 已展开** ⇒ `tdc_contract` 的 3 个死计数列被正确判为「已删」、`f_quota_anchor_at` 被正确判为「已加」。 +6. **`tdc_resource_field` 重建链**已识别 ⇒ 最终按 V2.89.0 的 7 列算,与本仓一致。 + +### 8.5 未覆盖 / 不在范围 + +- 本报告**只**比对上游 **TDC** 快照(`boot/db/` + `ssw-tdc-entity` + `ssw-tdc-controller`)。 + 上游 **j7** 的 `base_*`(`base_user` / `base_role` / `base_role_relation` / `sys_config`)不在 `/tmp/sswtdc-probe` 里 ⇒ §7.3 未核查。 +- 上游 `ssw-tdc-biz`(159 文件)、`ssw-tdc-admin`、`ssw-tdc-client` 的内部行为未逐行核对; + 本报告只做「表 / 实体 / 端点」三层对账。 +- 上游控制器里的**权限注解**(`@RequiresPermissions` 之类)与**请求/响应体字段**未逐字段比对(B4 阶段再做)。 +- 本次**未运行**任何 PG 实例(本机无 `psql`/`pg_dump`),全部结论来自静态解析 + 与本仓已有 pg_dump 产物交叉验证。