# MOD_014 会员中心

## 一、功能简介

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

**常用场景**：

- 运营查看/检索会员档案，维护会员标签与等级权益
- 运营配置积分规则（获取/消耗/等级加成）并核查积分流水
- 客服处理会员发票申请（审核/开票）
- 运营配置付费VIP会员权益并跟踪内购订单

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

| 页面 | 进入方式 |
|------|---------|
| 会员管理 | 业务管理 > 会员管理 |
| 发票申请 | 业务管理 > 会员管理 > 发票申请 |
| 积分规则 | 业务管理 > 会员管理 > 积分规则 |
| 积分流水 | 业务管理 > 会员管理 > 积分流水 |

---

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

### 2.1 会员管理

**进入方式**：

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

**页面说明**：

> 本页为「会员 · 会员档案」功能页面。说明：管理C端注册会员的等级、积分、余额与账号状态，支持按编号、昵称、手机号检索与启停、积分调整

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

| 筛选项 |
|--------|
| 会员编号输入 |
| 手机号输入 |
| 会员昵称输入 |
| 真实姓名输入 |
| 成长等级下拉(接口加载) |
| 付费等级下拉(接口加载) |
| 会员状态下拉(禁用/正常/待审核/已注销) |
| 搜索/重置按钮 |

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

**列表展示内容**：会员编号、会员昵称、真实姓名、手机号、成长等级、付费等级、成长值、可用积分、账户余额、状态标签(正常绿/禁用红/待审核已注销黄)、注册时间、最后登录时间、最后登录IP、自定义操作列380px

**列表说明**：行操作6按钮：积分明细(开抽屉)、优惠券明细(开抽屉)、禁用(仅状态=正常，confirm确定禁用该会员吗)、启用(仅状态=禁用，confirm确定启用该会员吗)、加积分、扣积分；无内置新增/编辑/删除/批量删除

**积分明细抽屉**（点击行操作[积分明细]打开）：包含 el-drawer 900px；el-table 9列(流水类型/变动积分/变动前积分/变动后积分/业务类型/业务描述/规则名称等)；el-pagination 10条/页
说明：标题含会员昵称与编号；打开即按memberId分页加载积分流水

**优惠券明细抽屉**（点击行操作[优惠券明细]打开）：包含 el-drawer 900px；el-table 7列(券码/券名称/面值或折扣/领取时间/失效时间/状态等)；状态映射(未使用/已使用/已过期/已冻结/已作废)；el-pagination 10条/页

**积分加减弹窗**（点击行操作[加积分]或[扣积分]打开）：包含 弹窗 400px；积分数量数字输入(必填,1-999999)；业务描述输入(选填)；取消/确定按钮
说明：积分数量≤0时提示「请输入有效的积分数量」；成功后提示积分增加/扣减成功并刷新列表

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

#### 操作1：按条件检索会员

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：7项搜索：会员编号、手机号、会员昵称、真实姓名、成长等级（接口加载下拉）、付费等级（接口加载下拉）、会员状态（禁用/正常/待审核/已注销）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件检索会员」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件检索会员」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：7项搜索：会员编号、手机号、会员昵称、真实姓名、成长等级（接口加载下拉）、付费等级（接口加载下拉）、会员状态（禁用/正常/待审核/已注销）（预期结果：条件录入完成（可随时点击重置清空条件））
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 确认「确定禁用该会员吗」后执行；本页隐藏全部内置操作（showOperate/showAdd/showEdit/对应按钮已隐藏），操作列6个自定义按钮

**操作步骤**：

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：启用会员

- **操作入口**：行操作[启用]按钮（仅状态=禁用显示）
- **操作说明**：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[结束: 启用会员完成]
```

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

- 「确定启用该会员吗」

#### 操作4：查看会员积分流水

- **操作入口**：行操作[积分明细]按钮
- **操作说明**：900px抽屉，标题含会员昵称与编号；打开即按memberId分页加载积分流水（9列：流水类型/变动积分/变动前积分/变动后积分/业务类型/业务描述/规则名称等），10条/页

**操作步骤**：

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

- **操作入口**：行操作[优惠券明细]按钮
- **操作说明**：900px抽屉；7列（券码/券名称/面值或折扣/领取时间/失效时间/状态等）；状态映射：未使用/已使用/已过期/已冻结/已作废；10条/页

**操作步骤**：

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

#### 操作6：给会员加积分

- **操作入口**：行操作[加积分]按钮
- **操作说明**：400px弹窗；积分数量必填(1-999999)，≤0时提示「请输入有效的积分数量」；业务描述选填；成功后提示积分增加成功并刷新列表

**操作步骤**：

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

- **操作入口**：行操作[扣积分]按钮
- **操作说明**：400px弹窗；积分数量必填(1-999999)，≤0时提示「请输入有效的积分数量」；业务描述选填；成功后提示积分扣减成功并刷新列表

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「给会员扣积分」对应入口）
2. 触发操作：行操作[扣积分]按钮：在页面 的区域「积分加减弹窗」中，通过行操作[扣积分]按钮触发「给会员扣积分」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；400px弹窗（预期结果：目标记录的操作按钮可见可用）
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 发票申请

**进入方式**：

> 系统左侧菜单：业务管理 > 会员管理 > 发票申请

**页面说明**：

> 本页为「会员 · 发票申请」功能页面。说明：处理会员提交的发票申请：抬头、税号与开票状态；支持审核上传附件并与订单衔接

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

| 筛选项 |
|--------|
| 订单编号输入 |
| 会员关键词输入(编号/昵称/姓名/手机号) |
| 业务类型下拉(商城/酒店/景区/美食/休闲/讲解/年卡/研学/非遗/文化/线路/村落) |
| 状态下拉(待审核/已开票/已驳回) |
| 发票抬头输入 |
| 搜索/重置按钮 |

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

**列表展示内容**：业务类型、订单编号(el-link可点开订单详情)、会员编号、会员姓名、会员手机、发票类型(个人/企业)、发票抬头、金额、状态标签(已开票绿/已驳回红/待审核黄)、附件(有附件时el-link可下载)、申请时间、行操作列280px

**列表说明**：行操作：下载(仅有附件时显示)、同意(仅待审核)、驳回(仅待审核)；订单编号缺orderId时提示「缺少关联订单，无法查看详情」

**订单详情抽屉**（点击订单编号链接打开）：包含 el-drawer 520px；el-descriptions动态行(按业务类型拉取订单详情)；底部按钮(关闭/前往订单管理)
说明：标题格式「业务类型 · 订单编号」；[前往订单管理]按业务类型路由跳转对应订单管理页并携带orderNo/orderId；详情为空提示「未获取到订单详情」，加载失败提示「加载订单详情失败」

**审核弹窗**（点击行操作[同意]或[驳回]打开）：包含 弹窗 520px(标题：同意开票/驳回申请)；审核备注多行文本；发票附件文件上传(仅同意时显示)；已上传文件名与下载链接；取消/确定按钮
说明：同意时未上传发票附件提示「同意时请先上传发票附件」；上传成功提示「附件上传成功」；提交成功提示「审核成功」并整页刷新(location.reload)

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

#### 操作1：按条件筛选发票申请

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

#### 操作2：下载发票附件

- **操作入口**：附件列 链接 / 行操作[下载]按钮（仅有附件时显示）
- **操作说明**：只读审核页：无内置增删改查弹窗（showView/showAdd/showEdit/showDelete/对应按钮已隐藏），仅行级下载与审核操作

**操作步骤**：

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

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

**操作流程图**：

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

#### 操作3：同意开票

- **操作入口**：行操作[同意]按钮（仅待审核显示）
- **操作说明**：打开审核弹窗（标题「同意开票」），需上传发票附件后提交

**操作步骤**：

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[结束: 同意开票完成]
```

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

- 「同意开票」

#### 操作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：查看关联订单详情

- **操作入口**：订单编号 链接 链接
- **操作说明**：520px抽屉，标题「业务类型 · 订单编号」；按业务类型拉取订单详情动态行；订单编号缺orderId时提示「缺少关联订单，无法查看详情」；详情为空提示「未获取到订单详情」，加载失败提示「加载订单详情失败」；底部[前往订单管理]按业务类型路由跳转对应订单管理页并携带orderNo/orderId

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「查看关联订单详情」对应入口）
2. 触发操作：订单编号 链接 链接：在页面 的区域「订单详情抽屉」中，通过订单编号 链接 链接触发「查看关联订单详情」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：520px抽屉，标题「业务类型 · 订单编号」（预期结果：条件录入完成（可随时点击重置清空条件））
4. 点击查询/搜索按钮：提交筛选条件，系统按条件查询当前租户范围数据（预期结果：列表按条件刷新，分页同步更新）
5. 操作结果反馈：系统提示「缺少关联订单，无法查看详情」，列表/界面同步刷新最新数据（预期结果：看到「缺少关联订单，无法查看详情」提示且数据已更新）

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

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入发票申请页面] --> B[检查登录与权限]
 B -->|权限正常| C[订单编号 el-link 链接]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 查看关联订单详情完成]
```

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

- 「业务类型 · 订单编号」
- 「缺少关联订单，无法查看详情」
- 「未获取到订单详情」
- 「加载订单详情失败」

#### 操作6：提交发票审核结果

- **操作入口**：审核弹窗[确定]按钮
- **操作说明**：520px弹窗；审核备注多行文本；发票附件文件上传（仅同意时显示，同意时未上传提示「同意时请先上传发票附件」）；上传成功提示「附件上传成功」；提交成功提示「审核成功」并整页刷新(location.reload)

**操作步骤**：

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[结束: 提交发票审核结果完成]
```

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

- 「同意时请先上传发票附件」
- 「附件上传成功」
- 「审核成功」

---

### 2.3 积分规则

**进入方式**：

> 系统左侧菜单：业务管理 > 会员管理 > 积分规则

**页面说明**：

> 本页为「会员 · 积分规则」功能页面。说明：按业务场景配置积分赠送规则，支持按会员等级差异化计分，规则变更后即时生效；[新建规则]跳转独立编辑页

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

| 筛选项 |
|--------|
| 场景编码下拉(接口加载场景列表) |
| 规则名称输入 |
| 计算方式下拉(接口加载) |
| 状态下拉 |
| 搜索/重置按钮 |

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

**列表展示内容**：工具栏[新建规则]按钮、场景编码、场景名称、规则名称、计算方式、基础分、日上限(0显示不限)、状态标签(启用绿/停用灰)、创建时间、行操作[编辑](跳独立编辑页)

**列表说明**：空数据提示「暂无积分规则」；操作列宽200px，仅编辑按钮，跳转携带规则id

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

#### 操作1：新建积分规则

- **操作入口**：页头右侧[新建规则]按钮
- **操作说明**：跳转独立编辑页 对应整页表单 录入新规则（独立编辑页模式：列表页 showAdd/showEdit/对应按钮已隐藏）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「新建积分规则」对应入口）
2. 触发操作：页头右侧[新建规则]按钮：在页面 的区域「页面简介区」中，通过页头右侧[新建规则]按钮触发「新建积分规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：跳转独立编辑页 对应整页表单 录入新规则（独立编辑页模式：列表页 showAdd/showEdit/对应按钮已隐藏）（预期结果：字段录入完成，未触发校验红字）
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项搜索：场景编码（接口加载场景列表下拉）、规则名称、计算方式（接口加载下拉）、状态

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选积分规则」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选积分规则」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：4项搜索：场景编码（接口加载场景列表下拉）、规则名称、计算方式（接口加载下拉）、状态（预期结果：条件录入完成（可随时点击重置清空条件））
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）；空数据提示「暂无积分规则」；日上限0显示不限；规则变更后即时生效

**操作步骤**：

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

**进入方式**：

> 系统左侧菜单：业务管理 > 会员管理 > 积分流水

**页面说明**：

> 本页为「会员 · 积分流水」功能页面。说明：查看会员积分变动记录，支持按会员、流水类型、业务类型筛选与导出

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

| 筛选项 |
|--------|
| 会员关键词输入(编号/昵称/姓名/手机) |
| 流水类型下拉(获取/消费/冻结/解冻/过期/调整) |
| 业务类型下拉(订单消费赠送/新会员注册/订单取消扣回/每日签到/积分兑换优惠券/人工调整/活动奖励/退款扣减,可搜索) |
| 业务ID输入 |
| 创建时间区间(起止日期时间) |
| 搜索/重置按钮 |

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

**列表展示内容**：工具栏[导出]按钮(权限member:pointsLog:export)、会员编号、会员姓名、会员手机、流水类型、变动积分、变动前、变动后、业务类型、业务描述、规则名称、创建时间、行操作[详情](权限member:pointsLog:info)

**列表说明**：空数据提示「暂无积分流水」；导出按当前搜索条件最多50000条生成Excel（文件名积分流水_时间戳.xlsx），成功提示「导出成功」失败提示「导出失败」

**积分流水详情弹窗**（点击行操作[详情]打开）：包含 弹窗 640px；el-descriptions 2列14项(会员编号/会员姓名/会员手机/流水类型/变动积分/变动前后/业务类型/业务ID/业务描述/积分规则/操作来源/过期时间/创建时间)
说明：先展示列表行数据再按id拉详情，详情接口失败时保留列表行数据

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

#### 操作1：按条件筛选积分流水

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：5项搜索：会员关键词（编号/昵称/姓名/手机）、流水类型（获取/消费/冻结/解冻/过期/调整）、业务类型（订单消费赠送/新会员注册/订单取消扣回/每日签到/积分兑换优惠券/人工调整/活动奖励/退款扣减，可搜索）、业务ID、创建时间区间（起止日期时间）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选积分流水」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选积分流水」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：5项搜索：会员关键词（编号/昵称/姓名/手机）、流水类型（获取/消费/冻结/解冻/过期/调整）、业务类型（订单消费赠送/新会员注册/订单取消扣回/每日签到/积分兑换优惠券/人工调整/活动奖励/退款扣减，可搜索）、业务ID、创建时间区间（起止日期时间）（预期结果：条件录入完成（可随时点击重置清空条件））
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：导出积分流水

- **操作入口**：工具栏[导出]按钮
- **操作说明**：权限 对应操作权限（v-hasPermi指令）；按当前搜索条件最多50000条生成Excel（文件名「积分流水_时间戳.xlsx」），成功提示「导出成功」失败提示「导出失败」；只读日志页：showView/showAdd/showEdit/showDelete/对应按钮已隐藏

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（对应操作权限）（预期结果：若权限不足，页面不显示「导出积分流水」对应入口）
2. 触发操作：工具栏[导出]按钮：在页面 的区域「积分流水列表区」中，通过工具栏[导出]按钮触发「导出积分流水」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 录入/选择配置内容：按界面要求填写配置项：权限 对应操作权限（v-hasPermi指令）（预期结果：必填项填写完成，格式校验通过）
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[结束: 导出积分流水完成]
```

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

- 「积分流水_时间戳.xlsx」
- 「导出成功」
- 「导出失败」

#### 操作3：查看积分流水详情

- **操作入口**：行操作[详情]按钮
- **操作说明**：权限 对应操作权限（v-hasPermi指令）；640px弹窗，el-descriptions 2列14项（会员编号/会员姓名/会员手机/流水类型/变动积分/变动前后/业务类型/业务ID/业务描述/积分规则/操作来源/过期时间/创建时间）；先展示列表行数据再按id拉详情，详情接口失败时保留列表行数据

**操作步骤**：

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

---

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

| 操作 | 界面提示 | 处理建议 |
|------|---------|---------|
| 禁用会员 | 「确定禁用该会员吗」 | 属正常反馈，按提示继续操作 |
| 启用会员 | 「确定启用该会员吗」 | 属正常反馈，按提示继续操作 |
| 给会员加积分 | 「请输入有效的积分数量」 | 按提示补齐必填信息或修正输入后重试 |
| 同意开票 | 「同意开票」 | 属正常反馈，按提示继续操作 |
| 驳回发票申请 | 「驳回申请」 | 属正常反馈，按提示继续操作 |
| 查看关联订单详情 | 「业务类型 · 订单编号」 | 属正常反馈，按提示继续操作 |
| 查看关联订单详情 | 「缺少关联订单，无法查看详情」 | 属正常反馈，按提示继续操作 |

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