Hofwams: Geld, Tickets und Catering auf einem Backend
Eine Event-Plattform, auf der Veranstalter Tickets verkaufen, RSVPs verwalten und Gäste einchecken und dann das Catering danach planen, wer tatsächlich kommt.
- Rolle
- Lead Engineer
- Zeitraum
- Dez. 2024 bis heute
- Status
- Live unter hofwams.com
- Stack
- NestJS, Postgres, Prisma, Redis, BullMQ, Stripe Connect, Next.js
- Problem
- Veranstalter jonglierten mit getrennten Tools für Tickets, RSVPs, Check-in und Auszahlungen und schätzten das Catering nur grob.
- Was ich gemacht habe
- Die Entwicklung einer Plattform für all das geleitet: ein NestJS-Backend mit Auszahlungen über Stripe Connect, ein Credit-Ledger ohne Race Conditions und QR-Check-in, dazu die Web- und Admin-Apps. Danach die Event-Einrichtung vereinfacht, als in der ersten Version Events im Entwurf hängen blieben.
- Ergebnis
- Über 100 Veranstalter und 50+ veröffentlichte Events, überwiegend private wie Geburtstage. Bezahlte Tickets, Check-in am Eingang, Catering-Prognosen und direkte Auszahlungen werden alle genutzt.

Das System
Veranstalter jonglierten mit einem Ticketing-Tool, einer RSVP-Tabelle, einem Zahlungs-Dashboard und einer Schätzung, wie viel Essen sie bestellen sollten. Hofwams bündelt das an einem Ort und ergänzt Catering-Intelligenz: Ernährungsangaben bei der Anmeldung und eine Portionsprognose, die Gästezahlen in einen Küchenplan übersetzt.
Das meiste Risiko liegt im Backend. Geld fließt über Stripe Connect direkt an Veranstalter, Credits werden parallel ausgegeben, und zwei Personen am Eingang können im selben Moment denselben QR-Code scannen.
Lead Engineer seit Dezember 2024, zusammen mit einem Frontend-Engineer, einem DevOps-Engineer und einem Designer. Ich verantworte die Architektur des gesamten Produkts, leite das Backend und habe große Teile des Web-Clients und der Admin-App geschrieben.
- Veranstalter
- 100+
- veröffentlichte Events
- 50+
- Tests
- 1,370+
Hofwams im Überblick. Fahren Sie über einen Knoten oder tippen Sie darauf, um zu sehen, was er tut.
Eine Event-Einrichtung, die man auch abschließt
Die erste Version der Event-Einrichtung fragte alles auf einmal ab. Veranstalter legten Events an, standen vor einer Wand aus Feldern und ließen sie im Entwurf liegen. Also haben wir den Ablauf auf das reduziert, was ein Event zum Livegehen braucht, und alles andere optional gemacht: überspringen, aufklappen und gleich ausfüllen oder später nachholen.
Mehr Events schafften es vom Entwurf zur Veröffentlichung, und Veranstalter begannen, bezahlte und andere Arten von Events durchzuführen, nicht nur kostenlose. Außerdem haben wir In-App-Feedback ergänzt, damit Anliegen direkt bei uns ankommen statt als abgebrochene Entwürfe.
Ein Credit-Ledger, das nicht überziehen kann
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
Zwei Tabs geben im selben Moment 40 Credits aus.
Veranstalter geben Credits für Plattformfunktionen aus, und Ausgaben können im selben Moment aus verschiedenen Tabs, Jobs oder Webhooks eintreffen. Kontostand lesen, prüfen und dann schreiben ist genau die Stelle, an der Doppelausgaben entstehen.
Deshalb steckt die Prüfung im Write selbst. Eine Abbuchung ist ein einziges bedingtes Update, das nur gelingt, solange das verfügbare Guthaben den Betrag deckt, und es wird in derselben Transaktion wie die zugehörigen Nutzungs- und Transaktionszeilen committet. Parallele Ausgaben werden in Postgres serialisiert statt im Anwendungscode. Gutschriften tragen abgeleitete Idempotency Keys, sodass ein erneut zugestelltes Event nicht doppelt gutschreiben kann, und Korrekturen sind ausgleichende Erstattungszeilen statt Änderungen.
Ein einziger schreibender CreditLedgerService mit eigener Test-Suite für Nebenläufigkeit.
Webhooks, die fehlschlagen dürfen
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 sendet ein payment.succeeded-Event.
Ein Webhook-Endpunkt bedient sowohl das Plattformkonto als auch die Connect-Konten, jeweils mit eigenem Signing Secret. Jedes Event wird mit seiner Stripe-Event-ID als eindeutigem Schlüssel, einem Retry-Zähler und dem letzten Verarbeitungsfehler gespeichert und dann danach geroutet, wofür die Zahlung war: eine Ticketbestellung oder ein Credit-Kauf.
Fehler beim Credit-Kauf geben absichtlich einen Fehler zurück, damit Stripe es erneut versucht, und ein Abgleichs-Cron fängt alles auf, was trotzdem durchrutscht. Gutschrift, Kaufdatensatz und Zahlungsstatus teilen sich einen Commit hinter einem PENDING-Guard.
Check-in ohne 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" };
Zwei Helfer scannen gleichzeitig dasselbe Ticket.
Früher konnten zwei Helfer, die dasselbe Ticket scannten, einen Gast doppelt einchecken. Der Fix hat die Bedingung in den Write selbst verlagert: Nur ein Scan kann die Registrierung umschalten, der andere bekommt eine klare Antwort „bereits eingecheckt“. Für die Race Condition gibt es jetzt einen Regressionstest.
Queues, die auch ohne Redis laufen
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 });
Features stellen Jobs über ein kleines Interface in die Queue.
Hintergrundarbeit läuft über eine kleine Queue-Abstraktion mit zwei Strategien: In-Memory für lokale Entwicklung und Tests, BullMQ in Produktion. Für beide gelten dieselben Decorators und dieselbe Retry-Semantik. Darüber laufen die Wiederherstellung abgebrochener Checkouts, das Aufräumen veralteter Bestellungen, Erinnerungen, Löschungen nach Aufbewahrungsfrist und der Credit-Abgleich.
Echtzeit-Updates laufen über SSE mit Redis-Fan-out, Reconnect mit Backoff und Jitter und einem Replay-Puffer für Last-Event-ID. So holt ein Handy, das am Eingang kurz kein Netz hat, verpasste Check-ins nach, statt sie zu verlieren.
Entscheidungen, die ich vertreten kann
Ein Schreiber, ein bedingtes Update
Jede Abbuchung läuft über den Ledger-Service, die Regel steckt also in einem einzigen Write, und eine fehlgeschlagene Ausgabe liefert ein klares 402 statt eines Datenbankfehlers.
Nur abfragen, was zum Livegehen nötig ist
Die Einrichtung verlangt nur, was ein Event zum Veröffentlichen braucht. Alles andere ist optional und kann warten, denn ein fertiges einfaches Event ist besser als ein vollständiges, das abgebrochen wird.
Modularer Monolith
Ein Deployable, 28 Module mit klaren Grenzen. Getrennte Services hätten Netzwerkfehler mitgebracht, bevor die Last sie verlangt hätte.
Feature Flags standardmäßig aus
Der WhatsApp-Kanal und sein Flows-Endpunkt werden deaktiviert ausgeliefert, bis Einwilligung und Vorlagen freigegeben sind.
In ihren Worten
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