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,49 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: M01
screen: Kontakt anlegen
typ: Modal
umsetzung: Bauen
status: Validiert
route: "aus S01 + ueberall (z. B. Lead-Konvertierung)"
subframe: ""
---
# M01 — Kontakt anlegen
## Ziel
Neuen Kontakt in Sekunden anlegen — ohne Dubletten zu produzieren.
## Pattern / Archetyp
A5 Dialog (echtes Modal: DialogLayout → Dialog → Dialog.Content).
## Daten
- **Pflicht: nur der Name.** Optional: Typ (Privatperson/Organisation, Default Privatperson), E-Mail, Telefon, Organisation verknüpfen (mit Rolle), Verantwortlicher
- **Live-Duplikat-Check** beim Tippen (Name/E-Mail/Telefon): Banner »Gibt es schon?« mit Treffer-Vorschau
## Aktionen
- »Anlegen« → Karteikarte öffnet sich (dort Rest pflegen)
- Bei Duplikat-Banner: »Bestehenden öffnen« oder »Trotzdem anlegen«
- Abbrechen
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Mögliches Duplikat | Banner im Modal | nein | Nur dokumentieren | Treffer klickbar |
| Name leer | Inline-Validierung | ja (Feld) | Nur dokumentieren | einziges Pflichtfeld |
## Subframe
- (erst nach explizitem OK)
## Notizen
- Wird auch aus anderen Flows geöffnet (z. B. Lead → Projekt: Kontakt verknüpfen/anlegen in D-P7).
@@ -0,0 +1,38 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: M02
screen: Organisation anlegen
typ: Modal
umsetzung: Bauen
status: Validiert
route: "aus S02 + aus M01/S03 (Organisation verknuepfen)"
subframe: ""
---
# M02 — Organisation anlegen
## Ziel
Neue Organisation schnell anlegen — gleiches Muster wie Kontakt anlegen.
## Pattern / Archetyp
A5 Dialog, analog [[M01 Kontakt anlegen]].
## Daten
- **Pflicht: nur der Name.** Optional: Branche/Merkmal, E-Mail, Telefon, Adresse, Verantwortlicher, Hauptkontakt verknüpfen
- Live-Duplikat-Check (Name/E-Mail)
## Aktionen
- »Anlegen« → Organisations-Karteikarte öffnet
- Duplikat-Banner: »Bestehende öffnen« / »Trotzdem anlegen«
- Abbrechen
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,45 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: M03
screen: Zusammenfuehren
typ: Modal (gross)
umsetzung: Bauen
status: Validiert
route: "aus S07"
subframe: ""
---
# M03 — Zusammenführen (Seite an Seite)
## Ziel
Zwei Dubletten kontrolliert zu einem Eintrag verschmelzen — Feld für Feld.
## Pattern / Archetyp
A5 großes Modal mit **Side-by-Side-Vergleich** (aufwendigste Einzelkomponente des Pakets).
## Daten
- Beide Einträge nebeneinander, Feld für Feld
- Je Feld wählbar, welcher Wert überlebt (Standard: der vollständigere)
- Unten: was zusammengeführt wird (Verlauf, Aufgaben, Dateien, Projekte beider Einträge wandern zum Ziel)
## Aktionen
- Feld-Auswahl je Zeile (links/rechts)
- »Zusammenführen« → Bestätigung mit Klartext: **»Kann nicht rückgängig gemacht werden. Der andere Eintrag wird aufgelöst, sein Verlauf bleibt erhalten.«**
- Abbrechen
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Endgültigkeit | Bestätigungs-Schritt | ja | Nur dokumentieren | s. oben |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,57 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: S01
screen: Kontakte-Liste
typ: Liste
umsetzung: Bauen
status: Validiert
route: "/contacts"
subframe: ""
---
# S01 — Kontakte-Liste
## Ziel
Jeden Kontakt in Sekunden finden.
## Pattern / Archetyp
A2 Liste; oben Reiter-Wechsel zu [[S02 Organisationen-Liste]].
## Daten
- **Zeigt ALLE Personen** — auch Ansprechpartner aus Organisationen (validiert): Zeile macht die Zugehörigkeit sichtbar (Organisation + Rollen-Badge Haupt-/Sekundärkontakt)
- Zeile: Avatar + Name · Organisation (mit Rolle) · Kontaktstatus (Kontakt/Kunde/Bestandskunde) · E-Mail · Telefon · Tags · Verantwortlicher · letzte Aktivität
- Suche · Filter: Verantwortlicher, Kontaktstatus, Tags (UND/ODER), Organisation (auch »ohne Organisation«), Datum · Archiviert-Schalter
- Keine Misch-Liste: Organisationen haben ihren eigenen Reiter ([[S02 Organisationen-Liste]])
- Server-seitig sortiert/paginiert
## Aktionen
- Zeile öffnen → [[S03 Kontakt-Karteikarte]]
- »+ Kontakt« → [[M01 Kontakt anlegen]]
- Mehrfach-Auswahl: Tag vergeben · Verantwortlichen zuweisen · Archivieren · CSV-Export
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer (Filter/read_own) | »Keine Kontakte für diese Filter« + zurücksetzen | Nur dokumentieren |
| Laden / Fehler | A7 | Wiederverwenden |
## Permissions / Gates
`crm.*` — bei `read_own` erscheinen nur eigene Kontakte (server-seitig).
## Subframe
- (erst nach explizitem OK)
## Notizen
- D01 Inline-Anlegen (Notion-Stil: Plus → neue Zeile, nur Name Pflicht, leere Zeile löscht sich) — dokumentiert, Später.
- Großer CSV-Export läuft im Hintergrund + Benachrichtigung.
@@ -0,0 +1,48 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: S02
screen: Organisationen-Liste
typ: Liste
umsetzung: Bauen
status: Validiert
route: "/contacts/companies"
subframe: ""
---
# S02 — Organisationen-Liste
## Ziel
Alle Firmen/Organisationen im Blick — zweiter Einstieg im Kontakte-Tab.
## Pattern / Archetyp
A2 Liste (Reiter neben [[S01 Kontakte-Liste]]). UI-Begriff: **»Organisation«**, nicht »Unternehmen«.
## Daten
- Zeile: Name · Branche/Merkmal · Anzahl verknüpfter Kontakte · Verantwortlicher · letzte Aktivität · Tags
- Suche · Filter analog S01
## Aktionen
- Zeile öffnen → [[S04 Organisations-Karteikarte]]
- »+ Organisation« → [[M02 Organisation anlegen]]
- Mehrfach-Aktionen analog S01
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer / Laden / Fehler | analog S01 | Wiederverwenden |
## Permissions / Gates
Wie S01.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,64 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: S03
screen: Kontakt-Karteikarte
typ: Detail (Muster-Vorlage)
umsetzung: Bauen
status: Validiert
route: "/contacts/:id"
subframe: ""
---
# S03 — Kontakt-Karteikarte ⭐
## Ziel
In 5 Sekunden im Bilde sein: Wer ist das, was lief zuletzt, was ist offen? **Die Muster-Vorlage für ALLE Detailseiten der App.**
## Pattern / Archetyp
A3 Detail — validiertes Grundgerüst: **Zweispalter + Reiter**.
## Aufbau (validiert)
- **Kopf:** Avatar, Name, Kontaktstatus-Badge, Organisation + Rolle · **Schnell-Aktionen:** Anrufen (v1: `tel:`-Link; AirCall kommt mit P15) · E-Mail · Termin · Aufgabe · Tag
- **Linke Spalte (schmal):** Stammdaten inline editierbar (Klick → Feld → speichern) · eigene Felder (SHK-Vorlagen) · Tags · **Verknüpfungen mit Rolle**: Organisationen, bei denen die Person Haupt-/Sekundärkontakt ist — und umgekehrt kann auch eine Privatperson eigene Sekundärkontakte haben (z. B. Ehepartner), gleiche Mechanik wie bei Organisationen
- **Rechte Spalte (breit), Reiter:**
- **Verlauf** (Default): chronologischer Activity-Stream — Anrufe, BCC-Mails, Notizen, Status-Wechsel, mit Actor-Marker
- **Projekte:** verknüpfte Projekte mit Board-Status (kommt inhaltlich mit D-P8)
- **Aufgaben:** eingebettete Kompakt-Liste = V01 aus WF-P4 Aufgaben
- **Dateien:** vorgefilterte Datei-Sektion aus WF-P4 Dateien
- **Notizen:** Markdown-Notizen
- **»Verlauf dieses Objekts«** (Audit): Einstieg zum M03-Drawer aus WF-P3 Audit Log
## Aktionen
- Inline-Edit aller Stammdaten/eigenen Felder · Tag hinzufügen/entfernen · Organisation verknüpfen (mit Rolle)
- Archivieren · Zusammenführen-Hinweis bei Duplikat-Verdacht
## Banner / Hinweise
- Duplikat-Verdacht: Banner »Ähnlicher Kontakt existiert« → Duplikat-Tool
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Nicht gefunden / kein Recht | 404 | Wiederverwenden |
| Laden / Fehler | A7 | Wiederverwenden |
| Verlauf leer | »Noch keine Aktivitäten« | Nur dokumentieren |
## Permissions / Gates
`crm.*`; Schnell-Aktionen rechte-abhängig.
## Subframe
- (erst nach explizitem OK)
## Notizen
- **Nach dem Subframe-Bau:** dieses Muster (Kopf + Zweispalter + Reiter) als Detailseiten-Standard festhalten → `04 Standards`, nur mit Davids Freigabe.
@@ -0,0 +1,37 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: S04
screen: Organisations-Karteikarte
typ: Detail
umsetzung: Bauen
status: Validiert
route: "/contacts/companies/:id"
subframe: ""
---
# S04 — Organisations-Karteikarte
## Ziel
Alles über eine Organisation — gleiches Muster wie die Kontakt-Karteikarte.
## Pattern / Archetyp
A3, **gleiches Grundgerüst wie [[S03 Kontakt-Karteikarte]]** (Zweispalter + Reiter).
## Unterschiede zu S03
- Linke Spalte zusätzlich: **Ansprechpartner-Liste** — alle verknüpften Personen mit Rollen-Badge, **genau ein Hauptkontakt** (markiert, umhängbar; erste zugeordnete Person wird automatisch Hauptkontakt) · hinzufügen (bestehenden Kontakt oder neu via [[M01 Kontakt anlegen]])
- Kopf: Organisations-Merkmal/Branche statt Kontaktstatus-Person-Logik (Status gibt es auch hier: Kontakt/Kunde/Bestandskunde)
- Reiter identisch: Verlauf · Projekte · Aufgaben · Dateien · Notizen
## Zustände / Permissions
Wie S03.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,44 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: S05
screen: Eigene Felder
typ: Settings-Liste
umsetzung: Bauen
status: Validiert
route: "/admin/custom-fields (Einstellungen -> Daten)"
subframe: ""
---
# S05 — Eigene Felder
## Ziel
Zusatzfelder definieren, die der Betrieb wirklich braucht (»Heizungstyp«, »Baujahr Anlage«).
## Pattern / Archetyp
A2 Settings-Liste unter Einstellungen → Daten.
## Daten
- Felder je Ziel-Typ (Kontakt / Projekt / Anfrage / Rechnung — umschaltbar)
- Je Feld: Name · Feld-Typ (Text, Zahl, Datum, Auswahl …) · Nutzungs-Anzahl · Quelle (SHK-Vorlage / eigenes) · Sortierung (Ziehen)
- SHK-Branchen-Felder sind vorbefüllt
## Aktionen
- Feld anlegen/bearbeiten (kleines Modal/Inline) · Archivieren (kein Hard-Delete bei Nutzung) · Reihenfolge ziehen
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Feld in Nutzung archivieren | Hinweis mit Nutzungs-Anzahl | Nur dokumentieren |
| Laden / Fehler / kein Zugriff | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,43 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: S06
screen: Tags
typ: Settings-Liste
umsetzung: Bauen
status: Validiert
route: "/admin/tags (Einstellungen -> Daten)"
subframe: ""
---
# S06 — Tags
## Ziel
Tags zentral pflegen, Wildwuchs zusammenführen.
## Pattern / Archetyp
A2 Settings-Liste unter Einstellungen → Daten.
## Daten
- Je Tag: Name · Farbe · Anzahl Verknüpfungen
## Aktionen
- Tag anlegen/umbenennen/Farbe ändern
- **Zusammenführen** (Tag A in Tag B aufgehen lassen, mit Bestätigung + Anzahl-Klartext)
- Löschen (mit Hinweis auf Verknüpfungs-Anzahl)
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Laden / Fehler / kein Zugriff | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,44 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: S07
screen: Duplikat-Tool
typ: Settings-Liste
umsetzung: Bauen
status: Validiert
route: "/admin/duplicates (Einstellungen -> Daten)"
subframe: ""
---
# S07 — Duplikat-Tool
## Ziel
Doppelte Kontakte/Organisationen finden und sauber verschmelzen.
## Pattern / Archetyp
A2 Liste unter Einstellungen → Daten.
## Daten
- Duplikat-Paare mit **Match-Grund** (gleiche E-Mail / gleiches Telefon / ähnlicher Name)
- Vorschau beider Einträge je Paar
## Aktionen
- Paar öffnen → [[M03 Zusammenfuehren]]
- »Kein Duplikat« (Paar verwerfen, taucht nicht wieder auf)
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Keine Duplikate | »Alles sauber — keine Dubletten gefunden« | Nur dokumentieren |
| Laden / Fehler / kein Zugriff | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)