Geräte-Registrierung für Push-Benachrichtigungen (FCM)
ID: APP-003 · Status: 🟢 aktiv · Use Case: UC-APP-003
Nach erfolgreichem Login fragt die App die Notification-Permission an und registriert bei Erlaubnis einen Firebase-Cloud-Messaging-Token (FCM) beim Push-Alerts Service, damit dieser künftig Push-Nachrichten an dieses Gerät zustellen kann – als Ergänzung zum bestehenden Web-Push-Kanal (PA-001), nicht als Ersatz (Web-Touchpoint nutzt weiterhin Web-Push).
Touchpoint
trading-companion-app
Grundlage
Löst sich auf Basis von PA-001 v1.1 (Push-Alerts Service): Der Service akzeptiert seit dieser Version FCM-Tokens als zweiten Subscription-Typ (subscription_type=fcm) über denselben Endpunkt wie Web-Push- Subscriptions. Dieser REQ (APP-003) beschreibt nur noch, WIE die App diesen bereits vorhandenen Kanal nutzt – nicht mehr, OB er existiert.
API
Endpoint: POST /api/alerts/subscription (Push-Alerts Service, PA-001)
Body
| Feld | Wert |
|---|---|
| Typ | fcm |
| Fcm Token | string |
| Device Info | string (optional) |
Ablauf
| Feld | Wert |
|---|---|
| 1 Permission | Nach erfolgreichem Login (siehe APP-001) fragt die App die Android-Notification-Permission an |
| 2 Token Holen | Bei Erlaubnis liefert das FCM-SDK einen geräte-/installationsspezifischen Token |
| 3 Registrierung | Token wird per POST /api/alerts/subscription (PA-001, type=fcm) ans Backend übergeben und dem eingeloggten Nutzer zugeordnet |
| 4 Token Rotation | FCM kann Tokens gelegentlich erneuern (z.B. nach App-Neuinstallation oder Datenlöschung) – die App erkennt das über den SDK-Callback und registriert automatisch neu, ohne Nutzeraktion |
Fehlerbehandlung
| Feld | Wert |
|---|---|
| Permission Verweigert | Kein Fehler, Info-Hinweis; App bleibt ansonsten voll nutzbar (nur ohne Push) |
| Registrierung Fehlgeschlagen | Stiller Retry beim nächsten App-Start, kein blockierender Fehlerdialog |
Abnahmekriterien
- [ ] Notification-Permission wird explizit angefragt, nicht still vorausgesetzt
- [ ] Bei Erlaubnis wird der FCM-Token an das Backend übergeben und dem Nutzer zugeordnet
- [ ] Bei Verweigerung bleibt die App voll nutzbar, nur ohne Push
- [ ] Token-Rotation durch FCM wird automatisch erkannt und nachregistriert
- [ ] Registrierung erfolgt erst nach erfolgreichem Login (APP-001), nicht davor
Depends On
- APP-001
- PA-001
Changelog
Eintrag 1
Version: 1.0
Changes
Initiale Version – Geräte-Registrierung für Push, inkl. offener Abhängigkeit zur FCM-Erweiterung im Push-Alerts Service
Eintrag 2
Version: 1.1
Changes: Blocker aufgelöst – konkret gegen PA-001 v1.1 verdrahtet, das den FCM-Kanal jetzt bereitstellt