OuYingJun1024
bb58fb2a29
按"一表一文件"建库表文档(协作规范第 11 条):字段(类型/约束/默认)+ 索引与约束 + 关系 + 说明,从 model 的 Mapped 定义扒准。 - README 索引:13 张表总览 + 通用约定(主键/外键/金额分/北京时间日期串/JSONB variant) - 覆盖 user / coin_account / coin_transaction / cash_transaction / withdraw_order / signin_record / user_task / savings_record / ad_reward_record / ad_ecpm_record / feedback / comparison_record / comparison_milestone_claim - savings_record 文档强调"成交省钱"≠"比价行为",与 comparison_record 互不喂数据 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1.6 KiB
1.6 KiB
ad_reward_record — 看激励视频发奖记录(S2S 回调)
模型
app/models/ad_reward.py| 关联接口 ad-pangle-callback / ad-reward-status | ← 表索引
每条 = 穿山甲一次发奖回调。trans_id 唯一做幂等键(穿山甲会重试,同号只发一次)。reward_date(北京时间日期串)给"每日上限"计数用,按日期串等值查。
字段
| 列 | 类型 | 约束 / 默认 | 说明 |
|---|---|---|---|
id |
Integer | PK, autoincrement | |
trans_id |
String(64) | UNIQUE, index, NOT NULL | 穿山甲交易号(幂等键) |
user_id |
Integer | FK→user.id, index, NOT NULL | 归属用户(回调 media_extra 带回) |
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 | 时间 |
索引与约束
- PK:
id;UNIQUE + index:trans_id;index:user_id、reward_date、created_at
关系
user_id→user.id(多对一)
说明
- 三道闸:验签不过 403 →
trans_id唯一幂等(并发 catch IntegrityError)→ 当日次数 ≥DAILY_AD_REWARD_LIMIT记capped不发币。 - 发币复用
grant_coins(biz_type='ad_reward', ref_id=trans_id)。