Skip to content

An application for managing employee data, including a feature to change the password.

Notifications You must be signed in to change notification settings

mairess/employee-system

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Employee System

coverage backend

codecov

Context

This is a system for managing employees.

Try with admin super power:

username: vitoria 

password: 123456

Run with Docker

Prerequisites

⚠️ Make sure you have Docker installed on your machine:

Also set up the following env variables for the mail service (guide here):

MAIL_HOST=smtp.example.com 

MAIL_PORT=123

MAIL_USERNAME=mymail@example.com

MAIL_PASSWORD=asdfASDF123

⚠️ The variable MAIL_PASSWORD is not your email password, you need to create an app password, set this up here if using google.

Steps:

  1. Clone repository:
git clone git@github.com:mairess/employee-system.git

cd employee-system
  1. Run application:
docker compose up -d --build 
  1. Available routes:
http://localhost:8080/swagger-ui/index.html

Run locally

To run this project locally, follow these steps:

Prerequisites

Make sure you have the following installed on your machine:

⚠️ Java

⚠️ Docker

⚠️ Apache kafka

Also set up the following env variables for the mail service (guide here):

MAIL_HOST=smtp.example.com 

MAIL_PORT=123

MAIL_USERNAME=mymail@example.com

MAIL_PASSWORD=asdfASDF123

⚠️ The variable MAIL_PASSWORD is not your email password, you need to create an app password, set this up here if using google.

Steps:

  1. Start Kafka with KRaft (Kafka must be running before start the application):
# Generate a Cluster UUID
KAFKA_CLUSTER_ID="$(bin/kafka-storage.sh random-uuid)"

# Format Log Directories
bin/kafka-storage.sh format -t $KAFKA_CLUSTER_ID -c config/kraft/server.properties

#Start the Kafka Server
bin/kafka-server-start.sh config/kraft/server.properties
  1. Clone repository:
git clone git@github.com:mairess/employee-system.git

cd employee-system
  1. Start database:
docker compose up -d database
  1. Start backend:
cd backend

mvn clean install

mvn spring-boot:run
  1. Start ms-email:
# open another terminal and enter ms-email

cd ms-email

mvn clean install

mvn spring-boot:run
  1. Start frontend (just to change password nothing more):
# open another terminal and enter frontend

cd frontend

npm install

npm run dev
  1. Available routes:
http://localhost:8080/swagger-ui/index.html

Releases

No releases published

Packages

No packages published

Languages