# MOD_002 酒店民宿

## 一、功能简介

「酒店民宿」是系统的组成部分，供以下角色使用：超级管理员。

**常用场景**：

- 运营录入酒店/民宿基础信息并上架房型
- 客服查询预订单并为到店游客办理入住核销
- 运营维护房型价格、床型与可订库存

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

| 页面 | 进入方式 |
|------|---------|
| 酒店管理 | 业务管理 > 酒店民宿 > 酒店管理 |
| 房型管理 | 业务管理 > 酒店民宿 > 房型管理 |
| 酒店预订 | 业务管理 > 酒店民宿 > 酒店预订 |

---

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

### 2.1 酒店管理

**进入方式**：

> 系统左侧菜单：业务管理 > 酒店民宿 > 酒店管理

**列表展示内容**：酒店/民宿基础信息维护（依据 后台服务 + 系统数据表 + 编辑页 对应功能页面 推断：列表/新增/编辑/上下架）

**可用性提示**：路由已登记但前端组件缺失（前端程序目录 为空），页面实际不可用，待补组件

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

#### 操作1：酒店/民宿维护（推断）

- **操作入口**：（推断）菜单「酒店管理」进入列表
- **操作说明**：路由已登记但前端组件缺失，页面实际不可用；推断能力：列表/新增/编辑/上下架

**操作步骤**：

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.2 房型管理

**进入方式**：

> 系统左侧菜单：业务管理 > 酒店民宿 > 房型管理

**列表展示内容**：房型价格/床型/可订库存维护（依据 后台服务 + 系统数据表 + 编辑页 对应功能页面-type/editor 推断：列表/新增/编辑）

**可用性提示**：路由已登记但前端组件缺失（前端程序目录 为空），页面实际不可用，待补组件

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

#### 操作1：房型维护（推断）

- **操作入口**：（推断）菜单「房型管理」进入列表
- **操作说明**：路由已登记但前端组件缺失，页面实际不可用；推断能力：房型价格/床型/可订库存的列表/新增/编辑

**操作步骤**：

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.3 酒店预订

**进入方式**：

> 系统左侧菜单：业务管理 > 酒店民宿 > 酒店预订

**列表展示内容**：酒店预订单查询与入住核销（依据 后台服务 + 系统数据表 + hotel_booking_verify 核销权限推断：列表/详情/核销）

**可用性提示**：路由已登记但前端组件缺失（前端程序目录 为空），页面实际不可用，待补组件

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

#### 操作1：酒店预订单查询与入住核销（推断）

- **操作入口**：（推断）菜单「酒店预订」进入列表
- **操作说明**：路由已登记但前端组件缺失，页面实际不可用；推断能力：列表/详情/入住核销（核销需 hotel_booking_verify 权限）

**操作步骤**：

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[结束: 酒店预订单查询与入住核销完成]
```

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

- 「酒店预订」

---

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

| 操作 | 界面提示 | 处理建议 |
|------|---------|---------|
| 酒店/民宿维护（推断） | 「酒店管理」 | 属正常反馈，按提示继续操作 |
| 房型维护（推断） | 「房型管理」 | 属正常反馈，按提示继续操作 |
| 酒店预订单查询与入住核销（推断） | 「酒店预订」 | 属正常反馈，按提示继续操作 |

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