OuYingJun1024
c9578f5ba2
轮播 feed(marquee_seed,全新): - 新增 marquee_seed 表 + admin CRUD/批量生成/预览;真实比价记录(success 且 0<省额≤300元、按 user 去重)优先,种子兜底混播 - 种子为「生成规则」:用户名可空(空则按脱敏格式随机合成、避开同屏撞名),金额改 [min,max] 区间随机,feed 公平随机抽取(不看 sort_order) - 新增 GET /api/v1/platform/savings-feed(无鉴权);展示时间统一刷新为相对当前的最近时刻 三统计配置(platform_stat_display)增强: - 自增长新增「绝对增量」方式(random_kind=add,每周期 +[step_min,step_max]) - 真实值模式加基数偏移(real_offset,展示=真实+偏移) - 只增不减护栏(allow_decrease 默认关,real/manual 不回退防门面缩水) - 累计节省 real 口径只计 0<单条≤300元防虚高;倍率上限 5.0→1.5;PATCH 支持 apply_now 立即更新 迁移:marquee_seed_table / marquee_seed_range / platform_stat_growth_offset(均可逆,已验证) 文档:API/DB 对应文档同步更新 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
38 lines
1.4 KiB
Python
38 lines
1.4 KiB
Python
"""首页平台级展示数据 endpoint(全平台门面数字,**不鉴权**——登录前首页也要展示)。
|
|
|
|
路由前缀 `/api/v1/platform`:
|
|
GET /stats 首页三统计(帮助用户 / 完成比价 / 累计节省),按运营后台配的模式算。
|
|
|
|
展示模式(real/manual/random,每指标独立)与计算逻辑见 app/repositories/platform_stat.py。
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
|
|
from fastapi import APIRouter, Query
|
|
|
|
from app.api.deps import DbSession
|
|
from app.repositories import marquee as marquee_crud
|
|
from app.repositories import platform_stat as crud
|
|
from app.schemas.platform import PlatformStatsOut, SavingsFeedItem, SavingsFeedOut
|
|
|
|
logger = logging.getLogger("shagua.platform")
|
|
|
|
router = APIRouter(prefix="/api/v1/platform", tags=["platform"])
|
|
|
|
|
|
@router.get("/stats", response_model=PlatformStatsOut, summary="首页三统计(全平台门面数字)")
|
|
def stats(db: DbSession) -> PlatformStatsOut:
|
|
v = crud.get_display_values(db)
|
|
return PlatformStatsOut(
|
|
help_users=v["help_users"],
|
|
total_compares=v["total_compares"],
|
|
total_saved_cents=v["total_saved"],
|
|
)
|
|
|
|
|
|
@router.get("/savings-feed", response_model=SavingsFeedOut, summary="首页轮播 feed(真实+种子混播)")
|
|
def savings_feed(db: DbSession, limit: int = Query(8, ge=1, le=30)) -> SavingsFeedOut:
|
|
items = marquee_crud.get_feed(db, limit=limit)
|
|
return SavingsFeedOut(items=[SavingsFeedItem(**it) for it in items])
|