Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/D-P7.md
T

60 lines
7.3 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.
# D-P7 · Screens P7 — Lead-Inbox
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P7 — Lead-Inbox (bedient `R-P7`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-25 → 2026-06-26 · Gate W2 (Noah-Demo #1) |
| **Status** | geplant (NEU — schließt P7-Screen-Lücke) |
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail, A4 Form, A5 Modal, A6 Settings, KPI-Kit)
- **Bedient (Dev):** `R-P7` (Lead-Inbox, Lead→Projekt, Anti-Spam, Statistiken)
- **Läuft parallel zu:** `D-CRM`-Cluster (Kontakt-/Firmen-Listen aus P6) — Lead-Cluster gehört ins selbe Designer-Paket (Noah-Demo #1); embedded Task-Liste/Files-Sub-Sektion kommen aus `D-P4`
- **Subframe:** Pflicht je Route (A2 Triage-Liste, A3 Detail, A5 Lead→Projekt-Flow, A6 Settings, KPI-Kit)
## Was wir bauen
Den **Lead-Triage-Arbeitsplatz**: eingehende Leads aus allen Quellen (Form, eingehende E-Mail, AirCall-Inbound, manueller Eintrag, Custom-Quellen) landen automatisch angelegt in einer Inbox, sind spam-geschützt, auswertbar und per Workflow weiterverarbeitbar.
> 🔴 **Pivot-Vorrang (AD-20):** Es gilt das `ENTITY-MODEL.md`, nicht die pre-Pivot-SCREEN-MAP. Das **Lead-Promotion-Modal (4-Optionen) entfällt** — es wird **Lead → Projekt**. Ein Lead trägt **`weiterverarbeitung_freigabe` (ja/nein/unklar)**; bei „ja" entsteht ein `Projekt` (kein Contact-Promotion), Lead-Daten werden vererbt (`konvertiert_projekt_id`), der **Kontakt wird separat verknüpft** (`verknuepfter_kontakt_id` — neu oder bestehend). Status-Enum bleibt `new/qualified/converted/lost/spam`.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Lead-Inbox** [`/leads`] | Tabelle/Karten: Identität (Name, sonst Email/Telefon, sonst Quelle+Datum), Quelle, Status, Verantwortlicher, Eingegangen (relativ <7 T), letzte Activity, 80-Zeichen-Message-Vorschau · Marker „Mögliches Duplikat"/„Spam-Verdacht"/„Auto-promoviert" · Filter (Status [Default new+qualified], Quelle, Verantwortlicher inkl. „Nicht zugewiesen", Eingegangen-Range, Tags, Lead-Custom-Felder) · Toggles „Spam ausblenden" (Default ein) + „Konvertierte einblenden" (Default aus) · Inline-Quick-Actions (Zuweisen, Status, **Zu Projekt machen**, Spam) · Bulk · Real-time-Refresh | A2 + Triage-Akzente |
| **Lead-Detail** [`/leads/:id`] | Stammdaten inline-editierbar · Quellen-Detail (Form-Name/Submission-ID/IP bzw. Email-Header bzw. Anruf-Aufzeichnungs-Link) · **Weiterverarbeitungsfreigabe (ja/nein/unklar)** · Spam-Score + Klartext-Begründung · **Match-Hinweise** (existierende Kontakte gleiche Email/Telefon, Soft-Match Name+Adresse) mit Direkt-Übergängen · Re-Submission-Verlauf · Status-Wechsler · DSGVO-Auto-Lösch-Hinweis mit Datum · Triage-Quick-Actions (Annehmen/Antworten/Anrufen/Notiz/Task/Termin) · Sub-Sektionen Übersicht/Konversation/Activity/Custom-Felder | A3 |
| **Lead → Projekt** [bei Freigabe, kein Modal-Zwang] | Bei `weiterverarbeitung_freigabe=ja`: Projekt aus Lead anlegen · **Daten-Vererbungs-Vorschau** (welche Lead-Felder ins Projekt fließen) · Ziel-Pipeline + Start-Status wählen · **Kontakt separat verknüpfen** (neu ODER bestehend, Auto-Match-Hinweis) · Mängel-Banner bei fehlenden Pflichtdaten (z. B. Name) | A5 — **Kern-Moment der Kette** (ersetzt das alte 4-Optionen-Promotion-Modal) |
| Lead-Statistiken [`/leads/statistics`] | KPI-Kacheln (Eingegangen, Konversion Lead→Projekt, Lead→Won, Reaktionszeit, Spam-Quote, Open-Leads >24h) · Aufschlüsselung nach Quelle/Verantwortlichem/Tag/Wochentag/Status · Trend-Charts mit Vorperioden-Vergleich · Date-Range-Selektor + Vergleichs-Toggle · Drill-Down → vorgefilterte Inbox · permission-aware (Verantwortlichen-Aufschlüsselung nur mit `leads.read_all`) | A2 + KPI-Kit |
| Quellen-Verwaltung [`/admin/lead-sources`] | Quellen-Liste (Name, Typ System/Custom, 30-Tage-Lead-Count, Status) · Custom-Quelle anlegen (Name, Display-Label, optional Default-Verantwortlicher/Default-Tags) · Edit/Archivieren · **Webhook-URL mit Token** (Fremd-Website-Leads) | A2 / A6 |
| Anti-Spam-Settings [`/admin/lead-anti-spam`] | Hard-Limit pro Quelle/Stunde + pro IP/Stunde · Anomalie-Detection (10×-Spike → Auto-Pause) · Auto-Mark-as-Spam-Heuristiken als Toggles (IP-Blocklist, Disposable-Domain, Honeypot, <3s-Submit) · Quarantäne- vs. Vollständig-Spam-Modus · `lost`-Auto-Lösch-Frist (0 = nie) | A6 |
| Manueller Lead-Eintrag [`/leads/new`] | Vor-/Nachname, Email, Telefon, Message, Quelle (Default manual), Verantwortlicher (Default Self), Tags · Inline-Match-Check beim Tippen | A4 |
*(Lead-Promotion-Modal entfällt — ersetzt durch „Lead → Projekt". Kontakt-/Firmen-Listen, Custom-Felder-/Tag-/Duplikat-Admin → P6/D-CRM.)*
## Features (muss abgedeckt sein)
- [ ] Lead-Inbox als Arbeitsplatz (Status-Filter, Triage-Quick-Actions, Bulk, Real-time-Refresh)
- [ ] **Lead → Projekt bei Weiterverarbeitungsfreigabe** (kein Contact-Promotion-Modal); Vererbung + separater Kontakt-Verknüpfung
- [ ] Multi-Quellen-Marker (Form/Email/AirCall-Inbound/manuell/Custom)
- [ ] Status-Workflow (new/qualified/converted/lost/spam) + DSGVO-Auto-Lösch-Hinweis (spam 30 T, lost konfigurierbar)
- [ ] Anti-Spam-Settings (Rate-Limits, Anomalie-Pause, Quarantäne, Auto-Mark-Heuristiken)
- [ ] Statistiken-Page (KPI-Kacheln, Quellen-Aufschlüsselung, Trends) — permission-aware
- [ ] Permission-aware UI (`leads.*`); nicht-eigene Leads bei `read_own` unsichtbar (404 statt 403)
- [ ] Empty/Loading/Fehler/Permission-Denied-States (Klartext + Lösungs-Knopf)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Triage-Daten-Tabelle/Karten-Umschalter (sortierbar, cursor-paginiert 50/Page), Filter-Bar (Multi-Select Status/Quelle/Verantwortlicher, Date-Range, Tags, Custom-Feld-Filter), Toggle-Chips (Spam ausblenden / Konvertierte einblenden), Hinweis-Marker (Duplikat/Spam/Auto-promoviert), Inline-Quick-Action-Picker (Zuweisen/Status), Bulk-Action-Toolbar mit Klartext-Bestätigungen, Detail-Panel mit Inline-Edit, Weiterverarbeitungsfreigabe-Auswahl (ja/nein/unklar), Spam-Score-Anzeige mit Begründung, Match-Hinweis-Liste mit Sprung-Links, Re-Submission-Verlauf, DSGVO-Lösch-Countdown-Hinweis, Status-Wechsler, **„Lead → Projekt"-Flow** (Daten-Vererbungs-Vorschau + Pipeline-/Status-Wahl + separater Kontakt-Verknüpfungs-Picker mit Match), KPI-Kacheln, Bar-/Line-Charts mit Vorperioden-Delta, Drill-Down-Verlinkung, Webhook-URL-Feld mit Copy + Token, Anti-Spam-Toggle-Zeilen, Empty-/Loading-/Fehler-/Permission-Denied-States.
## Quellen (granular)
- `designer-briefs/P07-lead-inbox.md` (vollständiger Brief — 🔴 Pivot-Vorrang AD-20)
- `ENTITY-MODEL.md` → **Domäne 5: Projekt-zentrischer CRM-Kern** (Lead-Zeile + Lead→Projekt) — 🔴 **Pivot-Vorrang (AD-20)**: kein Promotion-Modal, `weiterverarbeitung_freigabe`, `konvertiert_projekt_id`/`verknuepfter_kontakt_id`
- `ROADMAP.md` → Phase 7 (+ Pivot-Note) · `REQUIREMENTS.md` → `REQ-lead-*` · `PHASE-SOURCES.md` → P7
- `_bmad-output/specs/M02-lead-inbox.md` (⚠ teils pre-pivot: „promovieren zu Contact"/4-Optionen-Modal überholt — ENTITY-MODEL hat Vorrang)
- Dev-Pendant: `ticket-docs/R-P7.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev: