Push-Benachrichtigung empfangen und nativ anzeigen
ID: APP-004 · Status: 🟢 aktiv · Use Case: UC-APP-004
Die App empfängt Push-Nachrichten über FCM auch bei geschlossener App (Android-Systemebene) und zeigt sie als native Android-Notification an. Der Payload folgt derselben Grundstruktur wie die bestehenden Web-Push- Payloads (title/body/url, siehe PA-002/PA-003), ergänzt um optionale zusätzliche Deep-Link-Buttons.
Touchpoint
trading-companion-app
Payload Struktur
| Feld | Wert |
|---|---|
| Titel | string (Pflicht) |
| Body | string (optional) |
| Url | string (Pflicht) – primäres Ziel beim Tap auf den Notification-Body, dieselbe Route wie im Web-Touchpoint (siehe APP-005) |
| Actions | Liste von { label: string, url: string }, optional, maximal 2 – zeigt zusätzliche Buttons in der Notification, jeder mit eigenem Deep-Link-Ziel (kein Headless-Call, siehe Abgrenzung in der Overview) |
Darstellung
| Feld | Wert |
|---|---|
| Standard | Titel + Text + Icon, Tap auf Body öffnet die App bei url |
| Mit Actions | Bis zu 2 zusätzliche Buttons unterhalb der Notification, je mit eigenem label und Ziel-url |
| Gruppierung | ANNAHME – zu bestätigen: Mehrere gleichzeitige Notifications werden einzeln angezeigt, keine automatische Bündelung/Zusammenfassung in der ersten Version. |
Abnahmekriterien
- [ ] Push-Nachrichten werden auch bei vollständig geschlossener App als native Android-Notification angezeigt
- [ ] Notification zeigt Titel und Text korrekt an
- [ ] Vorhandene actions werden als zusätzliche Buttons dargestellt (max. 2)
- [ ] Keine der Notification-Interaktionen löst einen direkten Backend-Call aus – jede Interaktion führt in die App (siehe APP-005)
- [ ] Fehlender oder fehlerhafter Payload (z.B. ohne title) führt zu keinem App-Absturz, Notification wird übersprungen
Depends On
- APP-003
Changelog
Eintrag 1
Version: 1.0
Changes: Initiale Version – Push-Benachrichtigung empfangen und anzeigen