- WF-P6 Kontakte und Organisationen: Kontaktmodell validiert (ein Datensatz, Kontaktart = Rolle der Verknuepfung, Shell-Prinzip), Karteikarte als Detailseiten-Muster (Zweispalter + Reiter) - WF-P7 Leads: Triage-Inbox, Lead->Projekt als grosses Modal (+Bulk), CSV-Import-Wizard (Davids Delta/CR), Quellen + Spam-Schutz - WF-P4 Dateien: Teilen/Freigeben in v1 (intern + Link, Preset Mit mir geteilt) - Paket-Canvases auf Default-Kurven, MD-Verknuepfungen je Canvas Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
139 lines
7.0 KiB
Markdown
139 lines
7.0 KiB
Markdown
---
|
||
kind: wireframe-package
|
||
project: HiveGrid Screen Project
|
||
ticket: D-P7
|
||
package: WF-P7 Leads
|
||
typ: Flow
|
||
status: Validiert
|
||
subframe: ""
|
||
canvas: "WF-P7 Leads.canvas"
|
||
---
|
||
|
||
# WF-P7 Leads
|
||
|
||
Status: Validiert (Screen-Liste)
|
||
Subframe-Link: -
|
||
Canvas: [Canvas](<WF-P7 Leads.canvas>)
|
||
Stand: 2026-07-08
|
||
|
||
---
|
||
|
||
## 1. Kurzfassung
|
||
|
||
Der Lead-Eingang: Anfragen aus allen Quellen (Formular, E-Mail, Anruf, manuell, Webhook) landen automatisch in einer Triage-Liste. Dort wird sortiert, zugewiesen — und im Kern-Moment **»Zu Projekt machen«** startet die Kette Richtung Auftrag. Kontakt wird dabei separat verknüpft (kein altes Promotion-Modal, Pivot AD-20).
|
||
|
||
---
|
||
|
||
## 2. Intent Check
|
||
|
||
| Frage | Antwort |
|
||
|---|---|
|
||
| Welches Ticket/Modul ist betroffen? | D-P7, Dev-Pendant R-P7 |
|
||
| Was soll der Nutzer am Ende schaffen? | Keine Anfrage verlieren, Spam loswerden, schnell reagieren, gute Anfragen zu Projekten machen |
|
||
| Flow, Screen, Zustand oder Doku? | Triage-Liste + Detail + Konvertier-Modal + Statistiken + 2 Einstellungs-Seiten + Anlege-Modal |
|
||
| Welche Planning-Quellen wurden geprüft? | `ticket-docs/D-P7.md`, ENTITY-MODEL (Pivot), SCREEN-MAP §2, HiveGrid Map |
|
||
| Was ist sicher im Scope? | Alles oben + Anti-Spam + Webhook-Quellen |
|
||
| Was ist sicher nicht im Scope? | Kontakt-/Organisations-Listen (P6), Projekt-Welt (P8), Promotion-Modal (existiert nicht mehr) |
|
||
| Admin/Normalrolle-Unterschiede? | `leads.*`; bei `read_own` nur eigene (404); Statistiken-Aufschlüsselung nach Person nur mit `read_all` |
|
||
| Unsichere Annahmen? | Massen-Konvertierung (Bulk »Zu Projekt«): UI validiert, technische Machbarkeit mit Dev bestätigen |
|
||
|
||
---
|
||
|
||
## 3. Scope
|
||
|
||
| Punkt | Inhalt |
|
||
|---|---|
|
||
| Ticket/Modul | D-P7 · Lead-Eingang |
|
||
| Nutzerrolle | Maximalansicht (Admin) |
|
||
| Startpunkt | Sidebar »Leads« |
|
||
| Ziel | Anfrage triagiert → Projekt erstellt oder erledigt/Spam |
|
||
| Haupt-Archetyp | A2 Triage-Liste · A3 Detail · A5 Modal · A6 Settings · KPI-Kit |
|
||
| Bespoke-Anteil | Keiner |
|
||
| Out of scope | Kampagnen-/Marketing-Quellen-Details (P14) |
|
||
|
||
---
|
||
|
||
## 4. Entscheidungen (validiert 2026-07-08)
|
||
|
||
| Entscheidung | Status | Notiz |
|
||
|---|---|---|
|
||
| Ein Paket für das ganze Feature | genommen | inkl. Quellen + Spam-Schutz (leben unter Einstellungen → Arbeitsweise) |
|
||
| **Lead → Projekt als großes Modal** | genommen | Drei Sektionen: Daten-Vererbungs-Vorschau · Ziel-Board + Start-Spalte · Kontakt verknüpfen (Auto-Match oder neu via M01 aus P6). Man bleibt im Kontext der Liste |
|
||
| **Mehrfachauswahl / Massenbearbeitung** | genommen | Davids Ergänzung: Bulk-Zuweisen/Status/Spam/Archiv UND Massen-Konvertierung (Modal in Bulk-Variante: gemeinsame Board-Wahl, Kontakt-Match je Lead). Machbarkeit Bulk-Convert mit Dev bestätigen |
|
||
| Anfrage anlegen als Modal | genommen | Wie »Kontakt anlegen« (P6), mit Live-Duplikat-Check |
|
||
| **Inline-Anlegen (Plus → Zeile mit Pflichtfeldern)** | dokumentiert / später | Davids Idee — gemeinsames Muster mit P6 (D01 dort); »muss gut gemacht werden«, erstmal Modal |
|
||
| Spam standardmäßig ausgeblendet, Konvertierte ausgeblendet | genommen | Toggle-Chips laut Ticket |
|
||
| Pivot-Regel | genommen | Freigabe (ja/nein/unklar) am Lead; bei »ja« → Projekt; Kontakt separat verknüpft; Status new/qualified/converted/lost/spam |
|
||
| **CSV-Import-Wizard** | genommen — Davids Delta (2026-07-08) | Ganze Listen importieren: Datei hochladen → Spalten den Lead-Feldern zuordnen → Vorschau mit Fehlern/Duplikaten → Import. Steht NICHT im Dev-Ticket → als Change-Request/Delta an Dev |
|
||
|
||
### Happy Path
|
||
|
||
1. Anfrage kommt rein (Formular/Anruf/E-Mail) → erscheint live in der Inbox, ggf. mit Duplikat-/Spam-Marker.
|
||
2. Triage direkt in der Zeile: zuweisen, Status, oder Spam.
|
||
3. Gute Anfrage öffnen → Detail: Herkunft, Match-Hinweise (»könnte Kontakt X sein«), Freigabe auf »ja«.
|
||
4. **»Zu Projekt machen«** → Modal: Vorschau der übernommenen Daten, Board + Start-Spalte wählen, Kontakt verknüpfen (Match oder neu) → Projekt existiert, Lead = konvertiert.
|
||
5. Chef schaut in die Statistiken: Woher kommen Anfragen, wie schnell reagieren wir, was wird daraus?
|
||
|
||
### Meldungs-/Error-States (validiert)
|
||
|
||
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|
||
|---|---|---|---|---|
|
||
| Spam-Verdacht / mögliches Duplikat / auto-promoviert | Marker in der Zeile + Begründung im Detail | nein | Nur dokumentieren | Klartext-Begründung (»3 Anfragen in 1 Min von gleicher IP«) |
|
||
| Pflichtdaten fehlen beim Konvertieren (z. B. Name) | Mängel-Banner im Modal | ja (Aktion) | Nur dokumentieren | Felder direkt im Modal nachtragbar |
|
||
| DSGVO-Auto-Löschung | Countdown-Hinweis im Detail | nein | Nur dokumentieren | »Wird am [Datum] automatisch gelöscht« (Spam 30 T, lost konfigurierbar) |
|
||
| Fremder Lead bei `read_own` | unsichtbar / 404 | ja | Wiederverwenden | Dev-Vorgabe |
|
||
| Leere Inbox | Leer-Zustand | nein | Nur dokumentieren | »Keine neuen Anfragen« |
|
||
|
||
---
|
||
|
||
## 7. Validierte Screen-Liste
|
||
|
||
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|
||
|---|---|---|---|---|---|
|
||
| S01 | Lead-Inbox (Triage-Liste) | Liste | Bauen | `/leads` | Validiert |
|
||
| S02 | Lead-Detail | Detail | Bauen | `/leads/:id` | Validiert |
|
||
| M01 | Lead → Projekt ⭐ | Modal (groß, + Bulk-Variante) | Bauen | aus S01/S02 | Validiert |
|
||
| S03 | Lead-Statistiken | KPI-Seite | Bauen | `/leads/statistics` | Validiert |
|
||
| S04 | Quellen-Verwaltung | Settings-Liste | Bauen | `/admin/lead-sources` | Validiert |
|
||
| S05 | Spam-Schutz | Settings | Bauen | `/admin/lead-anti-spam` | Validiert |
|
||
| M02 | Anfrage anlegen | Modal | Bauen | aus S01 | Validiert |
|
||
| M03 | CSV-Import-Wizard | Modal/Wizard | Bauen | aus S01 | Validiert (Davids Delta) |
|
||
| D01 | Inline-Anlegen (Plus → Zeile) | Idee | Später | in S01 | Dokumentiert (gemeinsam mit P6) |
|
||
| D02–D06 | Marker/Banner/Zustände (s. Tabelle) | Inline | Nur dokumentieren | — | Validiert |
|
||
|
||
---
|
||
|
||
## 8. Grid
|
||
|
||
```text
|
||
Sidebar -> S01 (Inbox) -> S02 (Detail)
|
||
S01/S02 -> M01 (Lead -> Projekt; aus S01 auch als Bulk)
|
||
S01 -> M02 (+ Anfrage) / M03 (CSV-Import)
|
||
S01 -> S03 (Statistiken; Drill-Down zurueck in gefilterte Inbox)
|
||
Einstellungen -> S04 (Quellen) / S05 (Spam-Schutz)
|
||
M01 nutzt M01 aus P6 (Kontakt anlegen) fuer neue Kontakte
|
||
```
|
||
|
||
---
|
||
|
||
## 9. Screen-Pakete
|
||
|
||
- [[S01 Lead-Inbox]] · [[S02 Lead-Detail]] · [[M01 Lead zu Projekt]]
|
||
- [[S03 Lead-Statistiken]] · [[M02 Anfrage anlegen]] · [[M03 CSV-Import]]
|
||
- [[S04 Quellen-Verwaltung]] · [[S05 Spam-Schutz]]
|
||
|
||
---
|
||
|
||
## 10. Offene Fragen
|
||
|
||
- Massen-Konvertierung (Bulk »Zu Projekt«): technische Machbarkeit + Verhalten bei fehlenden Kontakt-Matches → Frage an Dev (beim Handoff)
|
||
- CSV-Import (M03): Davids Delta, steht nicht im Dev-Ticket → als Change-Request formulieren (Import-Job, Duplikat-Behandlung serverseitig)
|
||
- Ziel-Board-Vorauswahl im Konvertier-Modal (z. B. immer »Vertrieb«-Board als Default?) → beim Subframe-Bau
|
||
- Statistiken: welche KPI-Kacheln auf Seite 1 → beim Subframe-Bau (Ticket-Liste ist Obermenge)
|
||
|
||
## Handoff-Check
|
||
|
||
- [x] Jeder Screen ist mit Umsetzung markiert.
|
||
- [x] Meldungs-/Error-State-Matrix ist ausgefüllt.
|
||
- [ ] Subframe-Link ist eingetragen. *(Subframe erst nach explizitem OK)*
|