基于python+mysql+vue的酒店管理系统【完整代码+可远程安装部署】

系统以 Python 作为主要开发语言，借助 Flask 框架完成后端开发，利用其灵活的路由系统和简单配置，快速搭建后端服务，实现业务逻辑与数据交互。选用 MySQL 数据库存储数据，凭借其稳定性、可靠性和高效的数据处理能力，确保客房信息、顾客资料、预订记录等大量数据的安全存储与快速检索。运用 Vue.js 构建前端交互界面，通过组件化开发模式，构建出动态响应式的前端界面，让页面交互更加流畅，极大提升用户体验。

该系统提供便捷易用的操作界面和强大丰富的功能。酒店管理人员可通过系统轻松管理客房信息，如房型、房价、房态等，实时掌握客房资源动态；还能处理顾客预订信息，进行入住、退房操作，管理顾客评价与反馈。顾客则能方便地在系统上查询酒店客房信息，根据自身需求进行房间预订，查看预订记录，在规定时间内灵活修改或取消预订。此外，系统支持会员管理功能，为会员提供积分累计、等级晋升及专属优惠等服务，提升顾客忠诚度。

通过该系统的设计与实现，酒店实现了运营管理的数字化与智能化，优化资源配置，提高服务效率与质量，增强市场竞争力。顾客也能享受到更便捷、高效的酒店预订服务，提升出行住宿的便利性。同时，系统对 Python、Flask、MySQL 和 Vue.js 等技术的综合运用，展示了这些技术在酒店预约管理领域的实际应用价值，为类似系统的开发提供了有益参考和借鉴。

背景

在当今数字化浪潮席卷全球的时代，各行各业都在积极寻求数字化转型，以适应市场的快速变化和消费者日益增长的多样化需求。酒店行业作为旅游业的重要支柱，也面临着前所未有的机遇与挑战。

随着人们生活水平的不断提高，旅游出行、商务出差等活动日益频繁，酒店的市场需求持续增长。然而，传统的酒店运营管理模式在面对如此庞大且复杂的业务时，逐渐显露出诸多弊端。在过去，许多酒店依赖人工记录和管理客房信息、顾客预订资料以及财务数据等。这种方式不仅效率低下，容易出现人为错误，而且信息的更新和共享存在严重滞后性。例如，在客房信息管理方面，工作人员需要手动记录每间客房的房型、房价、房态等信息，当客房状态发生变化时，如客人入住、退房或者房间需要维修等，信息的更新往往不及时，导致其他工作人员无法准确掌握客房资源的实时动态，进而可能出现超订、错订等情况，给酒店和顾客都带来不必要的麻烦。

在顾客预订环节，传统的预订方式主要通过电话、传真或者线下柜台进行。这种方式不仅耗费顾客大量的时间和精力，而且预订流程繁琐，顾客无法直观地了解酒店的客房情况和价格信息，也难以根据自己的需求进行灵活的预订选择。对于酒店来说，人工处理预订信息的效率较低，难以应对旅游旺季等高峰期的大量预订需求，容易造成顾客流失。

此外，随着市场竞争的日益激烈，酒店需要不断提升自身的服务质量和管理水平，以吸引和留住更多的顾客。传统的管理模式无法满足酒店对顾客数据进行深入分析和挖掘的需求，酒店难以了解顾客的消费习惯、偏好和需求，也就无法为顾客提供个性化的服务和精准的营销。例如，酒店无法根据顾客的历史预订记录和消费行为，为会员提供专属的优惠活动和个性化的服务推荐，导致顾客忠诚度不高。

为了应对这些挑战，实现酒店运营管理的数字化与智能化成为必然趋势。数字化管理系统智能化成为必然趋势。数字化管理系统智能化成为必然趋势。数字化管理系统能够整合酒店的各项业务流程，实现信息的实时共享和高效处理，提高服务效率和质量。同时，借助大数据分析和人工智能技术，酒店可以深入了解顾客需求，为顾客提供更加个性化的服务，提升顾客满意度和忠诚度。

功能介绍

前台功能

首页（门户浏览）
- 民宿展示：用户进入首页，能够浏览民宿列表，其中包含最新上线以及热门的民宿。展示内容有民宿名称、价格、图片等关键信息，让用户快速把握民宿概况。
- 热门推荐：借助协同过滤推荐算法，为用户精准推送热门民宿，提升用户发现心仪民宿的几率。
- 搜索功能：在页面顶部设有搜索框，支持用户输入民宿名称、价格范围等关键词进行模糊搜索，迅速定位目标民宿。
民宿详情页
- 基本信息呈现：详细展示民宿的名称、价格、备注等基本信息，还可提供民宿内外部环境图片、房间布局等，帮助用户全面了解民宿情况。
- 民宿评论：在详情页下方设置评论区域，用户既能查看其他客人对民宿的评价，也可以发表自己的入住体验、感受等，促进用户之间的交流。
用户中心
- 个人信息管理：用户可对基本资料进行修改，查看个人信息，如姓名、联系方式等，同时能修改密码，保障账号安全。
- 互动功能管理：支持用户对感兴趣的民宿进行收藏、点赞操作，方便后续查找心仪民宿。
- 我的预订：用户在此可查看自己预订民宿的相关信息，包括预订日期、入住时长、房型等，便于管理个人行程安排。
- 意见反馈：为用户提供提交意见反馈的入口，方便用户就民宿服务、网站功能等提出建议与问题。
注册登录：用户需先完成注册并登录，才能使用网站各项功能，以此确保用户信息安全，维护网站管理秩序。

后台功能

民宿管理
- 信息录入：管理员可在管理系统中录入民宿的名称、价格、备注等基本信息，充实民宿信息库。
- 信息修改：针对已录入的民宿信息，根据实际情况进行修改，保证信息的准确性和时效性。
- 信息查询：方便管理员随时查询民宿的基本信息，快速获取所需民宿详情。
类型管理
- 类型信息管理：系统支持管理员对民宿类型信息进行管理，主要涉及民宿类型名称的添加、修改和删除操作，使民宿分类更清晰合理。
评论管理
- 评论浏览与管理：管理员可全面浏览整个网站的民宿评论信息，对不当评论进行处理，维护评论区良好秩序。
用户管理
- 信息管理与浏览：管理员能够管理和浏览网站用户信息，查看用户基本资料、注册信息等。
- 用户操作：具备新增用户账号的功能，也可对现有用户信息进行编辑，如修改用户权限；对违规或长期未使用的用户执行删除操作。
统计分析
- 数据统计与分析：系统依据民宿的活动数据，如预订量、入住率等，以及用户参与度相关数据，如浏览记录、收藏数量等，进行深度统计分析。协助管理员全面了解系统运行状况，为民宿运营策略调整、服务优化等提供数据支持。
消息管理
- 消息发布权限：民宿管理员有权在系统上发布消息，所发布消息可被全站用户接收，方便及时传达民宿促销活动、服务变更等重要信息。
广告管理
- 广告发布操作：民宿管理员可在系统上发布广告消息，发布后的广告将在民宿详情页面右侧展示，助力民宿宣传推广。
意见反馈
- 反馈信息查看：管理员在后台能够查看用户提交的意见反馈信息，及时了解用户需求和问题，针对性地优化民宿服务与网站功能。
系统信息
- 基本信息查看：管理员可查看系统名称、服务器信息（如运行状态、带宽）、内存信息、CPU 信息、软件信息（如软件版本、插件）等基本信息，全面掌握系统运行环境与状态，保障系统稳定运行。

开发环境

后端： Python 3.8 + Django 3.2
前端： Javascript + Vue
数据库：MySQL 5.7
开发平台：Pycharm + vscode
运行环境：Windows 10/11

界面展示

前端界面

后端界面

代码结构

后端结构

server  
├── myapp            // 主应用
│       └── auth                     // 认证管理
│       └── middlewares              // 中间件
│       └── permission               // 权限
│       └── views                    // 视图与接口（主要业务代码）
│       └── models.py                // 状态码
│       └── serializers.py           // 状态码
│       └── urls.py                  // 状态码
│       └── utils.py                 // 状态码
├── server             // 配置目录
├── upload             // 静态资源目录
├── requiements.txt    // 依赖项

前端结构

├── build                      // 构建相关  
├── public                     // 公共文件
│   ├── favicon.ico            // favicon图标
│   └── index.html             // html模板
├── src                        // 源代码
│   ├── api                    // 所有请求
│   ├── assets                 // 主题 字体等静态资源
│   ├── router                 // 路由
│   ├── store                  // 全局 store管理
│   ├── utils                  // 全局公用方法
│   ├── views                  // view界面
│   ├── App.vue                // 入口页面
│   ├── main.js                // 入口 加载组件 初始化等
│   └── settings.js            // 系统配置
├── .eslintignore              // 忽略语法检查
├── .eslintrc.js               // eslint 配置项
├── .gitignore                 // git 忽略项
├── babel.config.js            // babel.config.js
├── package.json               // package.json
└── vite.config.js             // vue配置

数据库设计

本系统共设计了用户信息表、分类表、借阅表、登录日志表、操作日志表、评论表、地址表、意见反馈表、访问记录表、广告表。详见文件夹中的《表结构.doc》。

重要模块展示

分页实现

基于ant-design框架的a-table的分页插件。

// 分页变量

  const data = reactive({
    dataList: [],
    loading: false,
    keyword: '',
    selectedRowKeys: [] as any[],
    pageSize: 10,
    page: 1,
  });
  
// 分页插件
:pagination="{
          size: 'default',
          current: data.page,
          pageSize: data.pageSize,
          onChange: (current) => (data.page = current),
          showSizeChanger: false,
          showTotal: (total) => `共${total}条数据`,
        }"

请求工具实现

前端的请求工具是基于axios开发的，位于utils的http文件夹中。封装了request请求和拦截器。

const service: AxiosInstance = axios.create({
  // baseURL: import.meta.env.BASE_URL + '',
  baseURL: BASE_URL + '',
  timeout: 15000,
});

// axios实例拦截请求
service.interceptors.request.use(
  (config: InternalAxiosRequestConfig) => {
    config.headers.ADMINTOKEN = localStorage.getItem(ADMIN_USER_TOKEN);
    config.headers.TOKEN = localStorage.getItem(USER_TOKEN);

    return config;
  },
  (error: AxiosError) => {
    return Promise.reject(error);
  },
);

// axios实例拦截响应
service.interceptors.response.use(
  (response: AxiosResponse) => {
    if (response.status == 200) {
      if (response.data.code == 0 || response.data.code == 200) {
        return response;
      } else {
        return Promise.reject(response.data);
      }
    } else {
      return Promise.reject(response.data);
    }
  },
  // 请求失败
  (error: any) => {
    console.log(error.response.status);
    if (error.response.status == 404) {
      // todo
    } else if (error.response.status == 403) {
      // todo
    }
    return Promise.reject(error);
  },
);

权限控制模块

权限控制使用了BaseAuthentication实现的，具体代码可参考authentication.py

from rest_framework import exceptions
from rest_framework.authentication import BaseAuthentication
from myapp.models import User

# 接口认证
class AdminTokenAuthtication(BaseAuthentication):
    def authenticate(self, request):
        adminToken = request.META.get("HTTP_ADMINTOKEN")

        print("检查adminToken==>" + adminToken)
        users = User.objects.filter(admin_token=adminToken)
        """
        判定条件：
            1. 传了adminToken 
            2. 查到了该帐号 
            3. 该帐号是管理员或演示帐号
        """
        if not adminToken or len(users) == 0 or users[0].role == '2':
            raise exceptions.AuthenticationFailed("AUTH_FAIL_END")
        else:
            print('adminToken验证通过')

路由模块实现

前端的路由是基于vue-router框架实现的，路由文件位于src的rooter的root.js文件中。预览如下：

  {
    path: '/admin',
    name: 'admin',
    redirect: '/admin/thing',
    component: () => import('/@/views/admin/main.vue'),
    children: [
      { path: 'overview', name: 'overview', component: () => import('/@/views/admin/overview.vue') },
      { path: 'order', name: 'order', component: () => import('/@/views/admin/order.vue') },
      { path: 'thing', name: 'thing', component: () => import('/@/views/admin/thing.vue') },
      { path: 'comment', name: 'comment', component: () => import('/@/views/admin/comment.vue') },
      { path: 'user', name: 'user', component: () => import('/@/views/admin/user.vue') },
      { path: 'classification', name: 'classification', component: () => import('/@/views/admin/classification.vue') },
      { path: 'ad', name: 'ad', component: () => import('/@/views/admin/ad.vue') },
      { path: 'notice', name: 'notice', component: () => import('/@/views/admin/notice.vue') },
      { path: 'loginLog', name: 'loginLog', component: () => import('/@/views/admin/login-log.vue') },
      { path: 'opLog', name: 'opLog', component: () => import('/@/views/admin/op-log.vue') },
      { path: 'errorLog', name: 'errorLog', component: () => import('/@/views/admin/error-log.vue') },
      { path: 'sysInfo', name: 'sysInfo', component: () => import('/@/views/admin/sys-info.vue') },
    ]
  },