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