# MOD_016 旅游年卡

## 一、功能简介

「旅游年卡」是系统的组成部分，供以下角色使用：超级管理员、业务运营。

**常用场景**：

- 运营创建年卡产品（价格/有效期）并配置权益（免票/折扣次数与适用范围）
- 客服查询会员年卡实例状态与开卡流水
- 运营核查权益钱包余额与权益使用流水

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

| 页面 | 进入方式 |
|------|---------|
| 年卡产品 | 业务管理 > 旅游年卡 > 产品 |
| 年卡卡实例 | 业务管理 > 旅游年卡 > 卡实例 |
| 开卡流水 | 业务管理 > 旅游年卡 > 开卡流水 |
| 权益配置 | 业务管理 > 旅游年卡 > 权益配置 |
| 权益流水 | 业务管理 > 旅游年卡 > 权益流水 |

---

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

### 2.1 年卡产品

**进入方式**：

> 系统左侧菜单：业务管理 > 旅游年卡 > 产品

**页面说明**：

> 本页为「旅游年卡 · 产品」功能页面。说明：维护小程序售卖的年卡套餐；免票、折扣等具体权益在列表「权益配置」中设置；说明文案会在小程序卡详情展示

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

| 筛选项 |
|--------|
| 卡档下拉(可输入创建,如普卡/银卡/金卡) |
| 有效期下拉(可输入创建,如季度卡/年卡) |
| 卡名称输入 |
| 上架状态下拉(下线/上架,提示仅上架产品在小程序展示) |
| 搜索/重置按钮 |

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

**列表展示内容**：卡档(编码转中文)、有效期(编码转中文)、卡名称、卡面风格(编码转中文)、售价(元)、划线价(元)、库存说明、展示排序、上架状态标签(上架绿/下线灰)、内置操作(查看/编辑/删除)+行操作[权益配置]

**列表说明**：内置新增/编辑/查看均打开大弹窗自定义表单；行操作[权益配置]打开产品权益抽屉；操作列360px；空数据提示「暂无年卡产品」；权限配置(addPermission/editPermission/deletePermission)在代码中被注释未启用

**产品编辑弹窗**（点击工具栏[新增]或行操作[编辑]/[查看]打开）：包含 大弹窗表单；基本信息组(卡档[必选可自填]/有效期[必选可自填]/卡名称[必填,小程序卡面主标题]/卡面风格[石色/青灰色/金色可自填]/售价元[必填≥0两位小数]/展示排序[数字越小越靠前]/上架状态[必选]/划线价[选填展示原价])；小程序展示文案组(权益说明多条录入[每条≤500字,新增一条/删除]/适用地点多条录入[每条≤500字]/卡面角标多条录入[每条≤64字]/激活说明多行/使用说明多行/退款说明多行/库存说明)；保存/取消按钮
说明：查看模式为只读：编码字段转为中文展示字段，多条文案禁用编辑；校验提示：请选择或填写卡档/请选择或填写有效期/请输入卡名称/请输入售价/请选择上架状态

**产品权益配置抽屉**（点击行操作[权益配置]打开）：包含 对应弹窗/抽屉(按产品id与卡名称加载)；权益列表维护
说明：维护该年卡产品的免票/折扣等具体权益（对应后端biz_yearcard_benefit及适用范围）

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

#### 操作1：按条件筛选年卡产品

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

#### 操作2：新增年卡产品

- **操作入口**：工具栏[新增]按钮
- **操作说明**：打开大弹窗自定义表单（基本信息组+小程序展示文案组）；权限配置（addPermission/editPermission/deletePermission）在代码中被注释未启用，当前所有登录用户可操作

**操作步骤**：

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[结束: 新增年卡产品完成]
```

#### 操作3：编辑年卡产品

- **操作入口**：行操作[编辑]按钮
- **操作说明**：打开大弹窗自定义表单修改产品信息；操作列360px

**操作步骤**：

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
 D --> F[点击查询]
 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[结束: 删除年卡产品完成]
```

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

- 「暂无年卡产品」

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

#### 操作6：打开产品权益配置抽屉

- **操作入口**：行操作[权益配置]按钮
- **操作说明**：打开 对应弹窗/抽屉（按产品id与卡名称加载），维护该年卡产品的免票/折扣等具体权益及适用范围

**操作步骤**：

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[结束: 打开产品权益配置抽屉完成]
```

#### 操作7：保存年卡产品

- **操作入口**：大弹窗表单[保存]按钮（新增/编辑共用）
- **操作说明**：基本信息组：卡档（必选可自填）/有效期（必选可自填）/卡名称（必填，小程序卡面主标题）/卡面风格（石色/青灰色/金色可自填）/售价元（必填≥0两位小数）/展示排序（数字越小越靠前）/上架状态（必选）/划线价（选填展示原价）；小程序展示文案组：权益说明、适用地点（多条录入每条≤500字）、卡面角标（多条录入每条≤64字）、激活说明/使用说明/退款说明（多行）、库存说明；校验提示：请选择或填写卡档/请选择或填写有效期/请输入卡名称/请输入售价/请选择上架状态；查看模式为只读（编码字段转中文展示，多条文案禁用编辑）

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围，权限配置未启用））（预期结果：若权限不足，页面不显示「保存年卡产品」对应入口）
2. 触发操作：大弹窗表单[保存]按钮：在页面 的区域「产品编辑弹窗」中，通过大弹窗表单[保存]按钮触发「保存年卡产品」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：基本信息组：卡档（必选可自填）/有效期（必选可自填）/卡名称（必填，小程序卡面主标题）/卡面风格（石色/青灰色/金色可自填）/售价元（必填≥0两位小数）/展示排序（数字越小越靠前）/上架状态（必选）/划线价（选填展示原价）（预期结果：字段录入完成，未触发校验红字）
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[结束: 保存年卡产品完成]
```

#### 操作8：维护产品权益

- **操作入口**：对应弹窗/抽屉 内权益维护操作
- **操作说明**：抽屉按产品id与卡名称加载；维护该年卡产品的免票/折扣等具体权益及适用范围；权益生效后会员持卡在小程序消费时按权益核销

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「维护产品权益」对应入口）
2. 触发操作：对应弹窗/抽屉 内权益维护操作：在页面 的区域「产品权益配置抽屉」中，通过YearcardProductBenefitDrawer 内权益维护操作触发「维护产品权益」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 录入/选择配置内容：按界面要求填写配置项：抽屉按产品id与卡名称加载（预期结果：必填项填写完成，格式校验通过）
4. 提交配置：点击保存/确定提交配置（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

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

**操作流程图**：

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

---

### 2.2 年卡卡实例

**进入方式**：

> 系统左侧菜单：业务管理 > 旅游年卡 > 卡实例

**页面说明**：

> 本页为「旅游年卡 · 卡实例」功能页面。说明：查看用户已持有的年卡实例；本页仅支持查看详情

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

| 筛选项 |
|--------|
| 会员关键词输入(编号/昵称/手机/会员主键) |
| 卡号输入(支持模糊) |
| 展示码输入 |
| 交易单号输入(支持模糊) |
| 状态下拉(待激活/使用中/已过期/已冻结/已注销) |
| 搜索/重置按钮 |

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

**列表展示内容**：卡名称、会员编号、会员姓名、手机号码、卡号、展示码、交易单号、生效时间、失效时间、状态标签(使用中绿/待激活黄/已过期已冻结已注销灰)、行操作[查看]

**列表说明**：无新增/编辑/删除按钮；操作列100px；空数据提示「暂无卡实例」

**卡实例详情弹窗**：全部字段只读，空值显示「—」

**可用性提示**：点击行操作[查看]打开

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

#### 操作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：查看年卡卡实例详情

- **操作入口**：行操作[查看]按钮
- **操作说明**：打开大弹窗只读表单，分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.3 开卡流水

**进入方式**：

> 系统左侧菜单：业务管理 > 旅游年卡 > 开卡流水

**页面说明**：

> 本页为「旅游年卡 · 开卡流水」功能页面。说明：查看购卡后的开卡/激活记录；本页仅支持查看详情

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

| 筛选项 |
|--------|
| 会员关键词输入(编号/昵称/手机/会员主键) |
| 卡号输入(支持模糊) |
| 标题输入(支持模糊) |
| 交易单号输入(支持模糊) |
| 业务单号输入(支持模糊) |
| 展示码输入 |
| 状态下拉(已创建/已激活/已过期/已关闭) |
| 搜索/重置按钮 |

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

**列表展示内容**：卡名称、会员编号、会员姓名、手机号码、卡号、业务单号、交易单号、标题、展示码、开卡时间、有效截止、状态标签(已激活绿/已创建黄/已过期已关闭灰)、行操作[查看]

**列表说明**：无新增/编辑/删除按钮；操作列100px；空数据提示「暂无开卡流水」

**开卡流水详情弹窗**：全部字段只读，空值显示「—」

**可用性提示**：点击行操作[查看]打开

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

#### 操作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：查看开卡流水详情

- **操作入口**：行操作[查看]按钮
- **操作说明**：打开大弹窗只读表单，分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.4 权益配置

**进入方式**：

> 系统左侧菜单：业务管理 > 旅游年卡 > 权益配置

**页面说明**：

> 本页为「旅游年卡 · 权益配置」功能页面。说明：按产品配置免票、折扣、赠券等权益及适用范围；保存后自动同步产品JSON摘要供小程序展示

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

| 筛选项 |
|--------|
| 产品ID输入(固定产品时隐藏) |
| 权益编码输入(精确匹配) |
| 权益名称输入 |
| 权益类型下拉(免票入园/折扣/固定减免/同行/发券/赠积分等) |
| 状态下拉(停用/启用) |
| 搜索/重置按钮 |

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

**列表展示内容**：产品ID列(未固定产品时显示)、编码、权益名称、类型(编码转中文)、范围数、配额、次数、优先级、状态标签(启用绿/停用灰)、内置操作(新增/编辑/删除)

**列表说明**：对应按钮已隐藏无查看；操作列260px；空数据提示「暂无权益配置」；同面板可嵌入年卡产品页权益抽屉复用

**权益编辑弹窗**（点击工具栏[新增]或行操作[编辑]打开）：包含 大弹窗表单(独立页1200px/嵌入920px)；权益编码提示(新增:保存后系统自动生成同产品唯一；编辑:只读展示编码不可修改)；基本信息组(权益名称[必填,C端展示]/权益类型[必选]/权益说明[选填≤500字,同步产品展示文案])；配额与次数组(配额类型[不限次/限次]/配额数值[≥1]/每日上限[0不限]；发券赠积分类隐藏)；优惠参数组(按类型显隐：折扣率[0~1,0.85=85折]/减免金额[元]/同行人数)；发放配置组(仅发券/赠积分显示：券模板ID+发券张数或赠送积分；开卡或周期刷新时自动发放)；核验与排序组(需预约[否/是]/核验方式[默认动态码]/可叠券[否/是]/优先级[越小越优先]/排序/状态[必选])；适用范围自定义面板(多卡片：范围类型[场馆/门票产品/门票SKU/业态/全平台]+展示名+对应关联选择[场馆下拉/门票产品下拉/SKU规格/业态下拉/全平台免填]+状态[启用/停用]；[+添加适用范围][删除])
说明：权益类型切换自动显隐对应字段并推荐默认范围类型（折扣/减免→门票产品，发券/赠积分→全平台，其余→场馆）；校验提示：请输入产品ID/请输入权益名称/请选择权益类型/请选择状态；场馆与门票产品选项来自景区模块启用数据

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

#### 操作1：切换查看全部产品权益

- **操作入口**：产品过滤提示条[查看全部产品权益]链接（仅URL带productId时显示）
- **操作说明**：提示条展示当前产品名与产品ID；点击链接移除产品过滤，查看全量权益配置

**操作步骤**：

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 --> G[列表按条件刷新]
 G --> Z[结束: 切换查看全部产品权益完成]
```

#### 操作2：按条件筛选权益配置

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

#### 操作3：新增权益

- **操作入口**：工具栏[新增]按钮
- **操作说明**：打开权益编辑弹窗（独立页1200px）；对应按钮已隐藏无查看；操作列260px；空数据提示「暂无权益配置」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「新增权益」对应入口）
2. 触发操作：工具栏[新增]按钮：在页面 的区域「权益列表区」中，通过工具栏[新增]按钮触发「新增权益」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：打开权益编辑弹窗（独立页1200px）（预期结果：字段录入完成，未触发校验红字）
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
 D -->|校验通过| F[点击保存/提交]
 F -->|失败| E1
 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[结束: 删除权益完成]
```

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

#### 操作6：保存权益配置

- **操作入口**：权益编辑弹窗[保存]按钮（新增/编辑共用）
- **操作说明**：权益编码新增时保存后系统自动生成（同产品唯一），编辑时只读不可修改；基本信息组：权益名称（必填，C端展示）/权益类型（必选）/权益说明（选填≤500字，同步产品展示文案）；配额与次数组：配额类型（不限次/限次）/配额数值（≥1）/每日上限（0不限），发券赠积分类隐藏；优惠参数组按类型显隐：折扣率（0~1，0.85=85折）/减免金额（元）/同行人数；发放配置组仅发券/赠积分显示（券模板ID+张数或赠送积分，开卡或周期刷新时自动发放）；核验与排序组：需预约/核验方式（默认动态码）/可叠券/优先级（越小越优先）/排序/状态（必选）；适用范围自定义面板多卡片：范围类型（场馆/门票产品/门票SKU/业态/全平台）+展示名+关联选择+状态，可[+添加适用范围]/[删除]；类型切换自动显隐字段并推荐默认范围类型（折扣/减免→门票产品，发券/赠积分→全平台，其余→场馆）；校验提示：请输入产品ID/请输入权益名称/请选择权益类型/请选择状态；场馆与门票产品选项来自景区模块启用数据；保存后自动同步产品JSON摘要供小程序展示

**操作步骤**：

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 权益流水

**进入方式**：

> 系统左侧菜单：业务管理 > 旅游年卡 > 权益流水

**页面说明**：

> 本页为「旅游年卡 · 权益使用流水」功能页面。说明：核销、抵扣、发券等权益使用记录，含会员编号、姓名与手机；导出按当前搜索条件最多50000条（文件名年卡权益流水_时间戳.xlsx），成功提示「导出成功」失败提示「导出失败」

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

| 筛选项 |
|--------|
| 会员关键词输入(编号/昵称/手机) |
| 实例ID输入 |
| 权益ID输入 |
| 使用类型下拉(核销/下单抵扣/发券/发积分/冲正) |
| 场馆ID输入 |
| 搜索/重置按钮 |

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

**列表展示内容**：会员编号、会员姓名、会员手机、权益名称、类型、状态、次数、减免额、场馆、核销码、时间、行操作[查看]

**列表说明**：操作列120px；空数据提示「暂无流水」

**人工核销弹窗**（点击页头[人工核销]打开）：包含 弹窗 480px；核销码输入(必填,会员动态码/卡面码)；场馆ID输入(可选,校验适用范围)；钱包ID输入(可选,指定权益钱包)；核销次数数字输入(1-99)；取消/确认核销按钮(提交中带loading)
说明：未填核销码提示「请输入核销码」；成功提示「核销成功」并关闭弹窗；失败走全局拦截提示

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

#### 操作1：打开人工核销弹窗

- **操作入口**：页头右侧[人工核销]按钮
- **操作说明**：打开 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[结束: 打开人工核销弹窗完成]
```

#### 操作2：导出权益流水Excel

- **操作入口**：页头右侧[导出 Excel]按钮
- **操作说明**：按当前搜索条件导出最多50000条，文件名「年卡权益流水_时间戳.xlsx」；成功提示「导出成功」，失败提示「导出失败」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「导出权益流水Excel」对应入口）
2. 触发操作：页头右侧[导出 Excel]按钮：在页面 的区域「页面简介区」中，通过页头右侧[导出 Excel]按钮触发「导出权益流水Excel」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 录入/选择配置内容：按界面要求填写配置项：按当前搜索条件导出最多50000条，文件名「年卡权益流水_时间戳.xlsx」（预期结果：必填项填写完成，格式校验通过）
4. 提交配置：点击保存/确定提交配置（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「导出成功」，列表/界面同步刷新最新数据（预期结果：看到「导出成功」提示且数据已更新）

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

**操作流程图**：

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

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

- 「年卡权益流水_时间戳.xlsx」
- 「导出成功」
- 「导出失败」

#### 操作3：按条件筛选权益流水

- **操作入口**：搜索表单[搜索/重置]按钮
- **操作说明**：5项搜索：会员关键词（编号/昵称/手机）、实例ID、权益ID、使用类型（核销/下单抵扣/发券/发积分/冲正）、场馆ID

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按条件筛选权益流水」对应入口）
2. 触发操作：搜索表单[搜索/重置]按钮：在页面 的区域「搜索区」中，通过搜索表单[搜索/重置]按钮触发「按条件筛选权益流水」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：5项搜索：会员关键词（编号/昵称/手机）、实例ID、权益ID、使用类型（核销/下单抵扣/发券/发积分/冲正）、场馆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[结束: 按条件筛选权益流水完成]
```

#### 操作4：查看权益流水详情

- **操作入口**：行操作[查看]按钮
- **操作说明**：流水只读（showAdd/showEdit/对应按钮已隐藏，CRUD写操作直接拒绝）；操作列120px；空数据提示「暂无流水」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「查看权益流水详情」对应入口）
2. 触发操作：行操作[查看]按钮：在页面 的区域「权益流水列表区」中，通过行操作[查看]按钮触发「查看权益流水详情」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：流水只读（showAdd/showEdit/对应按钮已隐藏，CRUD写操作直接拒绝）（预期结果：条件录入完成（可随时点击重置清空条件））
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：提交人工核销

- **操作入口**：核销弹窗[确认核销]按钮
- **操作说明**：核销码必填（会员动态码/卡面码），场馆ID可选（校验适用范围），钱包ID可选（指定权益钱包），核销次数1-99；未填核销码提示「请输入核销码」；成功提示「核销成功」并关闭弹窗；失败走全局拦截提示；提交中带loading

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「提交人工核销」对应入口）
2. 触发操作：核销弹窗[确认核销]按钮：在页面 的区域「人工核销弹窗」中，通过核销弹窗[确认核销]按钮触发「提交人工核销」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；核销码必填（会员动态码/卡面码），场馆ID可选（校验适用范围），钱包ID可选（指定权益钱包），核销次数1-99（预期结果：目标记录的操作按钮可见可用）
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[结束: 提交人工核销完成]
```

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

- 「请输入核销码」
- 「核销成功」

---

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

| 操作 | 界面提示 | 处理建议 |
|------|---------|---------|
| 删除年卡产品 | 「暂无年卡产品」 | 属正常反馈，按提示继续操作 |
| 查看年卡卡实例详情 | 「—」 | 属正常反馈，按提示继续操作 |
| 新增权益 | 「暂无权益配置」 | 属正常反馈，按提示继续操作 |
| 导出权益流水Excel | 「年卡权益流水_时间戳.xlsx」 | 属正常反馈，按提示继续操作 |
| 导出权益流水Excel | 「导出成功」 | 属正常反馈，按提示继续操作 |
| 导出权益流水Excel | 「导出失败」 | 稍后重试，仍失败请联系管理员 |
| 查看权益流水详情 | 「暂无流水」 | 属正常反馈，按提示继续操作 |

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