## ADDED Requirements ### Requirement: 按套餐状态与资产状态分层匹配 系统 SHALL 在现有匹配维度(网络与实名状态、卡类别、运营商账户)之外,按套餐状态(有生效套餐、套餐已用完、只有待生效套餐、无套餐)与资产状态(在库、已销售、已换货、已停用)匹配轮询配置;维度为空表示不限。绑定设备的卡 MUST 按设备计算套餐状态,独立卡按卡计算,口径与现有"是否有有效套餐"判断一致。系统 MUST 在卡任务执行完收尾、全量初始化、生命周期重新匹配时计算层级,卡的层级最迟在下一次执行时更新。 #### Scenario: 套餐到期后降层 - **GIVEN** 卡原匹配"有生效套餐"层,套餐已过期 - **WHEN** 该卡下一次轮询执行完收尾 - **THEN** 系统按"无套餐"层的间隔计算各检查类型下次到期时间 #### Scenario: 设备卡同层 - **WHEN** 设备下 2 张卡分属不同运营商账户,设备有生效套餐 - **THEN** 两张卡都按"有生效套餐"匹配 ### Requirement: 检查间隔三态与合并 系统 SHALL 区分每种检查类型间隔的三种取值:正数(秒)表示按此间隔检查并停止向下查找;`0` 表示不检查并停止向下查找;空表示继承,继续查找优先级更低的配置。系统 MUST 按优先级升序、优先级相同按配置 ID 升序遍历启用的匹配配置,对每种检查类型取第一个非空取值。接口 MUST 接受 `0` 或不小于该类型最小间隔的正数,拒绝其他值。 #### Scenario: 无套餐层不查流量 - **GIVEN** "无套餐"层流量间隔为 `0`,优先级更低的兜底配置流量间隔为 3600 - **WHEN** 无套餐卡匹配这两条配置 - **THEN** 该卡不做流量检查 #### Scenario: 空值继承 - **GIVEN** 高优先级配置实名间隔为空,低优先级配置实名间隔为 7200 - **WHEN** 卡同时匹配两条配置 - **THEN** 该卡实名检查间隔为 7200 #### Scenario: 相同优先级 - **WHEN** 两条启用配置优先级都为 1 且同时匹配一张卡 - **THEN** 系统按配置 ID 较小者优先,结果在多次计算间保持一致 ### Requirement: 无套餐层与库存层必须检查卡状态 系统 SHALL 拒绝保存匹配"无套餐且已销售"或"在库"的配置中卡状态检查间隔为空或 `0` 的情况。已销售无套餐、在库的卡未匹配到任何配置时,系统 MUST 告警且不入队。 #### Scenario: 库存层未配卡状态 - **WHEN** 维护者保存资产状态为"在库"、卡状态间隔为 `0` 的配置 - **THEN** 系统拒绝保存并提示该层必须配置卡状态检查 ### Requirement: 优先级调整、匹配预览与重算到期时间 系统 SHALL 允许超级管理员单条修改配置优先级,以及一次提交全部配置顺序整体重排(事务内完成)。保存时若与其他启用配置优先级相同且匹配条件可能重叠,系统 MUST 提示但不拦截。系统 SHALL 提供匹配预览:输入 ICCID(可附带未保存的修改),返回该卡各匹配维度取值、命中配置列表,以及每种检查类型最终采用的间隔与来源(按间隔、不检查、继承自某配置、未匹配),预览 MUST 不写任何数据。系统 SHALL 提供"立即重算到期时间"异步任务(可按运营商账户限定),新到期时间 = min(当前到期, 上次检查时间 + 新间隔),只提前不推后,只更新调度状态、不调网关,返回任务 ID 与进度。 #### Scenario: 整体排序 - **WHEN** 超级管理员提交新的配置顺序 - **THEN** 系统按顺序重排优先级,各进程在配置刷新后按新顺序匹配 #### Scenario: 预览未保存修改 - **WHEN** 运营带上"把某配置流量间隔改为 0"的未保存修改预览一张卡 - **THEN** 系统返回修改后的最终间隔与来源,配置与调度状态不变 #### Scenario: 缩短间隔后重算 - **GIVEN** 某层流量间隔从 86400 改为 3600,卡 A 上次查流量在 2 小时前、当前到期在 20 小时后 - **WHEN** 执行重算到期时间 - **THEN** 卡 A 流量检查到期时间改为上次检查后 1 小时(即立即到期),且仍受运营商账户限流约束执行 ### Requirement: 重置日前加密查流量 系统 SHALL 在配置了 `pre_reset_window` 与 `pre_reset_carddata_interval` 的层内,于卡所属运营商账户重置时刻(重置日当天 0 点,业务时区)前的窗口内,按窗口间隔安排流量检查:窗口内下次到期 = 当前 + 窗口间隔,若越过重置时刻则改为"重置时刻 − 收尾提前量"(已过则不再加查);窗口前按正常间隔算出的到期越过窗口起点时截断到窗口起点;越过重置时刻后恢复正常间隔。两列为空表示该配置不加密。 #### Scenario: 窗口内最后一次查询 - **GIVEN** 重置日为 1 号,窗口 6 小时,窗口间隔 30 分钟,收尾提前量 5 分钟,当前为 31 号 23:40 - **WHEN** 计算流量下次到期 - **THEN** 下次到期为 31 号 23:55,而不是 1 号 00:10 #### Scenario: 截断到窗口起点 - **GIVEN** 正常间隔 1 天,当前为 31 号 10:00,窗口起点 31 号 18:00 - **WHEN** 计算流量下次到期 - **THEN** 下次到期为 31 号 18:00 ### Requirement: 分层与加密效果可观测 系统 SHALL 提供按层的卡数与漏配告警卡数统计,以及按运营商账户、按重置周期的"有生效套餐但窗口内未查到流量"卡数与最后一次查询距重置时刻的分布。 #### Scenario: 查看分层统计 - **WHEN** 运营查询分层统计 - **THEN** 系统返回每层卡数与未匹配任何配置的已销售无套餐、在库卡数