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.9 KiB
4.9 KiB
傻瓜比价 App 后端 — 数据库表文档(索引)
数据库:SQLite 起步(
data/app.db),生产可切 PostgreSQL(改DATABASE_URL)。 ORM:SQLAlchemy 2.0(app/models/),迁移:Alembic(alembic/versions/,render_as_batch兼容 SQLite)。 金额字段一律存整数:金币=个数,现金=分(*_cents)。时间列DateTime(timezone=True)。 最后更新:2026-06-06(补全 19 张表 + 新增 OVERVIEW 总览)
🧭 先看 OVERVIEW.md — 表 × 功能 × 关系:跨表的「每块功能用哪些表 / 什么操作写哪张表 / 表间 join key」都在那;本页只做单表索引,点进每张表的详情看字段级说明。
表总览(20 张业务表 + alembic_version 框架表)
账号 / 反馈
| 表 | 用途 | 模型 | 文档 |
|---|---|---|---|
user |
用户(登录主体);几乎所有表的外键宿主 | models/user.py |
详情 |
feedback |
用户帮助与反馈(含截图) | models/feedback.py |
详情 |
钱包 / 福利(看广告赚钱闭环)
| 表 | 用途 | 模型 | 文档 |
|---|---|---|---|
coin_account |
金币+现金余额快照(一用户一行) | models/wallet.py |
详情 |
coin_transaction |
金币流水账本 | models/wallet.py |
详情 |
cash_transaction |
现金流水账本(分) | models/wallet.py |
详情 |
withdraw_order |
提现单(现金→微信零钱,含人工审核态) | models/wallet.py |
详情 |
wechat_transfer_authorization |
微信免确认转账授权(一用户一行) | models/wallet.py |
详情 |
signin_record |
签到记录(7 天循环) | models/signin.py |
详情 |
user_task |
一次性任务领取去重 | models/task.py |
详情 |
ad_reward_record |
看激励视频发奖记录(S2S 回调,trans_id 幂等) | models/ad_reward.py |
详情 |
ad_watch_log |
看广告观看时长(每日 50min 防刷主闸) | models/ad_watch_log.py |
详情 |
ad_ecpm_record |
广告展示 eCPM 上报(收益对账) | models/ad_ecpm.py |
详情 |
比价 / 省钱
| 表 | 用途 | 模型 | 文档 |
|---|---|---|---|
comparison_record |
比价记录(每次比价完整明细) | models/comparison.py |
详情 |
comparison_milestone_claim |
比价战绩里程碑领取记录 | models/comparison_milestone.py |
详情 |
savings_record |
省钱记录(profile 省钱战绩源;真实下单归因 + demo) | models/savings.py |
详情 |
price_report |
上报更低价(众包纠偏,人工审核发奖) | models/price_report.py |
详情 |
首页门面数据
| 表 | 用途 | 模型 | 文档 |
|---|---|---|---|
platform_stat_display |
首页三统计展示配置(real/manual/random) | models/platform_stat.py |
详情 |
marquee_seed |
首页轮播种子(真实不足时兜底混播) | models/marquee_seed.py |
详情 |
运营后台 admin(独立子应用 app/admin/,独立鉴权)
| 表 | 用途 | 模型 | 文档 |
|---|---|---|---|
admin_user |
管理员账号(独立 JWT + RBAC) | models/admin.py |
详情 |
admin_audit_log |
操作审计日志(只追加) | models/admin.py |
详情 |
app_config |
运营可配置项(覆盖 rewards 常量) | models/app_config.py |
详情 |
通用约定
- 主键:
idInteger autoincrement;例外:coin_account/wechat_transfer_authorization的user_id既是主键也是外键(一用户一行),app_config用key作主键。 - 外键:所有用户维度表
user_id→user.id且建 index;admin_audit_log.admin_id→admin_user.id;price_report.comparison_record_id→comparison_record.id。 - 金额:整数;金币计数,现金/价格存「分」(
*_cents)。汇率10000 金币 = 1 元 = 100 分。 - 时间:
created_at等用DateTime(timezone=True)+server_default=func.now();业务"今天"按北京时间(core/rewards.cn_today),跨天计数用「日期串」列(reward_date/watch_date/report_date,String(10)存YYYY-MM-DD)等值查,不在 SQL 里做跨时区 date 比较(SQLite 不可靠)。 - JSON 列:
JSON().with_variant(JSONB(), "postgresql")—— PG 上 JSONB(可建 GIN 索引),SQLite 退化为通用 JSON(否则create_all编译报错);feedback.images例外,用通用JSON。 - 分页:列表接口统一游标式(
id倒序,cursor=上页最后一条 id,返回next_cursor)。 - 迁移:改表必写 alembic 迁移并保持单 head;改表/建表同时更新本目录对应文档(一表一文件)+ OVERVIEW.md。