Laravel Attendance Lab System

Table of Contents

• Laravel Attendance Lab System
  • Table of Contents
  • Features
  • Tech Stack
  • Requirements
  • Getting Started
  • Usage
  • API
  • Contributing
  • License
  • Support

This project is a Laravel-based attendance system designed for general use. It features face recognition, geolocation, and flexible shift management. The system is ideal for organizations needing an efficient way to track attendance, manage schedules, and handle absences.

Features

• Face Recognition: Users can clock in and out using face recognition technology.
• Geolocation: Ensures that attendance is recorded only when users are at the specified location.
• Absence Management: Users can provide reasons and evidence for absences.
• User-Friendly Interface: Built with Filament to provide a clean and intuitive admin panel.

Tech Stack

• Laravel 11.x: The PHP framework used to build the application.
• Filament 3: Used for the admin interface and resource management.
• MySQL 8.0: The database system used to store all records.
• Sanctum: For API authentication.

Requirements

• PHP 8.0 or higher
• Composer
• MySQL 8.0 or higher

Getting Started

To get started with the Laravel Attendance Lab project, follow the steps below:

1. Clone the repository:

   git clone https://github.com/IlhamGhaza/laravel-attendance-lab.git
   cd laravel-attendance-lab

2. Install dependencies:

   composer install

3. Copy the .env.example file to .env:

   cp .env.example .env

4. Generate application key:

   php artisan key:generate

5. Set up your database:

   • Update the .env file with your database credentials.

   • Run migrations and seeders:

     php artisan migrate --seed

6. Install Laravel Shield for User Permissions: you can use this command to install Laravel Shield for user permissions

   php artisan shield:install

   to generate all permissions

   php artisan shield:generate --all

   you can read the documentation here

7. Serve the application:

   php artisan serve

8. Access the application:

   Open your web browser and visit http://localhost:8000/admin to access the Laravel Attendance Lab application.

9. Admin Panel:

   Log in with the admin credentials provided during the seed process.

Usage

• Admin Panel: Manage shifts, schedules, and attendance records via the Filament interface.
• Clock In/Out: Users can clock in and out using the face recognition feature.
• Manage Shifts: Admins can create and manage shifts for users.
• Absence Requests: Users can submit absence requests with reasons and evidence.

API

you can use postman to test api in postman_collections folder

Contributing

Contributions are welcome! Please follow the standard GitHub flow:

1. Fork the repository.
2. Create a new branch.
3. Make your changes.
4. Submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Support

If you encounter any issues or have any questions, please feel free to reach out to the project maintainer at Email.