修正数据

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

@@ -0,0 +1,29 @@
+## 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`