Hofwams: dinero, entradas y catering en un solo backend
Una plataforma de eventos donde los organizadores venden entradas, gestionan RSVP y registran a los invitados, y luego planifican el catering según quién va a venir de verdad.
- Rol
- Ingeniero líder
- Periodo
- dic 2024 a hoy
- Stack
- NestJS, Postgres, Prisma, Redis, BullMQ, Stripe Connect, Next.js
- Problema
- Los organizadores de eventos usaban herramientas separadas para entradas, RSVP, check-in y cobros, y calculaban el catering a ojo.
- Qué hice
- Lideré la construcción de una sola plataforma para todo: un backend en NestJS con pagos vía Stripe Connect, un libro de créditos a prueba de condiciones de carrera y check-in con QR, además de las apps web y de administración. Después simplifiqué la creación de eventos cuando la primera versión dejaba eventos atascados en borrador.
- Resultado
- Más de 100 organizadores y más de 50 eventos publicados, en su mayoría privados, como cumpleaños. La venta de entradas de pago, el check-in en la puerta, la previsión de catering y los pagos directos están todos en uso.

El sistema
Los organizadores de eventos hacían malabares con una herramienta de venta de entradas, una hoja de cálculo de RSVP, un panel de pagos y una estimación de cuánta comida pedir. Hofwams reúne todo eso en un solo lugar y añade inteligencia de catering: recoge las preferencias alimentarias en el registro y predice las raciones para convertir el número de invitados en un plan de cocina.
La mayor parte del riesgo está en el backend. El dinero pasa por Stripe Connect directamente a los organizadores, los créditos se gastan de forma concurrente y dos personas en la puerta pueden escanear el mismo código QR en el mismo instante.
Ingeniero líder desde diciembre de 2024, junto a un ingeniero frontend, un ingeniero DevOps y un diseñador. Soy responsable de la arquitectura de todo el producto, dirijo el backend y escribí buena parte del cliente web y de la app de administración.
- organizadores
- 100+
- eventos publicados
- 50+
- tests
- 1,370+
Hofwams de un vistazo. Pasa el cursor o toca un nodo para ver qué hace.
Una creación de eventos que la gente termina
La primera versión de la creación de eventos pedía todo desde el principio. Los organizadores empezaban un evento, se encontraban con un muro de campos y lo dejaban en borrador. Así que recortamos el flujo a lo que un evento necesita para publicarse y dejamos todo lo demás como opcional: saltarlo, desplegarlo para rellenarlo ya o volver a ello más tarde.
Más eventos pasaron de borrador a publicados, y los organizadores empezaron a crear eventos de pago y de otros tipos, no solo gratuitos. También añadimos feedback dentro de la app, para que las dudas nos lleguen directamente en lugar de aparecer como borradores abandonados.
Un libro de créditos que no puede gastar de más
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
Dos pestañas gastan 40 créditos en el mismo instante.
Los organizadores gastan créditos en funciones de la plataforma, y los gastos pueden llegar en el mismo instante desde distintas pestañas, jobs o webhooks. Leer el saldo, comprobarlo y después escribir es justo de donde salen los gastos dobles.
Por eso la comprobación vive dentro de la escritura. Un débito es una única actualización condicional que solo se aplica si el saldo disponible cubre el importe, y se confirma en la misma transacción que sus filas de uso y de transacción. Los gastos concurrentes se serializan en Postgres en lugar de en el código de la aplicación. Las asignaciones llevan claves de idempotencia derivadas, así que un evento reenviado no puede asignar dos veces, y las correcciones son filas de reembolso compensatorias en lugar de ediciones.
CreditLedgerService como único escritor, con una suite de tests de concurrencia dedicada.
Webhooks que pueden fallar
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}
Stripe envía un evento payment.succeeded.
Un único endpoint de webhooks atiende tanto a la cuenta de la plataforma como a las cuentas de Connect, cada una con su propio secreto de firma. Cada evento se guarda con su id de evento de Stripe como clave única, un contador de reintentos y el último error de procesamiento, y después se enruta según para qué era el pago: un pedido de entradas o una compra de créditos.
Los fallos en compras de créditos devuelven un error a propósito para que Stripe reintente, y un cron de conciliación atrapa lo que aún se escape. La asignación, el registro de compra y el estado del pago comparten un único commit detrás de una guarda PENDING.
Check-in sin condiciones de carrera
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" };
Dos voluntarios escanean la misma entrada a la vez.
Antes, dos voluntarios que escaneaban la misma entrada podían registrar dos veces al mismo invitado. La solución movió la condición dentro de la propia escritura, de modo que solo un escaneo puede cambiar el registro y el otro recibe una respuesta clara de que ya está registrado. La condición de carrera ahora tiene un test de regresión.
Colas que funcionan sin 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 });
Las funcionalidades encolan jobs a través de una pequeña interfaz.
El trabajo en segundo plano pasa por una pequeña abstracción de colas con dos estrategias: en memoria para desarrollo local y tests, y BullMQ en producción. Los mismos decoradores y la misma semántica de reintentos valen para ambas. Se encarga de recuperar checkouts abandonados, limpiar pedidos caducados, enviar recordatorios, purgar datos por retención y conciliar créditos.
Las actualizaciones en tiempo real van por SSE con difusión desde Redis, reconexión con backoff aleatorio y un buffer de reenvío por Last-Event-ID, así que un móvil que pierde señal en la puerta se pone al día en lugar de perderse check-ins.
Decisiones que defiendo
Un escritor, una actualización condicional
Cada débito pasa por el servicio del libro de créditos, así que la regla vive en una sola escritura, y un gasto fallido devuelve un 402 claro en lugar de un error de base de datos.
Pedir solo lo necesario para publicar
La creación exige lo que un evento necesita para publicarse. Todo lo demás es opcional y puede esperar, porque un evento sencillo terminado vale más que uno completo abandonado.
Monolito modular
Un solo desplegable, 28 módulos con límites claros. Separar en servicios habría añadido fallos de red antes de que la escala lo pidiera.
Feature flags desactivados por defecto
El canal de WhatsApp y su endpoint de Flows salen ocultos hasta que se aprueban el consentimiento y las plantillas.
En sus palabras
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