--- kind: screen project: HiveGrid Screen Project ticket: D-CRM package: WF-P6 Kontakte und Organisationen id: S03 screen: Kontakt-Karteikarte typ: Detail umsetzung: Bauen status: Validiert 2026-08-29 route: "/contacts/:id" subframe: "https://app.subframe.com/f023064a5ca0/design/13a46cd7-44b6-4495-bad5-57eb1ffc978a/edit" --- # S03 — Kontakt-Karteikarte ## Ziel In 5 Sekunden im Bilde sein: Wer ist das, was lief zuletzt, was ist offen? ## Pattern / Archetyp A3 Detail als Pipeline-/Kanban-native, validierte Subframe-Referenz. **S03 ist die einzige vollständige Hauptansicht und Source of Truth** für Kopf, Daten, Relationen und Schnellaktionen. Die sechs Zustände des rechten Werkzeugbereichs werden separat als schmale Miniscreens gepflegt, damit Änderungen am Detailgrundgerüst nicht in jeder Variante wiederholt werden müssen. ## Anlagezustand - `Neue Person` in S01 öffnet unmittelbar diese vollständige S03-Ansicht mit leeren Personenfeldern. Es gibt keinen vorgeschalteten M01-Dialog. - Stammdaten, Kontaktwege, Adressen und Relationen werden auf derselben Arbeitsfläche gepflegt, die später die normale Karteikarte bildet. - Der erste gültige Speichervorgang legt die Person an; S03 bleibt geöffnet und wechselt ohne Erfolgsseite oder Navigation in den normalen Detailzustand. - Mindestens Vorname oder Nachname muss vor dem ersten Speichern befüllt sein. `Kein Status` ist zulässig. - Der Live-Duplikat-Check auf Name, E-Mail und Telefon führt bei einem Treffer in [[M01a Kontakt anlegen Duplikatwarnung]]. `Abbrechen` dort kehrt mit unveränderten Eingaben in diesen Anlagezustand zurück. - Development-Vorgabe: `Verantwortlich` wird bei Neuanlage mit dem angemeldeten Nutzer vorbelegt, bleibt aber änderbar und kann geleert werden. - Zurück-Navigation mit Eingaben warnt vor dem Verwerfen. Ein vollständig leerer Anlagezustand erzeugt keinen sichtbaren Listeneintrag. ## Aktueller Subframe-Stand - **Kopf:** Avatar, Name, Typ und optionaler Kontaktstatus; rechts die systemgeführte Kundennummer (read-only), Zurück zu Kontakte und Speichern — analog zur Pipeline-Detailseite. - **Linke Datenspalte:** Stammdaten und Kontaktwege als ruhige, kompakte Zeilen. Enthalten sind Anrede, Titel, Vorname, Nachname, optionaler Status, Verantwortlich sowie die wiederholbaren E-Mail- und Telefonzeilen. - **Kontaktwege:** beliebig viele E-Mail-Adressen und Telefonnummern. Jede Zeile besitzt eine beschreibbare Typbezeichnung; genau ein Wert je Kontaktweg kann als Standard markiert werden. Hinzufügen erfolgt über einen Plus-Button unter der jeweiligen Liste. Je Bereich bleibt eine leere Referenzzeile sichtbar, damit Placeholder, deaktivierte Standard-Aktion und unbefüllter Zustand eindeutig dokumentiert sind. - **Mittlere Kontextspalte:** beginnt oben mit `Weitere Angaben` aus Quelle, Kunde seit, Tags und Notiz. Darunter folgen Adressen und Verknüpfungen, klar von den Stammdaten getrennt. Standard- und Rechnungsadresse sind vorbereitet; beliebig viele weitere benannte Adressen sind möglich. Organisationen und Personen werden getrennt angezeigt. Eine Organisation wird in S03 direkt über `Organisation verknüpfen` hinzugefügt und intern dem Primärpfad zugeordnet, ohne Primär/Sekundär im Personen-Screen anzuzeigen. Bei Person-Verknüpfungen wählt ein Dropdown zwischen Primär und Sekundär. Ein eigenes M04-Modal gibt es nicht. - **Rechter Werkzeugbereich (ca. 340 px):** Ein festes 2×3-Raster wechselt zwischen Verlauf, Projekte, Aufgaben, Dateien, Notizen und Aktivitäten. Der aktive Bereich wird direkt darunter kompakt dargestellt; es gibt keine breite zweite Arbeitsfläche mehr. - **Verlauf** (Default): chronologischer Activity-Stream — Anrufe, BCC-Mails, Notizen, Status-Wechsel, mit Actor-Marker - **Projekte:** verknüpfte Projekte mit Board-Status (kommt inhaltlich mit D-P8) - **Aufgaben:** eingebettete Kompakt-Liste = V01 aus WF-P4 Aufgaben - **Dateien:** vorgefilterte Datei-Sektion aus WF-P4 Dateien - **Notizen:** Markdown-Notizen - **Schnellaktionen unten:** schwebende Leiste wie in der Pipeline-Detailseite mit Anrufen, E-Mail, Termin, Aufgabe, Notiz und Hochladen. Kontextaktionen liegen damit einheitlich am unteren Rand statt verteilt im Kopf. - **»Verlauf dieses Objekts«** (Audit): Einstieg zum M03-Drawer aus WF-P3 Audit Log ## Hauptansicht und Werkzeug-Miniscreens - **S03 — Hauptansicht:** vollständige Kontakt-Detailseite mit Kopf, linker Datenspalte, mittlerer Kontextspalte, rechtem Werkzeugbereich und Schnellaktionen unten. Nur hier wird das gemeinsame Grundlayout gepflegt. - **S03a — Projekte:** reiner 340-px-Werkzeug-Miniscreen mit kompakten Projektkarten. - **S03b — Aufgaben:** reiner Werkzeug-Miniscreen mit offenen und erledigten Aufgaben. - **S03c — Dateien:** reiner Werkzeug-Miniscreen mit Upload-Fläche und Dateiliste. - **S03d — Notizen:** reiner Werkzeug-Miniscreen mit kurzer Erfassung und bestehenden Notizen. - **S03e — Verlauf:** reiner Werkzeug-Miniscreen mit chronologischem Kommunikations- und Ereignisverlauf. - **S03f — Aktivitäten:** reiner Werkzeug-Miniscreen für Änderungen und systemische Objektaktivitäten, z. B. Daten geändert, Projekt verknüpft, Aufgabe erstellt oder Tag hinzugefügt. Die Miniscreens enthalten bewusst **keine** Kopie von Kopf, Kontaktfeldern, Adressen, Relationen oder Schnellaktionen. Sie dokumentieren nur den jeweils aktiven rechten Zustand und sind keine eigenständigen Produktseiten. ## Finalisierte Hauptansicht (2026-08-29) Die kompakte Inline-Zeilen-Richtung ist nach der visuellen und funktionalen Detailprüfung die kanonische S03-Hauptseite: - [S03 Review – Inline-Zeilen](https://app.subframe.com/f023064a5ca0/design/13a46cd7-44b6-4495-bad5-57eb1ffc978a/edit) Die frühere Seite `S03 Kontakt-Detailseite` sowie die Variante `S03 Review – Akkordeon-Gruppen` wurden nach der Richtungsentscheidung aus Subframe entfernt. Die verbleibende Seite setzt verbindlich um: - Alle bearbeitbaren Werte sind echte Subframe-Formular- und Menükomponenten statt statischer Textattrappen: `TextInput`, `Select`, `DropdownMenuSelect`, `DatePicker`, `MultiSelectTags`, `TextArea` und `Accordion`. - Grunddaten verwenden passende Controls: Anrede und Titel als Select, Status als Badge-Select nach dem Pipeline-Muster, Verantwortlich als durchsuchbares Single-Select-Dropdown sowie Vorname und Nachname als TextInput. Verantwortliche werden mit der fertigen `DropdownMenuSelect.DropdownUserItem`-Zeile aus Avatar, Name und sekundärer Information dargestellt; einfache Textoptionen sind dafür nicht ausreichend. Im Statusfeld und in jeder Statusoption wird derselbe Badge samt konsistenter Farbe gezeigt. - E-Mail- und Telefontypen sind frei beschreibbare TextInputs. `Privat`, `Geschäftlich`, `Mobil` und `Assistenz` dienen als Startwerte beziehungsweise Vorschläge, bilden aber bewusst keine geschlossene Auswahlliste. - Der Standardwert ist kein Dropdown: Nicht-Standardwerte besitzen den direkten Button `Als Standard`; der aktuelle Standard wird als ausgewählter Button mit Haken gezeigt. Je Kontaktweg kann genau ein Eintrag Standard sein. - E-Mail und Telefon enthalten jeweils eine vollständig leere Referenzzeile. Typ und Wert zeigen nur ihre Placeholder; `Als Standard` bleibt deaktiviert, bis ein verwertbarer Kontaktweg vorhanden ist. - Kompakte Inline-Zeilen erhalten feste Wrapper für Typ, Standard-Aktion und Zeilenmenü; das eigentliche E-Mail-/Telefonfeld nutzt den verbleibenden Platz. Interne Mindestbreiten eines Controls dürfen diese Wrapper nicht überlaufen. Die Standard-Aktion besitzt immer eine belastbare Mindestbreite und sichtbares horizontales Padding. - Die Hinzufügen-Aktionen für E-Mail, Telefon, Adressen, Organisationen, Personen und weitere Verknüpfungen nehmen jeweils die volle Sektionsbreite ein. - Standard-, Rechnungs- und weitere benannte Adressen sind echte, unabhängig auf-/zuklappbare Akkordeons; mindestens ein Block ist zur Referenz geöffnet. Jeder Adressblock enthält denselben Feldsatz aus dem Adressflow: Straße, Nr., Adresszusatz, PLZ, Ort und Land. Textfelder und Länder-Select besitzen stets eine sichtbare Umrandung. Jeder Nicht-Standard-Adressblock besitzt die direkte Button-Aktion `Standardadresse übernehmen`; die Standardadresse selbst zeigt diese Aktion nicht. - Quelle ist ein durchsuchbares Single-Select-Dropdown, `Kunde seit` ein DatePicker, Tags ein MultiSelect und die Notiz eine TextArea. - Select-Optionen besitzen sichtbare Item-Inhalte. Drei-Punkte-Aktionen sind mit einem echten Dropdown-Root, Trigger, Portal und Menüinhalt verdrahtet; ein alleinstehender IconButton gilt hier nicht als Menü. - Organisationen und Personen sind getrennte auf-/zuklappbare Relationsbereiche. Organisationen bilden in S03 eine flache Liste ohne sichtbare Primär-/Sekundär-Unterteilung; `Organisation verknüpfen` legt über den internen Primärpfad an. Personen bleiben in Primär und Sekundär getrennt und erlauben je Bereich 0..n Einträge. - Relationseinträge zeigen das verknüpfte Ziel als Link und die relationsbezogene Bezeichnung. Primär/Sekundär wird nur bei Personenrelationen gezeigt. Bearbeiten bleibt über das Zeilenmenü erreichbar. - Projekte/Vorgänge stehen als eigener Bereich `Weitere Verknüpfungen` und werden nicht mit Personen- oder Organisationsrelationen vermischt. - Systemgeführte Werte bleiben bewusst read-only, insbesondere Kundennummer und Verlaufseinträge. ### Gewählte Darstellungslogik - **Organisationen:** ein einziger Full-Width-Button `Organisation verknüpfen`; keine sichtbare Gruppenwahl. Die neue Relation wird in S03 automatisch dem Primärpfad zugeordnet. - **Personen:** ein Full-Width-Button `Person verknüpfen` öffnet ein Dropdown mit `Primär verknüpfen` und `Sekundär verknüpfen`. Erst danach öffnet die durchsuchbare Personenauswahl. - Eine optionale freie Relationsbezeichnung wird direkt in der neuen Zeile oder später per Zeilenklick bearbeitet. Sie blockiert die schnelle Verknüpfung nicht. - Über Zeilenklick/Zeilenmenü lassen sich Bezeichnung ändern, Personenrelationen zwischen Primär und Sekundär verschieben oder Relationen lösen. M04, M04b und M04c entfallen vollständig als separate Screens. - Kein Treffer bietet `Neue Organisation anlegen` bzw. `Neue Person anlegen` an und öffnet S04 bzw. S03 direkt im Anlagezustand. Der Relationskontext bleibt unsichtbar erhalten und wird nach dem ersten Speichern einmalig angewendet. Die visuelle Detailvalidierung ist abgeschlossen. Die Seite `S03 Review – Inline-Zeilen` ist trotz ihres bestehenden Subframe-Namens die vollständige S03-Source-of-Truth; daneben bleiben nur S03a–S03f als isolierte Werkzeug-Miniscreens bestehen. ## Aktionen - Inline-Edit der Stammdaten · Kontaktweg/Adresse hinzufügen, umbenennen und Standard setzen · Tag hinzufügen/entfernen · Organisation ohne sichtbare Gruppenwahl verknüpfen · Person über Primär/Sekundär-Dropdown verknüpfen · Relation inline bearbeiten/verschieben/lösen - Archivieren → [[M08 Kontakt archivieren]] · Zusammenführen-Hinweis bei Duplikat-Verdacht ## Banner / Hinweise - Duplikat-Verdacht: Banner »Ähnlicher Kontakt existiert« → Duplikat-Tool ## Zustände Die folgenden Relationszustände sind verbindliche Development-Vorgaben. | Zustand | Beschreibung | Umsetzung | |---|---|---| | Nicht gefunden / kein Recht | 404 | Wiederverwenden | | Laden / Fehler | A7 | Wiederverwenden | | Verlauf leer | »Noch keine Aktivitäten« | Nur dokumentieren | | Anlage: Vor- und Nachname leer | Inline-Validierung beim ersten Speichern | Nur dokumentieren | | Anlage: mögliches Duplikat | [[M01a Kontakt anlegen Duplikatwarnung]] | Bauen · validiert | | Anlage verlassen mit Eingaben | Verwerfen-Bestätigung | Nur dokumentieren | | Relation: kein Suchtreffer | Inline-Aktion `Neu anlegen`; Kontext nach Neuanlage anwenden | Nur dokumentieren | | Relation bereits vorhanden | keine Dublette; bestehende Zeile hervorheben | Nur dokumentieren | | Person-Person-Selbstbezug | eigener Kontakt nicht auswählbar | Nur dokumentieren | | Relation speichern fehlgeschlagen | Inline-Fehler, Eingabe bleibt stehen, erneut versuchen | Wiederverwenden | | Relation lösen | kompakte Bestätigung mit Zielname | Nur dokumentieren | ## Permissions / Gates `crm.*`; Schnell-Aktionen rechte-abhängig. ## Subframe - [Subframe](https://app.subframe.com/f023064a5ca0/design/13a46cd7-44b6-4495-bad5-57eb1ffc978a/edit) ## Notizen - S03 bleibt unabhängig von der Werkzeugvalidierung die gemeinsame Hauptreferenz. Bei Änderungen am Grundlayout wird nur S03 angepasst; S03a–S03f ändern sich ausschließlich, wenn sich der jeweilige rechte Werkzeugzustand ändert.