Employee Management API

🔴 Project Demo

Features

A backend application with APIs for employee management in any generic business:

• Basic user authentication check for all API calls
• Specific calls such as DELETE, POST etc require users to have authority by means of appropriate roles
• View, create and delete roles using appropriate fetch methods
• View, update, create and delete user details using appropriate fetch methods
• View, update, create, delete and sort employee details using appropriate fetch methods
• Adequate server response messages for all requests

Background

Each and every request needs to be authenticated with the correct username and password. Every user needs to have either one of the following roles to be able to send requests:

• OWNER - This is the master role which can access all APIs, can create new roles and users for specific use cases and add new employees into the DB
• ADMIN - Unable to access neither ROLES nor USER APIs, but can make any change to the employees DB
• USER - General role with which a user can view and edit employee details but are forbidden to delete or add new entries. Moreover, has no access to ROLES and USER APIs

APIs

List of all the API calls for specific use cases:

• ROLES

  • Fetch all roles using /employee-management/roles as a GET request
  • View a particular role using /employee-management/roles/${id} as a GET request
  • Create a new role using /employee-management/roles as a POST request
  • Delete an existing role using /employee-management/roles/${id} as a DELETE request

• USERS

  • Fetch all users using /employee-management/users as a GET request
  • View a particular user using /employee-management/users/${id} as a GET request
  • Create a new user using /employee-management/users as a POST request
  • Update a user using /employee-management/users/${id} as a PUT request
  • Delete an existing user using /employee-management/users/${id} as a DELETE request

• EMPLOYEES

  • Fetch all employees' details using /employee-management/employees as a GET request
  • View a particular employee's details:
    • using 'id' by /employee-management/employees/${id} as a GET request
    • using 'first name' by /employee-management/employees?firstName=${first_name} as a GET request
  • Create a new employee using /employee-management/employees as a POST request
  • Update any particular employee details using /employee-management/employees/${id} as a PUT request
  • Delete an existing employee using /employee-management/employees/${id} as a DELETE request
  • Sort the employess list based on their first name using /employee-management/employees/sort?direction=${dir} as a GET request

Tech

The project makes use of the following dependencies: Spring boot, Spring data jpa, Spring security, Java 1.8, lombok