OuYingJun1024
56f4548654
让客户端 4 态任务行 CTA (Normal/Loading/Capped/CoolingDown) 与 ExitReward 弹窗 limit note (本轮看完/今日看完 二选一) 都由后端权威派生, 跨设备 / 重装 / 杀进程都一致, 客户端不再依赖 in-memory 本地存储。 - core/rewards.py: 加 VIDEO_ROUND_REQUIRED_COUNT=3 / VIDEO_ROUND_COOLDOWN_SECONDS=600 - repositories/ad_reward.py: today_status 从 3-tuple 扩成 5-tuple, 从已有 created_at 字段按 ORDER BY DESC + OFFSET round_count 派生最近一个 已完成轮末尾时间; 零新字段零新表 - schemas/ad.py: AdRewardStatusOut + TestGrantOut 加 round_count + cooldown_until - api/v1/ad.py: reward_status / test_grant 接 5-tuple - tests: 加 4 个覆盖 (初始 / 未达一轮 / 刚达一轮进冷却 / 冷却已过) - docs/api/ad-reward-status.md: 补字段说明 + 客户端 4 态 CTA 推导规则 + "冷却仅 UX, 发奖不受影响" 注解 冷却是 UX 约束: pangle-callback 发奖只看 daily_limit, 冷却期间穿山甲 回调照常发奖, 不另设拒发分支。 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
56 lines
2.5 KiB
Python
56 lines
2.5 KiB
Python
"""看激励视频发奖相关 schemas。
|
|
|
|
约定同其余模块:字段 snake_case、金额/次数存整数。
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from datetime import datetime
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class PangleCallbackOut(BaseModel):
|
|
"""回给穿山甲 GroMore 的回调响应。
|
|
|
|
GroMore 服务端激励回调规范(supportcenter/26240)要求响应体为
|
|
`{"is_verify": bool, "reason": int}`:
|
|
- `is_verify=true` + `reason=0`:校验通过、发放奖励(发奖成功 或 当日已达上限均算"已处理")。
|
|
- `is_verify=false`:不发放,`reason` 带错误码透传客户端 SDK(见 ad.py 的 REASON_*)。
|
|
验签失败由 API 层直接返 403,不走这里。"""
|
|
|
|
is_verify: bool = True
|
|
reason: int = 0
|
|
|
|
|
|
class AdRewardStatusOut(BaseModel):
|
|
"""客户端查今日看广告发奖进度(福利页"看视频赚金币"用)。"""
|
|
|
|
used_today: int = Field(..., description="今日已成功发奖次数")
|
|
daily_limit: int = Field(..., description="每日发奖次数上限")
|
|
remaining: int = Field(..., description="今日剩余可领次数")
|
|
coin_per_ad: int = Field(..., description="看完一个激励视频发的金币")
|
|
round_count: int = Field(
|
|
..., description="本轮(3 次一组)已看次数,0..N-1。客户端可由它判断'刚刚看完一轮'"
|
|
)
|
|
cooldown_until: datetime | None = Field(
|
|
None,
|
|
description="本轮看完后 10 分钟冷却结束时间(UTC ISO),null 表示不在冷却。"
|
|
"冷却是 UX 约束,后端发奖不受影响,客户端 CTA 据此显示 MM:SS 倒计时且不可点",
|
|
)
|
|
|
|
|
|
class TestGrantOut(BaseModel):
|
|
"""[仅本地联调]模拟发奖结果。带上今日进度,客户端可直接据此刷新展示。"""
|
|
|
|
granted: bool = Field(..., description="本次是否真的发了金币(达每日上限则 False)")
|
|
status: str = Field(..., description="granted / capped")
|
|
coin: int = Field(..., description="本次发放金币(capped 时为 0)")
|
|
used_today: int = Field(..., description="今日已成功发奖次数")
|
|
daily_limit: int = Field(..., description="每日发奖次数上限")
|
|
remaining: int = Field(..., description="今日剩余可领次数")
|
|
coin_per_ad: int = Field(..., description="看完一个激励视频发的金币")
|
|
round_count: int = Field(..., description="本轮已看次数,详见 AdRewardStatusOut")
|
|
cooldown_until: datetime | None = Field(
|
|
None, description="本轮冷却结束时间(UTC),详见 AdRewardStatusOut"
|
|
)
|