# “我的”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. 奖励到账后光点余额同步变化