一、全流程总览

一句话：先在「项目库」挑项目加入自己的清单 → 给招来的学员登记并绑上项目（系统自动开一笔待缴订单）→ 去「缴费中心」给这笔订单付款 → 学员"已报名"后一键「提报佣金」等管理员审核结算。

二、① 选择项目

入口：后台 → 项目（上架项目库）

这一步是把平台开放的项目，加入你自己的「我的项目」清单，方便后面绑学员时快速选取。

  1. 打开 项目 页，浏览平台上架的全部招生项目（含区域、类别、层次、项目介绍、佣金金额等）。
  1. 找到要推广的项目，点击 「加入我的项目」（页面按钮，移动端为 加入我的项目）。
  1. 系统把该项目写入你的个人清单，提示「已成功加入」。
  1. 之后在 我的项目 里就能看到它；绑学员时的项目下拉，数据就来自这里。

注意：绑学员时只能选「我的项目」里的项目（不再用全量上架项目），所以这一步是前置必做。

三、② 绑定学员（students）

入口：后台 → 学员管理

给每一位你招来的学员建立档案，并把上一步加入的项目绑上去。绑定动作的关键副作用由后端自动完成，你无需手动开单。

添加学员

  1. 点击 「添加学员」，填写：
    • 姓名（必填）
    • 手机号（必填，格式 1[3-9]xxxxxxxxx，校验不通过会提示）
    • 微信号（选填）
    • 跟进状态：跟进中 / 已报名 / 已流失（默认"跟进中"）
    • 备注（选填）
  1. 保存后，学员进入列表，此时 项目 = 未绑定、预计收益 = ¥0.00。

绑定项目（开单）

  1. 在学员列表点 绑定按钮（🔗 图标），弹出项目选择。
  1. 下拉里选一个 「我的项目」 中的项目（选项展示：项目名｜区域｜类别｜层次｜介绍）。
  1. 选好保存。系统会自动为你做三件事：
    • 生成一笔专属 订单号 order_no（用于后面缴费中心付款）；
    • 锁定该学员的佣金费率，订单创建后不再被重算覆盖；
    • 按项目定价写入 订单金额。
  1. 绑定成功后，学员行显示项目名与预计收益；「去缴费」即可进入下一步。

⚠️ 锁定规则：项目一旦绑定并生成订单，订单号不可改、费率被冻结。学员状态变为（已转化）或佣金 （已审核）后，绑定/编辑均被锁定，不可再改。

四、③ 缴费中心缴费（recharge）

入口：后台 → 缴费中心（钱包充值模块）

绑完项目后，学员对应的那笔订单需要在缴费中心完成支付。系统支持用学员订单号直接下单、支付宝扫码付款。

缴费步骤

  1. 打开 缴费中心，页面加载时拉取你的订单/充值记录。
  1. 找到对应学员的订单（或点学员行的「去缴费」带入 order_no），进入下单。
  1. 选择支付方式（当前为支付宝当面付）：
    • 调用后端 预下单；
    • 返回 支付二维码 + 订单号。
  1. 用支付宝 App 扫码支付；支付成功后：
    • 订单状态由"待支付"变为 充值成功（已支付）；
    • 学员记录上的支付状态 同步更新为已付。
  1. 页面顶部状态说明：支付；充值成功。

草稿态说明：未提交的下单是草稿，不会落库；只有真正创建成功才生成正式订单号。

缴费记录

  • 缴费中心内可查看 充值历史，含订单号、金额、手续费、状态、时间。
  • 订单号是后续提报佣金、对账的唯一凭据，建议截图留存。

五、④ 提报佣金

入口：学员管理 → 选中某学员 → 提报佣金

当学员完成报名且订单已支付，你就可以把这笔招生对应的佣金提报给平台审核。

提报条件（后端硬性校验）

  • 学员 状态必须为（已报名）——其他状态（跟进中 / 已流失 / 未报名）会提示「只有已完成报名的学员才能提报佣金」。
  • 佣金 不能重复提报：若佣金状态（已通过审核），会提示「该佣金已通过审核，无需重复提报」。
  • 有 限流保护：同一客户端 1 小时内最多 30 次提报，超频提示「操作过于频繁」。

提报动作

  1. 在学员列表点该学员的 提报佣金 按钮，前端调用：
  1. 后端逻辑：
    • 校验状态 / 是否已审 / 限流；
    • 佣金金额 = 学员订单总额× 绑定时锁定的生效费率；
    • 写入发放状态（待审核），等待管理员处理。
  1. 成功提示「已提报佣金，等待管理员审核」。

审核流转

  • 提报后状态变为 待审核；
  • 管理员在后台审核 → 通过 或 驳回；
  • 通过后佣金进入可结算/已发状态，学员行「佣金率」列锁定不再重算。

提报前请确认：学员状态已置为"已报名"、对应订单已在缴费中心支付成功，否则会提报失败。

六、常见问题（FAQ）

Q1：绑项目时为什么会自动出一笔订单？ A：这是系统设计的"开单即锁价"机制——绑定项目的瞬间，后端自动生成 order_no、按项目定价写入订单金额、并冻结佣金费率，保证后续缴费与佣金计算口径一致、不被改项目影响。

Q2：绑定后还能换项目吗？ A：在订单未支付、佣金未审核前可以改；一旦订单已付或佣金 approved，绑定与编辑按钮会被禁用（锁定）。

Q3：缴费中心付不了款怎么办？ A：确认订单号正确、网络通畅；若二维码过期重新点「去支付」生成新二维码。支付成功以订单状态变为"充值成功"为准。

Q4：提报佣金提示"只有已完成报名的学员才能提报"？ A：先把该学员状态改为"已报名"（且订单已支付），再提报。

Q5：提报后多久结算？ A：取决于管理员审核节奏，提报后状态为"待审核"，通过后进入结算流程；可在学员列表查看佣金状态列。

Q6：可以删除学员吗？ A：可以（删除按钮），不影响已产生的订单与佣金记录。

七、给代理的 3 条实操建议

  1. 先加项目再绑学员：项目没加入「我的项目」前，绑学员下拉是空的，会卡住。
  1. 缴费凭证留底：每笔学员订单支付成功后截个图（订单号 + 金额），提报佣金或日后对账都用得上。
  1. 状态要跟到位：学员"已报名" + 订单"已支付"是提报佣金的两个硬门槛，缺一不可；别等月底才想起来补状态。