Files
HiveGrid-Wireframes/02 Wireframes/P6 Kontakte und Organisationen/WF-P6 Kontakte und Organisationen/WF-P6 Kontakte und Organisationen.md
T

8.2 KiB
Raw Blame History

kind, project, ticket, package, typ, status, subframe, canvas
kind project ticket package typ status subframe canvas
wireframe-package HiveGrid Screen Project D-CRM WF-P6 Kontakte und Organisationen Flow Validiert 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

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


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

  • Jeder Screen ist mit Umsetzung markiert.
  • Meldungs-/Error-State-Matrix ist ausgefüllt.
  • Subframe-Link ist eingetragen. (Subframe erst nach explizitem OK)