Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ilhamghaza/laravel-attendance-lab
Laravel Attendance Lab is a backend system for mobile lab attendance using face detection and geolocation. Built with Laravel 11.x and Filament 3, it manages lab schedules, aslab transfers, and attendance efficiently through a user-friendly admin interface.
https://github.com/ilhamghaza/laravel-attendance-lab
attendance-lab attendance-management-system backend face-recognition filament firebase geolocation laravel mlkit-face-detection php
Last synced: about 2 months ago
JSON representation
Laravel Attendance Lab is a backend system for mobile lab attendance using face detection and geolocation. Built with Laravel 11.x and Filament 3, it manages lab schedules, aslab transfers, and attendance efficiently through a user-friendly admin interface.
- Host: GitHub
- URL: https://github.com/ilhamghaza/laravel-attendance-lab
- Owner: IlhamGhaza
- License: mit
- Created: 2024-09-08T14:45:23.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-09-17T13:24:10.000Z (3 months ago)
- Last Synced: 2024-10-10T12:44:26.999Z (2 months ago)
- Topics: attendance-lab, attendance-management-system, backend, face-recognition, filament, firebase, geolocation, laravel, mlkit-face-detection, php
- Language: PHP
- Homepage:
- Size: 742 KB
- Stars: 1
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Laravel Attendance Lab System
## Table of Contents
- [Laravel Attendance Lab System](#laravel-attendance-lab-system)
- [Table of Contents](#table-of-contents)
- [Features](#features)
- [Tech Stack](#tech-stack)
- [Requirements](#requirements)
- [Getting Started](#getting-started)
- [Usage](#usage)
- [API](#api)
- [Contributing](#contributing)
- [License](#license)
- [Support](#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**:
```bash
git clone https://github.com/IlhamGhaza/laravel-attendance-lab.git
cd laravel-attendance-lab
```
2. **Install dependencies**:
```bash
composer install
```
3. **Copy the `.env.example` file to `.env`**:
```bash
cp .env.example .env
```
4. **Generate application key**:
```bash
php artisan key:generate
```
5. **Set up your database**:
- Update the `.env` file with your database credentials.
- Run migrations and seeders:
```bash
php artisan migrate --seed
```
6. **Install Laravel Shield for User Permissions**:
you can use this command to install Laravel Shield for user permissions
```bash
php artisan shield:install
```
to generate all permissions
```bash
php artisan shield:generate --all
```
you can read the documentation [here](https://filamentphp.com/plugins/bezhansalleh-shield)
7. **Serve the application**:
```bash
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
[](https://opensource.org/licenses/MIT)
This project is licensed under the MIT License. See the [LICENSE](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]([email protected]).