Deep-Link-Navigation bei Tap auf Notification oder Button
ID: APP-005 · Status: 🟢 aktiv · Use Case: UC-APP-005
Tap auf eine Notification (oder einen ihrer Action-Buttons, siehe APP-004) öffnet die App direkt bei der im Payload enthaltenen url – geladen in der bestehenden Capacitor-WebView, kein zusätzlicher Browser-Tab. Die Route ist dieselbe, die auch im Web-Touchpoint existiert – kein separates App-eigenes Routing-Konzept.
Touchpoint
trading-companion-app
Url Schema
| Feld | Wert |
|---|---|
| Wahl | Android App Links auf der bestehenden Domain (https://matus-toolbox.com/...) statt eines Custom-URL-Schemes (z.B. matustoolbox://...). |
| Begruendung | Dieselbe URL funktioniert dann auch im normalen Browser (Web-Touchpoint) als Fallback – kein doppeltes Routing-Konzept für zwei URL-Formate nötig. Zusätzlicher Vorteil: Falls die App-Link-Verifizierung fehlschlägt, öffnet Android automatisch den Browser mit derselben URL statt eines Fehlers (graceful degradation, siehe fehlerbehandlung). |
Wichtige Voraussetzung
Für Android App Links muss .well-known/assetlinks.json auf matus-toolbox.com öffentlich ohne Cloudflare-Access-Login erreichbar sein (dieselbe Einschränkung wie bei APP-002s version.json) – sonst schlägt die App-Link-Verifizierung fehl.
Beispiel Routen
- /trading/journal/{id} → Journal Trade-Detail (TJ-004)
- /trading/journal/{id}/close → Journal Close-Vorschau (TJ-009), z.B. Ziel des 17:30-Reminders aus TJ-008
- /lunch → Lunch-Übersicht (bestehender Trigger aus PA-002)
- /system → System-Übersicht (bestehender Trigger aus PA-002)
Ablauf
| Feld | Wert |
|---|---|
| 1 Tap | Nutzer tippt auf Notification-Body oder einen Action-Button |
| 2 Session Check | App prüft/refresht die Session im Hintergrund (siehe APP-001), bevor die Zielroute geladen wird |
| 3 Navigation | Zielroute wird in der Capacitor-WebView geöffnet, App kommt in den Vordergrund |
Fehlerbehandlung
| Feld | Wert |
|---|---|
| App Link Nicht Verifiziert | Android öffnet ersatzweise den normalen Browser mit derselben URL (Web-Touchpoint) statt eines Fehlers – funktional identisch, nur ohne native App-Optik. |
| Route Nicht Gefunden | Fallback auf die App-Startseite statt eines Fehlerbildschirms |
Abnahmekriterien
- [ ] Tap auf den Notification-Body öffnet die App direkt bei der im Payload enthaltenen url
- [ ] Tap auf einen Action-Button (falls vorhanden) öffnet die App bei dessen eigener url
- [ ] Zielroute wird innerhalb der bestehenden Capacitor-WebView geladen, kein separater Browser-Tab bei erfolgreicher Verifizierung
- [ ] Session ist beim Laden bereits gültig, kein sichtbarer Login-Zwischenstopp (Zusammenspiel mit APP-001)
- [ ] Bei fehlgeschlagener App-Link-Verifizierung öffnet ersatzweise der normale Browser mit derselben URL
- [ ] assetlinks.json ist ohne Cloudflare-Access-Login erreichbar
Depends On
- APP-001
- APP-004
Changelog
Eintrag 1
Version: 1.0
Changes: Initiale Version – Deep-Link-Navigation bei Tap auf Notification/Button