【毕设/开源】Python Django 酒店管理系统开发实战（附源码）—— 基于 Gemini + Cursor 的 AI 编程新范式

2401_87699450

792人浏览 · 2026-01-05 20:57:42

2401_87699450 · 2026-01-05 20:57:42 发布

【开源】Python Django 酒店管理系统开发实战（附源码）

摘要：临近毕业季，为了高效完成毕业设计，我尝试了一种全新的开发模式：利用 AI (Gemini) 进行架构设计，配合 AI 代码编辑器 (Cursor) 进行落地实现。最终在短时间内完成了一套功能完备、界面现代化的酒店管理系统。本文将分享系统的核心功能、技术实现细节以及 AI 辅助开发的实战心得。

一、项目背景与简介

传统的酒店管理系统往往界面老旧、功能单一。本项目旨在构建一个现代化、智能化、数据化的酒店业务平台。系统分为用户端（客房预订、会员中心）和管理端（数据大屏、房态管理、员工排班）。

技术栈概览：

后端：Python 3.10 + Django 4.2
前端：Bootstrap 5 + jQuery + FontAwesome
数据可视化：Chart.js
数据库：SQLite (默认) / MySQL
开发工具：Cursor + VS Code

项目开源地址：👉 GitHub 传送门 (觉得不错请点个 Star ⭐)

二、系统功能展示

1. 首页与智能搜索

抛弃了传统的表格列表，采用图文卡片式布局。支持按入住日期、价格区间、房型进行多维度筛选。
在这里插入图片描述

2. 数据可视化驾驶舱 (Dashboard)

这是管理端的亮点。利用 Chart.js 将后台数据实时渲染为图表，包含：

今日入住率与销售额
最近 7 天订单趋势图
房型热度饼图

3. 会员体系与个人中心

实现了完整的会员逻辑。用户消费自动获得积分，积分达到阈值自动升级（普通->银卡->金卡->钻石），高等级会员预订自动打折。
在这里插入图片描述

三、核心技术实现 (Show me the code)

1. 会员等级与积分自动化

利用 Django 的 pre_save 或在 Model 的 save 方法中实现逻辑闭环。当用户退房（订单完成）时，系统自动计算积分并更新等级。

# models.py (核心逻辑片段)
class CustomUser(AbstractUser):
    # 定义会员等级
    TIERS = (
        ('standard', '普通会员'),
        ('silver', '银卡会员'),   # 500分
        ('gold', '金卡会员'),     # 2000分
        ('platinum', '白金会员'), # 5000分
        ('diamond', '钻石会员'),  # 10000分
    )
    points = models.IntegerField(default=0, verbose_name="积分")
    membership_level = models.CharField(max_length=20, choices=TIERS, default='standard')

    def calculate_level(self):
        """根据积分自动计算等级"""
        if self.points >= 10000:
            return 'diamond'
        elif self.points >= 5000:
            return 'platinum'
        elif self.points >= 2000:
            return 'gold'
        elif self.points >= 500:
            return 'silver'
        return 'standard'

    def save(self, *args, **kwargs):
        # 每次保存时刷新等级
        self.membership_level = self.calculate_level()
        super().save(*args, **kwargs)

2. 数据大屏接口设计

为了给前端 Chart.js 提供数据，我们需要在 View 层进行数据聚合（Aggregation）。

# views.py
from django.db.models import Count, Sum
from django.utils import timezone
import datetime
from django.contrib.auth.decorators import user_passes_test
from django.shortcuts import render
from .models import Booking

@user_passes_test(lambda u: u.is_superuser)
def dashboard(request):
    # 统计最近 7 天的订单数
    today = timezone.now().date()
    dates = [today - datetime.timedelta(days=i) for i in range(6, -1, -1)]
    daily_orders = []
    
    for date in dates:
        count = Booking.objects.filter(
            created_at__date=date
        ).count()
        daily_orders.append(count)

    # 统计房型销量
    room_type_data = Booking.objects.values('room__room_type').annotate(
        total=Count('id')
    ).order_by('-total')

    context = {
        'labels': [d.strftime('%m-%d') for d in dates],
        'data': daily_orders,
        'room_type_labels': [item['room__room_type'] for item in room_type_data],
        'room_type_counts': [item['total'] for item in room_type_data],
    }
    return render(request, 'dashboard.html', context)

3. 前端 UI 美化 (Bootstrap 5)

为了摆脱“土味”界面，我使用了深青色 (Teal) + 金色 (Gold) 的配色方案，并对 Bootstrap 组件进行了定制。

/* 自定义 CSS 片段 */
:root {
    --primary-color: #005662; /* 深青色 */
    --accent-color: #C5A572;  /* 香槟金 */
}

.card {
    border: none;
    border-radius: 12px;
    box-shadow: 0 4px 15px rgba(0,0,0,0.05);
    transition: transform 0.3s ease;
}

.card:hover {
    transform: translateY(-5px); /* 悬停上浮效果 */
}