The Event Ticket Booking System is a comprehensive, Django-powered platform that revolutionizes event management. Built with modern web technologies, it provides a seamless experience for both event organizers and attendees with advanced features including secure payment processing, real-time ticket management, and intelligent analytics.

• 🔒 Secure: Industry-standard security practices
• ⚡ Fast: Optimized for high-performance
• 📱 Responsive: Works perfectly on all devices
• 🎨 Modern UI: Clean, intuitive user interface
• 🔧 Modular: Easy to extend and customize

🎟️ Event_Ticket_Booking_System/ ├── 👥 user_service/ # User authentication & profiles ├── 🎪 event_service/ # Event management core ├── 🎫 ticket_service/ # Ticketing system ├── 💳 payment_service/ # Payment processing ├── 🎪 organizer_service/ # Organizer dashboard ├── 📝 complaint_service/ # Issue management ├── 🎨 templates/ # HTML templates ├── 🎯 static/ # Static assets │ ├── css/ # Stylesheets │ ├── js/ # JavaScript files │ └── images/ # Image assets ├── 📄 requirements.txt # Python dependencies ├── ⚙️ manage.py # Django management └── 📋 README.md # This file 

graph TD A[🌐 Guest User] --> B{👤 Authentication} B -->|Register| C[📝 Choose Role] B -->|Login| D{🎭 User Type?} C --> E[🎫 Attendee] C --> F[🎪 Organizer] D --> E D --> F E --> G[🎪 Browse Events] E --> H[💳 Add Payment Method] E --> I[🎟️ Book Tickets] E --> J[📄 Download PDF] E --> K[❌ Cancel Booking] F --> L[🎪 Create Events] F --> M[📊 View Analytics] F --> N[💰 Track Revenue] G --> O[🔍 Search & Filter] I --> P[⏰ 3-Hour Cancellation Window] E --> Q[📝 File Complaint] F --> Q A --> Q style A fill:#e1f5fe style E fill:#f3e5f5 style F fill:#fff3e0 style Q fill:#ffebee 

Before you begin, ensure you have the following installed:

• Python 3.9+ 🐍
• pip (Python package manager) 📦
• Git (version control) 🔄
• Virtual Environment (recommended) 🏠

1. 📥 Clone the Repository

   git clone https://github.com/your-username/Event-Ticket-Booking-System.git cd Event-Ticket-Booking-System

2. 🏠 Create Virtual Environment

   python -m venv venv # On Windows venv\Scripts\activate # On macOS/Linux  source venv/bin/activate

3. 📦 Install Dependencies

   pip install -r requirements.txt

4. ⚙️ Configure Environment

   # Create .env file cp .env.example .env # Edit .env with your settings SECRET_KEY=your-secret-key-here DEBUG=True DATABASE_URL=sqlite:///db.sqlite3

5. 🗄️ Setup Database

   python manage.py makemigrations python manage.py migrate python manage.py createsuperuser

6. 📊 Load Sample Data (Optional)

   python manage.py loaddata fixtures/sample_data.json

7. 🚀 Run Development Server

   python manage.py runserver

8. 🌐 Access the Application

   🏠 Homepage: http://127.0.0.1:8000/ 🔑 Admin Panel: http://127.0.0.1:8000/admin/ 

# Django Settings SECRET_KEY=your-django-secret-key DEBUG=True # Database DATABASE_URL=sqlite:///db.sqlite3 # Email Configuration (Optional) EMAIL_HOST=smtp.gmail.com EMAIL_PORT=587 EMAIL_HOST_USER=your-email@gmail.com EMAIL_HOST_PASSWORD=your-app-password # File Storage MEDIA_ROOT=media/ STATIC_ROOT=static/

🖥️ Desktop View	📱 Mobile View
Full-featured dashboard with analytics	Optimized mobile experience

Interface	Preview	Description
🎪 Event Gallery		Beautiful event cards with filtering
🎫 Booking Flow(1)		Streamlined 2-step booking process
🎫 Booking Flow(2)		Streamlined 2-step booking process
📊 Analytics My Tickets Dashboard		Real-time charts and insights
📊 Analytics Organizer Dashboard		Real-time charts and insights
📄 PDF Tickets		Professional ticket design with QR

# Run all tests python manage.py test # Run specific app tests python manage.py test user_service # Run with coverage coverage run manage.py test coverage report coverage html

# Dockerfile FROM python:3.9-slim WORKDIR /app COPY requirements.txt . RUN pip install -r requirements.txt COPY . . EXPOSE 8000 CMD ["gunicorn", "Event_Ticket_Booking_System.wsgi:application", "--bind", "0.0.0.0:8000"]

# docker-compose.yml version: '3.8' services: web: build: . ports: - "8000:8000" environment: - DEBUG=False - DATABASE_URL=postgresql://postgres:password@db:5432/eventdb depends_on: - db - redis db: image: postgres:13 environment: POSTGRES_DB: eventdb POSTGRES_USER: postgres POSTGRES_PASSWORD: password volumes: - postgres_data:/var/lib/postgresql/data redis: image: redis:alpine volumes: postgres_data:

# Install Heroku CLI heroku login heroku create your-app-name # Configure environment heroku config:set SECRET_KEY=your-secret-key heroku config:set DEBUG=False # Deploy git push heroku main heroku run python manage.py migrate heroku run python manage.py createsuperuser

A planned evolution of the Event Ticket Booking System with real-time, intelligent, and enterprise-grade enhancements.

• 📧 Email Notifications — Send booking confirmations and complaint status updates
• 🔔 Real-time Notifications — Use WebSocket for instant ticketing alerts
• 📱 Mobile Companion App — React Native frontend for mobile users
• 🌐 Multi-language Support — Arabic, English, and more

• 🤖 AI-Powered Recommendations — Suggest events based on user interests
• 📊 Advanced Organizer Analytics — Charts and insights for event performance
• 🎪 Reusable Event Templates — Faster creation with saved configurations
• 💬 Integrated Chat Support — Connect users with support agents
• 🔐 SSO & OAuth Integration — Login with Google/Facebook

• 🌍 Multi-Tenant Support — White-label the system for institutions
• 💳 Multiple Payment Gateways — PayPal, Stripe, and regional gateways
• 📈 Business Intelligence Suite — Enterprise reporting tools
• 🎥 Virtual Event Hosting — Live streaming and webinar features
• 🤝 API Marketplace — Third-party developer plugins and integrations

We welcome contributions from the community! Here's how you can help:

1. 🍴 Fork the Repository
2. 🌿 Create Feature Branch

   git checkout -b feature/amazing-feature

3. 💻 Make Changes
4. 🧪 Run Tests

   python manage.py test

5. 📝 Commit Changes

   git commit -m "Add amazing feature"

6. 🚀 Push to Branch

   git push origin feature/amazing-feature

7. 📬 Open Pull Request

• Follow PEP 8 coding standards
• Write comprehensive tests
• Update documentation
• Use conventional commit messages
• Ensure backward compatibility

Found a bug? Please open an issue with:

• Bug description
• Steps to reproduce
• Expected vs actual behavior
• Environment details
• Screenshots (if applicable)

👨‍🎓 Project Team

Role	Name	Contact
🎓 Student Developer	Alaa Emad Al Hout
👨‍🏫 Project Supervisor	Dr.Abdelkareem Alashqar

🏫 Institution

Islamic University of Gaza Faculty of Information Technology - Graduate Studies Department (Master's) Course: Advanced Software Engineering

🙏 Special Thanks

• Django Community for the amazing framework
• Bootstrap team for the UI components
• ReportLab for PDF generation capabilities
• All contributors and testers