# Flying Fish Hotel

**Repository Path**: Endurancer_Program/flying-fish-hotel

## Basic Information

- **Project Name**: Flying Fish Hotel
- **Description**: 飞鱼酒店管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-01-12
- **Last Updated**: 2025-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 一、项目概述
1. **项目名称**：酒店预订管理系统
2. **项目类型**：基于Springboot + Vue的酒店预订管理平台（前后端分离）
3. **目标用户**：
   - **管理员**：负责平台整体运营和管理的人员。
   - **酒店**：在平台上注册并管理自己酒店信息的商家。
   - **普通用户**：使用平台进行酒店预订、查看酒店信息等操作的注册用户。
4. **功能模块**：
   - 用户注册/登录
   - 管理员后台管理系统所有数据（包括但不限于酒店审核、用户管理、房间分类管理、房间信息管理、订单管理、入住退房管理、公告管理等）
   - 酒店后台管理（发布房间信息、管理用户入住退房、管理用户评论、管理自己酒店的订单）
   - 用户前台操作（查看酒店信息、查看房间信息、加入收藏、预订下单、查看自己的订单、评价酒店、查看入住记录等）
---

### 二、环境搭建
#### 1. 开发工具
- **后端**
  - **IntelliJ IDEA** 或其他支持Java开发的IDE（如Eclipse）：用于编写和调试后端代码。  
- **前端**
  - **Visual Studio Code (VS Code)**：轻量级且功能强大的文本编辑器，适合前端开发，提供了丰富的插件支持。  
- **数据库设计与管理**
  - **Navicat Premium**（建议版本不低于16）：可视化工具，用于设计和管理MySQL数据库，简化数据库操作。
#### 2. 开发环境
- **JDK**
  - **版本要求**：1.8
  - **安装说明**：确保正确安装并配置JAVA_HOME环境变量，以便命令行和其他工具能够识别JDK。
- **Node.js**
  - **版本要求**：16.0+
  - **安装说明**：通过官方提供的安装包进行安装，并确保npm（Node.js的包管理工具）也一并安装，方便后续安装前端依赖。  
- **Maven**
  - **版本要求**：3.8+
  - **安装说明**：Maven是Java项目的构建工具，负责管理项目依赖和执行构建生命周期任务。确保MAVEN_HOME环境变量已设置，并将`bin`目录添加到系统路径中。
#### 3. 数据库环境
- **MySQL**
  - **版本要求**：5.7或8.0
  - **安装说明**：根据操作系统选择合适的MySQL安装包，并完成安装。配置数据库连接参数，确保应用程序可以正常访问数据库。
#### 4. 第三方中间件及工具
- **Redis**：用于缓存数据，如验证码、用户会话信息等。
- **Nginx**：作为反向代理服务器，分发请求至不同的后端服务；同时也可以用于负载均衡和静态资源的托管。
- **Git**：版本控制系统，用于代码管理和协作开发。

---
### 三、项目结构
#### 1. 后端项目结构
- `src/main/java`：存放Java源代码，细分为以下子包：
  - `controller`：包含所有RESTful API控制器类，负责处理HTTP请求。
  - `service`：实现业务逻辑的服务层接口和实现类。
  - `mapper`：定义与数据库交互的持久层接口（MyBatis Mapper）。
  - `entity`：存放实体类，对应数据库中的表结构。
  - `dto`：数据传输对象，用于封装API请求和响应的数据。
  - `vo`：视图对象，专门用于前端展示的数据模型。
  - `exception`：自定义异常类及其处理器。
  - `utils`：工具类，提供通用的功能方法，如日期格式化、字符串处理等。  
- `src/main/resources`：存放非Java资源文件，包括但不限于：
  - `application.properties` 或 `application.yml`：Spring Boot应用配置文件。
  - `mapper.xml`：MyBatis SQL映射文件。
  - 其他静态资源或模板文件（如邮件模板）。 
- `src/test/java`：存放单元测试和集成测试代码，确保各个组件的功能正确性。

#### 2. 前端项目结构
- `src/assets`：存放静态资源，如图片、图标、样式文件（CSS/SCSS）等。
- `src/components`：存放可复用的Vue组件，这些组件可以在不同的页面中使用，提高代码的复用性和开发效率。
- `src/router`：存放路由配置文件，定义了应用的所有路由规则以及它们对应的组件。
- `src/store`：存放Vuex状态管理的相关文件，包括状态、突变、动作等，以集中管理和共享全局状态。
- `src/views`：存放页面级组件，每个页面通常对应一个独立的Vue组件，包含了页面特有的逻辑和布局。
- `src/api`：存放与后端交互的API请求相关代码，通过Axios库发送HTTP请求并与后端通信。
- `src/utils`：存放前端工具类代码，提供辅助函数或常量定义，帮助简化开发过程。
- `src/App.vue`：应用的根组件，是整个应用的入口点，包含了主模板和全局配置。
- `src/main.js`：应用的入口文件，负责初始化Vue实例并挂载到DOM元素上，同时引入全局插件和其他必要的设置。
---

### 四、项目创新
#### 1. **多酒店管理模式**
- **创新描述**：不同酒店可以在平台上管理自己的数据，包括房间信息、订单管理、用户入住退房等，实现了多酒店的精细化管理。
- **技术实现**：为每个酒店分配独立的后台管理系统，确保数据隔离和权限控制。
#### 2. **仿携程酒店预订网首页**
- **创新描述**：界面设计模仿携程酒店预订网，相似度高，为用户提供熟悉的操作体验，减少学习成本。
- **技术实现**：采用Element UI组件库快速构建美观且响应式的界面，确保用户体验的一致性。
#### 3. **模拟完整酒店预订流程**
- **创新描述**：从酒店预订到入住退房，模拟了一整套完整的酒店预订流程，形成闭环。
- **技术实现**：结合实际业务需求，实现预订下单、支付、确认入住、退房等环节的无缝衔接，确保流程顺畅。
---

### 五、功能模块实现
#### 管理员功能
1. **登录、个人信息、修改密码**
   - 实现管理员登录、个人信息查看和修改密码功能。  
2. **管理后台管理系统所有数据**
   - 包括但不限于：
     - **酒店管理**：审核注册的酒店，确保合法合规。
     - **用户管理**：管理平台用户信息，保障平台安全运行。
     - **房间分类管理**：维护房间类型体系，便于用户查找。
     - **房间信息管理**：管理所有酒店的房间信息，确保信息准确无误。
     - **订单管理**：处理平台上的所有订单信息，包括订单状态更新和退款处理。
     - **入住管理**：管理用户的入住信息，确保入住流程顺利。
     - **退房管理**：处理用户的退房信息，完成退房手续。
     - **公告管理**：发布和管理系统公告，及时传达重要信息给用户。
     - **个人中心**：管理员个人信息管理。
#### 酒店功能
1. **注册、登录、个人信息、修改密码**
   - 实现酒店注册、登录功能，注册后需经管理员审核方可登录。
2. **发布房间信息** 
  - 发布和管理酒店的房间信息，包括价格、房型、可用时间等。  
3. **管理用户入住、退房**
   - 处理用户的入住和退房信息，确保流程顺畅。  
4. **管理用户评论**
   - 审核和管理用户对酒店的评论，维护良好的社区氛围。  
5. **管理自己酒店的订单**
   - 查看和管理酒店的订单信息，处理订单状态更新和退款请求。
#### 用户功能
1. **注册、登录、个人信息、修改密码**
   - 实现用户注册、登录功能，保护用户账户安全。   
2. **查看酒店信息**
   - 浏览平台上的酒店信息，了解酒店详情。  
3. **查看房间信息**
   - 查看酒店提供的房间信息，包括房型、价格、设施等。  
4. **加入收藏**
   - 将喜欢的酒店或房间加入收藏夹，方便日后查看。  
5. **预订下单**
   - 下单预订酒店房间，完成预订流程。 
6. **查看自己的订单**
   - 查看和管理自己的订单信息，了解订单状态。   
7. **评价酒店**
   - 对入住过的酒店进行评价，分享入住体验。   
8. **查看入住记录**
   - 查看自己的入住历史记录，方便查询过往住宿情况。
---
![输入图片说明](imgs/3109e2eb8172074a5c0b0a7d15797c5.jpg)
![输入图片说明](imgs/5648c56f0fbe6127e3e7699618b8415.jpg)
![输入图片说明](imgs/6b13354563fd52a10a8c1a7639cb23e.jpg)
![输入图片说明](imgs/72c5428da28b0f8f3914e1c3a3b8063.jpg)
![输入图片说明](imgs/95cd8bd4c5d115a211f47994e86d18b.jpg)