From b0e2d7c8d7e9341682c3cfcf61a55009a0c2ac78 Mon Sep 17 00:00:00 2001 From: no_gen_mu Date: Fri, 3 Jul 2026 18:01:28 +0800 Subject: [PATCH] =?UTF-8?q?refactor(invite):=20=E7=A7=BB=E9=99=A4=20DEV=20?= =?UTF-8?q?=E9=80=A0=E6=95=B0/=E9=87=8D=E7=BD=AE=E6=8E=A5=E5=8F=A3(seed-fa?= =?UTF-8?q?ke=E3=80=81dev-reset)=E4=B8=8D=E5=85=A5=E5=BA=93?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 评审意见:POST/DELETE /invite/seed-fake、POST /invite/dev-reset 三个接口标注 [DEV]、 且 dev-reset 无鉴权,是本地测试用的造数/重置口子,不应合进 main。 删掉两处: - app/api/v1/invite.py: 三个端点 handler - app/repositories/invite.py: seed_fake_invitees / clear_fake_invitees / dev_reset_test_account 保留 is_compared 好友已比价状态、发奖改「比价并下单」、每日兑换定时器锁北京时区等产品改动。 纯删除,不影响其余接口(/me /invitees /bind /landing-track 均在)。 Co-Authored-By: Claude Opus 4.8 --- app/api/v1/invite.py | 51 ----------- app/repositories/invite.py | 172 ------------------------------------- 2 files changed, 223 deletions(-) diff --git a/app/api/v1/invite.py b/app/api/v1/invite.py index 3fe534b..5bbc99e 100644 --- a/app/api/v1/invite.py +++ b/app/api/v1/invite.py @@ -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, diff --git a/app/repositories/invite.py b/app/repositories/invite.py index ff7c2da..5af08c5 100644 --- a/app/repositories/invite.py +++ b/app/repositories/invite.py @@ -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(