Hofwams: dinheiro, ingressos e buffet em um só backend
Uma plataforma de eventos onde organizadores vendem ingressos, gerenciam RSVPs e fazem o check-in dos convidados, e depois planejam o buffet a partir de quem realmente vai comparecer.
- Função
- Engenheiro líder
- Período
- dez. de 2024 a hoje
- Status
- No ar em hofwams.com
- Stack
- NestJS, Postgres, Prisma, Redis, BullMQ, Stripe Connect, Next.js
- Problema
- Organizadores de eventos se viravam com ferramentas separadas para ingressos, RSVPs, check-in e repasses, e chutavam a quantidade de comida.
- O que eu fiz
- Liderei a construção de uma plataforma única para tudo isso: um backend NestJS com repasses via Stripe Connect, um ledger de créditos à prova de race conditions e check-in por QR code, além dos apps web e de admin. Depois simplifiquei a criação de eventos quando a primeira versão deixava eventos presos em rascunho.
- Resultado
- Mais de 100 organizadores e mais de 50 eventos publicados, em sua maioria privados, como aniversários. Venda de ingressos pagos, check-in na porta, previsão de buffet e repasses diretos estão todos em uso.

O sistema
Organizadores de eventos se viravam com uma ferramenta de ingressos, uma planilha de RSVPs, um painel de pagamentos e um chute sobre quanta comida pedir. O Hofwams reúne tudo isso em um só lugar e acrescenta inteligência de buffet: coleta de restrições alimentares na inscrição e uma previsão de porções que transforma o número de convidados em um plano para a cozinha.
A maior parte do risco está no backend. O dinheiro passa pelo Stripe Connect direto para os organizadores, créditos são gastos de forma concorrente, e duas pessoas na porta podem escanear o mesmo QR code no mesmo instante.
Engenheiro líder desde dezembro de 2024, trabalhando com um engenheiro de frontend, um engenheiro de DevOps e um designer. Sou responsável pela arquitetura de todo o produto, lidero o backend e escrevi boa parte do cliente web e do app de admin.
- organizadores
- 100+
- eventos publicados
- 50+
- testes
- 1,370+
O Hofwams em um relance. Passe o mouse ou toque em um nó para ver o que ele faz.
Criação de eventos que as pessoas realmente terminam
A primeira versão da criação de eventos pedia tudo de uma vez. Os organizadores começavam um evento, davam de cara com uma parede de campos e o deixavam em rascunho. Então reduzimos o fluxo ao que um evento precisa para ir ao ar e tornamos o resto opcional: pular, expandir para preencher agora ou voltar depois.
Mais eventos passaram de rascunho a publicados, e os organizadores começaram a criar eventos pagos e de outros tipos, não só gratuitos. Também adicionamos feedback dentro do app, para que as dúvidas cheguem direto até nós em vez de aparecerem como rascunhos abandonados.
Um ledger de créditos que não deixa gastar além do saldo
credit-ledger.service.ts (simplified)
const { count } = await tx.credits.updateMany({ where: { userId, available: { gte: amount } }, data: { available: { decrement: amount } },});if (count === 0) throw new PaymentRequired(); // 402
Duas abas gastam 40 créditos no mesmo instante.
Os organizadores gastam créditos em funcionalidades da plataforma, e os gastos podem chegar no mesmo instante de abas, jobs ou webhooks diferentes. Ler o saldo, conferir e só então escrever é exatamente de onde vêm os gastos em dobro.
Por isso a verificação fica dentro da escrita. Um débito é um único update condicional que só funciona enquanto o saldo disponível cobre o valor, gravado na mesma transação que as linhas de uso e de transação. Gastos concorrentes são serializados no Postgres, não no código da aplicação. Concessões de crédito levam chaves de idempotência derivadas, então um evento reenviado não concede duas vezes, e correções são linhas de estorno compensatórias, não edições.
CreditLedgerService como único escritor, com uma suíte de testes de concorrência dedicada.
Webhooks que podem falhar
stripe-webhooks.service.ts (simplified)
const event = verifySignature(rawBody, signature);const saved = await upsertEvent(event.id); // unique idif (saved.processedAt) return; // retry of a handled eventtry { await route(event); } catch (err) { throw err; // 500: Stripe retries the credit purchase}
O Stripe envia um evento payment.succeeded.
Um único endpoint de webhook atende tanto a conta da plataforma quanto as contas Connect, cada uma com seu próprio segredo de assinatura. Todo evento é persistido com o id do evento Stripe como chave única, uma contagem de tentativas e o último erro de processamento, e então roteado conforme o que foi pago: um pedido de ingresso ou uma compra de créditos.
Falhas em compras de créditos retornam erro de propósito para que o Stripe tente de novo, e um cron de reconciliação pega o que ainda escapar. A concessão, o registro da compra e o status do pagamento vão no mesmo commit, protegidos por uma condição PENDING.
Check-in sem race condition
registration-check-in.service.ts (simplified)
const { count } = await db.registration.updateMany({ where: { id, checkedInAt: null }, data: { checkedInAt: new Date() },});if (count === 0) return { status: "already_checked_in" };
Dois voluntários escaneiam o mesmo ingresso ao mesmo tempo.
Dois voluntários escaneando o mesmo ingresso conseguiam fazer o check-in do mesmo convidado duas vezes. A correção levou a condição para dentro da própria escrita, então só um scan consegue mudar a inscrição, e o outro recebe uma resposta clara de que o check-in já foi feito. A race condition agora tem um teste de regressão.
Filas que rodam sem Redis
queue.module.ts (simplified)
provide: QUEUE,useClass: env.QUEUE_DRIVER === "bullmq" ? BullMqQueue // production: Redis, retries : InMemoryQueue, // dev and tests await queue.add("send-reminder", { eventId });
As funcionalidades enfileiram jobs por uma pequena interface.
O trabalho em segundo plano passa por uma pequena abstração de fila com duas estratégias: em memória para desenvolvimento local e testes, BullMQ em produção. Os mesmos decorators e a mesma semântica de retry valem para as duas. Ela cuida da recuperação de checkouts abandonados, da limpeza de pedidos antigos, de lembretes, de expurgos por política de retenção e da reconciliação de créditos.
As atualizações em tempo real vão por SSE com fan-out via Redis, reconexão com backoff com jitter e um buffer de replay por Last-Event-ID, então um celular que perde sinal na porta recupera o atraso em vez de perder check-ins.
Decisões que valem a pena defender
Um escritor, um update condicional
Todo débito passa pelo serviço do ledger, então a regra fica em uma única escrita, e um gasto recusado retorna um 402 claro em vez de um erro de banco.
Pedir só o que é preciso para ir ao ar
A criação exige o que um evento precisa para ser publicado. O resto é opcional e pode esperar, porque um evento simples e terminado vale mais que um completo e abandonado.
Monólito modular
Um único deploy, 28 módulos com fronteiras claras. Separar em serviços teria trazido falhas de rede antes que a escala pedisse isso.
Feature flags desligadas por padrão
O canal de WhatsApp e seu endpoint de Flows vão para produção desligados até que o consentimento e os templates sejam aprovados.
Nas palavras deles
When MJ joined, HOFWAMS was still an idea. He led the product’s architecture and development, frontend and backend, and built what our organizers rely on: tickets, RSVPs, QR check-in and direct payouts. When organizers were leaving events stuck in draft, he simplified setup and more of them went live. I would especially recommend him to early-stage startups that need an engineer who can do more than just write code.
Paul Olatunji