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>
4.5 KiB
4.5 KiB
platform_stat_display — 首页三统计展示配置
模型
app/models/platform_stat.py| 关联接口 platform-stats / admin-dashboard-display | ← 表索引
客户端首页三个门面数字（帮助用户 / 完成比价 / 累计节省）的展示配置。一行一指标(主键=metric),每指标可独立选 real/manual/random 三种模式。计算逻辑见 app/repositories/platform_stat.py。
单位:倍率用千分比整数(1.000→
1000);total_saved指标的manual_value/random_current单位是分,两个计数指标是个数。
字段
| 列 | 类型 | 约束 / 默认 | 说明 |
|---|---|---|---|
metric |
String(32) | PK | help_users / total_compares / total_saved |
mode |
String(16) | NOT NULL, default real |
real 查库 / manual 手填 / random 随机增长 |
manual_value |
Integer | nullable | manual 模式固定值(基础单位) |
random_mult_min |
Integer | NOT NULL, default 1000 | 倍率下限(千分比,≥1000 保证只增不减) |
random_mult_max |
Integer | NOT NULL, default 1100 | 倍率上限(千分比) |
random_tick_seconds |
Integer | NOT NULL, default 86400 | 更新间隔(秒) |
random_anchor_minutes |
Integer | NOT NULL, default 0 | 触发时刻对齐偏移(距北京 0 点分钟数):天=每日时刻 h*60+m、小时=每小时第几分、分钟=0 |
random_current |
Integer | nullable | 当前展示值(所有模式,基础单位);惰性 tick 改写 |
random_last_tick_at |
DateTime(tz) | nullable | 上次 tick 时刻 |
random_kind |
String(8) | NOT NULL, default mult |
自增长方式:mult ×倍率 / add +绝对增量 |
random_step_min |
Integer | NOT NULL, default 0 | add 模式增量下限(基础单位) |
random_step_max |
Integer | NOT NULL, default 0 | add 模式增量上限(基础单位) |
real_offset |
Integer | NOT NULL, default 0 | real 模式基数偏移(基础单位):展示 = 真实值 + 偏移 |
allow_decrease |
Boolean | NOT NULL, default false | 是否允许展示值下降(默认 false = 只增不减) |
updated_by_admin_id |
Integer | nullable | 最后修改的管理员 |
updated_at |
DateTime(tz) | server_default now(), onupdate now() | 更新时间 |
初始数据(migration 播种)
三行,默认 mode='manual' + 客户端原写死门面值,保证上线前后展示一致:
| metric | manual_value | 含义 |
|---|---|---|
help_users |
12847 | 12847 人 |
total_compares |
86532 | 86532 次 |
total_saved |
3762140 | 37621.40 元 |
统一「定时刷新」(北京钟点对齐)
random_current 现是所有模式的「当前展示值」(不止 random),用户侧 /stats 直接返回它。
- 触发边界 = 北京时间
anchor + k*interval(interval=random_tick_seconds,anchor=random_anchor_minutes*60,sub-day 间隔取anchor % interval作相位)。例:每天 09:00 / 每小时 :30 / 每 5 分刻度。 - 读取(
get_display_values/get_config)时跑_refresh:统计random_last_tick_at→now跨过几个边界 N,N≥1 才刷新:- real →
random_current= 重新查库的真实值 +real_offset(跨多少边界都只取最新),经只增不减护栏。 - manual →
random_current= 当前manual_value,经只增不减护栏。 - random → 按
random_kind走 N 个周期:mult连乘随机倍率(randint(min,max)/1000,恒 ≥1.0)/add连加随机增量(randint(step_min,step_max),≥0)。天然只增。
- real →
- 只增不减护栏(
allow_decrease=false,默认):real/manual 刷新时若新目标值 < 当前random_current,保持当前值不回退(门面忌缩水)。开allow_decrease才允许下降。 - 用边界索引比较,
random_last_tick_at直接记now,不重复计。 - ⚠️ 接受刷新时刻的微小并发竞态(不加行锁):纯门面数字,无业务后果。
random_current首次为空时按当前模式播种(update_config或_refresh兜底);random_initial可立即设起点(不受护栏约束)。
说明
- real 口径仅统计
comparison_record中status='success'的记录(去重用户数 / 记录数)。total_saved的求和只计入0 < saved_amount_cents ≤ 300 元的条目(剔除 bug 异常大值,与轮播口径一致,防一条异常配合「只增不减」永久撑高门面)。 倍率上限收紧为 1.500(单次 ×1.5,原 5.0 太大一跳就假)。- 改配置走 admin
PATCH /admin/api/dashboard-display/{metric},带审计。