WS-GatePass is a powerful, enterprise-ready Visitor Gate Pass Management System designed to modernize and automate how organizations manage visitor access, security, and communication. Built with flexibility and scalability in mind, WS-GatePass replaces traditional paper-based or manual visitor logs with a fully digital, intelligent system that ensures efficiency, accountability, and real-time visibility across all visitor interactions. From the moment a visitor is scheduled to their arrival, verification, check-in, and eventual check-out, the system provides a seamless, structured workflow that reduces human error, enhances security compliance, and improves the overall visitor experience.

⚡ Smart Automation at Every Stage

The system introduces intelligent automation into every stage of the visitor lifecycle:

• Visitors can be pre-scheduled before arrival
• A verification code ensures only authorized visitors gain access
• Check-in processes are streamlined with pre-filled data and quick actions
• Real-time notifications keep visitors, hosts, and administrators informed instantly

🔹 Core Visitor Management

• Visitor Check-In & Check-Out (Manual & Tag-Based)
• Expected Visitor Scheduling with Verification Code
• Returning Visitor Quick Entry
• Visitor Badge / Tag Assignment
• Real-time Visitor Status Tracking (Expected, Checked-In, Checked-Out)

🔹 Smart Induction System

• Pre-visit Induction Registration
• Auto-fill Check-In from Induction Records
• Induction Status Tracking (Pending / Completed)
• Seamless conversion from induction → check-in

 🔹 Multi-Channel Notifications

• Email Notifications (Visitor, Host, Internal)
• WhatsApp Notifications (Real-time alerts)
• SMS Notifications (via modular providers)
• Template-based notification system
• Fully customizable message content

🔹 Modular Communication System

• Plug & Play Modules (Brevo, SendGrid, Zoho, Twilio, Termii, WhatsApp)
• One Active Provider per Channel (conflict-safe system)
• License-based module activation
• Marketplace-ready architecture

🔹 Advanced Reporting & Insights

• Visitor Reports (Filtered by Date, Status)
• Expected Visitor Reports
• Returning Visitor Reports
• CSV Export for all reports
• Real-time dashboard analytics

🔹 Role-Based Access Control (RBAC)

• User Roles & Permissions
• Fine-grained access control (per feature)
• Secure admin/user separation
• Scalable for enterprise use 

🔹 Department & Host Management

• Department creation & organization
• Employee (Host) assignment
• Visitor-to-host mapping
• Department-based reporting

🔹 Tag-Based and Button Check Out Operations

• Fast Check-Out using Tag Number
• Fast Check-Out using Check-Out Button
• Supports high-volume environments
• Reduces front desk processing time

🔹 Professional Dashboard

• Total Visitors Overview
• Daily Visitor Metrics
• Checked-In / Overstay Monitoring
• Induction Tracking Summary
• Clean, modern UI with visual cards

🔹 Mobile-Friendly Interface

• Responsive dashboard and forms
• Optimized for tablets and smartphones
• Collapsible sidebar navigation
• Touch-friendly UI elements

🔹 Secure & Production-Ready

• CSRF Protection
• Rate Limiting
• Input Sanitization (XSS Protection)
• Secure File Upload Handling
• Permission-based file structure enforcement
• Installer pre-check validation (permissions, environment)

🔹 Easy Installation Wizard

• Step-by-step installer (No CLI required)
• Database setup via UI
• Admin account creation
• License activation during install
• Auto configuration generation

🔹 Custom Branding & Settings

• Logo & Favicon upload
• Company profile configuration
• Email settings (SMTP / API providers)
• System-wide settings panel

 🔹 Multi-Language Support

• Language switching (EN, FR, ES, etc.)
• Translation helper system
• Expandable language packs

🎯 USE CASES

• Corporate Offices
• Hospitals & Clinics
• Government Facilities
• Schools & Universities
• Industrial Sites
• Event Venues

⚙️ System Requirements

PHP >= 8.0

MySQL / MariaDB

Apache / Nginx (with mod_rewrite enabled)

cPanel / Shared Hosting supported

PHP Extensions Required:

mysqli

curl

json

mbstring

openssl

🟢 1. Getting Started

🔐 Login

1. Open your system URL
2. Enter your Username and Password
3. Click Login

🏠 2. Dashboard Overview

After login, you will see the dashboard.

📊 What you’ll see:

• Total Visitors
• Visitors Today
• Checked-In Visitors
• Overstays
• Visitor Status Breakdown
• Induction Summary

👉 This gives you a quick overview of all visitor activities.

👥 3. Managing Visitors

✅ A. Check-In Visitor

1. Go to Visitors → Check-In
2. Fill in:
   • Name
   • Phone Number
   • Company
   • Host (person to visit)
   • Department
3. Click Check-In

✔ Visitor is now registered

✔ Notifications are sent (if enabled)

🔁 B. Returning Visitor

1. Go to Visitors → Returning Visitor
2. Select existing visitor
3. System auto-fills details
4. Click Check-In

📅 C. Expected Visitor

Used to schedule visitors before arrival.

1. Go to Visitors → Expected Visitor
2. Enter visitor details
3. Select visit date
4. Click Save

✔ Visitor receives a verification code

🔐 D. Verify Visitor

1. Click Verify on expected visitor
2. Enter the verification code
3. Click Submit

✔ Visitor is verified

✔ Redirects to Check-In

🚪 E. Check-Out Visitor

Option 1: From List

• Go to Checked-In Visitors
• Click Check-Out

Option 2: By Tag

• Click Check-Out by Tag (top bar)
• Enter tag number
• Submit

✔ Visitor is checked out

✔ Notifications are sent

🏢 4. Departments

1. Go to Operations → Departments
2. Add department name
3. Click Save

Used to organize visitors and reporting.

👨‍💼 5. Employees (Hosts)

1. Go to Operations → Employees
2. Add:
   • Name
   • Email
   • Department
3. Click Save

✔ Visitors can be assigned to hosts

🛡 6. Induction Management

Used for pre-approval or onboarding.

1. Go to Visitors → Induction
2. Add visitor details
3. Set status to Pending

✔ During check-in, data can be auto-filled

📊 7. Reports

Go to Reports

Available Reports:

• Visitor Report
• Expected Visitors
• Returning Visitors

Features:

• Filter by date
• Filter by status
• Search visitors
• Export to CSV

📧 8. Notifications Setup

Go to:

Settings → SMTP Settings

Configure:

• Email server (SMTP or API module)
• Sender name & email

💬 Optional Modules

You can enable:

• Email (Brevo, SendGrid, Zoho)
• SMS (Termii, Twilio)
• WhatsApp

🧩 9. Modules

Go to Modules

You can:

• Install new modules
• Activate / deactivate modules
• Configure module settings

👤 10. Users & Permissions

Go to Administration → Users

You can:

• Create users
• Assign roles
• Control permissions

🎨 11. System Settings

Go to Settings

Customize:

• Company Name
• Logo
• Favicon
• Footer text
• Theme