Pular para conteúdo

Galgal

Plataforma de IA para corretores de imóveis em Jundiaí, SP.

Galgal é um sistema que combina um agente conversacional com IA (WhatsApp), um portal público de imóveis e um dashboard para corretores. O agente simula a corretora Júlia (baseada na corretora real Glauci Andrade), conduzindo compradores por todo o funil de vendas — da qualificação até o agendamento de visita.

URLs live

Serviço URL
Portal do corretor viacorretor.com.br
API REST api.viacorretor.com.br/docs
Admin (NocoDB) admin.viacorretor.com.br
Web UI (FastHTML) app.viacorretor.com.br

O que o sistema faz

Agente de vendas (Júlia)

  • Conversa com compradores via WhatsApp em português, tom informal e direto
  • Detecta a fase de venda a cada turno (primeiro contato → qualificação → opções → objeção → visita → follow-up)
  • Injeta exemplos reais de conversas anteriores (216 exemplos de reply_suggestions.jsonl) para guiar o tom
  • Usa 3 ferramentas com dados reais: buscar_imoveis, qualificar_comprador, propor_visita

Portal do corretor (Next.js)

  • Landing page por corretor com brand color, bio e imóveis em destaque
  • Listagem paginada com filtros (tipo, propósito, busca livre)
  • Detalhe de imóvel com galeria de fotos
  • Formulário de contato vinculado ao corretor/imóvel
  • Dashboard: gestão de imóveis, leads, perfil do corretor
  • Auth via magic link (email) + JWT em cookie

Backend (FastAPI)

  • 50+ endpoints REST documentados via OpenAPI
  • Autenticação: magic link → JWT em cookie galgal_token
  • Multi-tenant: cada corretor tem seu Tenant

Banco de dados

  • Dev/testes: SQLite (automático, sem config)
  • Produção: PostgreSQL no Neon (autumn-moon-06764332)
  • Admin visual: NocoDB em admin.viacorretor.com.br — 106 imóveis, 1496 fotos

Status atual (v0.5.0)

  • 106 imóveis + 1496 fotos no Neon
  • Portal live em viacorretor.com.br
  • 52 testes no componente scraper, 82% cobertura
  • Scraper ZAP/VivaReal operacional
  • Agente completo (Sprint 1–3); Sprint 4 (WhatsApp real via Evolution API) em andamento

Arquitetura em uma linha

WhatsApp → Evolution API → galgal/agent → pydantic-ai → OpenRouter LLM
                                       ↓
                              tools → galgal/property.repo → Neon PostgreSQL

Next.js (broker-web) → FastAPI (galgal/api) → Neon PostgreSQL

Veja Arquitetura: Visão geral para o diagrama completo.