Demo URL : https://vmsapp.infinityfreeapp

Username: admin

Password: Admin@123

Professional Visitor Management System for offices, receptions, and security desks. Staff log in to register visitors, capture optional photos, assign departments and hosts, issue badge numbers, and track who is currently on site. Clean server-rendered PHP (no Composer required) with a modern Bootstrap 5 dark-themed UI.

Includes dashboard with recent activity and charts, full visitor profiles, check-out workflows, printable visitor badges, and a reports area with daily, on-premises, and history views—plus CSV export and print-friendly layouts. Administrators manage departments and staff accounts; an optional audit log records key actions for compliance and troubleshooting.

Well-structured MVC-style folders (controllers, models, views), PDO prepared statements, CSRF protection, password hashing, and session security. SQL scripts and database documentation are included for manual installation on shared hosting or dedicated servers.

• Secure staff login (session-based, CSRF on POSTs, password_hash)
• Roles: admin, security, receptionist (extendable in code)
• Visitor check-in: profile, company, host, purpose, department
• Optional visitor photo upload (JPEG/PNG/WebP, stored as JPEG via GD)
• Auto badge numbering; printable badge view
• Visitor list with pagination and last-visit summary
• Edit / delete visitors (cascading visits)
• “Currently inside” view with quick check-out
• Dashboard: tiles, recent visits, 7-day check-in chart
• Reports: daily check-ins, on-premises, full history (date filters, pagination)
• CSV export for reports (UTF-8 with BOM for Excel)
• Print-optimized report and badge styles
• Admin: departments CRUD, users CRUD
• Activity / audit log (admin) when audit_log table exists
• Bootstrap 5.3 UI, custom dark theme, responsive layout
• Front controller routing via index.php?route=...
• .htaccess protection for sensitive directories (Apache)
• No Composer dependency — plain PHP
• SQL bundle: full install + shared-hosting schema + upgrade notes in docs

• PHP 8.2 or higher
• MySQL 5.7+ or MariaDB 10.2+ (InnoDB, utf8mb4 recommended)
• PHP extensions: PDO, pdo_mysql, session, json; GD with JPEG support (for photos)
• Apache (or compatible) web server; mod_rewrite optional
• Writable uploads/ folder for visitor images

1. Upload the visitor-management folder to your web root (or point a vhost to it).

2. Create a MySQL database and user with appropriate privileges.

3. Import SQL:
   • Full demo database: run sql/vms_complete.sql (creates visitor_db, tables, sample departments and demo users — change passwords after login).
   • OR on shared hosting: create an empty database, import sql/schema_install.sql, then insert at least one user in the users table with a bcrypt hash (see sql/DATABASE.md).

4. Copy config/database.local.php.example to config/database.local.php and set host, port, database name, username, and password.

5. Ensure the uploads/ directory (and uploads/visitors/) is writable by the web server.

6. Open the site in a browser using index.php (e.g. …/index.php?route=auth/login).

7. For production: set APP_ENV=production in your server environment, use HTTPS, and do not expose database.local.php. Read docs/APPLICATION.md and sql/DATABASE.md for details, security notes, and troubleshooting.