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

Version 2.0.0 – Major Feature Update

Release Date: May 2026

🚀 New Features

🔐 Security Improvements
Implemented Role-Based Access Control (RBAC)
Added Permission-Based Menu Visibility
Added Permission-Based Controller Protection
Added CSRF Protection
Added Login Rate Limiting
Added Password Hash Upgrade Mechanism
Added Forced Password Change Support
Added Session Security Improvements

📊 Reporting Improvements
Added Visitor Reports
Added Returning Visitor Reports
Added Expected Visitor Reports
Added Check-In / Check-Out Reports
Added CSV Export
Added Host Information in Reports
Added Department Information in Reports
Added Visitor Status Filtering
Added Date Range Filtering

🏢 Administration Improvements
Added Role Management
Added Permission Assignment Interface
Added User Management
Added Department Management
Added Employee Directory Management
Added System Settings Management

🎨 UI / UX Improvements
Redesigned Roles Management Interface
Redesigned Role Permission Editor
Redesigned User Creation Interface
Added Back Navigation Buttons
Improved Dashboard Statistics
Improved Mobile Responsiveness
Improved Module Marketplace Layout
Improved Notification Template Editor

🐞 Bug Fixes
Fixed Expected Visitor Verification Workflow
Fixed Check-In Permission Validation
Fixed Returning Visitor Permission Mapping
Fixed Administrator Permission Assignment After Installation
Fixed CSV Export Missing Host Information
Fixed CSV Export Missing Department Information
Fixed Notification Template Loading Issues
Fixed Settings Permission Enforcement
Fixed Role Permission Synchronization
Fixed Password Reset Workflow
Fixed User Creation CSRF Validation
Fixed Report Filter Display Issues
Fixed Module Routing Issues
Fixed Installer Access Control Issues
Fixed License Validation Issues
Fixed SMTP Configuration Validation

⚡ Performance Improvements
Optimized Permission Loading
Improved Dashboard Query Performance
Reduced Database Calls in Reports
Improved Module Discovery Performance
Improved Authentication Performance

🔄 Upgrade Notes
New permissions introduced:
returning_manage
view_checkedin_visitors
manage_notification_templates
Database migration required for:
Notification Templates
Expected Visitor Verification
Role Permission Enhancements

⚙️ 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