Files
junhong_cmp_fiber/openspec/changes/archive/2026-09-24-fix-pending-exchange-ownership/design.md
break b09275a0d0
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m53s
修复待处理换货资产归属
2026-09-24 12:30:33 +08:00

2.4 KiB
Raw Blame History

Context

待处理换货读取已先解析资产、再校验个人客户归属、最后读取物流换货单。换货服务已经注入个人客户资产归属服务,但当前读取路径未使用它,而是直接以资产虚拟号查询设备号绑定。无虚拟号物联网卡应使用 ICCID 绑定;空字符串被用作设备号查询时会把无关历史绑定误判为归属。

Goals / Non-Goals

Goals:

  • 让待处理换货读取复用个人客户资产归属的单一权威判定。
  • 消除空虚拟号导致的错误可见性与错误拒绝。
  • 保持换货单筛选、响应、错误码和路由不变。

Non-Goals:

  • 不变更个人客户绑定模型、现有绑定数据或换货单数据。
  • 不处理手机号—资产关联、测试环境配置或其他个人客户资产读取入口。
  • 不引入迁移、兼容别名或新的抽象层。

Decisions

用已注入的客户归属服务替换旧本地校验

GetPending 从用户上下文取得当前个人客户 ID,并以已解析资产的类型和 ID 调用现有客户归属服务。该服务已按资产类型与虚拟号是否为空路由到设备号或 ICCID 绑定表,是当前风险换卡等 C 端路径采用的归属口径。

不修改归属服务,也不在换货服务复制 ICCID/虚拟号分支。这样保证后续绑定规则演进只有一个判定来源。

保持外部不可枚举语义

归属查询返回未拥有、资产不存在或底层不可见结果时,待处理换货接口继续映射为既有“资产不存在”。已通过归属校验但没有活动物流换货单时继续成功返回空数据。

回归验证聚焦无虚拟号与空键

在现有 Go 测试基础设施可覆盖时,测试应构造无虚拟号卡、有效 ICCID 绑定和待处理物流换货单,断言返回待处理投影;再构造仅有空设备号绑定的客户,断言不能读取同一卡。同步保留有虚拟号资产的回归样例,证明既有路径未改变。若当前仓库无可隔离的持久化测试面,则使用维护者指定测试环境的两张卡完成原请求 smoke,并记录脱敏响应。

Risks / Trade-offs

  • 归属服务读取资产一次,GetPending 已解析资产后会产生重复读取;本次优先消除授权歧义,不为单次读取引入新接口或缓存。
  • 既有依赖空虚拟号误授权读取换货单的请求将被拒绝;这是纠正越权行为,不提供兼容路径。