Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ilhamghaza/laravel-attendace
https://github.com/ilhamghaza/laravel-attendace
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/ilhamghaza/laravel-attendace
- Owner: IlhamGhaza
- Created: 2024-08-26T10:16:51.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-09-17T13:28:46.000Z (3 months ago)
- Last Synced: 2024-09-17T16:48:27.826Z (3 months ago)
- Language: PHP
- Size: 736 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Laravel Attendance System
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.
## Installation
1. **Clone the repository**:
```bash
git clone https://github.com/IlhamGhaza/laravel-attendace.git
cd laravel-attendace
```
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. **Serve the application**:
```bash
php artisan serve
```
## Usage
- **Admin Panel**: Manage shifts, schedules, and attendance records via the Filament interface.
- **Attendance Tracking**: Users can log in via face recognition and geolocation.
## API
This project includes an API built with Laravel Sanctum and Orion for handling CRUD operations.
## 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](LICENSE) file for details.
[](https://opensource.org/licenses/MIT)
## Contact
For any inquiries, please contact Ilham Ghaza at [Email]([email protected]).