--- 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]() 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)*