Plan Kern-Kette P6-P7 (Kontakte, Leads) + Datei-Teilen v1

- 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>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 23:17:54 +02:00
1 parent e48a5a46e8
commit ca078436df
28 files changed
+2424 -432

No files matched your search

@@ -0,0 +1,57 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: M01
screen: Lead zu Projekt
typ: Modal (gross)
umsetzung: Bauen
status: Validiert
route: "aus S01/S02, nur bei Freigabe = ja"
subframe: ""
---
# M01 — Lead → Projekt ⭐
## Ziel
Der Kern-Moment der Kette: aus einer guten Anfrage wird ein Projekt — kontrolliert, mit sauberem Kontakt dran.
## Was das Tool können muss
- **Daten-Vererbungs-Vorschau**: welche Lead-Felder ins Projekt fließen (Name, Nachricht, eigene Felder …)
- **Ziel-Board + Start-Spalte wählen** (Default-Vorauswahl beim Subframe-Bau klären)
- **Kontakt separat verknüpfen**: Auto-Match-Vorschlag (gleiche E-Mail/Telefon) → bestehenden wählen ODER neu anlegen (öffnet [[M01 Kontakt anlegen]] aus P6, vorbefüllt)
- Fehlende Pflichtdaten (z. B. Name) direkt im Modal nachtragen (Mängel-Banner)
- **Bulk-Variante** (Davids Ergänzung): mehrere Leads auf einmal — gemeinsame Board-Wahl, Kontakt-Match je Lead, Konfliktliste für Leads ohne Match
## Pattern / Archetyp
A5 großes Modal (echtes Modal: DialogLayout → Dialog → Dialog.Content) mit drei Sektionen.
## Aufbau
1. **Was wird übernommen** — Vorschau der vererbten Felder
2. **Wohin** — Pipeline/Board + Start-Spalte
3. **Wer** — Kontakt (Match-Vorschlag / suchen / neu anlegen)
## Aktionen
- »Projekt erstellen« → Projekt existiert, Lead wird `converted`, Sprung zur Projekt-Detailseite (Toast mit Link)
- Abbrechen
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Pflichtdaten fehlen | Mängel-Banner + Inline-Nachtragen | ja (Aktion) | Nur dokumentieren | z. B. fehlender Name |
| Bulk: Lead ohne Kontakt-Match | Konflikt-Zeile in Bulk-Ansicht | nein | Nur dokumentieren | einzeln nachziehen |
## Subframe
- (erst nach explizitem OK)
## Notizen
- Ersetzt das alte 4-Optionen-Promotion-Modal (Pivot AD-20). Bulk-Machbarkeit → Dev-Frage beim Handoff.
@@ -0,0 +1,42 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: M02
screen: Anfrage anlegen
typ: Modal
umsetzung: Bauen
status: Validiert
route: "aus S01 (Route /leads/new bleibt Dev-seitig)"
subframe: ""
---
# M02 — Anfrage anlegen
## Ziel
Anruf kommt rein, kein passender Kontakt — Anfrage in Sekunden erfassen.
## Was das Tool können muss
- Schnelles Erfassen: Vor-/Nachname, E-Mail, Telefon, Nachricht, Quelle (Default: manuell), Verantwortlicher (Default: ich), Tags
- **Live-Match-Check beim Tippen**: »Gibt es schon als Kontakt/Anfrage« mit Sprung-Link
## Pattern / Archetyp
A5 Dialog, gleiche Mechanik wie »Kontakt anlegen« (P6).
## Aktionen
- »Anlegen« → Anfrage erscheint in der Inbox, Detail öffnet
- Abbrechen
## Subframe
- (erst nach explizitem OK)
## Notizen
- Davids Delta: Modal statt eigener Seite (Ticket sah `/leads/new` als Seite vor — UI-Form ist Designer-Freiheit).
- D01 Inline-Anlegen (Plus → Zeile) als »Später«-Muster dokumentiert.
@@ -0,0 +1,47 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: M03
screen: CSV-Import
typ: Modal/Wizard
umsetzung: Bauen
status: Validiert (Davids Delta)
route: "aus S01, Importieren-Knopf"
subframe: ""
---
# M03 — CSV-Import-Wizard
## Ziel
Ganze Listen auf einmal reinholen (z. B. Messekontakte, Alt-Bestand) — mit sauberer Feld-Zuordnung statt Chaos. **Davids Delta: steht nicht im Dev-Ticket → Change-Request.**
## Was das Tool können muss
- CSV-Datei hochladen (Dropzone-Baustein aus P4)
- **Spalten-Zuordnung**: jede CSV-Spalte einem Lead-Feld zuordnen (Auto-Vorschlag bei passenden Überschriften, eigene Felder wählbar, Spalte überspringen möglich)
- **Vorschau vor dem Import**: erste Zeilen gemappt anzeigen, Fehler markieren (ungültige E-Mail, leere Pflichtwerte)
- **Duplikat-Behandlung wählen**: überspringen / trotzdem anlegen / als möglichs Duplikat markieren
- Import läuft im Hintergrund; Ergebnis-Meldung (»142 importiert, 3 übersprungen — Liste ansehen«)
## Pattern / Archetyp
A5 mehrstufiger Wizard: 1. Datei → 2. Spalten zuordnen → 3. Vorschau + Duplikat-Regel → 4. Import läuft/Ergebnis.
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Datei nicht lesbar / falsches Format | Schritt-Fehler | ja (Schritt) | Nur dokumentieren | Klartext + Beispiel-Hinweis |
| Zeilen mit Fehlern | markierte Zeilen in Vorschau | nein | Nur dokumentieren | »werden übersprungen« |
## Subframe
- (erst nach explizitem OK)
## Notizen
- Change-Request an Dev: Import-Job serverseitig, Duplikat-Logik, Feld-Mapping. Beim Handoff formulieren.
- Gleiches Wizard-Muster ist später für Kontakt-Import wiederverwendbar (nur notiert, nicht beauftragt).
@@ -0,0 +1,61 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: S01
screen: Lead-Inbox
typ: Triage-Liste
umsetzung: Bauen
status: Validiert
route: "/leads"
subframe: ""
---
# S01 — Lead-Inbox
## Ziel
Keine Anfrage verlieren: alles Eingehende an einem Ort, in Sekunden sortiert.
## Was das Tool können muss
- Anfragen aus **allen Quellen** automatisch empfangen (Formular, E-Mail, Anruf, manuell, Webhook) — live, ohne Neuladen
- Triage direkt in der Zeile: zuweisen, Status wechseln, **Zu Projekt machen**, als Spam markieren
- Mehrfachauswahl mit Massenbearbeitung (zuweisen/Status/Spam/Archiv) **inkl. Massen-Konvertierung** (Davids Ergänzung)
- Spam-Schutz sichtbar machen (Marker mit Begründung), ohne die Liste zu verstopfen
## Pattern / Archetyp
A2 Liste mit Triage-Akzenten, Tabelle/Karten-Umschalter, cursor-paginiert.
## Daten
- Zeile: Identität (Name, sonst E-Mail/Telefon, sonst Quelle+Datum) · Quellen-Marker · Status · Freigabe (ja/nein/unklar) · Verantwortlicher · Eingegangen (relativ < 7 T) · 80-Zeichen-Nachrichten-Vorschau
- Marker: »Mögliches Duplikat« · »Spam-Verdacht« · »Auto-promoviert«
- Filter: Status (Default new+qualified), Quelle, Verantwortlicher (inkl. »nicht zugewiesen«), Zeitraum, Tags, eigene Felder
- Toggle-Chips: **»Spam ausblenden« (Default an)** · **»Konvertierte einblenden« (Default aus)**
## Aktionen
- Zeile öffnen → [[S02 Lead-Detail]]
- Inline: Zuweisen · Status · **»Zu Projekt«** → [[M01 Lead zu Projekt]] · Spam
- Bulk: Zuweisen/Status/Spam/Archiv + **Bulk »Zu Projekt«** (M01 in Bulk-Variante)
- »+ Anfrage« → [[M02 Anfrage anlegen]] · »Importieren« → [[M03 CSV-Import]]
- »Statistiken« → [[S03 Lead-Statistiken]]
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | »Keine neuen Anfragen« | Nur dokumentieren |
| Laden / Fehler | A7 | Wiederverwenden |
| `read_own` | nur eigene sichtbar (server-seitig) | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
## Notizen
- D01 Inline-Anlegen (Plus → Zeile mit Pflichtfeldern) — gemeinsames »Später«-Muster mit P6.
@@ -0,0 +1,54 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: S02
screen: Lead-Detail
typ: Detail
umsetzung: Bauen
status: Validiert
route: "/leads/:id"
subframe: ""
---
# S02 — Lead-Detail
## Ziel
Eine Anfrage komplett verstehen und entscheiden: weiterverarbeiten, ablehnen oder Spam.
## Was das Tool können muss
- **Herkunft transparent machen**: welches Formular (mit Submission), welcher E-Mail-Header, welcher Anruf (mit Aufnahme-Link)
- **Freigabe-Entscheidung** festhalten (ja/nein/unklar) — bei »ja« wird »Zu Projekt« möglich
- **Match-Hinweise**: existierende Kontakte mit gleicher E-Mail/Telefon (harte Treffer) oder ähnlichem Namen (weiche) — mit Direktsprung
- Spam-Score mit Klartext-Begründung; Re-Submission-Verlauf (gleiche Person hat mehrfach angefragt)
## Pattern / Archetyp
A3 Detail — gleiches Grundgerüst wie die Kontakt-Karteikarte (Zweispalter + Reiter).
## Daten
- Kopf: Identität, Status, Freigabe-Schalter, Quellen-Marker · Triage-Quick-Actions (Annehmen / Antworten / Anrufen / Notiz / Aufgabe / Termin)
- Links: Stammdaten inline editierbar · eigene Felder · Match-Hinweise · DSGVO-Lösch-Countdown
- Rechts, Reiter: Übersicht/Nachricht · Konversation · Verlauf (Activity)
## Aktionen
- **»Zu Projekt«** → [[M01 Lead zu Projekt]] (nur bei Freigabe = ja; sonst Hinweis)
- Status wechseln (new/qualified/converted/lost/spam) · zuweisen
- Match-Hinweis → Kontakt-Karteikarte öffnen oder direkt verknüpfen
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| DSGVO-Countdown | »Wird am [Datum] automatisch gelöscht« | Nur dokumentieren |
| Nicht gefunden / kein Recht | 404 | Wiederverwenden |
| Laden / Fehler | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,45 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: S03
screen: Lead-Statistiken
typ: KPI-Seite
umsetzung: Bauen
status: Validiert
route: "/leads/statistics"
subframe: ""
---
# S03 — Lead-Statistiken
## Ziel
Der Chef sieht: Woher kommen Anfragen, wie schnell reagieren wir, was wird daraus?
## Was das Tool können muss
- KPI-Kacheln: Eingegangen · Umwandlung Lead→Projekt · Lead→Gewonnen · Reaktionszeit · Spam-Quote · offene Anfragen > 24 h
- Aufschlüsselung nach Quelle / Verantwortlichem / Tag / Wochentag / Status
- Trend-Charts mit Vergleich zur Vorperiode (Zeitraum-Wahl + Vergleichs-Schalter)
- **Drill-Down**: Klick auf eine Zahl → vorgefilterte Inbox
## Pattern / Archetyp
A2 + KPI-Kit (Kacheln, Balken-/Linien-Charts aus dem Baukasten).
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Zu wenig Daten | »Noch nicht genug Anfragen für Trends« | Nur dokumentieren |
| Laden / Fehler | A7 | Wiederverwenden |
## Permissions / Gates
Aufschlüsselung nach Verantwortlichem nur mit `leads.read_all`.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,40 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: S04
screen: Quellen-Verwaltung
typ: Settings-Liste
umsetzung: Bauen
status: Validiert
route: "/admin/lead-sources (Einstellungen -> Arbeitsweise)"
subframe: ""
---
# S04 — Quellen-Verwaltung
## Ziel
Steuern, woher Anfragen kommen — inkl. Anschluss fremder Websites.
## Was das Tool können muss
- Quellen-Liste: Name · Typ (System/eigene) · Anfragen der letzten 30 Tage · Status
- Eigene Quelle anlegen (Name, Anzeige-Label, optional Standard-Verantwortlicher + Standard-Tags)
- **Webhook-URL mit Token** je Quelle (Kopier-Knopf) — damit Fremd-Websites Anfragen direkt einliefern
- Bearbeiten / Archivieren
## Pattern / Archetyp
A2/A6 unter Einstellungen → Arbeitsweise.
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Laden / Fehler / kein Zugriff | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,41 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: S05
screen: Spam-Schutz
typ: Settings
umsetzung: Bauen
status: Validiert
route: "/admin/lead-anti-spam (Einstellungen -> Arbeitsweise)"
subframe: ""
---
# S05 — Spam-Schutz
## Ziel
Spam automatisch abfangen, ohne echte Anfragen zu verlieren — alles in Klartext einstellbar.
## Was das Tool können muss
- **Limits**: max. Anfragen pro Quelle/Stunde und pro IP/Stunde
- **Anomalie-Erkennung**: 10-facher Anstieg → Quelle pausiert automatisch (mit Benachrichtigung)
- **Auto-Spam-Regeln als Schalter**: IP-Sperrliste · Wegwerf-E-Mail-Domains · Honeypot-Feld · Absenden unter 3 Sekunden
- **Modus**: Quarantäne (landet markiert in der Inbox) vs. vollständig Spam (ausgeblendet)
- Auto-Lösch-Frist für verlorene Anfragen (0 = nie); Spam fix 30 Tage
## Pattern / Archetyp
A6 Settings mit Toggle-Zeilen (je Regel Klartext-Beschreibung).
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Laden / Fehler / kein Zugriff | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)