Zum Hauptinhalt springen

Peavox: Aufbau eines Fitness-SaaS-MVP als Solo-Gründer

TL;DR

Peavox ist eine Fitness-Business-Management-SaaS-Plattform, die von Grund auf als Solo-Gründer-Projekt entwickelt wurde. Durch den Einsatz eines modernen Tech-Stacks (Kotlin/Spring Boot, React Native/Expo, Next.js) und bewusste Architekturentscheidungen rund um Multi-Tenancy, Typsicherheit und Cross-Platform-Entwicklung wurde die gesamte Plattform, einschließlich Backend-API, Mobile App, Admin-Portal und Marketing-Website, von einem einzigen Entwickler gebaut und gelauncht.

Einführung

Der Aufbau eines SaaS-Produkts erfordert typischerweise ein Team: Backend-Entwickler, Frontend-Spezialisten, Mobile-Entwickler und DevOps-Engineers. Aber mit den richtigen Technologieentscheidungen und Architekturentscheidungen kann ein technischer Solo-Gründer eine produktionsreife Plattform bauen, die mit Produkten konkurriert, die von viel größeren Teams entwickelt wurden.

Peavox ist eine Fitness-Business-Management-Plattform, die Fitnessstudio-Betreibern und Fitness-Studios hilft, Mitgliedschaften zu verwalten, Kurse zu planen, Buchungen abzuwickeln und Zahlungen zu verarbeiten. Die Herausforderung bestand darin, all dies mit einer ordentlichen Multi-Tenant-Architektur, nativen Mobile Apps für iOS und Android, einem vollständigen Admin-Dashboard und einer Marketing-Website als Ein-Personen-Operation zu bauen.

Technische Architektur

Monorepo-Struktur

Die gesamte Plattform lebt in einem einzigen Monorepo, was atomare Änderungen über den gesamten Stack, gemeinsame Tools und vereinfachtes Deployment ermöglicht:

peavox/
├── backend/          # Spring Boot API (Kotlin)
├── mobile-app/       # Expo React Native (TypeScript)
├── admin-portal/     # Next.js Dashboard (TypeScript)
└── website/          # Astro Marketing-Seite

Technologie-Auswahl

Komponente Technologie Warum
Backend Kotlin + Spring Boot Typsicherheit, Null-Safety, ausgereiftes Ökosystem
Mobile React Native + Expo Echte Cross-Platform, schnelle Entwicklung
Admin-Portal Next.js Server-Side Rendering, React-Ökosystem
Marketing-Seite Astro Statische Generierung, minimales JavaScript
State Management TanStack Query Server-State-Sync, Caching, optimistische Updates
Validierung Zod Laufzeitvalidierung mit TypeScript-Inferenz

Zentrale technische Herausforderungen

Herausforderung 1: Multi-Tenant-Datenisolierung

Problem: Jedes Fitness-Business benötigt vollständige Datentrennung bei gemeinsamer Infrastruktur.

Lösung: Implementierung von SiteContext als Request-Scoped-Komponente. Alle Datenbankabfragen werden automatisch auf den aktuellen Tenant beschränkt. Das ist nicht nur eine Konvention, sondern wird auf Architekturebene erzwungen. Jede Repository-Abfrage (außer Admin-Operationen) muss Tenant-bezogen sein, und dies wird in Integrationstests validiert.

Das Ergebnis: Fitness-Unternehmen können darauf vertrauen, dass ihre Mitgliederdaten, Buchungshistorie und Finanzinformationen vollständig von anderen Tenants isoliert sind.

Herausforderung 2: Cross-Platform Mobile-Entwicklung

Problem: Native Mobile Apps für iOS und Android werden erwartet, aber das Erstellen und Pflegen von zwei separaten Codebasen als Solo-Entwickler ist nicht machbar.

Lösung: React Native mit Expo bietet echte native Performance mit einer einzigen TypeScript-Codebasis. Kombiniert mit TanStack Query für Server-State-Management und Zod für Validierung teilt die Mobile App Patterns und sogar Code mit dem Admin-Portal.

Das Repository-Pattern organisiert die gesamte Datenabfrage-Logik, was es einfach macht, Features hinzuzufügen, ohne Spaghetti-Code zu erzeugen. Wenn ein Fitnessstudio-Mitglied einen Kurs bucht, handhaben dieselben Patterns Ladezustände, Fehlerbehandlung und Cache-Invalidierung, ob auf iOS oder Android.

Herausforderung 3: Typsicherheit über den gesamten Stack

Problem: API-Vertrags-Mismatches zwischen Backend und Frontend verursachen Bugs, die erst zur Laufzeit auffallen.

Lösung: Typsicherheit wird auf jeder Ebene erzwungen:

  • Backend: Kotlins Null-Safety und DTO-Pattern für alle API-Request/Response-Bodies
  • Frontend: TypeScript durchgehend, mit Zod-Schemas, die sowohl Laufzeitvalidierung als auch TypeScript-Typ-Inferenz bieten
  • Testing: MockMvc-Controller-Tests fangen Integrationsprobleme früh ab

Wenn sich ein API-Vertrag ändert, schlägt die TypeScript-Kompilierung im Frontend fehl, bevor Code in Produktion gelangt.

Gelieferte Kernfunktionen

Mitgliederverwaltung

  • Mitgliederprofile und Kontaktinformationen
  • Mitgliedschaftsplan-Zuweisung und -Tracking
  • Statusverwaltung und Historie

Kurs- und Terminplanung

  • Kurserstellung und -konfiguration
  • Terminplanung mit Kapazitätsmanagement
  • Wiederkehrende Terminmuster

Buchungssystem

  • Echtzeit-Verfügbarkeitsprüfung
  • Mitglieder-Kursbuchungen mit Bestätigungen
  • Wartelistenverwaltung

Zahlungsabwicklung

  • Stripe Connect-Integration für eingebettete Zahlungen
  • Automatisierte Abrechnung und Rechnungsstellung
  • Keine sensiblen Zahlungsdaten gespeichert (Stripe übernimmt PCI-Compliance)

Ergebnisse

Solo-Gründer-Effizienz

Die Kombination aus:

  • Monorepo: Single Source of Truth, atomare Änderungen
  • Typsicherheit: Reduzierte Debugging-Zeit, Fehler zur Kompilierzeit erkannt
  • Moderne Frameworks: Produktionsreife Grundlagen out of the box
  • Repository-Pattern: Organisierter Code, der leicht zu warten ist

…ermöglichte es einem einzelnen Entwickler zu bauen, was typischerweise ein Team von 4-6 Ingenieuren erfordern würde.

Produktionsreife Architektur

Anders als viele MVPs, die vom ersten Tag an technische Schulden anhäufen, wurde Peavox gebaut mit:

  • Multi-Tenancy als Kern-Designprinzip, nicht als Nachgedanke
  • Saubere Separation of Concerns für zukünftige Skalierung
  • API-First-Design bereit für Drittanbieter-Integrationen
  • Europäische Compliance (DSGVO, SEPA-Support geplant)

Technische Differenzierungsmerkmale

Aspekt Legacy Fitness-Software Peavox
Architektur Monolithische Legacy-Systeme Modern, Microservices-ready
Mobile Web-Wrapper oder veraltete Apps Echte native Cross-Platform
API Geschlossen oder limitiert Open API-Design von Anfang an
Multi-Tenancy Nachträglich angebaut Von Grund auf designed
Payment-Integration Custom Processors Stripe Connect (portabel)

Lessons Learned

  1. Investiere früh in Typsicherheit. Die Zeit, die für Kotlin + TypeScript + Zod aufgewendet wird, zahlt sich schnell aus durch reduziertes Debugging und erhöhtes Vertrauen bei Änderungen.

  2. Multi-Tenancy muss architektonisch sein. Tenant-Isolierung zu einem bestehenden System hinzuzufügen ist schmerzhaft. Es von Anfang an einzubauen ist vergleichsweise einfach.

  3. Moderne Tools vervielfachen Solo-Entwickler. Expo, Next.js und Spring Boot bieten so viel out of the box, dass sich ein einzelner Entwickler auf Business-Logik statt Infrastruktur konzentrieren kann.

  4. Das Monorepo ermöglicht Agilität. Wenn ein Feature Änderungen über Backend, Mobile und Admin-Portal erfordert, entfernt das Erstellen in einem einzigen Commit mit einer einzigen CI/CD-Pipeline den Koordinationsaufwand.

Fazit

Ein SaaS-Produkt als Solo-Gründer zu bauen ist herausfordernd, aber mit modernen Tools zunehmend machbar. Der Schlüssel liegt in klugen Architekturentscheidungen früh: typsichere Sprachen wählen, von Anfang an für Multi-Tenancy designen und Frameworks nutzen, die sich um Infrastruktur-Belange kümmern.

Peavox demonstriert, dass mit der richtigen technischen Grundlage ein einzelner Entwickler eine Plattform bauen kann, die nicht nur ein MVP-Hack ist, sondern ein produktionsreifes System, das mit dem Business skalieren kann.

Besuchen Sie peavox.com um mehr über die Plattform zu erfahren.

Wobei können wir Sie unterstützen?

Senden Sie mir einfach eine Nachricht order rufen Sie mich an. Ich freue mich, von Ihnen zu hören.

[email protected]

+49 160 975 280 94

Portrait of Marco Rico, Fractional CTO

Marco Rico

Fractional CTO