Objetivo
Desenvolver uma API REST que permita o cadastro de clientes, a consulta de produtos provenientes de uma API externa e o gerenciamento de uma lista de produtos favoritos.
O projeto deverá utilizar banco de dados para persistência das informações, consumir uma API externa gratuita e ser publicado na plataforma Cloudflare.
Descrição do projeto
Você deverá desenvolver uma API que permita o cadastro de clientes e o gerenciamento de seus produtos favoritos. O sistema utilizará a Fake Store API como fonte externa de produtos.
Arquitetura da solução
publicada em
*.workers.devFuncionamento esperado
- Um cliente realiza seu cadastro na aplicação.
- O sistema armazena os dados do cliente no banco de dados.
- O cliente pode consultar os produtos disponíveis na Fake Store API.
- O cliente pode selecionar produtos e adicioná-los à sua lista de favoritos.
- O sistema armazena os produtos favoritados e o relacionamento com o cliente no banco de dados.
- O cliente pode consultar e remover seus produtos favoritos.
Requisitos funcionais
Cadastro de clientes
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /clients | Cadastrar um cliente |
| GET | /clients | Listar clientes |
| GET | /clients/:id | Consultar cliente por ID |
| PUT | /clients/:id | Atualizar cadastro |
| DELETE | /clients/:id | Excluir cliente |
Dados mínimos do cliente:
- ID
- Nome
- Senha
Integração com API externa
Consumir a Fake Store API para disponibilizar os produtos. Documentação: fakestoreapi.com/docs
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /products | Listar produtos externos |
| GET | /products/:id | Consultar produto específico |
| GET | /categories | Listar categorias |
Gerenciamento de favoritos
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /clients/:id/favorites | Adicionar produto aos favoritos |
| GET | /clients/:id/favorites | Listar favoritos do cliente |
| DELETE | /clients/:id/favorites/:productId | Remover produto dos favoritos |
Requisitos técnicos
O projeto deverá atender aos seguintes requisitos:
- Utilizar a linguagem e o framework de sua preferência para desenvolver a API, desde que compatíveis com o Cloudflare Workers.
- Utilizar Cloudflare Workers para hospedagem.
- Utilizar Cloudflare D1 como banco de dados.
- Utilizar Wrangler para configuração e publicação.
- Consumir a Fake Store API por meio de requisições HTTP (ex.: Fetch API).
- Implementar operações CRUD para clientes.
- Implementar o gerenciamento de favoritos.
- Implementar validação dos dados recebidos.
- Implementar tratamento de erros.
- Utilizar códigos de status HTTP apropriados.
- Armazenar senhas utilizando hash seguro.
- Disponibilizar o código-fonte em um repositório público no GitHub.
Estrutura sugerida do banco de dados
O banco de dados deverá possuir, no mínimo, duas tabelas:
- id PK
- name
- password_hash hash
- created_at
vários favoritos
- id PK
- client_id FK → clients.id
- product_id Fake Store
- created_at
client_id + product_id deverá ser única.Testes da API
Utilize Postman ou ferramenta equivalente para testar os itens abaixo. Marque cada um conforme for concluindo — o progresso fica salvo neste navegador.
Entregáveis
A entrega deverá conter obrigatoriamente:
📁1. Repositório GitHub
- Link público do projeto.
- Código-fonte completo.
- Arquivo
README.md. - Documentação dos endpoints.
- Instruções de configuração e execução.
☁️2. API publicada na Cloudflare
- URL pública da API em
workers.dev. - Endpoints funcionando.
- Integração com Cloudflare D1.
- Consumo funcional da Fake Store API.
Forma de entrega
A entrega deverá ser realizada nesta atividade do Microsoft Teams, contendo:
https://github.com/usuario/projeto
https://projeto.usuario.workers.dev
Critérios de avaliação
| Critério | Pontuação | |
|---|---|---|
| Cadastro e gerenciamento de clientes | 1,5 | |
| Integração com a API externa de produtos | 1,5 | |
| Implementação do gerenciamento de favoritos | 2,0 | |
| Modelagem e persistência no Cloudflare D1 | 1,5 | |
| Publicação e funcionamento na Cloudflare | 2,0 | |
| Validação, tratamento de erros e testes | 1,0 | |
| Organização do GitHub e documentação | 0,5 | |
| Total | 10,0 |
Desafio extra: visão de front-end
Além da API, desenvolva uma interface web que consuma os endpoints que você criou, permitindo que um usuário utilize o sistema sem precisar do Postman. O desafio não faz parte dos critérios de avaliação acima.
- 📝Cadastro de clienteFormulário com nome, e-mail e senha, validação dos campos e mensagens de erro claras.
- 🛍️Catálogo de produtosListagem dos produtos com imagem, título e preço, e filtro por categoria.
- 🔍Detalhe do produtoPágina ou modal com descrição completa e botão para favoritar.
- ❤️Meus favoritosLista dos favoritos do cliente, com opção de remover cada item.
- 👤Gerenciar cadastroEdição e exclusão dos dados do cliente.
- ⚠️Feedback ao usuárioEstados de carregamento, mensagens de sucesso e erro (ex.: produto já favoritado).
Sugestões técnicas
- Framework livre: React, Vue, Svelte, Angular ou HTML/CSS/JS puro.
- Layout responsivo (funcionar bem no celular).
- Hospedagem no Cloudflare Pages.
- Habilitar CORS na API para aceitar requisições do front-end.
Como entregar
- Código no mesmo repositório (ex.: pasta
frontend/) ou em um repositório separado. - Instruções de execução no
README.md. - Enviar, junto com a entrega no Teams, o link público do front-end (ex.:
https://projeto.pages.dev).