feat: 新增全部已使用流量和全部总流量字段
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 2m30s

This commit is contained in:
luo
2026-07-03 12:03:52 +08:00
parent 99de03604d
commit acda0d82c8
10 changed files with 155 additions and 5 deletions

View File

@@ -0,0 +1,37 @@
# 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:
- 无;新增请求参数和响应字段均为可选,前端资产信息页仅主动请求并展示新增数据