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>
2.5 KiB
2.5 KiB
signin_record — 签到记录(14 天循环)
模型
app/models/signin.py· 仓库app/repositories/signin.py· 接口 signin-status / signin-do · ← 索引 · 总览
App「每日签到」每签一次写一行,(user_id, signin_date) 唯一,天然防一天签两次。cycle_day(1..14)决定发多少金币(档位 rewards.SIGNIN_REWARDS,默认 (200,120,150,180,200,250,500,200,250,300,350,400,500,3000),运营后台 app_config.signin_rewards 可改),断签重置回 1;第 15 天回到第 1 天;streak 是连续天数(不封顶),给"已连续签到 N 天"展示。
用在哪 / 增删改查
- C(插入):
POST /signin/do(do_signin)。今天未签且校验通过 → 算出cycle_day/streak(昨天签过则在上次基础上 +1、否则重置 1)→ 写一行 +grant_coins(biz_type='signin', ref_id=今天日期)加币,同事务 commit。今天已签再调 → 抛AlreadySignedError(409),不重复写。 - U / D:无。每天一行,历史不改。
- R:
GET /signin/status(签到页:今天签没签、连续天数、14 档状态/金币、能否签),内部get_status读最近一条 + 推算今天档位。
字段
| 列 | 类型 | 约束 / 默认 | 说明(取值 / join) |
|---|---|---|---|
id |
Integer | PK, autoincrement | |
user_id |
Integer | FK→user.id, index, NOT NULL | 归属用户 |
signin_date |
Date | NOT NULL | 签到日期(北京时间 cn_today() 的 date)。其 ISO 串被 coin_transaction.ref_id 引用(biz_type=signin) |
cycle_day |
Integer | NOT NULL | 取值 1..14:14 天循环里今天第几档,决定发币额;断签重置回 1 |
streak |
Integer | NOT NULL | 连续签到天数(≥1,不封顶);断签重置回 1 |
coin_awarded |
Integer | NOT NULL | 本次实发金币(= 当时档位金额) |
created_at |
DateTime(tz) | server_default now() | 时间 |
关系 / Join Key
user_id→user.id(多对一)。- 配套写
coin_account(U,加币)+coin_transaction(C,biz_type='signin'、ref_id=signin_date.isoformat())。coin_transaction.ref_id反查即对应本表当天那条。
索引与约束
- PK
id;indexuser_id;UNIQUE(user_id,signin_date) =uq_signin_user_date(防一天签两次)。
注意
- "今天/昨天"全按北京时间(
CN_TZ=UTC+8),不用 UTC(否则 0~8 点会算成前一天)。 - 连续判定:
last.signin_date == today - 1天才算连续,否则首签/断签重置。