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

38 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## Context
待处理换货读取已先解析资产、再校验个人客户归属、最后读取物流换货单。换货服务已经注入个人客户资产归属服务,但当前读取路径未使用它,而是直接以资产虚拟号查询设备号绑定。无虚拟号物联网卡应使用 ICCID 绑定;空字符串被用作设备号查询时会把无关历史绑定误判为归属。
## Goals / Non-Goals
**Goals:**
- 让待处理换货读取复用个人客户资产归属的单一权威判定。
- 消除空虚拟号导致的错误可见性与错误拒绝。
- 保持换货单筛选、响应、错误码和路由不变。
**Non-Goals:**
- 不变更个人客户绑定模型、现有绑定数据或换货单数据。
- 不处理手机号—资产关联、测试环境配置或其他个人客户资产读取入口。
- 不引入迁移、兼容别名或新的抽象层。
## Decisions
### 用已注入的客户归属服务替换旧本地校验
`GetPending` 从用户上下文取得当前个人客户 ID,并以已解析资产的类型和 ID 调用现有客户归属服务。该服务已按资产类型与虚拟号是否为空路由到设备号或 ICCID 绑定表,是当前风险换卡等 C 端路径采用的归属口径。
不修改归属服务,也不在换货服务复制 ICCID/虚拟号分支。这样保证后续绑定规则演进只有一个判定来源。
### 保持外部不可枚举语义
归属查询返回未拥有、资产不存在或底层不可见结果时,待处理换货接口继续映射为既有“资产不存在”。已通过归属校验但没有活动物流换货单时继续成功返回空数据。
### 回归验证聚焦无虚拟号与空键
在现有 Go 测试基础设施可覆盖时,测试应构造无虚拟号卡、有效 ICCID 绑定和待处理物流换货单,断言返回待处理投影;再构造仅有空设备号绑定的客户,断言不能读取同一卡。同步保留有虚拟号资产的回归样例,证明既有路径未改变。若当前仓库无可隔离的持久化测试面,则使用维护者指定测试环境的两张卡完成原请求 smoke,并记录脱敏响应。
## Risks / Trade-offs
- 归属服务读取资产一次,`GetPending` 已解析资产后会产生重复读取;本次优先消除授权歧义,不为单次读取引入新接口或缓存。
- 既有依赖空虚拟号误授权读取换货单的请求将被拒绝;这是纠正越权行为,不提供兼容路径。