ok

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

@@ -0,0 +1,39 @@
+---
+name: console返水过期兜底
+overview: 在 C 端返水信息接口增加“近7天过期兜底”逻辑：若存在未领取且已过期记录，进入接口时自动标记为 expired，避免依赖定时脚本。
+todos:
+  - id: locate-info-hook
+    content: 在 DailyRebateLogic::info() 增加近7天过期兜底调用点（查询记录前）
+    status: pending
+  - id: add-scope-expire-method
+    content: 新增用户+近7天范围的过期更新方法，仅更新 claimable 且已过期记录
+    status: pending
+  - id: verify-behavior
+    content: 按过期/未过期/超范围三类样例验证 info 返回状态符合预期
+    status: pending
+isProject: false
+---
+
+# Console返水信息过期兜底改造
+
+## 目标
+在用户访问返水信息接口时，对该用户“近7天”记录执行一次轻量过期兜底：把 `status=claimable` 且 `expire_at<=当前时间` 的记录更新为 `expired`，避免脚本漏跑导致前端状态不一致。
+
+## 改动方案
+- 在 [`/Users/ray/Documents/project/www/slot/slot_console/app/api/logic/DailyRebateLogic.php`](/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` 接口：已过期记录仍不可领取（现有保护逻辑保持不变）。