# MOD_015 优惠券

## 一、功能简介

「优惠券」是系统的组成部分，供以下角色使用：超级管理员、会员运营。

**常用场景**：

- 运营创建优惠券模板（满减/折扣/兑换）并设置领取规则与有效期
- 运营向指定会员/人群发放优惠券并跟踪领取核销
- 客服核查会员持券状态与用券记录

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

| 页面 | 进入方式 |
|------|---------|
| 优惠券模板 | 业务管理 > 优惠券 |
| 会员优惠券 | 业务管理 > 优惠券 > 会员优惠券 |

---

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

### 2.1 优惠券模板

**进入方式**：

> 系统左侧菜单：业务管理 > 优惠券

**页面说明**：

> 本页为「营销 · 优惠券」功能页面。说明：创建和管理优惠券（优惠力度、使用条件、有效期、领取方式、可领会员与渠道）；启用后用户可在小程序领取，下单按规则自动抵扣

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

| 筛选项 |
|--------|
| 优惠券编码输入 |
| 优惠券名称输入 |
| 优惠券类型下拉 |
| 领取方式下拉 |
| 状态下拉 |
| 搜索/重置按钮 |

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

**列表展示内容**：工具栏[新建优惠券]按钮、券编码、券名称、使用场景、类型、优惠方式、面额/折扣、总量、已发、已用、领取方式、有效期、状态、可使用渠道(JSON多值翻译)、可领会员等级(JSON多值翻译)、使用说明(多行左对齐)、创建时间、行操作列400px

**列表说明**：行操作：领券码(仅领取方式getType=1时显示,开领券二维码弹窗)、编辑(跳整页表单)、下架(状态=进行中或已结束,confirm确定下架该优惠券吗？下架后用户将无法继续领取)、进行中/启用(状态=已下架或已结束,confirm确定启用该优惠券吗？启用后符合条件的用户可领取使用)、结束(状态=进行中或已结束,confirm确定结束该优惠券活动吗？结束后用户将无法再领取)；操作成功提示「操作成功」；空数据提示「没有更多数据了！」

**领券二维码弹窗**（点击行操作[领券码]打开）：包含 对应弹窗/抽屉(模板id/券名称/二维码URL/领取方式)；二维码生成与刷新
说明：二维码刷新后回写行claimQrcodeUrl并刷新列表

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

#### 操作1：新建优惠券模板

- **操作入口**：页头右侧/工具栏[新建优惠券]按钮
- **操作说明**：跳转整页表单 对应整页表单 创建优惠券（优惠力度/使用条件/有效期/领取方式/可领会员与渠道）；启用后用户可在小程序领取，下单按规则自动抵扣；独立表单页模式：列表页 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：按条件筛选优惠券模板

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：5项搜索：优惠券编码、优惠券名称、优惠券类型、领取方式、状态

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选优惠券模板」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选优惠券模板」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：5项搜索：优惠券编码、优惠券名称、优惠券类型、领取方式、状态（预期结果：条件录入完成（可随时点击重置清空条件））
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；可使用渠道与可领会员等级为JSON多值翻译展示；空数据提示「没有更多数据了！」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「编辑优惠券模板」对应入口）
2. 触发操作：行操作[编辑]按钮：在页面 的区域「优惠券列表区」中，通过行操作[编辑]按钮触发「编辑优惠券模板」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：跳转整页表单并携带id（预期结果：字段录入完成，未触发校验红字）
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：下架优惠券

- **操作入口**：行操作[下架]按钮（状态=进行中或已结束显示）
- **操作说明**：confirm「确定下架该优惠券吗？下架后用户将无法继续领取」；操作成功提示「操作成功」

**操作步骤**：

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[结束: 下架优惠券完成]
```

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

- 「确定下架该优惠券吗？下架后用户将无法继续领取」
- 「操作成功」

#### 操作5：启用优惠券

- **操作入口**：行操作[进行中/启用]按钮（状态=已下架或已结束显示）
- **操作说明**：confirm「确定启用该优惠券吗？启用后符合条件的用户可领取使用」；操作成功提示「操作成功」

**操作步骤**：

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[结束: 启用优惠券完成]
```

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

- 「确定启用该优惠券吗？启用后符合条件的用户可领取使用」
- 「操作成功」

#### 操作6：结束优惠券活动

- **操作入口**：行操作[结束]按钮（状态=进行中或已结束显示）
- **操作说明**：confirm「确定结束该优惠券活动吗？结束后用户将无法再领取」；操作成功提示「操作成功」

**操作步骤**：

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[结束: 结束优惠券活动完成]
```

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

- 「确定结束该优惠券活动吗？结束后用户将无法再领取」
- 「操作成功」

#### 操作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[结束: 批量删除优惠券模板完成]
```

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

#### 操作9：查看领券二维码

- **操作入口**：行操作[领券码]按钮（仅领取方式getType=1时显示）
- **操作说明**：打开 对应弹窗/抽屉（模板id/券名称/二维码URL/领取方式）；二维码刷新后回写行 claimQrcodeUrl 并刷新列表

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「查看领券二维码」对应入口）
2. 触发操作：行操作[领券码]按钮：在页面 的区域「领券二维码弹窗」中，通过行操作[领券码]按钮触发「查看领券二维码」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：打开 对应弹窗/抽屉（模板id/券名称/二维码URL/领取方式）（预期结果：条件录入完成（可随时点击重置清空条件））
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.2 会员优惠券

**进入方式**：

> 系统左侧菜单：业务管理 > 优惠券 > 会员优惠券

**页面说明**：

> 本页为「营销 · 会员优惠券」功能页面。说明：查看每位会员已领取的优惠券及使用状态；支持按会员查询、向指定会员发放、作废未使用的券

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

| 筛选项 |
|--------|
| 会员关键词输入(会员编号/姓名/手机号) |
| 券编码输入 |
| 券码输入 |
| 使用状态下拉(未使用/已使用/已过期/已冻结/已作废) |
| 领取开始时间(日期时间) |
| 领取结束时间(日期时间) |
| 搜索/重置按钮 |

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

**列表展示内容**：工具栏[发放优惠券]按钮、券码、会员编号、会员姓名、手机号、券名称、类型、优惠方式、面值/折扣、领取方式、领取时间、失效时间、状态、行操作列140px

**列表说明**：行操作：详情(开详情弹窗)、作废(仅状态=未使用,prompt输入作废原因,为空提示「作废原因不能为空」,成功提示「作废成功」)；空数据提示「没有更多数据了！」

**会员优惠券详情弹窗**（点击行操作[详情]打开）：包含 弹窗 720px；券信息组(券码/券名称/券编码/使用状态/券类型/优惠方式/面额折扣/使用门槛[满X元可用或无门槛]/封顶减免)；会员信息组(会员编号/会员姓名/手机号)；领取信息组(领取方式/领取时间/有效开始/有效结束/兑换积分)；使用信息组(已使用时显示：使用时间/使用订单/抵扣金额/订单金额)；冻结信息组(已冻结时显示：冻结时间/冻结原因)；关闭按钮
说明：无数据提示「未找到该优惠券记录」，加载失败提示「加载详情失败」并关闭弹窗

**发放优惠券弹窗**（点击工具栏[发放优惠券]打开）：包含 弹窗 520px；优惠券下拉(必填,仅加载状态=进行中模板前200条,可搜索,标签格式券名称（券编码）)；发放会员多行文本(必填,每行一位或逗号/空格分隔,填会员编号或手机号)；备注多行文本(选填)；取消/确定发放按钮
说明：未选券提示「请选择要发放的优惠券」；未填会员提示「请填写至少一位会员的编号或手机号」；成功提示「发放完成」并刷新列表

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

#### 操作1：按条件筛选会员优惠券

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：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[结束: 按条件筛选会员优惠券完成]
```

#### 操作2：作废优惠券

- **操作入口**：行操作[作废]按钮（仅状态=未使用显示）
- **操作说明**：prompt 输入作废原因，为空提示「作废原因不能为空」；成功提示「作废成功」并刷新列表；只读页面 showView/showAdd/showEdit/showDelete/对应按钮已隐藏，仅保留详情与作废

**操作步骤**：

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[结束: 作废优惠券完成]
```

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

- 「作废原因不能为空」
- 「作废成功」

#### 操作3：打开发放优惠券弹窗

- **操作入口**：工具栏[发放优惠券]按钮
- **操作说明**：打开 520px 发放弹窗（优惠券下拉/发放会员多行文本/备注），供向指定会员发放优惠券

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「打开发放优惠券弹窗」对应入口）
2. 触发操作：工具栏[发放优惠券]按钮：在页面 的区域「会员优惠券列表区」中，通过工具栏[发放优惠券]按钮触发「打开发放优惠券弹窗」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；打开 520px 发放弹窗（优惠券下拉/发放会员多行文本/备注），供向指定会员发放优惠券（预期结果：目标记录的操作按钮可见可用）
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：查看优惠券详情

- **操作入口**：行操作[详情]按钮
- **操作说明**：打开 720px 详情弹窗，分5信息组：券信息/会员信息/领取信息/使用信息（已使用时显示）/冻结信息（已冻结时显示）；无数据提示「未找到该优惠券记录」，加载失败提示「加载详情失败」并关闭弹窗

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「查看优惠券详情」对应入口）
2. 触发操作：行操作[详情]按钮：在页面 的区域「会员优惠券详情弹窗」中，通过行操作[详情]按钮触发「查看优惠券详情」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：打开 720px 详情弹窗，分5信息组：券信息/会员信息/领取信息/使用信息（已使用时显示）/冻结信息（已冻结时显示）（预期结果：条件录入完成（可随时点击重置清空条件））
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[结束: 查看优惠券详情完成]
```

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

- 「未找到该优惠券记录」
- 「加载详情失败」

#### 操作5：提交优惠券发放

- **操作入口**：发放弹窗[确定发放]按钮
- **操作说明**：优惠券下拉仅加载状态=进行中的模板前200条（可搜索，标签格式「券名称（券编码）」）；发放会员多行文本每行一位或逗号/空格分隔（填会员编号或手机号）；备注选填；未选券提示「请选择要发放的优惠券」，未填会员提示「请填写至少一位会员的编号或手机号」，成功提示「发放完成」并刷新列表

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「提交优惠券发放」对应入口）
2. 触发操作：发放弹窗[确定发放]按钮：在页面 的区域「发放优惠券弹窗」中，通过发放弹窗[确定发放]按钮触发「提交优惠券发放」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；优惠券下拉仅加载状态=进行中的模板前200条（可搜索，标签格式「券名称（券编码）」）（预期结果：目标记录的操作按钮可见可用）
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，内容基于系统当前版本界面与提示语整理。
