Perschase API

API REST para gestão financeira pessoal (SaaS), desenvolvida com foco em boas práticas de arquitetura e código limpo.

Tecnologias Utilizadas

• Java 21 (LTS)
• Spring Boot 3 (Framework Web)
• PostgreSQL (Banco de Dados Relacional)
• Spring Data JPA (Persistência)
• Lombok (Produtividade e redução de boilerplate)
• Bean Validation (Segurança e validação de dados)
• Maven (Gerenciador de Dependências)

Arquitetura

O projeto segue a arquitetura em camadas (Layered Architecture):

1. Controller: Camada responsável apenas pela comunicação HTTP (REST).
2. Service: Camada responsável pelas regras de negócio.
3. Repository: Camada responsável pela interação com o Banco de Dados.
4. Domain/Model: Representação das entidades do negócio.

Como Rodar o Projeto

Pré-requisitos

• Java 21 instalado
• PostgreSQL rodando na porta 5432
• Banco de dados criado com o nome perschase

Configuração

No arquivo src/main/resources/application.properties, configure suas credenciais: spring.datasource.url=jdbc:postgresql://localhost:5432/perschase spring.datasource.username=seu_usuario spring.datasource.password=sua_senha

Executando

./mvnw spring-boot:run

Endpoints da API

Transações

Método	Rota	Descrição
GET	/transacoes	Lista todas as transações cadastradas
POST	/transacoes	Cria uma nova transação (Status 201)
DELETE	/transacoes/{id}	Remove uma transação (Status 204)

Exemplo de JSON para Criação:

{
  "descricao": "Assinatura AWS",
  "valor": 150.00
}