marco
b4780e256e
- 重写 15 张已有表文档:每张补「用在 App 哪/增删改查时机/字段取值/join key 指向」 - 新建 4 张缺失表文档:wechat_transfer_authorization / ad_watch_log / price_report / app_config - 新增 OVERVIEW.md:功能↔表映射 + 写入路径 + 表间关系(含语义 join key)+ ER + 资金模型 - README 索引补齐到 19 表 + 置顶 OVERVIEW + 通用约定补全 - 纠正过时:withdraw_order(reviewing/rejected/user_name)、savings_record(/order/report 真实写入)、coin_transaction(biz_type) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.5 KiB
2.5 KiB
coin_account — 金币 + 现金余额快照
模型
app/models/wallet.py· 仓库app/repositories/wallet.py· 接口 wallet-account · ← 索引 · 总览
一用户一行的余额快照,App「资产卡 / 钱包」读它展示。每次余额变动都另写一笔流水(coin_transaction / cash_transaction)并记 balance_after,出问题逐笔回溯。user_id 既是主键也是外键(一对一)。详见 总览 §四 资金模型。
用在哪 / 增删改查
- C(插入):
get_or_create_account懒建 —— 用户第一次发生金币动作(签到/任务/看广告/admin 发币/兑换/提现)时建一行空账户(全 0)。从未发生过金币动作的用户没有这行(读接口按 0 兜底)。 - U(更新):几乎所有钱相关动作都更新它 —— 发金币(签到/任务/看广告/admin)
coin_balance +=、兑现金coin_balance −= / cash_balance_cents +=、发起提现cash_balance_cents −=(带条件原子 UPDATE 防超额)、提现退款cash_balance_cents +=。 - D:无。
- R:
GET /wallet/account(钱包余额卡)、admin 用户 360 概览。
字段
| 列 | 类型 | 约束 / 默认 | 说明(取值 / join) |
|---|---|---|---|
user_id |
Integer | PK + FK→user.id | 用户(一用户一行);既是主键也是外键 |
coin_balance |
Integer | NOT NULL, default 0 | 当前金币余额(个数);= 历次 coin_transaction.amount 之和 |
cash_balance_cents |
Integer | NOT NULL, default 0 | 当前现金余额(分);= 历次 cash_transaction.amount_cents 之和 |
total_coin_earned |
Integer | NOT NULL, default 0 | 累计赚取金币(只增不减,仅正向 grant 累加),用于"历史总收益"展示 |
updated_at |
DateTime(tz) | server_default now(), onupdate now() | 最后更新时间 |
关系 / Join Key
user_id→user.id(一对一)。- 与
coin_transaction/cash_transaction无外键直连,靠user_id关联;快照 = 流水累加值,流水的balance_after*应等于当时的快照余额(对账依据)。
索引与约束
- PK
user_id(同时是 FK→user.id)。
注意
- 唯一发金币入口
wallet.grant_coins:更新本表 + 写coin_transaction,不 commit,由调用方同事务提交(发币与业务记录原子化)。 - 扣现金用
UPDATE ... WHERE cash_balance_cents >= amount原子条件扣减,并发/重试不会超额。