# MOD_008 美丽乡村

## 一、功能简介

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

**常用场景**：

- 运营录入乡村旅游目的地（村落/农庄）并上架体验套餐
- 客服处理乡村游预约单（确认/核销）

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

| 页面 | 进入方式 |
|------|---------|
| 乡村目的地 | 业务管理 > 美丽乡村 > 乡村目的地 |
| 乡村套餐 | 业务管理 > 美丽乡村 > 乡村套餐 |
| 乡村预约 | 业务管理 > 美丽乡村 > 乡村预约 |

---

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

### 2.1 乡村目的地

**进入方式**：

> 系统左侧菜单：业务管理 > 美丽乡村 > 乡村目的地

**页面说明**：

> 标题「美丽乡村 · 目的地」，维护小程序美丽乡村目的地卡片；新增与编辑在独立页面完成，本页负责筛选、删除与列表展示

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

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

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

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

**工具栏**：跳转独立编辑页 对应功能页面

**列表说明**：列：序号/封面(可预览)/目的地名称/分类/评分/位置/电话/排序/状态/创建时间；内置增删改禁用，keep-alive 返回自动刷新

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

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

#### 操作1：条件筛选乡村目的地

- **操作入口**：搜索表单[查询]（名称 input/分类 select/状态 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，跳转独立表单页 对应功能页面）
- **操作说明**：跳转后由目的地编辑页完成维护，保存后返回本页自动刷新

**操作步骤**：

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：目的地列表查询与分页

- **操作入口**：列表自动加载/翻页（展示：序号/封面/目的地名称/分类/评分/位置/电话/排序/状态（上架=绿tag、下线=灰tag）/创建时间）
- **操作说明**：仅上架目的地对小程序 C 端可见

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「目的地列表查询与分页」对应入口）
2. 触发操作：列表自动加载/翻页/创建时间）：在页面 的区域「目的地列表区」中，通过列表自动加载/翻页/创建时间）触发「目的地列表查询与分页」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：仅上架目的地对小程序 C 端可见（预期结果：条件录入完成（可随时点击重置清空条件））
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 乡村套餐

**进入方式**：

> 系统左侧菜单：业务管理 > 美丽乡村 > 乡村套餐

**页面说明**：

> 标题「美丽乡村 · 体验套餐」，在目的地下配置可预约的体验套餐；新增与编辑在独立页面完成，本页负责筛选、删除与列表展示

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

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

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

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

**工具栏**：跳转独立编辑页 对应功能页面

**列表说明**：列：序号/目的地(名称·分类联动展示)/套餐名称/副标题/现价/原价/排序/状态/创建时间；内置增删改禁用，keep-alive 返回自动刷新

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

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

#### 操作1：条件筛选乡村套餐

- **操作入口**：搜索表单[查询]（目的地 input 按目的地主键筛选（占位提示「按目的地主键筛选（列表展示名称）」）/套餐名称 input/状态 select 上架、下线，均支持清空）
- **操作说明**：各条件可组合使用

**操作步骤**：

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

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

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入乡村套餐页面] --> B[检查登录与权限]
 B -->|权限正常| C[搜索表单「查询」」）/套餐名称 input/状态 select 上架、下线，均支持清空）]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 条件筛选乡村套餐完成]
```

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

- 「按目的地主键筛选（列表展示名称）」

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

- **操作入口**：工具栏[新增套餐]（primary，跳转独立表单页 对应功能页面）
- **操作说明**：跳转后由套餐编辑页完成维护（布局同路线管理编辑页），保存后返回本页自动刷新

**操作步骤**：

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：套餐列表查询与分页

- **操作入口**：列表自动加载/翻页（展示：序号/目的地（名称·分类联动展示，查询失败显示「未知目的地」）/套餐名称/副标题/现价（按元展示）/原价（按元展示）/排序/状态（上架=绿tag、下线=灰tag）/创建时间）
- **操作说明**：仅上架套餐对小程序 C 端可见；无数据时展示「没有更多数据了！」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「套餐列表查询与分页」对应入口）
2. 触发操作：列表自动加载/翻页/套餐名称/副标题/现价/原价/排序/状态/创建时间）：在页面 的区域「套餐列表区」中，通过列表自动加载/翻页/套餐名称/副标题/现价/原价/排序/状态/创建时间）触发「套餐列表查询与分页」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：仅上架套餐对小程序 C 端可见（预期结果：条件录入完成（可随时点击重置清空条件））
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：编辑套餐

- **操作入口**：行操作[编辑]（跳转独立表单页，携带套餐 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.3 乡村预约

**进入方式**：

> 系统左侧菜单：业务管理 > 美丽乡村 > 乡村预约

**页面说明**：

> 标题「美丽乡村 · 预约单」，查看用户提交的乡村体验预约订单；仅支持查看详情与到店核销，不支持新建或修改订单

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

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

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

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

**工具栏（到店核销）**：点击弹出 prompt 输入框「请输入顾客出示的乡村体验预约核销码」，确认后核销并刷新列表

**列表说明**：列：序号/业务单号/交易单号/目的地名称/套餐名称/会员编号/会员姓名/会员手机/数量/手机号/核销码/状态/创建时间；增删改全部禁用（只读业务单）

**行操作区**：仅「详情」，打开 680px 详情抽屉

**预约单详情抽屉**（conditional）：包含 el-drawer[680px]；el-tag[状态]；el-descriptions[会员信息]；el-descriptions[预约信息]；el-descriptions[预约结果说明]；el-descriptions[其他补充信息]；el-descriptions[时间记录]；el-button[复制]
说明：头部显示业务单号/交易单号/目的地·套餐；分区块：会员信息、预约信息(含核销码复制)、预约结果说明(小程序成功页摘要)、其他补充信息、时间记录(创建/更新/核销/取消/过期)

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

#### 操作1：到店核销

- **操作入口**：工具栏[到店核销]（primary plain，弹出输入框，标题「乡村预约核销」）
- **操作说明**：提示「请输入顾客出示的乡村体验预约核销码」，核销码不能为空（为空提示「核销码不能为空」）；点击[确认核销]后按核销码核销，成功提示「核销成功」并刷新列表；核销失败展示后端返回的错误信息（默认「核销失败」）；点击[取消]关闭弹窗不核销

**操作步骤**：

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：条件筛选乡村预约单

- **操作入口**：搜索表单[查询]（交易单号 input/业务单号 input/目的地名称 input 模糊匹配/套餐名称 input 模糊匹配/会员关键词 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[结束: 条件筛选乡村预约单完成]
```

#### 操作3：预约单列表查询与分页

- **操作入口**：列表自动加载/翻页（展示：序号/业务单号/交易单号/目的地名称/套餐名称/会员编号/会员姓名/会员手机/数量/手机号/核销码/状态（已使用=绿tag、待使用=橙tag、已取消·已过期=灰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：打开预约单详情

- **操作入口**：行操作[详情]（打开 680px 详情抽屉）
- **操作说明**：任意状态的预约单均可查看详情

**操作步骤**：

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
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 查看预约单详情完成]
```

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

- 「暂无预约单数据」
- 「核销码已复制」
- 「当前环境不支持自动复制」

---

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

| 操作 | 界面提示 | 处理建议 |
|------|---------|---------|
| 封面图片预览 | 「—」 | 属正常反馈，按提示继续操作 |
| 条件筛选乡村套餐 | 「按目的地主键筛选（列表展示名称）」 | 属正常反馈，按提示继续操作 |
| 套餐列表查询与分页 | 「没有更多数据了！」 | 属正常反馈，按提示继续操作 |
| 套餐列表查询与分页 | 「未知目的地」 | 属正常反馈，按提示继续操作 |
| 到店核销 | 「请输入顾客出示的乡村体验预约核销码」 | 按提示补齐必填信息或修正输入后重试 |
| 到店核销 | 「核销码不能为空」 | 按提示补齐必填信息或修正输入后重试 |
| 到店核销 | 「核销成功」 | 属正常反馈，按提示继续操作 |
| 到店核销 | 「核销失败」 | 稍后重试，仍失败请联系管理员 |

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