Traveler API

Desenvolvido por

Testado por

Documentação da API

A documentação completa da API está disponível aqui.

Descrição

O Traveler API é uma aplicação desenvolvida em Java com o framework Spring Boot, focada em gerenciar e rastrear despesas durante viagens. O projeto permite que os usuários registrem suas viagens, associem despesas às viagens, categorizem essas despesas, e obtenham relatórios detalhados.

Funcionalidades

• Cadastro de usuários e autenticação com JWT.
• Registro de viagens com histórico e detalhes.
• Cadastro e associação de despesas a viagens.
• Relatório do valor total de despesas por viagem.
• Suporte para categorias de despesas (alimentação, transporte, hospedagem, etc.).
• API documentada com Swagger.
• Configuração de CORS para permitir acesso frontend.
• Configuração de migrations, para criação e versionamento do banco de dados.

Configuração do Ambiente

Pré-requisitos

• Java 21
• Maven 3.8+
• Docker
• PostgreSQL 16

Instalação e Execução

1. Clone o repositório:

   
   git clone https://github.com/traveler-ATITUS-2024/traveler-api.git
   cd traveler-api

2. Configure os arquivos .env e config.json com seus dados:

   
   .env
   .config.json

3. Execute a aplicação com o Docker:

   
   docker compose up --build -d

4. Se estiver local, acesse a api no endereço:

   
   http://localhost:8080