📱 Trading Companion App – Overview

Ziel

Ein schlanker, per Sideloading installierter Android-Begleiter zur bestehenden PWA. Zweck ist ausschließlich die zuverlässige Zustellung von Push- Benachrichtigungen (was die PWA browserbedingt nicht leisten kann, siehe Rückbau von PA-006/PA-007) sowie Deep-Links, die bei Tap direkt zum richtigen Screen in der App führen.

Bewusst kein eigener Funktionsumfang: Die App dupliziert keine Business-Logik. Sämtliche Trading-Funktionalität (Trade Optimizer, Trading Journal, etc.) läuft unverändert über die bestehenden Web-APIs – die App ist im Kern ein Capacitor-Wrapper um die bestehende React-PWA, ergänzt um zwei native Fähigkeiten: FCM-Push-Empfang und sicheren Token-Storage.

Architektur-Entscheidung

Basis: Capacitor-Wrapper um die bestehende React-PWA (kein separater UI-Stack, keine Logik-Duplizierung)
Native Erweiterung 1: Firebase Cloud Messaging (FCM) für echten Push-Empfang, auch bei geschlossener App
Native Erweiterung 2: Sicherer, verschlüsselter Token-Storage (siehe APP-001)
Distribution: Sideloading (APK selbst signiert, kein Play-Store-Account), Details siehe frühere Diskussion zu Overlay-Optionen

Kernfunktionen

Sideload-Installation und Hinweis auf verfügbare Updates (APP-002)
Gerät für Push-Benachrichtigungen registrieren (FCM-Token, APP-003)
Push-Benachrichtigungen mit optionalen Deep-Link-Buttons empfangen und anzeigen (APP-004)
Bei Tap direkt zum passenden Screen in der App springen (APP-005)
Automatisches Session-/Token-Refresh, sodass eine erneute Anmeldung bei regelmäßiger Nutzung faktisch nicht mehr nötig ist (APP-001)

Plattform-/Service-Integration

Komponente	Beschreibung
Push-Alerts Service	Zustellkanal seit `PA-001` v1.1 um FCM ergänzt (bestehendes Web-Push/VAPID bleibt für den Web-Touchpoint parallel bestehen) – siehe `APP-003`
Plattform-Auth (AUTH-001/AUTH-003)	App nutzt den seit `AUTH-003` verfügbaren Refresh-Token-Mechanismus für dauerhafte Sessions ohne wiederholte Anmeldung (siehe `APP-001`)

Abgrenzung

In Scope	Out of Scope
Push-Empfang via FCM	Headless-Actions in Notifications (bewusste Entscheidung, siehe Changelog)
Deep-Link-Navigation zum richtigen Screen	Eigene, von der PWA unabhängige Business-Logik
Automatisches Token-Refresh	Play-Store-Vertrieb, Auto-Updates

Changelog

Version	Datum	Änderungen
1.3	2026-07-13	Push-Alerts-Blocker aufgelöst – PA-001 v1.1 stellt FCM-Kanal bereit
1.2	2026-07-13	APP-002 bis APP-005 ergänzt (Sideload/Update, Push-Registrierung, Push-Empfang, Deep-Link-Navigation); Push-Alerts-FCM-Erweiterung als offener Blocker markiert

1.1	2026-07-13	Auth-Abhängigkeit konkretisiert – Plattform wurde um AUTH-003 (Refresh-Token-Mechanismus) erweitert, APP-001 verdrahtet dagegen

1.0	2026-07-13	Initiale Version