Todos os artigos

· 3 min de leitura

Um SaaS inteiro na borda: a arquitetura da Imovitrine

Como construí a Imovitrine só com Cloudflare Workers, Hono, D1 e R2 — sem servidor para administrar — e quais trade-offs essa escolha trouxe.

  • Cloudflare
  • Arquitetura
  • TypeScript

A Imovitrine é um produto da TeraSis: uma vitrine digital para corretores de imóveis. O corretor cadastra os imóveis, escolhe um modelo e ganha um link próprio para divulgar nas redes e no WhatsApp — com a opção de usar um domínio próprio no plano Pro.

Desde o início, eu tinha uma restrição clara: o produto precisava ter custo de infraestrutura próximo de zero enquanto não tivesse clientes, e não podia depender de alguém administrando servidor. Isso me levou a construir tudo na plataforma de desenvolvedores da Cloudflare.

A stack

  • Cloudflare Workers para toda a aplicação: painel do corretor, vitrines públicas, área administrativa e webhooks de pagamento
  • Hono como framework web, com JSX renderizado no servidor
  • D1 (SQLite gerenciado) como banco de dados
  • R2 para armazenar as fotos dos imóveis
  • Cron Triggers para rotinas de manutenção
  • Workers Observability para logs e erros

Não há container, VM nem fila de deploy para gerenciar. O deploy é um wrangler deploy.

Renderização no servidor, com pouco JavaScript

As vitrines são páginas que o cliente final abre a partir de um link no WhatsApp, geralmente no celular e muitas vezes no 4G. Por isso, a decisão foi renderizar o HTML no Worker, perto do usuário, e mandar o mínimo de JavaScript possível.

O Hono deixa isso bem direto:

app.get('/:slug', async (c) => {
  const corretor = await c.env.DB
    .prepare('SELECT * FROM corretores WHERE slug = ? AND ativo = 1')
    .bind(c.req.param('slug'))
    .first<Corretor>();

  if (!corretor) return c.notFound();

  const { results: imoveis } = await c.env.DB
    .prepare('SELECT * FROM imoveis WHERE corretor_id = ? AND publicado = 1 ORDER BY destaque DESC, criado_em DESC')
    .bind(corretor.id)
    .all<Imovel>();

  return c.html(<Vitrine corretor={corretor} imoveis={imoveis} />);
});

O resultado é uma página que carrega rápido em qualquer lugar, sem hydration e sem bundle pesado.

D1: SQLite com as limitações do SQLite

O D1 foi a escolha que mais exigiu adaptação. Ele é, essencialmente, SQLite — o que traz vantagens (simplicidade, migrações em SQL puro, testes locais idênticos à produção) e algumas limitações que precisam entrar no desenho:

  • Escritas são serializadas. Para o perfil da Imovitrine (muito mais leitura do que escrita), isso não é problema. Para um sistema com escrita intensa, seria.
  • Não há transações interativas como no Postgres. Operações que precisam ser atômicas usam batch(), que executa várias instruções em uma única transação.
  • Migrações precisam ser pensadas para SQLite: alterações de coluna mais complexas exigem recriar a tabela.

Até o controle de rate limit e o log de erros ficam no próprio D1, com uma rotina diária via Cron Trigger que limpa registros antigos.

Fotos no R2

Fotos são, de longe, o maior volume de dados do produto. O R2 resolveu duas coisas: armazenamento barato e sem custo de saída — o que, para um produto em que cada vitrine exibe dezenas de imagens, faz diferença real na conta.

As fotos são servidas a partir de um subdomínio público do bucket, com cache na CDN. O Worker só participa do upload, quando valida tipo, tamanho e permissões.

Domínio próprio para cada corretor

Uma das funcionalidades do plano Pro é usar um domínio próprio (www.corretorfulano.com.br) em vez do link da Imovitrine. Com Cloudflare for SaaS, o corretor aponta um CNAME e a plataforma cuida do certificado SSL e do roteamento — o mesmo Worker atende todos os domínios e identifica o corretor pelo hostname da requisição.

Decisões registradas

Um hábito que levei a sério nesse projeto foi registrar cada decisão de arquitetura em um documento curto: o contexto, as opções consideradas e o motivo da escolha. São dezenas de registros hoje. Parece excesso para um produto pequeno, mas, quando eu volto a uma parte do código meses depois, o “por que isso está assim?” já está respondido.

Os trade-offs

Nem tudo são vantagens:

  • Limites de execução. Workers têm limites de CPU por requisição. Processamento pesado (como redimensionar muitas imagens de uma vez) precisa ser pensado de outra forma.
  • Ecossistema diferente. Nem toda biblioteca Node.js funciona no runtime dos Workers. É preciso escolher dependências com cuidado.
  • Dependência de um fornecedor. A aplicação está bastante acoplada à Cloudflare. Como o código de negócio fica isolado em módulos TypeScript comuns, uma migração seria trabalhosa, mas possível.

Para um SaaS com o perfil da Imovitrine — leitura intensa, público espalhado pelo país e necessidade de custo baixo —, os trade-offs valeram muito a pena. Para um sistema logístico com processamento pesado em lote, eu provavelmente escolheria outra arquitetura. Como quase tudo em engenharia: depende.