Technische Dokumentation
fintutto.world — Funnel- & Onboarding-Dokumentation
Stand: April 2026 | Repo: alexanderdeibel-Fintutto/translator (Monorepo)
Diese Dokumentation beschreibt die vollständige Systemarchitektur, alle Branchen-Segmente, Sales-Einstiegspunkte, den Magic-Link-Flow, Onboarding-Prozesse je Nutzertyp sowie das UAR-Tracking-System von fintutto.world — einer KI-Übersetzungsplattform für 21 Branchen-Segmente.
Kapitel 1
Systemarchitektur im Überblick
fintutto.world ist eine KI-Übersetzungsplattform mit 21 Branchen-Segmenten, die über ein gemeinsames Monorepo (apps/) betrieben werden. Das System unterscheidet drei klar definierte Nutzertypen mit unterschiedlichen Einstiegswegen und Berechtigungen.
Staff / Mitarbeiter
Nutzt die App aktiv zur Übersetzung (z.B. Arzt, Beamter, Guide)
Einstieg: Magic-Link via Sales-Funnel
Visitor / Gast
Empfänger der Übersetzung (z.B. Patient, Tourist)
Einstieg: QR-Code → Listener-App
Enterprise-Admin
Verwaltet Organisation, Lizenzen und Mitarbeiter
Einstieg: AMS-Dashboard
Das technische Backbone bildet Supabase (Auth, Datenbank, Edge Functions) in Kombination mit Resend für den E-Mail-Versand und Stripe für die Zahlungsabwicklung.
Kapitel 2
Branchen & Segmente
Das System kennt 21 Segmente, organisiert in 6 Branchengruppen. Jedes Segment verfügt über eine dedizierte Landing Page unter sales.fintutto.world/{segment} sowie eine zugehörige App-Domain.
Segment-Übersicht nach Branchengruppe
Gruppe A – Öffentlicher Sektor
  • authority — Behörden & Ämter → authority.fintutto.world
  • ngo — NGO & Soziales → ngo.fintutto.world
  • school — Bildung & Schule → school.fintutto.world
  • medical — Medizin & Gesundheit → medical.fintutto.world
Gruppe B – Tourismus & Kultur
  • guide — Stadtführer & Guides
  • museum — Museen & Ausstellungen
  • region — Regionen & Tourismus
  • natur — Natur & Freizeit
  • art — Kunstführer → art.fintutto.world
  • city — Stadtguide → city.fintutto.world
Gruppe C – Gastronomie & Hotellerie
  • hospitality — Hotellerie
  • gastro — Gastronomie & Restaurant
  • counter — Service & Counter
Gruppe D – Events & Konferenzen
  • events — Events & Veranstaltungen → guide.fintutto.world
  • conference — Konferenzen → conference.fintutto.world
Gruppe E – Mobilität & Handel
  • transport — Transport & Mobilität → guide.fintutto.world
  • retail — Einzelhandel → guide.fintutto.world
Gruppe F – Enterprise & Sonderlösungen
  • enterprise — Enterprise-Kunden → enterprise.fintutto.world
  • personal — Einzelpersonen → app.fintutto.world
  • agency — Agenturen → enterprise.fintutto.world
  • partner — Partner & Reseller → portal.fintutto.world

Mehrere Segmente teilen sich eine gemeinsame App-Domain — z.B. gastro, counter und hospitality alle → hospitality.fintutto.world
Kapitel 3
Sales-Einstiegspunkte & Landing Pages
Der Sales-Funnel ist dreistufig aufgebaut: von der Haupt-Website über die Sales-Übersicht bis hin zu segment-spezifischen Landing Pages. Für Segmente ohne dedizierte Seite greift ein generischer Fallback mit ROI-Kalkulator und Lead-Formular.
1
fintutto.world
Haupt-Landing-Page — erster Kontaktpunkt für alle Interessenten
2
sales.fintutto.world
Sales-Übersicht (SalesOverviewPage) — alle Segmente im Überblick
3
sales.fintutto.world/{seg}
Segment-spezifische Landing Page — maßgeschneidert für jede Branche
4
Generischer Fallback
SalesSegmentPage via /:segment — ROI-Kalkulator + Lead-Formular
Dedizierte Landing Pages existieren u.a. für: Authority, Medical, Hospitality, Gastro, Counter, Guide, Museum, Events, Region, Natur, Retail, Transport, NGO, School, Art, City sowie Solution-Views für Agenturen und Medizin.
Kapitel 4
Magic-Link-Flow
Der Magic-Link-Flow ist das Herzstück der passwortlosen Authentifizierung bei fintutto.world. Ein Nutzer muss sich nie ein Passwort merken — der Einstieg erfolgt ausschließlich über einen per E-Mail versendeten Einmal-Link, der direkt zur richtigen App weiterleitet.
Die URL-Struktur des Magic-Links lautet: https://{app}.fintutto.world/auth#access_token={token}&type=magiclink. Supabase setzt den redirectTo-Parameter beim Versand automatisch auf die jeweilige App-URL. Der Plan-Parameter in der Registrierungs-URL (?plan={segment}_basic) steuert, welche App-Domain als Redirect-Ziel verwendet wird.
Plan-zu-App-Mapping
Der plan-Parameter der Registrierungs-URL bestimmt, auf welche App-Domain der Magic-Link verweist. Die folgende Tabelle zeigt das vollständige Mapping:
Kapitel 5
App-Domains & Routing-Matrix
Die Plattform ist in mehrere Gruppen von Apps aufgeteilt: Staff-Apps für Mitarbeiter, Visitor-Apps für Gäste und Empfänger sowie System-Apps für Verwaltung und Vertrieb. Jede App hat eine dedizierte Domain und ein eigenes Verzeichnis im Monorepo.
Staff-Apps (Mitarbeiter)
  • authority.fintutto.world — Beamte, Sachbearbeiter
  • medical.fintutto.world — Ärzte, Pflegepersonal
  • ngo.fintutto.world — NGO-Mitarbeiter
  • school.fintutto.world — Lehrkräfte
  • guide.fintutto.world — Stadtführer, Naturguides
  • hospitality.fintutto.world — Hotel-, Gastro-Personal
  • conference.fintutto.world — Konferenz-Sprecher
  • enterprise.fintutto.world — Enterprise-Mitarbeiter
Visitor/Gast-Apps (Empfänger)
  • listener.fintutto.world — QR-Scan Zuhörer
  • consumer.fintutto.world — Allgemeine Nutzer
  • medical-patient.fintutto.world — Patienten
  • school-student.fintutto.world — Schüler
  • hotel-guest.fintutto.world — Hotelgäste
  • authority-visitor.fintutto.world — Behörden-Besucher
  • ngo-client.fintutto.world — NGO-Klienten
System-Apps
  • sales.fintutto.world — Vertrieb & Landing Pages
  • ams.fintutto.world — Account Management System
  • developer.fintutto.world — API-Dokumentation
Kapitel 6
Onboarding-Flows je Nutzertyp
Fintutto.world unterscheidet vier verschiedene Onboarding-Szenarien, je nach Nutzertyp und Branche. Während Staff-Nutzer einen geführten Wizard durchlaufen, kommen Gäste ganz ohne Registrierung aus — maximale Einfachheit für den Endempfänger der Übersetzung.
1
Standard-Staff-Onboarding
Authority, NGO, Medical, School nutzen denselben StaffAuthGate + StaffOnboardingWizard mit 4 Schritten: Willkommen, Profil-Setup, erste Übersetzung, QR-Code-Einführung.
2
Hospitality / Guide
Ähnlicher Flow wie Standard, aber mit branchenspezifischen Schritten: Tisch-QR-Codes für Gastro-Betriebe, Tour-Setup für Guide-Nutzer.
3
Enterprise-Onboarding
Admin richtet Organisation ein (Firmenname, Logo, Standorte, Abteilungen), lädt Mitarbeiter via AMS ein — diese durchlaufen dann das Standard-Staff-Onboarding.
4
Visitor / Gast-Flow
Kein Login, kein Onboarding: Gast scannt QR-Code → listener.fintutto.world/ABCD → Sprache wählen → live Übersetzung empfangen.
Standard-Staff-Onboarding: Schritt für Schritt
Der StaffAuthGate prüft beim App-Start, ob onboarding_completed in der Datenbank gesetzt ist. Ist dies nicht der Fall, öffnet sich automatisch der Onboarding-Wizard als Modal. Nach Abschluss wird ein UAR-Event ausgelöst, das die Drip-E-Mail-Serie startet.
Schritt 1 — Willkommen & App-Erklärung
Erste Orientierung: Was ist fintutto? Wie funktioniert die Übersetzung?
Schritt 2 — Profil-Setup
Name, Rolle und bevorzugte Sprache werden eingetragen und gespeichert.
Schritt 3 — Erste Übersetzung
Der Nutzer probiert die App direkt aus — erste Übersetzung live erleben.
Schritt 4 — QR-Code für Gäste
Der persönliche QR-Code wird gezeigt — Gäste können ab sofort die Listener-App nutzen.
Kapitel 7
Enterprise & AMS: Mitarbeiter-Einladungsflow
Für Enterprise-Kunden und den Marktaufbau (Zero-Budget-Modell) stehen zwei unterschiedliche Einladungswege zur Verfügung — einer für Masseneinladungen via AMS, einer für die gezielte Einzeleinladung durch Enterprise-Admins.
Weg A: AMS → Masseneinladung
Für den Marktaufbau ohne Vertriebsbudget:
  1. Kampagne erstellen (Typ: authority, medical, etc.)
  1. CSV-Kontakte importieren (aus Scraping / Recherche)
  1. E-Mail-Template wählen & Kampagne starten
  1. Batch-Versand via invite-campaigns Edge Function
  1. Tracking: Gesendet / Geöffnet / Geklickt / Registriert
  1. Automatisches Follow-up an nicht-reagierte Kontakte
Weg B: Enterprise-Admin → Einzeleinladung
Für bestehende Enterprise-Kunden, die neue Mitarbeiter hinzufügen:
  1. Admin öffnet AMS → /dashboard/staff
  1. E-Mail + Rolle eingeben → "Mitarbeiter einladen"
  1. admin-create-user Edge Function wird aufgerufen
  1. Supabase erstellt User-Account
  1. Welcome-E-Mail mit Magic-Link via Resend versendet
  1. Mitarbeiter klickt Link → Standard-Staff-Onboarding
Sicherheitsmodell: admin-create-user
Die admin-create-user Edge Function prüft jeden Aufruf in einer festen Reihenfolge ab. Nur wenn alle Prüfungen bestanden sind, wird ein neuer Nutzer angelegt und die Welcome-E-Mail versendet.
Prüfung 1: Auth-Header
Auth-Header vorhanden? → sonst 401 UNAUTHORIZED
Prüfung 2: Session
Supabase-Session gültig? → sonst 401 UNAUTHORIZED
Prüfung 3: Rolle
Caller hat role = 'admin' in gt_users? → sonst 403 FORBIDDEN
Prüfung 4: Duplikat
Ziel-E-Mail bereits registriert? → gibt bestehenden User zurück
Erfolg: User anlegen
Neuen User in Supabase erstellen → Welcome-E-Mail mit Magic-Link senden
AMS-Rollen & Dashboard-Bereiche
AMS-Rollen im Überblick
Wichtige AMS-Dashboard-Bereiche
  • /dashboard/platform — Plattform-Übersicht & KPIs
  • /dashboard/pipeline — Sales-Pipeline (Kanban)
  • /dashboard/lead-database — Lead-Datenbank
  • /dashboard/invite-campaigns — Masseneinladungs-Kampagnen
  • /dashboard/organizations — Organisations-Manager
  • /dashboard/staff — Mitarbeiter-Manager
  • /dashboard/revenue — Umsatz-Dashboard
  • /dashboard/tours — Tour-Editor
  • /dashboard/artworks — Kunstwerk-Manager
Kapitel 8
UAR-Tracking & Automatisierungen
Das Universal Account Record (UAR)-System ist die zentrale Automatisierungsschicht von fintutto.world. Es trackt Nutzerverhalten in Echtzeit und löst automatisch E-Mail-Drip-Sequenzen aus — ohne manuellen Eingriff.
Drip-Workflow-Sequenzen
Nach onboarding_complete
Tag 0
Welcome-E-Mail: "Willkommen bei fintutto.world"
Tag 1
Tipps-E-Mail: "So nutzen Sie die App optimal"
Tag 3
Feature-E-Mail: "Haben Sie schon den QR-Code ausprobiert?"
Tag 7
Check-in-E-Mail: "Wie läuft es?"
Tag 14
Upgrade-E-Mail: "Mehr Sprachen, mehr Features"
Nach calculator_view (ohne Registrierung)
Tag 1
Follow-up: "Ihr ROI-Ergebnis wartet"
Tag 3
Angebot: "Kostenlos testen – keine Kreditkarte"
Tag 7
Letzte Chance: "Ihr persönliches Angebot"
Technische Komponenten
  • uar-tracker.ts — Events an Edge Function senden
  • uar-event-ingest — Events empfangen & speichern
  • uar-workflow-runner — Drip-Sequenzen via pg_cron
  • send-email — E-Mails via Resend versenden
  • fintutto-world-crm — Lead-Verwaltung
Kapitel 9
Vollständige Domain-Übersicht
Alle Produktiv-Domains von fintutto.world sind aktiv live. Die Plattform umfasst 27 Produktiv-Domains sowie mehrere Supabase-Backend-Endpunkte für Edge Functions.
Supabase Backend-Endpunkte
Alle serverseitigen Prozesse laufen als Supabase Edge Functions auf dem Haupt-Projekt (aaefocdqgdgexkcrjhks.supabase.co). Die folgende Übersicht zeigt die wichtigsten Endpunkte und ihre Funktion:
UAR Event Ingest
/functions/v1/uar-event-ingest — Empfängt und speichert alle Tracking-Events von den Frontend-Apps in Echtzeit.
UAR Workflow Runner
/functions/v1/uar-workflow-runner — Führt Drip-E-Mail-Sequenzen aus, getriggert via pg_cron in definierten Zeitintervallen.
Send Email
/functions/v1/send-email — Zentrale E-Mail-Funktion für alle transaktionalen Mails via Resend (Magic-Links, Drip, Einladungen).
Admin Create User
/functions/v1/admin-create-user — Legt neue Mitarbeiter-Accounts an, geprüft durch das dreistufige Sicherheitsmodell.
Stripe Integration
/functions/v1/stripe-checkout & stripe-webhook — Steuert Checkout-Prozesse und verarbeitet eingehende Zahlungs-Webhooks von Stripe.
Invite Campaigns
/functions/v1/invite-campaigns — Verarbeitet Masseneinladungs-Kampagnen aus dem AMS im Batch-Modus mit Follow-up-Automatisierung.
Zusammenfassung
fintutto.world ist eine vollständig integrierte KI-Übersetzungsplattform, die Vertrieb, Authentifizierung, Onboarding und Automatisierung in einem einzigen Monorepo vereint. Das System skaliert nahtlos von Einzelpersonen bis hin zu Enterprise-Organisationen mit hunderten Mitarbeitern.
21 Segmente
in 6 Branchengruppen — von Behörden bis Gastronomie, alle mit eigener Landing Page und App-Domain.
Passwortloser Einstieg
Magic-Link-Flow via Supabase — sicher, einfach, kein Passwort notwendig für Staff oder Enterprise-Nutzer.
Zero-Friction für Gäste
QR-Code scannen → Sprache wählen → Übersetzung empfangen. Kein Login, kein Onboarding, kein Aufwand.
Vollautomatisches CRM
UAR-Tracking löst Drip-Sequenzen, Follow-ups und AMS-Benachrichtigungen ohne manuellen Eingriff aus.

Dokumentation generiert: April 2026 | Quelle: alexanderdeibel-Fintutto/translator Monorepo