OuYingJun1024
cfeacb4bab
- 新表 platform_stat_display:每个指标可选 real/manual/random 三种 展示模式,含建表 + anchor_minutes 两个 alembic migration - 公开接口 GET /api/v1/platform/stats(无鉴权门面数字,登录前可读) - 运营后台 GET/PATCH /admin/api/dashboard-display 配置展示模式 - 配套 model/repository/schema,注册 router(app/main+admin/main), 导出 model,补 docs(api/database 索引及 3 篇详情) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
3.3 KiB
3.3 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 | random 当前累积值(基础单位);惰性 tick 改写 |
random_last_tick_at |
DateTime(tz) | nullable | 上次 tick 时刻 |
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= 重新查库的真实值(跨多少边界都只取最新)。 - manual →
random_current= 当前manual_value。 - random →
random_current连乘 N 次随机倍率(randint(min,max)/1000,恒 ≥1.0 只增不减)。
- real →
- 用边界索引比较,
random_last_tick_at直接记now,不重复计。 - ⚠️ 接受刷新时刻的微小并发竞态(不加行锁):纯门面数字,无业务后果。
random_current首次为空时按当前模式播种(update_config或_refresh兜底);random_initial可立即设起点。
说明
- real 口径仅统计
comparison_record中status='success'的记录(去重用户数 / 记录数 /saved_amount_cents求和)。 - 改配置走 admin
PATCH /admin/api/dashboard-display/{metric},带审计。