Introduction

A front desk / visitor management system is an essential aspect of any business. It serves as the first point of contact for customers, potentially making or breaking their experience. Our Welcome - Frontdesk/Visitor Management System is designed to handle all customer inquiries and requests, track them effectively, and automate parts of the process. It also provides information about the company’s services and products, saving time and money while enhancing customer service.

Key Features

Here are some of the main features that make this system stand out:

• Welcome Visitor Records: Efficiently manage visitor information.
• Capture Visitor Images: Keep a visual record of your visitors.
• Connect and Sync with Active Directory (AD): Seamless integration with your existing directory.
• Web-based Front Desk: Convenient check-in/out process for visitors.
• Visitor Analytics Dashboard: Gain insights into visitor data.
• Daily Visitor List: Keep track of daily visitors.
• Non-Checked-Out Visitor List: Manage visitors who haven't checked out.
• Unlimited Accounts: Create as many accounts as needed.
• User Role and Permission System: Define roles and permissions for better control.
• Responsive Interface: Accessible on desktop, tablet, and mobile devices.
• Cloud and Self-Hosted Solutions: Flexibility to choose your hosting option.

Requirements

Before you start, ensure your environment meets the following requirements:

• PHP version ^8.1
• MySQL 5.x or higher
• Nginx or Apache
• LDAP Extension (if using Active Directory)

Installation

Follow these steps to get the project up and running:

Step 1: Clone the Repository

git clone https://github.com/md-sazzadul-islam/front-desk-visitor-management.git
cd front-desk-visitor-management

Step 2: Install Dependencies

composer install

Step 3: Configure Environment

Copy the example environment file and generate the application key:

cp .env.example .env
php artisan key:generate

Step 4: Edit the .env File

Configure your database and other settings in the .env file.

Step 5: Import SQL

Import the SQL file to set up the database schema:

File: sql/welcome.sql 

Step 6: Serve the Application

Start the development server:

php artisan serve

Configuration

LDAP Configuration

Ensure your .env file contains the following LDAP configurations:

LDAP_HOSTS=mail.example.com
LDAP_PORT=389
LDAP_USERNAME=welcome@example.com
LDAP_PASSWORD=password
LDAP_BASE_DN="dc=example,dc=com"

Mail Configuration

Configure your mail settings in the .env file:

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=f0958845bdc3a0
MAIL_PASSWORD=0256d421515e5d
MAIL_ENCRYPTION=tls

Demo Login Info

Use the following demo accounts to log in:

Admin

• Username: admin@sazzadul.com
• Password: 12345678

User

• Username: user@sazzadul.com
• Password: 12345678

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. Check out the GitHub repository to get started.

Contact

For any questions or support, feel free to reach out:

Md Sazzadul Islam - https://sazzadul.com

For more details, visit the project documentation.

Let's build a better visitor management experience together!