# MOD_017 分销返佣

## 一、功能简介

「分销返佣」是系统的组成部分，供以下角色使用：超级管理员、业务运营、会员运营。

**常用场景**：

- 运营配置分销全局开关、关系链费率与分享直推费率
- 运营维护分销员等级体系并跟踪分享点击归因
- 财务审核分销员佣金提现申请并核对结算流水

**本模块包含的页面**：

| 页面 | 进入方式 |
|------|---------|
| 佣金提现审核 | 业务管理 > 分销返佣 > 佣金提现审核 |
| 关系链费率 | 业务管理 > 分销返佣 > 关系链费率 |
| 分销全局配置 | 业务管理 > 分销返佣 > 全局配置 |
| 分享直推费率 | 业务管理 > 分销返佣 > 分享直推费率 |
| 分销员等级 | 业务管理 > 分销返佣 > 分销员等级 |

---

## 二、页面详细操作指南

### 2.1 佣金提现审核

**进入方式**：

> 系统左侧菜单：业务管理 > 分销返佣 > 佣金提现审核

**页面说明**：

> 本页为「分销 · 佣金提现」功能页面。说明：审核会员现金佣金提现申请，确认线下打款后标记到账；驳回或打款失败将解冻账户余额

**可用的筛选条件**：

| 筛选项 |
|--------|
| 提现单号输入 |
| 会员关键词输入(编号/昵称/姓名/手机号) |
| 状态下拉(待审核/待打款/已驳回/已到账/打款失败) |
| 搜索/重置按钮 |

填写条件后点击【搜索】刷新列表，点击【重置】清空条件。

**列表展示内容**：提现单号、会员编号、会员姓名、会员手机、申请金额、手续费、到账金额、收款人、状态标签(已到账绿/已驳回打款失败红/待打款蓝/待审核黄)、申请时间、打款时间、行操作列280px

**列表说明**：行操作：通过(仅待审核,confirm确认通过该提现申请？,成功提示「已通过审核」)、驳回(仅待审核,开驳回弹窗)、确认打款(仅待打款,开打款弹窗)、打款失败(仅待打款,prompt输入打款失败原因,为空提示「原因不能为空」,成功提示「已标记打款失败」)；另有内置[查看]

**驳回弹窗**（点击行操作[驳回]打开）：包含 弹窗 480px；驳回原因多行文本(必填)；取消/确定按钮
说明：未填原因提示「请填写驳回原因」；成功提示「已驳回」并整页刷新

**确认打款弹窗**（点击行操作[确认打款]打开）：包含 弹窗 480px；外部流水号输入(选填,银行/微信转账单号)；备注多行文本(选填)；取消/确认到账按钮
说明：成功提示「已确认打款」并整页刷新

#### 本页面可执行的操作

#### 操作1：按条件筛选提现申请

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：3项搜索：提现单号、会员关键词（编号/昵称/姓名/手机号）、状态（待审核/待打款/已驳回/已到账/打款失败）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选提现申请」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选提现申请」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：3项搜索：提现单号、会员关键词（编号/昵称/姓名/手机号）、状态（待审核/待打款/已驳回/已到账/打款失败）（预期结果：条件录入完成（可随时点击重置清空条件））
4. 点击查询/搜索按钮：提交筛选条件，系统按条件查询当前租户范围数据（预期结果：列表按条件刷新，分页同步更新）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入佣金提现审核页面] --> B[检查登录与权限]
 B -->|权限正常| C[搜索表单「搜索/重置」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 按条件筛选提现申请完成]
```

#### 操作2：通过提现审核

- **操作入口**：行操作[通过]按钮（仅状态=待审核显示）
- **操作说明**：confirm「确认通过该提现申请？」；成功提示「已通过审核」并整页刷新（location.reload）；审核页 showAdd/showEdit/showDelete/对应按钮已隐藏

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「通过提现审核」对应入口）
2. 触发操作：行操作[通过]按钮：在页面 的区域「提现申请列表区」中，通过行操作[通过]按钮触发「通过提现审核」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；confirm「确认通过该提现申请？」（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出确认「确认通过该提现申请？」，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「已通过审核」，列表/界面同步刷新最新数据（预期结果：看到「已通过审核」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入佣金提现审核页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「通过」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 通过提现审核完成]
```

**系统提示语**（与界面实际提示一致）：

- 「确认通过该提现申请？」
- 「已通过审核」

#### 操作3：驳回提现申请

- **操作入口**：行操作[驳回]按钮（仅状态=待审核显示）
- **操作说明**：打开 480px 驳回弹窗填写驳回原因；驳回后解冻账户余额

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「驳回提现申请」对应入口）
2. 触发操作：行操作[驳回]按钮：在页面 的区域「提现申请列表区」中，通过行操作[驳回]按钮触发「驳回提现申请」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；打开 480px 驳回弹窗填写驳回原因（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入佣金提现审核页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「驳回」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 驳回提现申请完成]
```

#### 操作4：确认打款

- **操作入口**：行操作[确认打款]按钮（仅状态=待打款显示）
- **操作说明**：打开 480px 打款弹窗，线下完成转账后标记到账

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「确认打款」对应入口）
2. 触发操作：行操作[确认打款]按钮：在页面 的区域「提现申请列表区」中，通过行操作[确认打款]按钮触发「确认打款」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；打开 480px 打款弹窗，线下完成转账后标记到账（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入佣金提现审核页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「确认打款」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 确认打款完成]
```

#### 操作5：标记打款失败

- **操作入口**：行操作[打款失败]按钮（仅状态=待打款显示）
- **操作说明**：prompt 输入打款失败原因，为空提示「原因不能为空」；成功提示「已标记打款失败」并整页刷新；打款失败将解冻账户余额

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「标记打款失败」对应入口）
2. 触发操作：行操作[打款失败]按钮：在页面 的区域「提现申请列表区」中，通过行操作[打款失败]按钮触发「标记打款失败」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；prompt 输入打款失败原因，为空提示「原因不能为空」（预期结果：目标记录的操作按钮可见可用）
4. 二次确认（输入原因）：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「原因不能为空」，列表/界面同步刷新最新数据（预期结果：看到「原因不能为空」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入佣金提现审核页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「打款失败」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 标记打款失败完成]
```

**系统提示语**（与界面实际提示一致）：

- 「原因不能为空」
- 「已标记打款失败」

#### 操作6：查看提现申请详情

- **操作入口**：页面内置行操作[查看]
- **操作说明**：内置查看（showView=true）；操作列280px

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「查看提现申请详情」对应入口）
2. 触发操作：页面内置行操作[查看]：在页面 的区域「提现申请列表区」中，通过页面内置行操作[查看]触发「查看提现申请详情」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：内置查看（showView=true）（预期结果：条件录入完成（可随时点击重置清空条件））
4. 点击查询/搜索按钮：提交筛选条件，系统按条件查询当前租户范围数据（预期结果：列表按条件刷新，分页同步更新）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入佣金提现审核页面] --> B[检查登录与权限]
 B -->|权限正常| C[页面内置行操作「查看」]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 查看提现申请详情完成]
```

#### 操作7：提交提现驳回

- **操作入口**：驳回弹窗[确定]按钮
- **操作说明**：驳回原因多行文本必填，未填提示「请填写驳回原因」；成功提示「已驳回」并整页刷新

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「提交提现驳回」对应入口）
2. 触发操作：驳回弹窗[确定]按钮：在页面 的区域「驳回弹窗」中，通过驳回弹窗[确定]按钮触发「提交提现驳回」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；驳回原因多行文本必填，未填提示「请填写驳回原因」（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「请填写驳回原因」，列表/界面同步刷新最新数据（预期结果：看到「请填写驳回原因」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入佣金提现审核页面] --> B[检查登录与权限]
 B -->|权限正常| C[驳回弹窗「确定」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 提交提现驳回完成]
```

**系统提示语**（与界面实际提示一致）：

- 「请填写驳回原因」
- 「已驳回」

#### 操作8：确认打款到账

- **操作入口**：打款弹窗[确认到账]按钮
- **操作说明**：外部流水号选填（银行/微信转账单号），备注多行文本选填；成功提示「已确认打款」并整页刷新

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「确认打款到账」对应入口）
2. 触发操作：打款弹窗[确认到账]按钮：在页面 的区域「确认打款弹窗」中，通过打款弹窗[确认到账]按钮触发「确认打款到账」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；外部流水号选填（银行/微信转账单号），备注多行文本选填（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「已确认打款」，列表/界面同步刷新最新数据（预期结果：看到「已确认打款」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入佣金提现审核页面] --> B[检查登录与权限]
 B -->|权限正常| C[打款弹窗「确认到账」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 确认打款到账完成]
```

**系统提示语**（与界面实际提示一致）：

- 「已确认打款」

---

### 2.2 关系链费率

**进入方式**：

> 系统左侧菜单：业务管理 > 分销返佣 > 关系链费率

**页面说明**：

> 本页为「分销 · 关系链费率」功能页面。说明：按业务场景、分销层级与获佣人身份配置二级/三级关系链返佣比例或固定额；规则匹配优先精确身份，其次DEFAULT默认档

**可用的筛选条件**：

| 筛选项 |
|--------|
| 业务场景下拉(接口加载) |
| 分销层级下拉 |
| 身份类型下拉 |
| 奖励类型下拉 |
| 状态下拉 |
| 规则编码输入 |
| 搜索/重置按钮 |

填写条件后点击【搜索】刷新列表，点击【重置】清空条件。

**列表展示内容**：工具栏[新建规则]按钮、规则编码、业务场景(编码转中文)、层级、身份类型、身份编码、奖励类型、计算方式、比例/固定额(FIXED显示X元,否则显示百分比)、冷静期(天)、启用标签、状态标签、创建时间、行操作[编辑](跳独立表单页)

**列表说明**：操作列200px仅编辑按钮；空数据提示「暂无费率规则」

#### 本页面可执行的操作

#### 操作1：新建费率规则

- **操作入口**：页头右侧/工具栏[新建规则]按钮
- **操作说明**：跳转独立表单页 对应整页表单，按业务场景、分销层级与获佣人身份配置二级/三级关系链返佣比例或固定额；规则匹配优先精确身份，其次DEFAULT默认档；独立表单页模式：列表页 showView/showAdd/对应按钮已隐藏

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「新建费率规则」对应入口）
2. 触发操作：页头右侧/工具栏[新建规则]按钮：在页面 的区域「页面简介区」中，通过页头右侧/工具栏[新建规则]按钮触发「新建费率规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：跳转独立表单页 对应整页表单，按业务场景、分销层级与获佣人身份配置二级/三级关系链返佣比例或固定额（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入关系链费率页面] --> B[检查登录与权限]
 B -->|权限正常| C[页头右侧/工具栏「新建规则」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 新建费率规则完成]
```

#### 操作2：按条件筛选关系链费率

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：6项搜索：业务场景（接口加载）、分销层级、身份类型、奖励类型、状态、规则编码

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选关系链费率」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选关系链费率」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：6项搜索：业务场景（接口加载）、分销层级、身份类型、奖励类型、状态、规则编码（预期结果：条件录入完成（可随时点击重置清空条件））
4. 点击查询/搜索按钮：提交筛选条件，系统按条件查询当前租户范围数据（预期结果：列表按条件刷新，分页同步更新）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入关系链费率页面] --> B[检查登录与权限]
 B -->|权限正常| C[搜索表单「搜索/重置」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 按条件筛选关系链费率完成]
```

#### 操作3：编辑费率规则

- **操作入口**：行操作[编辑]按钮（跳独立表单页）
- **操作说明**：跳转 对应整页表单 并携带id query；操作列200px仅编辑按钮；空数据提示「暂无费率规则」；比例/固定额按计算方式展示（FIXED显示X元，否则显示百分比）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「编辑费率规则」对应入口）
2. 触发操作：行操作[编辑]按钮：在页面 的区域「费率规则列表区」中，通过行操作[编辑]按钮触发「编辑费率规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：跳转 对应整页表单 并携带id query（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「暂无费率规则」，列表/界面同步刷新最新数据（预期结果：看到「暂无费率规则」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入关系链费率页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「编辑」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 编辑费率规则完成]
```

**系统提示语**（与界面实际提示一致）：

- 「暂无费率规则」

#### 操作4：删除费率规则

- **操作入口**：页面内置行操作[删除]
- **操作说明**：独立表单页模式隐藏查看/新增/编辑，内置删除接口保留；单行删除确认流程

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「删除费率规则」对应入口）
2. 触发操作：页面内置行操作[删除]：在页面 的区域「费率规则列表区」中，通过页面内置行操作[删除]触发「删除费率规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；独立表单页模式隐藏查看/新增/编辑，内置删除接口保留（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入关系链费率页面] --> B[检查登录与权限]
 B -->|权限正常| C[页面内置行操作「删除」]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 删除费率规则完成]
```

> **风险提示**：删除操作不可恢复，请确认目标记录无误后再执行。

#### 操作5：批量删除费率规则

- **操作入口**：页面内置[批量删除]按钮
- **操作说明**：内置批量删除接口保留；勾选多行后确认删除

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「批量删除费率规则」对应入口）
2. 触发操作：页面内置[批量删除]按钮：在页面 的区域「费率规则列表区」中，通过页面内置[批量删除]按钮触发「批量删除费率规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；内置批量删除接口保留（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入关系链费率页面] --> B[检查登录与权限]
 B -->|权限正常| C[页面内置「批量删除」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 批量删除费率规则完成]
```

> **风险提示**：删除操作不可恢复，请确认目标记录无误后再执行。

---

### 2.3 分销全局配置

**进入方式**：

> 系统左侧菜单：业务管理 > 分销返佣 > 全局配置

**页面说明**：

> 本页为「分销 · 全局配置」功能页面。说明：分销总开关、冷静期、提现门槛等系统级参数；配置键由初始化脚本写入，此处仅修改配置值与说明

**可用的筛选条件**：

| 筛选项 |
|--------|
| 配置键输入(模糊搜索) |
| 搜索/重置按钮 |

填写条件后点击【搜索】刷新列表，点击【重置】清空条件。

**列表展示内容**：配置键、配置值、说明、取值提示(内置提示字典：COMMISSION_ENABLED分销开关/GLOBAL_MAX_RATE单奖励类型占实付上限/COOLING_DAYS_DEFAULT默认冷静期/SHARE_ATTRIBUTION_DAYS分享归因缓存天数/ATTRIBUTION_MUTEX_MODE归因互斥模式/WITHDRAW_MIN_AMOUNT最低提现金额/WITHDRAW_FEE_RATE提现手续费率/WITHDRAW_ENABLED提现开关)、更新时间、行操作[编辑]

**列表说明**：操作列100px仅编辑按钮；空数据提示「暂无配置，请先执行 」；列表固定每页50条

**编辑配置弹窗**（点击行操作[编辑]打开）：包含 弹窗 520px；配置键输入(禁用不可改)；配置值输入(必填,下方显示该键取值提示)；说明多行文本；备注多行文本；取消/保存按钮(保存中带loading)
说明：配置值为空校验提示「配置值不能为空」；成功提示「保存成功」并刷新列表

#### 本页面可执行的操作

#### 操作1：按配置键搜索全局配置

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：1项搜索：配置键输入（模糊搜索）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按配置键搜索全局配置」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按配置键搜索全局配置」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：1项搜索：配置键输入（模糊搜索）（预期结果：条件录入完成（可随时点击重置清空条件））
4. 点击查询/搜索按钮：提交筛选条件，系统按条件查询当前租户范围数据（预期结果：列表按条件刷新，分页同步更新）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分销全局配置页面] --> B[检查登录与权限]
 B -->|权限正常| C[搜索表单「搜索/重置」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 按配置键搜索全局配置完成]
```

#### 操作2：编辑全局配置

- **操作入口**：行操作[编辑]按钮
- **操作说明**：打开 520px 编辑弹窗；键值配置页无工具栏（showToolbar=false）无增删查内置操作，仅行级编辑；取值提示内置字典：COMMISSION_ENABLED分销开关/GLOBAL_MAX_RATE单奖励类型占实付上限/COOLING_DAYS_DEFAULT默认冷静期/SHARE_ATTRIBUTION_DAYS分享归因缓存天数/ATTRIBUTION_MUTEX_MODE归因互斥模式/WITHDRAW_MIN_AMOUNT最低提现金额/WITHDRAW_FEE_RATE提现手续费率/WITHDRAW_ENABLED提现开关；操作列100px；空数据提示「暂无配置，请先执行 」；固定每页50条；编辑权限 对应操作权限 的 v-hasPermi 与 permStore 配置在代码中被注释暂关闭

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围，编辑权限校验暂未启用））（预期结果：若权限不足，页面不显示「编辑全局配置」对应入口）
2. 触发操作：行操作[编辑]按钮：在页面 的区域「全局配置列表区」中，通过行操作[编辑]按钮触发「编辑全局配置」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：打开 520px 编辑弹窗（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「暂无配置，请先执行 」，列表/界面同步刷新最新数据（预期结果：看到「暂无配置，请先执行 」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分销全局配置页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「编辑」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 编辑全局配置完成]
```

**系统提示语**（与界面实际提示一致）：

- 「暂无配置，请先执行」

#### 操作3：保存配置值

- **操作入口**：编辑弹窗[保存]按钮
- **操作说明**：配置键禁用不可改，配置值必填（为空校验提示「配置值不能为空」，下方显示该键取值提示），说明与备注多行文本；成功提示「保存成功」并刷新列表；保存中带loading

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围，编辑权限校验暂未启用））（预期结果：若权限不足，页面不显示「保存配置值」对应入口）
2. 触发操作：编辑弹窗[保存]按钮：在页面 的区域「编辑配置弹窗」中，通过编辑弹窗[保存]按钮触发「保存配置值」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：配置键禁用不可改，配置值必填（为空校验提示「配置值不能为空」，下方显示该键取值提示），说明与备注多行文本（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「配置值不能为空」，列表/界面同步刷新最新数据（预期结果：看到「配置值不能为空」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分销全局配置页面] --> B[检查登录与权限]
 B -->|权限正常| C[编辑弹窗「保存」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 保存配置值完成]
```

**系统提示语**（与界面实际提示一致）：

- 「配置值不能为空」
- 「保存成功」

---

### 2.4 分享直推费率

**进入方式**：

> 系统左侧菜单：业务管理 > 分销返佣 > 分享直推费率

**页面说明**：

> 本页为「分销 · 分享直推费率」功能页面。说明：配置分享归因场景下的直推返佣；支持全局默认与SPU/SKU/年卡产品等范围覆盖，匹配优先具体范围再回退GLOBAL

**可用的筛选条件**：

| 筛选项 |
|--------|
| 业务场景下拉(接口加载) |
| 范围类型下拉 |
| 身份类型下拉 |
| 奖励类型下拉 |
| 状态下拉 |
| 规则编码输入 |
| 搜索/重置按钮 |

填写条件后点击【搜索】刷新列表，点击【重置】清空条件。

**列表展示内容**：规则编码、业务场景(编码转中文)、范围类型、范围值、身份编码、奖励类型、比例/固定额(FIXED显示X元,否则显示百分比)、启用标签、状态标签、行操作[编辑](跳独立表单页)

**列表说明**：工具栏开启但无自定义按钮，新建入口在页头；操作列200px仅编辑按钮；空数据提示「暂无分享直推费率」

#### 本页面可执行的操作

#### 操作1：新建直推费率规则

- **操作入口**：页头右侧[新建规则]按钮
- **操作说明**：跳转独立表单页 对应整页表单，配置分享归因场景下的直推返佣；支持全局默认与SPU/SKU/年卡产品等范围覆盖，匹配优先具体范围再回退GLOBAL；独立表单页模式：列表页 showView/showAdd/对应按钮已隐藏

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「新建直推费率规则」对应入口）
2. 触发操作：页头右侧[新建规则]按钮：在页面 的区域「页面简介区」中，通过页头右侧[新建规则]按钮触发「新建直推费率规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：跳转独立表单页 对应整页表单，配置分享归因场景下的直推返佣（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分享直推费率页面] --> B[检查登录与权限]
 B -->|权限正常| C[页头右侧「新建规则」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 新建直推费率规则完成]
```

#### 操作2：按条件筛选分享直推费率

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：6项搜索：业务场景（接口加载）、范围类型、身份类型、奖励类型、状态、规则编码

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选分享直推费率」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选分享直推费率」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：6项搜索：业务场景（接口加载）、范围类型、身份类型、奖励类型、状态、规则编码（预期结果：条件录入完成（可随时点击重置清空条件））
4. 点击查询/搜索按钮：提交筛选条件，系统按条件查询当前租户范围数据（预期结果：列表按条件刷新，分页同步更新）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分享直推费率页面] --> B[检查登录与权限]
 B -->|权限正常| C[搜索表单「搜索/重置」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 按条件筛选分享直推费率完成]
```

#### 操作3：编辑直推费率规则

- **操作入口**：行操作[编辑]按钮（跳独立表单页）
- **操作说明**：跳转 对应整页表单 并携带id query；操作列200px仅编辑按钮；空数据提示「暂无分享直推费率」；比例/固定额按计算方式展示（FIXED显示X元，否则显示百分比）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「编辑直推费率规则」对应入口）
2. 触发操作：行操作[编辑]按钮：在页面 的区域「分享直推费率列表区」中，通过行操作[编辑]按钮触发「编辑直推费率规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：跳转 对应整页表单 并携带id query（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「暂无分享直推费率」，列表/界面同步刷新最新数据（预期结果：看到「暂无分享直推费率」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分享直推费率页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「编辑」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 编辑直推费率规则完成]
```

**系统提示语**（与界面实际提示一致）：

- 「暂无分享直推费率」

#### 操作4：删除直推费率规则

- **操作入口**：页面内置行操作[删除]
- **操作说明**：独立表单页模式隐藏查看/新增/编辑，内置删除接口保留；单行删除确认流程

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「删除直推费率规则」对应入口）
2. 触发操作：页面内置行操作[删除]：在页面 的区域「分享直推费率列表区」中，通过页面内置行操作[删除]触发「删除直推费率规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；独立表单页模式隐藏查看/新增/编辑，内置删除接口保留（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分享直推费率页面] --> B[检查登录与权限]
 B -->|权限正常| C[页面内置行操作「删除」]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 删除直推费率规则完成]
```

> **风险提示**：删除操作不可恢复，请确认目标记录无误后再执行。

#### 操作5：批量删除直推费率规则

- **操作入口**：页面内置[批量删除]按钮
- **操作说明**：内置批量删除接口保留；勾选多行后确认删除

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「批量删除直推费率规则」对应入口）
2. 触发操作：页面内置[批量删除]按钮：在页面 的区域「分享直推费率列表区」中，通过页面内置[批量删除]按钮触发「批量删除直推费率规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；内置批量删除接口保留（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分享直推费率页面] --> B[检查登录与权限]
 B -->|权限正常| C[页面内置「批量删除」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 批量删除直推费率规则完成]
```

> **风险提示**：删除操作不可恢复，请确认目标记录无误后再执行。

---

### 2.5 分销员等级

**进入方式**：

> 系统左侧菜单：业务管理 > 分销返佣 > 分销员等级

**页面说明**：

> 本页为「分销 · 分销员等级」功能页面

**可用的筛选条件**：

| 筛选项 |
|--------|
| 等级编码（输入框，模糊匹配） |
| 等级名称（输入框，模糊匹配） |
| 状态（下拉选择） |

填写条件后点击【搜索】刷新列表，点击【重置】清空条件。

**列表展示内容**：列表列：序号/等级编码/等级名称/排序/状态（标签：启用绿色/停用灰色）/创建时间、行操作：仅[编辑]（跳转独立表单页，携带 id）；showView/showAdd/对应按钮已隐藏、内置删除/批量删除接口保留（接口层可用）、操作列宽200px、空数据提示「暂无分销员等级」

#### 本页面可执行的操作

#### 操作1：新建分销员等级

- **操作入口**：页头右侧[新建等级]按钮
- **操作说明**：goForm 跳转独立路由表单页 对应整页表单；等级供关系链/分享费率中 DISTRIBUTOR_LEVEL 身份匹配及升级规则扩展使用；独立表单页模式：列表页 showAdd/对应按钮已隐藏

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「新建分销员等级」对应入口）
2. 触发操作：页头右侧[新建等级]按钮：在页面 的区域「页面介绍与页头操作」中，通过页头右侧[新建等级]按钮触发「新建分销员等级」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：goForm 跳转独立路由表单页 对应整页表单（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分销员等级页面] --> B[检查登录与权限]
 B -->|权限正常| C[页头右侧「新建等级」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 新建分销员等级完成]
```

#### 操作2：按条件筛选分销员等级

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：3项搜索：等级编码（模糊匹配）、等级名称（模糊匹配）、状态

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选分销员等级」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选分销员等级」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：3项搜索：等级编码（模糊匹配）、等级名称（模糊匹配）、状态（预期结果：条件录入完成（可随时点击重置清空条件））
4. 点击查询/搜索按钮：提交筛选条件，系统按条件查询当前租户范围数据（预期结果：列表按条件刷新，分页同步更新）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分销员等级页面] --> B[检查登录与权限]
 B -->|权限正常| C[搜索表单「搜索/重置」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 按条件筛选分销员等级完成]
```

#### 操作3：编辑分销员等级

- **操作入口**：行操作[编辑]按钮（跳转独立表单页携带id）
- **操作说明**：跳转 对应整页表单 独立路由表单页；操作列宽200px；空数据提示「暂无分销员等级」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「编辑分销员等级」对应入口）
2. 触发操作：行操作[编辑]按钮：在页面 的区域「等级列表」中，通过行操作[编辑]按钮触发「编辑分销员等级」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：跳转 对应整页表单 独立路由表单页（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「暂无分销员等级」，列表/界面同步刷新最新数据（预期结果：看到「暂无分销员等级」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分销员等级页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「编辑」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写表单信息]
 D -->|校验失败| E2[按红字提示修正] --> D
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 F --> G[系统提示操作成功, 列表刷新]
 G --> Z[结束: 编辑分销员等级完成]
```

**系统提示语**（与界面实际提示一致）：

- 「暂无分销员等级」

#### 操作4：删除分销员等级

- **操作入口**：页面内置行操作[删除]
- **操作说明**：内置删除接口保留（接口层可用）；单行删除确认流程

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「删除分销员等级」对应入口）
2. 触发操作：页面内置行操作[删除]：在页面 的区域「等级列表」中，通过页面内置行操作[删除]触发「删除分销员等级」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；内置删除接口保留（接口层可用）（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分销员等级页面] --> B[检查登录与权限]
 B -->|权限正常| C[页面内置行操作「删除」]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 删除分销员等级完成]
```

> **风险提示**：删除操作不可恢复，请确认目标记录无误后再执行。

#### 操作5：批量删除分销员等级

- **操作入口**：页面内置[批量删除]按钮
- **操作说明**：内置批量删除接口保留（接口层可用）；勾选多行后确认删除

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「批量删除分销员等级」对应入口）
2. 触发操作：页面内置[批量删除]按钮：在页面 的区域「等级列表」中，通过页面内置[批量删除]按钮触发「批量删除分销员等级」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；内置批量删除接口保留（接口层可用）（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

异常处理：
- 异常路径：请求失败：接口异常或网络中断时，系统提示错误信息；稍后重试或联系管理员
- 异常路径：校验不通过：表单/条件校验失败时，按提示文案修正后重新填写提交

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入分销员等级页面] --> B[检查登录与权限]
 B -->|权限正常| C[页面内置「批量删除」按钮]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 批量删除分销员等级完成]
```

> **风险提示**：删除操作不可恢复，请确认目标记录无误后再执行。

---

## 三、常见问题与系统提示

| 操作 | 界面提示 | 处理建议 |
|------|---------|---------|
| 通过提现审核 | 「确认通过该提现申请？」 | 属正常反馈，按提示继续操作 |
| 通过提现审核 | 「已通过审核」 | 属正常反馈，按提示继续操作 |
| 标记打款失败 | 「原因不能为空」 | 按提示补齐必填信息或修正输入后重试 |
| 标记打款失败 | 「已标记打款失败」 | 稍后重试，仍失败请联系管理员 |
| 提交提现驳回 | 「请填写驳回原因」 | 按提示补齐必填信息或修正输入后重试 |
| 提交提现驳回 | 「已驳回」 | 属正常反馈，按提示继续操作 |
| 确认打款到账 | 「已确认打款」 | 属正常反馈，按提示继续操作 |
| 编辑费率规则 | 「暂无费率规则」 | 属正常反馈，按提示继续操作 |

> 本章生成日期：2026-08-24，内容基于系统当前版本界面与提示语整理。
