[33e88f42] Keine Zusammenfassung angegeben.

Keine Zusammenfassung angegeben.

fotograf-de-scraper/README.md

@@ -1,6 +1,6 @@
 # Fotograf.de Scraper & Management UI
 
-**Status:** Production-Ready Microservice (Core Feature: PDF List Generation, QR Cards & Shooting Schedule)
+**Status:** Production-Ready Microservice (Core Feature: PDF List Generation, QR Cards, Shooting Schedule & **Gmail API Integration**)
 
 Dieser Service modernisiert die alten `Fotograf.de` Skripte, indem er eine robuste, web-basierte UI zur Verwaltung und Automatisierung von Foto-Aufträgen bereitstellt. Er ist als eigenständiger Microservice konzipiert, der unabhängig vom Haupt-Stack läuft.
 
@@ -10,13 +10,13 @@ Der Service besteht aus zwei Hauptkomponenten:
 
 1.  **Backend (Python / FastAPI / Selenium / SQLAlchemy):**
     *   **Automatisierung:** Nutzt Selenium für das Scraping von `fotograf.de`.
-    *   **Persistenz:** Eine SQLite-Datenbank (`fotograf_jobs.db`) speichert die Auftragsliste, sodass langsame Scraping-Vorgänge nur bei Bedarf (Refresh) nötig sind.
+    *   **Persistenz:** Eine SQLite-Datenbank (`fotograf_jobs.db`) speichert die Auftragsliste, sodass langsame Scraping-Vorgänge nur bei Bedarf (Refresh) nötig sind. Speichert außerdem OAuth-Tokens (`GmailToken`) für persistente E-Mail-Sitzungen.
     *   **PDF-Engine:** Nutzt WeasyPrint für Teilnehmerlisten und ReportLab/PyPDF2 für präzise PDF-Overlays (QR-Karten).
-    *   **API-Integration:** Direkte Anbindung an die **Calendly API (v2)** zum Abruf von Live-Buchungsdaten.
+    *   **API-Integration:** Direkte Anbindung an die **Calendly API (v2)** zum Abruf von Live-Buchungsdaten sowie an die **Gmail API** für direkten E-Mail-Versand.
 
 2.  **Frontend (TypeScript / React / Vite / TailwindCSS):**
     *   **Modernes UI:** Ein vollständig responsives Dashboard mit Tailwind CSS (Kachel-Layout, Tabs für Kiga/Schule).
-    *   **Arbeitsfluss:** Tools sind direkt in der Detailansicht des jeweiligen Auftrags integriert (Shooting-Planung).
+    *   **Arbeitsfluss:** Tools sind direkt in der Detailansicht des jeweiligen Auftrags integriert (Shooting-Planung, E-Mail-Kampagnen).
 
 ## ✨ Core Features
 
@@ -36,16 +36,40 @@ Spezielles Modul für Familien-Mini-Shootings, direkt integriert in die Auftrags
     *   Generiert eine A4-Tabelle für den Shooting-Tag im 6-Minuten-Takt.
     *   Füllt Lücken für nicht gebuchte Slots automatisch leer auf.
 
-### Feature 3: Nachfass-E-Mails (Vollständig)
-*   Identifizierung von Käufern/Nicht-Käufern zur Generierung von CSV-Listen für den Supermailer.
+### Feature 3: Nachfass-E-Mails & Gmail Direkt-Versand (Vollständig)
+Identifizierung von potenziellen Käufern und automatisierter Kontakt.
+*   **Analyse-Logik:** Sucht nach Personen mit 0-1 Logins, die noch keine Bilder gekauft haben.
+*   **Supermailer Export:** Generierung einer fertigen CSV-Liste.
+*   **Direkter Gmail-Versand (Neu):** 
+    *   Volle OAuth 2.0 Integration. Einmaliger Login, das Refresh-Token hält die Sitzung aktiv.
+    *   Inline-Editor für Betreff und HTML-Nachricht mit Live-Platzhaltern (`{Name Käufer}`, `{Kindernamen}`, `{LinksHTML}`).
+    *   Massensendungs-API (Bulk Send) schickt Mails direkt über das verbundene Postfach.
 
 ### Feature 4: Verkaufs-Statistiken (Vollständig)
 *   Detaillierte Analyse des Kaufverhaltens pro Album mit Echtzeit-Fortschrittsanzeige im Browser.
 
+---
+
+## 🎯 Nächste Session: "Freigabeanfragen" (Feature 5)
+
+Das nächste große Ziel ist der automatische Versand von Freigabeanfragen via Gmail.
+
+**Der geplante Workflow (Bestätigt):**
+Anstatt Bild für Bild auf `fotograf.de` zu prüfen, nutzen wir die bereits erteilte **Einwilligung aus Calendly**.
+*   **Logik:** Das System prüft die Calendly-Buchungen des Shootings auf die Frage *"Dürfen wir einige schöne Aufnahmen veröffentlichen?"*.
+*   Alle Kunden, die hier "Ja" (bzw. eine positive Antwort) angegeben haben, werden extrahiert und erhalten automatisiert über die Gmail-API die Freigabeanfrage.
+*   *Text & Template werden in der nächsten Sitzung definiert.*
+
+---
+
 ## 🛠️ Technische Details & Fixes (April 2026)
+*   **E-Mail Signatur:** Die offizielle HTML-Signatur von "Kinderfotos Erding" (inkl. Logo via Google Drive Link) ist hartcodiert hinterlegt und wird bei jedem Massen- oder Testversand unsichtbar im Hintergrund an den HTML-Body angehängt.
+*   **Gmail OAuth Architektur:** Strikt getrennt. App-Credentials (`client_id`, `client_secret`) liegen in der `.env`. User-Credentials (Access & Refresh Tokens) werden dynamisch in der SQLite-Datenbank (`GmailToken`) gespeichert.
+*   **Routing / Reverse Proxy:** 
+    *   Das Frontend (React/Vite) nutzt den `base: '/fotograf-de/'` Pfad, um Assets korrekt hinter dem Nginx-Proxy zu laden.
+    *   API-Aufrufe nutzen relative Pfade (`/fotograf-de-api/`), welche von Nginx sauber zum internen Backend-Port `8000` umgeschrieben (`rewrite`) werden. Dies verhindert Mixed-Content und CORS-Fehler im Produktionsbetrieb.
 *   **Zeitzonen:** Automatische Konversion von Calendly-UTC-Zeiten in die lokale Zeit (`Europe/Berlin`).
 *   **Pagination Fix:** Das Backend blättert durch alle Calendly-Seiten für lückenlose Daten.
-*   **Logo-Integration:** Dynamisches Einbetten des Firmenlogos in alle generierten Dokumente.
 
 ## 🚀 Deployment & Konfiguration
 
@@ -55,8 +79,9 @@ Der Service wird über eine eigene `docker-compose.yml` im Unterverzeichnis gest
 Folgende Variablen müssen in der `.env` im Verzeichnis `/fotograf-de-scraper/` definiert sein:
 *   `KIGA_USER` / `KIGA_PW` / `SCHULE_USER` / `SCHULE_PW`: Logins für Fotograf.de.
 *   `CALENDLY_TOKEN`: Personal Access Token (JWT) von Calendly.
+*   `google_fotograf_client_id` / `google_fotograf_secret`: Die OAuth-App-Credentials aus der Google Cloud Console.
+*   `GOOGLE_REDIRECT_URI`: (Optional) Standard ist `https://floke-ai.duckdns.org/fotograf-de-api/api/auth/callback`.
 
 ### URLs & Ports
-*   **Scraper Frontend:** `http://192.168.178.6:3009`
-*   **Zentrales Dashboard:** `http://192.168.178.6:8090`
-*   **Persistenz:** Datenbank unter `./backend/data/fotograf_jobs.db`.
+*   **Produktion / Nginx:** `https://floke-ai.duckdns.org/fotograf-de/`
+*   **Persistenz:** Datenbank unter `./backend/data/fotograf_jobs.db`.