# Change: 更新资产解析流量汇总展示 ## Why 后台“资产信息”页需要展示当前世代下所有套餐的虚流量已用量和剩余量,方便运营人员在查看资产基础信息时快速判断整体流量消耗情况。 后端通过 `GET /api/admin/assets/resolve/:identifier` 新增可选查询参数控制是否返回汇总字段;前端需要明确请求契约、类型契约和展示位置,避免默认查询缺失汇总数据。 ## What Changes - 更新资产解析接口请求契约: - `GET /api/admin/assets/resolve/:identifier` 支持可选 Query 参数 `include_usage_summary: boolean` - 参数含义为是否返回当前世代流量汇总字段 `total_virtual_used_mb` / `total_virtual_remaining_mb` - 后端未传时默认不返回汇总数据;后台“资产信息”页发起解析请求时默认传 `include_usage_summary=true` - 更新资产解析接口响应契约: - 新增 `total_virtual_used_mb?: number | null`,表示所有套餐已用量(MB),未请求时为 `null` - 新增 `total_virtual_remaining_mb?: number | null`,表示所有套餐剩余量(MB),未请求时为 `null` - 更新后台“资产信息”基础信息展示: - 卡资产在“运营商状态”字段后新增“所有套餐已用量”和“所有套餐剩余量” - 设备资产在“SN”字段后新增“所有套餐已用量”和“所有套餐剩余量” - 字段值使用上述两个响应字段,并按流量大小格式化展示 - 字段为空或未请求时显示稳定占位内容 ## Impact - Affected specs: - `asset-information` - Affected code: - `src/api/modules/asset.ts` - `src/types/api/asset.ts` - `src/views/asset-management/asset-information/types.ts` - `src/views/asset-management/asset-information/composables/useAssetInfo.ts` - `src/views/asset-management/asset-information/components/BasicInfoCard.vue` - Dependencies: - `GET /api/admin/assets/resolve/:identifier` 后端支持 `include_usage_summary` Query 参数及响应字段 - Breaking changes: - 无;新增请求参数和响应字段均为可选,前端资产信息页仅主动请求并展示新增数据