huang
6b1fbf4a92
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m30s
2.1 KiB
2.1 KiB
Why
当前线上存在“卡流量已同步但套餐流量不变化”的问题，导致计费与停复机判断失真。该问题集中出现在绑定设备的卡和小流量高频上报场景，已经影响流量扣减准确性，需要优先修复。
What Changes
- feature-001-traffic-deduction-carrier-routing：修正轮询流量扣减时的载体路由逻辑，避免固定按
iot_card扣减导致设备级套餐无法命中。 - feature-002-traffic-deduction-fractional-precision：修正流量扣减精度，消除
float64 -> int64截断造成的<1MB增量长期丢失。 - feature-003-traffic-field-semantics-clarify：明确字段语义与展示口径：
current_month_usage_mb：系统自然月累计流量（卡维度）last_gateway_reading_mb：运营商当前周期累计读数（卡维度）
- 保持现有分层架构与任务链路不变（Handler → Service → Store → Model），仅调整扣减判定与数据口径说明；无 BREAKING API 变更。
Capabilities
New Capabilities
- 无
Modified Capabilities
polling-task-handlers：polling_carddata_handler在触发套餐扣减时，需支持“卡绑定设备时按设备载体命中套餐”而非固定卡载体。package-usage-priority：DeductDataUsage需支持小数 MB 增量累计后扣减，保证小流量高频上报场景下扣减准确。asset-queries：资产流量字段语义说明补充，避免将current_month_usage_mb误用为运营商周期口径。
Impact
- 受影响代码：
internal/task/polling_carddata_handler.gointernal/service/package/usage_service.gointernal/service/iot_card/service.gointernal/model/dto/asset_dto.go（描述语义）
- 受影响数据：
tb_package_usage.data_usage_mb的增长将更贴近上游真实增量（尤其是 <1MB 高频增量场景）
- API 兼容性：
- 无接口路径和结构变更
- 前端展示口径建议改为读取
last_gateway_reading_mb表达“运营商周期累计流量”
- 依赖与基础设施：无新增外部依赖、无数据库迁移。