🎫 Event Ticketing System 🎟️

A full-featured event ticketing platform backend built with Django, allowing organizers to create events and visitors to purchase tickets with QR code functionality.

---

✨ Features

👥 User Management	Multi-role system (Admin, Organizer, Visitor)
🗓️ Event Management	Create, update, and delete events
🎟️ Ticket System	Purchase, verify, and check-in with QR codes
📧 Email Notifications	Send ticket confirmations with embedded QR codes
🔔 Real-time Notifications	WebSocket-based event reminders
📊 Analytics	Track event views, purchases, and other interactions
🔍 GraphQL API	Flexible data querying and manipulation
🌐 REST API	Standard RESTful endpoints for events and tickets

🛠️ Tech Stack

🧰 Backend Framework

• 🟢 Django 5.2.1
• 🔴 Django REST Framework 3.16.0
• 🟣 Graphene (GraphQL) 3.4.3

🔐 Authentication

• 🔑 Django OAuth Toolkit
• 🔓 djangorestframework-simplejwt
• 👤 Social Authentication

💾 Database

• 🗃️ SQLite (development)
• 🔄 Migrations support for other databases in production

⚙️ Asynchronous Processing

• 🔄 Celery for background tasks
• 🚀 Redis for message broker
• 📡 Django Channels for WebSockets

📁 Media Handling

• 🖼️ Pillow for image processing
• 📱 QR Code generation

📧 Email Service

• 📨 SendGrid integration

📚 Documentation & Schemas

• 📝 DRF Spectacular for API documentation

📂 Project Structure

event_ticket/backend/
│
├── manage.py                  # Django management script
├── requirements.txt           # Project dependencies
├── client.html                # WebSocket test client
│
├── ticket_system/             # Main Django project
│   ├── __init__.py
│   ├── asgi.py                # ASGI config for async support
│   ├── celery.py              # Celery configuration
│   ├── schedule.py            # Task scheduling
│   ├── settings.py            # Project settings
│   ├── urls.py                # Main URL routing
│   ├── views.py               # Top-level views
│   ├── wsgi.py                # WSGI configuration
│   │
│   ├── core/                  # Core app with models and base functionality
│   │   ├── models.py          # User, Event, Ticket, Stats models
│   │   ├── serializers.py     # Data serializers
│   │   ├── permissions.py     # Custom permission classes
│   │   ├── admin.py           # Admin interface
│   │   └── manager.py         # Custom user manager
│   │
│   ├── events/                # Events app
│   │   ├── views.py           # Event and Ticket ViewSets
│   │   ├── serializers.py     # Event serializers
│   │   ├── urls.py            # Event URL routing
│   │   ├── consumers.py       # WebSocket consumers
│   │   ├── tasks.py           # Celery tasks
│   │   ├── routing.py         # WebSocket URL routing
│   │   └── middleware.py      # WebSocket auth middleware
│   │
│   ├── services/              # Services app
│   │   ├── email_service.py   # SendGrid email service
│   │   ├── qr_code.py         # QR code generation
│   │   ├── views.py           # Service views
│   │   └── urls.py            # Service URL routing
│   │
│   └── graphql/               # GraphQL app
│       ├── schema.py          # GraphQL schema
│       ├── query.py           # GraphQL queries
│       ├── mutation.py        # GraphQL mutations
│       └── types.py           # GraphQL types
│
├── media/                     # User-uploaded media
│   └── qr_codes/              # Generated ticket QR codes
│
└── staticfiles/               # Static files

🚀 Setup & Installation

📋 Prerequisites

⚙️ Installation Steps

Step-by-Step Guide

1. Clone the repository 📥

   git clone https://github.com/ahmed123456787/ticket-event.git
   cd event_ticket/backend

2. Create and activate a virtual environment 🔮

   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. Install dependencies 📦

   pip install -r requirements.txt

4. Set up environment variables 🔑

   Create a .env.dev file in the project root with:

   SENDGRID_API_KEY=your_sendgrid_api_key
   

5. Run migrations 🔄

   python manage.py migrate

6. Create a superuser 👑

   python manage.py createsuperuser

7. Run the development server 🚀

   python manage.py runserver

🔧 Additional Services Setup

Start Required Services

1. Start Redis server 🔴

   redis-server

2. Run Celery worker 🧠

   celery -A ticket_system worker -l info

3. Run Celery beat ⏰

   celery -A ticket_system beat -l info

📖 API Documentation

Once the server is running, access the API documentation at:

🔐 Authentication

Available Authentication Methods

1. JWT Authentication 🔑

   • Get token: POST /api/token/
   • Refresh token: POST /api/token/refresh/

2. Session Authentication 🖥️

   • Login: POST /api/login/
   • Logout: POST /api/logout/
   • Check status: GET /api/auth-status/

3. OAuth2 Authentication 🌐

   • OAuth endpoints: /auth/

👥 User Roles

Role	Description
👑 Admin	Complete system access
🎭 Organizer	Create and manage events, verify tickets
🙂 Visitor	Browse events, purchase and use tickets

🔍 GraphQL API

GraphQL API is available at:

📄 License

---

_{Built with ❤️ by Ahmed}