适用对象：后台「运营管理员」角色（ops_admin）。本文覆盖日常运营会用到的菜单：仪表盘、应用、商品、订单、分销系统（推广员管理、佣金明细、提现申请、推广员审核、退款冲正）、用户（只读）。文中截图来自本地演示环境，数据与线上无关。
1. 角色与权限边界
运营管理员拥有后台的大部分日常运营权限，但没有「账号安全」和「系统配置」相关的权限。对照下表确认自己能做什么，避免和超级管理员重复操作。
能力 | 是否具备 | 说明 |
|---|---|---|
应用 / 商品 / 注册码 | 可增删改查 | 含应用公共备注、商品备注（Markdown） |
订单 | 可查看、可退款 | 含首购优惠订单的「关闭并释放资格」 |
分销系统（全部 5 个页面） | 可查看、可操作 | 审核推广员、改佣金比例、审核提现 |
用户 | 只读 | 能看资料与推广关系，不能改密码、改角色、删用户 |
角色与权限、系统设置、支付 / 存储 / 邮件配置、系统日志 | 无 | 需要时请超级管理员处理 |
权限不足时页面右上角会弹出类似 Forbidden action: roles:read 的红色提示，表示该功能不在你的授权范围内，不是系统故障。
2. 登录与菜单结构
用管理员分配的账号登录后台。左侧菜单按业务分组，分销相关功能集中在「业务管理 → 分销系统」下：
- 概览 → 仪表盘：经营数据总览
- 业务管理：应用、商品、订单、分销系统（推广员管理 / 佣金明细 / 提现申请 / 推广员审核 / 退款冲正）
- 授权管理：设备、注册码、接口测试、使用记录
- 系统管理 → 用户：用户与推广关系（只读）
3. 仪表盘：每天先看这四组数
- 金额概览：总收入、当日 / 当月总收入，以及同期的退款金额。
- 用户概览：总用户数、今日新增。
- 总订单：总订单数、总复购订单、总退单。
- 今日订单：今日新增、今日支付成功、今日退单。
下方「收入与订单趋势」支持按日 / 周 / 月 / 年切换、当期与累计切换、柱状图与折线图切换，可按应用筛选。
口径提醒（做报表对不上数时先看这里）：金额只统计「已完成」订单并按支付时间归属；退款按退款确认时间归属；周统计按北京时间周一至周日切分，首尾周只统计所选日期范围内。当天发生的退款会减少当日口径里的退款金额，但不回改历史收入。
4. 推广员管理
路径： 业务管理 → 分销系统 → 推广员管理。这里只显示 已审核通过的推广员；待审核的申请在「推广员审核」里。
4.1 搜索与排序
- 搜索框支持：用户 ID、用户名、邮箱、姓名、推广码、收款账号，输入任意一项即可。
- 点击「总佣金 / 月佣金 / 日佣金 / 下线人数」表头可排序，用来找头部推广员或异常账号。
- 「推广级别」列显示 一级（有下线）、 二级（有上级）、 未建立合作（审核通过但还没有任何上下级关系）。
4.2 详情弹窗：一个人管三项
点击某行的「详情」，弹窗分三个页签： 合作概况（直属比例、上下级关系）、 下级推广员（下级列表与各自比例）、 比例变更记录（谁在什么时候把比例从多少改到多少）。调整比例也在这里操作，见下一章。
5. 推广员审核
路径： 分销系统 → 推广员审核。这里能看到全部状态（待审核、已通过、拒绝、停用），按状态筛选即可。
- 通过：申请人的支付宝账号和收款姓名进入提现档案；若系统开启了自动建立合作关系，会按邀请关系自动补建上下级。
- 拒绝：需要填写原因，申请人能看到。
- 停用：停止其推广资格，已产生的佣金和提现记录不受影响；停用后不能再发展新下级。
6. 佣金比例与层级规则
本系统是 二级差额分成：每个推广员有一个「直属比例」（记作 X），他名下的二级推广员有一个「下级比例」（记作 Y），必须满足 0 ≤ Y < X ≤ 100%。
场景 | 谁拿多少 |
|---|---|
一级推广员 A 自己推广的用户下单 | A 拿「实付金额 × X」 |
A 的下级 B（二级）推广的用户下单 | B 拿「实付金额 × Y」；A 拿「实付金额 × (X − Y)」的差额 |
只有一级（没有上级）的推广员 | 只产生一笔佣金，比例就是他的 X |
佣金一律按 订单实付金额计算（用了首购优惠就按优惠后的金额），向下取整到分。
6.1 怎么改比例
- 改某个推广员的直属比例 X：推广员管理 → 详情 → 合作概况 → 修改比例。
- 改某个下级的比例 Y：推广员管理 → 详情 → 下级推广员 → 修改该下级的比例。
- 系统会拦下三种非法操作：把 X 改到小于等于某个下级的 Y；有下级时把 X 清空；给一个已经有下级的推广员再挂上级。
- 每次改动都会写入「比例变更记录」，包含操作人、旧值、新值和时间。
用户管理页（系统管理 → 用户）也能看到每个用户的 推广级别和 佣金比例，点「详情」可查看「上级、下级和比例」，但修改比例请走上面的分销入口。
7. 佣金明细
路径： 分销系统 → 佣金明细。这是核对佣金最常用的页面。
- 筛选：订单号、受益人（用户名 / ID）、直接推广人（用户名 / ID）、层级（一级 / 二级）、日期范围。
- 日期按 北京时间的支付日期筛选，缺少支付时间时退回佣金创建时间，与「推广概览」的归属口径一致。
- 「收入类型」区分 直推收入（自己推广成交）和 差额收入（下级成交拿到的差额），二者共同构成总佣金。
- 金额列拆开看：「本人佣金」是应得总额，「可提现」是当前未提现的部分，「已结算」是已经打款的部分。
状态 | 含义 |
|---|---|
待确认 | 已支付，但仍在持有期内（默认 7 天），到「可结算时间」后才可提现 |
可提现 | 已过持有期，可以申请提现 |
提现中 | 已被一笔提现申请锁定，正在走审核 / 打款 |
已结算 | 已经打款给推广员 |
已取消 | 订单被退款或关闭，佣金作废 |
已抵扣 | 佣金被退款产生的抵扣额整体冲抵 |
勾选若干行后点右上角「代申请提现」，可以替推广员发起一笔提现（用于推广员不方便自己操作的场景），流程与推广员本人申请一致。
8. 提现申请
路径： 分销系统 → 提现申请。推广员在推广中心提交申请后，会在这里待处理。
- 核对提现单号、用户、金额、支付宝账户与姓名。
- 线下转账完成后点「确认打款」，填写 打款流水号并上传 转账凭证（凭证保存在系统里，推广员也能看到）。
- 无法打款就点「拒绝」并填写原因，被锁定的佣金会立即释放回可提现。
- 已打款的记录可以点「查看凭证」复核。
订单退款时，该推广员所有 待处理的提现会被系统自动驳回并释放佣金；已经打款的部分会生成负向「退款抵扣」，从他后续的佣金里逐笔抵扣。所以退款后不需要你手工去改提现单。
9. 退款冲正
路径： 分销系统 → 退款冲正。这里集中展示退款产生的负向抵扣。
- 状态有 待抵扣、 部分抵扣、 已抵扣三种，按状态筛选可以快速找出还没抵扣完的推广员。
- 抵扣逻辑是自动的：推广员后续产生的可提现佣金会先抵扣欠款，抵扣完成后才变成可提现余额。
- 如果某个推广员的「退款抵扣」里长期挂着待抵扣，说明他后续没有新佣金可扣，属于正常的挂账状态。
10. 订单管理
路径： 业务管理 → 订单。相比旧版主要有三处变化：
- 筛选条件新增 优惠状态和 创建时间范围；订单号、注册码、购买用户、状态保持不变。
- 列表新增「优惠信息」列：优惠码、优惠码推广人 ID、原价、优惠金额、支付链接有效期，用于排查首购优惠纠纷。
- 待支付的优惠订单右侧会出现「 关闭并释放资格」：系统会先向支付渠道确认关单， 确认成功后才释放该用户的首购优惠资格；渠道未确认时不会释放，稍后重试即可。
11. 应用与商品备注（Markdown）
应用的「公共备注」和商品的「备注」都支持 Markdown，前台会按格式渲染，用来写购买须知、使用说明、更新日志等。
- 支持标题、列表、加粗、行内代码与链接；换行会保留。
- 出于安全考虑 不支持图片和原始 HTML，链接会以新窗口打开。
- 编辑框里可以直接预览渲染效果。
12. 常见问题
12.1 找不到某个推广员？
「推广员管理」只列已审核通过的；申请还在审核中请去「推广员审核」，被拒绝或停用的不在管理列表里。
12.2 比例保存不了？
三种情况会被拦住：新比例小于等于某个下级的比例；有下级时想把比例清空；想给已经有下级的推广员再挂上级。按提示调整即可。
12.3 推广员说没有佣金？
按顺序排查：订单是否 已支付（未支付不产生佣金）；是否 已退款 / 已关闭；下单用户是否在 归因有效期内（默认 30 天）；是不是 二级分销被关闭期间的订单；下单的推广关系是不是他自己的推广码。
12.4 可提现金额为什么比佣金少？
可能有三种原因：佣金还在 持有期内（状态「待确认」）；部分金额已经在 提现中或 已结算；存在 退款抵扣欠款被优先扣除。
12.5 提现为什么打不了款？
确认提现金额不低于最低提现额（默认 50 元），并且这条提现单状态仍是「待处理」。
12.6 页面报 Forbidden？
该功能超出运营管理员权限（例如角色、系统设置、支付配置），请联系超级管理员。详见第一章的权限表。