feat(invite): 发奖改「比价并下单」+ 好友 is_compared 状态 + DEV 造数/重置接口 #113

Merged
guke merged 2 commits from 7-1ljh-invite-reward-notest into main 2026-07-03 19:01:38 +08:00
2 changed files with 0 additions and 223 deletions
Showing only changes of commit b0e2d7c8d7 - Show all commits
-51
View File
@@ -122,57 +122,6 @@ def my_invitees(
)
@router.post("/seed-fake", summary="[DEV] 给自己塞虚拟好友(测在途/好友列表 UI,仅非生产)")
def seed_fake_invitees(
user: CurrentUser, db: DbSession, pending: int = 3, compared: int = 2
) -> dict:
"""造 pending 个未比价 + compared 个已比价的虚拟好友。生产环境(is_prod)直接 404。
未比价 → 上"在途列表 / 好友列表去提醒";已比价 → 好友列表"邀请成功"、并发真实邀请奖励金
(可提现余额/累计提现也有数)。清理见 DELETE /seed-fake。
"""
if settings.is_prod:
from fastapi import HTTPException
raise HTTPException(status_code=404, detail="Not Found")
n = invite_repo.seed_fake_invitees(db, user.id, pending=max(0, pending), compared=max(0, compared))
return {"status": "ok", "created": n, "pending": pending, "compared": compared}
@router.delete("/seed-fake", summary="[DEV] 清掉自己的虚拟好友(仅非生产)")
def clear_fake_invitees(user: CurrentUser, db: DbSession) -> dict:
if settings.is_prod:
from fastapi import HTTPException
raise HTTPException(status_code=404, detail="Not Found")
n = invite_repo.clear_fake_invitees(db, user.id)
return {"status": "ok", "removed": n}
@router.post("/dev-reset", summary="[DEV] 把固定测试号打回出厂态,便于反复当新用户测发奖(仅非生产)")
def dev_reset(db: DbSession) -> dict:
"""把 TEST_ACCOUNT_PHONE 这个固定测试号清成"从没被邀请/没下过单"的新用户态。
⚠️ 无需鉴权(它只按配置里的测试号操作,不依赖登录态,方便测试脚本第一步直接调)。
双重门控:生产环境(is_prod)404;测试号总开关(TEST_ACCOUNT_PHONE)没配置 → 400。
故它永远只能动那一个配置好的测试号,动不了任意真实用户。
清什么见 repositories/invite.dev_reset_test_account(全清 + 刷 created_at 骗过 72h 闸)。
调完该测试号即可再次绑定 + 下单上报,重新触发一次邀请发奖。
"""
from fastapi import HTTPException
if settings.is_prod:
raise HTTPException(status_code=404, detail="Not Found")
phone = settings.test_account_phone
if not phone:
raise HTTPException(
status_code=400,
detail="测试号未启用:请在 .env 配 TEST_ACCOUNT_PHONE=11111111111 并重启服务",
)
cleared = invite_repo.dev_reset_test_account(db, phone)
logger.info("invite dev-reset phone=%s cleared=%s", phone, cleared)
return {"status": "ok", "phone": phone, "cleared": cleared}
@router.post(
"/landing-track",
response_model=LandingTrackOut,
-172
View File
@@ -312,178 +312,6 @@ def get_invitees(
return items, int(total), has_more
# ===== 开发用:塞虚拟好友(仅非生产,方便真机测在途/好友列表 UI)=====
def seed_fake_invitees(db: Session, inviter_id: int, *, pending: int = 3, compared: int = 2) -> int:
"""给 inviter 造 pending 个"未比价"+ compared 个"已比价"的虚拟被邀请好友(仅测试用)。
造真实 User(随机手机号/昵称/头像)+ InviteRelation;已比价的顺带发邀请奖励金(走真实入账,
这样"可提现余额/累计"也有数)。仅非生产环境开放(endpoint 层用 is_prod 挡)。返回新建好友数。
"""
from datetime import datetime, timedelta, timezone
from app.repositories import user as user_repo
# 造点像样的中文昵称 + 打包进 APK 的真人头像(asset://,客户端转 file:///android_asset/ 本地加载,
# 离线必显、不依赖外网,避免 dicebear 这类国外图在国内加载失败成空白)。头像图见客户端
# app/src/main/assets/avatars/fake/p0..p7.jpg,按序号轮询分配。
names = ["小满同学", "一罐可乐Colour", "草原上感受宁静者", "晴天小豆", "momo", "隔壁老王",
"爱吃辣的猫", "月半子", "阿柴", "橘子汽水"]
FAKE_AVATAR_COUNT = 8 # 与客户端 assets/avatars/fake/ 图数一致
created = 0
total = pending + compared
now = datetime.now(timezone.utc)
for i in range(total):
is_compared = i >= pending
# 唯一手机号:99 开头 + 9 位随机(避开真实号段,不与真人撞)
phone = "99" + "".join(secrets.choice("0123456789") for _ in range(9))
nickname = names[i % len(names)] + secrets.choice(["", "", "_", str(secrets.randbelow(99))])
u = User(
phone=phone,
username=user_repo._gen_unique_username(db),
nickname=nickname,
register_channel="fake_seed",
avatar_url=f"asset://avatars/fake/p{i % FAKE_AVATAR_COUNT}.jpg", # 打包头像,轮询分配
status="active",
)
db.add(u)
db.flush() # 拿 u.id
rel = InviteRelation(
inviter_user_id=inviter_id,
invitee_user_id=u.id,
channel="fake_seed",
status="effective",
inviter_coin=0,
invitee_coin=0,
# 邀请时间错开,便于看"时间近→远"排序
created_at=(now - timedelta(hours=i * 6)).replace(tzinfo=None),
)
if is_compared:
# 已比价 → 走真实"好友比价发奖"链路:标记 + 真发 ¥2 进邀请奖励金账户(invite_cash),
# 让"可提现余额/累计/人数/流水/提现记录"全链路真实变化,可验证功能正确。
# (钱只进 invite_cash,不碰金币现金账户;清理 DELETE /seed-fake 会原路退回。)
rel.compare_reward_granted = True
rel.compare_reward_cents = rewards.INVITE_COMPARE_REWARD_CENTS
rel.compare_rewarded_at = now
db.add(rel)
db.flush()
if is_compared:
crud_wallet.grant_invite_cash(
db, inviter_id, rewards.INVITE_COMPARE_REWARD_CENTS,
biz_type="invite_reward", ref_id=str(u.id), remark="虚拟好友比价奖励(测试)",
)
created += 1
db.commit()
return created
def clear_fake_invitees(db: Session, inviter_id: int) -> int:
"""删掉该 inviter 名下所有 channel=fake_seed 的虚拟好友关系 + 对应虚拟 User(测试收尾)。
⚠️已发过邀请奖励金的假关系(compare_reward_granted),删除时必须把当初 grant 的钱**原路退回**
(负数 grant_invite_cash),否则假好友清掉了、发进钱包的奖励金却残留 → invite_cash 余额脏账。
"""
rels = db.execute(
select(InviteRelation).where(
InviteRelation.inviter_user_id == inviter_id,
InviteRelation.channel == "fake_seed",
)
).scalars().all()
n = 0
for rel in rels:
# 先退钱:该关系当初发过奖励金 → 反向扣回同额,钱包不留残
if rel.compare_reward_granted and rel.compare_reward_cents:
crud_wallet.grant_invite_cash(
db, inviter_id, -rel.compare_reward_cents,
biz_type="invite_reward", ref_id=str(rel.invitee_user_id),
remark="虚拟好友清理·奖励金退回(测试)",
)
u = db.get(User, rel.invitee_user_id)
db.delete(rel)
if u is not None and u.register_channel == "fake_seed":
db.delete(u)
n += 1
db.commit()
return n
def dev_reset_test_account(db: Session, phone: str) -> dict:
"""[DEV] 把固定测试号打回"从没被邀请/没下过单"的出厂态,以便反复当新用户测发奖。
清理范围(全清,冰 2026-07-02 拍板):该 user 的
- invite_relation(作为被邀请人的那条 = 解 already_bound;作为邀请人的那些)
- invite_cash_transaction / coin_account 三个余额归零(invite_cash / coin / cash)
- savings_record(= 解 order/report 的 duplicated 幂等)
- invite_fingerprint(作为邀请人落的指纹)
- coin_transaction / cash_transaction / withdraw_order(彻底出厂)
并把 user.created_at 刷成 now(UTC)—— 骗过 bind 的"新用户 72h 窗口"闸(_is_new_user),
否则该号第一次跑之后 created_at 固定、过 72h 即使清了关系也会 not_eligible。
仅供 dev-reset 端点调用(端点已 is_prod→404 + 只认配置的测试号)。返回各表清理条数。
user 不存在(还没登录过)→ 返回全 0,不报错(下一步登录会新建,天然新号)。
"""
from datetime import datetime, timezone
from app.models.invite_fingerprint import InviteFingerprint
from app.models.savings import SavingsRecord
from app.models.wallet import (
CashTransaction,
CoinAccount,
CoinTransaction,
InviteCashTransaction,
WithdrawOrder,
)
user = db.execute(select(User).where(User.phone == phone)).scalar_one_or_none()
if user is None:
return {"user_found": False}
uid = user.id
def _del(model, whereclause) -> int:
rows = db.execute(select(model).where(whereclause)).scalars().all()
for r in rows:
db.delete(r)
return len(rows)
cleared = {
"user_found": True,
"user_id": uid,
"invite_relation_as_invitee": _del(
InviteRelation, InviteRelation.invitee_user_id == uid
),
"invite_relation_as_inviter": _del(
InviteRelation, InviteRelation.inviter_user_id == uid
),
"invite_cash_transaction": _del(
InviteCashTransaction, InviteCashTransaction.user_id == uid
),
"coin_transaction": _del(CoinTransaction, CoinTransaction.user_id == uid),
"cash_transaction": _del(CashTransaction, CashTransaction.user_id == uid),
"withdraw_order": _del(WithdrawOrder, WithdrawOrder.user_id == uid),
"invite_fingerprint": _del(
InviteFingerprint, InviteFingerprint.inviter_user_id == uid
),
"savings_record": _del(SavingsRecord, SavingsRecord.user_id == uid),
}
# 余额账户归零(保留行,只清三个余额;没有账户行则跳过)
acc = db.get(CoinAccount, uid)
if acc is not None:
acc.invite_cash_balance_cents = 0
acc.coin_balance = 0
acc.cash_balance_cents = 0
cleared["coin_account_zeroed"] = True
else:
cleared["coin_account_zeroed"] = False
# 刷 created_at 骗过 72h 新用户闸(存 naive UTC,与登录新建 user 的写法一致)
user.created_at = datetime.now(timezone.utc).replace(tzinfo=None)
cleared["created_at_refreshed"] = True
db.commit()
return cleared
# ===== 指纹归因(剪贴板兜底,见 [[invite-three-tasks]] 任务 3)=====
def record_fingerprint(