docs: record verified local FCM setup and E2E test

This commit is contained in:
2026-09-15 11:23:17 +02:00
parent c4a84ec135
commit 59e9299883
4 changed files with 42 additions and 27 deletions
+26 -17
View File
@@ -1,42 +1,51 @@
# ChatGPT-Prompt: Firebase-Zugang für MetalCircle
# ChatGPT-Prompt: Firebase-E2E-Wiederholung für MetalCircle
Den folgenden Prompt in einen neuen Chat kopieren. Keine Secret-Dateien mitgeben.
```text
Hilf mir Schritt für Schritt, den serverseitigen Firebase-Zugang für MetalCircle
im Entwicklungs-/Testbetrieb einzurichten. Verwende aktuelle offizielle
Firebase-/Google-Cloud-Dokumentation und erkläre mir die Console-Bedienung.
Hilf mir, den bereits eingerichteten serverseitigen Firebase-Zugang für MetalCircle
im lokalen Entwicklungs-/Testbetrieb zu prüfen oder den lokalen FCM-E2E-Test zu
wiederholen. Verwende aktuelle offizielle Firebase-/Google-Cloud-Dokumentation,
falls IAM-Fehler untersucht werden müssen.
Ausgangslage:
- Privates Projekt MetalCircle, Repository historisch kai/pingu-concerts.
- Android: Capacitor 6, Package ID dauerhaft de.pinguholic.concerts.
- Firebase-Anzeigename MetalCircle; die tatsächliche Projekt-ID muss ich prüfen.
- Firebase-Projekt-ID: `metalcircle-30d9b`.
- Android-google-services.json ist vorhanden. Tokenregistrierung und manuelle
Firebase-Testnachrichten/Kampagnen funktionieren bereits.
- Backend: FastAPI, PostgreSQL, Docker Compose, firebase-admin Python 7.1.0.
- Pushs für Freundschaftsanfragen, Direktnachrichten und Einladungen sind implementiert.
Kategorien und DE/EN werden pro Empfänger beachtet; Nachrichteninhalt bleibt privat.
- Versand ist standardmäßig deaktiviert und wurde mit simuliertem Firebase getestet.
- Lokaler Versand wurde mit einem echten Android-Gerät über FCM HTTP v1 erfolgreich
getestet. Falls der HTTP-403 `PERMISSION_DENIED` erneut auftritt, wurde für den
dedizierten Test-Service-Account diese Rolle als erforderlich bestätigt:
`roles/firebasecloudmessaging.admin` (Firebase Cloud Messaging API Admin).
- Der lokale Service Account ist
`metalcircle-push-local@metalcircle-30d9b.iam.gserviceaccount.com`.
- Die Service-Account-Datei wird lokal schreibgeschützt als
`/run/secrets/firebase-service-account.json` eingebunden.
Bitte begleite mich bei:
1. Auswahl des Projekts und Ermittlung der tatsächlichen Projekt-ID.
2. Prüfung/Aktivierung der Firebase Cloud Messaging API HTTP v1.
3. Einem eigenen Test-Service-Account, z. B. metalcircle-push-test, mit den für FCM
nötigen Rechten. Prüfe roles/firebasecloudmessaging.admin bzw.
cloudmessaging.messages.create. Kein persönliches Admin-Konto verwenden.
4. Erstellung und sicherer Ablage der Service-Account-JSON außerhalb von Repository
und Docker-Buildkontext. Nur der Betreiber soll die Datei lesen können.
5. Lokaler .env-Konfiguration:
1. Den bestehenden Projekt-, Service-Account- und read-only-Mount-Status anhand
ungefährlicher Metadaten prüfen; keine neue Rolle oder Schlüsseldatei anlegen.
2. Nur bei einem erneuten Versandfehler die FCM HTTP-v1-Aktivierung und die
Zuweisung von `roles/firebasecloudmessaging.admin` für genau diesen lokalen
Service Account im Projekt `metalcircle-30d9b` prüfen.
3. Lokale `.env`-Konfiguration nur auf gesetzte Werte prüfen, nie Inhalte ausgeben:
PUSH_ENABLED=true
FIREBASE_PROJECT_ID=<echte Projekt-ID>
FIREBASE_SERVICE_ACCOUNT_FILE=<absoluter Pfad zur Secret-Datei>
6. Start mit compose.yml plus compose.push.yml. Dieses Override mountet die Datei
4. Lokaler Start mit `compose.yml` plus `compose.push.yml`. Dieses Override mountet die Datei
read-only unter /run/secrets/firebase-service-account.json und setzt im Backend
GOOGLE_APPLICATION_CREDENTIALS auf diesen Pfad.
Lokal HTTP: COOKIE_SECURE=false docker compose -f compose.yml -f compose.push.yml up -d --build web
Auf einem HTTPS-Testserver bleibt COOKIE_SECURE=true.
7. End-to-End-Test mit zwei Testkonten: Anfrage, Nachricht, Veranstaltungseinladung,
DE/EN, Kategorien, Antippen, Logout und Benutzerwechsel.
5. Falls erforderlich, gezielten lokalen E2E-Test mit Testkonten ausführen:
Freundschaftsanfrage, Nachricht, Veranstaltungseinladung und echter Android-
Empfang. Bei erneutem HTTP 403 zuerst die bereinigte Fehlerantwort, Zielprojekt,
aktive Service-Account-Identität und Projektrollen prüfen; bei Erfolg keine
unnötigen Tests, Builds oder Cloud-Änderungen ausführen.
Grenzen:
- Niemals Schlüssel, Tokens, vollständige .env oder JSON-Inhalte im Chat anfordern.