Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VD-P23.md
T

53 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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-Ticket **`VD-1`** („Abo-Baukasten-UI + Wizard + Postfach-Inbox"). VD-P23 = der Postfach-Inbox-Anteil.
## Abhängigkeiten & Parallelität
- **Blocked by:** D0-Baseline (`D-D0a` App-Shell, `D-D0b` Archetypen 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/Deal/Project 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/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 |
## 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 `[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 + Vorlagen (M098)
- [ ] Anhänge → v1-Files; Mails erscheinen im Activity-Stream
- [ ] `email.read_own` vs. `email.read_all` filtern 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-Deal-Project-FKs
- `ROADMAP-V2.md` §v2-P2 (Screens/Features = Hauptquelle) · `ROADMAP.md` §Phase 23 · `_bmad-output/specs/M09-email-inbox.md`
- Plane-Snapshot: ersetzt Teil von `VD-1`; bedient `VA-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: