# MOD_009 导览管理

## 一、功能简介

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

**常用场景**：

- 运营维护导览景区与POI点位（地图坐标/分类/语音）
- 运营查看导览数据同步日志排查小程序导览异常

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

| 页面 | 进入方式 |
|------|---------|
| 导览POI | 业务管理 > 导览管理 > 导览POI |
| 景区管理 | 业务管理 > 导览管理 > 景区管理 |
| 导览同步日志 | 业务管理 > 导览管理 > 导览同步日志 |

---

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

### 2.1 导览POI

**进入方式**：

> 系统左侧菜单：业务管理 > 导览管理 > 导览POI

**页面说明**：

> 标题「智能导览 · 地图点位」，维护小程序智能导览地图兴趣点；新增与编辑在独立页面完成（右侧实时预览小程序详情效果）；每个导览点最多绑定一条讲解专辑

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

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

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

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

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

**列表说明**：列：序号/点位名称/主分类/子类型/地图图标(缩略可预览，无则显示「默认」)/位置说明/状态(tag 上架·下线)/排序；内置增删改禁用，列表按登录租户范围查询，keep-alive 返回自动刷新

**行操作区**：编辑跳独立编辑页；配置讲解点：已绑定则进讲解点编辑页，绑定多条时先弹警示「小程序地图仅能展示一条」，未绑定则带 POI 信息新建讲解点

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

#### 操作1：条件筛选导览POI

- **操作入口**：搜索表单[查询]（点位名称 input 按名称搜索/主分类 select 按主分类筛选/子类型 input 按子类型搜索/上架状态 select 按上架状态筛选，均支持清空）
- **操作说明**：各条件可组合使用；列表按当前登录租户范围查询

**操作步骤**：

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

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

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入导览POI页面] --> B[检查登录与权限]
 B -->|权限正常| C[搜索表单「查询」]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[填写筛选条件]
 D -->|条件不合法| E2[按提示修正] --> D
 D --> F[点击查询]
 F --> G[列表按条件刷新]
 G --> Z[结束: 条件筛选导览POI完成]
```

#### 操作2：新增地图点位

- **操作入口**：工具栏[新增地图点位]（primary，跳转独立表单页 对应功能页面）
- **操作说明**：跳转后由 POI 编辑页完成维护（右侧实时预览小程序详情效果），保存后返回本页自动刷新

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「新增地图点位」对应入口）
2. 触发操作：工具栏[新增地图点位]：在页面 的区域「工具栏」中，通过工具栏[新增地图点位]触发「新增地图点位」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写表单信息：按表单要求逐项填写（必填项带红星）：跳转后由 POI 编辑页完成维护（右侧实时预览小程序详情效果），保存后返回本页自动刷新（预期结果：字段录入完成，未触发校验红字）
4. 点击保存/提交：点击弹窗或表单页的保存/确定按钮提交数据（预期结果：请求提交成功）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

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

**操作流程图**：

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

#### 操作3：点位列表查询与分页

- **操作入口**：列表自动加载/翻页（展示：序号/点位名称/主分类/子类型/地图图标（缩略图可点击放大预览，未上传显示「默认」）/位置说明/状态（上架=绿tag、下线=灰tag）/排序）
- **操作说明**：仅上架点位对小程序智能导览地图可见；无数据时展示「没有更多数据了！」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「点位列表查询与分页」对应入口）
2. 触发操作：列表自动加载/翻页/位置说明/状态/排序）：在页面 的区域「点位列表区」中，通过列表自动加载/翻页/位置说明/状态/排序）触发「点位列表查询与分页」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 填写筛选条件：按搜索区条件填写筛选项：仅上架点位对小程序智能导览地图可见（预期结果：条件录入完成（可随时点击重置清空条件））
4. 点击查询/搜索按钮：提交筛选条件，系统按条件查询当前租户范围数据（预期结果：列表按条件刷新，分页同步更新）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

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

**操作流程图**：

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

#### 操作5：配置讲解点

- **操作入口**：行操作[配置讲解点]（success link，跳转讲解点编辑页）
- **操作说明**：导览 POI 与讲解点 1:1 绑定：系统先按当前点位查询已绑定讲解点——已绑定则直接进入该讲解点编辑页；未绑定则携带导览点位信息新建讲解点；若查到绑定多条，先弹出警示「讲解点重复绑定：该导览点已绑定 N 条讲解点，小程序地图仅能展示一条。请编辑下方首条记录，并将其余讲解点的「导览 POI」解绑或下线。」确认后进入首条讲解点编辑；查询讲解点失败提示「查询讲解点失败」

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「配置讲解点」对应入口）
2. 触发操作：行操作[配置讲解点]：在页面 的区域「行操作区」中，通过行操作[配置讲解点]触发「配置讲解点」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；导览 POI 与讲解点 1:1 绑定：系统先按当前点位查询已绑定讲解点——已绑定则直接进入该讲解点编辑页（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「查询讲解点失败」，列表/界面同步刷新最新数据（预期结果：看到「查询讲解点失败」提示且数据已更新）

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

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入导览POI页面] --> B[检查登录与权限]
 B -->|权限正常| C[行操作「配置讲解点」]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 配置讲解点完成]
```

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

- 「讲解点重复绑定：该导览点已绑定 N 条讲解点，小程序地图仅能展示一条。请编辑下方首条记录，并将其余讲解点的「导览 POI」
- 「查询讲解点失败」

#### 操作6：删除点位

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

**操作步骤**：

1. 前置检查：登录与权限：确保已登录管理端且具备相应权限（管理端登录用户（当前租户范围））（预期结果：若权限不足，页面不显示「删除点位」对应入口）
2. 触发操作：行操作[删除]：在页面 的区域「行操作区」中，通过行操作[删除]触发「删除点位」（预期结果：界面响应：弹窗打开/进入表单/列表刷新（视功能形态））
3. 选定目标数据：在列表中定位目标记录（必要时先通过搜索区筛选）；删除后列表自动刷新（预期结果：目标记录的操作按钮可见可用）
4. 二次确认：系统弹出二次确认弹窗，点击确定继续；取消则终止操作（预期结果：确认后提交请求）
5. 操作结果反馈：系统提示「操作成功」，列表/界面同步刷新最新数据（预期结果：看到「操作成功」提示且数据已更新）

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

**操作流程图**：

```mermaid
flowchart TD
 A[开始: 进入导览POI页面] --> 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[开始: 进入导览POI页面] --> B[检查登录与权限]
 B -->|权限正常| C[勾选多行后工具栏「批量删除」]
 B -->|无权限| Z0[入口不显示, 结束]
 C -->|请求异常| E1[提示错误, 稍后重试] --> C
 C --> D[选定目标记录]
 D -->|状态不符| E2[按钮不显示, 操作不可用] 
 D --> F{二次确认}
 F -->|取消| Z1[终止操作]
 F -->|确定| G[系统提示操作成功]
 G --> Z[结束: 批量删除点位完成]
```

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

---

### 2.2 景区管理

**进入方式**：

> 系统左侧菜单：业务管理 > 导览管理 > 景区管理

**页面说明**：

> 标题「导览 · 景区资源」，维护导览景区主数据（名称/图集/坐标/展示配置），与路线、语音讲解等内容关联；新增与编辑在独立页面完成，右侧实时预览小程序详情效果

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

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

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

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

**工具栏**：新增景区跳独立编辑页；删除为批量删除按钮，未勾选行时禁用

**列表说明**：列：序号/景区名称/等级/评分/营业时间/状态/排序；内置增删改与内置批量删除禁用（批量删除由工具栏按钮承担），列表按登录租户范围查询，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：批量删除景区

- **操作入口**：工具栏[删除]（danger，未勾选行时按钮禁用）
- **操作说明**：先在列表勾选至少一条景区记录；确认后删除，列表自动刷新

**操作步骤**：

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

- **操作入口**：列表自动加载/翻页（展示：序号/景区名称/等级/评分/营业时间/状态（上架=绿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[结束: 景区列表查询与分页完成]
```

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

- 「没有更多数据了！」

#### 操作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[结束: 删除景区完成]
```

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

---

### 2.3 导览同步日志

**进入方式**：

> 系统左侧菜单：业务管理 > 导览管理 > 导览同步日志

**页面说明**：

> 标题「导览 · 同步日志」，查看导览数据与外部系统同步记录（批次/结果/错误信息），便于运维重试与审计

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

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

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

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

**列表说明**：列：序号/会员ID/路线ID/任务码/同步时间/创建时间；新增·编辑禁用，删除受权限 对应操作权限 控制

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

#### 操作1：条件筛选同步日志

- **操作入口**：搜索表单[查询]（会员ID input/路线ID input/任务码 input，均支持清空）
- **操作说明**：各条件可组合使用

**操作步骤**：

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：同步日志列表查询与分页

- **操作入口**：列表自动加载/翻页（展示：序号/会员ID/路线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 --> 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[结束: 批量删除同步日志完成]
```

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

---

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

| 操作 | 界面提示 | 处理建议 |
|------|---------|---------|
| 点位列表查询与分页 | 「没有更多数据了！」 | 属正常反馈，按提示继续操作 |
| 点位列表查询与分页 | 「默认」 | 属正常反馈，按提示继续操作 |
| 配置讲解点 | 「讲解点重复绑定：该导览点已绑定 N 条讲解点，小程序地图仅能展示一条。请编辑下方首条记录，并将其余讲解点的「导览 POI」 | 属正常反馈，按提示继续操作 |
| 配置讲解点 | 「查询讲解点失败」 | 稍后重试，仍失败请联系管理员 |

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