4.2 KiB
VD-P23 · Screens P23 — Postfach-Inbox (Email-Sync)
| Typ | Screen (Design) |
| Owner | David |
| Phase | P23 — Postfach-Sync / Email-Inbox (v2-P2) · bedient VA-P23 |
| Cycle/Fenster | v2-W1 — Public-API/Postfach/Abo/KI-Start · 2026-07-13 → fällig 2026-07-17 |
| Status | geplant (NEU — Phasen-Ticket) |
♻️ Löst Sammel-Ticket auf: Dieses Phasen-Ticket ersetzt — zusammen mit
VD-P24— das alte Sammel-TicketVD-1(„Abo-Baukasten-UI + Wizard + Postfach-Inbox"). VD-P23 = der Postfach-Inbox-Anteil.
Abhängigkeiten & Parallelität
- Blocked by: D0-Baseline (
D-D0aApp-Shell,D-D0bArchetypen A2/A3/A5/A6) — Inbox/Detail/Compose komponieren aus den D0-Archetypen - Bedient (Dev):
VA-P23(Gmail/Outlook OAuth + Inbox + Threading, M096–M098) — v2-W1 (13.–17.07.) - Läuft parallel zu:
VD-P22(Public-API),VD-P24(Abo/Wizard) — gleiche v2-W1 - Subframe: Pflicht je Route (A2 Liste, A3 Detail, A5 Modal, A6 Settings)
Was wir bauen
Die Email-Inbox-Oberfläche: User verbinden ihr Gmail-/Outlook-Postfach per OAuth, das CRM spiegelt Threads bidirektional, matcht auto auf Contact/Lead/Projekt und zeigt sie im Activity-Stream. User lesen Threads mit sicherem HTML-Render, antworten/leiten weiter über die eigene Mailbox. Permission-getrennt über email.read_own vs. email.read_all. Nur OAuth-Sync/Inbox/Threading-Teil — die v1-Sende-Domain (DKIM/SPF/DMARC) wird NICHT neu gebaut.
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/Projekt, 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 |
Features (muss abgedeckt sein)
- OAuth-Connect Gmail (Pub/Sub-Watch) + Microsoft (Graph-Subscription); Token-Refresh + Revoke; Re-Auth-Hinweis
- Push-Sync (kein Primär-Polling); Initial-Sync 90 Tage resumebar mit Progress-Anzeige
- Auto-Match (From→Contact/Lead, Subject-Pattern
[Projekt #123], 1-offenes-Projekt-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 + Vorlagen (M098)
- Anhänge → v1-Files; Mails erscheinen im Activity-Stream
email.read_ownvs.email.read_allfiltern Liste + Activity-Stream
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); Re-Auth-/Token-abgelaufen-Hinweis; Permission-gefilterte Empty-/Loading-/Permission-Denied-States (Klartext).
Quellen (granular)
designer-briefs/P23-postfach-sync.md(vollständiger Brief — diese Doc ist sein Ticket-Destillat)ENTITY-MODEL.md→ Domäne 8: Kommunikation (Email M09/M10) + Activity-Stream/Contact/Lead/Projekt-FKs- Plane-Snapshot: ersetzt Teil von
VD-1; bedientVA-P23(v2-W1, 13.–17.07.)
Davids Delta (David füllt aus)
- Überschriebene/geänderte Spec-Punkte:
- Neue UI/UX-Entscheidungen:
- Subframe-Screen-Link(s):
- Offene Fragen an Dev: