4.3 KiB
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_ownvs.email.read_allfiltern 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: