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.
Galeria do produto
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