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
This commit is contained in:
1 parent
400d883e1a
commit
4b32b40bd6
20 files changed
+1853
-96
No files matched your search
@@ -0,0 +1,278 @@
|
||||
# ssw-tdc ↔ ssw-tds 跨进程联调:问题清单与优化建议
|
||||
|
||||
> **收件方**:ssw-tdc 项目组(用于优化 internal 契约)
|
||||
> **联调方**:tdc-rs(ssw-tdc 的 Rust 1:1 实现)
|
||||
> **真源基准(本次钉住)**:ssw-tdc commit `3d247df4a0b48b85bb4532bccd4b39dc818e5a08`
|
||||
> (2026-11-05 14:13:04 +0800,`feat(运行策略): D06 执行面接入 —— 静态判据改用平台合并策略并 fail-closed(B5)`)
|
||||
> —— 即测试 TDS 部署 `192.168.1.50:33000` 所对应的连接器版本。
|
||||
> **对端真源**:`http://192.168.1.2:8080/ssw/trusted-space/ssw-tds`
|
||||
> **真实联调对端**:`http://192.168.1.50:33000/`(门户账号由部署方提供,标题「尚数网可信数据空间」)
|
||||
> **执行时间**:2026-11-05;tdc-rs 以 `PROTOCOL_VERSION=3.2` + 部署方 internal token 直连,非 stub。
|
||||
|
||||
---
|
||||
|
||||
## 0. 结论速览
|
||||
|
||||
- **通道已打通**:协议 `3.2` + 真 internal token 后,tdc-rs 的 10 个出向端点在真 TDS 上
|
||||
路径 / 方法 / 6 个固定头与 `3d247df` 的 `TdsReportClient` **逐字一致**;目录查询、批量下单、
|
||||
账单列表、本地比对、对账凭证、越权自检全部按预期工作;并成功完成一单真实下单
|
||||
(订单号 `DD202611050011`)。
|
||||
- **2 个阻塞性契约漂移(同一根因)**:Buy `productId` ↔ `usageId`(§1)、internal 联系人
|
||||
`contacter` ↔ `buyerContact`(§5ter 发现 5)。前者让 standalone 购买在真 TDS 上必然失败,
|
||||
后者让「联系人不得超过 10 字符」校验在连接器链路上被静默绕过。根因都是
|
||||
**实体对外 JSON 名与 internal `Map` 键名没有统一映射**。
|
||||
- **治理建议**:协议版本跨仓自动校验(§2)、internal 字段白名单契约测试(§5)、
|
||||
Dispute 下线后两仓残留收敛(§3.1)、3 处上游用例口径收敛(§5ter 发现 6/7)。
|
||||
- **tdc-rs 侧严格按真源逐字实现,未做任何字段改名/映射**;跨进程 21 条上游用例
|
||||
**19 PASS / 1 FAIL(即上述 `contacter` 漂移)/ 1 INFO**,见 `UPSTREAM-CASES-VERIFICATION.md`。
|
||||
|
||||
---
|
||||
|
||||
## 1. 🔴 严重:Buy 字段名漂移(productId ↔ usageId)
|
||||
|
||||
### 1.1 实测结果(真 TDS,经 tdc-rs `/ServiceCatalog/Buy`,行为逐字对齐 `3d247df`)
|
||||
|
||||
目录返回 701 个 E2E 产品,取其中一个:`id=887690246907504709`(数据产品**主键**)、
|
||||
`productId=E2E-DNP-b3r3b-a7ty`(**业务编码**)。用不同请求体下单:
|
||||
|
||||
| 请求体 | 真 TDS 返回 |
|
||||
|---|---|
|
||||
| `{"productId":"887690246907504709"}`(主键值) | `数据产品不存在: null` |
|
||||
| `{"productId":"E2E-DNP-b3r3b-a7ty"}`(业务编码) | `数据产品不存在: null` |
|
||||
| `{"id":"887690246907504709"}` | `数据产品不存在: null` |
|
||||
| `{"usageId":"E2E-DNP-b3r3b-a7ty"}`(业务编码) | `数据产品不存在: E2E-DNP-b3r3b-a7ty` |
|
||||
| `{"usageId":"887690246907504709"}`(主键值) | `买方连接器不存在` ← **产品校验已通过** |
|
||||
| `{"usageId":"887690246907504709","buyerConnectorId":"878443108591731461"}` | **`code:200`,下单成功**,订单 `DD202611050011` |
|
||||
|
||||
> 最后一行证明:链路本身完全正常,唯一阻塞就是字段名/取值口径。
|
||||
|
||||
### 1.2 三个确凿事实
|
||||
|
||||
1. **目录返回的产品对象里没有 `usageId` 字段**。
|
||||
`POST /api/ssw/tds/Catalog/Internal/Catalog` 的每项只有 `id`(主键)与 `productId`(业务编码),
|
||||
全字段清单中不含 `usageId`。连接器前端从目录拿到产品后,无法直接得到 TDS 下单所需的字段。
|
||||
2. **ssw-tdc standalone Buy 原样透传 body**。
|
||||
`3d247df` 的 `ServiceCatalogController.java:150-186` 仅在 `buyerConnectorId` 缺省时补一次,
|
||||
然后 `tdsReportClient.internalApply(body)`;`TdsReportClient.java:1860-1864` 直接
|
||||
`postForEntity("/api/ssw/tds/TradeOrder/Internal/Apply", new HttpEntity<>(body, ...))`,**不做字段改名**。
|
||||
3. **ssw-tds 只认 `usageId`,且按主键查**。
|
||||
`TradeOrderServiceImpl.buy:155` → `order.setUsageId(str(body.get("usageId")))`;
|
||||
`:209-211` → `dataProductService.getById(order.getUsageId())`,取不到即抛
|
||||
`数据产品不存在: <usageId>`。`getById` 是按**主键**查,所以传业务编码同样查不到。
|
||||
|
||||
⇒ 不只是「字段改名」,还叠加了**取值口径不一致**:目录给 `id` / `productId` 两种标识,
|
||||
TDS 要求把**主键 id** 装进 `usageId`。仅把 `productId` 的值改个键名塞进 `usageId` 仍然失败。
|
||||
|
||||
### 1.3 佐证:usageId 是 TDS 侧订单的产品标识字段
|
||||
|
||||
- ssw-tds 订单实体与下游(建约 / 建任务)多处用 `order.getUsageId()` 定位产品。
|
||||
- ssw-tdc 接收 TDS 回传订单时也读 `usageId`:`ContractController.java:526`
|
||||
`String productId = strOf(order, "usageId");`。
|
||||
- 本次成功下单返回的订单对象里 `productId` 仍是业务编码 `E2E-DNP-b3r3b-a7ty`,
|
||||
而请求用的是主键 `887690246907504709` —— 再次说明两个字段语义不同,不是同一值的别名。
|
||||
|
||||
### 1.4 影响
|
||||
|
||||
- 连接器(standalone)购买路径在真实 ssw-tds 上**必然失败**。
|
||||
- 属两仓 internal 契约漂移,**非 tdc-rs 实现问题**:tdc-rs 逐字对齐 `3d247df`(同样透传
|
||||
`productId`),因此同样复现——这正是用第三方实现把问题暴露出来的价值。
|
||||
|
||||
### 1.5 建议(请 ssw-tdc 项目组裁定)
|
||||
|
||||
- **方案 A(推荐,ssw-tdc 单点修复,不动 TDS)**:在 `ServiceCatalogController.buy` 入口把前端
|
||||
传来的产品标识**规范化**为 `usageId` = 数据产品**主键 id**(即目录返回项的 `id`),再透传;
|
||||
`BuyBatch` 的 `productIds` 同理按主键数组。连接器前端语义不变。
|
||||
> ⚠️ 不能简单地把 `productId` 的值改个键名塞进 `usageId`:实测「业务编码」会被 TDS
|
||||
> `getById` 判为不存在。必须取主键。
|
||||
- **方案 B(两仓统一)**:ssw-tds 改读 `productId`,并明确按主键还是业务编码查;两仓同步补契约测试。
|
||||
- **附加建议(治本)**:在 `Catalog/Internal/Catalog` 返回项里**显式给出 `usageId`(= 主键)**,
|
||||
或在 internal 契约文档写明「下单标识 = 目录项 `id`」,避免连接器侧靠猜。
|
||||
|
||||
---
|
||||
|
||||
## 2. 🟡 协议版本治理(X-Protocol-Version)
|
||||
|
||||
### 2.1 现状与本次验证
|
||||
|
||||
- `3d247df` 的 `boot/ssw-common/.../security/InternalTokenSupport.java:42`
|
||||
`PROTOCOL_VERSION = "3.2"`;ssw-tds 同文件亦 `"3.2"`——**两仓当前一致**。
|
||||
- `3d247df` 的 `TdsReportClient.internalHeaders():2569` 6 个头逐字为
|
||||
`Content-Type / App-Code=sswflow / Jnpf-Origin=pc / Vue-Version=3 / X-Internal-Token / X-Protocol-Version=3.2`,
|
||||
与 tdc-rs `internal_headers()` **完全一致**(本次真 TDS 联调全部端点通过,佐证无误)。
|
||||
- 版本闸门语义:主版本必须相等、次版本向后兼容;未声明放行+WARN;声明但不兼容 ⇒ fail-closed 401。
|
||||
- **实测**:tdc-rs 初版 `1.0` 被真 TDS 直接 `401 跨端协议版本不兼容(对端 1.0,本端 3.2)`;
|
||||
对齐 `3.2` 后全部端点放行。历史上该值演进 `2.0 → 2.1 → 2.2 → 2.3 → 3.2`。
|
||||
|
||||
### 2.2 风险与建议
|
||||
|
||||
- 两仓各自硬编码**同一字面量、无自动校验**;任一侧升级而另一侧滞后 ⇒ internal 通道静默 401,
|
||||
错误只表现为「调用被拒」,不指向版本,排错困难。
|
||||
- 建议:把 `PROTOCOL_VERSION` 纳入**联调门禁 / CI 跨仓比对**,断言两仓相等;升级时同步 bump
|
||||
并在 changelog 标注,避免单侧先行。
|
||||
|
||||
---
|
||||
|
||||
## 3. 🟢 其他联调观察
|
||||
|
||||
### 3.1 Dispute(异议)链路已下线,建议两仓收敛残留
|
||||
|
||||
三条独立证据一致:
|
||||
|
||||
1. `3d247df` 的 `BillingController.java:34` 明确注释:**批4b(chg_0022 乙案):`/Dispute`
|
||||
异议链路已下线**(平台不再提供异议/修正能力,2026-10-29 定稿);实际 `@*Mapping` 路由中
|
||||
也已无 `/{id}/Dispute`。
|
||||
2. `3d247df` 的 `TdsReportClient` **没有 `disputeBilling` 方法**(仅 `confirmBilling` /
|
||||
`settleBilling` / `voucherBilling` / `receiptBilling` / `billingAction`)。
|
||||
3. 真 TDS 上 `PUT /api/ssw/tds/BillingLedger/{id}/Dispute` 不在 internal 白名单,
|
||||
返回 `{"code":600,"msg":"Login expired, please log in again"}`;而同批其它端点均正常放行。
|
||||
|
||||
**建议**:清理两仓残留——`BillingController` 类注释(`:32`「异议发起」)与 `@Tag`(`:46`「异议」)
|
||||
仍写异议能力;ssw-tds 侧确认状态机对应处理已移除;避免「一方仍发、另一方已不收」的悬空契约。
|
||||
|
||||
> 注(2026-11-05 17:35 更新):tdc-rs 已按上游同步**删除** `/Billing/{id}/Dispute` 端点与
|
||||
> `dispute_billing` 出向方法,`PUT` 该路径现回 **HTTP 404**(与 `chg_0022/C5` 用例口径一致)。
|
||||
> 此项不再是 tdc-rs 差距,本节建议仅针对 ssw-tdc / ssw-tds 两仓的注释与状态机残留。
|
||||
|
||||
### 3.2 新增 `side` 参数(2026-11-04 供方中心数据交易)
|
||||
|
||||
`3d247df` 的 `BillingController.list(connectorId, keyword, side)` 与
|
||||
`TdsReportClient.listBillingForConnector(..., side)` 支持 `PROVIDER` / `CONSUMER` 视角过滤;
|
||||
`side=null` 时不过滤(`ownsLedger` 依赖该缺省行为)。建议在 internal 契约文档中补齐该字段。
|
||||
|
||||
### 3.3 部署/环境层面(非代码问题)
|
||||
|
||||
- **内部令牌为部署级私有环境变量**,仓库无明文;不同测试部署值不同。建议团队维护一份
|
||||
「测试部署 internal token 索引」,避免联调反复试探。
|
||||
- **本地连接器身份需在目标 TDS 注册**:本次 tdc-rs 实例的 `f_tds_connector_id` 未在 .50 部署
|
||||
注册 ⇒ 自动带出的 `buyerConnectorId` 报「买方连接器不存在」;`Confirm` / `Settle` 走**严格**
|
||||
身份口径(显式 `connectorId` 必须与本端固定身份一致)也因此被拒。显式传入已注册连接器后
|
||||
下单成功。建议把「买方连接器不存在」的报错补上具体 id,便于定位是身份未注册。
|
||||
- `BillingLedger/Internal/List` 的 `connectorId` 必填(tdc-rs 已满足);建议缺省时返回显式 400
|
||||
而非空列表。
|
||||
- 下单成功后 `Billing/List` 仍为空——账单由其它流程生成,联调账本动作需另取真实账本 id。
|
||||
|
||||
---
|
||||
|
||||
## 4. 已验证通过的部分(无需动作)
|
||||
|
||||
| 端点 | 结果 |
|
||||
|---|---|
|
||||
| `GET /ServiceCatalog` | `code:200`,701 个真实产品 |
|
||||
| `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 个固定头 + 协议 `3.2` | 真 TDS 全部放行 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 建议落地的契约保护措施
|
||||
|
||||
- **新增「internal 通道契约测试」**:以 `TdsReportClient` 的请求体 schema 为基准,断言 ssw-tds
|
||||
各 `Internal` 端点的字段名/必填项一致;重点覆盖 `TradeOrder/Internal/Apply` 的 `usageId`
|
||||
(含**必须是主键**这一取值口径)与 `X-Protocol-Version` 头。
|
||||
- **CI 跨仓比对 `PROTOCOL_VERSION` 字面量**:任一侧变更即告警。
|
||||
- **契约变更单一入口**:internal 字段增删改统一走一个变更单,同步更新两侧与契约测试,避免再次分裂。
|
||||
|
||||
---
|
||||
|
||||
## 5bis. 补充证据:协议版本两仓各硬编码、13 天内连升 7 次
|
||||
|
||||
按「从 tdc-rs 建仓基线回溯上游更新」的复核,基线 `c568cc7`(2026-10-23)时
|
||||
`InternalTokenSupport.PROTOCOL_VERSION = "1.0"`,到 ssw-tdc 最新 `2d331e9`
|
||||
(2026-11-05 15:55)之间被 feature 提交逐次手工改动:
|
||||
|
||||
| 提交 | 批次 | 版本变化 |
|
||||
|---|---|---|
|
||||
| `a716a7b` | batch2 数据域 | `1.0 → 2.0` |
|
||||
| `81cbb19` | batch3c 标识码 | `2.0 → 2.1` |
|
||||
| `41739b4` | batch4a 订单六态 | `2.1 → 2.2` |
|
||||
| `898fced` | batch4b 交付五态 + 账单异议下线 | `2.2 → 2.3` |
|
||||
| `41ba4dd` | 签约期策略冲突 | `2.3 → 3.0` |
|
||||
| `ac55760` | 发布载荷 | `3.0 → 3.1` |
|
||||
| `c4812cf` | D03 协商增强 | `3.1 → 3.2` |
|
||||
|
||||
ssw-tds 侧有**同名同值**的独立常量,两侧没有任何自动校验:任一侧滞后即静默 401
|
||||
(tdc-rs 因停在 `1.0` 被真 TDS 判「跨端协议版本不兼容」)。这进一步支持 §5 的
|
||||
**CI 跨仓比对字面量**建议——建议把该常量抽到双方共享的契约清单/制品,或至少加一条
|
||||
「两仓 + 所有 Rust/其它语言实现」的版本一致性门禁。
|
||||
|
||||
同一期间 internal 契约还发生过这些增删改(均已由 tdc-rs 同步):
|
||||
`/Billing/{id}/Dispute` 下线、`Billing/List` 增 `side`、`Catalog/Internal/Catalog`
|
||||
增 5 个过滤字段、新增 `Catalog/Detail/{productCode}`、出向端点集合 67 → 70 条。
|
||||
⇒ 建议 §5 的「internal 通道契约测试」把**端点存在性 / 字段白名单 / 取值枚举**
|
||||
(如 `side ∈ {PROVIDER, CONSUMER}`,真 TDS 已会校验)一并纳入,而不只覆盖 Buy 字段。
|
||||
|
||||
真源复核:`3d247df`(.50 部署对应)→ `2d331e9` 的 8 个提交只动沙箱与前端,
|
||||
**契约层未变** ⇒ 本文档结论对最新 main 同样成立。
|
||||
|
||||
---
|
||||
|
||||
## 5ter. 补充发现:用上游验收用例跑跨进程验证后新增(2026-11-05 17:25,17:35 复跑)
|
||||
|
||||
把两仓 `openspec/changes/*/testcases.md` 里的验收用例挑了 21 条,
|
||||
在 tdc-rs ↔ .50 测试 TDS 之间实跑(脚本 `scripts/verify-upstream-cases.py`,
|
||||
报告 `docs/UPSTREAM-CASES-VERIFICATION.md`)。首轮 18 PASS / 2 FAIL / 1 INFO;
|
||||
tdc-rs 修完下线端点状态码后 **17:35 复跑 19 PASS / 1 FAIL / 1 INFO**,
|
||||
唯一剩余 FAIL 就是下面发现 5(上游字段漂移)。
|
||||
其中**新增一条与 Buy 漂移同根因的契约问题**。
|
||||
|
||||
### 🔴 发现 5:`contacter` ↔ `buyerContact` 字段名漂移(与发现 1 同类)
|
||||
|
||||
- ssw-tds `TradeOrderEntity.java:66-68`:属性 `buyerContact` 用
|
||||
`@JsonProperty("contacter")` 暴露给**对外 API**(PRD §8.2 `contacter C..10`)。
|
||||
- 但 internal 下单走 `TradeOrderServiceImpl.buy(Map body, true)`,
|
||||
**L155 `order.setBuyerContact(str(body.get("buyerContact")))`** —— 只认 `buyerContact`;
|
||||
L159-160 的超长校验(`> 10` 字符 ⇒ 抛「联系人不得超过 10 个字符」)也就只对
|
||||
`buyerContact` 生效。
|
||||
- 实测:经 tdc-rs 下单传 `contacter` = 20 字 ⇒ **`code 200` 直接出单,校验未触发**;
|
||||
改传 `buyerContact` = 20 字 ⇒ `code 400 联系人不得超过 10 个字符(contacter C..10)`。
|
||||
- 上游用例 `openspec/changes/chg_0032_batch4-trade-domain/testcases.md` 的
|
||||
`C4_order_audit_amount` 写的是「用 `contacter` 超 10 字符下单 ⇒ 被拒并提示」——
|
||||
**按对外字段写,却在 internal 通道下不成立**,等于该校验在连接器链路上被静默绕过。
|
||||
|
||||
**建议**:与发现 1(`productId` ↔ `usageId`)合并处理——
|
||||
在 `TradeOrder/Internal/Apply` 入口做一次**显式字段归一**
|
||||
(`productId`→`usageId`、`contacter`→`buyerContact`),或两仓统一 internal 键名,
|
||||
并给 internal 通道补一组「字段白名单」契约测试。
|
||||
|
||||
### 🟡 发现 6:下线端点的状态码口径
|
||||
|
||||
`chg_0022/C5`、`chg_0033/C4` 要求 `Dispute` / `Correction` 端点返回 **404**。实测:
|
||||
|
||||
| 位置 | 实际 |
|
||||
|---|---|
|
||||
| tdc-rs `PUT /api/ssw/tdc/Billing/{id}/Dispute` | **17:35 已修** ⇒ `HTTP 404 接口不存在`(首轮为 405) |
|
||||
| .50 TDS `PUT .../BillingLedger/{id}/Dispute` | `HTTP 200 + code 600 Login expired`(未注册路径被登录闸门拦) |
|
||||
| .50 TDS `POST .../BillingLedger/{id}/Correction` | 同上 |
|
||||
|
||||
tdc-rs 侧已按用例口径对齐为 **404**(根因:SPA 静态兜底对非 GET 先回 405,截胡了
|
||||
`/api/**` 未命中的 404 契约;已把 `/api` 判定前置并补回归测试,U05 复跑转 PASS)。
|
||||
**剩余口径差只在 .50 TDS 侧**:未注册 internal 路径被登录闸门拦成
|
||||
`HTTP 200 + code 600`,不是 404 ⇒ 建议用例口径改为「404 / 405 / 业务码 600
|
||||
均视为不可用」,或由平台侧让未注册 internal 路径直接 404。
|
||||
|
||||
### 🟡 发现 7:用例里「金额两位小数」是展示层要求
|
||||
|
||||
`chg_0033/C3` 期望金额两位小数,internal 账本 API 实际返 JSON 数值 `0.0`。
|
||||
账期 `YYYY-MM`、状态码 `01` 两位码均实测符合。建议用例把「金额格式」与「API 数值」分开断言,
|
||||
避免把展示层规则误套到接口上。
|
||||
|
||||
---
|
||||
|
||||
## 6. 附录:本次联调的可复现信息
|
||||
|
||||
- tdc-rs 启动:`PORT=30410 TDC_DATA_DIR=<project>/data SSW_INTERNAL_TOKEN=<入向> `
|
||||
`SSW_TDS_BASE_URL=http://192.168.1.50:33000 SSW_TDS_INTERNAL_TOKEN=<部署方令牌> ./target/debug/tdc-connector`
|
||||
- 健康检查回 `{"protocolVersion":"3.2","tdsMode":"HTTP","tdsBaseUrl":"http://192.168.1.50:33000"}`。
|
||||
- 入向调用统一带 `X-Internal-Token` + `X-Protocol-Version: 3.2`;所有 curl 必须
|
||||
`--noproxy '*'`(本机 `HTTP_PROXY=127.0.0.1:50005` 会劫持 loopback/内网请求)。
|
||||
- 关键响应原文:`数据产品不存在: null`、`买方连接器不存在`、`订单 DD202611050011`、
|
||||
`Login expired, please log in again`(Dispute 路径)。
|
||||
|
||||
---
|
||||
|
||||
*本文档由 tdc-rs 跨进程联调产出,真源钉在 ssw-tdc `3d247df`(.50 部署对应),
|
||||
并已复核最新 main `2d331e9` 契约层等价;§5ter 的用例验证明细见
|
||||
`docs/UPSTREAM-CASES-VERIFICATION.md`。供 ssw-tdc 项目组优化 internal 契约参考。*
|
||||
@@ -0,0 +1,145 @@
|
||||
# tdc-rs 上游同步记录与剩余差距
|
||||
|
||||
> **性质**:tdc-rs 自身记录,**不是** ssw-tdc 项目组的动作项。
|
||||
> 给项目组的问题见 `SSW-TDC-TDS-INTEGRATION-FINDINGS.md`。
|
||||
> **同步目标(最新真源)**:`ssw-tdc` `origin/main` = `2d331e92855a5203ce9632dd3881754848344ba9`(2026-11-05 15:55)。
|
||||
> **部署对应版本**:`3d247df`(.50 TDS 部署所用,14:13);已确认 `3d247df..2d331e9` 的 8 个提交
|
||||
> **只动 K8s 沙箱 / 隐私计算 / 两个 Vue 文件,未碰契约层** ⇒ 两者契约等价,同步到最新 main 即可对齐 .50。
|
||||
> **建仓基线**:`c568cc7`(2026-10-23 16:18,tdc-rs 10-24 建仓前最后一个上游提交,
|
||||
> 当时的 `/tmp/sswtdc-probe` 快照;`PROTOCOL_VERSION = "1.0"`)。
|
||||
> **核对/同步时间**:2026-11-05 17:35,真 TDS `192.168.1.50:33000` 复验并跑完 21 条上游用例后。
|
||||
|
||||
## 0. 基线 → 最新:上游这半个月改了什么
|
||||
|
||||
`c568cc7..2d331e9` 共 **188 个提交、472 个文件改动**,批次 `chg_0018` ~ `chg_0026`,
|
||||
新增 DB 迁移 `V2.95.0` ~ `V2.104.0` 共 13 个。改动集中在前端/沙箱/交付域;
|
||||
**与 tdc-rs 已实现范围(standalone 目录·购买·账单 10 个端点)相关的契约变更只有下面 5 项**。
|
||||
|
||||
### 协议版本演进(根因)
|
||||
|
||||
`InternalTokenSupport.PROTOCOL_VERSION` 在两仓各硬编码一份,期间连升 7 次:
|
||||
|
||||
| 提交 | 批次 | 版本 |
|
||||
|---|---|---|
|
||||
| 基线 `c568cc7` | — | `1.0` |
|
||||
| `a716a7b` | batch2 数据域 | `1.0 → 2.0` |
|
||||
| `81cbb19` | batch3c 标识码 | `2.0 → 2.1` |
|
||||
| `41739b4` | batch4a 订单六态 | `2.1 → 2.2` |
|
||||
| `898fced` | batch4b 交付五态 + **账单异议下线** | `2.2 → 2.3` |
|
||||
| `41ba4dd` | 签约期策略冲突 | `2.3 → 3.0` |
|
||||
| `ac55760` | 发布载荷 | `3.0 → 3.1` |
|
||||
| `c4812cf` | D03 协商增强 | `3.1 → 3.2` |
|
||||
|
||||
tdc-rs 一直停在 `1.0` ⇒ 真 TDS 版本闸门直接 401。已按上游单一常量语义升到 `3.2`,
|
||||
**移除**联调期自创的 `SSW_TDS_PROTOCOL_VERSION` env(真源无此配置)。
|
||||
|
||||
### 出向端点集合(基线 67 条 → 最新 70 条)
|
||||
|
||||
新增 `Catalog/Detail/`、`Contract/Internal/Get/`、`Contract/Internal/Refuse`、
|
||||
`DeliveryTask/Internal/ExecFact(s)`、`SampleAccess`、`Internal/PortalAsset`;
|
||||
删除 `Contract/Internal/Change`、`ChangeCancel`、`Resign`、`DeliveryTask/Internal/Ready`、
|
||||
`disputeBilling`。**除 `Catalog/Detail` 外全部落在 tdc-rs 未实现的 40+ 端点范围**,见 §5。
|
||||
|
||||
## 1. ✅ 已同步:`/Billing/{id}/Dispute` 下线
|
||||
|
||||
上游批4b(chg_0022 乙案,2026-10-29 定稿)删除路由与 `disputeBilling`。
|
||||
**已改**:`tds_biz.rs` 删路由 + `billing_dispute` handler;`tds.rs` 删 `dispute_billing`;
|
||||
`docs/contract.md` 端点表删该行;`tests/tds_biz.rs` 改用 Voucher 验证越权自检,
|
||||
并新增「`/Dispute` 已下线、不得出向」断言。
|
||||
**真 TDS 复验**:`PUT /Billing/FAKE/Dispute` →
|
||||
**HTTP 404 `{"code":404,"msg":"接口不存在","success":false}`** ✅
|
||||
> 注:刚删路由时曾回 405,根因**不在 axum 路由层**,而是 `platform::static_files::serve`
|
||||
> 对非 GET 请求一律先回 `405 + Allow`,截胡了 `/api/**` 未命中本该返回的 404。
|
||||
> 已把 `/api` 判定前置到静态服务之前,详见 §7。
|
||||
|
||||
## 2. ✅ 已同步:`Billing/List` 的 `side` 参数
|
||||
|
||||
上游 `BillingController.list(connectorId, keyword, side)` +
|
||||
`listBillingForConnector(cid, keyword, side)`(2026-11-04 供方中心 R1)。
|
||||
**已改**:入向 query 读 `side`;出向 body 非空白才带;`ownsLedger` 保持 `side=None`(两侧都返)。
|
||||
**真 TDS 复验**:`side=PROVIDER` → 200 真实账本;`CONSUMER` → 空;
|
||||
`side=BOGUS` → `400 side 只接受 PROVIDER / CONSUMER,收到: BOGUS`
|
||||
(证明字段被对端真实解析,非静默忽略)✅
|
||||
|
||||
## 3. ✅ 已同步:`internalCatalog` 过滤字段
|
||||
|
||||
上游改为 `internalCatalog(spaceId, Map filters)`,控制器 `putIfPresent` 收
|
||||
`keyword / industry / productType / dataSource / safeLevel / priceMode`(2026-11-04)。
|
||||
**已改**:`service_catalog_list` 读 6 键(`param()` 已 trim + 过滤空白 ≡ `putIfPresent`);
|
||||
`internal_catalog` 接受 `Option<&Map>`,只放非空白值,**取消「keyword 恒带键」旧行为**。
|
||||
**真 TDS 复验**:无参数 → 全量 701 条;`keyword=E2E-DNP-b3r3b-a7ty` → 1 条;
|
||||
`keyword=NOT-EXIST-XYZ` → 0 条;6 参数组合 → `{"list":[],"total":0}` ✅
|
||||
|
||||
## 4. ✅ 已同步(新增):`ServiceCatalog/Detail/{productCode}`
|
||||
|
||||
上游 2026-11-03 数据集语义批新增:入向 `GET /Detail/{productCode}` →
|
||||
出向 `GET /api/ssw/tds/Catalog/Detail/{code}?spaceId=<本端身份>`。
|
||||
🔴 上游明确 `spaceId` **只能从本端身份解析**,不得接受浏览器指定。
|
||||
**已改**:`tds.rs` 增 `catalog_detail`(段白名单 + URL 编码、解包型);
|
||||
`tds_biz.rs` 增 handler + 路由;`docs/contract.md` 端点表增行;`tests/tds_biz.rs` 增断言。
|
||||
**端点数**:删 Dispute −1、加 Detail +1 ⇒ 仍 10 条 / 总 132 条,`check-contract.sh` 全绿。
|
||||
**真 TDS 复验**:业务编码 `E2E-DNP-b3r3b-a7ty` → 200 完整详情;主键 → 400「产品不存在或不在本空间目录」
|
||||
(证明 TDS 按 productCode 查);带 `?spaceId=BOGUS` 仍返回正确详情(不信任入参);
|
||||
`%2e%2e` → 400「产品编码非法: ..」✅
|
||||
|
||||
## 5. 🟢 环境限制(非代码缺陷,仍在)
|
||||
|
||||
本地 `tdc_identity.f_tds_connector_id` 未在 .50 TDS 注册 ⇒ 自动带出的 `buyerConnectorId`
|
||||
报「买方连接器不存在」;`Confirm` / `Settle` 的严格身份口径因此被拒。
|
||||
显式传已注册 `878443108591731461` 后:Buy `usageId=产品主键` → 200 生成订单 ✅
|
||||
**动作**:联调时显式传 `buyerConnectorId` / `connectorId`,或写本端身份绑定。不改代码。
|
||||
|
||||
## 6. ⚪ 范围决策(需产品确认,仍在)
|
||||
|
||||
`2d331e9` 的 `TdsReportClient` 有 **70 条**出向端点(合同 / 交付任务 / 审计 / 主体 / 链证 / 大文件 / 沙箱…),
|
||||
tdc-rs 只实现 10 条(目录·购买·账单)。当前定位是 standalone 子集,
|
||||
是否扩到全量属范围决策而非 bug,需明确后再排期。
|
||||
|
||||
## 已确认对齐(无需动作)
|
||||
|
||||
- `PROTOCOL_VERSION = "3.2"`:单一常量同时驱动入向闸门与出向头,无 env 覆盖。
|
||||
- `internalHeaders()` 6 个头与 `TdsReportClient:2569` 逐字一致。
|
||||
- `internalApply` / `internalApplyBatch` / `billingAction` / `receiptBilling` / `voucherBilling`
|
||||
路径、方法、体形状在基线→最新期间**未变**,tdc-rs 无需改。
|
||||
- Buy 的 `productId` 原样透传与上游逐字一致(两仓 `productId` vs `usageId` 漂移是
|
||||
**上游对端问题**,见项目组 findings 文档,tdc-rs 不自创映射)。
|
||||
- 越权自检 `ownsLedger`、三档降级(NOOP / 不可达 / 业务失败)行为一致。
|
||||
|
||||
## 验证记录(2026-11-05 17:35 复跑)
|
||||
|
||||
| 项 | 结果 |
|
||||
|---|---|
|
||||
| `cargo build` | ✅ |
|
||||
| `cargo test`(全量,17 个测试二进制) | ✅ 308 passed / 0 failed / 1 ignored |
|
||||
| `bash scripts/check-contract.sh` | ✅ 端点表 132 条 ↔ 实际注册路由完全一致 |
|
||||
| 真 TDS 端到端复验 | ✅ 见 §1~§4 逐项 |
|
||||
| `verify-upstream-cases.py --with-write` | ✅ 21 条:19 PASS / 1 FAIL / 1 INFO(唯一 FAIL 为上游字段漂移) |
|
||||
|
||||
## 上游用例跨进程验证(2026-11-05 17:35 复跑)
|
||||
|
||||
`python3 scripts/verify-upstream-cases.py --with-write`:21 条上游验收用例
|
||||
(来源与逐条结果见 `docs/UPSTREAM-CASES-VERIFICATION.md`)
|
||||
⇒ **19 PASS / 1 FAIL / 1 INFO**(首轮 17:25 为 18/2/1)。
|
||||
唯一 FAIL 是 **U19** = 上游 `contacter` ↔ `buyerContact` 字段漂移
|
||||
(项目组 findings §5ter 发现 5),tdc-rs 按真源原样透传,**不自创映射**。
|
||||
|
||||
### ✅ 已闭环:U05 下线端点的 404 口径
|
||||
|
||||
首轮 U05 期望 404、实得 405。定位到 `platform::fallback::spa_fallback`:请求先交给
|
||||
`static_files::serve`,后者对齐 `ServeDir` 语义,对非 `GET`/`HEAD` **一律先回
|
||||
`405 + Allow`** ⇒ 把模块首行契约「`/api/**` 未命中 ⇒ 404 JSON」截胡了。
|
||||
**不是 axum 路由层的 method-not-allowed 回退。**
|
||||
|
||||
**已改**:`src/platform/fallback.rs` 把 `/api` 命名空间判定**前置**于静态服务
|
||||
(与 `fallback_response` / `ddl_guard` 同一层 percent-decode 口径);非 `/api` 路径的
|
||||
非 GET 仍回 405 + `Allow`(RFC 9110),未被过度改写。
|
||||
**已补**:`tests/spa_fallback.rs::api_unmatched_non_get_returns_404_json`
|
||||
(PUT/POST/DELETE/PATCH 精确 404 信封 + HEAD 状态码 + 反向锁定 SPA 深链仍 405);
|
||||
`tests/tds_biz.rs` 的 `/Dispute` 断言从 `assert_ne!(OK)` 收紧为 `assert_eq!(404)`。
|
||||
**复验**:真进程 `PUT /api/ssw/tdc/Billing/NOT-REAL/Dispute` →
|
||||
`HTTP 404 {"code":404,"msg":"接口不存在","success":false}`,U05 PASS ✅
|
||||
|
||||
> 这是修正「本仓既有 404 契约没在非 GET 上落实」,**不是**为用例自创业务逻辑。
|
||||
|
||||
> 另:`chg_0033/C3` 的「金额两位小数」是展示层要求,internal API 返数值 `0.0`,
|
||||
> 已按 INFO 记录,不是缺陷。
|
||||
@@ -210,3 +210,159 @@ POST /api/ssw/tds/Bridge/AuditTrail body: 留痕 JSON -> void
|
||||
|
||||
旧代理的「失败即降级、绝不拖垮本地 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`。
|
||||
|
||||
### 复跑命令
|
||||
|
||||
```bash
|
||||
# 启动(协议版本由 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`。
|
||||
|
||||
@@ -0,0 +1,148 @@
|
||||
# 【请裁定】ssw-tdc ↔ ssw-tds internal 契约:2 处字段漂移 + 3 处口径收敛
|
||||
|
||||
> **提交方**:tdc-rs(ssw-tdc 的 Rust 1:1 实现)
|
||||
> **真源基准**:ssw-tdc `3d247df4a0b48b85bb4532bccd4b39dc818e5a08`(2026-11-05 14:13,
|
||||
> 测试 TDS 部署 `192.168.1.50:33000` 对应版本);已复核最新 main `2d331e9` 契约层等价
|
||||
> **对端**:ssw-tds 最新仓;实测环境为上述 .50 部署,协议 `X-Protocol-Version: 3.2`
|
||||
> **时间**:2026-11-05 | **完整证据**:`docs/SSW-TDC-TDS-INTEGRATION-FINDINGS.md`
|
||||
|
||||
## 结论速览
|
||||
|
||||
- **通道本身已验证可用**:10 个出向端点的路径/方法/6 个固定头与 `3d247df` 的
|
||||
`TdsReportClient` 逐字一致,目录、详情、过滤、账本、`side` 枚举、越权 fail-closed、
|
||||
真实下单均跑通(成功订单 `DD202611050011`);21 条上游验收用例跨进程实跑 **19 PASS**。
|
||||
- **tdc-rs 严格按真源逐字实现,未做任何字段改名或取值适配**。下面 2 个 P0 都是
|
||||
**两仓 internal 契约漂移**,用第三方实现复现出来,不是 Rust 侧写错。
|
||||
- 需要项目组裁定的:**P0 × 2**(字段名漂移)、**P1 × 1**(版本治理)、
|
||||
**P2 × 4**(用例口径 / 残留清理)。
|
||||
|
||||
---
|
||||
|
||||
## 🔴 P0-1 Buy:`productId` ↔ `usageId`,且取值口径也不一致
|
||||
|
||||
**证据**
|
||||
|
||||
| 位置 | 行为 |
|
||||
|---|---|
|
||||
| `POST /api/ssw/tds/Catalog/Internal/Catalog` | 返回项只有 `id`(主键)与 `productId`(业务编码),**没有 `usageId`** |
|
||||
| `3d247df` `ServiceCatalogController.buy` (`:150-186`) | 仅在 `buyerConnectorId` 缺省时补一次,随后 `internalApply(body)` **原样透传** |
|
||||
| `3d247df` `TdsReportClient.java:1860-1864` | `postForEntity("/api/ssw/tds/TradeOrder/Internal/Apply", body)`,**不改名** |
|
||||
| ssw-tds `TradeOrderServiceImpl.buy:155` | `order.setUsageId(str(body.get("usageId")))` —— 只认 `usageId` |
|
||||
| 同文件 `:209-211` | `dataProductService.getById(order.getUsageId())` —— **按主键查**,取不到抛 `数据产品不存在: <usageId>` |
|
||||
|
||||
**实测**(目录取 `id=887690246907504709` / `productId=E2E-DNP-b3r3b-a7ty`)
|
||||
|
||||
| 请求体 | 真 TDS 返回 |
|
||||
|---|---|
|
||||
| `{"productId":"887690246907504709"}` / `{"productId":"E2E-DNP-b3r3b-a7ty"}` / `{"id":...}` | `数据产品不存在: null` |
|
||||
| `{"usageId":"E2E-DNP-b3r3b-a7ty"}`(业务编码) | `数据产品不存在: E2E-DNP-b3r3b-a7ty` |
|
||||
| `{"usageId":"887690246907504709","buyerConnectorId":"878443108591731461"}` | **`code:200` 下单成功** |
|
||||
|
||||
⇒ 不是简单的「改个键名」:目录给两种标识,TDS 要求把**主键 id** 装进 `usageId`。
|
||||
成功订单里 `productId` 仍是业务编码,说明两字段语义不同,不是别名。
|
||||
|
||||
**影响**:连接器 standalone 购买路径在真实 ssw-tds 上必然失败。
|
||||
|
||||
**建议(请裁定)**
|
||||
- **A(推荐,ssw-tdc 单点修复)**:`ServiceCatalogController.buy` 入口把前端产品标识
|
||||
规范化为 `usageId` = 目录项 **`id`(主键)**;`BuyBatch.productIds` 同理按主键数组。
|
||||
⚠️ 不能把 `productId` 的值直接换键名塞进 `usageId`(业务编码会被 `getById` 判不存在)。
|
||||
- **B(两仓统一)**:ssw-tds 改读 `productId` 并明确按主键还是业务编码查,两侧同步补契约测试。
|
||||
- **治本**:`Catalog/Internal/Catalog` 返回项显式给出 `usageId`(= 主键),
|
||||
或在 internal 契约文档写明「下单标识 = 目录项 `id`」。
|
||||
|
||||
---
|
||||
|
||||
## 🔴 P0-2 联系人:`contacter` ↔ `buyerContact`,超长校验被静默绕过
|
||||
|
||||
**证据**
|
||||
|
||||
- ssw-tds `TradeOrderEntity.java:66-68`:属性 `buyerContact` 用 `@JsonProperty("contacter")`
|
||||
暴露给**对外 API**(PRD §8.2 `contacter C..10`)。
|
||||
- internal 下单走 `TradeOrderServiceImpl.buy(Map body, true)`,
|
||||
**L155 只读 `body.get("buyerContact")`**;L159-160 的「联系人不得超过 10 个字符」
|
||||
校验因此只对 `buyerContact` 生效。
|
||||
- 上游用例 `openspec/changes/chg_0032_batch4-trade-domain/testcases.md`
|
||||
`C4_order_audit_amount` 按对外字段 `contacter` 写超长值 ⇒ 在 internal 通道下不成立。
|
||||
|
||||
**实测**:经 tdc-rs 下单,`contacter` = 20 字 ⇒ **`code 200` 直接出单(校验未触发)**;
|
||||
改传 `buyerContact` = 20 字 ⇒ `code 400 联系人不得超过 10 个字符(contacter C..10)`。
|
||||
|
||||
**影响**:连接器链路上该业务校验被静默绕过,会产出脏数据;且自动化测试按用例写会放行。
|
||||
|
||||
**建议**:与 P0-1 合并处理 —— 在 `TradeOrder/Internal/Apply` 入口做一次**显式字段归一**
|
||||
(`productId`→`usageId`、`contacter`→`buyerContact`),或两仓统一 internal 键名;
|
||||
两类字段名各补一组「字段白名单」契约测试。
|
||||
|
||||
---
|
||||
|
||||
## 🟡 P1 `PROTOCOL_VERSION` 两仓各硬编码,无跨仓校验
|
||||
|
||||
`InternalTokenSupport.PROTOCOL_VERSION` 在两仓各写一份字面量(当前均 `3.2`)。
|
||||
从 `c568cc7`(2026-10-23)到 `2d331e9`(2026-11-05)**13 天内连升 7 次**
|
||||
(`1.0 → 2.0 → 2.1 → 2.2 → 2.3 → 3.0 → 3.1 → 3.2`)。任一侧滞后即 internal 通道
|
||||
静默 401,错误只表现为「调用被拒」,不指向版本(tdc-rs 停在 `1.0` 时被
|
||||
真 TDS 判 `跨端协议版本不兼容(对端 1.0,本端 3.2)`,排查成本高)。
|
||||
|
||||
**建议**:把该常量纳入 **CI 跨仓比对门禁**(两仓 + 所有多语言实现断言相等),
|
||||
升级时同步 bump 并在 changelog 标注;或抽到双方共享的契约清单/制品。
|
||||
|
||||
---
|
||||
|
||||
## 🟢 P2 契约 / 用例口径收敛
|
||||
|
||||
| # | 问题 | 实测 | 建议 |
|
||||
|---|---|---|---|
|
||||
| 1 | 下线端点状态码 | `PUT .../BillingLedger/{id}/Dispute`、`POST .../Correction` 在 .50 返回 **`HTTP 200 + code 600 Login expired`**,不是用例写的 404(未注册 internal 路径被登录闸门拦) | 用例把「端点不可用」判成 404 / 405 / 业务码 600 之一,或平台让未注册 internal 路径直接 404。tdc-rs 侧已按用例对齐为 404 |
|
||||
| 2 | 「金额两位小数」 | `chg_0033/C3` 是**页面展示**要求;internal 账本 API 返 JSON 数值 `0.0`(账期 `YYYY-MM`、状态码 `01` 均符合) | 用例把「展示格式」与「API 数值」分开断言 |
|
||||
| 3 | `Billing/List` 的 `side` | 上游 2026-11-04 新增 `PROVIDER`/`CONSUMER`,真的会校验(`BOGUS` ⇒ 400) | internal 契约文档补齐该字段与枚举 |
|
||||
| 4 | Dispute 残留 | `3d247df` `BillingController.java:32` 类注释、`:46` `@Tag` 仍写「异议发起/异议」,路由与方法已下线 | 清理两仓注释与状态机残留,避免「一方仍发、另一方已不收」 |
|
||||
|
||||
**另(部署层,非代码问题)**:内部令牌是部署级私有环境变量,不同测试部署值不同;
|
||||
本地连接器身份需在目标 TDS 注册(未注册时报「买方连接器不存在」,建议报错带上具体 id)。
|
||||
建议团队维护一份「测试部署 internal token + 已注册连接器 id」索引,降低联调成本。
|
||||
|
||||
---
|
||||
|
||||
## 建议落地的保护措施
|
||||
|
||||
1. **internal 通道契约测试**:以 `TdsReportClient` 请求体 schema 为基准,断言两仓
|
||||
`Internal` 端点的字段名 / 必填项 / 枚举一致,重点覆盖
|
||||
`TradeOrder/Internal/Apply` 的 `usageId`(含**必须是主键**)与 `X-Protocol-Version`;
|
||||
并把**端点存在性 / 字段白名单 / 取值枚举**一并纳入。
|
||||
2. **CI 跨仓比对 `PROTOCOL_VERSION` 字面量**。
|
||||
3. **契约变更单一入口**:internal 字段增删改统一走一个变更单,同步两侧与契约测试。
|
||||
|
||||
---
|
||||
|
||||
## 复现方式
|
||||
|
||||
```bash
|
||||
# tdc-rs 以 3.2 + 部署方 internal token 直连真 TDS(非 stub)
|
||||
PORT=30410 TDC_DATA_DIR=<project>/data \
|
||||
SSW_INTERNAL_TOKEN=<入向令牌> \
|
||||
SSW_TDS_BASE_URL=http://192.168.1.50:33000 \
|
||||
SSW_TDS_INTERNAL_TOKEN=<部署方令牌> \
|
||||
./target/debug/tdc-connector
|
||||
|
||||
# 本机 HTTP_PROXY 会劫持 loopback/内网 ⇒ curl 一律 --noproxy '*'
|
||||
export TDS_INTERNAL_TOKEN='<部署方令牌>' # 部署级私有值,脚本只从环境变量读,不入库
|
||||
python3 scripts/verify-upstream-cases.py --with-write # 21 条,含真实下单
|
||||
```
|
||||
|
||||
入向统一带 `X-Internal-Token` + `X-Protocol-Version: 3.2`;结果写
|
||||
`/tmp/upstream_cases_result.json`,逐条明细见 `docs/UPSTREAM-CASES-VERIFICATION.md`。
|
||||
|
||||
---
|
||||
|
||||
## 附:tdc-rs 已按真源同步/对齐(排除「第三方实现写错」)
|
||||
|
||||
- 从建仓基线 `c568cc7` 回溯到 `2d331e9`(188 提交 / 472 文件),同步了契约层 5 项变更:
|
||||
`PROTOCOL_VERSION=3.2`(单一常量、无 env 覆盖)、`/Billing/{id}/Dispute` 下线、
|
||||
`Billing/List` 增 `side`、`internalCatalog` 6 个过滤字段、新增 `ServiceCatalog/Detail/{productCode}`。
|
||||
- 出向 6 个固定头与 `TdsReportClient:2569` 逐字一致;`ownsLedger` fail-closed、
|
||||
三档降级行为一致。
|
||||
- 本地 `cargo test` 全量 **308 passed / 0 failed / 1 ignored**;
|
||||
`check-contract.sh` 132 条端点 ↔ 实际注册路由一致。
|
||||
- **Buy 的 `productId` 原样透传与上游逐字一致**,联系人的 `contacter` 亦原样透传;
|
||||
本报告两个 P0 都是照抄真源后复现出的两仓漂移,tdc-rs 未自创映射。
|
||||
@@ -0,0 +1,127 @@
|
||||
# 上游验收用例 · 跨进程验证报告
|
||||
|
||||
> 2026-11-05 | tdc-rs(Rust)↔ 测试环境 TDS `http://192.168.1.50:33000`
|
||||
> 真源:ssw-tdc `3d247df`(.50 部署对应)/ 最新 main `2d331e9`;ssw-tds `0b37733`
|
||||
|
||||
## 1. 用例从哪来
|
||||
|
||||
两仓**没有可直接执行的 HTTP E2E 脚本**(`docs/e2e/cases/TC-DOM4-*.mjs` 在集成仓,不在本仓),
|
||||
验收用例以人读 Given/When/Then 写在 OpenSpec 变更里:
|
||||
|
||||
| 仓 | 用例文件 | 挑用的条目 |
|
||||
|---|---|---|
|
||||
| ssw-tdc | `openspec/changes/chg_0017_drop-demand-in-portal/testcases.md` | 「必须带内部凭证」 |
|
||||
| ssw-tdc | `chg_0020_batch3-identity-domain/testcases.md` | C5 connectorId 传播 |
|
||||
| ssw-tdc | `chg_0022_batch4b_delivery_billing/testcases.md` | **C5 账单无异议(要求 404)** |
|
||||
| ssw-tds | `chg_0032_batch4-trade-domain/testcases.md` | C4 超长联系人拒 / C5 用途非空 |
|
||||
| ssw-tds | `chg_0033_batch4b_delivery_billing/testcases.md` | C3 账单字段 / **C4 异议与修正端点下线** |
|
||||
| ssw-tds | `chg_0034_crypto-compliance/testcases.md` | **C18 协议版本兼容窗口** |
|
||||
| ssw-tds | `chg_0036_batch5-portal-record-domain/testcases.md` | C1 详情字段 / C2 门户边界 |
|
||||
|
||||
> 补充:tdc-rs 自带的 `scripts/upstream-test-ledger.tsv` 是**上游 Java 单测的移植台账**
|
||||
> (静态尺子,只管「搬没搬」),不是跨进程验收用例,与本报告不冲突。
|
||||
|
||||
## 2. 怎么跑
|
||||
|
||||
```bash
|
||||
# TDS internal token 是部署级私有值,只从环境变量读、不入库;未设置时脚本直接退出并提示
|
||||
export TDS_INTERNAL_TOKEN='<部署方令牌>'
|
||||
# 只读用例(无副作用)
|
||||
python3 scripts/verify-upstream-cases.py
|
||||
# 完整(含下单类,会真出订单)
|
||||
python3 scripts/verify-upstream-cases.py --with-write
|
||||
```
|
||||
|
||||
脚本内**临时**启动 `tdc-connector`(默认 `127.0.0.1:30412`),跑完无论成功失败都回收进程,
|
||||
不留后台服务;显式禁用代理(本机 `HTTP_PROXY` 会劫持 loopback/内网)。
|
||||
结构化结果写 `/tmp/upstream_cases_result.json`。
|
||||
测试数据**动态取**(目录第一个产品的 `id` / `productId`、账本列表),不硬编码。
|
||||
|
||||
**总计 21 条:PASS 19 / FAIL 1 / INFO 1。**(2026-11-05 17:35 修复 404 口径后复跑;首轮为 18/2/1)
|
||||
|
||||
## 3. 用例与结果
|
||||
|
||||
| # | 上游来源 | 期望 | 实际 | 判定 |
|
||||
|---|---|---|---|---|
|
||||
| U01 | tdc chg_0017 | 不带 `X-Internal-Token` ⇒ 401 | `401 内部接口凭证无效` | PASS |
|
||||
| U02 | tds C18 | 声明 `3.1`(同 major)⇒ 放行 | `200 code=200` 真实目录 | PASS |
|
||||
| U03 | tds C18 | 声明 `2.0`(跨 major)⇒ 拒 | `401 跨端协议版本不兼容(对端 2.0,本端 3.2)` | PASS |
|
||||
| U04 | tds C18(tdc-rs 入向面) | 声明 `1.0` ⇒ 拒 | `401 跨端协议版本不兼容` | PASS |
|
||||
| U05 | **tdc C5** | `PUT /Billing/{id}/Dispute` ⇒ **404** | `404 接口不存在`(17:35 复跑) | PASS |
|
||||
| U06 | tds C4 | TDS `PUT .../Dispute` ⇒ 404/未注册 | `HTTP 200 + code 600 Login expired` | PASS* |
|
||||
| U07 | tds C4 | TDS `POST .../Correction` ⇒ 404/未注册 | `HTTP 200 + code 600 Login expired` | PASS* |
|
||||
| U08 | tds C5 前置 | 目录返回真实产品 | 702 个产品,含 `id`/`productId` | PASS |
|
||||
| U09 | 上游最新 `internalCatalog` | `keyword` 精确过滤 | 命中 1 条 | PASS |
|
||||
| U10 | tds C1 | `GET /Detail/{productCode}` ⇒ 200 | 200 完整详情 | PASS |
|
||||
| U11 | tds C2 | 详情不含 `classifyLevel` | 未出现 | PASS |
|
||||
| U12 | tdc 段白名单 | `%2e%2e` 非法段被拒 | `code 400 产品编码非法: ..` | PASS |
|
||||
| U13 | 上游 `side` 枚举 | `side=BOGUS` ⇒ 400 | `400 side 只接受 PROVIDER / CONSUMER` | PASS |
|
||||
| U14 | tds C3 | `side=PROVIDER` 返回本方账本 | 30 条账本 | PASS |
|
||||
| U15 | tds C3 | 账期 `YYYY-MM` / 两位状态码 / 金额两位小数 | 账期 `2026-11`✓、状态 `01`✓、金额 `0.0`(数值,非展示串) | **INFO** |
|
||||
| U16 | ssw-tdc `ownsLedger` | 非本方账本 fail-closed | `code 400`(身份解析阶段即拒,未出向) | PASS |
|
||||
| U17 | 本次 findings 对照 | 透传 `productId` ⇒ `数据产品不存在: null` | 复现 | PASS |
|
||||
| U18 | tds C5 | `usageId`=主键 + `purpose` ⇒ 200 出单 | 200 出单 | PASS |
|
||||
| U19 | **tds C4** | **`contacter` > 10 字符 ⇒ 下单被拒** | **`code 200` 直接出单** | **FAIL** |
|
||||
| U20 | tdc C5 | 自动补 `buyerConnectorId` | `400 买方连接器不存在`(本端身份未在 .50 注册) | PASS |
|
||||
| U21 | tds C4 复核 | `buyerContact` > 10 字符 ⇒ 拒 | `400 联系人不得超过 10 个字符(contacter C..10)` | PASS |
|
||||
|
||||
\* U06/U07 按「端点不可用」判定:TDS 源码里 `Dispute`/`Correction` 路由确实已删,
|
||||
未注册路径被登录闸门拦成 `HTTP 200 + code 600`。**语义等价但状态码不是用例写的 404**,
|
||||
见 §4.3。
|
||||
|
||||
## 4. 偏差项分析
|
||||
|
||||
### 4.1 U19(新发现 · 高价值):internal 通道联系人字段名漂移
|
||||
|
||||
- ssw-tds `TradeOrderEntity:66-68` 把属性 `buyerContact` 用 `@JsonProperty("contacter")` 暴露给**对外 API**;
|
||||
- 但 internal 下单走 `TradeOrderServiceImpl.buy(Map body, true)`,L155 直接
|
||||
`order.setBuyerContact(str(body.get("buyerContact")))` —— **只认 `buyerContact`,不认 `contacter`**;
|
||||
- 于是上游用例 `chg_0032/C4`(按对外字段写 `contacter` 超 10 字符)经连接器 internal 通道下发时
|
||||
**校验完全不触发,超长联系人静默出单**;改传 `buyerContact` 才被 L159-160 拦下(U21)。
|
||||
|
||||
这与已登记的 Buy `productId` ↔ `usageId` 漂移是**同一类根因**:
|
||||
实体对外 JSON 名与 internal `Map` 键名没有统一映射,两侧各写各的。
|
||||
建议项目组一并收敛(统一键名,或在 internal 入口做一次显式字段归一)。
|
||||
|
||||
### 4.2 U05:端点下线的状态码口径(tdc-rs 侧已修复,转 PASS)
|
||||
|
||||
`chg_0022/C5` 与 `chg_0033/C4` 都要求下线端点返回 **404**。首轮 tdc-rs 返回
|
||||
**405 + `code:405 方法不被允许`**。根因不在 axum 路由层:`platform::fallback::spa_fallback`
|
||||
把请求先交给静态服务,而静态服务对齐 `ServeDir`,对非 GET/HEAD 一律先回 `405 + Allow`,
|
||||
截胡了本仓既有契约「`/api/**` 未命中 ⇒ 404 JSON」。
|
||||
|
||||
已把 `/api` 命名空间判定前置到静态服务之前(非 `/api` 路径的非 GET 仍保持 405 + Allow),
|
||||
并补 `tests/spa_fallback.rs` 精确 404 断言、收紧 `tests/tds_biz.rs` 的 `/Dispute` 断言。
|
||||
**17:35 真进程复跑:`HTTP 404 {"code":404,"msg":"接口不存在","success":false}` ⇒ U05 PASS。**
|
||||
|
||||
剩余口径差只在 **.50 TDS 侧**(U06/U07 返回 `HTTP 200 + code 600`,见 §4.3),
|
||||
建议项目组用例把「端点不可用」判成 404 / 405 / 业务码 600 之一,或由平台侧
|
||||
让未注册 internal 路径直接 404。
|
||||
|
||||
### 4.3 U06/U07:用例期望与 .50 部署口径
|
||||
|
||||
未注册 internal 路径在 .50 返回 `HTTP 200 + code 600 Login expired`,不是 404。
|
||||
这是**平台鉴权过滤器**的表现,非 tdc-rs 问题;但用例若只判 HTTP 状态码会误判。
|
||||
建议用例改为判「端点不可用」(404/405,或业务码 600)。
|
||||
|
||||
### 4.4 U15:展示层 vs API 数值
|
||||
|
||||
`C3` 的「金额两位小数」是**页面展示**要求;internal 账本 API 返回 JSON 数值 `0.0`。
|
||||
账期 `^\d{4}-\d{2}$、状态码 `01` 两位码均已实测符合。此项记为 INFO,不是缺陷。
|
||||
|
||||
### 4.5 环境限制(非代码问题)
|
||||
|
||||
本端 `f_tds_connector_id` 未在 .50 TDS 注册 ⇒ 自动补的 `buyerConnectorId` 报
|
||||
「买方连接器不存在」,Confirm/Settle 的严格身份口径也在解析阶段被拒(U16、U20)。
|
||||
用例里凡需已注册身份的,均显式传 `878443108591731461`。
|
||||
|
||||
## 5. 结论
|
||||
|
||||
- tdc-rs 与真 TDS 的 **3.2 internal 通道全线可用**:鉴权闸门、版本兼容窗口、目录/详情/过滤、
|
||||
账本查询与 `side` 枚举、越权 fail-closed、下单链路均按上游行为落地。
|
||||
- **19/21 通过**;U05(下线端点状态码)已由 tdc-rs 修复并复验转 PASS。
|
||||
唯一 FAIL 是 **U19 上游 internal 字段漂移**;按「严格按真源、不自创映射」的约束
|
||||
不在 tdc-rs 侧修,已并入给项目组的 findings 请其裁定。
|
||||
- 上游用例仍有 3 处口径需要收敛(`contacter` 字段名、下线端点的 404 断言在 .50 上不成立、
|
||||
金额展示格式套到 API 数值上),否则自动化测试会出现「实现正确但用例判红」
|
||||
或「实现漏校验但用例放行」。
|
||||
+1
-1
@@ -149,13 +149,13 @@
|
||||
| GET | `/api/ssw/tdc/Billing/List` | 本方账单列表(出向 TDS `BillingLedger/Internal/List`) |
|
||||
| GET | `/api/ssw/tdc/Billing/LocalCompare` | 本地计量比对(读本地 `tdc_api_consume_log`,**零出向**) |
|
||||
| PUT | `/api/ssw/tdc/Billing/{id}/Confirm` | 账单确认(出向 TDS `BillingLedger/{id}/Confirm`) |
|
||||
| PUT | `/api/ssw/tdc/Billing/{id}/Dispute` | 账单异议(出向 TDS `BillingLedger/{id}/Dispute`) |
|
||||
| PUT | `/api/ssw/tdc/Billing/{id}/Receipt` | 收据(出向 TDS `BillingLedger/{id}/Receipt`) |
|
||||
| PUT | `/api/ssw/tdc/Billing/{id}/Settle` | 账单结算(出向 TDS `BillingLedger/{id}/Settle`) |
|
||||
| GET | `/api/ssw/tdc/Billing/{id}/Voucher` | 对账凭证(出向 TDS `BillingLedger/{id}/Voucher`) |
|
||||
| GET | `/api/ssw/tdc/ServiceCatalog` | 服务目录(出向 TDS `Catalog/Internal/Catalog`) |
|
||||
| POST | `/api/ssw/tdc/ServiceCatalog/Buy` | 目录下单(出向 TDS `TradeOrder/Internal/Apply`) |
|
||||
| POST | `/api/ssw/tdc/ServiceCatalog/BuyBatch` | 目录批量下单(出向 TDS `TradeOrder/Internal/ApplyBatch`) |
|
||||
| GET | `/api/ssw/tdc/ServiceCatalog/Detail/{productCode}` | 目录详情(出向 TDS `Catalog/Detail/{productCode}?spaceId=`) |
|
||||
<!-- END ENDPOINTS -->
|
||||
|
||||
### 🔴 端点数**不许**手工维护(用脚本对账)
|
||||
|
||||
Reference in new issue
Block a user