🎫 TicketKatun - Ticket Booking System

A comprehensive Django-based ticket booking system for movies, sports events, and transport services with MongoDB integration.

🌟 Features

🎬 Event Management

Movie Events: Book movie tickets with seat management
Sports Events: Cricket and football match bookings
Transport Services: Bus and train ticket reservations
Real-time Seat Availability: Live seat tracking
Featured Events: Highlighted events on homepage

👤 User Management

User Registration & Authentication: Secure login/logout
User Profiles: Extended profile with contact information
Profile Updates: Edit personal information
Booking History: View past bookings
Wishlist: Save favorite events

💳 Booking System

Multi-Event Support: Book any type of event
Seat Selection: Real-time seat availability
Booking Management: View, update, and cancel bookings
Payment Integration: Secure payment processing
Booking Status: Track booking status (booked/cancelled)

🔍 Search & Discovery

Event Search: Search by name, location, or type
Event Filtering: Filter by event type (movies, sports, transport)
Event Details: Comprehensive event information
Responsive Design: Works on all devices

🛡️ Security Features

CSRF Protection: Cross-site request forgery protection
Authentication: Secure user authentication
Authorization: Role-based access control
Input Validation: Form validation and sanitization
Session Management: Secure session handling

🏗️ System Architecture

7-Layer Architecture

Client Layer: Web browsers, mobile devices
Presentation Layer: Django templates, Bootstrap CSS, JavaScript
Application Layer: Django views, URL routing, forms
Business Logic Layer: Event management, booking engine, user management
Data Access Layer: Django ORM, MongoDB driver
Data Storage Layer: MongoDB collections, file storage
External Services: Payment gateway, email, SMS services

Database Schema

User: Authentication and user data
UserProfile: Extended user information
MovieEvent: Movie screenings and details
SportsEvent: Sports events (cricket, football)
Transport: Bus and train services
Booking: Ticket reservations
Wishlist: Saved events

🛠️ Technology Stack

Backend

Django 2.2: Web framework
Python 3.12: Programming language
MongoDB: NoSQL database
Djongo: MongoDB connector for Django

Frontend

HTML5: Markup language
CSS3: Styling
Bootstrap: Responsive UI framework
JavaScript: Client-side functionality
AJAX: Asynchronous requests

Database

MongoDB: Primary database
Collections: Organized data storage
File Storage: Images and static assets

📋 Prerequisites

Python 3.12 or higher
MongoDB 4.0 or higher
Git

🚀 Installation

1. Clone the Repository

git clone https://github.com/yourusername/ticket-booking-system.git
cd 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 MongoDB

Install MongoDB on your system
Start MongoDB service
Create a database for the project

5. Configure Django Settings

Copy ticketbooking/settings.py to ticketbooking/local_settings.py
Update database settings in local_settings.py
Set SECRET_KEY and DEBUG settings

6. Run Migrations

python manage.py makemigrations
python manage.py migrate

7. Create Superuser

python manage.py createsuperuser

8. Populate Sample Data

python manage.py setup_mongodb

9. Run the Development Server

python manage.py runserver

📁 Project Structure

ticket-booking-system/
├── booking/                    # Main Django app
│   ├── management/            # Custom management commands
│   ├── migrations/            # Database migrations
│   ├── static/               # Static files (CSS, JS, images)
│   ├── templates/            # HTML templates
│   ├── admin.py              # Django admin configuration
│   ├── forms.py              # Django forms
│   ├── models.py             # Django models
│   ├── mongo_models.py       # MongoDB models
│   ├── urls.py               # URL routing
│   └── views.py              # View functions
├── ticketbooking/            # Django project settings
│   ├── settings.py           # Django settings
│   ├── urls.py               # Main URL configuration
│   └── wsgi.py               # WSGI configuration
├── media/                    # User uploaded files
├── staticfiles/              # Collected static files
├── requirements.txt          # Python dependencies
├── README.md                 # Project documentation
├── er_diagram.puml          # Entity Relationship Diagram
├── block_diagram.puml       # System Architecture Diagram
└── manage.py                # Django management script

🎯 Key Features Implementation

Real-time Seat Availability

AJAX-based seat updates
Real-time seat tracking
Automatic seat reservation

Profile Management

Extended user profiles
Contact information storage
Profile update functionality

Booking System

Multi-event booking support
Seat management
Booking status tracking

Wishlist Functionality

Save favorite events
Wishlist management
Quick booking from wishlist

🔧 Configuration

Environment Variables

Create a .env file in the project root:

DEBUG=True
SECRET_KEY=your-secret-key-here
DATABASE_URL=mongodb://localhost:27017/ticketbooking

MongoDB Configuration

Update database settings in ticketbooking/settings.py:

DATABASES = {
    'default': {
        'ENGINE': 'djongo',
        'NAME': 'ticketbooking',
        'HOST': 'localhost',
        'PORT': 27017,
    }
}

🧪 Testing

Run Tests

python manage.py test

Run Specific Tests

python manage.py test booking.tests

📊 Database Management

Create Sample Data

python manage.py setup_mongodb

Clean Duplicate Profiles

python manage.py clean_duplicate_profiles

Debug Profiles

python manage.py debug_profiles

🚀 Deployment

Production Settings

Set DEBUG=False in settings
Configure production database
Set up static file serving
Configure HTTPS
Set up environment variables

Heroku Deployment

Create Procfile
Configure runtime.txt
Set up MongoDB Atlas
Deploy to Heroku

📈 Performance Optimization

Database Optimization

Index frequently queried fields
Use MongoDB aggregation pipelines
Implement caching strategies

Frontend Optimization

Minify CSS and JavaScript
Optimize images
Use CDN for static files

🔒 Security Considerations

Authentication

Secure password hashing
Session management
CSRF protection

Data Protection

Input validation
SQL injection prevention
XSS protection

API Security

Rate limiting
API authentication
Request validation

🤝 Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests
Submit a pull request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Authors

Your Name - Initial work - YourGitHub

🙏 Acknowledgments

Django community for the excellent framework
MongoDB team for the database
Bootstrap team for the UI framework
All contributors and testers

📞 Support

For support and questions:

Create an issue on GitHub
Email: your.email@example.com
Documentation: Wiki

🔄 Version History

v1.0.0 - Initial release with basic booking functionality
v1.1.0 - Added wishlist and profile management
v1.2.0 - Real-time seat availability
v1.3.0 - Payment integration and security improvements

Made with ❤️ using Django and MongoDB

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
booking		booking
event_banners		event_banners
static/booking		static/booking
ticketbooking		ticketbooking
.gitignore		.gitignore
Procfile		Procfile
README.md		README.md
block_diagram.puml		block_diagram.puml
block_diagram_simple.md		block_diagram_simple.md
block_diagram_visual.txt		block_diagram_visual.txt
crud_operations_guide.md		crud_operations_guide.md
direct_plantuml_link.txt		direct_plantuml_link.txt
er_diagram.puml		er_diagram.puml
er_diagram_simple.md		er_diagram_simple.md
er_diagram_visual.txt		er_diagram_visual.txt
github_upload_guide.md		github_upload_guide.md
homepage_description.md		homepage_description.md
manage.py		manage.py
ngrok_deployment_guide.md		ngrok_deployment_guide.md
ngrok_setup.py		ngrok_setup.py
plantuml_instructions.md		plantuml_instructions.md
project_conclusion.md		project_conclusion.md
project_conclusion_3_para.md		project_conclusion_3_para.md
project_introduction.txt		project_introduction.txt
project_introduction_detailed.md		project_introduction_detailed.md
project_summary_sections.md		project_summary_sections.md
railway.json		railway.json
railway_deployment_guide.md		railway_deployment_guide.md
requirements.txt		requirements.txt
requirements_specifications.md		requirements_specifications.md
runtime.txt		runtime.txt
tunnel.py		tunnel.py
vercel.json		vercel.json

shuv0gg/Webbased_TIcket_Booking_System

Folders and files

Latest commit

History

Repository files navigation