OuYingJun1024
356d6e52b9
签到加成(boost): - 新增 signin_boost_record 表(user+date 唯一)+ POST /api/v1/signin/boost - signin 状态/结算逻辑调整 信息流广告结算: - 新增 ad_feed_reward_record 表(client_event_id 幂等)+ POST /api/v1/ad/feed-reward - ad_feed_reward 模型/repo、ad schema、按 ecpm/时长结算金币 金币数值:core/rewards.py 数值调整、config_schema/admin config 适配 迁移 coin_reward_phase1(down_revision pstat3growth);测试 + API/DB 文档同步 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
3.2 KiB
3.2 KiB
ad_reward_record — 看激励视频发奖记录(S2S 回调)
模型
app/models/ad_reward.py· 仓库app/repositories/ad_reward.py· 接口 ad-pangle-callback / ad-reward-status / ad-test-grant · ← 索引 · 总览
每条 = 穿山甲一次服务端发奖回调(用户看完激励视频)。是看广告三条数据流之一(发奖;另两条:ad_watch_log 时长、ad_ecpm_record 收益,三者无公共键)。trans_id 唯一做幂等键(穿山甲会重试,同号只发一次)。reward_date(北京时间日期串)给"每日上限"计数用。
用在哪 / 增删改查
- C(插入):
POST /ad/pangle-callback(穿山甲 S2S,经 SHA256 验签;grant_ad_reward)或POST /ad/test-grant(本地联调)。三道闸:① 验签不过 → API 层 403,不进库;②trans_id已存在 → 原样返回不重复发;③ 当日发奖次数(DAILY_AD_REWARD_LIMIT,默认 500)到顶 → 记一行status='capped'、coin=0、不发币。旧的观看总时长闸仅在DAILY_AD_WATCH_SECONDS_LIMIT > 0时启用,当前默认停用。否则granted+grant_coins(biz_type='ad_reward', ref_id=trans_id)加币,同事务。 - U / D:无。
- R:
GET /ad/reward-status(看广告页:今日已发次数/上限、单次金币、本轮已看/冷却结束、今日已看时长/上限);审计/对账整表回溯。
字段
| 列 | 类型 | 约束 / 默认 | 说明(取值 / join) |
|---|---|---|---|
id |
Integer | PK, autoincrement | |
trans_id |
String(64) | UNIQUE, index, NOT NULL | 穿山甲交易号(幂等键)。被 coin_transaction.ref_id 引用(biz_type=ad_reward) |
user_id |
Integer | FK→user.id, index, NOT NULL | 归属用户(回调 media_extra 带回;不存在抛 UnknownUserError) |
coin |
Integer | NOT NULL, default 0 | 实发金币;capped 时为 0 |
status |
String(16) | NOT NULL, default granted |
取值:granted(已发)/ capped(当日次数超限,记录但不发) |
reward_date |
String(10) | index, NOT NULL | 北京时间日期串 YYYY-MM-DD,按它等值统计当日发奖次数 |
reward_name |
String(64) | nullable | 穿山甲上报奖励名(参考,不作发奖依据) |
raw |
String(1024) | nullable | 回调原始参数(审计排查) |
created_at |
DateTime(tz) | server_default now(), index | 时间 |
关系 / Join Key
user_id→user.id(多对一)。trans_id← 被coin_transaction.ref_id引用(granted那条发币流水);capped行不发币、无对应流水。- 与
ad_watch_log/ad_ecpm_record无公共键;当前不逐条关联 eCPM 和发奖回调。
索引与约束
- PK
id;UNIQUE+indextrans_id;indexuser_id、reward_date、created_at。
注意
- 当前公网回调尚未接入前,激励视频精确 eCPM 绑定发奖先搁置;实发金币仍以穿山甲回调
reward_amount为准(resolve_ad_reward_coin解析,缺/坏回退默认、超上限夹紧),单次金币/每日上限/单次上限均从app_config读(运营后台可改)。 - 并发同
trans_id撞唯一约束 → catch IntegrityError 回滚返回已存在那条(幂等兜底)。