Files
邹进 9c3c258f16
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m27s
feat: 卡流量读数先过采集队列再入账,扣减按采集时刻确定套餐
- 每卡 Redis 采集队列(默认 N=3、跨天清空、回退容差 1 MB),攒满且不下降才写最后一个点
- 测试环境全量切换日快照计量,下线灰度名单、切换水位与卡表基线扣费;全部卡置待建起点
- 读数区分没给值与 0;有套餐的卡读数 0 也写快照与日用量 0 行;重置日比较基准为 0 照常防旧值
- 新增采集记录(按月分区保留 90 天)、人工冲正流水与后台接口、采集告警
- 扣减按采集时刻有效套餐查找,只对生效中套餐做状态迁移,查不到套餐按成功跳过
- 换货新卡(新设备下的卡)打待建起点;采集间隔上限只校验启用中的轮询配置

Change: add-card-traffic-queue-and-observed-deduction

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 12:18:47 +09:00

4.6 KiB
Raw Blame History

ADDED Requirements

Requirement: 按采集时刻确定扣减套餐

系统 SHALL 在消费流量增量事件时,按事件携带的采集时间用 card-traffic-metering 的"有套餐判断口径"查找扣减套餐,不再只认扣费时刻状态为生效中的套餐。采集时刻有效、扣费时已用完或已到期的套餐 MUST 照扣。扣减顺序、每个套餐的容量(启用虚流量时为虚总量,否则为真总量)、最后一个套餐承接超出部分、小数部分累积的规则保持不变。采集时间早于套餐最近一次流量重置、扣费在重置之后的,增量 MUST 扣在重置后的周期,审计记录采集时间与该套餐最近重置时间。

Scenario: 采集后套餐到期

  • WHEN 采集时间为套餐到期前 1 分钟,扣费时套餐已到期
  • THEN 系统照常扣减该套餐

Scenario: 用完到停机之间的用量

  • WHEN 卡唯一套餐已用完但仍在有效期,写入点产生增量
  • THEN 系统把增量计入该套餐的超出部分

Scenario: 跨套餐流量重置

  • WHEN 采集时间在日重置套餐 00:00 重置之前,扣费在重置之后
  • THEN 系统把增量扣在重置后的周期,审计中记录采集时间与重置时间

Requirement: 扣减时的套餐状态迁移

系统 SHALL 只对当前状态为生效中的套餐做"扣到阈值改为已用完"的状态迁移。当前状态为已用完、已过期的套餐 MUST 照常累加已用量与套餐日用量,MUST NOT 改变状态。余量小于等于 0 且不是最后一个套餐的跳过。停机判断 MUST 仍按套餐当前状态判断是否还有可用套餐。

Scenario: 已过期套餐被扣

  • WHEN 采集时刻有效的套餐在扣费时已过期,本次扣到超过阈值
  • THEN 系统累加已用量,套餐状态仍为已过期

Scenario: 生效中套餐扣到阈值

  • WHEN 生效中套餐本次扣减后达到阈值
  • THEN 系统把套餐改为已用完,并按当前状态判断是否停机

Requirement: 扣费时查不到套餐

采集时刻有套餐、扣费时一个套餐都查不到(采集后被退款或作废)时,系统 SHALL 记录告警日志与扣费审计(标明跳过原因),把事件按成功处理,MUST NOT 重试。该笔用量需要时由人工冲正处理。

Scenario: 采集后退款

  • WHEN 流量事件消费前,采集时刻唯一有效的套餐已退款
  • THEN 系统写跳过审计,事件按成功结束,不重试

Requirement: 套餐日用量记录

系统 SHALL 按 (套餐使用记录, 日期) 唯一保存套餐日用量,扣减时原子累加当天用量、覆盖累计用量,并发扣减 MUST NOT 产生重复行或丢失累加。日期 MUST 取写入点采集时间的上海日期,不取扣费时间;消费者的日流量缓冲同样按采集时间的上海日期归属。

Scenario: 凌晨采集隔一会儿才扣费

  • WHEN 写入点采集时间为上海时间 10-29 00:30,扣费在 00:31
  • THEN 套餐日用量记在 10-29

Scenario: 并发扣减同一套餐同一天

  • WHEN 两条流量事件同时扣减同一套餐同一天
  • THEN 当天只有一行日用量,当天用量为两次之和

Requirement: 人工冲正

系统 SHALL 提供人工冲正:调整套餐已用量只能经冲正流水进行,流水记录套餐使用记录、卡或设备、调整量(正数补扣、负数退回)、调整前后已用量、必填原因、可选关联采集记录与流量事件、操作人与时间。冲正 MUST 在事务内先锁定套餐行,按锁定后的当前已用量计算新值;调整后已用量小于 0 时 MUST 拒绝,不截成 0。同一事务内写流水、更新已用量并按阈值重算状态(已用完与生效中之间);已过期、已失效的套餐只改已用量不改状态。冲正 MUST 写审计。提交后系统 SHALL 调用停复机判断,MUST NOT 直接复机或停机。冲正 MUST NOT 修改卡日快照与已结算。

Scenario: 退回多扣的流量

  • WHEN 管理员对已用完的套餐冲正 −500 MB,冲正后低于阈值
  • THEN 套餐改为生效中,写流水与审计,提交后由停复机判断决定是否复机

Scenario: 退回后为负

  • WHEN 套餐已用 100 MB,管理员冲正 −200 MB
  • THEN 系统拒绝冲正,已用量不变

Scenario: 与扣减并发

  • WHEN 冲正与一笔流量扣减同时作用于同一套餐
  • THEN 两次修改都生效,不互相覆盖

Scenario: 卡因其他原因停机

  • WHEN 冲正后套餐不再用完,但卡因未实名停机
  • THEN 系统不复机