VIP Game Center

🎮 The Ultimate Gaming Experience

VIP Game Center is a comprehensive Django-based management system designed for modern gaming centers. Compete with top players in this immense challenge and be the champion of all time. Our elite players are waiting for your challenge. Are you ready to prove your skills?

✨ Features

🎯 Core Functionality

• User Management: Role-based access control (Admin, Gaming Staff)
• Booking System: Manage gaming sessions and equipment bookings
• TV Schedule Management: Organize and track TV viewing schedules
• Food Ordering System: Complete POS system for food and beverage orders
• Inventory Management: Track equipment and inventory items with categories
• Sales Reports: Generate comprehensive reports for food sales and TV schedules
• Profile Management: User profiles with customizable avatars and information

🎨 User Interface

• Modern, responsive design with dark theme
• Beautiful gaming-themed UI with neon accents
• Intuitive navigation and user experience
• Professional dashboard for staff and admin

🚀 Getting Started

Prerequisites

• Python 3.8 or higher
• pip (Python package manager)
• Virtual environment (recommended)

Installation

1. Clone the repository

   git clone git@github.com:hamse122/VIP-GAME.git
   cd VIP-GAME

2. Navigate to the project directory

   cd vipgame_ms

3. Create and activate a virtual environment

   # Windows
   python -m venv venv
   venv\Scripts\activate
   
   # Linux/Mac
   python3 -m venv venv
   source venv/bin/activate

4. Install dependencies

   pip install -r requirements.txt

5. Run migrations

   python manage.py migrate

6. Create a superuser

   python manage.py createsuperuser

7. Run the development server

   python manage.py runserver

8. Access the application

   • Open your browser and navigate to http://127.0.0.1:8000/
   • Login with your superuser credentials

📁 Project Structure

vipgame_ms/
├── main/                    # Main application
│   ├── models.py           # Database models
│   ├── views.py            # View logic
│   ├── urls.py             # URL routing
│   ├── forms.py            # Form definitions
│   ├── templates/          # HTML templates
│   ├── static/             # Static files (CSS, JS, images)
│   └── migrations/         # Database migrations
├── vipgame_ms/             # Django project settings
│   ├── settings.py         # Project settings
│   ├── urls.py             # Root URL configuration
│   └── wsgi.py             # WSGI configuration
├── media/                  # User-uploaded media files
├── db.sqlite3              # SQLite database (development)
└── manage.py               # Django management script

🎮 Key Modules

User Management

• Custom user model with roles (Admin, Gaming Staff)
• Profile management with avatars
• Status tracking (Active, On Leave, Inactive)

Booking System

• Create, edit, and delete bookings
• Track booking history
• Equipment assignment

Food Ordering (POS)

• Menu management
• Order creation and processing
• Receipt generation
• Sales reporting

Inventory Management

• Category-based organization
• Transaction tracking
• Inventory reports
• Stock management

TV Schedule

• Schedule management
• Payment tracking
• Receipt generation
• Revenue reports

🛠️ Technologies Used

• Backend: Django 4.2.7
• Database: SQLite (development)
• Frontend: HTML, CSS, JavaScript
• Styling: Bootstrap 5 (via Crispy Forms)
• Forms: Django Crispy Forms

📝 Requirements

The project uses the following Python packages (see requirements.txt):

• Django
• crispy-forms
• crispy-bootstrap5

🔐 Security Notes

⚠️ Important: Before deploying to production:

• Change the SECRET_KEY in settings.py
• Set DEBUG = False
• Configure ALLOWED_HOSTS
• Use a production database (PostgreSQL, MySQL, etc.)
• Set up proper static file serving
• Configure media file storage

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

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

👤 Author

Hamse

• GitHub: @hamse122

🙏 Acknowledgments

• Django community for the excellent framework
• All contributors and testers

---

Ready to join the tournament? 🎮 Let's game!