luizimcpi/kotlin-auth-service

kotlin-auth-service

SETUP DEV

SET Environment Variables

SERVER_PORT=7000
LOG_LOCATION=/your_user/logs
ENABLE_DEBUG=true
DATABASE_URL=jdbc:postgresql://localhost:5432/postgres
DATABASE_USER=postgres
DATABASE_PASSWORD=postgres
AUTH_SECRET=my_super_secret
VIACEP_URL=https://viacep.com.br/ws/
CONTACT_SQS_ADDRESS=http://localhost:9323
CONTACT_SQS_QUEUE_NAME=sqs-contact
CONTACT_SQS_REGION=us-east-1

Create local sqs using alpine sqs

docker run --name alpine-sqs -p 9324:9324 -p 9325:9325 -d roribio16/alpine-sqs

aws --endpoint-url http://localhost:9324 sqs create-queue --queue-name sqs-contact 

send message

aws --endpoint-url http://localhost:9324 sqs send-message --queue-url http://localhost:9324/queue/sqs-contact --message-body "{\"contact\":{\"name\":\"Contato Teste 1\",\"email\":\"contact1@gmail.com\",\"phone\":\"5513999999999\"}}"

Create local postgres database - using docker

docker pull postgres

docker run --name teste-postgres -e "POSTGRES_PASSWORD=postgres" -p 5432:5432 -d postgres

OR

Create local postgres database - linux ubuntu or debian

sudo apt update
sudo apt install postgresql postgresql-contrib

Change default password:
sudo -u postgres psql
ALTER USER postgres WITH PASSWORD 'postgres';

Flyway Info

./gradlew flywayInfo -Dflyway.url=jdbc:postgresql://localhost:5432/postgres -Dflyway.user=postgres -Dflyway.password=postgres

Flyway Migrate

./gradlew flywayMigrate -Dflyway.url=jdbc:postgresql://localhost:5432/postgres -Dflyway.user=postgres -Dflyway.password=postgres
or
make fmigrate

Flyway Clean

./gradlew flywayClean -Dflyway.url=jdbc:postgresql://localhost:5432/postgres -Dflyway.user=postgres -Dflyway.password=postgres
or
make fclean

Start Application using docker

1 -> ./gradlew build
2 -> docker build -t kotlin-auth-service .
3 -> docker-compose up

OR

Start Application using gradle

1 -> ./gradlew build
2 -> java -jar build/libs/kotlin-auth-service-1.0.0-SNAPSHOT.jar
or 
-> make start

Run Unit Tests

./gradlew test

jacocoReport -> build/reports/jacoco/test/jacocoTestReport.xml

Executing Endpoints

File requests.rest can be open with plugin REST client in VSCode

Used Libs

JAVALIN

KOIN

HikariCP

konfig

Exposed

Mockk

Junit 5

Fuel

Sulky ULID

Wiremock

Rest Assured

PostgreSQL Embedded

TO DO

• create and configure arch tests ArchUnit
• pass login crendentials using application/x-www-form-urlencoded
• create refresh token
• document endpoints with openAPI plugin