Files
junhong_cmp_fiber/openspec/changes/fix-depleted-package-display/proposal.md
break ff25586dc9
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 8m43s
修复已用完套餐展示
2026-09-08 17:25:34 +08:00

25 lines
1.2 KiB
Markdown

## Why
C 端资产信息接口将已用完的主套餐当作“无套餐”返回,导致用户无法查看已用量、套餐名称和到期时间。已用完仍是当前世代中可展示且未到期的套餐状态,必须与生效中套餐一致投影其使用信息。
## What Changes
- 调整 `GET /api/c/v1/asset/info` 的当前主套餐选择范围:除生效中主套餐外,也选择已用完主套餐。
- 已用完主套餐命中时,接口返回套餐名称、使用记录 ID、开始/到期时间及真/虚流量指标,不再返回套餐字段零值。
- 保持待生效、已过期、已失效主套餐不作为当前套餐展示;不改变套餐耗尽阈值、状态流转、续费价格或套餐历史接口。
## Capabilities
### New Capabilities
- 无。
### Modified Capabilities
- `personal-customer`: C 端资产信息必须展示当前已用完主套餐的使用信息。
## Impact
- 影响 `internal/service/asset` 的当前主套餐读取,以及 `internal/store/postgres` 的主套餐状态筛选。
- `GET /api/c/v1/asset/info` 对已用完套餐由零值摘要改为完整套餐摘要;不涉及 Schema、迁移、外部调用或写操作。