Files
junhong_cmp_fiber/openspec/changes/refactor-traffic-model-semantics/specs/asset-resolve/spec.md
huang fe4c545308
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 7m55s
修正数据
2026-04-27 18:10:08 +08:00

1.4 KiB
Raw Blame History

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 计算

流量展示规则:

  • 流量摘要只代表当前生效主套餐,不聚合加油包
  • 无当前生效主套餐时,上述流量字段全部返回 0current_package_usage_id 返回 null

Scenario: 返回当前主套餐五字段摘要

  • WHEN 管理员解析一张存在生效主套餐的卡
  • THEN 响应中包含 current_package_usage_idreal_total_mbreal_used_mbvirtual_total_mbvirtual_used_mbreduction_pct

Scenario: 无主套餐时返回空摘要

  • WHEN 管理员解析一台没有当前生效主套餐的设备
  • THEN 响应中 current_package = ""
  • AND current_package_usage_id = null
  • AND 流量字段均返回 0