🛒 Express Cart

Um serviço simples e eficiente de gerenciamento de carrinho de compras, construído com tecnologias modernas para oferecer performance e escalabilidade.

---

🔗 Sumário

• 📖 Sobre o Projeto
• 🛠 Tecnologias Utilizadas
• ✨ Funcionalidades
• 📐 Arquitetura do Projeto
• 🚀 Como Rodar o Projeto
• 📚 Documentação da API

---

📖 Sobre o Projeto

O Express Cart gerencia um carrinho de compras de forma eficiente, integrando dados de uma API externa para disponibilizar produtos.

O sistema foi projetado para alta performance e escalabilidade, combinando as seguintes tecnologias:

• Cache (Redis): Reduz a latência e a carga sobre a API externa.
• Banco de dados NoSQL (MongoDB): Oferece flexibilidade e escalabilidade para a persistência dos dados.
• Contêineres (Docker): Simplifica o deploy e garante a consistência do ambiente.

🎯 Principais Objetivos

• Oferecer uma experiência de usuário rápida e fluida.
• Minimizar chamadas desnecessárias à API externa através do cache inteligente.
• Facilitar o deploy em ambientes containerizados.

---

🛠 Tecnologias Utilizadas

• Java 17 → Linguagem moderna e performática.
  👉 Documentação oficial

• Lombok → Elimina código boilerplate, como getters, setters e construtores.
  👉 Documentação oficial

• Redis → Banco de dados em memória usado como cache para otimizar requisições.
  👉 Introdução ao Redis

• MongoDB → Banco de dados NoSQL para persistência flexível dos dados.
  👉 Documentação oficial

• OpenFeign → Cliente HTTP declarativo que simplifica chamadas a APIs externas.
  👉 Documentação oficial

• Docker → Containerização para um deploy simples e consistente.
  👉 Documentação oficial

• API Externa → Fonte de dados de produtos.

---

✨ Funcionalidades

• Listar Produtos: Busca produtos disponíveis na API externa.
• Gerenciar Carrinho: Controle total para criar, alterar, pagar e limpar o carrinho.
• Cache Inteligente (Redis): Reduz o tempo de resposta e o uso de recursos.
• Persistência com MongoDB: Armazena o carrinho de forma segura e flexível.
• Integração com API Externa: Mantém os produtos atualizados em tempo real.
• Suporte a Docker: Facilita a execução em qualquer ambiente.

---

📐 Arquitetura do Projeto

src/
 ├── main/
 │   ├── java/
 │   │   └── br/com/expresscart/
 │   │       ├── client/
 │   │       │   ├── response/
 │   │       │   │   ├── PlatziCategoryResponse
 │   │       │   │   └── PlatziProductResponse
 │   │       │   └── PlatziStoreClient
 │   │       │
 │   │       ├── config/
 │   │       │   ├── ControllerAdvice
 │   │       │   └── CustomErrorDecoder
 │   │       │
 │   │       ├── controller/
 │   │       │   ├── api/docs/
 │   │       │   │   ├── CartApi
 │   │       │   │   └── ProductApi
 │   │       │   ├── request/
 │   │       │   │   ├── CartRequest
 │   │       │   │   ├── PaymentRequest
 │   │       │   │   └── ProductRequest
 │   │       │   ├── CartController
 │   │       │   └── ProductController
 │   │       │
 │   │       ├── entity/
 │   │       │   ├── Cart
 │   │       │   ├── PaymentMethod
 │   │       │   ├── Product
 │   │       │   └── Status
 │   │       │
 │   │       ├── exception/
 │   │       │   ├── handler/
 │   │       │   │   ├── BusinessException
 │   │       │   │   └── DataNotFoundException
 │   │       │   └── response/
 │   │       │       ├── GenericErrorResponse
 │   │       │       └── ValidationErrorResponse
 │   │       │
 │   │       ├── repository/
 │   │       │   └── CartRepository
 │   │       │
 │   │       ├── service/
 │   │       │   ├── CartService
 │   │       │   └── ProductService
 │   │       │
 │   │       └── ExpressCartApplication
 │   │
 │   └── resources/
 │       ├── application.yml
 │       └── (outros arquivos de configuração, mapeamentos, etc.)
 │
 └── test/
     └── java/
         └── br/com/expresscart/
             └── (testes unitários e de integração)

---

🚀 Como Rodar o Projeto

🔧 Pré-requisitos

• Docker (ou instâncias locais de Redis e MongoDB)
• Java 17+
• Maven (ou utilize mvnw)

▶️ Rodando a aplicação

# 1. Clone este repositório
git clone https://github.com/CarlosLonghi/API-ExpressCart

# 2. Acesse a pasta do projeto
cd API-ExpressCart

# 3. Suba os serviços do Docker (Redis e MongoDB)
docker-compose up -d

# 4. Compile e rode a aplicação
./mvnw spring-boot:run

---

📚 Documentação da API

A documentação interativa da API foi gerada com Swagger e pode ser acessada após a inicialização da aplicação.

Ela permite que você visualize e teste todos os endpoints disponíveis.

Como acessar

1. Certifique-se de que a aplicação está rodando (após seguir os passos em "Como Rodar o Projeto").
2. Abra seu navegador e navegue até a seguinte URL:

👉 http://localhost:8080/swagger-ui/index.html

O que você pode fazer na documentação

• Visualizar Endpoints: Veja todos os endpoints da API, com seus métodos (GET, POST, PUT, DELETE), parâmetros e descrições.
• Testar Requisições: Use a funcionalidade Try it out para enviar requisições e ver as respostas em tempo real.
• Consultar Schemas: Entenda a estrutura das entidades (DTOs) utilizadas nas requisições e respostas.