邀请注册运维

一、插件简介

邀请注册插件为社区提供裂变增长能力：用户生成专属邀请码/链接，好友注册成功后双方获得积分奖励；可选付费购买邀请码、强制邀请码注册、首充金币返点等。

URL 后缀说明：示例 /invite.html；后缀继承社区 url_suffix（默认 html）。

二、核心能力

三、依赖与安装

1. 必须先安装并启用 `community`（BBS社区）——注册流程、积分体系、会员中心均依赖社区。
2. 软依赖 payment：付费邀请的现金支付（沙箱/正式支付）。
3. 软依赖 message：部分通知场景（非必须）。
4. 安装执行 install.sql，创建 invite_code、invite_relation、invite_purchase、invite_code_item 等表。
5. 后台注册「邀请记录」菜单（含购买记录权限节点）。

四、应用中心基础配置

字段来自 InvitePlugin::configSchema()：

五、后台/重点配置

无独立配置页，均在应用中心完成。

后台运维：

• 邀请记录 /admin/invite_log：查看邀请关系、邀请人/被邀请人、时间
• 购买记录 /admin/invite_purchase：付费邀请订单（余额/现金、游客凭据等）

付费现金价参考社区金币汇率，由 InviteService::cashQuote() 计算人民币金额。

六、前台用户流程

邀请人

1. 登录后进入会员中心「我的邀请」或访问 /invite.html。
2. 查看专属邀请码、邀请链接、邀请人数与排行榜。
3. 分享链接 /invite/r/{code}.html 给好友。
4. 若开启付费邀请：可点击购买，用金币/积分或现金（需 payment）批量获得邀请码。

被邀请人

1. 通过邀请链接访问或手动打开注册页。
2. 注册表单自动出现「邀请码」字段（强制或选填由配置决定）。
3. 注册成功：双方获得积分奖励；建立 invite_relation 记录。
4. 若开启首充返点：被邀请人首次充值金币时，按配置比例返点。

手机快捷登录

开启「强制邀请码」或「付费邀请」时，手机自动注册流程同样注入邀请码字段。

七、后台审核与运维

本插件无人工审核流程。运维关注：

• 邀请记录异常（刷号、自邀）
• 购买记录与支付对账
• 虚拟榜单内容合规

八、特殊说明

钩子插槽

前台路由

与任务中心

taskcenter 的 invite_count 类型统计邀请成功人数。

九、推荐上线清单

• 确认 community 已启用
• 配置邀请双边奖励金额
• 决定是否强制邀请码、是否开启付费邀请
• 若付费邀请：安装 payment 并测试购买流程
• 前台完整走通：分享链接 → 注册 → 奖励到账
• 若开启首充返点：测试被邀请人首次充值场景
• 检查排行榜与虚拟榜单展示

十、常见问题

Q：注册时没出现邀请码输入框？ 确认插件已启用；仅「强制邀请码」或「付费邀请」开启时，手机登录才必填。

Q：邀请成功但没奖励？ 检查 inviter_coins / invitee_coins 是否大于 0；确认邀请码有效且非自邀。

Q：现金购买邀请码失败？ 需安装并配置 payment 插件；检查 window.__INVITE__.payReady。

Q：首充返点没触发？ 确认 rebate_enabled 开启且为被邀请人首次成功充值金币。

Q：虚拟榜单不显示？ 检查 virtual_rank 格式：每行 昵称|邀请数|头像URL，头像可留空。