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

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，不再混用旧展示字段