Files
one-pipe-system/openspec/changes/update-asset-resolve-usage-summary/proposal.md
luo acda0d82c8
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 2m30s
feat: 新增全部已使用流量和全部总流量字段
2026-07-03 12:03:52 +08:00

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