marco
b4780e256e
- 重写 15 张已有表文档:每张补「用在 App 哪/增删改查时机/字段取值/join key 指向」 - 新建 4 张缺失表文档:wechat_transfer_authorization / ad_watch_log / price_report / app_config - 新增 OVERVIEW.md:功能↔表映射 + 写入路径 + 表间关系(含语义 join key)+ ER + 资金模型 - README 索引补齐到 19 表 + 置顶 OVERVIEW + 通用约定补全 - 纠正过时:withdraw_order(reviewing/rejected/user_name)、savings_record(/order/report 真实写入)、coin_transaction(biz_type) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.4 KiB
2.4 KiB
ad_watch_log — 看激励视频观看时长(每日防刷主闸)
模型
app/models/ad_watch_log.py· 仓库app/repositories/ad_watch.py· 接口POST /api/v1/ad/watch-report(上报)、读取面 ad-reward-status · ← 索引 · 总览
每条 = 客户端 onAdClose 上报的一次激励视频实际观看秒数。按 (user_id, watch_date) 聚合 SUM(watch_seconds) 得当日总观看时长,用于"每天最多看 50 分钟激励视频"硬上限(rewards.DAILY_AD_WATCH_SECONDS_LIMIT)。是看广告三条数据流之一(时长闸),与 ad_reward(发奖)、ad_ecpm(收益)并列、互不关联。
防刷设计:前端上报时长不可信 → 时长是主闸;配合
ad_reward_record的每日次数兜底(DAILY_AD_REWARD_LIMIT,默认 200),前端少报时长也刷不过次数闸。
用在哪 / 增删改查
- C(插入):
POST /ad/watch-report(add_watch_seconds)。每次看完激励视频上报一次 → 写一行,watch_seconds服务端夹[0, MAX_SINGLE_WATCH_SECONDS=120](防异常大值)。鉴权接口已确保 user 存在,不校验 UnknownUser。 - U / D:无。当日多次观看 = 多行,靠 SUM 聚合。
- R:
watched_seconds_today当日累计 —— 被ad_reward.grant_ad_reward(发奖前的时长闸)和GET /ad/reward-status(展示"今日已看 X/50 分钟" + 满则不给看)调用。
字段
| 列 | 类型 | 约束 / 默认 | 说明(取值 / join) |
|---|---|---|---|
id |
Integer | PK, autoincrement | |
user_id |
Integer | FK→user.id, index, NOT NULL | 归属用户 |
watch_seconds |
Integer | NOT NULL, default 0 | 本次实际观看秒数(服务端已夹 [0,120]) |
watch_date |
String(10) | index, NOT NULL | 北京时间日期串 YYYY-MM-DD,按它等值做"当日总时长"聚合 |
created_at |
DateTime(tz) | server_default now(), index | 时间 |
关系 / Join Key
user_id→user.id(多对一)。- 与
ad_reward_record/ad_ecpm_record无公共键:不做逐条关联,只按(user_id, watch_date)聚合。发奖时ad_reward读本表当日累计判时长闸。
索引与约束
- PK
id;indexuser_id、watch_date、created_at。
注意
- 上限走常量
DAILY_AD_WATCH_SECONDS_LIMIT=3000(50min)/MAX_SINGLE_WATCH_SECONDS=120(暂未挂 app_config,改值改core/rewards.py)。 - 按日期串等值查,不在 SQL 跨时区比 date(SQLite 不可靠)。