# Designer-Brief · P23 — Postfach-Sync (Email-Inbox) (v2-P2) **Phase:** 23/34 (v2-P2) · **Modul:** M09 (M096–M098) · **Owner-Dev:** Akeshan (VA-P23) · **Designer:** David · **Slot:** v2-W1 (13.–17.07.) **Quellen:** `ROADMAP-V2.md` §v2-P2 (Screens/Features = Hauptquelle) · `ROADMAP.md` §Phase 23 · `ENTITY-MODEL.md` (Activity-Stream/Contact-Deal-Project-FKs) · `_bmad-output/specs/M09-email-inbox.md` (OAuth-Sync/Inbox/Threading-Teile) **Subframe:** Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A5 Modal, A6 Settings). > 🔵 **Recut-Hinweis:** Nur der **OAuth-Sync/Inbox/Threading-Teil** von M09 ist v2. Die **Sende-Domain (DKIM/SPF/DMARC)** stammt aus v1-P14 und wird **NICHT** neu gebaut. Versand läuft über die **User-Mailbox** (Gmail/Graph), nicht über die Marketing-Sende-Domain. Push-Sync ist Pflicht (kein Primär-Polling). ⚠️ Gmail restricted scopes (`gmail.modify/send`) brauchen Google-Verifizierung/CASA (Antrag lief in v1 EXT-13); Microsoft-Graph-Subscription muss ~alle 3 Tage erneuert werden. ## Was dieses Modul tut (Kurzfassung) Gmail- und Outlook-Postfächer der User werden **bidirektional ins CRM gespiegelt**: per OAuth verbunden, per Push-Sync (Gmail Pub/Sub-Watch, Microsoft Graph-Subscription) aktuell gehalten, **auto-gematcht** auf Contact/Lead/Deal und im **Activity-Stream** sichtbar. User lesen Threads in einer Inbox-Liste mit sicherem HTML-Render und antworten/leiten weiter über die eigene Mailbox. Permission-getrennt über `email.read_own` vs. `email.read_all`. ## Benötigte Screens | Screen [Route] | Kern-Inhalt | Archetyp | |---|---|---| | Mailbox-Connect-Settings [`/settings/integrations/email`] | Postfach verbinden (Gmail/Microsoft OAuth), Sync-Status (Initial-Sync-Progress, letzter Sync, Fehler), Reconnect/Token-Refresh, Trennen/Revoke | A6 | | Inbox-Liste [`/emails`] | Mail-Liste (Absender, Betreff, Snippet, Datum, Verknüpfung-Badge, gelesen/ungelesen) · Filter (Mailbox/verknüpft/unverknüpft/Datum) · Volltext-Suche · Bulk-Actions | A2 | | Mail-Detail [`/emails/:id`] | Thread-Ansicht (chronologisch), sicherer HTML-Render (externe Bilder blockiert/optional laden), Anhänge (→ Files), Verknüpfungs-Editor (Contact/Lead/Deal/Project, manueller Override), Reply/Forward | A3 | | Outbound-Compose [`/emails/new`] | Neue Mail / Reply / Forward über User-Mailbox, Empfänger, Betreff, Body, Anhänge, Vorlagen-Auswahl | A5/A3 | ## Geplante Features (muss abgedeckt sein) - [ ] OAuth-Connect Gmail (Pub/Sub-Watch) + Microsoft (Graph-Subscription) mit 3-Tage-Renewal-Worker, Token-Refresh + Revoke - [ ] Push-Sync (kein Primär-Polling); Initial-Sync 90 Tage, resumebar mit Progress-Anzeige - [ ] Auto-Match: From-Adresse → Contact/Lead, Subject-Pattern (`[Deal #123]`), 1-offener-Deal-Heuristik; manueller Override sticht - [ ] Inbox-Liste mit Filter/Suche/Bulk + Detail mit Thread + sicherem HTML-Render (CSP, externe Bilder blockiert) - [ ] Reply/Forward via User-Mailbox (Provider-Quotas beachten) + Vorlagen (M098) - [ ] Anhänge landen in v1-Files; Mails erscheinen im Activity-Stream - [ ] `email.read_own` vs. `email.read_all` filtern Liste + Activity-Stream - [ ] OAuth-Tokens per DEK verschlüsselt (Token-Encryption) ## Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand) Provider-Connect-Buttons (Gmail/Microsoft mit Logo), Sync-Status-Panel (Progress-Bar Initial-Sync, letzter-Sync-Zeitstempel, Fehler-Banner mit Reconnect), Mail-Daten-Tabelle (gelesen/ungelesen-Indikator, Verknüpfungs-Badge), Filter-Bar + Volltext-Suchfeld, Bulk-Action-Toolbar, Thread-Ansicht (kollabierbare Nachrichten), sicherer HTML-Render-Container mit „externe Bilder laden"-Hinweis, Anhang-Chips/Liste, Verknüpfungs-Editor (Entity-Picker mit Auto-Match-Vorschlag + Override), Reply/Forward-Composer (Empfänger-Felder, Body-Editor, Vorlagen-Dropdown, Anhang-Upload), Permission-gefilterte Empty-/Loading-/Permission-Denied-States (Klartext), Re-Auth-/Token-abgelaufen-Hinweis. ## Davids Delta (David füllt aus) - [ ] Überschriebene/geänderte Spec-Punkte: - [ ] Neue UI/UX-Entscheidungen: - [ ] Subframe-Screen-Link(s): - [ ] Offene Fragen an Dev: ## Dev-Nachzug (wir nach Davids Delta) - [ ] Spec/ENTITY-MODEL an Davids Entscheidungen angepasst: - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen: - [ ] Plane-Ticket (VA-P23) aktualisiert: