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