Skip to content

Repository files navigation

EventHub 🎉

A comprehensive event management platform built with Flask for seamless event organization and ticket booking. Live Demo Python Flask License Status

✨ Key Highlights

  • 🚀 Production Ready - Fully deployed and tested on Render
  • 🔒 Secure - Bcrypt password hashing, CSRF protection
  • 📱 Responsive - Mobile-friendly design
  • ⚡ Fast - Optimized database queries with eager loading
  • 🎨 Modern UI - Clean and intuitive interface
  • 🔧 Maintainable - Well-structured codebase with comprehensive error handling

🚀 Features

For Attendees 👥

  • 🎫 Browse Events - Discover upcoming events with detailed information
  • 💳 Book Tickets - Multiple payment options (Credit Card, PayPal, UPI)
  • 📱 Digital Pass - QR code-based tickets with downloadable passes
  • 🔔 Reminders - Set email/SMS reminders for events
  • ✅ Manage Tickets - View, download, and cancel tickets easily
  • 🎟️ Ticket Types - Choose from General, VIP, and other ticket categories

For Organizers 🎪

  • 📅 Event Management - Create, edit, and delete events
  • 🏢 Venue Management - Add and manage event venues
  • 🎤 Speaker Management - Assign speakers to events
  • 🎟️ Ticket Configuration - Set ticket types, prices, and quantities
  • 📊 Dashboard - Real-time analytics and ticket tracking
  • ✓ QR Scanner - Verify and check-in attendees with QR codes
  • 🤖 AI Event Planner - Smart event planning with budget breakdown

For Administrators 🔐

  • 👥 User Management - Full system access and control
  • 🔐 Organizer Management - Add, edit, and remove organizers
  • 📈 System Analytics - System-wide statistics and insights
  • 🛡️ Security - Monitor and manage platform security

🛠️ Tech Stack

Backend:

  • Python 3.11+
  • Flask 3.0+ (Web Framework)
  • SQLAlchemy 2.0+ (ORM with eager loading optimization)
  • SQLite (Database)
  • Flask-Migrate (Database Migrations)
  • Bcrypt (Password Hashing)
  • QRCode & Pillow (QR Code Generation)

Frontend:

  • HTML5, CSS3, JavaScript
  • Responsive Design
  • Modern UI/UX
  • Real-time form validation

Deployment & DevOps:

  • Gunicorn (WSGI Server)
  • Render (Cloud Platform)
  • Git (Version Control)
  • Automated CI/CD Pipeline

Key Features:

  • ✅ Eager loading for optimized database queries
  • ✅ Comprehensive error handling
  • ✅ Production logging with rotating file handler
  • ✅ Health check endpoint for monitoring
  • ✅ Global error handlers (500, 404)

Python Flask SQLite SQLAlchemy Gunicorn Render HTML5 CSS3 JavaScript

👤 Demo Accounts

After running create_admin_users.py, you can login with these accounts:

Role Email Password Access Level
👑 Administrator admin@eventhub.com Admin@123 Full system access
🎪 Organizer 1 organizer1@eventhub.com Org1@123 Event management
🎪 Organizer 2 organizer2@eventhub.com Org2@123 Event management

Note: Change these passwords in production!

🌐 Deployment

The application is production-ready and deployed on Render with optimized performance and error handling.

📊 Database Schema

Core Models

User

  • user_id (PK)
  • name, email, password
  • user_type (organizer/attendee/administrator)

Event

  • event_id (PK)
  • name, description, date, time
  • location_id (FK → Venue)

Venue

  • venue_id (PK)
  • name, address, capacity, city, state, zip_code

Ticket

  • ticket_id (PK)
  • event_id (FK → Event)
  • order_id (FK → Order)
  • price, type, seat_number
  • qr_token, short_code
  • checked_in, checked_in_at

Order

  • order_id (PK)
  • user_id (FK → User)
  • date, total_price
  • payment_id (FK → Payment)

Payment

  • payment_id (PK)
  • order_id (FK → Order)
  • payment_method, transaction_id

Speaker

  • speaker_id (PK)
  • name, bio
  • event_id (FK → Event)

TicketType

  • ticket_type_id (PK)
  • event_id (FK → Event)
  • type, price, quantity

Reminder

  • reminder_id (PK)
  • user_id (FK → User)
  • event_id (FK → Event)
  • remind_at, method, message, sent

Made with ❤️ by Aryan Sandilya

GitHub followers GitHub stars

About

A modern event management platform for organizers and attendees.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages