"""首页平台级展示数据 schemas(客户端首页门面数字)。"""
from __future__ import annotations

from pydantic import BaseModel


class PlatformStatsOut(BaseModel):
    """首页三统计。total_saved 为分,客户端 ÷100 显示「元」。"""

    help_users: int  # 帮助用户(人)
    total_compares: int  # 完成比价(次)
    total_saved_cents: int  # 累计节省(分)


class SavingsFeedItem(BaseModel):
    """首页轮播一条。time 为北京时间 HH:MM:SS。"""

    masked_user: str  # 脱敏用户名,手机尾号(138****5678)或中文昵称(省钱**)混合风格
    saved_amount_cents: int  # 节省(分),客户端 ÷100 显示「x.xx 元」
    time: str


class SavingsFeedOut(BaseModel):
    items: list[SavingsFeedItem]


class AppFlagsOut(BaseModel):
    """客户端拉取的运营 feature flag(不鉴权,登录前也能拉)。客户端缓存后按需读。"""

    comparing_ad_enabled: bool  # 比价/领券期是否展示信息流广告(远程 kill-switch)