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

@@ -0,0 +1,43 @@
---
kind: planning-gap
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: GAP-CSV
screen: CSV-Import-Wizard
status: Nicht im aktuellen Subframe-Flow
route: ""
subframe: ""
source_checked: 2026-08-20
---
# Offenes Delta — CSV-Import-Wizard
## Bisher geplantes Ziel
Lead-Listen aus Messekontakten oder Altbestand mit kontrollierter Feldzuordnung importieren. Dieser Punkt war Davids Delta und stand nicht im ursprünglichen Dev-Ticket.
## Bisher geplanter Umfang
1. CSV-Datei hochladen.
2. Spalten Lead-Feldern zuordnen; Auto-Vorschläge, eigene Felder und Überspringen.
3. Vorschau mit fehlerhaften Zeilen und Duplikaten.
4. Duplikatregel: überspringen, trotzdem anlegen oder markieren.
5. Import im Hintergrund mit Ergebnisübersicht.
## Bisher geplantes Pattern
A5 als vierstufiger Wizard: Datei → Spalten zuordnen → Vorschau und Duplikatregel → Import/Ergebnis. Die Dropzone sollte das P4-Dateimuster wiederverwenden.
## Bisher geplante Meldungen
| Ereignis | UI-Form | Blockiert? | Copy / Notiz |
|---|---|---|---|
| Datei nicht lesbar oder falsches Format | Schritt-Fehler | ja, nur diesen Schritt | Klartext plus Beispiel-Hinweis |
| Zeilen mit Fehlern | Markierung in der Vorschau | nein | `werden übersprungen` |
Das Wizard-Muster war außerdem als spätere Wiederverwendung für den Kontaktimport notiert. Serverseitiger Import-Job, Duplikatlogik und Feld-Mapping wären ein Change-Request an Development.
## Abgleich 2026-08-20
Im finalen 20-Seiten-Flow `WF-P7 LeadListe` existiert kein CSV-Import. Er bleibt als separater Change-Request-Kandidat erhalten, ist kein aktueller Subframe-Screen und blockiert den abgeschlossenen P7-Screen-Handoff nicht.
@@ -0,0 +1,36 @@
---
kind: planning-gap
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: GAP-STAT
screen: Lead-Statistiken
status: Nicht im aktuellen Subframe-Flow
route: "/leads/statistics"
subframe: ""
source_checked: 2026-08-20
---
# Offenes Delta — Lead-Statistiken
## Bisher geplantes Ziel
Der Chef sieht, woher Anfragen kommen, wie schnell reagiert wird und was aus Leads wird.
## Bisher geplanter Umfang
- KPI-Kacheln: Eingegangen, Konversion Lead → Projekt, Lead → Gewonnen, Reaktionszeit, Spam-Quote und offene Anfragen über 24 Stunden.
- Aufschlüsselung nach Quelle, Verantwortlichem, Tag, Wochentag und Status.
- Trend-Charts mit Vorperioden-Vergleich.
- Drill-down in eine vorgefilterte Inbox.
- Verantwortlichen-Auswertung nur mit `leads.read_all`.
## Bisher geplantes Pattern und Zustände
- A2 mit KPI-Kit: Kacheln sowie Balken-/Linien-Charts aus dem Baukasten.
- Bei zu wenig Daten: `Noch nicht genug Anfragen für Trends`.
- Laden und Fehler über den wiederverwendbaren A7-Zustand.
## Abgleich 2026-08-20
Im finalen 20-Seiten-Flow `WF-P7 LeadListe` existiert keine Statistikseite. D-P7/R-P7 beschreiben sie weiterhin und das Backend nennt Statistik-Aggregate. Sie bleibt ein separater Ticketkandidat und blockiert den abgeschlossenen P7-Screen-Handoff nicht.
@@ -0,0 +1,61 @@
---
kind: planning-gap
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: GAP-CONTRACT
screen: Produktvertrag-Deltas
status: Separates Produkt-/Development-Folgethema
route: ""
subframe: ""
source_checked: 2026-08-20
---
# Offenes Delta — Produktvertrag versus aktueller Subframe-Flow
Subframe ist die Single Source of Truth für den gebauten UI-Stand. Diese Datei bewahrt davon abweichende Anforderungen aus D-P7, R-P7, AD-20 und der bisherigen Obsidian-Planung. Sie behauptet nicht, dass diese Punkte gebaut sind.
## Eingang
Früher verbindlich bzw. geplant, im aktuellen S02 nicht oder nicht vollständig sichtbar:
- Anfragen aus Formular, E-Mail, Anruf, manueller Anlage und Webhook live ohne Neuladen.
- Quellen-Marker, vollständiger Lead-Status, Weiterverarbeitungsfreigabe `ja/nein/unklar`, Spam-Begründung, Duplikat- und Auto-Promoted-Marker.
- Filter für nicht zugewiesen, eigene Felder und die Toggle-Chips `Spam ausblenden` sowie `Konvertierte einblenden`.
- Bulk-Aktionen für Status, Spam, Archiv und Konversion; cursor-basierte Pagination.
- Zustände für leer, Laden, Fehler und `read_own`.
Der aktuelle Eingang baut Karten-/Listenansicht, Filter/Presets, Löschen, Übernehmen und Zuweisen. Ob und wie `Übernehmen` bzw. `Zuweisen` in die Arbeitsliste überführt, ist im statischen Export nicht verdrahtet.
## Lead-Record
Früher verbindlich bzw. geplant, im aktuellen S03 nicht sichtbar:
- Quellen-Detail je Eingangstyp, etwa Formular-Submission, E-Mail-Header oder Anrufaufnahme.
- Freigabeentscheidung als Gate für die Konversion.
- Harte und weiche Kontakt-Matches mit Direktverknüpfung.
- Spam-Score mit Klartextbegründung und Re-Submission-Verlauf.
- DSGVO-Löschdatum sowie vollständige Statusfolge `new/qualified/converted/lost/spam`.
- 404-/Permission-, Lade- und Fehlerzustände.
## Konversion
Der bisherige Produktvertrag verlangt:
1. Lead → Projekt statt Lead → Deal.
2. Vorschau der zu übernehmenden Lead-Felder.
3. Ziel-Board bzw. Pipeline und Startspalte/-status auswählen.
4. Kontakt per Match übernehmen, suchen oder vorbefüllt neu anlegen.
5. Fehlende Pflichtdaten direkt im Dialog ergänzen.
6. Bulk-Variante mit gemeinsamer Zielwahl und Konfliktliste je Lead.
7. Nach Erfolg Leadstatus `converted` und Sprung zur Projekt-Detailseite.
Das aktuelle M01 zeigt stattdessen ein verlustfreies Mapping in einen Deal auf dem fest vorgegebenen Vertriebsboard und eine Checkbox zur Kontaktübernahme. Diese Differenz ist vor dem Development-Handoff zu entscheiden.
## Manuelle Anlage
Die alte Planung sah zusätzlich Verantwortlich mit Default `ich`, eine Live-Match-Prüfung während der Eingabe und das anschließende Öffnen des Details vor. Das aktuelle M02 bietet dagegen Privatperson/Firma, Projekt-/Firmenname, Kontakt, Quelle, Projekttyp, Priorität und Tags; die Dublettenentscheidung ist als nachgelagertes M03 gebaut.
## Einordnung nach dem finalen Handoff
Davids Finalisierungsanweisung vom 2026-08-20 bestätigt den aktuellen Subframe-Stand als geltenden P7-UI-Handoff. Die hier konservierten Abweichungen sind keine offenen Entscheidungen innerhalb dieses Screen-Tickets mehr. Falls sie weiterverfolgt werden, erhalten sie einen ergänzenden Flow oder ein eigenes Produkt-/Development-Ticket.
@@ -0,0 +1,34 @@
---
kind: planning-gap
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: GAP-SOURCES
screen: Quellen-Verwaltung
status: Nicht im aktuellen Subframe-Flow
route: "/admin/lead-sources"
subframe: ""
source_checked: 2026-08-20
---
# Offenes Delta — Quellen-Verwaltung
## Bisher geplantes Ziel
Steuern, woher Anfragen kommen, einschließlich fremder Websites.
## Bisher geplanter Umfang
- Quellen-Liste mit Name, Typ System/eigene Quelle, Lead-Anzahl der letzten 30 Tage und Status.
- Eigene Quelle mit Anzeige-Label, Standard-Verantwortlichem und Standard-Tags anlegen.
- Webhook-URL mit Token kopieren.
- Bearbeiten und archivieren.
## Bisher geplantes Pattern und Zustände
- A2/A6 unter Einstellungen → Arbeitsweise.
- Laden, Fehler und fehlender Zugriff über den wiederverwendbaren A7-Zustand.
## Abgleich 2026-08-20
Im finalen 20-Seiten-Flow `WF-P7 LeadListe` existiert keine Quellen-Verwaltung. D-P7/R-P7 und die bestehende Admin-Route beschreiben sie weiterhin. Sie bleibt ein separater Settings-/Ticketkandidat und blockiert den abgeschlossenen P7-Screen-Handoff nicht.
@@ -0,0 +1,20 @@
---
kind: planning-gap-index
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
status: Separate Folgethemen
source_checked: 2026-08-20
---
# P7 — Separate Folgethemen außerhalb des finalen Subframe-Flows
Diese Themen waren vor dem Subframe-Abgleich als aktuelle P7-Screens oder verbindliche Produktanforderungen geplant. Sie bleiben erhalten, damit Produkt-/Dev-Anforderungen nicht still verloren gehen.
- [[Produktvertrag-Deltas]] — Anforderungen, die vom aktuellen UI abweichen oder dort nicht sichtbar sind
- [[Lead-Statistiken]]
- [[Quellen-Verwaltung]]
- [[Spam-Schutz]]
- [[CSV-Import-Wizard]]
Sie sind keine aktuellen Tracker-Screens. Die letzten vier Themen besitzen im finalen Flow keine Seite; der ältere Produktvertrag hat mit M01 zwar ein UI-Gegenstück, weicht aber beim Zielmodell ab. Diese Punkte blockieren den abgeschlossenen D-P7-Screen-Handoff nicht und werden bei Bedarf als eigene Produkt-/Development-Tickets entschieden.
@@ -0,0 +1,35 @@
---
kind: planning-gap
project: HiveGrid Screen Project
ticket: D-P7
package: WF-P7 Leads
id: GAP-SPAM
screen: Spam-Schutz
status: Nicht im aktuellen Subframe-Flow
route: "/admin/lead-anti-spam"
subframe: ""
source_checked: 2026-08-20
---
# Offenes Delta — Spam-Schutz
## Bisher geplantes Ziel
Spam automatisch abfangen, ohne echte Anfragen zu verlieren.
## Bisher geplanter Umfang
- Limits pro Quelle/Stunde und IP/Stunde.
- 10-facher Anstieg pausiert eine Quelle automatisch und benachrichtigt Admins.
- Schalter für IP-Sperrliste, Wegwerf-Domains, Honeypot und Absenden unter drei Sekunden.
- Quarantäne versus vollständig Spam.
- Auto-Löschfrist für verlorene Leads; Spam 30 Tage.
## Bisher geplantes Pattern und Zustände
- A6 Settings mit Toggle-Zeilen und Klartextbeschreibung je Regel.
- Laden, Fehler und fehlender Zugriff über den wiederverwendbaren A7-Zustand.
## Abgleich 2026-08-20
Im finalen 20-Seiten-Flow `WF-P7 LeadListe` existieren weder Spam-Schutz-Settings noch Spam-Score/Begründung im Lead-Record. D-P7/R-P7 und die bestehende Admin-Route beschreiben diese Funktion weiterhin. Sie bleibt ein separater Ticketkandidat und blockiert den abgeschlossenen P7-Screen-Handoff nicht.