cursor/plans/console返水过期兜底_1de18924.plan.md

name, overview, todos, isProject

name	overview	todos	isProject
console返水过期兜底	在 C 端返水信息接口增加“近7天过期兜底”逻辑：若存在未领取且已过期记录，进入接口时自动标记为 expired，避免依赖定时脚本。	id content status locate-info-hook 在 DailyRebateLogic::info() 增加近7天过期兜底调用点（查询记录前） pending id content status add-scope-expire-method 新增用户+近7天范围的过期更新方法，仅更新 claimable 且已过期记录 pending id content status verify-behavior 按过期/未过期/超范围三类样例验证 info 返回状态符合预期 pending	false

Console返水信息过期兜底改造

目标

在用户访问返水信息接口时，对该用户“近7天”记录执行一次轻量过期兜底：把 status=claimable 且 expire_at<=当前时间 的记录更新为 expired，避免脚本漏跑导致前端状态不一致。

改动方案

• 在 /Users/ray/Documents/project/www/slot/slot_console/app/api/logic/DailyRebateLogic.php 的 info() 开头（$unlocked 判定后、组装 records 前）新增一步：
  • 仅针对当前 uid、统计日期范围“今天往前 6 天到今天”（即接口展示的近7天）执行过期更新。
  • 更新条件：status = STATUS_CLAIMABLE 且 expire_at <= now()。
  • 更新结果无需抛错，作为兜底处理（可选记录 debug/info 日志）。
• 在同文件新增受保护方法（例如 expireRecentClaimableForInfo(int $uid): int）承载该逻辑，保持 info() 主流程清晰，符合 Logic 分层。
• 保留现有 expireDueRecords()（全量定时任务用），新方法仅用于 C 端接口的“用户级小范围补偿”，两者职责互补，不互相替代。

细节约束

• 范围严格限定为近7天，避免接口触发全表更新。
• 仅改 claimable -> expired，不触碰 claimed / pending。
• 执行顺序放在读取记录前，保证本次 records 返回的状态已是最新。

验证计划

• 构造 1 条近7天内 claimable + expire_at 已过期 数据，调用 info 后应返回 expired。
• 构造 1 条近7天内 claimable + expire_at 未到期 数据，调用 info 后仍为 claimable。
• 构造 1 条 7 天外过期 claimable 数据，调用 info 后不应被本接口更新（仍由定时任务处理）。
• 回归 claim 接口：已过期记录仍不可领取（现有保护逻辑保持不变）。