fintutto.world — Master-Dokumentation
Lead-Lifecycle, Automatisierungen & Growth-System
Stand: April 2026
Vollständig aktiv
Kein manueller Eingriff erforderlich
Inhaltsverzeichnis
Diese Dokumentation beschreibt das vollständige technische und operative System von fintutto.world — von der ersten Berührung eines Leads bis zum aktiven, zahlenden Nutzer und darüber hinaus.
01
Systemübersicht
Was fintutto.world ist — Geschäftsmodell, Branchen, Plattformstruktur
02
Einstiegspunkte & Sales-Funnel
Die 5 Wege, wie ein Lead das System findet — und wie er zum Käufer wird
03
Magic-Link & Onboarding
Passwortlose Authentifizierung und geführte Nutzeraktivierung
04
UAR-System & E-Mail-Automatisierung
Universal Account Records, 15 Workflows, 15 Templates
05
Referral, Enterprise & AMS
Organisches Wachstum, Großkundenmanagement und Dashboard-Struktur
06
Apps, Infrastruktur & Deployment
Das vollständige Ökosystem — Domains, Edge Functions, Schutzmaßnahmen
Kapitel 1
Systemübersicht: Was fintutto.world ist
fintutto.world ist eine KI-gestützte Übersetzungs- und Kommunikationsplattform, die für 21 Branchen spezialisierte Lösungen bereitstellt. Das Besondere: Jede Branche erhält ihre eigene App-Erfahrung — der Restaurantbetreiber sieht nie das Interface des Krankenhausarztes. Jede App ist auf die spezifischen Sprachbedürfnisse, das Fachvokabular und die regulatorischen Anforderungen der jeweiligen Branche zugeschnitten.
Self-Service
Nutzer kaufen direkt über Stripe — ohne Vertriebsgespräch, ohne Kaltakquise. Die Plattform übernimmt den gesamten Kaufprozess vollautomatisch.
Enterprise
Unternehmen buchen Lizenzen für ihre Mitarbeiter. Masseneinladungen per CSV, Rollenverwaltung und dediziertes Onboarding im AMS.
Referral
Begeisterte Nutzer empfehlen weiter und werden dafür belohnt. Kein Werbebudget erforderlich — das System wächst durch seine eigene Qualität.
Die 21 Branchen-Segmente
fintutto.world ist kein generisches Übersetzungstool. Jede der 21 Branchen erhält eine eigene App-Erfahrung mit branchenspezifischem Vokabular, zugeschnittenen Features und relevanten Compliance-Anforderungen. Die Segmente sind in fünf thematische Gruppen gegliedert.
Kapitel 2
Die 5 Einstiegspunkte
Ein Lead kann fintutto.world auf fünf verschiedenen Wegen finden. Jeder Weg ist vollständig getrackt und löst automatisch die passende Reaktion im UAR-System aus — vom ersten anonymen Cookie bis zur Konversion.
1
Organisch / SEO
Nutzer suchen nach "Übersetzung für Stadtführer" oder "Dolmetscher App Krankenhaus" und landen auf einer der 34 spezialisierten Landing Pages unter sales.fintutto.world — exakt zugeschnitten auf Vokabular, Schmerzpunkte und ROI der jeweiligen Branche.
2
Referral-Link
Ein bestehender Nutzer teilt seinen personalisierten Einladungslink. Der Empfänger landet auf einer personalisierten Landing Page, die bereits die Branche des Einladenden kennt und einen 3-Schritt-Wizard startet.
3
QR-Code (Gast-Erlebnis)
Hotelgäste, Museumsbesucher oder Konferenzteilnehmer scannen einen QR-Code und erleben die Übersetzung sofort — ohne Registrierung, ohne App-Download. Dieses Erlebnis ist der stärkste Kaufauslöser für den Betreiber.
4
Direktlink / Kampagne
Links aus E-Mail-Kampagnen, LinkedIn-Posts oder Partnerseiten führen direkt zu einer branchenspezifischen Landing Page. Das UTM-Tracking ist vollständig im UAR-System integriert.
5
Empfehlung durch Angestellten
Ein Mitarbeiter, der die App täglich nutzt, empfiehlt sie einem Kollegen in einem anderen Betrieb. Der Klick wird seinem Account gutgeschrieben — die monetäre Prämie geht jedoch an seinen Account-Inhaber (den Betreiber).
Kapitel 3
Sales-Funnel: Die 34 Landing Pages
Jede Landing Page unter sales.fintutto.world folgt demselben strukturellen Aufbau — aber mit vollständig branchenspezifischem Inhalt. Der Restaurantbetreiber liest über Sprachbarrieren am Tisch, der Krankenhausarzt über DSGVO-konforme Patientenkommunikation.
Seitenstruktur (alle 34 Seiten)
01
Hero
Konkreter Nutzen in einem Satz — z.B. "Deine Gäste verstehen dich — in 40 Sprachen, live"
02
Problem
3 spezifische Schmerzpunkte der Branche — keine generischen Aussagen
03
Lösung
Demo oder Screenshot der App im Branchen-Kontext
04
ROI-Kalkulator
Interaktiver Rechner mit realen Zahlen dieser Branche
05
Preise & CTA
Klarer Preisvergleich, branchenspezifische Testimonials, FAQ zu den 5 häufigsten Einwänden
Ausgewählte Routen
Insgesamt 34 spezialisierte Landing Pages — eine pro Branche plus Übersichtsseite, Preisseite und Referral-Seite.
Der ROI-Kalkulator & Conversion-Pfade
Der ROI-Kalkulator ist das wichtigste Conversion-Werkzeug auf jeder Landing Page. Er macht den wirtschaftlichen Nutzen von fintutto.world in Echtzeit greifbar — mit konkreten Euro-Beträgen, nicht abstrakten Versprechen.
Kalkulator-Logik
Eingaben:
- Anzahl Gäste / Patienten / Schüler pro Monat
- Stunden pro Woche für Sprachprobleme
- Aktueller Dolmetscher-Aufwand in EUR
Ausgaben:
- Monatliche Ersparnis in EUR
- ROI in Prozent
- Amortisationszeit in Wochen
Jede Interaktion mit dem Kalkulator löst automatisch ein UAR-Event aus — inklusive Follow-up E-Mail mit dem konkreten berechneten EUR-Betrag nach 24 Stunden.
Die 3 Conversion-Pfade
1
Pfad A — Direktkauf
Nutzer klickt "Jetzt starten" → Stripe Checkout → Magic-Link → App. Vollautomatisch, kein Vertriebsgespräch.
2
Pfad B — Kostenlos testen
Nutzer registriert sich für den Free-Tier → Onboarding-Wizard → automatische Drip-Sequenz bis zum Upgrade-Moment.
3
Pfad C — Kontakt
Nutzer klickt "Mehr erfahren" → Lead landet im AMS-CRM → manuelle Nachverfolgung durch das Team.
Kapitel 4
Magic-Link-System: Authentifizierung ohne Passwort
fintutto.world verwendet keine Passwörter. Jeder Login erfolgt über einen Magic-Link — eine E-Mail mit einem einmaligen, zeitlich begrenzten Token. Das eliminiert Passwort-Vergessen, vereinfacht den Einstieg und reduziert die Abbruchrate beim ersten Login erheblich.
Nach der Token-Verifizierung prüft die on-user-signup Edge Function, ob es sich um einen neuen oder zurückkehrenden Nutzer handelt. Neue Nutzer erhalten einen UAR-Eintrag und starten den Onboarding-Wizard. Zurückkehrende Nutzer landen direkt in ihrer App mit wiederhergestelltem Zustand.
Plan-zu-App-Mapping
Der Magic-Link enthält einen redirect_to-Parameter, der den Nutzer nach dem Login automatisch zur richtigen App-Domain weiterleitet. Das Mapping basiert auf dem gebuchten Plan und stellt sicher, dass jeder Nutzer genau die Oberfläche sieht, die für seine Branche und Rolle optimiert ist.
Enterprise-Kunden laden Mitarbeiter nicht über Magic-Links ein, sondern über dedizierte Staff-Invite-Links — generiert von der admin-create-user Edge Function mit 7-Tage-gültigem Token, App-Domain, Rolle und Organisations-ID.
Kapitel 5
Onboarding: Vom ersten Login zum aktiven Nutzer
Nach dem ersten Login startet der StaffOnboardingWizard automatisch — gesteuert durch den StaffAuthGate, der in allen Apps eingebunden ist. Der Wizard prüft hasCompletedOnboarding im Nutzerprofil und zeigt sich genau einmal. Er ist der entscheidende Moment, in dem aus einem neuen Account ein aktiver Nutzer wird.
1
Willkommen
Name bestätigen, Sprache wählen — persönlicher Einstieg
2
Profil
Rolle, Betrieb, Stadt — Kontext für Personalisierung
3
Erste Schritte
Die wichtigsten Features der jeweiligen App werden gezeigt
4
Fertig
Konfetti, erste konkrete Aufgabe — Aktivierungsmoment
Nach Abschluss des Wizards wird das onboarding_complete Event ausgelöst → UAR-Eintrag → E-Mail "Dein nächster Schritt" nach 24 Stunden.
Onboarding-Varianten nach Nutzertyp
Nicht alle Nutzer durchlaufen denselben Wizard. fintutto.world differenziert zwischen drei Onboarding-Erfahrungen — je nach Kontext und Nutzerrolle.
Hospitality / Guide-Onboarding
Erweiterter Wizard mit branchenspezifischen Fragen: Wie viele Gäste pro Woche? Welche Sprachen kommen am häufigsten vor? Möchtest du einen Demo-QR-Code erstellen? Diese Daten verbessern sofort die Nutzererfahrung und liefern wertvolle Segmentierungsdaten.
Enterprise-Onboarding
Mehrstufiger Prozess im AMS: Organisations-Setup (Firmenname, Logo, Hauptsprache) → Mitarbeiter-Import via CSV oder manuelle Einladung → Rollen-Zuweisung → Pilot-Session mit dem Team → Go-Live-Aktivierung aller Mitarbeiter.
Gast-Onboarding (Listener)
Kein Onboarding im klassischen Sinne. Gäste scannen den QR-Code, wählen ihre Sprache und hören sofort die Übersetzung — kein Account, kein Passwort, kein Download. Nach der Session erscheint optional ein dezenter Hinweis: "Auch für deinen Betrieb?"
Kapitel 6
Das UAR-System: Jeder Kontakt wird verstanden
Das Universal Account Record (UAR) System ist das Herzstück der gesamten Automatisierung. Es kennt jeden Kontakt — vom anonymen Website-Besucher, der den Kalkulator nutzt, bis zum zahlenden Enterprise-Kunden. Kein Kontakt fällt durch das Raster.
Identitäts-Auflösung
Das UAR-System verknüpft Kontakte stufenweise über mehrere Touchpoints hinweg:
Anonym
Cookie-ID, fw_uar_identities
E-Mail bekannt
E-Mail-Merge im System
Registriert
Verknüpfung mit auth.users
Zahlend
Vollprofil in gt_users
Wenn ein anonymer Besucher den Kalkulator nutzt und später seinen Namen eingibt, werden alle vorherigen Events automatisch mit seinem Profil verknüpft.
Technische Umsetzung
Der Event-Flow läuft vollautomatisch durch vier Schichten:
01
Frontend (React)
trackUAREvent('event_name', { data }) → POST zur uar-event-ingest Function
02
Edge Function
INSERT in fw_uar_events → UPSERT in fw_uar_identities → Workflow-Trigger prüfen
03
pg_cron (alle 5 Min)
uar-workflow-runner prüft: Nächster Step fällig?
04
send-email Function
E-Mail via Resend API → Posteingang des Kontakts
UAR Event-Typen & automatische Reaktionen
Jedes Event im UAR-System löst eine definierte, automatische Reaktion aus. Es gibt keine manuellen Zwischenschritte — das System reagiert innerhalb von Sekunden auf jede Nutzeraktion.
Kapitel 7
E-Mail-Automatisierung: 15 Workflows
Das E-Mail-System von fintutto.world besteht aus 15 aktiven Workflows — jeder mit einem klar definierten Trigger, einer Verzögerung und einem spezifischen Ziel. Der Ton ist durchgängig: direkt, per "Du", auf Augenhöhe — nie nervig, nie förmlich, nie aufdringlich. Das Ziel ist nicht Verkauf, sondern echter Mehrwert.
Die 15 E-Mail-Templates
Jedes Template hat eine klare Kernaussage — maximal ein Ziel pro E-Mail. Die Templates sind in der Datenbank unter fw_email_templates gespeichert und können über das AMS-Dashboard jederzeit bearbeitet und getestet werden.
onboarding_welcome
"Du bist dabei. Hier ist dein erster Schritt." — Sofort nach Registrierung
onboarding_day2_tip
"Tipp: Das macht 80% unserer Nutzer als erstes." — Tag 2
onboarding_first_scan
"Erster Scan! Deine Gäste haben es gerade erlebt." — Nach QR-Scan
onboarding_reminder
"Noch kein QR-Code? Dauert 30 Sekunden." — Tag 5 ohne Scan
calculator_followup
"Du sparst [X]€ pro Monat. Hier ist wie." — Nach Kalkulator-Nutzung
calculator_reminder
"Dein Ergebnis wartet noch." — Tag 3 ohne Registrierung
reengagement_30d
"Alles gut? Wir haben was Neues für dich." — 30 Tage inaktiv
reengagement_60d
"Letzte Mail von uns. Versprochen." — 60 Tage inaktiv
upgrade_limit_reached
"Du hast alles ausgeschöpft. Gut so. Hier geht's weiter." — Free-Limit
referral_invite
"Ich nutze das täglich — du solltest es auch kennen." — Einladungsmail
referral_reward_earned
"Dein Kontakt hat gekauft. Dein Bonus ist aktiv." — Prämie verdient
referral_ambassador
"3 von 3. Du bist jetzt Botschafter." — Botschafter-Status
referral_nudge
"Dein Einladungslink schläft noch." — Link nicht genutzt nach 7 Tagen
magic_link
"Dein Anmelde-Link — gültig für 24 Stunden." — Bei jedem Login
staff_invite
"Dein Team wartet auf dich." — Mitarbeiter-Einladung
Drip-Sequenz nach Registrierung
Nach der Registrierung durchläuft jeder neue Nutzer eine bedingte Drip-Sequenz. "Bedingt" bedeutet: Bestimmte E-Mails werden nur versendet, wenn der Nutzer eine bestimmte Aktion noch nicht durchgeführt hat. So erhält ein aktiver Nutzer keine unnötigen Erinnerungen.
Tag 0
onboarding_welcome — "Du bist dabei." — Immer
Tag 1
onboarding_day2_tip — "Der wichtigste erste Schritt." — Immer
Tag 5
onboarding_reminder — Nur wenn kein QR-Scan erfolgt ist
Tag 7
Branchenspezifischer Tipp aus der jeweiligen Drip-Campaign
Tag 14
upgrade_limit_reached — Nur wenn Free-Limit erreicht wurde
Tag 30
reengagement_30d — Nur wenn Nutzer inaktiv ist
Tag 60
reengagement_60d — Nur wenn Nutzer weiterhin inaktiv ist
Kapitel 8
Das Referral-System: Wachstum ohne Werbebudget
Das Referral-System ist fintutto.worlds wichtigstes Wachstumsinstrument — vollständig automatisiert, ohne Werbebudget, ohne Vertriebsteam. Es nutzt die natürliche Begeisterung aktiver Nutzer und verwandelt sie in messbares, strukturiertes Wachstum. Drei Rollen, drei Mechanismen — jeder optimal auf die jeweilige Situation zugeschnitten.
Account-Inhaber
Restaurantbetreiber, Museumsleiter, Schulleiter — kennen andere Betreiber in ihrer Branche, haben Vertrauen bei Kollegen und profitieren direkt von Geldprämien. Sie sind die primäre Zielgruppe für Referrals.
Angestellte
Stadtführer, Krankenschwestern, Lehrer — nutzen die App täglich und empfehlen organisch. Keine Geldprämien (rechtlich problematisch), stattdessen: Badges, Feature-Freischaltungen, Punkte. Monetäre Prämie geht an den Account-Inhaber.
Gäste
Erleben die App passiv. Nach einer Session erscheint ein dezenter Share-Screen — kein Popup, kein Druck. Nur ein Link zur passenden Landing Page: "Auch für deinen Betrieb?"
Der Referral-Wizard
Wenn jemand auf einen Einladungslink klickt, landet er nicht auf einer generischen Landing Page, sondern auf einem 3-Schritt-Wizard unter sales.fintutto.world/ref/:code. Der Wizard fühlt sich nicht wie ein Formular an — er fühlt sich wie ein Gespräch an.
Die 3 Wizard-Schritte
1
Branche bestätigen
Vorausgefüllt aus dem Referral-Code: "Bist du auch im Bereich Gastronomie tätig?" → Ja / Andere Branche wählen. Keine Eingabe nötig — ein Klick genügt.
2
Betrieb beschreiben
"Wie viele Gäste kommen bei dir pro Woche?" → Schieberegler. "In welcher Stadt bist du?" → Freitextfeld (optional). Fühlt sich wie ein Gespräch an, nicht wie ein Formular.
3
Angebot sehen
Personalisierter ROI basierend auf den Eingaben + CTA "Kostenlos starten". Alle Daten werden in fw_referral_wizard_data gespeichert und mit dem UAR-System verknüpft.
Was das AMS sofort sieht
Sobald jemand den Wizard durchläuft, erscheinen im AMS-Dashboard in Echtzeit:
- Wer hat geklickt (anonymisiert oder identifiziert)
- Aus welcher Branche kommt der Lead
- Welche Betriebsgröße wurde angegeben
- Stadt / Region des Interessenten
- Ob ein Kauf erfolgt ist
Diese Daten ermöglichen hochpräzise Segmentierung und gezielte Nachverfolgung — ohne manuellen Aufwand.
Prämien-Logik & Botschafter-Programm
Alle Prämien werden von der referral-engine Edge Function vollautomatisch vergeben — kein manueller Eingriff erforderlich. Die Prämienstruktur ist so gestaltet, dass sie echte Multiplikatoren (Verbandsvertreter, Branchenberater, Ausbilder) besonders stark belohnt.
Botschafter-Badge
Sichtbares Badge in der App — öffentliche Anerkennung als vertrauensvolle Referenz in der Community
10% Dauerrabatt
Gilt für alle zukünftigen Zahlungen — dauerhaft, nicht zeitlich begrenzt
Priorisierter Support
Botschafter erhalten bevorzugten Zugang zum Support-Team
1 Jahr kostenlos
Ab 10 aktiven Einladungen — der stärkste Anreiz für Multiplikatoren und Brancheninsider
Referral Frontend-Komponenten
Das Referral-System ist in allen Staff-Apps als integrierter Teil der Benutzeroberfläche präsent — nicht als separates Modul, sondern als natürlicher Bestandteil des Nutzererlebnisses. Die Komponenten erscheinen genau dann, wenn Nutzer am begeistertsten sind.
ReferralShareButton
In allen Staff-Apps und auf der AccountPage verfügbar. Drei Varianten: Button (für Detailseiten), Compact (für Navigationsleisten), Banner (für Dashboards). Einfaches Teilen per Link, WhatsApp oder E-Mail.
ReferralPrompt
Erscheint automatisch nach definierten Erfolgserlebnissen — nach dem ersten QR-Scan, nach der 10. Übersetzung, nach dem ersten positiven Gäste-Feedback. Der Moment der Begeisterung wird zum Empfehlungsmoment.
ReferralDashboard
Vollständige Übersicht auf der AccountPage im Tab "Empfehlen": Alle Links, Klick-Statistiken, Status jeder Einladung, verdiente und ausstehende Prämien — transparent und in Echtzeit.
ReferralWizard & LandingPage
Unter sales.fintutto.world/ref/:code — personalisierte Landing Page mit vorausgefüllter Branche und 3-Schritt-Wizard für Eingeladene. Maximale Conversion durch minimale Reibung.
Kapitel 9
Enterprise & AMS: Die Schaltzentrale
Das Account Management System (AMS) unter ams.fintutto.world ist die operative Schaltzentrale für das gesamte fintutto.world-Ökosystem. Es vereint Sales-Pipeline, Mitarbeitermanagement, E-Mail-Redaktion, Umsatz-Analytics und Referral-Tracking in einer einzigen, integrierten Oberfläche.
Sales & CRM
Sales-Pipeline im Kanban-Format (Lead → Qualifiziert → Demo → Kauf), Lead-Datenbank mit UAR-Events und Scores, Partner- und Reseller-Verwaltung
Mitarbeiter-Management
Masseneinladungs-Kampagnen per CSV, Einzeleinladungen, Mitarbeiterverwaltung aller Enterprise-Kunden, Rollen-Zuweisung
Content & Templates
E-Mail-Template-Editor mit Live-Vorschau und Test-Versand — alle 15 Templates direkt im Browser bearbeitbar
Analytics & Revenue
Stripe-Umsatz, MRR, Churn, aktive Nutzer, Plattform-KPIs, Referral-Analytics — alle Daten auf einem Dashboard
Enterprise-Mitarbeiter-Onboarding: Zwei Wege
Enterprise-Kunden können Mitarbeiter auf zwei Wegen einladen — je nach Größe des Teams und vorhandenen Daten. Beide Wege enden im selben standardisierten Onboarding-Flow.
Weg A — Masseneinladung via CSV
01
CSV hochladen
Admin lädt CSV mit E-Mail-Adressen und Rollen hoch
02
Links generieren
invite-campaigns Edge Function erstellt personalisierte Einladungslinks für jeden Mitarbeiter
03
E-Mails versenden
Automatischer Versand via Resend (Template: staff_invite)
04
Aktivierung & Onboarding
Mitarbeiter klickt Link → App → Magic-Link-Login → Wizard. Nach 3 Tagen: automatische Erinnerung wenn nicht aktiviert.
Weg B — Einzeleinladung via AMS
01
Eingabe im Dashboard
Admin gibt E-Mail-Adresse und Rolle direkt im AMS-Dashboard ein
02
Account-Erstellung
admin-create-user Edge Function erstellt den Account und generiert den Einladungslink
03
Gleicher Flow
Ab Schritt 4 identisch mit Weg A — Magic-Link-Login, Onboarding-Wizard, automatische Erinnerung
Rollen-Hierarchie
1
2
3
4
1
Owner
2
Admin
3
Staff
4
Guest
AMS-Dashboard-Bereiche
Das AMS-Dashboard ist in funktionale Bereiche gegliedert, die über definierte Routen zugänglich sind. Jeder Bereich hat eine klar abgegrenzte Verantwortlichkeit.
Kapitel 10
Das App-Ökosystem: Alle Domains
fintutto.world besteht aus 20+ eigenständigen Apps auf dedizierten Domains — aufgeteilt in Staff-Apps (für Betreiber und Mitarbeiter), Visitor-Apps (für Gäste und Endnutzer) und System-Apps (für Betrieb und Verwaltung). Alle Apps leben in einem einzigen Monorepo und teilen gemeinsame Infrastruktur.
Staff-Apps
10 spezialisierte Apps für Betreiber und Mitarbeiter — von hospitality.fintutto.world bis conference.fintutto.world. Jede mit branchenspezifischem Interface und Vokabular.
Visitor-Apps
5 Apps für Gäste und Endnutzer — listener.fintutto.world (QR-Code-Gäste ohne Account), consumer.fintutto.world (Privat-Nutzer), medical-patient, hotel-guest, school-student.
System-Apps
AMS, CMS, Sales-Landing-Pages, Haupt-Landing-Page, Developer Portal und Partner Portal — die operative und administrative Infrastruktur der Plattform.
Staff-Apps im Detail
Jede Staff-App ist vollständig auf die Bedürfnisse der jeweiligen Berufsgruppe zugeschnitten — unterschiedliches Vokabular, unterschiedliche Compliance-Anforderungen, unterschiedliche Kernfunktionen.
Kapitel 11
Technische Infrastruktur: Was im Hintergrund läuft
fintutto.world läuft auf einer Supabase-basierten Serverless-Architektur mit 38 aktiven Edge Functions, zwei pg_cron Jobs und einem vollständig normierten Datenbankschema. Die Infrastruktur ist so konzipiert, dass kein manueller Eingriff für den regulären Betrieb erforderlich ist.
38
Edge Functions
Aktiv deployed und getestet — von uar-event-ingest bis stripe-webhook
15
Marketing-Workflows
Alle live in der Datenbank — alle Trigger-Events abgedeckt
140
Stripe-Preise
Alle Branchen und Plan-Tiers abgedeckt — vollständig synchronisiert
5min
Workflow-Intervall
pg_cron führt den uar-workflow-runner alle 5 Minuten aus
Supabase Edge Functions (Kern)
Die wichtigsten Edge Functions bilden das operative Rückgrat der Plattform. Jede Function hat eine klar definierte Verantwortlichkeit und wird ausschließlich über HTTP POST oder interne Trigger aufgerufen.
Datenbank-Schema & Secrets
Das Datenbankschema ist in funktionale Bereiche gegliedert: UAR-Tracking, Workflow-Engine, E-Mail-Templates, Referral-System und Zahlungsverarbeitung. Alle kritischen API-Keys sind als Secrets gesetzt.
Kern-Tabellen
Gesetzte Secrets
RESEND_API_KEY
E-Mail-Versand via Resend
SUPABASE_SERVICE_ROLE_KEY
Admin-Datenbankzugriff
STRIPE_SECRET_KEY
Zahlungsverarbeitung
OPENAI_API_KEY
KI-Übersetzung
ANTHROPIC_API_KEY
Claude für komplexe Übersetzungen
ELEVENLABS_API_KEY
Text-to-Speech
GOOGLE_MAPS_API_KEY
GPS-basierte Inhalte
GOOGLE_TTS_API_KEY
Alternative TTS
Kapitel 12
Deployment & Schutz: Das System schützt sich selbst
Alle 20+ Apps leben in einem einzigen GitHub-Monorepo (alexanderdeibel-Fintutto/translator). Geteilter Code in src/ wird von allen Apps genutzt. App-spezifischer Code liegt in apps/[appname]/. Diese Struktur ermöglicht schnelle Entwicklung bei gleichzeitiger maximaler Stabilität — durch automatisierte Schutzmaßnahmen auf mehreren Ebenen.
Regressionstests
GitHub Actions "Regression Guard" läuft bei jedem Push auf main. Kein Merge ohne grünen CI-Check — Branch Protection ist erzwungen. Bekannte Bugs, die einmal gefixt wurden, können nicht erneut eingebaut werden.
Vercel-Kostenoptimierung
Dank ignoreCommand in jeder vercel.json baut Vercel bei jedem Push nur die tatsächlich betroffenen Apps. Eine Änderung an der Hospitality-App triggert keinen Rebuild der Schul-App — erhebliche Einsparungen bei Build-Minuten.
Pilot-Workflow
Bei Änderungen an Shared Code (src/): Erst auf pilot-Branch pushen → nur Consumer-App deployed → testen → wenn OK: "Approve" in GitHub Actions → alle Apps deployen. Shared-Code-Bugs treffen nie alle Apps gleichzeitig.
Logbuch-Bot
Nach jedem Push wird automatisch CHANGELOG.md mit [skip ci] gepusht — vollständiges, automatisch gepflegtes Audit-Trail aller Änderungen. Keine manuelle Dokumentationspflicht.
Für neue Agenten: Jeder Agent, der an diesem Repository arbeitet, muss als erstes AGENTS.md lesen. Diese Datei enthält alle kritischen Regeln, bekannten Fallstricke und Architektur-Entscheidungen — inklusive der Regressions-Bugs, die einmal gefixt wurden und nie wieder eingebaut werden dürfen.
Anhang: Vollständige Automatisierungs-Checkliste
Stand April 2026 — alle Systeme aktiv und getestet. Kein manueller Eingriff für den regulären Betrieb erforderlich.
unknown link
Vollständig automatisiert. Vollständig aktiv.
Das System läuft. Kein manueller Eingriff erforderlich.
21 Branchen
Spezialisierte App-Erfahrungen für jede Zielgruppe
5 Einstiegspunkte
Vollständig getrackt — jeder Lead wird verstanden
15 Workflows
E-Mail-Automatisierung ohne manuelle Schritte
38 Edge Functions
Serverless-Infrastruktur — skalierbar, zuverlässig
Dokumentation: April 2026 | fintutto.world | alexanderdeibel-Fintutto/translator