Fintutto Translator v3.1 — Technische Architektur
Vollständige technische Dokumentation der Systemarchitektur, des Tech Stacks, der Übersetzungs-Pipeline und aller Kernkomponenten des Fintutto Translator v3.1.



Fintutto Translator ist die weltweit erste Übersetzungsplattform, die auch ohne Internet funktioniert — per Bluetooth, WiFi-Hotspot oder lokale ML-Modelle. Live, in Echtzeit, für Gruppen bis 500 Personen, in 45 Sprachen gleichzeitig.

Jetzt kostenlos testen
v3.1.0Build 310Dokument: 01.03.2026intutto - cl{⍶/Ω}ud

alles. automatisch. ab jetzt.

Inhaltsverzeichnis
01
Systemübersicht

PWA, Capacitor, Relay Server, Transport Layer, Translation Engine

02
Tech Stack

Frontend, AI/ML, Realtime/Transport, Native/Mobile, Storage

03
Sprachunterstützung

45 Sprachen, RTL, Romanisierung, Offline-Sprachpaare

04
Übersetzungs-Pipeline & STT/TTS

6-stufige Kaskade, Speech-to-Text, Text-to-Speech

05
Transport-Architektur (4 Tiers)

Cloud, Hotspot, BLE GATT, Offline

06
Sicherheit, Offline, Native App, Seiten & Features

E2E-Verschlüsselung, Service Worker, Capacitor, 13 Routen

07
Datenfluss, Performance & Tests

Diagramme, Bundle-Größen, Latenz-Ziele, 87 Tests

1. Systemübersicht

Das Fintutto Translator v3.1 System verbindet drei Hauptkomponenten: PWA (Browser), Capacitor (Android/iOS) und Relay Server.

React 18 / TypeScript

UI-Framework mit vollständiger Typsicherheit

Vite 6 / PWA

Build-Tool + Dev-Server mit Progressive Web App Support

Tailwind / Radix UI

Utility-First CSS + Accessible Primitives

Capacitor 8

Native Bridge für Android + iOS

Transport Layer & Translation Engine
TRANSPORT LAYER (4-Tier Fallback)
1
Tier 1: Cloud

Supabase Realtime

2
Tier 2: Hotspot

Embedded WebSocket + WiFi AP

3
Tier 3: BLE GATT

Direct Bluetooth, 0 Infrastruktur

4
Tier 4: Offline

Lokale ML-Modelle, kein Netzwerk

TRANSLATION ENGINE (Cascade)
1
Google Cloud Translation API

Primäre Online-Übersetzung

2
MyMemory Translation Memory

Free Fallback

3
LibreTranslate

Open Source Fallback

4
Opus-MT via Transformers.js

Offline, On-Device

2. Tech Stack — Frontend
2. Tech Stack — AI/ML & Realtime/Transport
AI / ML
Realtime / Transport
2. Tech Stack — Native/Mobile & Storage/Caching
Native / Mobile
Storage / Caching
3. Sprachunterstützung — 45 Sprachen in 3 Kategorien
Europäische Kernsprachen (22)

DE, EN, FR, ES, IT, PT, NL, PL, TR, RU, UK, AR, ZH, JA, KO, HI, SV, DA, CS, RO, EL, HU

Migrationssprachen (10)

FA (Farsi/Dari), PS (Paschtu), KU (Kurdisch), TI (Tigrinya), AM (Amharisch), SO (Somali), UR (Urdu), BN (Bengali), SW (Suaheli), SQ (Albanisch)

Tourismussprachen (13)

HR, BG, SR, SK, NO, FI, TH, VI, ID, MS, FIL, HE, KA

RTL-Unterstützung

Vollständige Right-to-Left-Unterstützung für: AR, FA, PS, KU, UR, HE

Romanisierung

Client-seitige Transliteration für: Arabisch, Persisch, Kyrillisch, Griechisch, Devanagari (Hindi/Bengali)

Offline-Sprachpaare

54 herunterladbare Opus-MT Modelle (~35 MB pro Paar)

4. Übersetzungs-Pipeline — 6-stufige Kaskade

Bei jedem Cache-Miss wird die nächste Stufe aktiviert. Circuit Breaker pro Provider: Threshold 3 Fehler → 30s Pause. Request Dedup: Identische gleichzeitige Anfragen teilen ein Promise. Graceful Degradation: Offline → nur Provider 6 aktiv.

4. Übersetzungs-Pipeline — Resilienz & Zusatz-Features
Resilienz-Features
Circuit Breaker

Pro Provider, Threshold 3, Reset 30s

Request Dedup

Identische gleichzeitige Anfragen teilen ein Promise

Retry-After

HTTP-Header wird geparst und respektiert

Cache Eviction

Automatisch bei >500 In-Memory-Einträgen

Graceful Degradation

Offline → nur Provider 6 aktiv

Zusatz-Features pro Übersetzung
Kontextmodi

General, Travel, Medical, Legal, Business, Casual

Formalität

Sie/Du-Konvertierung (9 Sprachen)

Wort-Alternativen

MyMemory TM-Matches (Top 5)

Romanisierung

Automatisch für nicht-lateinische Schriften

Match-Score

Qualitätsindikator pro Übersetzung

5. Speech-to-Text (STT) — Engine-Kaskade
Satz-Boundary-Erkennung
  • Regex-basiert: .!?; + CJK-Interpunktion + Arabische Fragezeichen
  • Erkennt Satzenden im laufenden Interim-Text
  • Emittiert synthetische isFinal=true Events bei Satzgrenzen
  • Ermöglicht Echtzeit-Satz-für-Satz-Übersetzung
Google Cloud STT (iOS)
  • PCM → LINEAR16 Encoding (Int16 → Base64)
  • Polling-Intervall: 3 Sekunden
  • Audio-Buffer: Max 30 Sekunden (Memory-Limit)
  • Sende-Limit: Max 15 Sekunden pro Request
  • Automatische Sample-Rate-Erkennung (iOS Safari: oft 48 kHz)
6. Text-to-Speech (TTS) — Stimm-Hierarchie
Chirp 3 HD

24 Sprachen (Premium)

Neural2

10 Sprachen

Standard

36 Sprachen

Browser Fallback

Alle Sprachen (geräteabhängig)

7. Transport-Architektur — 4 Tiers im Überblick

Der Connection Manager wählt automatisch den besten verfügbaren Transport via autoSelectTransport(config). Broadcast Transport und Presence Transport werden durch AES-256-GCM Verschlüsselung als Decorator gewrappt.

7. Transport-Architektur — Auto-Discovery & Interface
Auto-Discovery (Tier 2)

Probt 6 gängige Router-IPs parallel:

  • 192.168.8.1 (GL.iNet)
  • 192.168.1.1 (Standard)
  • 192.168.0.1 (Alternativ)
  • 10.0.0.1 (Hotspots)
  • 172.20.10.1 (iOS Personal Hotspot)
  • 192.168.43.1 (Android Hotspot)
Transport-Interface
interface BroadcastTransport { type: 'supabase' | 'local-ws' | 'ble' isConnected: boolean subscribe(code, handlers): void broadcast(event, payload): void unsubscribe(): void onConnectionChange(cb): () => void } interface PresenceTransport { type: 'supabase' | 'local-ws' | 'ble' join(code, data): void updatePresence(data): void leave(): void onSync(cb): () => void }
8. BLE GATT Protocol
Service-UUIDs
Characteristics
Chunking-Protocol
Payload > 180 Bytes

Split in 180-Byte Chunks. Chunk 1..N-1: Gesendet als einzelne Notifications. Chunk N (letzter): Markiert als Final.

Listener

Reassembly aus Buffer

Payload ≤ 180 Bytes

Direkt als einzelne Notification

Device-Discovery
  • Advertising-Name Format: GT-TR-XXXX (Session-Code)
  • Scan-Interval: Kontinuierlich
  • Stale-Timeout: 10 Sekunden
  • RSSI-Anzeige für Signalstärke
Native Implementierungen
  • Android: BleTransportPlugin.java — BluetoothGattServer, Android 12+ Permission Decorators
  • iOS: BleTransportPlugin.swift — CBPeripheralManager, CoreBluetooth Framework
9. Hotspot-Relay-Server
Architektur

Das Speaker-Gerät hostet gleichzeitig den WiFi Access Point und den eingebetteten WebSocket Relay Server. Die App (WebView) kommuniziert über einen WS Client (Speaker) mit dem Embedded WS Relay auf Port :8765. Listener-Geräte verbinden sich per WiFi.

Relay-Server
  • Port: 8765 (Standard), 8766 (Embedded Fallback)
  • Protokoll: JSON über WebSocket
  • Health-Check: GET /health → 200 OK
  • Features: Session-Routing, Presence Sync, Broadcast Fan-Out
WiFi-QR-Code Format
WIFI:T:WPA;S:{SSID};P:{Password};;

iOS 11+ / Android 10+: Automatisches Verbindungs-Prompt. Kein manuelles Tippen nötig.

Verbundene Listener
Listener 1
Listener 2
Listener ...N

Bis zu 5–10 Geräte gleichzeitig verbindbar. Kein Internet erforderlich.

10. Sicherheit & Verschlüsselung
E2E-Verschlüsselung (Transport)
Sicherheitsmerkmale
Web Crypto API

Keine externe Krypto-Bibliothek

Key Caching

Pro Session, cleared bei Session-Ende

Transparent Wrapping

EncryptedBroadcastTransport als Decorator

Fallback

Plaintext wenn Web Crypto nicht verfügbar

Envelope

{ _encrypted: base64_ciphertext }

API-Key-Management
  • Google API Key in localStorage (Client-seitig)
  • Schlüssel wird nie an Drittanbieter weitergegeben
  • Env-Variable als Fallback: VITE_GOOGLE_TTS_API_KEY
11. Offline-Fähigkeiten — Service Worker (Workbox)
Opus-MT (pro Sprachpaar)

~35 MB — Offline-Übersetzung

Whisper (multilingual)

~40 MB — Offline-Spracherkennung

ONNX Runtime WASM

~21 MB — ML-Inferenz-Engine

11. Offline-Feature-Matrix
54
Offline-Sprachpaare

Herunterladbare Opus-MT Modelle

~200MB
Voll-Offline

Gesamter Speicherbedarf

~5MB
Basis-App

PWA ohne Offline-Modelle

12. Native App (Capacitor)
Konfiguration
  • App ID: com.fintutto.translator
  • App Name: Fintutto Translator
  • Min Android: API 24 (Android 7.0)
  • Target: API 36 (Android 15)
  • Min iOS: 15.0
  • Capacitor: 8.1.0
Native Plugins
Android-Permissions
  • INTERNET, ACCESS_NETWORK_STATE
  • RECORD_AUDIO, CAMERA
  • CHANGE_WIFI_STATE, ACCESS_WIFI_STATE, ACCESS_FINE_LOCATION
  • NEARBY_WIFI_DEVICES (SDK 33+)
  • BLUETOOTH, BLUETOOTH_ADMIN (SDK < 30)
  • BLUETOOTH_SCAN, BLUETOOTH_ADVERTISE, BLUETOOTH_CONNECT
iOS-Permissions
  • NSMicrophoneUsageDescription
  • NSCameraUsageDescription
  • NSSpeechRecognitionUsageDescription
  • NSLocalNetworkUsageDescription
  • NSBluetoothAlwaysUsageDescription
  • NSBluetoothPeripheralUsageDescription
  • UIBackgroundModes: bluetooth-central, bluetooth-peripheral
13. Seiten & Features — 13 Routen
13. Seiten & Features — Hauptübersetzer & Live-Session
Hauptübersetzer (/)
Eingabe

Quellsprache ⟷ Zielsprache. Text eingeben oder sprechen. 🎤 📋 🔊 Sie/Du

Ausgabe

Übersetzung, 📖 Aussprache, 🔄 Alternativen, Provider + Match-Score, 👍 👎 📋 🔊

Kontext

🌐 ✈️ 🏥 ⚖️ 💼 💬 — Letzte 5 Übersetzungen [klick = wieder laden]

Live-Session (/live/:code) — Speaker
  • QR-Code(s): WiFi (Hotspot) + Session-Code
  • Mikrofon-Steuerung (Start/Stop)
  • Echtzeit-Transkript
  • Listener-Statistik (Anzahl, Sprachen, Verteilung)
  • Latenz-Monitoring (STT/Translate/Total)
  • Session-Protokoll Export (TXT/MD)
  • BLE-Advertising-Status
Live-Session — Listener
  • Große Übersetzungsanzeige (2xl–3xl)
  • Sprachauswahl-Chips, Auto-Speak Toggle
  • Vollbild-Untertitel-Modus (3xl–6xl, schwarzer Hintergrund)
  • Letzte 5 Untertitel mit Fade-Effekt
  • Verbindungsstatus-Indikator
14. Datenfluss-Diagramme — Live-Session: Speaker → Listeners
Latenz-Pipeline
1
markSTTStart()

STT Processing → markSTTEnd()

2
markTranslateStart()

API Call → markTranslateEnd()

3
markBroadcast()

Transport

4
markTTSStart()

TTS → markTTSEnd()

LatencyReport { sttMs, translateMs, broadcastMs, ttsMs, totalMs, provider }

15. Performance & Metriken
Bundle-Größen
Latenz-Ziele
Speicheranforderungen
16. Test-Abdeckung — 87 Tests, 7 Test-Suiten
Build-Pipeline
npm run build # tsc && vite build (12s) npm test # vitest run (2.2s) npm run cap:sync # Capacitor sync
87
Tests gesamt

Über 7 Test-Suiten

12s
Build-Zeit

tsc && vite build

2.2s
Test-Laufzeit

vitest run

Fintutto Translator v3.1.0Build 310Dokument generiert am 01.03.2026