rastuci
E-commerce completo com pagamentos, envios e painel de administração
O Problema
Uma marca de roupas infantis precisa de uma loja online profissional com métodos de pagamento locais, integração de envios e um painel admin para gerenciar tudo de forma independente.
A Solução
Uma plataforma e-commerce completa com integração MercadoPago, calculadora de envios, gestão de estoque e painel admin completo — tudo feito sob medida para o mercado argentino.
Arquitetura
Loja pública Next.js com catálogo de produtos e fluxo de checkout
Dashboard admin protegido para gerenciamento de produtos, pedidos e estoque
API routes Next.js para pedidos, produtos, pagamentos e envios
PostgreSQL no Neon com Prisma Decimal para valores monetários
Integração MercadoPago com processamento de webhooks para notificações de pagamento
Integração de API de envios para cálculo de tarifas e rastreamento
Características Principais
Integração de pagamentos MercadoPago
Fluxo de checkout MercadoPago completo com confirmação de pagamento via webhooks
Calculadora de envios com múltiplas transportadoras
Tarifas de envio em tempo real de múltiplas transportadoras com base no destino e peso
Catálogo de produtos com variantes
Produtos com variantes de tamanho e cor, rastreamento de estoque por variante
Gestão de estoque com rastreamento
Dedução automática de estoque na compra, alertas de estoque baixo e gestão de reposição
Gestão de pedidos com fluxo de estados
Pedidos fluem por estados: pendente → pago → preparando → enviado → entregue
Painel admin com análises
Visão geral de vendas, produtos mais vendidos, gráficos de receita e gestão de pedidos em um lugar
+4 more features in the repo
Por Baixo do Capô
Pipeline de Webhooks de Pagamentos
Os webhooks do MercadoPago são recebidos, verificados para idempotência para evitar processamento duplicado, o status do pedido é atualizado e um email de confirmação é enviado — tudo em um fluxo atômico.
- MercadoPago webhook
- Idempotency check
- Order update
- Email notification
Tratamento Decimal de Preços
Todos os valores monetários usam Prisma Decimal em vez de floats do JavaScript — eliminando erros de arredondamento de ponto flutuante em cálculos financeiros.
- Price stored as Decimal
- Arithmetic with Decimal
- Display formatted string