https://github.com/amattu2/payroll-management-system
A Laravel 9 and Bootstrap 5 employee payroll and timekeeping system. Oriented towards a single-tenant deployment.
https://github.com/amattu2/payroll-management-system
bootstrap laravel payroll php
Last synced: 9 months ago
JSON representation
A Laravel 9 and Bootstrap 5 employee payroll and timekeeping system. Oriented towards a single-tenant deployment.
- Host: GitHub
- URL: https://github.com/amattu2/payroll-management-system
- Owner: amattu2
- License: agpl-3.0
- Created: 2022-06-04T21:07:42.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-08-11T14:08:39.000Z (over 1 year ago)
- Last Synced: 2024-08-12T14:38:04.375Z (over 1 year ago)
- Topics: bootstrap, laravel, payroll, php
- Language: JavaScript
- Homepage:
- Size: 5.89 MB
- Stars: 8
- Watchers: 2
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Introduction
A comprehensive HR employee management and timekeeping system. Digitize timesheets, handle time-off requests, and automate standard onboarding procedures.
Abbreviated list of functionality:
- Employee management
- Linked employee accounts
- Track clock-in/clock-out times
- Finalize timesheets with automated notifications
- Manage leave/time-off requests
Coming Soon:
- Automate onboarding procedures with push notifications of hired/terminated employees
- Pre-built reports and employee insights
- Company/department closures and scheduling with notifications
- Supervisor/Department tracking
# Getting Started
Install both Composer and NPM dependencies.
```bash
composer install
npm install
```
Create a copy of the `.env.example` file and rename it to `.env`. Update the database credentials and application key.
```bash
cp .env.example .env
```
Run the database migrations and seeder.
```bash
php artisan migrate --seed
php artisan run:factories # Optional: Seed the database with dummy data
php artisan cache:clear # Clear the temporary DB cache
```
Build frontend the assets
```bash
npm run dev
```
Run the backend service
```bash
php artisan serve
```
Open your browser and navigate to [http://localhost:8000](http://localhost:8000). You can log in with the following credentials (default):
- Email: `admin@example.com`
- Password: `password`
# Previews
## Overview Page
## Employees Page
## Timesheets
## Leave/PTO Page
# To-Do
## App
- [ ] App Settings and Controls
- [ ] Navigation search bar (e.g. Employees, Timesheets, ...)
## Employees
- [ ] Create a user account for a employee
- [ ] Department assignments
- [ ] Supervisor tracking (e.g. Joan reports to Barry)
- [X] Internal comments / Notes
- [X] Profile picture display
- [ ] PTO cap and limit tracking
- [X] General profile editing
- [X] Employee Communication (e.g. Timesheets, Free form emails, PTO Rejections)
- [X] Time-Off Tracking / Requests
## Payroll / Timesheets
- [X] Editing timesheet options (e.g. Period/Pay type)
- [X] Time card tracking
- [ ] Time unit calculation by Day/Hours (including 1/4, 1/2, 3/4 days)
- [X] Exporting (PDF/Email)
## Reports
- [ ] Report Center
- [ ] Statistics/Graphs on pages
- [ ] Employee Statistics
- [ ] Overview Statistics
## Other
- [X] Block a user from logging in if their associated employee is not active
- [X] Heavy query caching (i.e. employees, timesheets)
- [X] Fix factories for tables with unique constraints (Timesheets, Timesheet Days)
- [X] Implement lang file for long/duplicated messages
- [X] When employees are terminated, reject all open PTO requests
# Requirements & Dependencies
- PHP 8+
- Laravel 9.X+
- MySQL
- Bootstrap 5.X+