API Livro de Receitas

👩‍💻 Desenvolvido para gerenciamento de receitas, usuários e ingredientes

---

Objetivos 📝

A API Livro de Receitas foi desenvolvida com o objetivo de fornecer uma estrutura back-end robusta para gerenciamento de receitas culinárias.

O sistema permite que usuários cadastrem, visualizem, atualizem e removam receitas, funcionando como um “livrinho digital de receitas”.
Além disso, a API também gerencia usuários e oferece filtros avançados de busca por receitas.

O projeto será utilizado futuramente como base para uma aplicação mobile em Kotlin, garantindo escalabilidade e reutilização.

---

Funcionalidades 🔨

Cadastro de receitas	➕
Busca de receita por ID	🔎
Busca de receitas por nome	🔤
Filtro por tempo de preparo	⏱️
Filtro por quantidade de porções	🍽️
Filtro por ingrediente	🥕
Listagem de receitas	📋
Atualização de receitas	✏️
Remoção de receitas	🗑️
Listagem de ingredientes únicos	📦
Cadastro de usuários	👤
Busca de usuário por email	📧
Login de usuário	🔐

---

Tecnologias Utilizadas 👾

---

Como foi Desenvolvido 🤔

O desenvolvimento da API foi estruturado em camadas, seguindo boas práticas de arquitetura back-end:

Controller 📡
Responsável por expor os endpoints da API.

Service ⚙️
Contém as regras de negócio e validações.

Repository 💾
Responsável pela comunicação com o banco via JPA.

Model 📦
Define as entidades do sistema: Usuário, Receita.

---

Estrutura da API 🔗

📌 Receita

• POST /receita → Cadastrar receita
• GET /receita → Listar todas as receitas
• GET /receita/{id} → Buscar receita por ID
• GET /receita/nome/{nome} → Buscar receitas por nome
• GET /receita/ingrediente/{ingrediente} → Buscar receitas por ingrediente
• GET /receita/porcao/filtro?min={min}&max={max} → Filtrar por porções
• GET /receita/filtro/tempo?tempoMin={min}&tempoMax={max} → Filtrar por tempo de preparo
• PUT /receita/{id} → Atualizar receita
• DELETE /receita/{id} → Remover receita

---

👤 Usuário

• POST /usuario → Cadastrar usuário
• POST /usuario/login → Login de usuário
• GET /usuario/{email} → Buscar usuário por email

---

🥕 Ingredientes

• GET /ingrediente → Listar ingredientes únicos cadastrados

---

Futuro do Projeto 🚀

• Integração com aplicativo mobile em Kotlin 📱
• Upload de imagens para receitas
• Sistema de favoritos e curtidas
• Implementação de autenticação com JWT
• Melhorias em segurança e controle de acesso

---

Como Acessar ❓

Para rodar o projeto na sua máquina, siga os passos abaixo:

1️⃣ Clone o repositório:

git clone https://github.com/KaelLuih/API-Receitas.git

2️⃣ Acesse a pasta do projeto:

cd api-receitas

3️⃣ Execute o projeto com Maven:

./mvnw spring-boot:run

👉 Ou, se já tiver Maven instalado:

mvn spring-boot:run

4️⃣ A API estará disponível em:

https://api-receitas-pb3e.onrender.com/

---

Autores 👤

Elis Jasper ⚙️ Backend

Kael Luih de Araujo ⚙️ Backend

Maria E. Zabel ⚙️ Backend