CRUD completo de contatos com Spring Boot 3, PostgreSQL, Swagger e Bean Validation.

API REST para gerenciamento de uma agenda de contatos. O projeto é uma refatoração de um CRUD original em C# ASP.NET MVC, reescrito em Java com Spring Boot seguindo boas práticas de mercado: separação em camadas, DTOs, validações e tratamento centralizado de erros.

Projeto original (C# MVC): Projeto-MVC--Crud-completo-

Documentação interativa: http://localhost:8080/swagger-ui.html

{
  "nome": "João Silva",
  "telefone": "(11) 99999-9999",
  "email": "[email protected]",
  "categoria": "TRABALHO",
  "ativo": true
}

Categorias disponíveis: PESSOAL · TRABALHO · FAMILIA · OUTRO

Erros de validação retornam 400 Bad Request com detalhes por campo.

Controller (HTTP)
    ↓
Service (regras de negócio)
    ↓
Repository (JPA / banco)
    ↓
PostgreSQL

src/main/java/com/rodrigopresida/agenda/
├── config/
│   └── SwaggerConfig.java
├── controller/
│   └── ContatoController.java
├── dto/
│   ├── ContatoRequestDTO.java
│   └── ContatoResponseDTO.java
├── exception/
│   ├── ApiErrorResponse.java
│   ├── ContatoNotFoundException.java
│   └── GlobalExceptionHandler.java
├── model/
│   ├── Categoria.java
│   └── Contato.java
├── repository/
│   └── ContatoRepository.java
├── service/
│   └── ContatoService.java
└── AgendaSpringBootApplication.java

• Java 21+
• Maven 3.x
• PostgreSQL 16+

CREATE DATABASE agenda_db;

Edite src/main/resources/application.properties:

spring.datasource.url=jdbc:postgresql://localhost:5432/agenda_db
spring.datasource.username=seu_usuario
spring.datasource.password=sua_senha

git clone https://github.com/RodrigoPresida/agenda-spring-boot.git
cd agenda-spring-boot
./mvnw spring-boot:run

A API estará disponível em http://localhost:8080
Swagger UI em http://localhost:8080/swagger-ui.html

30 testes automatizados com JUnit 5 + Mockito:

Banco H2 em memória configurado para o ambiente de teste (não requer PostgreSQL).

./mvnw test
# Tests run: 30, Failures: 0, Errors: 0, Skipped: 0 — BUILD SUCCESS

Rodrigo Cruz dos Santos — Analista de Dados