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)
@@ -0,0 +1,69 @@
{
"nodes":[
{"id":"group-daten","type":"group","x":-80,"y":1020,"width":2980,"height":380,"label":"Datenpflege (Einstellungen → Daten)"},
{"id":"group-kontakte","type":"group","x":-80,"y":-100,"width":1820,"height":380,"label":"Kontakte"},
{"id":"group-orgs","type":"group","x":-80,"y":460,"width":1820,"height":380,"label":"Organisationen (Reiter im selben Tab)"},
{"id":"group-anlegen","type":"group","x":1960,"y":460,"width":1120,"height":380,"label":"Anlegen (Modals)"},
{"id":"group-modell","type":"group","x":1980,"y":-520,"width":700,"height":520,"label":"Kontaktmodell (validiert 2026-07-08)"},
{"id":"md-paket","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/WF-P6 Kontakte und Organisationen.md","x":-80,"y":-440,"width":460,"height":280},
{"id":"note-entry","type":"text","text":"# Einstieg\n\nSidebar → Kontakte (`/contacts`).\n\nZwei Reiter, nie gemischt: **Kontakte** (ALLE Personen, auch Ansprechpartner — Organisation + Rolle in der Zeile) und **Organisationen**.","x":0,"y":0,"width":360,"height":200},
{"id":"s01","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/Screens/S01 Kontakte-Liste.md","x":560,"y":0,"width":420,"height":200},
{"id":"s03","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/Screens/S03 Kontakt-Karteikarte.md","x":1240,"y":0,"width":420,"height":200},
{"id":"note-orgs","type":"text","text":"# Hinweis\n\nUI-Begriff »Organisation«, nicht »Firma/Unternehmen« (öffentl. Einrichtungen!).\n\nKarteikarte zeigt die **Ansprechpartner-Liste** mit Rollen — genau EIN Hauptkontakt (markiert, umhängbar).","x":0,"y":560,"width":360,"height":200},
{"id":"s02","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/Screens/S02 Organisationen-Liste.md","x":560,"y":560,"width":420,"height":200},
{"id":"s04","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/Screens/S04 Organisations-Karteikarte.md","x":1240,"y":560,"width":420,"height":200},
{"id":"m01","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/Screens/M01 Kontakt anlegen.md","x":2000,"y":560,"width":420,"height":200},
{"id":"m02","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/Screens/M02 Organisation anlegen.md","x":2580,"y":560,"width":420,"height":200},
{"id":"note-daten","type":"text","text":"# Einstieg\n\nEinstellungen → Daten. Gilt auch für Projekte/Anfragen (Ziel-Typ umschaltbar).","x":0,"y":1120,"width":360,"height":200},
{"id":"s05","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/Screens/S05 Eigene Felder.md","x":560,"y":1120,"width":420,"height":200},
{"id":"s06","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/Screens/S06 Tags.md","x":1140,"y":1120,"width":420,"height":200},
{"id":"s07","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/Screens/S07 Duplikat-Tool.md","x":1720,"y":1120,"width":420,"height":200},
{"id":"m03","type":"file","file":"02 Wireframes/P6 Kontakte/WF-P6 Kontakte und Organisationen/Screens/M03 Zusammenfuehren.md","x":2400,"y":1120,"width":420,"height":200},
{"id":"note-modell","type":"text","text":"# Regeln\n- **EIN Datensatz für alles:** »Firma« = Kontakt vom Typ Organisation (Unterart = Auswahlfeld)\n- **Kontaktart (Haupt/Sekundär) = Rolle der Verknüpfung**, nicht der Person\n- Privatperson: nur Name Pflicht, keine Kontaktart-Frage\n- Organisation: auch ohne Person anlegbar\n- Genau **ein Hauptkontakt** je Organisation — erste Person automatisch, umhängbar\n- Auch **Privatpersonen können Sekundärkontakte** haben (Shell-Prinzip, z. B. Ehepartner)","x":2020,"y":-440,"width":620,"height":400}
],
"edges":[
{
"id":"e-entry",
"styleAttributes":{"path":"dotted"},
"fromNode":"note-entry",
"fromSide":"right",
"toNode":"s01",
"toSide":"left"
},
{"id":"e-open","fromNode":"s01","fromSide":"right","toNode":"s03","toSide":"left","label":"Kontakt öffnen"},
{
"id":"e-tab",
"styleAttributes":{"path":"dotted"},
"fromNode":"s01",
"fromSide":"bottom",
"toNode":"s02",
"toSide":"top",
"label":"Reiter Organisationen"
},
{"id":"e-open2","fromNode":"s02","fromSide":"right","toNode":"s04","toSide":"left","label":"öffnen"},
{"id":"e-new1","fromNode":"s01","fromSide":"bottom","toNode":"m01","toSide":"top","label":"+ Kontakt"},
{"id":"e-new2","fromNode":"s02","fromSide":"bottom","toNode":"m02","toSide":"bottom","label":"+ Organisation"},
{
"id":"e-after",
"styleAttributes":{"path":"long-dashed"},
"fromNode":"m01",
"fromSide":"top",
"toNode":"s03",
"toSide":"right",
"label":"öffnet Karteikarte"
},
{
"id":"e-entry-daten",
"styleAttributes":{"path":"dotted"},
"fromNode":"note-daten",
"fromSide":"right",
"toNode":"s05",
"toSide":"left"
},
{"id":"e-merge","fromNode":"s07","fromSide":"right","toNode":"m03","toSide":"left","label":"Paar öffnen"}
],
"metadata":{
"version":"1.0-1.0",
"frontmatter":{}
}
}
@@ -0,0 +1,143 @@
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
typ: Flow
status: Validiert
subframe: ""
canvas: "WF-P6 Kontakte und Organisationen.canvas"
---
# WF-P6 Kontakte und Organisationen
Status: Validiert (Screen-Liste)
Subframe-Link: -
Canvas: [Canvas](<WF-P6 Kontakte und Organisationen.canvas>)
Stand: 2026-07-08
---
## 1. Kurzfassung
Das Adressbuch mit Gedächtnis: Kontakte- und Organisationen-Listen, die **Kontakt-Karteikarte als Vorlage für ALLE Detailseiten**, Anlegen mit Duplikat-Warnung, plus die drei Datenpflege-Seiten in den Einstellungen (Eigene Felder, Tags, Duplikat-Tool). Fundament der Kette Anfrage → Projekt.
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Welches Ticket/Modul ist betroffen? | D-CRM (P6), Dev-Pendant R-P6 |
| Was soll der Nutzer am Ende schaffen? | Kunden finden, in 5 Sekunden im Bilde sein (Verlauf), Daten pflegen, Dubletten loswerden |
| Flow, Screen, Zustand oder Doku? | Screen-Cluster: 2 Listen, 2 Karteikarten, 2 Anlege-Modals, 3 Einstellungs-Seiten, 1 Merge-Modal |
| Welche Planning-Quellen wurden geprüft? | `ticket-docs/D-CRM.md`, ENTITY-MODEL (Pivot-Vorrang), SCREEN-MAP §2, HiveGrid Map |
| Was ist sicher im Scope? | Alles oben + Live-Duplikat-Check + Kontaktmodell (Typ/Status/Rolle) |
| Was ist sicher nicht im Scope? | Leads (D-P7), Pipelines (D-P8), Lead-Promotion-Modal (Pivot: existiert nicht mehr) |
| Admin/Normalrolle-Unterschiede? | `crm.*`-Rechte (read_own/read_all/write/delete/admin); bei read_own sieht man nur eigene |
| Unsichere Annahmen? | Inline-Anlegen in der Liste (Notion-Stil) — als Option dokumentiert, nicht v1-gebaut |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Ticket/Modul | D-CRM · Kontakte & Organisationen + Datenpflege |
| Nutzerrolle | Maximalansicht (Admin) |
| Startpunkt | Sidebar »Kontakte« |
| Ziel | Kontakt gefunden/angelegt/gepflegt; Historie sichtbar |
| Haupt-Archetyp | A2 Listen · **A3 Detail (Muster-Vorlage!)** · A5 Modals · A2 Settings-Listen |
| Bespoke-Anteil | Keiner; Side-by-Side-Merge ist die aufwendigste Einzelkomponente |
| Out of scope | Leads, Pipelines, Kampagnen-Anbindung (nur Anzeige im Verlauf) |
---
## 4. Entscheidungen (validiert 2026-07-08)
| Entscheidung | Status | Notiz |
|---|---|---|
| EIN großes Paket (inkl. Datenpflege-Seiten) | genommen | Davids Entscheidung |
| Anlegen als **Modal** mit Live-Duplikat-Warnung | genommen | Nach Anlegen öffnet die Karteikarte |
| **Inline-Anlegen in der Liste (Notion-Stil)** | dokumentiert / später | Davids Idee: Plus in der Liste → neue Zeile inline; funktioniert, weil nur der Name Pflicht ist; Zeile ohne Namen wird automatisch gelöscht. Erstmal nicht bauen |
| Karteikarte = **Zweispalter + Reiter** | genommen | Links schmal: Stammdaten, eigene Felder, Tags, Verknüpfungen (inline editierbar). Rechts breit: Reiter Verlauf · Projekte · Aufgaben · Dateien · Notizen. Schnell-Aktionen im Kopf. **= Muster-Vorlage für alle Detailseiten** |
| Kontaktmodell (fix aus Datenmodell) | genommen | EIN Kontakt-Datensatz für alles. Typ = Privatperson/Organisation (Organisations-Art wie Unternehmen/öffentl. Einrichtung = einfaches Auswahlfeld) · Status = Kontakt/Kunde/Bestandskunde · Kontaktart (Haupt-/Sekundär) = **Rolle der Verknüpfung**, nicht der Person |
| **Zwei getrennte Reiter, keine Misch-Liste** | genommen | Reiter »Kontakte« (alle Personen) + Reiter »Organisationen« — nie beide Typen in einer Liste gemischt (validiert 2026-07-08) |
| Kontakte-Reiter zeigt **ALLE Personen** | genommen | Auch Ansprechpartner, die in Organisationen stecken — mit sichtbarer Organisation + Rolle in der Zeile. Privatpersonen sowieso |
| **Anlege-Regeln** | genommen | Privatperson: nur Name Pflicht, keine Kontaktart-Frage (steht für sich) · Organisation: auch ohne Person anlegbar, Ansprechpartner optional · Zuordnung Person→Organisation mit Rollen-Wahl · genau EIN Hauptkontakt je Organisation, erste zugeordnete Person automatisch (umhängbar) |
| **Auch Privatpersonen können Sekundärkontakte haben** | genommen | Davids »Shell«-Gedanke: Verknüpfungen gehen an jeden Kontakt (z. B. Ehepartner/Mitbewohner an einer Privatperson) — gleiche Mechanik wie bei Organisationen, nur andere Felder |
| Datenpflege-Seiten unter Einstellungen → Daten | genommen | passt zum Infrastruktur-Beschluss |
| Querschnitts-Bausteine einbetten | genommen | Aufgaben-Reiter = V01 (P4) · Datei-Sektion (P4) · »Verlauf«-Drawer = M03 (P3 Audit) — werden referenziert, nicht neu gebaut |
### Happy Path
1. Sidebar »Kontakte« → Liste, tippen/filtern, Kontakt öffnen.
2. Karteikarte: links Stammdaten direkt editieren; rechts im Verlauf sehen, was zuletzt lief (Anrufe, Mails, Notizen); Schnell-Aktion »Aufgabe« oder »Termin« direkt aus dem Kopf.
3. Neuer Kunde ruft an → »+ Kontakt« → Modal, beim Tippen kommt ggf. »gibt's schon« → bestehenden öffnen statt Dublette anlegen.
4. Aufräumen: Einstellungen → Duplikat-Tool → Paar nebeneinander → Feld für Feld übernehmen → zusammenführen.
### Meldungs-/Error-States (validiert)
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|---|---|---|---|---|
| Fremder Kontakt bei `read_own` | 404 bzw. taucht in Liste nicht auf | ja | Wiederverwenden | Dev-Vorgabe |
| Mögliches Duplikat beim Anlegen | Banner im Modal: »trotzdem anlegen« / »bestehenden öffnen« | nein | Nur dokumentieren | Live-Check beim Tippen |
| Zusammenführen ist endgültig | Bestätigung mit Klartext | ja (Aktion) | Nur dokumentieren | »Kann nicht rückgängig gemacht werden« |
| Großer CSV-Export | läuft im Hintergrund + Meldung | nein | Nur dokumentieren | Benachrichtigung wenn fertig |
| Leere Liste (Filter/read_own) | Leer-Zustand mit Klartext | nein | Nur dokumentieren | »Keine Kontakte für diese Filter« |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | Kontakte-Liste | Liste | Bauen | `/contacts` | Validiert |
| S02 | Organisationen-Liste | Liste | Bauen | `/contacts/companies` | Validiert |
| S03 | Kontakt-Karteikarte ⭐ | Detail (Muster-Vorlage) | Bauen | `/contacts/:id` | Validiert |
| S04 | Organisations-Karteikarte | Detail | Bauen | `/contacts/companies/:id` | Validiert |
| M01 | Kontakt anlegen | Modal | Bauen | aus S01 + überall | Validiert |
| M02 | Organisation anlegen | Modal | Bauen | aus S02 | Validiert |
| S05 | Eigene Felder | Settings-Liste | Bauen | `/admin/custom-fields` | Validiert |
| S06 | Tags | Settings-Liste | Bauen | `/admin/tags` | Validiert |
| S07 | Duplikat-Tool | Settings-Liste | Bauen | `/admin/duplicates` | Validiert |
| M03 | Zusammenführen (Seite an Seite) | Modal (groß) | Bauen | aus S07 | Validiert |
| D01 | Inline-Anlegen in Liste (Notion-Stil) | Idee | Später | in S01 | Dokumentiert |
| D02–D05 | Banner/Zustände (s. Tabelle) | Inline/Banner | Nur dokumentieren | — | Validiert |
---
## 8. Grid
```text
Sidebar -> S01 <-> S02 (Reiter)
S01 -> S03 (Karteikarte) / S02 -> S04
S01 -> M01 (+ Kontakt) / S02 -> M02
Einstellungen -> S05 / S06 / S07 -> M03 (Zusammenfuehren)
S03/S04 betten ein: Aufgaben V01 (P4), Datei-Sektion (P4), Verlauf-Drawer M03 (P3 Audit)
```
---
## 9. Screen-Pakete
- [[S01 Kontakte-Liste]] · [[S02 Organisationen-Liste]]
- [[S03 Kontakt-Karteikarte]] · [[S04 Organisations-Karteikarte]]
- [[M01 Kontakt anlegen]] · [[M02 Organisation anlegen]]
- [[S05 Eigene Felder]] · [[S06 Tags]] · [[S07 Duplikat-Tool]] · [[M03 Zusammenfuehren]]
---
## 10. Offene Fragen
- Inline-Anlegen (D01): wann/ob bauen → David entscheidet später
- Reiter-Label: David sagte locker »Firmen oder sowas« — Spec-Vorgabe ist »Organisation« (öffentliche Einrichtungen sind keine Firmen); wir bleiben bei **»Organisationen«**, final beim Subframe-Bau
- Sekundärkontakte an Privatpersonen (Shell-Gedanke): Datenmodell (KontaktRelation = Kontakt↔Kontakt) deckt das ab — beim Handoff kurz mit Dev bestätigen
- Quick-Action »Anrufen« zeigt in v1 `tel:`-Link, AirCall-Anbindung kommt mit D-P15
- Karteikarten-Muster nach Subframe-Bau als Standard dokumentieren (→ `04 Standards`, nur mit Davids Freigabe)
## Handoff-Check
- [x] Jeder Screen ist mit Umsetzung markiert.
- [x] Meldungs-/Error-State-Matrix ist ausgefüllt.
- [ ] Subframe-Link ist eingetragen. *(Subframe erst nach explizitem OK)*