zzhyyyyy
0db5384bfc
- 反馈二维码:admin feedback_qr 路由/schema/repo,feedback API 返回二维码媒体 - 媒体:core/media 与 config 调整 - 后台数据:queries 增补提现/上报查询,users/withdraw 路由与 schema 扩展 - 每日兑换:新增 daily_exchange_worker 并在 main 挂载 - 广告流奖励:ad_feed_reward 模型/仓储/schema 小改 - 脚本:seed_mock_price_reports / seed_mock_withdraws;新增 add_feed_scene 迁移 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
88 lines
3.3 KiB
Python
88 lines
3.3 KiB
Python
"""admin 用户管理 schemas。"""
|
|
from __future__ import annotations
|
|
|
|
from datetime import datetime
|
|
from typing import Literal
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field
|
|
|
|
|
|
class AdminUserListItem(BaseModel):
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
id: int
|
|
phone: str
|
|
nickname: str | None = None
|
|
register_channel: str
|
|
status: str
|
|
debug_trace_enabled: bool = False
|
|
wechat_openid: str | None = None
|
|
created_at: datetime
|
|
last_login_at: datetime
|
|
|
|
|
|
class AdminUserOverview(BaseModel):
|
|
"""用户 360 概览:基础资料 + 钱包余额 + 各项 count(历史明细走各自分页接口)。"""
|
|
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
user: AdminUserListItem
|
|
coin_balance: int
|
|
cash_balance_cents: int
|
|
total_coin_earned: int
|
|
comparison_total: int
|
|
comparison_success: int
|
|
withdraw_total: int
|
|
withdraw_success_cents: int
|
|
feedback_total: int
|
|
|
|
|
|
class UserRewardStats(BaseModel):
|
|
"""提现详情抽屉「用户统计区」:按时间窗口算的提现 + 看广告行为统计。
|
|
|
|
窗口由 date_from/date_to 决定(都不传 = 注册至今 = 全量);现金余额除外——它是当前快照。
|
|
各「*_cash_cents」是把该来源累计发放金币折算成可提现现金(分):100 金币 = 1 分(COIN_PER_YUAN=10000)。
|
|
eCPM 单位沿用穿山甲原值「分/千次」。
|
|
"""
|
|
|
|
withdraw_success_cents: int # 累计提现(窗口内 success 金额)
|
|
cash_balance_cents: int # 现金余额(当前快照,不随窗口)
|
|
withdraw_total: int # 提现总次数(窗口内全部状态)
|
|
traditional_task_cash_cents: int # 传统任务提现(非广告非人工的金币折现)
|
|
reward_video_count: int # 累计激励视频数(granted 条数)
|
|
reward_video_avg_ecpm: float # 平均激励视频 eCPM(分/千次)
|
|
reward_video_cash_cents: int # 激励视频提现(金币折现)
|
|
feed_count: int # 累计信息流广告数(granted 份数,unit_count 累加)
|
|
feed_avg_ecpm: float # 平均信息流广告 eCPM(分/千次)
|
|
feed_cash_cents: int # 信息流广告提现(金币折现)
|
|
|
|
|
|
class UserCoinRecord(BaseModel):
|
|
"""金币发放记录(提现详情底部表)。source 见 source_label;非广告来源 ecpm 为 None。"""
|
|
|
|
source: str # reward_video / signin_boost / feed / signin
|
|
source_label: str # 激励视频 / 签到膨胀 / 信息流广告 / 签到
|
|
created_at: datetime
|
|
ecpm: str | None = None # 原始 eCPM(分/千次),非广告为 None
|
|
coin: int # 发放金币数
|
|
|
|
|
|
class GrantCoinsRequest(BaseModel):
|
|
amount: int = Field(..., description="金币变动:正=增加,负=扣减(不可为 0)")
|
|
reason: str = Field(..., min_length=1, max_length=128, description="操作原因(必填,入审计)")
|
|
|
|
|
|
class GrantCashRequest(BaseModel):
|
|
amount_cents: int = Field(..., description="现金变动(分):正=增加,负=扣减(不可为 0)")
|
|
reason: str = Field(..., min_length=1, max_length=128, description="操作原因(必填,入审计)")
|
|
|
|
|
|
class SetUserStatusRequest(BaseModel):
|
|
status: Literal["active", "disabled"] = Field(
|
|
..., description="active=解封 / disabled=封禁(注销 deleted 不走此接口)"
|
|
)
|
|
|
|
|
|
class SetDebugTraceRequest(BaseModel):
|
|
enabled: bool = Field(..., description="是否给该用户开「复制调试链接」权限")
|