Hofwams : argent, billets et restauration sur un seul backend
Une plateforme événementielle où les organisateurs vendent des billets, gèrent les RSVP et accueillent leurs invités, puis planifient la restauration selon qui vient vraiment.
- Rôle
- Lead engineer
- Période
- déc. 2024 à aujourd'hui
- Statut
- En ligne sur hofwams.com
- Stack
- NestJS, Postgres, Prisma, Redis, BullMQ, Stripe Connect, Next.js
- Problème
- Les organisateurs jonglaient entre des outils séparés pour la billetterie, les RSVP, le check-in et les versements, et estimaient la restauration au jugé.
- Ce que j'ai fait
- J'ai dirigé la construction d'une plateforme unique pour tout cela : un backend NestJS avec versements Stripe Connect, un registre de crédits protégé contre les accès concurrents et un check-in par QR code, ainsi que les applications web et d'administration. Puis j'ai simplifié la création d'événements quand la première version laissait des événements bloqués en brouillon.
- Résultat
- Plus de 100 organisateurs et plus de 50 événements publiés, surtout privés, comme des anniversaires. Billetterie payante, check-in à l'entrée, prévisions de restauration et versements directs sont tous utilisés.

Le système
Les organisateurs d'événements jonglaient entre un outil de billetterie, un tableur de RSVP, un tableau de bord de paiements et une estimation de la quantité de nourriture à commander. Hofwams réunit tout cela au même endroit et ajoute une intelligence de restauration : les régimes alimentaires sont saisis à l'inscription et une prévision des portions transforme le nombre d'invités en plan de cuisine.
L'essentiel du risque se trouve dans le backend. L'argent passe par Stripe Connect directement vers les organisateurs, les crédits sont dépensés de façon concurrente, et deux personnes à l'entrée peuvent scanner le même QR code au même instant.
Lead engineer depuis décembre 2024, avec un ingénieur frontend, un ingénieur DevOps et un designer. Je suis responsable de l'architecture de tout le produit, je dirige le backend et j'ai écrit une grande partie du client web et de l'application d'administration.
- organisateurs
- 100+
- événements publiés
- 50+
- tests
- 1,370+
Hofwams en un coup d'œil. Survolez ou touchez un nœud pour voir son rôle.
Une création d'événement que l'on termine vraiment
La première version de la création d'événement demandait tout d'emblée. Les organisateurs commençaient un événement, tombaient sur un mur de champs et le laissaient en brouillon. Nous avons donc réduit le parcours à ce dont un événement a besoin pour être publié, et rendu tout le reste facultatif : on peut le passer, le déplier pour le remplir tout de suite ou y revenir plus tard.
Davantage d'événements sont passés du brouillon à la publication, et les organisateurs ont commencé à créer des événements payants et d'autres types, pas seulement gratuits. Nous avons aussi ajouté un retour d'expérience dans l'application, pour que les remarques nous parviennent directement au lieu de se traduire en brouillons abandonnés.
Un registre de crédits qui ne peut pas dépenser trop
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
Deux onglets dépensent 40 crédits au même moment.
Les organisateurs dépensent des crédits sur les fonctionnalités de la plateforme, et des dépenses peuvent arriver au même instant depuis différents onglets, jobs ou webhooks. Lire le solde, le vérifier puis écrire, c'est exactement là que naissent les doubles dépenses.
La vérification vit donc dans l'écriture. Un débit est une seule mise à jour conditionnelle qui ne réussit que si le solde disponible couvre le montant, commitée dans la même transaction que ses lignes d'usage et de transaction. Les dépenses concurrentes sont sérialisées dans Postgres plutôt que dans le code applicatif. Les attributions portent des clés d'idempotence dérivées, si bien qu'un événement relivré ne peut pas créditer deux fois, et les corrections sont des lignes de remboursement compensatoires plutôt que des modifications.
Un CreditLedgerService unique en écriture, avec une suite de tests de concurrence dédiée.
Des webhooks qui ont le droit d'échouer
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 envoie un événement payment.succeeded.
Un seul endpoint de webhook sert à la fois le compte de la plateforme et les comptes Connect, chacun avec son propre secret de signature. Chaque événement est persisté avec son id d'événement Stripe comme clé unique, un compteur de tentatives et la dernière erreur de traitement, puis routé selon l'objet du paiement : une commande de billets ou un achat de crédits.
Les échecs d'achat de crédits renvoient volontairement une erreur pour que Stripe réessaie, et un cron de réconciliation rattrape ce qui passe encore entre les mailles. L'attribution, l'enregistrement de l'achat et le statut du paiement partagent un seul commit derrière une garde PENDING.
Un check-in sans condition de course
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" };
Deux bénévoles scannent le même billet en même temps.
Deux bénévoles scannant le même billet pouvaient auparavant enregistrer deux fois le même invité. Le correctif a déplacé la condition dans l'écriture elle-même : un seul scan peut faire basculer l'inscription, et l'autre reçoit une réponse claire « déjà enregistré ». La condition de course a désormais son test de non-régression.
Des files d'attente qui tournent sans 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 });
Les fonctionnalités mettent des jobs en file via une petite interface unique.
Le travail en arrière-plan passe par une petite abstraction de file d'attente avec deux stratégies : en mémoire pour le développement local et les tests, BullMQ en production. Les mêmes décorateurs et la même sémantique de retry s'appliquent aux deux. Elle pilote la relance des paiements abandonnés, le nettoyage des commandes périmées, les rappels, les purges de rétention et la réconciliation des crédits.
Les mises à jour en temps réel passent par SSE avec diffusion via Redis, reconnexion avec backoff aléatoire et un buffer de rejeu Last-Event-ID, si bien qu'un téléphone qui perd le réseau à l'entrée rattrape son retard au lieu de manquer des check-ins.
Des choix que j'assume
Un seul rédacteur, une seule mise à jour conditionnelle
Chaque débit passe par le service du registre : la règle vit dans une seule écriture, et une dépense refusée renvoie un 402 clair plutôt qu'une erreur de base de données.
Ne demander que ce qu'il faut pour publier
La création exige ce dont un événement a besoin pour être publié. Tout le reste est facultatif et peut attendre, car un événement simple et terminé vaut mieux qu'un événement complet et abandonné.
Monolithe modulaire
Un seul déployable, 28 modules aux frontières claires. Découper en services aurait ajouté des modes de défaillance réseau avant que la charge ne l'exige.
Feature flags désactivés par défaut
Le canal WhatsApp et son endpoint Flows sont livrés désactivés jusqu'à l'approbation du consentement et des modèles.
Ce qu'ils en disent
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