zkxw/openspec/changes/cell-storage-protocol-modules/specs/cell-storage-installment-warning/spec.md

ADDED Requirements

Requirement: 分期预警数据范围

系统 SHALL 仅统计满足以下条件的 biz_protocol_payment_detail 行：当前租户、del_flag=0、pay_status = dfj（待缴费）、installment_no 非空（分期明细）。系统 SHALL NOT 将 pay_status = jfqrz 或其他状态纳入本列表。

Scenario: 待缴费过滤

• WHEN 请求分期预警列表
• THEN 返回行均满足 dfj 且存在分期期序号

Requirement: 预警与逾期判定

系统 SHALL 使用服务器当前日期与 installment_due_date（存储为 YYYYMMDD 字符串）比较。对每一行 SHALL 可判定：

• 逾期：应缴日早于当天；
• 预警：应缴日在当天或未来 15 天（含）内，且未逾期。

系统 SHALL 支持按「预警 / 逾期 / 全部」类筛选参数过滤（具体 query 名称以实现为准，须在前后端一致）。

Scenario: 超出 15 天未到期不标为预警

• WHEN 某分期应缴日晚于今天起算第 16 天
• THEN 该行在仅查「预警」类结果中 SHALL NOT 出现（「全部」是否出现由产品约定；默认实现可仍列出但标签非预警）

Requirement: Web 分期缴费预警页

Web 管理端 SHALL 提供「分期缴费用户预警」列表页，展示应缴日、预警/逾期标签、关联协议单标识等；对齐标准列表模板与 Fresh Mint 规范。

Scenario: 用户查看逾期列表

• WHEN 用户选择逾期筛选并加载列表
• THEN 展示的行均为应缴日早于今天的待缴费分期明细