2.1 KiB
2.1 KiB
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.tssrc/types/api/asset.tssrc/views/asset-management/asset-information/types.tssrc/views/asset-management/asset-information/composables/useAssetInfo.tssrc/views/asset-management/asset-information/components/BasicInfoCard.vue
- Dependencies:
GET /api/admin/assets/resolve/:identifier后端支持include_usage_summaryQuery 参数及响应字段
- Breaking changes:
- 无;新增请求参数和响应字段均为可选,前端资产信息页仅主动请求并展示新增数据