TODO List

API para gerenciar tarefas (CRUD) que faz parte desse desafio para pessoas desenvolvedoras backend júnior, que se candidatam para a Simplify.

---

Tecnologias

• Spring Boot
• Spring MVC
• Spring Data JPA
• SpringDoc OpenAPI 3
• PostgreSQL

---

Práticas adotadas

• API REST
• Consultas com Spring Data JPA
• Injeção de Dependências
• Tratamento global de exceções
• Validações com Bean Validation
• Versionamento do banco de dados com Flyway
• Documentação automática da API com Swagger (OpenAPI)

---

⚙️ Pré-requisitos e Configuração

Este projeto utiliza o PostgreSQL. Antes de executar, você precisa:

1. Ter o PostgreSQL rodando localmente na porta 5432.
2. Criar um banco de dados vazio com o nome todolist (o Flyway se encarregará de criar as tabelas).
3. Configurar as seguintes variáveis de ambiente na sua máquina ou na sua IDE de preferência:

Variável	Descrição	Exemplo
DATABASE_USERNAME	Seu usuário do PostgreSQL	postgres
DATABASE_PASSWORD	Sua senha do PostgreSQL	123456

---

Como Executar

• Clonar repositório git

git clone https://github.com/giovannithamasia/todolist-desafio-backendjr.git

• Construir o projeto:

 ./mvnw clean package

• Executar a aplicação:

 java -jar target/todolist-0.0.1-SNAPSHOT.jar

A API poderá ser acessada em localhost:8080. O Swagger poderá ser visualizado em localhost:8080/swagger-ui.html

API Endpoints

Para fazer as requisições HTTP abaixo, você pode usar o Swagger UI do projeto ou qualquer cliente HTTP como Postman:

• Criar Tarefa

POST /todos
{
  "nome": "Todo 1",
  "descricao": "Desc Todo 1",
  "realizado": false,
  "prioridade": "ALTA"
}

Headers de resposta:
201 Created
Location: /todos/1

• Listar Tarefas

GET /todos

[
  {
    "id": 1,
    "nome": "Todo 1",
    "descricao": "Desc Todo 1",
    "realizado": false,
    "prioridade": "ALTA"
  }
]

• Buscar Tarefa pelo ID

GET /todos/1

{
  "id": 1,
  "nome": "Todo 1",
  "descricao": "Desc Todo 1",
  "realizado": false,
  "prioridade": "ALTA"
}

• Atualizar Tarefa

PUT /todos/1
{
  "nome": "Todo 1 Up",
  "descricao": "Desc Todo 1 Up",
  "realizado": true,
  "prioridade": "MEDIA"
}

Headers de resposta:
204 No Content

• Remover Tarefa

DELETE /todos/1

Headers de resposta:
204 No Content