11

docs/prd/MY_TAB_INVITE_FRIENDS_PRD_2026-04-16.md

@@ -0,0 +1,167 @@
+# “我的”Tab 邀请好友 PRD
+
+更新时间：`2026-04-16`
+
+## 0. 目标
+
+把“邀请好友”做成正式的拉新入口，首期目标是：
+
+1. 用户能拿到自己的专属邀请码或邀请链接
+2. 能方便地复制或分享
+3. 邀请成功后双方奖励可核算
+
+---
+
+## 1. 当前现状与问题
+
+当前“邀请好友”仅是快捷入口按钮，没有：
+
+1. 专属邀请码
+2. 分享载体
+3. 邀请关系记录
+4. 奖励发放规则
+
+因此无法真正产生拉新闭环。
+
+---
+
+## 2. 本期范围
+
+## 2.1 本期要做
+
+1. 邀请好友弹窗
+2. 专属邀请码与邀请链接
+3. 复制、系统分享、二维码三种分享方式
+4. 邀请进度与奖励状态
+
+## 2.2 本期不做
+
+1. 多级分销
+2. 战队拉新活动
+3. 社交平台深度回流分析
+
+---
+
+## 3. 业务规则
+
+## 3.1 邀请主体
+
+只有正式激活账号可以邀请好友。
+
+待绑定手机号账号不可邀请。
+
+## 3.2 邀请标识
+
+每个账号拥有：
+
+1. 一个固定邀请码
+2. 一个可分享邀请链接
+
+邀请码与账号一一绑定，不允许频繁重置。
+
+## 3.3 邀请成功判定
+
+被邀请用户满足以下条件才算成功：
+
+1. 首次注册或首次完成正式激活
+2. 首次绑定邀请码成功
+3. 完成至少一次有效进入游戏或创建世界动作
+
+这样可以过滤纯注册刷量。
+
+## 3.4 奖励
+
+首期奖励建议采用可控方案：
+
+1. 邀请人获得叙世币
+2. 被邀请人获得新手奖励
+
+所有奖励必须走台账，不允许前端本地加值。
+
+---
+
+## 4. 详细设计
+
+## 4.1 页面内容
+
+邀请弹窗展示：
+
+1. 我的邀请码
+2. 复制按钮
+3. 系统分享按钮
+4. 二维码展示
+5. 已邀请人数
+6. 待达成奖励数量
+7. 已到账奖励
+
+## 4.2 交互
+
+1. 点击复制
+   - 复制邀请码和邀请链接
+2. 点击分享
+   - 触发浏览器分享或复制兜底
+3. 点击二维码
+   - 放大查看
+
+---
+
+## 5. 后端设计
+
+## 5.1 数据模型
+
+建议新增：
+
+### `user_invite_codes`
+
+- `user_id`
+- `invite_code`
+- `status`
+- `created_at`
+
+### `user_referral_relations`
+
+- `inviter_user_id`
+- `invitee_user_id`
+- `invite_code`
+- `bound_at`
+- `activated_at`
+- `reward_status`
+
+### `user_reward_ledger`
+
+- `user_id`
+- `reward_type`
+- `amount`
+- `source_type`
+- `source_id`
+- `created_at`
+
+## 5.2 接口
+
+### `GET /api/referrals/invite-center`
+
+返回：
+
+- 邀请码
+- 邀请链接
+- 分享二维码地址
+- 邀请统计
+- 奖励统计
+
+---
+
+## 6. 前端实现要求
+
+1. 邀请入口采用轻量弹窗，不跳新系统页
+2. 邀请码展示必须可直接复制
+3. 二维码图片由后端或统一服务生成
+4. 所有奖励数字以服务端返回为准
+
+---
+
+## 7. 验收标准
+
+1. 用户能看到自己的邀请码与邀请链接
+2. 可以一键复制或分享
+3. 邀请成功后能看到正确统计
+4. 奖励到账后叙世币余额同步变化