coupon/coupon_sync_rules.md

兑换码状态同步规则

数据流

远程API（根据产品配置的接口地址）
    │
    ▼ 请求参数：start_time, end_time, app_id（产品code）
    ▼ Header：Authorization = md5(start_time + end_time)
    │
    ▼ 返回数据（status=2 已使用的兑换码列表）
    │
    ▼ 逐条匹配本地 claim_records
    │
    ▼ 匹配成功 → 更新状态
    ▼ 匹配失败 → 记录未匹配

匹配规则

步骤	说明
1. 取数据	调用产品配置的 API 接口，按使用时间范围查询已使用的兑换码
2. 过滤	只处理 status=2（已使用）的记录
3. 匹配	用 coupon_code + product_id 匹配本地 claim_records 表
4. 更新	匹配到的记录如果本地 status != 2，则更新状态、使用时间、会员ID

未匹配的常见原因

原因	说明
该兑换码不是通过本系统领取的	API 返回的是该产品下所有已使用的码，包含其他渠道发放的
产品归属不对	claim_records.product_id 与当前产品的 ID 不一致
领取记录已被删除	数据已被清理

同步方式

1. 手动同步

• 位置：后台设置 → 兑换码状态同步
• 选择时间范围，点击"立即同步"
• 结果显示：API 总条数、匹配条数、更新条数、已匹配 code 列表、未匹配 code 列表

2. 定时任务

• 每天凌晨 2 点执行，同步前一天的数据
• crontab：0 2 * * * php /path/to/cron_sync.php