邀请注册运维管控

一、插件简介

邀请注册支持免费专属码与付费批量码。可强制邀请码才能注册；可要求被邀请人完成手机或邮箱验证后才计成功并发放双边注册积分。被邀请人首次充值金币可按比例返点。积分/金币名称读取支付中心，未填写时默认「积分」「金币」。

二、核心能力

三、依赖与安装

1. 将插件目录置于 plugins/invite/。
2. 在应用中心安装「邀请注册」。
3. 安装时创建 invite_code、invite_relation、invite_purchase、invite_code_item 表，注册后台「邀请记录」菜单。
4. 硬依赖：社区插件（注册、会员中心、积分/金币账户）。
5. 软依赖：支付中心（游客扫码购码、金币充值、币种名称）；短信/邮件或社区校验字段（开启「邀请成功需校验」时需能完成手机或邮箱验证）。

四、应用中心基础配置

在应用中心 → 邀请注册 → 配置，字段来自 configSchema。本插件没有单独「邀请设置」菜单，规则都在这里：

五、后台重点配置

奖励、强制码、付费、校验均在应用中心配置。后台菜单只做记录查询：

• 邀请记录 /admin/invite_log：邀请人、被邀请人、邀请码、注册积分、成功/待校验、首充返点
• 购买记录 /admin/invite_purchase：从邀请记录页进入，不单独占一级菜单。含登录余额购买与游客扫码待支付/已支付

六、前台用户流程

1. 免费模式：登录「我的邀请」，复制专属链接或邀请码发给好友；好友打开 /invite/r/{code} 或注册时填写该码。
2. 付费模式：登录后按「售价 / 每份枚数」购买；未登录可在注册页邀请码处扫码购码。每枚码只用一次。
3. 结算：未开校验则注册即成功并发积分；开启校验则先记待校验，手机或邮箱验证通过后再发积分、计入成功人数。
4. 首充返点：仅邀请已成功，且该用户第一次金币充值到账时，按绑定关系里保存的比例返金币，只返一笔。
5. 页面展示成功人数、累计积分；开启校验时另显示待校验人数；付费模式显示可用码数量。

七、后台审核与运维

前台路由

八、特殊说明

• 一人一关系：被邀请人只能绑定一次邀请关系。
• 免费码 vs 付费码：免费模式每人一条长期码；付费模式关闭专属无限码，改为购买一次性码。不要在运营中途频繁开关，以免用户理解混乱。
• 待校验：reward_status 0 待校验 / 1 已成功。待校验不计成功人数、不发积分、不发首充返点。
• 游客购码：扫码订单可挂 guest，支付完成后得到码再去注册。
• 返点币种：注册奖发积分，首充返点发金币，按到账金币向下取整。
• 名称约定：售价单位、奖励文案随支付中心积分/金币名称变化。

九、推荐上线清单

• 开启「启用邀请注册」，确认是否强制邀请码、是否需要校验
• 填好双边注册积分（可为 0）与首充返点比例
• 若用付费邀请：核对售价、货币、每份枚数，并确认支付中心通道（游客扫码）
• 走通：分享链接 → 注册 →（如需）验证手机/邮箱 → 积分到账 → 首次充金币返点只发生一次
• 抽检强制邀请码时无码无法注册、错误码无法注册
• 配置排行榜条数；虚拟榜仅作展示补充
• 到支付中心确认积分/金币展示名称

十、常见问题

Q：注册了为什么不算成功？ 若开启「邀请成功需校验」，须完成手机或邮箱任一验证。后台邀请记录会显示「待校验」。

Q：积分什么时候到账？ 未开校验：绑定邀请关系时发放。开启校验：验证通过后才发放。奖励为 0 则不会入账。

Q：首充没有返点？ 须开启返点、邀请已成功、本次是该用户第一笔金币充值到账，且比例大于 0。第二次充值不再返。

Q：找不到专属链接？ 已开启付费邀请时，前台改为购买批量码，不再提供无限次专属链接。

Q：游客怎么买码？ 开启付费邀请且支付中心可用时，在注册页邀请码输入处按提示扫码；登录用户也可在「我的邀请」用余额购买。

Q：必须填邀请码但用户没有码？ 关闭「强制邀请码注册」，或准备付费购码/运营发放码。

Q：价格单位名称不对？ 到支付中心修改积分名称、金币名称后刷新。

Q：找不到购买记录菜单？ 已并入「邀请记录」，地址为 /admin/invite_purchase。