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

97 lines
7.2 KiB
Markdown

---
kind: screen
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
id: S04
screen: Organisations-Karteikarte
typ: Detail
umsetzung: Bauen
status: Validiert 2026-08-29
route: "/contacts/companies/:id"
subframe: "https://app.subframe.com/f023064a5ca0/design/a6fe8461-1728-49c2-96c0-005cea90b547/edit"
---
# S04 — Organisations-Karteikarte
## Ziel
Alles über eine Organisation, inklusive mehrerer primärer und sekundärer Ansprechpartner mit eigenen Relationsbezeichnungen.
## Pattern / Archetyp
A3 Detail auf der validierten S03-Struktur; organisationsspezifisch angepasst und final als Development-Referenz bestätigt.
## Anlagezustand
- `Neue Organisation` in S02 öffnet unmittelbar diese vollständige S04-Ansicht mit leeren Organisationsfeldern. Es gibt keinen vorgeschalteten M02-Dialog.
- Stammdaten, Kontaktwege, Adressen und Ansprechpartner werden auf derselben Arbeitsfläche gepflegt, die später die normale Organisations-Karteikarte bildet.
- Der erste gültige Speichervorgang legt die Organisation an; S04 bleibt geöffnet und wechselt ohne Erfolgsseite oder Navigation in den normalen Detailzustand.
- Der Organisationsname ist vor dem ersten Speichern Pflicht. `Kein Status` ist zulässig.
- Der Live-Duplikat-Check auf Name und E-Mail führt bei einem Treffer in [[M02a Organisation 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.
## Unterschiede zu S03
- Eigene, unabhängig mehrwertige Bereiche für **Primäre Ansprechpartner** und **Sekundäre Ansprechpartner**. Beide erlauben 0..n Personen; es gibt keinen Zwang auf genau einen Primärkontakt.
- Jede Zuordnung trägt eine frei benennbare Relationsbezeichnung wie `Geschäftsführerin`, `Mitarbeiter`, `Verkaufsleiter` oder `Bauleitung`. Diese Bezeichnung wird nicht am Personendatensatz gespeichert.
- Eine Person darf zusätzlich in weiteren Organisationen verknüpft sein.
- Branche und Rechtsform sind getrennte Felder.
- Status-Draft: kein Status · Interessent · Kunde · Bestandskunde · Ehemaliger Kunde.
- Telefonnummern und E-Mails sind beliebig wiederholbar und beschreibbar.
- Standard- und Rechnungsadresse sind vorbereitet; weitere benannte Adressen sind unbegrenzt ergänzbar und alle Adressblöcke auf-/zuklappbar.
- Die systemgeführte Kundennummer steht read-only oben rechts im Kopf.
- Rechter Werkzeugbereich identisch: Verlauf · Projekte · Aufgaben · Dateien · Notizen · Aktivitäten
## Finaler Subframe-Stand (2026-08-29)
- **Struktur:** S04 verwendet dieselbe blanke Pipeline-/Kanban-Detailfläche wie S03: Kopf, linke Datenspalte, mittlere Kontextspalte, fester 340-px-Werkzeugbereich rechts und schwebende Schnellaktionen unten. Eine App-Shell wird im Referenzscreen nicht wiederholt.
- **Organisations-Grunddaten:** Organisationsname, Rechtsform, Branche, Website, USt-IdNr., Handelsregister, optionaler Status und Verantwortlich. Personenfelder wie Anrede, Titel, Vorname und Nachname existieren in S04 nicht.
- **Echte Controls:** Rechtsform ist ein Select; Status zeigt konsistente Badges im Feld und in allen Optionen; Branche, Quelle und Verantwortlich sind durchsuchbar. Verantwortliche und Personenoptionen verwenden `DropdownMenuSelect.DropdownUserItem` mit Avatar, Name und sekundärer Information.
- **Kontaktwege:** E-Mail-Adressen und Telefonnummern verwenden dasselbe wiederholbare Muster wie S03. Typen sind frei beschreibbare TextInputs, der Standard wird über direkte Buttons gesetzt, jedes Zeilenmenü ist vollständig verdrahtet und pro Bereich dokumentiert eine leere Referenzzeile den unbefüllten Zustand. Das Zeilenraster wurde im zweiten QA-Durchgang kompakter gesetzt, damit Typ, Wert, Standardaktion und Menü nicht kollidieren.
- **Mittlere Spalte:** `Weitere Angaben` steht oberhalb von Adressen und Ansprechpartnern. Standard-, Rechnungs- und weitere benannte Adressen nutzen vollständige Akkordeons mit Straße, Nr., Adresszusatz, PLZ, Ort und Land. Nur Nicht-Standard-Adressen bieten `Standardadresse übernehmen`.
- **Ansprechpartner:** Primäre und sekundäre Ansprechpartner sind getrennte, jeweils mehrwertige Akkordeonbereiche mit 0..n Personen. Das Hinzufügen startet direkt in der gewählten Sektion mit durchsuchbarer Personenauswahl; eine zusätzliche Primär-/Sekundär-Abfrage entfällt. Linkname, Relationsbezeichnung und echtes Zeilenmenü bleiben getrennt.
- **Weitere Verknüpfungen:** Projekte/Vorgänge bleiben als eigener Bereich außerhalb der Ansprechpartnerlogik.
- **QA:** Nach dem initialen Aufbau wurden zwei vollständige Review-Durchgänge anhand der S03-Fehlerhistorie erstellt und nacheinander in die Versionshistorie dieser kanonischen S04-Seite übernommen. Geprüft wurden insbesondere echte Controls, sichtbare Dropdown-Inhalte, Suchfähigkeit, Standardlogik, leere Referenzzeilen, Min-Breiten/Paddings, vollständige Adressen und Relationsmenüs. Alte und temporäre S04-Seiten wurden danach entfernt.
## Ansprechpartner direkt in der Detailansicht pflegen
- `+ Hinzufügen` bleibt direkt an `Primäre Ansprechpartner` bzw. `Sekundäre Ansprechpartner`. Damit steht der Bereich bereits fest; eine zusätzliche Rollenwahl entfällt.
- Der Klick öffnet direkt unter der Überschrift eine kompakte, durchsuchbare Personenauswahl. Auswahl erzeugt die Relation unmittelbar; M04a wird nicht geöffnet.
- Die optionale freie Relationsbezeichnung kann direkt in der neuen Zeile oder später per Zeilenklick ergänzt werden. Sie blockiert die schnelle Auswahl nicht.
- Zeilenklick/Zeilenmenü erlaubt Bezeichnung ändern, zwischen Primär/Sekundär verschieben und Verknüpfung lösen. M04c entfällt.
- Bei keinem Treffer bietet die Auswahl `Neue Person anlegen` an und öffnet S03 direkt im Anlagezustand. Organisation und Zielbereich bleiben unsichtbar als Kontext erhalten und werden nach dem ersten Speichern angewendet.
## Relationszustände
Diese Zustände sind verbindliche Development-Vorgaben.
| Zustand | Verhalten | Umsetzung |
|---|---|---|
| Person bereits verknüpft | kein zweiter Eintrag; bestehende Zeile hervorheben/öffnen | Nur dokumentieren |
| Kein Suchtreffer | `Neue Person anlegen` anbieten und Relationskontext nach erstem Speichern anwenden | Nur dokumentieren |
| Speichern fehlgeschlagen | Inline-Fehler, Auswahl bleibt erhalten, erneut versuchen | Wiederverwenden |
| Verknüpfung lösen | kompakte Bestätigung mit Personenname | Nur dokumentieren |
## Anlagezustände
| Zustand | Verhalten | Umsetzung |
|---|---|---|
| Organisationsname leer | Inline-Validierung beim ersten Speichern | Nur dokumentieren |
| Mögliches Duplikat | [[M02a Organisation anlegen Duplikatwarnung]] | Bauen · validiert |
| Anlage verlassen mit Eingaben | Verwerfen-Bestätigung | Nur dokumentieren |
## Aktionen
- Ansprechpartner inline hinzufügen/bearbeiten/verschieben/lösen
- Archivieren → [[M08 Kontakt archivieren]]
## Zustände / Permissions
Wie S03.
## Subframe
- [Subframe](https://app.subframe.com/f023064a5ca0/design/a6fe8461-1728-49c2-96c0-005cea90b547/edit)