## 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** 系统不复机