Files
shaguabijia-app-server/docs/database/user_task.md
ouzhou da7ce69494 feat(ad): eCPM 上报接口 + 冷却策略解耦纯函数 + savings JSONB 跨库修复 (#8)
- 新增 POST /api/v1/ad/ecpm-report:激励视频展示后客户端上报本次 eCPM,落 ad_ecpm_record 做内部收益统计(model/repository/schema/alembic 迁移 + 接口文档)
- 看广告冷却策略抽到 app/core/ad_cooldown.py 纯函数;ad_reward.today_status 只取数据,换策略只改这一处
- savings.dishes 改 JSON().with_variant(JSONB,"postgresql"):SQLite 无 visit_JSONB 会让 create_all 编译崩,修复后测试套件恢复

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: OuYingJun1024 <1034284404@qq.com>
Reviewed-on: #8
Co-authored-by: ouzhou <ouzhou@wonderable.ai>
Co-committed-by: ouzhou <ouzhou@wonderable.ai>
2026-06-01 22:23:15 +08:00

1.4 KiB

user_task — 一次性任务领取去重

模型 app/models/task.py | 关联接口 tasks-list / tasks-claim | ← 表索引

像"打开消息提醒"这类只能领一次的任务,完成后写一行,(user_id, task_key) 唯一防重复领奖。可循环领取的任务(签到)不走这张表,有专表 signin_record

字段

类型 约束 / 默认 说明
id Integer PK, autoincrement
user_id Integer FK→user.id, index, NOT NULL 归属用户
task_key String(48) NOT NULL 任务标识,见 rewards.TASK_REWARDS(如 enable_notification)
status String(16) NOT NULL, default completed 任务状态
coin_awarded Integer NOT NULL, default 0 该任务发放金币
completed_at DateTime(tz) server_default now() 完成/领取时间

索引与约束

  • PK: id;index: user_id
  • UNIQUE(user_id, task_key) = uq_task_user_key(防重复领)

关系

  • user_iduser.id(多对一)

说明

  • 领取:写本表 + grant_coins(biz_type='task_<key>', ref_id=task_key) 同事务;重复领抛 409,未知 key 抛 404。
  • 比价战绩里程碑虽是"领一次"模型但不复用本表,另有 comparison_milestone_claim(因 task_key 是固定字典,里程碑是按次数解锁的序号)。