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 JavaScript para desenvolver a API.
- 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 utilizando 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 |