Files
HiveGrid-Wireframes/02 Wireframes/P6 Kontakte und Organisationen/WF-P6 Kontakte und Organisationen/Screens/S03 Kontakt-Karteikarte.md
T

133 lines
12 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: 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.