Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,52 @@
|
||||
# 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:
|
||||
Reference in new issue
Block a user