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

144 lines
8.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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)*