Mega Hotel VMS - Advanced Visitor Management System

Mega Hotel VMS is a premium, professional-grade Visitor Management System built with Laravel. Designed specifically for hotels, resorts, and corporate environments, it streamlines the check-in and check-out process, enhances security, and provides detailed analytics for visitor tracking.

With features like instant photo capture, digital signatures, and automated security blacklisting, Mega Hotel VMS replaces traditional paper logs with a secure, efficient, and modern digital solution.

🚀 Key Features

• Fast Check-in & Check-out: Streamlined workflow to register visitors in seconds with a user-friendly interface.
• Instant Photo Capture: Integrated camera support to take visitor photos directly from the browser for enhanced identification.
• Digital Signature Capture: Securely capture and store visitor signatures for legal, compliance, and security records.
• Security Blacklist: Instantly block unwanted or restricted individuals from entering your premises based on name or phone number.
• Ticketing System: Generate professional check-in and check-out tickets with unique ticket numbers and QR-style tracking.
• PWA Support: Fully installable Progressive Web App (PWA) compatible with mobile and desktop devices for a native-like experience.
• Real-time Dashboard: Get instant visual insights into active visitors, today's arrivals, and security alerts.
• Advanced Visitor Logs: Comprehensive history with powerful search, date range filters, and status tracking (Active/Checked-out).
• Export to PDF & CSV: Generate detailed audit reports for administrative review with a single click.
• Modern & Responsive UI: Built with Bootstrap and jQuery, ensuring a sleek look on all devices (Tablets, Phones, Desktops).

🛠 Technical Stack

• Backend: Laravel 11.x (PHP 8.2+)
• Frontend: Blade Templates, Bootstrap 5, jQuery
• Database: MySQL / MariaDB
• Security: CSRF Protection, Password Hashing, Secure File Management
• Modern Features: Service Workers, Web Manifest (PWA), Base64 Image Processing

💼 Administrative Features

• One-Click Web Installer: Professional web-based installer to set up the system and database in minutes.
• General Settings: Full control over Hotel Name, Address, Contact details, and Logo customization.
• Device Configuration: Select and save preferred camera devices for photo capture from the admin panel.
• User Management: Manage administrative accounts and secure session control.
• System Update Module: Built-in functionality to handle incremental application updates seamlessly.

📂 What's Included?

• Full Source Code
• Complete Documentation & Installation Guide
• Ready-to-use Database Migrations & Seeders

🌐 Demo Access

Demo URL: https://meg-hotel-vms.onecrib.com
Admin Email: [email protected]
Password: password

Modernize your hotel's security and visitor experience today with Mega Hotel VMS!

🚀 Core Visitor Management

• Fast Check-in Flow: Efficient digital form to capture visitor details (Name, Phone, Purpose, Room Number) in seconds.
• One-Click Check-out: Instantly check out visitors from the live list with automated departure timestamps.
• Live Active Tracking: A dedicated real-time dashboard view of all visitors currently on the premises.
• Unique Ticket Generation: Each visitor receives a unique ticket number with professional printable check-in/check-out passes.
• Digital Signature Capture: Integrated signature pad for legal compliance, allowing visitors to sign directly on-screen.
• Instant Photo Capture: Built-in camera support to snap and store visitor photos for high-security identification.

🛡️ Security & Compliance

• Automated Blacklist System: Instantly block unwanted individuals by name or phone number. High-visibility alerts prevent unauthorized check-ins.
• Detailed Audit Logs: Full historical records of all visitor movements, including attribution to the staff member who handled the check-in/out.
• Secure Asset Storage: Identification photos and signatures are stored securely on the server with encrypted pathing.
• Standard Security Protocols: Built with Laravel 11, featuring CSRF protection, secure session management, and password hashing.

📊 Professional Analytics & Dashboard

• Real-time Stats Cards: Instant overview of Today's Visitors, Active Visitors, Weekly, and Monthly totals.
• 7-Day Visitor Trends: Visual line charts representing traffic patterns to help with staffing and security planning.
• Purpose Analysis: Data breakdown of visitor purposes (e.g., Business, Delivery, Personal) to identify premises usage trends.
• Recent Activity Feed: A "Quick Glance" timeline of the most recent visitor registrations and departures.

📈 Reporting & Data Portability

• Advanced Search & Filtering: Powerful search engine for logs using keywords, date ranges, and status (Active/Checked-out).
• Professional PDF Export: Generate clean, print-ready PDF reports for security audits or administrative reviews.
• CSV Export: One-click data export compatible with Microsoft Excel and Google Sheets for further data manipulation.

📱 Modern PWA & Multi-Device Support

• Progressive Web App (PWA): Fully installable on iOS, Android, and PC. Acts as a standalone native app with a dedicated home screen icon.
• Mobile-First Design: Built with Bootstrap 5, the interface is fully responsive and optimized for touch-screen tablets at reception desks.
• Offline Fallback Support: Custom offline page ensures the app maintains professional branding even during temporary network issues.
• Dynamic Manifest Synchronization: Your hotel name and logo automatically sync to the PWA branding settings.

⚙️ Administrative & Technical Ease

• One-Click Web Installer: Automated installer for requirements check, database setup, and admin account creation.
• Global Configuration: Centralized settings for Hotel Branding (Name, Logo, Address, Phone).
• Hardware Configuration: Select and save preferred camera devices for visitor capture directly from the admin panel.
• System Update Module: Built-in tool to handle incremental system updates and migrations without manual file editing.

🖥️ Server Requirements

To ensure a smooth installation and optimal performance, your server should meet the following technical requirements:

• PHP Version: PHP >= 8.2 (Compatible with PHP 8.3)
• Web Server: Apache (with mod_rewrite enabled) or Nginx
• Database: MySQL 5.7+ or MariaDB 10.3+
• Memory Limit: 256MB or higher (Recommended for photo/PDF processing)
• Operating System: Linux (Ubuntu/Debian) or Windows (WAMP/XAMPP)

📦 Required PHP Extensions

The following PHP extensions must be enabled on your server:

• BCMath — For precise mathematical calculations.
• Ctype — For character type checking.
• cURL — For internal system requests and updates.
• DOM — For XML/HTML document processing (Required for PDF export).
• Fileinfo — For secure photo and file uploads.
• GD or Imagick — Required for processing visitor photos and digital signatures.
• JSON — For data handling and PWA manifest generation.
• Mbstring — For multi-byte string handling.
• OpenSSL — For secure session management and data encryption.
• PDO (MySQL) — For database connectivity.
• Tokenizer — For Laravel framework parsing.
• XML — For PDF generation and reporting.
• ZipArchive — Required for system updates and packaging.

🌐 Client-Side Compatibility

• Browser: Modern browsers with JavaScript enabled (Chrome, Firefox, Safari, Edge).
• Hardware: Camera/Webcam access is required for the visitor photo capture feature.
• PWA: Compatible with any modern device that supports Progressive Web Apps.

🛠️ Quick Installation Guide

Follow these simple steps to get your Mega Hotel VMS up and running in minutes.

1. Upload Files: Upload the source code folder to your server's public directory (e.g., public_html or www).
2. Set Up Database: Create a new MySQL/MariaDB database and a database user with full privileges.
3. Launch Installer: Open your browser and navigate to your domain (e.g., https://yourdomain.com/install).

🚀 Automated Installer Steps

The system features a built-in web installer that will guide you through the configuration:

• Step 1: Welcome — Introduction to the installation process.
• Step 2: Server Requirements — The system automatically checks for the required PHP version and extensions. Ensure all indicators are green.
• Step 3: Permissions — The installer verifies that the storage, bootstrap/cache, and .env files are writable for the system.
• Step 4: Database Configuration — Enter your Database Name, Username, and Password. The system will automatically test the connection and update your configuration.
• Step 5: Database Migration — With one click, the system will set up all necessary tables and seed initial data.
• Step 6: Admin Creation — Set up your master administrator account by entering your Name, Email, and a secure Password.
• Step 7: Finish — The installer will finalize the configuration, link your storage for photos, and redirect you to the login page.

⚠️ Important Post-Installation Steps

• Folder Permissions: Ensure the storage and bootstrap/cache folders remain writable (CHMOD 775 or 755).
• Storage Link: The installer automatically runs php artisan storage:link. If images do not appear, you may need to run this command manually via SSH or your hosting terminal.
• SSL (Recommended): For security and to enable camera access for visitor photos, it is highly recommended to install an SSL certificate (HTTPS) on your domain.

⚙️ System Updates

If you upload an updated version of the code later, you can easily synchronize your database by visiting /update while logged in as an administrator.