修正数据

openspec/changes/refactor-traffic-model-semantics/specs/client-asset-info/spec.md

@@ -0,0 +1,46 @@
+## MODIFIED Requirements
+
+### Requirement: B1 资产基本信息查询接口
+系统 SHALL 提供 `GET /api/c/v1/asset/info?identifier=xxx`，并且 MUST 要求个人客户认证（C 端 Token）。
+
+**流量相关响应字段**:
+- `current_package`
+- `current_package_usage_id`
+- `real_total_mb`
+- `real_used_mb`
+- `virtual_total_mb`
+- `virtual_used_mb`
+- `reduction_pct`
+
+**约束**:
+- 流量摘要仅表示当前主套餐，不聚合加油包
+- 不再返回 `package_total_mb`、`package_used_mb`、`package_remain_mb` 等旧字段
+
+#### Scenario: C 端资产信息返回主套餐五字段
+- **WHEN** 客户调用 `GET /api/c/v1/asset/info?identifier=8986xxxx` 且资产存在当前主套餐
+- **THEN** 响应包含当前主套餐的统一五字段与 `reduction_pct`
+
+#### Scenario: 无主套餐时返回空摘要
+- **WHEN** 客户查询的资产没有当前主套餐
+- **THEN** 响应中流量字段返回 `0`，`current_package_usage_id` 返回 `null`
+
+### Requirement: B3 历史套餐列表接口
+系统 SHALL 提供 `GET /api/c/v1/asset/package-history?identifier=xxx&page=1&page_size=20`，并且 MUST 要求个人客户认证。
+
+**列表项字段**:
+- `package_usage_id`
+- `package_name`
+- `package_type`
+- `master_usage_id`
+- `real_total_mb`
+- `real_used_mb`
+- `virtual_total_mb`
+- `virtual_used_mb`
+- `reduction_pct`
+- `activated_at`
+- `expires_at`
+- `status`
+
+#### Scenario: C 端历史列表复用统一字段
+- **WHEN** 客户调用 `GET /api/c/v1/asset/package-history`
+- **THEN** 列表项使用统一五字段与 `reduction_pct`，不再混用旧展示字段