Files
HiveGrid-Wireframes/Tickets/Fertige Tickets/D-CRM Kontakte und Organisationen.md
T

142 lines
14 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: ticket-handoff
project: HiveGrid Screen Project
ticket: D-CRM
area: Kontakte / Organisationen / Kontaktmodell
status: Fertig / Development-Handoff
repo: https://git.tool-ctrl.de/toolctrl-labs/HiveGrid-Wireframes
stand: 2026-08-29
---
# D-CRM Kontakte und Organisationen
Repo: https://git.tool-ctrl.de/toolctrl-labs/HiveGrid-Wireframes
Zentrale Tracker-Datei: [Screen Paket Tracker](../../02%20Wireframes/Screen%20Paket%20Tracker.md)
Flow-Paket: [WF-P6 Kontakte und Organisationen](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen.md)
Canvas: [WF-P6 Kontakte und Organisationen.canvas](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen.canvas)
Subframe: [WF-P6 Kontakte und Organisationen](https://app.subframe.com/f023064a5ca0/flow/68046dc7-bc93-4232-a0da-a406a8bd10b8/edit)
## Kurzfassung
Der Kontakte-/Organisationen-Flow ist als Development-Handoff abgeschlossen. Der finale Subframe-Flow enthält **13 Seiten**: zwei getrennte Listen, die Personen- und Organisations-Karteikarte, zwei Duplikatentscheidungen, einen Archivierungsdialog und sechs isolierte Zustände des rechten Werkzeugbereichs.
Alle 13 Seiten wurden am 2026-08-29 per MCP vollständig als JSX gelesen und anschließend frisch gerendert. Namen, UUIDs, Direktlinks, Kernkomponenten und sichtbare Inhalte stimmen mit Paket-MD, Screen-Dateien, Tracker und Canvas überein. S04 wurde aus der finalen S03-Struktur aufgebaut und in zwei eigenen QA-Durchgängen gegen die vollständige S03-Fehlerhistorie geprüft. Die frühere S03-Seite, die veraltete S04 und temporäre Reviewseiten sind aus Subframe entfernt.
Backlog-Bereiche bleiben bewusst außerhalb dieses Handoffs: Eigene Felder, Duplikat-Tool, Zusammenführen und Inline-Anlegen in der Liste.
## Gemacht
- Personen und Organisationen als getrennte, direkt umschaltbare Listen finalisiert.
- Dauerhafte Auswahl-Checkboxen und `BulkActionBar` in S01/S02 dokumentiert; keine eigene Auswahlseite.
- S03 als einzige vollständige Personen-Karteikarte im Pipeline-nativen Dreispaltenmuster finalisiert.
- S04 auf derselben Struktur mit Organisationsfeldern und getrennten primären/sekundären Ansprechpartnern aufgebaut.
- Sechs rechte Werkzeugzustände als isolierte Miniscreens für Projekte, Aufgaben, Dateien, Notizen, Verlauf und Aktivitäten validiert.
- Anlage direkt in S03/S04 verlegt; M01/M02 als Formulare entfernt.
- Relationspflege vollständig inline in S03/S04 verlegt; M04–M04c entfernt.
- M01a/M02a als kurze Duplikatentscheidungen und M08 als dynamischer Archivierungsdialog finalisiert.
- Wiederholbare E-Mails, Telefonnummern und Adressen inklusive Standardlogik und leeren Referenzzeilen festgelegt.
- Statusmodell, Verantwortlichen-Default, Relationsmodell, Suchlogik und Fehlerzustände als Development-Vertrag dokumentiert.
- P6-Paket, Screen-Dateien, Canvas, Tracker und dieser Ticket-Handoff synchronisiert.
## Finale Produktentscheidungen
- **Kontaktmodell:** `Kontakt` ist der technische Oberbegriff; im UI gibt es `Person` und `Organisation`. `Kontakt` ist kein Status.
- **Listen:** Personen und Organisationen werden nie gemischt, sind aber über einen kompakten Switch direkt erreichbar.
- **Anlage:** `Neue Person` öffnet S03, `Neue Organisation` S04 jeweils direkt mit leeren Feldern. Der erste gültige Speichervorgang legt den Datensatz an und lässt dieselbe Detailseite geöffnet.
- **Verantwortlich:** Bei Neuanlage ist der angemeldete Nutzer vorbelegt. Das Feld bleibt änderbar und kann geleert werden.
- **Status:** Kein Status ist zulässig. Weitere Werte sind `Interessent`, `Kunde`, `Bestandskunde` und `Ehemaliger Kunde`. Reine Ansprechpartner benötigen keinen Kundenstatus.
- **Bestandskunde:** Ein erfolgreich abgeschlossenes Projekt kann den Status automatisch setzen; manuelle Übersteuerung bleibt möglich. Ohne fachliches Ereignis erfolgt keine automatische Rückstufung.
- **Kontaktwege:** E-Mail-Adressen und Telefonnummern sind beliebig wiederholbar, besitzen frei beschreibbare Typen und genau einen Standardwert pro Kontaktweg.
- **Adressen:** Standard- und Rechnungsadresse sind vorbereitet; weitere benannte Adressen sind unbegrenzt möglich. Jeder Nicht-Standard-Block kann direkt zur Standardadresse gemacht werden.
- **Relationen:** Personen und Organisationen sind n:m verknüpfbar. Primär/Sekundär gehört ausschließlich zur konkreten Relation; beide Gruppen erlauben 0..n Einträge und dürfen leer sein.
- **Relationsbezeichnung:** Funktion/Beziehung ist optional, frei benennbar und liegt nur an der Relation. Sie blockiert die schnelle Auswahl nicht.
- **Inline-Pflege:** S03 verknüpft Organisationen ohne sichtbare Gruppenwahl über den Primärpfad und Personen nach einmaliger Primär-/Sekundärwahl. S04 fügt Personen direkt in der gewählten Ansprechpartnersektion hinzu.
- **Kein Suchtreffer:** `Neu anlegen` öffnet S03/S04 im Anlagezustand, behält den Relationskontext unsichtbar und wendet ihn nach dem ersten Speichern einmalig an.
- **Duplikate:** Beim ersten Speichern führt ein möglicher Treffer in M01a/M02a: bestehenden Datensatz öffnen oder bewusst trotzdem anlegen.
- **Archivieren:** M08 ist eine gemeinsame Referenz. Objektbegriff, Name und Buttontext werden für Person/Organisation dynamisch eingesetzt; Relationen, Projekte und Verlauf werden nicht gelöscht.
- **App-Shell:** Die Referenzscreens zeigen nur den eigentlichen Screen-Inhalt auf blanker Fläche. Globale Topbar und Sidebar werden nicht dupliziert.
## Hauptfluss
```text
S01 Personenliste <-> S02 Organisationenliste
| |
v v
S03 Person S04 Organisation
| |
+-> M01a Duplikat +-> M02a Duplikat
+-> M08 Archivieren +-> M08 Archivieren
S03/S04 rechter Werkzeugbereich:
S03a Projekte · S03b Aufgaben · S03c Dateien
S03d Notizen · S03e Verlauf · S03f Aktivitäten
```
## Vollständiges Subframe-Inventar
| ID | Live-Name | UUID | Repo | Subframe |
|---|---|---|---|---|
| S01 | S01 Kontakte-Liste | `82f7c7cb-18d2-4f3c-b374-15ca56e12635` | [MD](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/S01%20Kontakte-Liste.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/82f7c7cb-18d2-4f3c-b374-15ca56e12635/edit) |
| S02 | S02 Organisationen-Liste | `6d1512ab-898a-4931-976c-2622d8d4aff4` | [MD](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/S02%20Organisationen-Liste.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/6d1512ab-898a-4931-976c-2622d8d4aff4/edit) |
| S03 | S03 Review – Inline-Zeilen | `13a46cd7-44b6-4495-bad5-57eb1ffc978a` | [MD](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/S03%20Kontakt-Karteikarte.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/13a46cd7-44b6-4495-bad5-57eb1ffc978a/edit) |
| S04 | S04 Organisations-Karteikarte | `a6fe8461-1728-49c2-96c0-005cea90b547` | [MD](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/S04%20Organisations-Karteikarte.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/a6fe8461-1728-49c2-96c0-005cea90b547/edit) |
| M01a | M01a Kontakt anlegen – Duplikatwarnung | `38a86afc-5cfd-40a6-bdab-fc6a19d93697` | [MD](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/M01a%20Kontakt%20anlegen%20Duplikatwarnung.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/38a86afc-5cfd-40a6-bdab-fc6a19d93697/edit) |
| M02a | M02a Organisation anlegen – Duplikat erkannt | `de4c91e1-3f45-49e8-b3c4-f3f830c50e74` | [MD](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/M02a%20Organisation%20anlegen%20Duplikatwarnung.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/de4c91e1-3f45-49e8-b3c4-f3f830c50e74/edit) |
| M08 | M08 Kontakt archivieren | `a5efa71b-e485-4c76-80bf-8f3bb4c47de0` | [MD](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/M08%20Kontakt%20archivieren.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/a5efa71b-e485-4c76-80bf-8f3bb4c47de0/edit) |
| S03a | S03a Kontakt-Karteikarte - Projekte | `b4d311db-d9fb-430e-9cbc-438d639e1915` | [S03-Doku](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/S03%20Kontakt-Karteikarte.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/b4d311db-d9fb-430e-9cbc-438d639e1915/edit) |
| S03b | S03b Kontakt-Karteikarte - Aufgaben | `181aba66-b00e-4cb2-a560-d2160610040f` | [S03-Doku](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/S03%20Kontakt-Karteikarte.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/181aba66-b00e-4cb2-a560-d2160610040f/edit) |
| S03c | S03c Kontakt-Karteikarte - Dateien | `68974b3a-ab6c-4be8-a3b8-53c82fb89eb3` | [S03-Doku](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/S03%20Kontakt-Karteikarte.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/68974b3a-ab6c-4be8-a3b8-53c82fb89eb3/edit) |
| S03d | S03d Kontakt-Karteikarte - Notizen | `337b0721-9d27-4037-bb0d-59d066ed9769` | [S03-Doku](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/S03%20Kontakt-Karteikarte.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/337b0721-9d27-4037-bb0d-59d066ed9769/edit) |
| S03e | S03e Kontakt-Detail – Pipeline exakt | `ebf980fb-4569-45b0-b799-c76d2daff8e9` | [S03-Doku](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/S03%20Kontakt-Karteikarte.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/ebf980fb-4569-45b0-b799-c76d2daff8e9/edit) |
| S03f | S03f Kontakt-Detail – Pipeline editierbar | `6f1048f4-adaa-46ed-bd8c-6460ac3d43aa` | [S03-Doku](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/Screens/S03%20Kontakt-Karteikarte.md) | [Subframe](https://app.subframe.com/f023064a5ca0/design/6f1048f4-adaa-46ed-bd8c-6460ac3d43aa/edit) |
## Development-Hinweise
- Die exportierten `onClick`-Handler sind statische Platzhalter. Routing und Outcomes folgen dem Paket-MD, Canvas und den Screen-Dateien.
- S03 trägt im Live-Flow weiterhin den Namen `S03 Review – Inline-Zeilen`; diese Seite ist die kanonische S03-Referenz und keine zusätzliche Reviewvariante.
- S03a–S03f sind keine eigenen Routen. Sie dokumentieren ausschließlich den aktiven Zustand des rechten 340-px-Werkzeugbereichs.
- Die Kundennummer ist systemgeführt und read-only. `Kunde seit` ist ein eigener Geschäftswert.
- `KontaktArt` muss im Backend in Relationsgruppe (`primaer`/`sekundaer`) und optionale Funktion/Beziehung getrennt werden.
- `Kontakt.adresseId` muss durch eine mehrwertige Kontakt-Adress-Zuordnung mit Standard-/Rechnungskennzeichnung ersetzt werden.
- E-Mail-Adressen benötigen wie Telefonnummern einen beschreibbaren Typ und eine Standardmarkierung.
- Verantwortlich und Quelle sind durchsuchbare Single-Selects; Personenoptionen verwenden Avatar, Name und sekundäre Information.
- Bestehende Relationen dürfen beim Archivieren nicht gelöscht werden.
- Standard-Loading-, Fehler-, 404- und Permission-Muster werden wiederverwendet und benötigen keine zusätzlichen P6-Screens.
## Entfernt oder bewusst nicht im Hauptflow
- M01/M02: Anlageformulare entfallen; S03/S04 übernehmen den Anlagezustand.
- M04–M04c: Relationsmodale entfallen; Pflege erfolgt inline.
- S06/M06: eigene Tag-Verwaltung entfernt; Tags am Kontakt bleiben erhalten.
- S01a: Mehrfachauswahl in S01 integriert.
- Frühere S03- und S04-Seiten sowie temporäre Reviewseiten wurden aus Subframe entfernt. Wiederherstellung ist nur über die Subframe-Projektversionierung möglich.
## Separate Folgethemen
Diese Punkte blockieren den Handoff nicht:
- S05 Eigene Felder.
- S07 Duplikat-Tool und M03 Zusammenführen.
- D01 Inline-Anlegen direkt in der Liste.
- AirCall-Anbindung der Anruf-Schnellaktion mit D-P15; v1 verwendet `tel:`.
- Optional neutralere Bezeichnungen für Primär/Sekundär bei Person-Person-Verknüpfungen.
## Abschlussprüfung
- 13 Live-Seiten = 13 gelesene JSX-Dateien = 13 vollständige Renderings.
- Flow-ID, Seitennamen, UUIDs und Direktlinks sind eindeutig und synchron.
- S01/S02 enthalten Auswahl-Checkboxen und `BulkActionBar`.
- S03/S04 enthalten die erwarteten Daten-, Kontaktweg-, Adress-, Relations- und Werkzeugbereiche.
- M01a/M02a und M08 rendern als kompakte Dialogreferenzen.
- P6-Canvas ist JSON-valide; IDs sind eindeutig und alle 15 Kanten referenzieren vorhandene Nodes.
- Paket-MD, Screen-Dateien, Tracker, Canvas und Ticket-Handoff verwenden denselben finalen Status.
- Backlog-Dokumente wurden nicht in den Hauptflow gezogen.
## Hinweis für das Ticket-System
Diese Datei ist der kompakte fertige Handoff für `D-CRM`. Für die vollständige Detailwahrheit sind das [P6-Flow-Paket](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen.md), der [P6-Canvas](../../02%20Wireframes/P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen/WF-P6%20Kontakte%20und%20Organisationen.canvas), die verknüpften Screen-Dateien und der [Screen Paket Tracker](../../02%20Wireframes/Screen%20Paket%20Tracker.md) maßgeblich.