--- 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.