Files
tdc-rs/docs/TDC-TDS-CONTRACT.md
admin 4b32b40bd6 feat(tds): 同步 ssw-tdc 最新 internal 契约并完成真 TDS 联调验证
- 协议版本收敛为单一常量 3.2,移除联调期自创的 env 覆盖
- 按真源同步 5 项契约:Dispute 下线、Billing/List 增 side、internalCatalog 6 过滤字段、新增 ServiceCatalog/Detail、出向方法收敛
- 修正 /api/** 未命中非 GET 请求被静态兜底判成 405 的偏差,恢复 404 契约
- 新增上游用例跨进程验证脚本与 4 份联调文档;部署级凭据只从环境变量读取
- 全量测试 308 passed;132 端点契约一致;真 TDS 21 条用例 19 PASS / 1 FAIL / 1 INFO
2026-11-05 17:53:15 +08:00

25 KiB
Raw Permalink Blame History

TDC ↔ TDS 跨方契约

🔴 现状(P4 已落地):本仓有 TDS 出向通道,只走 internal 通道 (≡ 上游 TdsReportClient.internalHeaders() / internal* / *Billing)。 旧版的 /api/ssw/tdc/tds/* 代理网关已下线(请求该路径 ⇒ 404)。

本轮范围:照抄上游新版 TDC 的 ServiceCatalogController + BillingController (10 个端点),出向打到真 TDS 的 */Internal/* 与 BillingLedger/* 端点。 上游还有一条 login/ensureToken 通道(JNPF 登录换 token)⇒ 本轮不做。

上游真源(只读):

  • ssw-tdc-controller/.../ServiceCatalogController.java、.../BillingController.java
  • ssw-tdc-biz/.../client/TdsReportClient.java
  • ssw-tds-controller/.../{Catalog,TradeOrder,BillingLedger,Space}Controller.java

1. 通道:只走 internal

通道 上游入口 本仓 说明
internal TdsReportClient(X-Internal-Token + 固定头) ✅ 本轮实现 TDS white-url 放行的内部端点
login / ensureToken TdsReportClient.ensureToken(JNPF 登录换 token) ❌ 不做 本轮不需要
Bridge/** 旧 HttpTdcTdsClient 代理(App-Code: tdc) ❌ 已下线 旧代理随 Task 10 撤除 ⇒ 404

为什么 internal:App-Code: sswflow(internal 通道的值)≠ App-Code: tdc(Bridge 通道的值)。 上游新版 TDC 的服务目录 / 账单两页走的是 internal 通道 ⇒ 本仓照抄。


2. 出向请求头(正好 6 个,逐字照抄上游 internalHeaders())

头 值 说明
Content-Type application/json
App-Code sswflow 🔴 不是 tdc(那是 Bridge 通道)
Jnpf-Origin pc
Vue-Version 3
X-Internal-Token SSW_TDS_INTERNAL_TOKEN 有默认值(本地单机模式不出向时无所谓)
X-Protocol-Version 1.0 与上游 InternalTokenSupport.PROTOCOL_VERSION 一致
  • 🔴 绝不带 Authorization / Cookie ⇒ 本地会话令牌不外泄。
  • 🔴 超时照抄上游 restTemplate():连接 3s / 读取 5s(快速失败,别拖垮本地业务)。
  • 🔴 reqwest 客户端必须 .no_proxy() ⇒ 本机 HTTP_PROXY / 系统代理会把 loopback 的 TDS 劫持成 502。

3. 本仓对外 10 个端点 → 出向 TDS 端点

路径与 HTTP 方法逐字对齐上游前端(上游 SPA 的 W = "/api/ssw/tdc", static/assets/tdc-*.js 里 serviceCatalog / billing 两个 api 对象就是这 10 个调用)。

本仓端点 方法 出向 TDS 路径 方法 体 返回形状
/api/ssw/tdc/ServiceCatalog GET /api/ssw/tds/Catalog/Internal/Catalog POST {spaceId, keyword} 解包型 ⇒ data({list,total})
/api/ssw/tdc/ServiceCatalog/Buy POST /api/ssw/tds/TradeOrder/Internal/Apply POST 透传(补 buyerConnectorId) 解包型 ⇒ data
/api/ssw/tdc/ServiceCatalog/BuyBatch POST /api/ssw/tds/TradeOrder/Internal/ApplyBatch POST 透传(补 buyerConnectorId) 解包型 ⇒ data
/api/ssw/tdc/Billing/List GET /api/ssw/tds/BillingLedger/Internal/List POST {connectorId[, keyword]} 整包型 ⇒ data
/api/ssw/tdc/Billing/{id}/Dispute PUT /api/ssw/tds/BillingLedger/{id}/Dispute PUT {} 整包型 ⇒ msg + 账本 id
/api/ssw/tdc/Billing/{id}/Confirm PUT /api/ssw/tds/BillingLedger/{id}/Confirm?connectorId= PUT {} 整包型 ⇒ msg + 账本 id
/api/ssw/tdc/Billing/{id}/Settle PUT /api/ssw/tds/BillingLedger/{id}/Settle?connectorId= PUT {} 整包型 ⇒ msg + 账本 id
/api/ssw/tdc/Billing/{id}/Receipt PUT /api/ssw/tds/BillingLedger/{id}/Receipt POST {receiptNo, remark}(只挑这两个键) 整包型 ⇒ msg + 账本 id
/api/ssw/tdc/Billing/{id}/Voucher GET /api/ssw/tds/BillingLedger/{id}/Voucher GET — 整包型 ⇒ data(须是对象)
/api/ssw/tdc/Billing/LocalCompare?contractId= GET 不出向 — — 本地表 tdc_api_consume_log
  • 🔴 对外 PUT / 出向 POST(Receipt):上游 TDC 控制器对外是 PUT,TDS 侧是 POST ⇒ 两边都要对。
  • 🔴 出向 URL 只由固定路径模板拼出:路径段(账本 id)过白名单 (ASCII 字母/数字/下划线/短横线,1..=64)⇒ 用户输入绝不直接进 URL 路径。
  • 🔴 connectorId 走查询串(不是头)⇒ 必须 URL 编码。

3.1 两种返回风格(照抄上游,别混)

风格 上游方法 语义
解包型 internalCatalog / internalApply / internalApplyBatch code==200 ⇒ 取 data;否则 Err(msg)
整包型 listBillingForConnector / dispute / confirm / settle / receipt / voucher 原样返回 {code,msg,data},由上层判 code

⚠️ 整包型的成功里 data 是字符串(账本 id),不是对象 —— 写测试/解析时别想当然。

3.2 身份解析:两套口径(照抄上游)

端点 口径 规则
Billing/List / Dispute / Receipt / Voucher / LocalCompare 宽松(上游 resolveConnectorId) 显式 connectorId 优先;为空取本端固定身份
Billing/{id}/Confirm / Settle 严格(上游 resolveOwnConnectorIdStrict) 只认本端身份;显式 id 与本端不一致 ⇒ 拒
  • 本端固定身份 = tdc_identity 里 f_default_mark 优先的那一行 (f_tds_space_id ⇒ 空间;f_tds_connector_id ⇒ 连接器)。
  • 越权自检(上游 ownsLedger):动作类端点先 BillingLedger/Internal/List(不带 keyword), 在 data.list 里找 id 匹配 ⇒ 不匹配 ⇒ 拒。任何异常 ⇒ false(fail-closed)。 ⚠️ 这条自检本身会发一次出向请求(List)—— 断言「越权时不出向」时只能断言 动作端点没被调用,不能断言「一条出向都没有」。

4. 降级语义(三档,都不许变成 HTTP 500 / panic)

情形 表现 文案来源
NOOP(未配 SSW_TDS_BASE_URL) 本地单机模式,不发任何网络请求 「未配置 TDS 地址(本地单机模式)」
不可达(超时 / 网络错 / 响应不是 JSON) 业务失败(HTTP 200 + code:400) 上游原话「TDS …不可达」
TDS 业务失败(HTTP 200 但 code != 200) 业务失败(HTTP 200 + code:400) TDS 的 msg 原文
  • 🔴 TDS 业务错误走 HTTP 200 ⇒ 判定成败必须看 body 的 code(只看 HTTP 状态会把失败误判成成功)。
  • 🔴 本仓对外也是 HTTP 200 + {code,msg,data}(业务失败 = code:400,data:null)。

5. 已登记的刻意分歧(照抄上游时故意不同的地方)

# 分歧 上游 本仓 理由
D1 宽松身份口径 既有端点(List/Dispute/Receipt/Voucher/LocalCompare)就是宽松的 照抄(未加固) 用户明确「照抄上游,不创新」
D2 异常包装 抛异常 Result<T, String> Rust 侧表达;语义逐条对齐
D3 msg 缺失时的文案 String.valueOf(res.get("msg")) ⇒ 字面量 "null" 空串兜底 上游那个 "null" 是 bug,前端会显示一个 "null"
D4 数字型 connectorId 硬转 (String) ⇒ ClassCastException(500) 宽松取文本,不 500 上游自己注了这一点(2026-09-19 审查 P2-7)
D5 空请求体 上游 @RequestBody 必填 ⇒ 报错 动作类端点接受空体(当空对象) 上游这几个端点体可空;ServiceCatalog/Buy 也是空体当空对象
D6 分页 上游 standalone 分支不翻页 currentPage/pageSize 忽略 上游 internalCatalog 无分页参数
D7 Content-Type 校验 上游 415 本仓不校验 ⇒ 报「请求体格式有误」 与本仓其它端点一致(JsonBody 口径)

6. 实测记录(真 TDS,2026-10-25)

环境:TDS = http://127.0.0.1:30041(库 tds2,java PID 56575,不重启); 本仓连接器 = :30410(SSW_TDS_BASE_URL=http://127.0.0.1:30041)。 身份绑定:空间 PORTAL-DEMO-SPACE(门户演示空间)。

6.1 本仓 10 个端点(对外形状)

# 调用 本仓返回
1 GET /api/ssw/tdc/ServiceCatalog?keyword= {"code":200,"msg":null,"data":{"list":[],"total":0}}
2 POST /api/ssw/tdc/ServiceCatalog/Buy 体 {"productId":"P-1"} {"code":400,"msg":"数据产品不存在: null","data":null}
3 POST /api/ssw/tdc/ServiceCatalog/BuyBatch 体 {"productIds":["P-1","P-2"]} {"code":400,"msg":"业务用途必填(平台运营据此审核)","data":null}
4 GET /api/ssw/tdc/Billing/List {"code":200,"msg":null,"data":{"list":[]}}
5 PUT /api/ssw/tdc/Billing/{不存在的id}/Dispute {"code":400,"msg":"非本方账单,无权发起异议","data":null}
6 PUT /api/ssw/tdc/Billing/{不存在的id}/Confirm {"code":400,"msg":"非本方账单,无权确认","data":null}
7 PUT /api/ssw/tdc/Billing/{不存在的id}/Settle {"code":400,"msg":"非本方账单,无权结算","data":null}
8 PUT /api/ssw/tdc/Billing/{不存在的id}/Receipt {"code":400,"msg":"非本方账单,无权上传结算回执","data":null}
9 GET /api/ssw/tdc/Billing/{不存在的id}/Voucher {"code":400,"msg":"非本方账单,无权下载对账凭证","data":null}
10 GET /api/ssw/tdc/Billing/LocalCompare?contractId=C-1 {"code":200,"msg":null,"data":{"contractId":"C-1","local":[]}}

全部 HTTP 200(业务失败也是 200)⇒ 判成败必须读 body 的 code。 5–9 是本仓的越权闸门先拒的(ownsLedger 查不到该账本)⇒ 动作请求根本没发出去。

6.2 TDS 侧原始返回(直打 TDS,绕开本仓闸门)

# TDS 调用 TDS 原始返回
T1 GET /api/ssw/tds/Space/Internal/List {"code":200,"msg":"Success","data":[{"id":"PORTAL-DEMO-SPACE",…,"name":"门户演示空间",…}]}
T2 POST /api/ssw/tds/Catalog/Internal/Catalog 体 {"spaceId":"PORTAL-DEMO-SPACE","keyword":null} {"code":200,"msg":"Success","data":{"list":[],"total":0}}
T3 POST /api/ssw/tds/TradeOrder/Internal/Apply 体 {} {"code":400,"msg":"数据产品不存在: null"}
T4 POST /api/ssw/tds/TradeOrder/Internal/ApplyBatch 体 {} {"code":400,"msg":"多方批次下单需至少勾选 2 个提供方资源(单标请走 /Internal/Apply)"}
T5 POST /api/ssw/tds/BillingLedger/Internal/List 体 {"connectorId":"854250096668180741"} {"code":200,"msg":"Success","data":{"list":[]}}
T6 PUT /api/ssw/tds/BillingLedger/{不存在的id}/Dispute {"code":400,"msg":"台账不存在"}
T7 PUT /api/ssw/tds/BillingLedger/{不存在的id}/Confirm?connectorId=… {"code":400,"msg":"台账不存在"}
T8 PUT /api/ssw/tds/BillingLedger/{不存在的id}/Settle?connectorId=… {"code":400,"msg":"台账不存在"}
T9 POST /api/ssw/tds/BillingLedger/{不存在的id}/Receipt {"code":400,"msg":"台账不存在"}
T10 GET /api/ssw/tds/BillingLedger/{不存在的id}/Voucher {"code":400,"msg":"台账不存在"}
T11 GET /api/ssw/tds/Space/Internal/List(不带令牌,对照组) {"code":400,"msg":"缺少有效凭证(需登录或内部凭证)"}
  • T11 说明 X-Internal-Token 真的生效(缺了就 400)。
  • ⚠️ 调试 TDS 里没有本连接器的账本行 ⇒ 5 个动作端点的成功路径无法对着真 TDS 走通 (TDS 侧只会回「台账不存在」)。成功路径由 tests/tds_biz.rs 的假 TDS 覆盖。
  • T3/T4 的拒因逐字来自 TDS(数据产品不存在: null 里的 null 是 TDS 自己拼的, 本仓原样透传,没替它美化)。

6.3 浏览器级验收(上游控制台两个 TDS 页)

页面 页面发出的后端调用 结果
/tdc/service-catalog GET /api/ssw/tdc/ServiceCatalog?currentPage=1&pageSize=20 ✅ 200(R3 时代是 404),页面渲染出表格壳
/tdc/billing GET /api/ssw/tdc/Billing/List?currentPage=1&pageSize=10 ✅ 200(R3 时代是 404),页面渲染出账期/产品/合约编号/… 列

两页都是「No data」—— 演示 TDS 里没有产品 / 账本 ⇒ 不是本仓的锅。


7. 旧 Bridge 通道(历史,已下线)

留档以便追溯,本仓不再实现。

文件 作用
TdcTdsClient.java 抽象接口
HttpTdcTdsClient.java HTTP 实现(配 ssw.tds.base-url 时生效)
NoopTdcTdsClient.java 降级实现(未配 base-url)
TdcTdsClientConfig.java 装配(base-url / internal-token 注入)

旧契约清单(全部 404):

GET  /api/ssw/tds/Bridge/Contract/{id}    -> 合约概览 Map
GET  /api/ssw/tds/Bridge/Connector/{id}   -> 连接器概览 Map
GET  /api/ssw/tds/Bridge/DataProduct/{id} -> 数据产品概览 Map
POST /api/ssw/tds/Bridge/AuditChain       body: {bizIds:[..]} -> 审计哈希链 Map
POST /api/ssw/tds/Bridge/ChainEvidence    body: {bizIds:[..]} -> 链上存证 Map
POST /api/ssw/tds/Bridge/AuditRecord      body: {bizIds:[..]} -> 审计记录 Map
POST /api/ssw/tds/Bridge/AuditTrail       body: 留痕 JSON      -> void

旧代理时代的实测(2026-10-23,已失效,仅供追溯):

调用 结果
Bridge/Contract/855041382379688261 contractCode: CT-CRT-yxkcm,状态 01
Bridge/Connector/854250096668180741 「TEE 连接器_05496131」,orgName: 吉利汽车,ONLINE
Bridge/DataProduct/855039616187633989 「测评目录产品-iws2k」,DRAFT

旧代理的「失败即降级、绝不拖垮本地 TDC 业务」原则已被 internal 通道继承 (见 §4 三档降级)。

6.4 契约 stub 联调实测(2026-11-05,跨进程真 HTTP 对端)

背景:真 TDS(ssw/trusted-space/ssw-tds)在本机无法独立启动(RocketMQ name-server 192.168.10.6:30094、MinIO 192.168.0.207:9000 均不可达)。改用契约忠实 TDS stub (tds-stub/server-internal.js,零依赖 Node,监听 127.0.0.1:30100)做跨进程联调: stub 逐请求打印「方法/路径/查询串/六固定头/体长度」,可直接核对 tdc-rs 出向是否逐字照抄 上游 internalHeaders()。证据见 tds-stub/integration-evidence.log。

环境:tdc-rs :30410(SSW_TDS_BASE_URL=http://127.0.0.1:30100、SSW_TDS_INTERNAL_TOKEN=ssw-internal-token-e2e); 本端身份 LOCAL-CONNECTOR(f_tds_space_id=PORTAL-DEMO-SPACE、f_tds_connector_id=854250096668180741, 经 PUT /api/ssw/tdc/Identity/{id} 写入,使越权自检可过)。

出向契约核对(10 端点全部对齐):

本仓端点 出向 TDS 实测出向(stub 日志) 结果
ServiceCatalog GET Catalog/Internal/Catalog (POST) POST /api/ssw/tds/Catalog/Internal/Catalog bodyLen=46 ✅ 解包型 data→{list,total}
ServiceCatalog/Buy POST TradeOrder/Internal/Apply (POST) POST /api/ssw/tds/TradeOrder/Internal/Apply ✅
ServiceCatalog/BuyBatch POST TradeOrder/Internal/ApplyBatch (POST) POST /api/ssw/tds/TradeOrder/Internal/ApplyBatch ✅
Billing/List GET BillingLedger/Internal/List (POST) POST /api/ssw/tds/BillingLedger/Internal/List ✅ 整包型 data 原样返回
Billing/{id}/Dispute PUT BillingLedger/{id}/Dispute (PUT) 先 List(自检) 再 PUT .../Dispute ✅
Billing/{id}/Confirm PUT …/Confirm?connectorId= (PUT) PUT .../Confirm?connectorId=854250096668180741 ✅ 查串非头
Billing/{id}/Settle PUT …/Settle?connectorId= (PUT) PUT .../Settle?connectorId=854250096668180741 ✅
Billing/{id}/Receipt PUT …/Receipt (POST) 对外 PUT、出向 POST .../Receipt bodyLen=31 ✅ 分歧 D-对外PUT/出向POST 对齐
Billing/{id}/Voucher GET …/Voucher (GET) GET .../Voucher ✅
Billing/LocalCompare GET 不出向 日志无新增 ✅ 本地表

所有出向均带 6 固定头(app-code=sswflow/jnpf-origin=pc/vue-version=3/x-protocol-version=1.0/ X-Internal-Token(stub 校验通过)/Content-Type:application/json)⇒ 与 §2 逐字一致。

越权自检(fail-closed):Billing/{id}/Dispute|Confirm|Settle|Receipt|Voucher 对非本方账本 (如 NOPE-LEDGER)→ 「非本方账单,无权…」;stub 日志仅见 BillingLedger/Internal/List (owns_ledger 自检),动作请求未发出 ⇒ 与 §3.2 一致。

三档降级(均 HTTP 200 + code:400,绝不 500/panic):

档 触发 本仓返回
NOOP 未配 SSW_TDS_BASE_URL(启动日志 TDS mode: NOOP) {"code":400,"msg":"未配置 TDS 地址(本地单机模式)"},无出向
不可达 SSW_TDS_BASE_URL 指向死端口 30199 {"code":400,"msg":"TDS 账单查询不可达"},无出向
业务失败 TDS 回 HTTP 200 + code≠200 透传 TDS msg(如 {"code":400,"msg":"多方批次下单需至少勾选 2 个提供方资源…"})

结论:tdc-rs P4 出向通道与真 TDS(ssw/trusted-space/ssw-tds 控制器逐字确认)契约完全对齐, 无分歧;6 固定头、token、解包/整包、越权自检、三档降级均符合 docs/TDC-TDS-CONTRACT.md 与上游代码。


§6.5 真实测试 TDS 部署联调(192.168.1.50:33000)

对端:运营平台(TDS) http://192.168.1.50:33000/(门户账号由部署方提供,标题「尚数网可信数据空间」)。 非 stub,是真部署,用来做真·跨进程联调。

发现 1:协议版本错位(🔴 阻塞,已修)

  • 真 TDS 实际为协议 3.2(ssw-tds/.../InternalTokenSupport.PROTOCOL_VERSION = "3.2")。
  • 版本闸门语义(与上游逐字一致):主版本必须相等,次版本向后兼容;未声明⇒放行+WARN;声明了但不兼容⇒fail-closed 401。
  • tdc-rs 此前硬编码 X-Protocol-Version: "1.0"(platform/protocol.rs 常量)⇒ 对真 TDS 直接 401: {"code":401,"msg":"跨端协议版本不兼容(对端 1.0,本端 3.2),请升级对端"}。
  • 根因:tdc-rs(ssw-tdc 的 Rust 重实现)落后两个主版本未同步;上游 Java ssw-tdc 应同为 3.2。

修复(严格 1:1 对齐 ssw-tdc):将 platform/protocol.rs 的单一常量 PROTOCOL_VERSION 升到 "3.2", 其同时驱动入向闸门与出向 X-Protocol-Version 头(≡ 上游 InternalTokenSupport.PROTOCOL_VERSION 一处定义两处复用)。 移除原联调期临时加的 SSW_TDS_PROTOCOL_VERSION 环境变量与 tds_protocol_version 字段——ssw-tdc 真源无此 env, tdc-rs 不引入自创逻辑。改动:platform/protocol.rs(PROTOCOL_VERSION="3.2")、tdc/client/tds.rs (internal_headers 直接引用该常量、删 protocol_version 字段与构造参数)、tdc/state.rs、platform/config.rs(删字段/env)、测试同步。 验证:以该常量启动后,真 TDS 版本闸门放行,回 {"code":400,"msg":"缺少有效内部凭证"}(token 错,证明版本已对上)。

发现 2:内部令牌为部署私有值(✅ 已由部署方提供,联调跑通)

  • 令牌校验:InternalTokenSupport.isInternal(req, internalToken) 逐字比对 X-Internal-Token 与 配置的 internal-token(默认 ssw-internal-token-e2e,来源 SSW_INTERNAL_TOKEN 环境变量)。
  • 真 TDS 用非默认令牌:默认 ssw-internal-token-e2e 及十余个常见测试值全部回 缺少有效内部凭证;仓库 application.yml、部署目录均无明文 ⇒ 部署方设定的私有值。
  • 部署方已提供该值,写入 SSW_TDS_INTERNAL_TOKEN 后所有 internal 端点放行。

联调结果(2026-11-05;真源钉在 ssw-tdc 3d247df)

健康检查:{"protocolVersion":"3.2","tdsMode":"HTTP","tdsBaseUrl":"http://192.168.1.50:33000"}。

端点 真 TDS 结果
GET /ServiceCatalog code:200,701 个真实产品
POST /ServiceCatalog/Buy 见发现 3;修正字段后 code:200,订单 DD202611050011
POST /ServiceCatalog/BuyBatch productIds 被识别,回业务校验「需至少勾选 2 个提供方资源」
GET /Billing/List code:200(部署侧列表为空)
GET /Billing/LocalCompare?contractId=... code:200,{contractId, local:[]}
GET /Billing/{id}/Voucher(真实账本) code:200,完整 {ledger, metrics}
5 个账本动作 ownsLedger 自检 非本方账本全部 fail-closed 拒绝,拒因文案各自正确
出向 6 固定头 + X-Protocol-Version: 3.2 全部放行(与 3d247df TdsReportClient.internalHeaders():2569 逐字一致)

发现 3:Buy 字段名漂移(🔴 两仓契约问题,已交 ssw-tdc 项目组)

目录返回的产品没有 usageId 字段(只有 id 主键 / productId 业务编码);ssw-tdc standalone Buy 原样透传 body;ssw-tds TradeOrderServiceImpl.buy 只取 usageId 且 getById 按主键查。 实测 productId / id 任一值 ⇒ 数据产品不存在: null;只有 {"usageId":"<产品主键>","buyerConnectorId":"<已注册连接器>"} 才能下单成功。 详见 docs/SSW-TDC-TDS-INTEGRATION-FINDINGS.md(含完整字段组合实测表与修复建议)。

发现 4:真源版本差距(tdc-rs 已同步闭环)

钉住 3d247df 后发现 tdc-rs 曾保留已下线的 /Billing/{id}/Dispute、缺 side 参数、 internalCatalog 过滤字段不全;现已逐项按真源同步,并从建仓基线 c568cc7 回溯到 最新 main 2d331e9 核对契约层。详见 docs/TDC-RS-ALIGNMENT-GAP.md。

复跑命令

# 启动(协议版本由 platform/protocol.rs 单一常量 3.2 驱动,无 env 覆盖)
PORT=30410 TDC_DATA_DIR=<project>/data \
  SSW_INTERNAL_TOKEN=ssw-internal-token-e2e \
  SSW_TDS_BASE_URL=http://192.168.1.50:33000 \
  SSW_TDS_INTERNAL_TOKEN=<部署方令牌> \
  ./target/debug/tdc-connector

# 调用:本机 HTTP_PROXY 会劫持 loopback/内网 ⇒ 一律 --noproxy '*'
curl -s --noproxy '*' -H 'X-Internal-Token: ssw-internal-token-e2e' \
  -H 'X-Protocol-Version: 3.2' http://127.0.0.1:30410/api/ssw/tdc/ServiceCatalog

上游更新同步后的复验(2026-11-05 17:00)

按用户要求回溯 tdc-rs 建仓基线 c568cc7(2026-10-23,PROTOCOL_VERSION=1.0)→ ssw-tdc 最新 main 2d331e9(15:55),共 188 提交 / 472 文件;协议版本期间连升 7 次到 3.2。 3d247df..2d331e9 的 8 个提交只动沙箱/前端,契约层与 .50 部署版本等价。 已严格照抄同步 5 项契约变更(详见 docs/TDC-RS-ALIGNMENT-GAP.md): Dispute 下线、side、internalCatalog 6 过滤字段、新增 catalogDetail + /Detail/{productCode}、协议 3.2。

复验矩阵(服务 127.0.0.1:30410,health = protocolVersion:3.2 / tdsMode:HTTP):

请求 真 TDS 结果 说明
GET /ServiceCatalog 200,701 条 通道正常
GET /ServiceCatalog?keyword=E2E-DNP-b3r3b-a7ty 200,1 条 新增过滤字段真实生效
?keyword=NOT-EXIST-XYZ / 6 参数组合 0 条 / {"list":[],"total":0} 对端确实按字段过滤
GET /ServiceCatalog/Detail/E2E-DNP-b3r3b-a7ty 200 完整详情 新增端点打通
Detail/887690246907504709(主键) 400 产品不存在或不在本空间目录 TDS 按 productCode 查
Detail/...?spaceId=BOGUS 200 正确详情 spaceId 只取本端身份,不信任入参
Detail/%2e%2e 400 产品编码非法: .. 路径段白名单生效
GET /Billing/List?side=PROVIDER 200 真实账本 side 生效
?side=CONSUMER / ?side=BOGUS 空 / 400 side 只接受 PROVIDER / CONSUMER 对端校验该字段
PUT /Billing/FAKE/Dispute 404 接口不存在(17:35 修复 405 偏差后) 已下线(不再是业务端点)
POST /Buy {"productId":...} 400 数据产品不存在: null 两仓漂移仍在(见发现 3)
POST /Buy {"usageId":"<主键>","buyerConnectorId":"<已注册>"} 200 生成订单 链路通
POST /BuyBatch 400 需至少勾选 2 个提供方资源 业务校验正常
GET /Billing/{真实账本}/Voucher 200 {ledger, metrics} 只读出向正常
PUT /Billing/FAKE/Confirm 400 无法确定连接器身份… 严格口径 + 本地身份未注册

本地验证(17:35 复跑):cargo test 全量 308 passed / 0 failed / 1 ignored; check-contract.sh 132 条端点 ↔ 实际注册路由完全一致(删 Dispute −1 / 加 Detail +1,总数不变)。

上游用例跨进程验证(17:35):python3 scripts/verify-upstream-cases.py --with-write ⇒ 21 条,19 PASS / 1 FAIL / 1 INFO。唯一 FAIL 是上游 contacter ↔ buyerContact 字段漂移(tdc-rs 按真源透传,不自创映射);U05「下线端点 ⇒ 404」已由 405 修为 404 并转 PASS。 详见 docs/UPSTREAM-CASES-VERIFICATION.md。