docs: finalize P7 lead handoff and sync project

This commit is contained in:
david committed 2026-08-20 20:22:19 +02:00
1 parent d953a79e95
commit 058d72be72
43 files changed
+1685 -568

No files matched your search

+199 -105
View File
@@ -4,135 +4,229 @@ project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
typ: Flow
status: Validiert
subframe: ""
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: Validiert (Screen-Liste)
Subframe-Link: -
Canvas: [Canvas](<WF-P7 Leads.canvas>)
Stand: 2026-07-08
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. Kurzfassung
## 1. Verbindliche Quelle
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).
Für den aktuellen UI-Stand ist der bestehende Subframe-Flow die Single Source of Truth. Subframe wurde nur gelesen und nicht verändert.
---
## 2. Intent Check
| Frage | Antwort |
| Feld | Wert |
|---|---|
| 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 |
| 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.
---
## 3. Scope
## 2. Aktuelle Flow-Struktur
| 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
### Eingang, Arbeitsliste und Lead-Record
```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
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.
## 9. Screen-Pakete
### Anlage, Dubletten und Verwerfen
- [[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]]
```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.
---
## 10. Offene Fragen
## 3. Vollständiger Subframe-Bestand
- 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)
Die Spalte „Canvas-ID“ löst doppelte Subframe-Präfixe eindeutig auf. Maßgeblich bleiben Subframe-Name und UUID.
## Handoff-Check
| 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) |
- [x] Jeder Screen ist mit Umsetzung markiert.
- [x] Meldungs-/Error-State-Matrix ist ausgefüllt.
- [ ] Subframe-Link ist eingetragen. *(Subframe erst nach explizitem OK)*
---
## 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`.