## MODIFIED Requirements ### Requirement: 统一资产解析入口 系统 SHALL 提供统一的资产查找接口,通过任意标识符定位卡或设备,并返回该资产的中等聚合信息。 **API 端点**: `GET /api/admin/assets/resolve/:identifier` **流量相关响应结构(AssetResolveResponse)**: - `current_package`: 当前主套餐名称(无主套餐时返回空字符串) - `current_package_usage_id`: 当前主套餐的套餐使用记录 ID(无主套餐时为 null) - `real_total_mb`: 当前主套餐真实总量 - `real_used_mb`: 当前主套餐真实已用量 - `virtual_total_mb`: 当前主套餐业务停机阈值 - `virtual_used_mb`: 当前主套餐展示已用量 - `reduction_pct`: 按 `(real_total_mb / virtual_total_mb) - 1` 计算 **流量展示规则**: - 流量摘要只代表当前生效主套餐,不聚合加油包 - 无当前生效主套餐时,上述流量字段全部返回 0,`current_package_usage_id` 返回 null #### Scenario: 返回当前主套餐五字段摘要 - **WHEN** 管理员解析一张存在生效主套餐的卡 - **THEN** 响应中包含 `current_package_usage_id`、`real_total_mb`、`real_used_mb`、`virtual_total_mb`、`virtual_used_mb` 和 `reduction_pct` #### Scenario: 无主套餐时返回空摘要 - **WHEN** 管理员解析一台没有当前生效主套餐的设备 - **THEN** 响应中 `current_package = ""` - **AND** `current_package_usage_id = null` - **AND** 流量字段均返回 `0`