Skip to content

A Basic Employees & Companies Management Project On Laravel

Notifications You must be signed in to change notification settings

jameurfida/Mini-HRM-Project

Repository files navigation

Mini-HRM Logo

Preview Demo Current Version License

Admin Panel to manage Companies and Employees.

Table of Contents

About

Mini-HRM is a web application built using Laravel, aimed at managing companies and their employees efficiently. It provides basic CRUD functionality for companies and employees, along with additional features like email notifications, trash functionality, and a user-friendly front-end theme.

Features

  • Basic Laravel Auth: Administrators can log in to the application.
  • Database Seeds: The first user with email admin@admin.com and password "password" is created.
  • Companies CRUD: Ability to create, read, update, and delete companies.
  • Employees CRUD: Ability to create, read, update, and delete employee records associated with companies.
  • Companies DB Table: Fields include Name (required), email, and logo (minimum 100x100).
  • Employees DB Table: Fields include First name (required), last name (required), Company (foreign key to Companies), email, and phone.
  • Database Migrations: Migrations are used to create the necessary database schemas.
  • File Storage: Companies' logos are stored in storage/app/public folder and made accessible to the public.
  • Validation: Laravel's validation function using Request classes is implemented.
  • Pagination: Laravel's pagination is used to display Companies/Employees lists with 10 entries per page.
  • Front-end Theme: Utilized more complicated front-end theme like Tabler.
  • Email Notification: Sends an email whenever a new company is entered using Mailgun or Mailtrap.
  • Move Deleted Items to Trash: Soft deletion implemented to move deleted items to trash.
  • View & Restore Trashed Data: Ability to view and restore trashed data.

Demo

Mini-HRM Project Demo Preview Demo

Installation

  1. Clone the repository.
  2. Install the required dependencies using composer:

Usage

Run the development server:

php artisan serve

  1. Open your browser and navigate to the application.

  2. Log in using the provided credentials (admin@admin.com / password).

  3. Start managing companies and employees through the user-friendly interface.

Technologies Used

Laravel - The PHP web application framework. Tabler - The front-end theme used for an enhanced user experience. Mailgun or Mailtrap - For email notifications. Other dependencies (list any additional technologies or packages used). Contributing Contributions are welcome! If you find any issues or have suggestions for improvement, feel free to open an issue or create a pull request.

License

This project is open-sourced software licensed under the MIT license.

About

A Basic Employees & Companies Management Project On Laravel

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages