Files
shaguabijia-app-server/docs/database/ops_marquee_seed.md
T
ouzhou 766666601e feat(platform): 首页门面三统计 + 运营后台展示模式配置 (#22)
Co-authored-by: OuYingJun1024 <1034284404@qq.com>
Reviewed-on: #22
Reviewed-by: marco <marco@wonderable.ai>
Co-authored-by: ouzhou <ouzhou@wonderable.ai>
Co-committed-by: ouzhou <ouzhou@wonderable.ai>
2026-06-07 23:17:27 +08:00

2.4 KiB

ops_marquee_seed — 首页轮播种子(生成规则)

模型 app/models/ops_marquee_seed.py | 关联接口 platform-savings-feed / admin-marquee-seeds | ← 表索引

首页「用户****xxx 比价后节省 xx 元」轮播的兜底假数据。轮播真实数据源是全平台比价记录,真实不足 N 条时用本表启用的种子补齐「混播」,保证轮播不空。种子是「生成规则」而非死记录:用户名可空(→随机合成)、金额是区间(→随机取值)。运营后台增删改。逻辑见 app/repositories/ops_marquee.py

字段

类型 约束 / 默认 说明
id Integer PK, autoincrement
masked_user String(64) NULL 可空 脱敏用户名,如 用户********a52(整串存)。留空 → feed 展示时按脱敏格式随机合成(用户********+3 位 hex,避开同屏撞名),风格与真实条一致、永不穿帮
min_cents Integer NOT NULL 节省金额区间下限(分)
max_cents Integer NOT NULL 节省金额区间上限(分);feed 每次在 [min,max] 随机取值,固定金额则 min==max
enabled Boolean NOT NULL, default true 停用的不参与混播
sort_order Integer NOT NULL, default 0 仅后台列表排序(小在前);feed 是公平随机抽取,不看此字段
created_at DateTime(tz) server_default now() 创建时间

初始数据(migration 播种)

6 条 = 客户端原写死的轮播条目(金额转分、min==max 固定值):a52/18.60、k89/42.40、m71/7.90、p46/156.30、r93/23.50、c28/89.40。 (marquee_seed02 迁移把旧单值列 saved_amount_cents 拆成 min_cents=max_cents,并把 masked_user 改为可空;opsrename01 迁移把表名由 marquee_seed 改为 ops_marquee_seed,与代码 ops_ 前缀对齐,路由 /admin/api/marquee-seeds 不变。)

说明

  • feed 取真实(comparison_record success 且 0<saved≤300 元,按 user 去重)优先,不足用本表启用种子公平随机抽取补齐(不再固定取前 N,所有种子都有机会露出)。种子用户名空则随机合成、金额区间随机取值。展示时间统一刷新成「相对现在的最近时刻」(详见 platform-savings-feed)。
  • 改种子走 admin /admin/api/marquee-seeds CRUD + 批量生成(/bulk)+ 预览(/preview),写操作带审计。