Case Study · 2025–2026
heysuma — Studiomanagement
in einer Plattform.
Eine vollständig selbst entwickelte All-in-One-Business-Software für EMS-Studios — von der Datenbankarchitektur bis zur CI/CD-Pipeline. Kein Framework-Wrapper, kein White-Label-Produkt. Unser Beleg dafür, was Kitun für den Mittelstand bauen kann.
- Domänen
- 36 fachliche Domänen
- Frontends
- Studio-Admin + Kunden-PWA + Website
- Backend
- Python · FastAPI async
- Daten
- PostgreSQL · 62 Migrationen
- KI
- 5 Agenten · Strands Agents SDK
- Security
- Dokumentiertes Security-Audit
- Hosting
- Hetzner DE · DSGVO
- Launch
- v1.0 · Mai 2026
- 3 Monate
- Greenfield bis v1.0
- 4 Apps
- API · Admin · Kunden · Website
- ~140k LOC
- Python + TS/Vue
- 368 Commits
- 3 Monate, ein Entwickler
01 · Ausgangslage
Ein Unternehmen, dessen Prozesse in keine Standardlösung passen.
Studiobetrieb ist Service-Business auf Steroiden: Mitglieder, Verträge, Termine mit begrenzten Ressourcen, SEPA-Einzug, Kampagnen, Franchise-Strukturen — und alles gleichzeitig. Keine existierende SaaS-Lösung deckte das Spektrum sauber ab. Die Alternative wären drei, vier zusammengeklebte Tools gewesen. Mit der dazugehörigen Reibung, doppelten Datenpflege und manuellen Übertragungen.
02 · Ansatz
Erst das Geschäftsmodell. Dann die Architektur. Dann der Code.
Wir haben das gesamte Geschäftsmodell eines EMS-Studios modelliert — 36 fachliche Domänen mit sauberen Grenzen, asynchrone REST-API, strikt verifizierte Multi-Tenancy, rollenbasierte Rechte. Erst danach begann die Implementierung. KI übernahm Routinearbeit wie Boilerplate, Tests und Integrationen entlang dieser Architektur. Jede Zeile reviewt, jede Änderung als kontrollierte DB-Migration versioniert — heute 62 Stück.
03 · Ergebnis
Vier Apps. Eine Plattform. v1.0 produktiv seit Mai 2026.
heysuma läuft auf Hetzner-Infrastruktur in Deutschland: Studio-Admin (Vue 3), Kunden-PWA (Vue 3), Marketing-Website (Astro) und FastAPI-Backend — durchgängig TLS-verschlüsselt. Studios verwalten Mitglieder, planen Termine, ziehen SEPA-Lastschriften ein, analysieren Umsatz, führen Sales-Pipelines. Endkunden buchen per PWA und chatten mit einem Buchungsassistenten, der direkten Tool-Zugriff auf das System hat. Ein Security-Audit ist vollständig dokumentiert.
Domänen
Auszug aus 36 fachlichen Domänen.
Jede dieser Domänen ist in Produktion, als eigenständiges Modul aufgebaut mit Models, Schemas, Service-Layer und Routern. Jede ist so modelliert, dass sie sich mit überschaubarem Aufwand auf andere Branchen übertragen lässt.
CRM & Kundenlebenszyklus
Kontakt- und Kundenprofile mit Status-Lifecycle, Gruppen, Multi-Standort-Sicht, DSGVO-konforme Verwaltung sensibler Gesundheitsdaten mit Verschlüsselung at-rest und separatem Audit-Log.
Kalender & Terminplanung
Drei Ansichtsmodi (Liste, Kalender, Check-in), Drag-and-Drop-Buchung, vollständiges Statusmodell, Ressourcenverwaltung mit automatischer Kapazitätsfreigabe, konfigurierbare Buchungs- und Stornierungsfenster.
Vertragsmanagement
Digitale Vertragsanlage, Laufzeiten, Abrechnungszyklen, Pausierung, Kündigungsmanagement mit automatischer Enddatum-Berechnung, Auto-Verlängerung mit optionaler Preisanpassung. PDF und Signatur-Upload.
Rechnungslegung
Vollständiger Rechnungslebenszyklus mit Statusmodell, automatischer PDF-Generierung, direktem E-Mail-Versand, konfigurierbarem Nummernkreis, MwSt.-Konfiguration, Bulk-Finalisierung.
SEPA ISO 20022
Normkonforme SEPA-XML-Datei-Generierung, Preview vor Ausführung, Sammeleinzug, vollständige Protokollierung, digitale SEPA-Mandate, Gläubiger-ID pro Standort konfigurierbar.
Finanzreporting
Umsatzberichte mit flexiblem Datumsfilter, aufgeschlüsselt nach Zahlungsart und Rechnungstyp. Excel-Export mit Formatierungen für Steuerberater-Kompatibilität.
Sales-Pipeline
Konfigurierbares Kanban-Board mit beliebig vielen Spalten und parallelen Pipelines, Lead- und Opportunity-Tracking, Aufgaben-Vorlagen pro Phase, Kampagnen-Templates.
Lead-Capture-Widgets
Formular-Builder, einbettbarer Widget-Code für externe Websites, öffentliche Verfügbarkeitsanzeige in Echtzeit, automatische Lead-Anlage, Bot- und Missbrauchsschutz.
Self-Service-Portal (PWA)
Separate Progressive Web App für Endkunden: Terminbuchung, Übersicht, Stornierung mit Fristprüfung, Studio-Branding, passwortlose Anmeldung.
E-Mail-Automatisierung
Template-basierte E-Mails, automatisierte Terminbestätigungen, Erinnerungen mit konfigurierbaren Vorlaufzeiten, asynchroner Versand über eine Hintergrund-Queue.
Multi-Tenancy
Organisations- und Studio-Ebene, strikt mandantengetrennte Datenhaltung, abgestuftes rollenbasiertes Zugriffskonzept vom Inhaber bis zum Endkunden.
KI-Agenten
Drei produktive Agenten (Support, Buchung, Assistenz) mit Tool-Use, SSE-Streaming, Session-Persistenz in PostgreSQL, Usage-Logging pro Session.
Engagement-Scoring
Nächtlich berechneter Score auf Basis von Terminnutzung vs. Kontingent (8-Wochen-Rollfenster). Lifecycle-Stages aktiv / gefährdet / inaktiv als Basis für Churn-Prognose.
Daten-Import
CSV-Import mit Parse-Preview-Confirm-Workflow für Kunden, Verträge, Tarife, Check-ins. Validierung vor der Übernahme, Hintergrund-Verarbeitung für große Datensätze.
Produkte & Leistungen
Tarife, Zusatztarife, Produkte, Dienstleistungen, Pakete mit separaten Preismodellen, Auto-Verlängerung, Rabatten und rechtlichen Texten.
Notifications (SSE)
Server-Sent Events für Echtzeit-Benachrichtigungen im Frontend, Ungelesene-Badge, Mark-as-read, Revision-basiertes Polling-Konzept.
KI-Integration
Fünf produktive KI-Agenten. Tool-Use. Nicht ChatGPT-Wrapper.
Gebaut mit dem Strands Agents SDK. Jeder Agent hat Session-Persistenz in PostgreSQL, Streaming-Responses über Server-Sent Events, Usage-Logging von Input- und Output-Tokens pro Session, und echten Tool-Zugriff auf die Business-Logik.
Assistant
Onboarding- und Allzweck-Assistent für das Studio-Team mit Zugriff auf Systemstruktur und Workflows. Kennt die Daten, kennt die Wege.
Booking
Natürlichsprachliche Terminvereinbarung in der Kunden-App. Direkter Tool-Zugriff auf Verfügbarkeit und Buchungserstellung.
Retention
Signal-Pipeline für Engagement-Erosion. Erkennt nachlassende Termin-Nutzung, schlägt proaktive Bindung vor — bevor klassische Reports den Trend zeigen.
Support
Kontextsensitiver Chat für operative Fragen im Studio-Alltag. Antworten direkt aus dem System, ohne externe Suche, ohne Doku-Bouncing.
Journey-Ingestor
Schreibt heterogene Customer-Journey-Events (Web, E-Mail, Buchungen) in ein einheitliches Lifecycle-Modell. Grundlage für Engagement-Scoring und Vorhersagen.
Sicherheit
Sicherheit ist Design, nicht Checkbox.
2026 haben wir ein vollständig dokumentiertes Security-Audit durchlaufen. Die Grundlage dafür ist eine Architektur, die Sicherheitsanforderungen nicht nachträglich anflanscht, sondern strukturell garantiert.
Passwortlose Auth
Anmeldung per Magic-Link und Passkeys. Kein Passwort-Handling, kein Reset-Flow, keine Passwort-Datenbank.
Schutz vor Web-Angriffen
Gängige Web-Angriffsklassen wie CSRF und Injection sind auf Architekturebene adressiert — nicht Route für Route nachgerüstet.
Mandantentrennung
Jeder Datenzugriff ist serverseitig an den verifizierten Mandanten gebunden. Studios sehen ausschließlich ihre eigenen Daten.
Datenverschlüsselung
Gesundheitsdaten sind at-rest verschlüsselt. Zugriffe auf sensible Daten werden in einem separaten Audit-Log protokolliert.
Sauberer Datenzugriff
Datenbankzugriffe laufen durchgängig über eine typisierte ORM-Schicht — keine zusammengebauten SQL-Strings.
Missbrauchsschutz
Rate-Limiting auf API-Ebene und Bot-Schutz auf allen öffentlichen Formularen.
Was das für euch bedeutet
Dieselbe Grundlage. Für euer Unternehmen.
In ~4 Wochen.
heysuma wurd ein drei Monaten von einem Entwickler gebaut. Mit dem heute eingespielten AI-nativen Workflow — zwei Senior-Architekten orchestrieren ein Fleet aus KI-gestützter Umsetzung — könnten wir dieselbe Tiefe in ~4 Wochen replizieren. Wir verkaufen heysuma nicht weiter — aber wir bauen mit derselben Architektur, denselben Komponenten und derselben Disziplin Software für Produktionsunternehmen, Handwerk, Dienstleister, Gesundheit, Bildung. Verträge, Abrechnung, Kundenportal, Sales-Pipeline, Multi-Standort, DSGVO: all das ist für uns kein Neuland, sondern Handwerk aus einer laufenden Plattform.