Integração Frontend
Este guia abrangente descreve como implementar componentes de interface do usuário para recursos da Fashion.AI em sua aplicação frontend.
Referência Visual
Sugestões visuais para o componente "compre o look" estão disponíveis em nosso design de exemplo no Figma.
Componentes de Interface
Botão "Compre o Look"
- Posicionado sobre a imagem principal do produto
- Exibido apenas quando recomendações estão disponíveis
- Dispara a abertura do modal/gaveta de produtos relacionados
Modal de Produtos Relacionados
O modal deve exibir:
- Produtos retornados pela API com botão "Eu quero" para adicionar ao carrinho
- Informações do produto: nome, preço, tamanhos disponíveis
- Validação de estoque local antes da renderização
- Botão para fechar o modal
Comportamento
- Exibição do botão: Mostrar apenas se há produtos recomendados com estoque válido
- Abertura do modal: Ao clicar no botão "compre o look"
- Adicionar ao carrinho: Através do botão "Eu quero" para cada produto
- Fechamento: Botão X ou clique fora do modal
Validações Importantes
- ✅ Verificar estoque localmente antes da renderização
- ✅ Validar se há produtos retornados pela API
- ✅ Implementar estados de carregamento durante chamadas de API
- ✅ Lidar com erros de conectividade ou API indisponível
Exemplo de Implementação
// Pseudo-código para abertura do modal
function openShopTheLookModal(productId) {
// 1. Fazer chamada da API
const recommendations = await fetchShopTheLook(productId);
// 2. Validar estoque localmente
const validProducts = recommendations.filter(product =>
hasStock(product.id)
);
// 3. Abrir modal apenas se houver produtos válidos
if (validProducts.length > 0) {
renderModal(validProducts);
}
}