Mercantils – Operação de vendas para mercados locais

Ecossistema de atendimento e vendas que transforma conversas no WhatsApp em pedidos organizados para o comerciante.

Visão geral

Produto fullstack com Vitrine pública, painel do comerciante, carrinho compartilhado, checkout server-side, Kanban operacional e Agent conversacional integrado ao Gateway.

Desafio

Mercados locais precisavam atender pelo canal que o cliente já usa sem perder contexto, controle do pedido ou visibilidade da operação interna.

Solução

Estruturei a separação entre Hub, Agent e Gateway: o cliente conversa por WhatsApp ou Vitrine, o Agent interpreta a intenção e o Hub organiza catálogo, pedido, atendimento e entrega.

Arquitetura

  • Hub Next.js como fonte de verdade operacional
  • Agent Python/FastAPI para conversa e ferramentas
  • Gateway Go para transporte resiliente
  • PostgreSQL, Redis e filas duráveis

Decisões técnicas

  • Separação de responsabilidades entre Hub, Agent e Gateway.
  • Outbox persistida antes do envio para garantir retry e rastreabilidade.
  • Carrinho compartilhado entre WhatsApp e Vitrine sem duplicar a operação.

Destaques de Engenharia

  • Vitrine pública com carrinho compartilhado
  • Painel com Kanban de pedidos e atendimento
  • Agent com Gemini ou Claude via Bedrock
  • Outbox, retry, idempotência e DLQ
  • Integração desacoplada com WhatsApp/Evolution

Impacto

  • Conecta atendimento conversacional e operação de loja em um fluxo único.
  • Permite que a equipe assuma a conversa sem perder o pedido logístico.

Resultado

  • Antes: conversa, carrinho e operação ficavam separados -> Depois: o pedido atravessa os canais com contexto compartilhado.
  • Antes: falhas no transporte podiam perder mensagens -> Depois: filas, leases e retry tornam o fluxo recuperável.

Tecnologias

  • Next.js 16
  • React 19
  • TypeScript
  • PostgreSQL
  • Drizzle ORM
  • Redis
  • Python
  • FastAPI
  • Go