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.
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.