Este é um projeto de API RESTful para gerenciamento de fluxo de caixa de uma empresa. Com ele, é possível cadastrar lançamentos de crédito e débito e verificar o saldo diário.

• Separação em camadas (Controller, Service e Repository)
• Injeção de dependências com Spring
• Uso de DTOs para transferência de dados entre a API e o banco de dados

• Strategy: utilizado para implementar diferentes formas de cálculo do saldo diário.
• Repository: utilizado para abstrair a camada de acesso ao banco de dados.
• DTO: utilizado para transferência de dados entre as camadas.

• Java 17
• Spring Boot 3
• Spring Data JPA
• Spring Security
• Spring Boot Actuator
• JWT
• H2 Database
• Swagger 3
• Lombok
• JUnit 5
• Mockito
• ModelMapper

• POST /login: endpoint para realizar a autenticação de um usuário e gerar um token JWT.
• POST /lancamentos: endpoint para adicionar um novo lançamento.
• GET /lancamentos/{id}: endpoint para buscar um lançamento por id.
• GET /lancamentos: endpoint para listar todos os lançamentos.
• GET /lancamentos?data={data}: endpoint para listar todos os lançamentos de uma determinada data.
• GET /saldo-consolidado/{data}: endpoint para calcular o saldo diário de uma determinada data.

Para executar o projeto, é necessário ter o Java 17 e o Maven instalados.

Para usar a API, é necessário ter o Docker e o Docker Compose instalados.

git clone https://github.com/pauloruszel/controle-fluxo-caixa.git

cd controle-fluxo-caixa

mvn clean package

docker-compose up --build

A API estará disponível em http://localhost:8080.

Para utilizar as funcionalidades da API, é necessário realizar a autenticação e obter um token JWT.

Endpoint de autenticação: POST /login

Body:
{
    "login": "Paulo",
    "password": "1234"
}

A resposta será um token JWT, que deve ser incluído no header das requisições que exigem autenticação, no formato "Bearer {token}".

Para rodar os testes unitários, execute o comando abaixo:

mvn test

A aplicação possui o Spring Boot Actuator configurado para expor os endpoints /health, /info e /metrics na porta 1979. Para acessá-los, utilize o seguinte endereço:

• http://localhost:1979/actuator/health.