🏨 Hotel Management System

A comprehensive hotel management system built with Flask, featuring room management, booking system, guest portal, loyalty programs, and advanced analytics.

Features

• 🏨 Room Management with Multi-Image Gallery
• 📅 Advanced Booking System with Timeline
• 👥 Guest Portal with Self-Registration
• 💳 Billing & PDF Invoice Generation
• ⭐ Review & Rating System
• 🎁 Loyalty Program (Bronze/Silver/Gold/Platinum)
• 🧹 Room Cleaning Status Tracking
• 📊 Advanced Analytics & Reports
• 🔔 Real-time Notifications
• 🌙 Dark Mode Support
• 👨‍💼 Staff Management
• 🍽️ Additional Services (Food, Laundry, etc.)
• 📈 Revenue Dashboard

Tech Stack

• Backend: Python Flask
• Database: PostgreSQL (Production) / SQLite (Development)
• Frontend: HTML, CSS, JavaScript, Bootstrap 5
• Charts: Chart.js
• PDF: ReportLab
• Authentication: Flask-Login

Installation

Local Development

1. Clone the repository
2. Create virtual environment:

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

3. Install dependencies:

   pip install -r requirements.txt

4. Run the application:

   python app.py

5. Open browser: http://127.0.0.1:5000

Default Login

• Admin: username: admin, password: admin123
• Guest: Register a new account

Deployment on Render

1. Push code to GitHub
2. Connect Render to your GitHub repository
3. Render will automatically detect render.yaml
4. Click "Create New" → "Blueprint"
5. Select your repository
6. Render will create database and web service automatically

Environment Variables

• SECRET_KEY: Auto-generated by Render
• DATABASE_URL: Auto-configured by Render
• MAIL_SERVER: (Optional) For email features
• MAIL_USERNAME: (Optional) For email features
• MAIL_PASSWORD: (Optional) For email features

Database Schema

• Users: Admin, Staff, Guest accounts
• Rooms: Room details, images, amenities
• Guests: Guest information, loyalty points
• Bookings: Booking records with timeline
• Reviews: Room reviews and ratings
• Notifications: User notifications
• Services: Additional hotel services
• Payments: Payment tracking
• RoomImages: Multiple images per room

API Endpoints

• /login - User authentication
• /register - Guest registration
• /dashboard - Admin dashboard
• /guest/dashboard - Guest dashboard
• /rooms - Room management
• /bookings - Booking management
• /calendar - Calendar view
• /reports - Custom date reports
• /analytics - Advanced analytics
• /notifications - Notification center
• /services - Additional services
• /staff - Staff management
• /cleaning-dashboard - Cleaning status

Contributing

This is a complete production-ready system. Feel free to:

• Report bugs
• Suggest features
• Submit pull requests

License

MIT License - Free to use for educational and commercial purposes

Support

For issues or questions, please create an issue in the repository.

Credits

Built with ❤️ using Python & Flask