OuYingJun1024
179303d875
把首页门面数据的「运营可配」部分代码统一加 ops_ 前缀,与运营语义对齐: - 模型 PlatformStatDisplay→OpsStatConfig(表 platform_stat_display→ops_stat_config)、 MarqueeSeed→OpsMarqueeSeed(表 marquee_seed→ops_marquee_seed) - repo platform_stat→ops_stat、marquee→ops_marquee - admin schema/router dashboard_display→ops_stat_config、marquee_seed→ops_marquee_seed(schema 类 Ops*) - 审计 action/target_type 同步成 ops_* - 引用方(models/__init__、admin/main、api/v1/platform)更 import;platform 用户侧门面保留命名 - 迁移 opsrename01 仅改表名(可逆);路由 URL 与 API 文档文件名不变(前端/客户端无感) - 文档:db 文档重命名 + API 文档/索引同步 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
4.6 KiB
4.6 KiB
ops_stat_config — 首页三统计展示配置
模型
app/models/ops_stat_config.py| 关联接口 platform-stats / admin-dashboard-display | ← 表索引
客户端首页三个门面数字（帮助用户 / 完成比价 / 累计节省）的展示配置。一行一指标(主键=metric),每指标可独立选 real/manual/random 三种模式。计算逻辑见 app/repositories/ops_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 太大一跳就假)。- 表名
ops_stat_config(opsrename01迁移由platform_stat_display改名,与代码 ops_ 前缀对齐;路由/admin/api/dashboard-display不变)。 - 改配置走 admin
PATCH /admin/api/dashboard-display/{metric},带审计。