# MOD_011 讲解服务

## 一、功能简介

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

**常用场景**：

- 运营录入讲解点并上传语音讲解音轨
- 运营组合讲解点形成讲解套餐（人工讲解/电子导览）
- 客服处理游客讲解预约单（派单/核销）

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

| 页面 | 进入方式 |
|------|---------|
| 讲解点管理 | 业务管理 > 讲解 > 讲解点管理 |
| 讲解音轨 | 业务管理 > 讲解 > 讲解音轨 |
| 讲解套餐 | 业务管理 > 讲解 > 讲解套餐 |
| 讲解预约单 | 业务管理 > 讲解 > 讲解预约单 |

---

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

### 2.1 讲解点管理

**进入方式**：

> 系统左侧菜单：业务管理 > 讲解 > 讲解点管理

**页面说明**：

> 标题「讲解点管理」，维护小程序游览讲解的讲解专辑主数据；新增与编辑在独立页面完成（左侧录入、右侧实时预览小程序详情）；音轨与套餐在对应菜单按讲解点配置

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

| 筛选项 |
|--------|
| 页面内置搜索表单 |

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

**列表展示内容**：列表、表格*9

**工具栏**：跳转独立编辑页（路由名 businessExplainSpotEditor）

**列表说明**：列：序号/封面(可预览)/名称/导览POI/分类/评分/位置文案/状态/排序；内置增删改禁用，keep-alive 返回自动刷新

**行操作区**：编辑跳独立编辑页（带讲解点 id 与来源路径）

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

#### 操作1：条件筛选讲解点

- **操作入口**：搜索表单[查询]（名称 input 模糊筛选/分类 select/导览 POI input 主键精确/状态 select 上架、下线，均支持清空）
- **操作说明**：各条件可组合使用

**操作步骤**：

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[结束: 条件筛选讲解点完成]
```

#### 操作2：新增讲解点

- **操作入口**：工具栏[新增讲解点]（primary，跳转独立表单页 businessExplainSpotEditor）
- **操作说明**：跳转后由讲解点编辑页完成维护（左侧录入、右侧实时预览小程序详情），保存后返回本页自动刷新

**操作步骤**：

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：讲解点列表查询与分页

- **操作入口**：列表自动加载/翻页（展示：序号/封面/名称/导览 POI（未绑定显示「—」）/分类/评分/位置文案/状态（上架=绿tag、下线=灰tag）/排序）
- **操作说明**：仅上架讲解点对小程序游览讲解可见；无数据时展示「暂无讲解点」

**操作步骤**：

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[结束: 讲解点列表查询与分页完成]
```

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

- 「暂无讲解点」
- 「—」

#### 操作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：编辑讲解点

- **操作入口**：行操作[编辑]（跳转独立表单页，携带讲解点 id 与返回来源）
- **操作说明**：保存后返回本页自动刷新

**操作步骤**：

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[结束: 编辑讲解点完成]
```

#### 操作6：删除讲解点

- **操作入口**：行操作[删除]（页面内置，确认后删除）
- **操作说明**：删除后列表自动刷新

**操作步骤**：

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[结束: 删除讲解点完成]
```

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

#### 操作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[结束: 批量删除讲解点完成]
```

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

---

### 2.2 讲解音轨

**进入方式**：

> 系统左侧菜单：业务管理 > 讲解 > 讲解音轨

**页面说明**：

> 标题「讲解音轨」，维护讲解点下的分段音频（小程序游览讲解选段播放与展线顺序）；请先在讲解点管理建好讲解点

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

| 筛选项 |
|--------|
| 页面内置搜索表单 |

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

**列表展示内容**：列表、表格*7

**列表说明**：列：序号/讲解点名称/章节标题/展示时长/音频(已上传·—)/状态/展线顺序；查看禁用，列表按登录租户范围查询

**内置行操作与大弹窗表单**（always）：包含 内置新增；内置编辑；内置删除/批量删除；弹窗[large]；el-select[讲解点]；el-audio-upload-one；自定义槽位[口播稿]
说明：弹窗表单分四段：归属与章节(讲解点下拉必填/章节标题必填)、展示时长与展线顺序(时长/顺序/上架状态)、讲解音频(上传≤30MB 公网OSS)、口播稿(自定义文本域≤1000字)；保存自动附加当前租户

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

#### 操作1：音轨列表查询与分页

- **操作入口**：列表自动加载/翻页（展示：序号/讲解点名称/章节标题/展示时长/音频（已上传、未上传显示「—」）/状态（上架=绿tag、下线=灰tag）/展线顺序）
- **操作说明**：仅上架音轨对小程序游览讲解可见；无数据时展示「暂无音轨数据」

**操作步骤**：

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[结束: 音轨列表查询与分页完成]
```

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

- 「暂无音轨数据」
- 「—」

#### 操作2：新增音轨

- **操作入口**：工具栏[新增]（页面内置，打开 large 弹窗表单）
- **操作说明**：讲解点下拉必选（未选择提示「请选择讲解点」，下拉加载最多500个讲解点，加载失败时下拉为空但其它字段仍可填写）；章节标题必填（未填写提示「请填写章节标题」，占位「小程序播放列表标题，如：序厅、第一展厅、酿造工艺」）；上架状态必选（默认上架，「下线则 C 端不展示本段」）；讲解音频上传限 30MB 以内（上传至公网 OSS）；口播稿/摘要选填纯文本最多1000字（带字数统计）；展线顺序同讲解点内越小越靠前；保存后列表自动刷新

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「新增音轨」对应入口）
2. 触发操作：工具栏[新增]：在页面 的区域「内置行操作与大弹窗表单」中，通过工具栏[新增]触发「新增音轨」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：讲解点下拉必选（未选择提示「请选择讲解点」，下拉加载最多500个讲解点，加载失败时下拉为空但其它字段仍可填写）（预期结果：字段录入完成，未触发校验红字）
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[结束: 新增音轨完成]
```

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

- 「请选择讲解点」
- 「请填写章节标题」
- 「小程序播放列表标题，如：序厅、第一展厅、酿造工艺」
- 「下线则 C 端不展示本段」

#### 操作3：编辑音轨

- **操作入口**：行操作[编辑]（页面内置，打开 large 弹窗并回波音轨数据）
- **操作说明**：校验规则同新增；保存后列表自动刷新

**操作步骤**：

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[结束: 批量删除音轨完成]
```

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

---

### 2.3 讲解套餐

**进入方式**：

> 系统左侧菜单：业务管理 > 讲解 > 讲解套餐

**页面说明**：

> 标题「讲解套餐」，维护各讲解点下的可售套餐（定价/服务包含项/配图/预约说明）；新增与编辑在独立页面完成，请先完成讲解点管理

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

| 筛选项 |
|--------|
| 页面内置搜索表单 |

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

**列表展示内容**：列表、表格*10

**工具栏**：跳转独立编辑页 对应功能页面；URL 带 spotId 时预设讲解点

**列表说明**：列：序号/讲解点名称/套餐名称/包含项(预览首项+总数)/配图(N张)/现价/原价/场次提示/状态/排序；内置增删改禁用，列表按登录租户范围查询，keep-alive 返回自动刷新

**行操作区**：编辑跳独立编辑页（带套餐 id）

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

#### 操作1：条件筛选讲解套餐

- **操作入口**：搜索表单[查询]（讲解点名称 input 模糊匹配/套餐名称 input 关键词/上架状态 select 上架、下线，均支持清空）
- **操作说明**：各条件可组合使用；列表按当前登录租户范围查询

**操作步骤**：

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[结束: 条件筛选讲解套餐完成]
```

#### 操作2：新增讲解套餐

- **操作入口**：工具栏[新增讲解套餐]（primary，跳转独立表单页 对应功能页面）
- **操作说明**：若当前 URL 携带讲解点参数则编辑页预设该讲解点；跳转后由套餐编辑页完成维护，保存后返回本页自动刷新

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「新增讲解套餐」对应入口）
2. 触发操作：工具栏[新增讲解套餐]：在页面 的区域「工具栏」中，通过工具栏[新增讲解套餐]触发「新增讲解套餐」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：若当前 URL 携带讲解点参数则编辑页预设该讲解点（预期结果：字段录入完成，未触发校验红字）
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：套餐列表查询与分页

- **操作入口**：列表自动加载/翻页（展示：序号/讲解点名称/套餐名称/包含项（预览首项，多项显示「首项 等 N 项」）/配图（N 张）/现价（按元展示）/原价（按元展示）/场次提示/状态（上架=绿tag、下线=灰tag）/排序）
- **操作说明**：仅上架套餐对小程序可售；无数据时展示「暂无套餐数据」

**操作步骤**：

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[结束: 套餐列表查询与分页完成]
```

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

- 「暂无套餐数据」
- 「首项 等 N 项」

#### 操作4：编辑讲解套餐

- **操作入口**：行操作[编辑]（跳转独立表单页，携带套餐 id 与返回来源）
- **操作说明**：保存后返回本页自动刷新

**操作步骤**：

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：批量删除讲解套餐

- **操作入口**：勾选多行后工具栏[批量删除]（页面内置）
- **操作说明**：至少勾选一条记录

**操作步骤**：

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.4 讲解预约单

**进入方式**：

> 系统左侧菜单：业务管理 > 讲解 > 讲解预约单

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

| 筛选项 |
|--------|
| el-card[讲解预约单查询] |
| el-input[预约单ID] |
| el-button[查询] |

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

**查询结果展示区**：查询成功后以原始 JSON 形式展示预约单详情，无格式化描述列表

**可用性提示**：conditional

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

#### 操作1：按ID查询讲解预约单

- **操作入口**：卡片内输入框（占位「输入预约单 ID」）+[查询]按钮（primary）
- **操作说明**：未输入预约单 ID 时点击查询不执行任何请求

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「按ID查询讲解预约单」对应入口）
2. 触发操作：卡片内输入框+[查询]按钮：在页面 的区域「预约单查询卡片」中，通过卡片内输入框+[查询]按钮触发「按ID查询讲解预约单」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
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[结束: 按ID查询讲解预约单完成]
```

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

- 「输入预约单 ID」

---

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

| 操作 | 界面提示 | 处理建议 |
|------|---------|---------|
| 讲解点列表查询与分页 | 「暂无讲解点」 | 属正常反馈，按提示继续操作 |
| 讲解点列表查询与分页 | 「—」 | 属正常反馈，按提示继续操作 |
| 音轨列表查询与分页 | 「暂无音轨数据」 | 属正常反馈，按提示继续操作 |
| 新增音轨 | 「请选择讲解点」 | 按提示补齐必填信息或修正输入后重试 |
| 新增音轨 | 「请填写章节标题」 | 按提示补齐必填信息或修正输入后重试 |
| 新增音轨 | 「小程序播放列表标题，如：序厅、第一展厅、酿造工艺」 | 属正常反馈，按提示继续操作 |

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