Files
HiveGrid-Wireframes/02 Wireframes/P7 Leads/WF-P7 Leads/WF-P7 Leads.md
T

233 lines
17 KiB
Markdown

---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
typ: Flow
status: Fertig / Development-Handoff
subframe: "https://app.subframe.com/f023064a5ca0/flow/69f745e5-4a15-4227-b9db-ec08c78fd6d7/edit"
canvas: "WF-P7 Leads.canvas"
source_checked: 2026-08-20
---
# WF-P7 Leads
Status: **Fertig / Development-Handoff** · finaler Subframe-Stand vollständig abgeglichen
Subframe: [Flow öffnen](https://app.subframe.com/f023064a5ca0/flow/69f745e5-4a15-4227-b9db-ec08c78fd6d7/edit)
Canvas: [Canvas öffnen](<WF-P7 Leads.canvas>)
Ticket: [D-P7 Leads](<../../../Tickets/Fertige Tickets/D-P7 Leads.md>)
Stand: 2026-08-20
---
## 1. Verbindliche Quelle
Für den aktuellen UI-Stand ist der bestehende Subframe-Flow die Single Source of Truth. Subframe wurde nur gelesen und nicht verändert.
| Feld | Wert |
|---|---|
| Projekt | `Basedesign` (`f023064a5ca0`) |
| Flow | `WF-P7 LeadListe` |
| Flow-ID | `69f745e5-4a15-4227-b9db-ec08c78fd6d7` |
| Bestand | 20 Subframe-Seiten |
| Abgleich | 2026-08-20 per MCP; nach Davids finalen Änderungen erneut 20/20 Seiten inklusive JSX gelesen, alle geänderten Hauptseiten und Dialogvarianten gerendert |
Die Screen-Namen, UUIDs, sichtbaren Inhalte, Komponenten und gebauten Varianten kommen direkt aus Subframe. Frühere Obsidian-Annahmen gelten nur noch dort, wo der aktuelle Flow sie sichtbar bestätigt. `S01 Arbeitsliste` wurde im finalen Stand neu angelegt und besitzt deshalb die neue UUID `ae41c6ea-d1b0-4656-9a5c-55f64343962a`.
Wichtig für die Flow-Kanten: Die exportierten `onClick`-Handler sind leer. Die Canvas-Verbindungen zeigen deshalb sichtbare Auslöser und naheliegende Beziehungen. Wo das Ergebnis einer Aktion im Screen nicht eindeutig ist, ist es als offen markiert und nicht als bereits verdrahtete Navigation behauptet.
---
## 2. Aktuelle Flow-Struktur
### Eingang, Arbeitsliste und Lead-Record
```text
S02 Eingang Karten <-> S02 Eingang Liste
| Übernehmen / Zuweisen
v
S01 Arbeitsliste -> S03 Lead-Record -> M01 Konversion -> Deal im Vertriebsboard
| |
v +-> M04 Nächste Aktion
V01 Abarbeiten-Modus +-> M06 Dialer -> V02 / V03 / V05
+-> M07 E-Mail -> V06 / V07
+-> M08 Ansprechpartner hinzufügen
```
- **Eingang** ist die Triage für neue, noch nicht übernommene Anfragen. Karten- und Listenansicht zeigen dieselben drei Beispieldatensätze mit Filtern, Zuweisungsvorschlägen, Mehrfachauswahl und Verwerfen. Für den Handoff gilt: `Übernehmen` weist den Lead der handelnden Person zu, `Zuweisen` einer gewählten Person; beide führen in die Arbeitsliste.
- **Arbeitsliste** priorisiert bereits aktive Leads nach Fälligkeit bzw. Handlungsbedarf. Gruppierungen sind Fälligkeit, Zuständig, Anfragenart, Kundentyp oder keine Gruppierung.
- **Lead-Record** ist die zentrale Bearbeitungsseite mit Kontaktdaten, nächster Aktion, Kommunikationsverlauf, Lead-Details und Ansprechpartnern.
- **Abarbeiten-Modus** ist im aktuellen Subframe-Bestand als schmale Fortschrittsleiste gebaut; die darunterliegende Lead-Ansicht ist in dieser Seite nicht enthalten.
### Anlage, Dubletten und Verwerfen
```text
S01/S02 -> M02 Lead anlegen
| Ansprechpartner neu / bestehenden verknüpfen
+-> M02 Lead anlegen Kontakt verknüpfen
+-> M03 Dubletten-Prüfung
S02 -> V08 Verwerfen bestätigen
S02 -> M05 Ansicht speichern
```
- M02 unterscheidet Privatperson und Firma und verlangt laut Copy mindestens einen Kontaktweg.
- Die Kontakt-Verknüpfungsvariante sucht bestehende Kontakte direkt im Anlage-Dialog.
- M03 vergleicht neuen und bestehenden Datensatz bei gleicher Telefonnummer und bietet getrenntes Anlegen oder Zusammenführen.
- V08 ist eine irreversible Verwerfen-Bestätigung für den Eingang.
### Kommunikation
- M07 ist ein schwebender E-Mail-Composer mit Empfänger, Cc/Bcc, Betreff, Rich-Text-Werkzeugen, Anhang, Vorlagen, Entwurfsstatus und geplantem Versand.
- V06 und V07 zeigen denselben Composer minimiert bzw. im Vollbild.
- M06 ist ein schwebender Dialer mit Rufnummer, Notiz, Gesprächsergebnis, Stimmung und Protokollierung am Lead.
- V02, V03 und V05 zeigen Tastenfeld, aktives Gespräch und kompakte Ansicht.
---
## 3. Vollständiger Subframe-Bestand
Die Spalte „Canvas-ID“ löst doppelte Subframe-Präfixe eindeutig auf. Maßgeblich bleiben Subframe-Name und UUID.
| Canvas-ID | Subframe-Seite | Typ / Rolle | Screen-MD | Subframe |
|---|---|---|---|---|
| S01 | S01 Arbeitsliste | priorisierte Arbeitsliste | [MD](<Screens/S01 Arbeitsliste.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/ae41c6ea-d1b0-4656-9a5c-55f64343962a/edit) |
| M05 | M05 Ansicht speichern | Filteransicht speichern | [MD](<Screens/M05 Ansicht speichern.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/c011c64f-df15-42c2-b920-66f0ebea87fd/edit) |
| S03 | S03 Lead-Record | zentrale Lead-Detailansicht | [MD](<Screens/S03 Lead-Record.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/6c173984-ea71-4d85-b53e-ebc397b3c821/edit) |
| V01 | V01 Abarbeiten-Modus | Fortschritts-/Arbeitsmodus | [MD](<Screens/V01 Abarbeiten-Modus.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/f2451766-d918-49b2-8c77-913e4817d31a/edit) |
| M08 | M08 Ansprechpartner hinzufuegen | Kontakt verknüpfen/anlegen | [MD](<Screens/M08 Ansprechpartner hinzufuegen.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/c7949b46-6b91-47ec-b08c-959f686df55b/edit) |
| S02-K | S02 Eingang Karten | Eingang · Kartenansicht | [MD](<Screens/S02 Eingang Karten.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/165bfa17-8792-4616-bfb6-d064bc7352a8/edit) |
| S02-L | S02 Eingang Liste | Eingang · Listenansicht | [MD](<Screens/S02 Eingang Liste.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/24d7b73c-39f4-4c74-adf4-8493861adb68/edit) |
| M01 | M01 Konversion | Lead in Deal umwandeln | [MD](<Screens/M01 Konversion.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/1609485c-d315-4cdf-8e41-ad1dfb0b2691/edit) |
| M02 | M02 Lead anlegen | Lead-Anlage | [MD](<Screens/M02 Lead anlegen.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/14a837e3-c2f7-4289-9ae4-d9427935e74f/edit) |
| M02-K | M02 Lead anlegen Kontakt verknuepfen | Anlage · bestehender Kontakt | [MD](<Screens/M02 Lead anlegen Kontakt verknuepfen.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/75858347-70f9-4233-99f6-e72f0852ccab/edit) |
| M07 | M07 E-Mail schreiben | schwebender E-Mail-Composer | [MD](<Screens/M07 E-Mail schreiben.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/9a4d7a13-73e3-412d-8beb-0c6dfcc7617c/edit) |
| V06 | V06 E-Mail minimiert | Composer · minimiert | [MD](<Screens/V06 E-Mail minimiert.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/25f763a3-8146-4330-97a5-394510ac0b17/edit) |
| V07 | V07 E-Mail Vollbild | Composer · Vollbild | [MD](<Screens/V07 E-Mail Vollbild.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/20deb403-a0a8-48aa-944b-65a7c464fa7b/edit) |
| M03 | M03 Dubletten-Pruefung | Dublettenentscheidung | [MD](<Screens/M03 Dubletten-Pruefung.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/36fb8b6a-bced-44a3-b8bd-76ae3ecf7cdd/edit) |
| V08 | V08 Verwerfen bestaetigen | irreversible Bestätigung | [MD](<Screens/V08 Verwerfen bestaetigen.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/ecc9c8b6-ab3a-4dc3-82d2-6f98f2829344/edit) |
| M04 | M04 Naechste Aktion | Reminder/Aufgabe setzen | [MD](<Screens/M04 Naechste Aktion.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/9b3a7954-384f-42ed-9b04-934f30adbc0f/edit) |
| M06 | M06 Dialer | Dialer · Ausgangszustand | [MD](<Screens/M06 Dialer.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/dcd35b81-dce7-4257-be0d-8755adeffe8b/edit) |
| V02 | V02 Dialer Tastenfeld | Dialer · Tastenfeld | [MD](<Screens/V02 Dialer Tastenfeld.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/8960b4b1-cecb-4050-a322-2e8e0b30f0ad/edit) |
| V03 | V03 Dialer Im Gespraech | Dialer · aktives Gespräch | [MD](<Screens/V03 Dialer Im Gespraech.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/b81072df-5ffd-45b9-959e-166a830807e6/edit) |
| V05 | V05 Dialer kompakt | Dialer · kompakt | [MD](<Screens/V05 Dialer kompakt.md>) | [Subframe](https://app.subframe.com/f023064a5ca0/design/b9ea58a5-7e98-435f-8a5b-e696cbc2709b/edit) |
---
## 4. Fachlicher Stand aus dem aktuellen JSX
### Eingang
- Karten- und Listenansicht tragen denselben Titel und dieselbe Erklärung: neue Anfragen werden zuerst gesichtet und zugeteilt, bevor sie in die Arbeitsliste wandern.
- Filter/Preset-Inhalte: Freitext, Dringlichkeit, Anfragenart, Region und Kanal; zusätzliche Filter für Status, Tags, Verantwortlich, Zeitraum, Priorität und Erstellt am; Presets Heute, Diese Woche, Alle offenen und Meine Projekte.
- Sichtbare Lead-Daten: Priorität, Name, Kurzbeschreibung, Kanal, potenzieller Wert, Region, Telefonnummer, Anfragenart, Eingangszeit und vorgeschlagene zuständige Person.
- Einzelaktionen: Übernehmen, Zuweisen, Öffnen und Verwerfen. Mehrfachaktionen: Löschen, Übernehmen und Zuweisen.
### Arbeitsliste
- FilterBar mit Freitext und aktiven Chips für Status, Tags, Verantwortlich und Zeitraum; Presets Heute, Diese Woche, Alle offenen und Meine Projekte.
- Spalten: Lead, Anfragenart, Priorität, Nächste Aktion, Zuständig und Wert.
- Gruppierungen: Fälligkeit, Zuständig, Anfragenart, Kundentyp oder keine.
- Gebaute Fälligkeitsgruppen: Überfällig, Neu · unbearbeitet, Rückruf zugesagt, Heute fällig und Droht kalt zu werden.
- Zeilen zeigen Name/Firma, Kurzbeschreibung, Anfragenart, vierstufige Prioritätsanzeige samt Badge, nächste Aktion/Fälligkeit, Avatar/Owner und potenziellen Wert.
### Lead-Record
- Kopf: Breadcrumb Leads → Lead, Initialen, Name, Statusbadge, Hinweis `zeitkritisch`, Kundentyp/Ort, Anfragenart und `Qualifiziert zu Deal`.
- Schnellaktionen: Anrufen, WhatsApp, Mail, Task und Datei.
- Linke Spalte: Ansprechpartner, Beziehung, Telefon, E-Mail, Straße, Hausnummer, PLZ, Ort und Region; darunter Kommunikationsstatistik.
- Mitte: Anstehende Aufgabe/Reminder, Inline-Erfassung für Notiz/E-Mail/Anruf/WhatsApp und chronologischer Verlauf.
- Rechte Spalte: Status, Owner, potenzieller Wert, Priorität, Quelle, nächste Aktion, Engagement, Erfasst, Tags und Ansprechpartner.
- Verlaufseinträge besitzen Bearbeiten/Löschen-Menüs. Tags und viele Stammdaten sind als direkt bearbeitbare Felder angelegt.
### Konversion
- M01 wandelt den Lead in einen `Deal` auf dem Vertriebsboard um.
- Sichtbares verlustfreies Mapping: Ansprechpartner, Telefon/E-Mail, Quelle, Projekttyp, potenzieller Wert, Owner sowie Verlauf/Notizen → Deal-Timeline.
- Kontaktübernahme ist per Checkbox wählbar. Ziel-Board und Startstatus sind im aktuellen Dialog nicht auswählbar.
### Anlage und Dubletten
- M02 enthält Privatperson/Firma, Projektname, Firmenname, Telefon, E-Mail, Ansprechpartner, Quelle, Projekttyp, Priorität und Tags.
- Die Firma-Variante bietet Ansprechpartner neu anlegen oder bestehenden Kontakt suchen/verknüpfen.
- M03 vergleicht bei identischer Telefonnummer Name, Telefon, Quelle und Anliegen; Entscheidungen sind getrennt anlegen oder zusammenführen.
### Nächste Aktion, E-Mail und Telefon
- M04 setzt Aufgabe, optionale Notiz, Datum und Uhrzeit; der Reminder erscheint in `Anstehend`.
- E-Mail: Empfänger, Cc/Bcc, Betreff, Rich-Text-Toolbar, Variablen/Einfügewerkzeuge, Anhang, Vorlagen, Sofort- oder Zeitversand, Entwurfsstatus und Löschen.
- Dialer: Kontakt und Rufnummer, ausgehende Nummer, Tastenfeld, Gesprächsnotiz, Ergebnis, Stimmung, Gesprächsdauer, Stummschalten, Auflegen sowie `Protokollieren & abschließen`.
---
## 5. Gebaute Zustände und Varianten
| Auslöser / Zustand | Gebaute Seite | Sichtbares Ergebnis |
|---|---|---|
| Eingang als Karten oder Liste | S02-K / S02-L | gleiche Triage-Daten in zwei Darstellungen |
| Filterkombination sichern | M05 | benannte Ansicht speichern |
| sequenziell arbeiten | V01 | Fortschritt, Überspringen, Erledigt, Schließen |
| Lead in Deal umwandeln | M01 | Mapping-Vorschau und Kontaktübernahme |
| bestehenden Ansprechpartner verwenden | M02-K / M08 | Suche, Auswahl, Rolle und Hauptkontakt |
| gleiche Telefonnummer | M03 | getrennt anlegen oder zusammenführen |
| Lead aus Eingang verwerfen | V08 | irreversible Bestätigung |
| nächste Aktivität planen | M04 | Aufgabe/Notiz mit Datum und Uhrzeit |
| E-Mail schreiben | M07 / V06 / V07 | normal, minimiert und Vollbild |
| anrufen | M06 / V02 / V03 / V05 | normal, Tastenfeld, im Gespräch und kompakt |
---
## 6. Finaler UI-Stand und Development-Folgethemen
Mit Davids Finalisierungsanweisung vom 2026-08-20 gilt der aktuelle Subframe-Flow als validierter UI-Stand für den Development-Handoff. Die folgenden Abweichungen zur älteren Planung bleiben bewusst sichtbar, blockieren aber nicht den Abschluss dieses Screen-Tickets.
### Geltender finaler UI-Stand
1. **Konversion zu Deal:** M01 verwendet `Qualifiziert zu Deal` und `In Deal umwandeln` und legt auf dem festen Vertriebsboard an. Der frühere Vertrag `Lead → Projekt` mit Ziel-Pipeline/Startstatus ist nicht Teil des finalen P7-UI-Flows.
2. **Keine separate Weiterverarbeitungsfreigabe:** `ja / nein / unklar` ist im finalen Lead-Record nicht als eigenes Feld oder Gate gebaut.
3. **Kein frei wählbares Konversionsziel:** Ziel-Board und Startstatus werden in M01 nicht ausgewählt.
4. **Separate Folgethemen:** Lead-Statistiken, Quellen-Verwaltung, Anti-Spam-Settings und CSV-Import besitzen im finalen 20-Seiten-Flow keine Seite. Sie bleiben als eigene Produkt-/Ticketkandidaten erhalten.
5. **Nicht im finalen Record enthalten:** Quellen-Detail, Spam-Score/Begründung, Match-Hinweise, Re-Submission-Verlauf, DSGVO-Löschdatum und der frühere vollständige Status-Workflow.
### QA- und Umsetzungshinweise
- M02 nennt Fax als zulässigen Kontaktweg, zeigt aber kein Fax-Feld.
- S03 zeigt den Lead Thomas Klein, listet rechts jedoch Ansprechpartner der Reithofer Immobilien GmbH. Der Beispieldatensatz ist fachlich nicht konsistent.
- M04 zeigt gleichzeitig unterschiedliche Datumszustände (Kalenderauswahl, Datumstext und `Noch kein Termin gewählt`).
- S02 enthält das Preset `Meine Projekte`, obwohl der Screen neue Leads/Anfragen zeigt.
- V01 enthält nur die Abarbeiten-Leiste; der aktive Lead darunter ist in der gebauten Seite nicht enthalten.
- S01 besitzt Auswahl-Checkboxen, aber keinen gebauten Mehrfachaktionszustand.
- Die Dialer-Ergebnisse mischen deutsche und englische Taxonomie (`Gatekeeper`, `Rescheduling`); Development sollte die finale Fachwortliste mit Produkt abstimmen.
- Die exportierten Handler sind leer. Für Development gilt die oben dokumentierte Handoff-Logik für `Übernehmen` und `Zuweisen`.
### Nicht gebaute Standardzustände
Im finalen 20-Seiten-Flow gibt es keine eigenen Empty-, Loading-, Fehler-, Permission- oder Erfolgsseiten für Eingang, Arbeitsliste, Lead-Record, Versand, Anruf oder Konversion. Development verwendet dafür die bestehenden Standardmuster; neue eigene Screens wären ein späterer Produktumfang.
Der vollständige Abgleich der bisherigen Produktanforderungen mit dem aktuellen UI ist unter [Produktvertrag-Deltas](<Backlog/Produktvertrag-Deltas.md>) konserviert.
---
## 7. Bereinigter Altbestand
- Die frühere 8-Screen-Planung wurde durch den tatsächlichen 20-Seiten-Bestand ersetzt.
- `S01 Lead-Inbox` wurde fachlich in `S02 Eingang` und `S01 Arbeitsliste` aufgeteilt.
- `S02 Lead-Detail` wurde durch `S03 Lead-Record` ersetzt.
- Das frühere große `Lead → Projekt`-Modal mit Board-/Spaltenwahl und Bulk-Variante ist nicht mehr als aktueller Screen dokumentiert; maßgeblich ist M01 Konversion aus Subframe.
- Lead-Statistiken, Quellen-Verwaltung, Spam-Schutz, CSV-Import und die abweichenden Vertragsanforderungen bleiben unter [Backlog](<Backlog/README.md>) erhalten, sind aber nicht als aktuelle Subframe-Screens markiert.
- Routen sind im aktuellen Subframe-Code nicht hinterlegt und deshalb nicht als verifizierte Fakten weitergeführt.
---
## 8. Handoff-Check
- [x] Alle 20 aktuellen Subframe-Seiten haben eine Screen-Datei.
- [x] Alle 20 Screen-Dateien enthalten UUID, direkten Link und Abgleichdatum.
- [x] Paket-MD, Tracker und Canvas verwenden denselben 20-Seiten-Bestand.
- [x] Subframe wurde nur gelesen und nicht verändert.
- [x] Alte, nicht mehr belegte Planung wurde sichtbar geparkt statt still als gebaut weitergeführt.
- [x] Alle echten Dialogseiten importieren `Dialog` und enthalten `Dialog.Content`; Dialer und E-Mail sind bewusst schwebende Panels.
- [x] Davids finaler Subframe-Stand ist als geltende UI-Entscheidung dokumentiert; ältere Vertragsdeltas bleiben als Folgethemen erhalten.
- [x] Nicht gebaute Standardzustände sind als Development-Wiederverwendung statt als eigene P7-Screens eingeordnet.
- [x] Das fertige Tickethandoff liegt unter `Tickets/Fertige Tickets/D-P7 Leads.md`.