Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,59 @@
# 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: