Task Organizer API

This is a complete example of Clean Architecture implemented with Java, SpringBoot and MongoDB, in a simple CRUD application, with high coverage of unit and integration tests, using Junit 5 and TestContainers.

🛠️ Tecnologies

• Spring Boot
• MongoDB
• Docker
• TestContainers
• Java JWT (Auth0)
• Lombok
• Springdoc OpenAPI

📖 Documentation

The documentation can be accessed after deploying the application via the URL http://localhost:8080/swagger-ui/index.html#/ .

You can also import my set of requests into Postman. There you have all the endpoints with all the necessary URL parameters and body details to interact with the API.

🚀 How to Run

📋 Prerequisites

• Docker
• Docker Compose

🔎 Details

The application is configured to connect to MongoDB via port 27017.

🌍 Environment variables:

docker-compose.yml is configured to use default values.

Database

DB_USERNAME: Default value root

DB_PASSWORD: Default value root

Security

JWT_SECRET: secret used to generate a JWT token. Default value secret

These settings can also be changed in application.properties.

📦 Installing

Clone the project with the command (or download the zip from Github):

  git clone https://github.com/mtpontes/task-organizer-api.git

🌐 Deploy

Raise the containers:

  docker-compose up --build