开发说明 · 邀请

邀请功能规格

定义游客与登录状态、分享、邀请记录、奖励政策、等级成长和提现衔接。当前为 1.0.0 初始草稿，具体结算与关系判定中未明确的规则单独列出。

1.0.0 · 初始草稿 分享与团队成长 USD 返佣
体验邀请原型 ↗ 返回产品方案 →
01 / 邀请

范围与规则状态

状态 范围 约束
当前草稿 游客首页与公开政策、登录后邀请信息和记录、提现选择与表单。 不引入积分奖励；返佣单位为 USD。邀请主页属于五栏导航。
已明确展示 三级比例 15% / 10% / 5%；L1–L4 条件；公会 20% 说明。 展示政策不等于结算算法已确认，不以注册或分享行为直接发奖。
建议 记录字段、加载与失败提示、返回保留分类、提交前核对。 可用于原型评审，待业务确认后作为最终规格。
待确认 关系归因、有效邀请、消费范围、结算、换汇、费用、到账及风控。 不可由客户端补算或将示例金额视为真实余额。
02 / 邀请

页面与展示内容

页面 必须展示 操作与返回
邀请首页 · 游客 介绍文案、登录/注册、邀请政策；不展示个人邀请码、返佣或记录。 进入页面本身不强制登录。点击登录/注册先打开底部手机号登录弹层，可切换手机号注册，关闭留在原页。
邀请首页 · 已登录 邀请码与复制、链接与复制、累计返佣 USD 与“包含已提现部分”、提现、我的邀请。 默认直接邀请；最近 5 人；查看全部带当前分类；底部邀请选中。
邀请政策 团队示例 5/25/125 共 155 人；15%/10%/5%；L1–L4；L4 公会资格与 20% 说明。 游客可阅读。邀请记录和分享需要账号，登录后返回原目标；隐藏底部导航。
全部邀请 直接/间接切换、当前分类记录或明确空态。 入口继承分类，刷新保留；顶部返回首页保留分类。列表字段和分页建议见数据定义。
提现方式弹层 PIX、USDT BSC、USDC BSC，单选，确认、关闭。 未选择禁用确认；确认后打开对应表单；取消不产生申请。
提现表单 所选方式、收款资料、USD 数量、可提现余额、全部、确认、说明、记录。 从邀请进入后返回邀请；更换方式重新选择。三种方式共用余额和记录。
03 / 邀请

账号、分享与邀请关系

场景 处理规则 结果
注册与登录 统一使用底部手机号登录弹层，可在弹层内切换注册。注册包含 +55 区号选择、11 位数字手机号、密码、确认密码、选填邀请码；号码输入框不提示填写区号。不提供邮箱登录或注册，校验复用账号模块。 成功恢复受保护的原目标；取消不丢失邀请页。其他账号不应看见前一账号的邀请资料。
邀请码为空 选填，不作为注册前置条件。 正常注册；不制造邀请关系。
邀请码已填写 正式服务验证有效性并决定关系绑定；长度、冲突、自邀、补填规则待确认。 关系确认前不得展示有效好友、发奖或升级。演示只保存填写值。
复制 邀请码单独复制；链接按钮复制含网址和邀请码的完整文案。 写入成功才提示成功；失败展示可选中文本。
系统分享 由用户主动调用系统分享，文案含注册网址和邀请码；不自动选择联系人或发送。 用户取消保持原页；不支持或调用失败提供复制；操作不增加邀请人数。
登录失效 个人记录与提现入口要求重新登录；公共政策继续可读。 隐藏前一会话的私有数据，登录后重新读取；禁止仅凭页面显示状态执行提现。
04 / 邀请

奖励与成长数据含义

数据 定义 未决边界
直接邀请 / 一级 当前账号直接邀请并已确认关系的用户。 有效邀请是否要求消费、去重方式、禁用账号处理。
间接邀请 由直接邀请的好友继续产生的邀请。 是否汇总二级与三级、展示范围与权限。
层级奖励 一级 15%、二级 10%、三级 5%。触发描述为购点/订阅或服务开通/续费。 参与商品、金额基数、币种换算、入账周期、退款扣回、精度与四舍五入。
累计返佣 账号累计获得的邀请返佣，包含已提现部分；USD 两位小数。 冻结、冲正、退款是否回减累计值；正式账本口径。
可提现余额 当前允许发起提现的余额，与累计返佣分开提供。 待结算、冻结、处理中款项如何占用与释放；不可直接用累计值推导。
成长 L1 加入；L2 邀请 2 人 + 培养 2 个 L1；L3 邀请 4 人且培养 1 个 L2 和 1 个 L1；L4 培养 1 个 L2 和 1 个 L3；达标自动升级。 邀请统计范围、培养关系、降级规则与等级任务权限。
公会资格 L4 可申请创建；政策显示全公会 20% 奖励。 申请审核、奖励基数和叠加方式由公会与结算规则确定。
05 / 邀请

提现字段、校验与提交

字段或阶段 已明确内容 处理要求
PIX 类型与标识 巴西手机号或 CPF；手机号固定 +55；另填收款人姓名。 必填且按类型校验；电话输入 2 位地区区号 + 9 开头的 9 位号码。CPF 正式校验及身份核对待确认。
USDT / USDC BSC 网络、收款地址。 地址与网络匹配；格式通过不代表地址有效。正式渠道可用性与网络清单由服务提供。
数量 单位 USD；全部按钮填可提现余额。 正数，最多两位小数，不超过余额。PIX 最低 1 USD；USDC 最低 20 USD；USDT 门槛待确认。原型 USDT 暂用 20 USD 演示。
提交前确认 · 建议 展示方式、网络或 Key 类型、收款标识、数量、手续费和实付数量。 费用或报价不可得时不能提交真实申请；取消保留输入。实际提交需服务端重新校验余额与报价。
重复操作与失败 · 建议 处理中禁用提交；请求使用唯一业务标识。 超时先查询原申请结果，避免重复扣款。余额变化提示刷新，失败不凭空扣除余额。
记录 · 建议 时间、方式、数量、处理状态；实际成功以支付回执为准。 待处理、成功、失败应区分。演示仅“模拟处理中”，不模拟真实到账或不可撤销的资金操作。
06 / 邀请

加载、空态、错误与可访问性

状态 展示要求 恢复方式
加载中 · 建议 个人数据未返回前显示加载占位，不显示虚假的零值；方式加载时禁用确认。 加载完成替换；超过等待阈值显示可重试提示，阈值待确认。
邀请为空 直接“还没有直邀好友”，间接“还没有间邀好友”，并提示复制分享。 允许切换、查看政策与返回。
读取失败 记录错误与空态区分；金额未知不能显示 0.00。 就地重试；保留当前分类。
没有余额 显示可提现 0.00 USD；不允许产生申请。 全部填零并提示暂无余额，确认动作给出原因。
表单错误 展示具体字段原因并定位对应输入。 用户修正后可再次操作，不清空其他有效输入。
弹层与键盘 弹层有标题、关闭；限制焦点在弹层内；Esc 关闭，关闭后回到触发控件。 窄屏、长链接、系统键盘出现时仍可滚动到输入和提交；底部导航不遮挡。
07 / 邀请

接口需要表达的信息

数据组 最小信息 说明
个人邀请概览 账号标识、邀请码、分享落地地址、累计返佣金额及币种。 来源与权限由服务验证；邀请码不可由真实用户隐私直接推导。
邀请关系列表 · 建议 关系标识、直邀/间邀类型、昵称或脱敏显示标识、关系生效时间、分页信息。 首页只取最近 5 人；完整列表分页策略待确认。不展示手机号、邮箱等非必要个人信息。
奖励政策 层级、比例、有效范围、生效时间；等级条件、公会条件。 需要确认政策版本与消费发生时间的对应关系，不仅依靠展示文案结算。
提现配置与余额 可用方式、网络、最低数量、余额、费用与换汇报价。 累计金额、余额与货币精度分别处理；客户端不能判断最终可支付性。
提现申请与结果 唯一申请标识、账号、方式、数量、费用、收款信息、状态、时间。 服务保障幂等与访问控制；真实隐私和资金信息不得写入演示数据。
08 / 邀请

应达到的验收结果

  1. 游客可浏览

    邀请首页不跳离；政策可读，私有信息不可见；底部登录弹层可关闭、切换手机号注册；成功回到原目标。

  2. 分享可完成

    邀请码与链接可复制；失败可手动复制；系统分享取消不报成功；刷新后同账号邀请码不变。

  3. 记录不串类

    两类分别显示，首页最多 5 人，全部记录继承分类；切换、返回和刷新保留选择；无数据与失败有不同提示。

  4. 金额含义清楚

    累计返佣与可提现余额独立展示；选择提现方式后字段匹配，空值、错误格式、过小或超额数量均不能提交。

  5. 确认和返回完整

    取消确认保留填写；重复点击不会产生多笔申请；模拟记录可刷新查看，三种方式共用余额；关闭弹层恢复焦点。

  6. 显示范围准确

    原型手机画布不超过 430px；窄屏无横向溢出，表单可滚动；方案在手机、平板、电脑均可独立阅读。

09 / 邀请

尚需确认的业务决策

  1. 正式分享落地页与邀请码携带方式；是否允许后续补填、换绑，失效或冲突如何处理。
  2. 直邀与间邀口径、三级关系在列表的呈现、记录字段、排序及分页。
  3. 参与商品、返佣基数、结算时间、退款回冲、成长条件中有效邀请与培养的定义。
  4. 公会 20% 适用对象及是否叠加三级奖励，申请与管理权限。
  5. USDT 最低提现、PIX 换汇、手续费与到账币种、审核条件、限额、失败退回和到账时长。
交付边界

本页定义平台无关的产品行为；当前原型的脚本、存储键、示例数据和预览方式见维护附录。真实服务与资金流程未接入。