Files
HiveGrid-Wireframes/02 Wireframes/P6 Kontakte und Organisationen/WF-P6 Kontakte und Organisationen/WF-P6 Kontakte und Organisationen.md
T

250 lines
23 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: wireframe-package
project: HiveGrid Screen Project
ticket: D-CRM
package: WF-P6 Kontakte und Organisationen
typ: Flow
status: Fertig / Development-Handoff
subframe: "https://app.subframe.com/f023064a5ca0/flow/68046dc7-bc93-4232-a0da-a406a8bd10b8/edit"
canvas: "WF-P6 Kontakte und Organisationen.canvas"
---
# WF-P6 Kontakte und Organisationen
Status: Fertig / Development-Handoff
Subframe-Link: [Subframe](https://app.subframe.com/f023064a5ca0/flow/68046dc7-bc93-4232-a0da-a406a8bd10b8/edit)
Canvas: [Canvas](<WF-P6 Kontakte und Organisationen.canvas>)
Stand: 2026-08-29
---
## 1. Kurzfassung
Ein bewusst schlankes CRM-Grundgerüst: getrennte, aber direkt umschaltbare Listen für Personen und Organisationen, Anlage direkt in der jeweiligen Detailansicht, lokale Relationspflege und kurze Duplikat-Entscheidung. S03 ist die einzige vollständige Kontakt-Detailreferenz im Pipeline-/Kanban-Muster; die sechs rechten Werkzeugzustände werden als isolierte Miniscreens gepflegt.
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Welches Ticket/Modul ist betroffen? | D-CRM (P6), Dev-Pendant R-P6 |
| Was soll der Nutzer am Ende schaffen? | Kunden finden, in 5 Sekunden im Bilde sein (Verlauf), Daten pflegen, Dubletten loswerden |
| Flow, Screen, Zustand oder Doku? | Screen-Cluster: 2 Listen, 2 Karteikarten mit je einem Anlagezustand, Inline-Relationspflege sowie Duplikat- und Archiventscheidung; erweiterte Datenpflege im Backlog |
| Welche Planning-Quellen wurden geprüft? | `ticket-docs/D-CRM.md`, ENTITY-MODEL (Pivot-Vorrang), SCREEN-MAP §2, HiveGrid Map |
| Was ist sicher im Scope? | Alles oben + Live-Duplikat-Check + Kontaktmodell (Typ/Status/Rolle) |
| Was ist sicher nicht im Scope? | Leads (D-P7), Pipelines (D-P8), Lead-Promotion-Modal (Pivot: existiert nicht mehr) |
| Admin/Normalrolle-Unterschiede? | `crm.*`-Rechte (read_own/read_all/write/delete/admin); bei read_own sieht man nur eigene |
| Unsichere Annahmen? | Inline-Anlegen in der Liste (Notion-Stil) — als Option dokumentiert, nicht v1-gebaut |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Ticket/Modul | D-CRM · Kontakte & Organisationen + Datenpflege |
| Nutzerrolle | Maximalansicht (Admin) |
| Startpunkt | Sidebar »Kontakte« |
| Ziel | Kontakt gefunden/angelegt/gepflegt; Historie sichtbar |
| Haupt-Archetyp | A2 kompakte Listen nach dem Aufgaben-Muster · A5 schlanke Modals · A3 Detail nach dem Pipeline-/Kanban-Muster |
| Bespoke-Anteil | Keiner; Side-by-Side-Merge ist die aufwendigste Einzelkomponente |
| Out of scope | Leads, Pipelines, Kampagnen-Anbindung (nur Anzeige im Verlauf) |
---
## 4. Finale Entscheidungen (2026-08-29)
| Entscheidung | Status | Notiz |
|---|---|---|
| Ein Kontaktmodell für beide Typen | genommen | Jeder Datensatz ist fachlich ein Kontakt; Typ = Person oder Organisation. »Kontakt« ist deshalb kein Status. |
| Zwei Listen mit direktem Wechsel | genommen | Personen und Organisationen werden nicht vermischt, sind aber über einen kompakten Switch erreichbar. `Neue Person` führt direkt in S03, `Neue Organisation` direkt in S04. |
| Anlage direkt in der Detailansicht | genommen 2026-08-29 | M01 und M02 entfallen vollständig. S03/S04 öffnen mit leeren Feldern im Anlagezustand; der erste gültige Speichervorgang wechselt dieselbe Ansicht in den normalen Detailzustand. |
| Personen ↔ Organisationen = n:m | genommen | Eine Person kann mehreren Organisationen angehören. Die Organisation kann mehrere Personen enthalten. |
| Primär-/Sekundärkontakt ist Relationsrolle | genommen | Die Rolle gilt pro Verknüpfung, nicht global an der Person. Organisationen besitzen zwei getrennte, jeweils mehrwertige Bereiche: primäre und sekundäre Ansprechpartner. Beide dürfen leer sein; es gibt keine Regel »genau ein Primärkontakt«. |
| Benannte Kontakt-Verknüpfungen | genommen | Jede Verknüpfung kann eine optionale, frei benennbare Funktion/Beziehung erhalten, z. B. `Verkaufsleiter`, `Mitarbeiter` oder `Ehepartner`. Die Bezeichnung liegt ausschließlich an der Verknüpfung, verändert den verknüpften Kontakt nicht und blockiert die schnelle Zielauswahl nicht. |
| Sekundärkontakte an Personen | genommen | Dieselbe Relationsmechanik deckt z. B. Ehepartner oder Mitbewohner ab. Eine Person darf mehrere andere Personen verknüpfen; die Beziehung wird je Verknüpfung benannt. |
| Statusmodell | genommen | Kein Status ist zulässig. `Interessent` → noch kein Kunde; `Kunde` → aktive/manuell gepflegte Kundenbeziehung; `Bestandskunde` → mindestens ein erfolgreich abgeschlossenes Projekt (automatisch, manuell übersteuerbar); `Ehemaliger Kunde` → explizit verlorene/inaktive Kundenbeziehung. Kein automatisches Zurückstufen ohne fachliches Ereignis. |
| Flexible Kontaktwege und Adressen | genommen · Backend-Delta | Telefonnummern, E-Mails und Adressen sind wiederholbare Listen mit frei wähl- bzw. beschreibbarem Typ. Standard- und Rechnungsadresse sind vorgegeben; beliebig viele weitere Adressen sind möglich. Jeder Nicht-Standard-Adressblock bietet `Standardadresse übernehmen` als direkte Button-Aktion. Projekte dürfen zusätzliche projektspezifische Adressen haben. |
| Wachsende Auswahllisten | genommen 2026-08-29 | Verantwortlich und Quelle sind durchsuchbare Single-Select-Dropdowns. Verantwortliche verwenden `DropdownMenuSelect.DropdownUserItem` mit Avatar, Name und sekundärer Information. Status bleibt ein normales Select, zeigt den gewählten Status und alle Optionen jedoch als farbkonsistente Badges nach dem Pipeline-Muster. |
| Anlage-Defaults und Verlassen | genommen 2026-08-29 | Bei Neuanlage wird `Verantwortlich` mit dem angemeldeten Nutzer vorbelegt, bleibt aber änderbar und kann geleert werden. Navigation mit Eingaben warnt vor dem Verwerfen; ein vollständig leerer Anlagezustand erzeugt keinen Datensatz. |
| Organisationsfelder | genommen | `Branche` und `Rechtsform` sind getrennte Felder; kein kombiniertes »Branche / Merkmal«. |
| Duplikatprüfung | genommen | Kurzer Entscheidungsdialog aus dem Anlagezustand von S03/S04: bestehenden Eintrag öffnen oder bewusst trotzdem anlegen; kein Anlageformular. |
| Relationspflege ohne Modal | genommen 2026-08-29 | In S03 verknüpft `Organisation verknüpfen` ohne sichtbare Gruppenwahl über den Primärpfad; `Person verknüpfen` bietet Primär/Sekundär im Dropdown an. In S04 bleiben primäre und sekundäre Ansprechpartner getrennte Zielbereiche. Ziel auswählen und Bezeichnung inline ergänzen; bestehende Relation ebenfalls in der Zeile bearbeiten, verschieben oder lösen. M04–M04c entfallen als Produktseiten. |
| Tags als Kontaktmerkmal | genommen | Tags bleiben an Kontakten nutzbar. Die eigene Verwaltungsoberfläche S06/M06 gehört jedoch nicht mehr zum P6-Hauptflow und wurde aus Subframe entfernt. |
| Subframe ohne App-Shell | genommen | Die P6-Seiten zeigen nur den eigentlichen Screen-Inhalt auf einer blanken Seite. Topbar und Sidebar werden im Flow bewusst nicht wiederholt. |
| Kontakt-Detail S03 | **Validiert 2026-08-29** | Einzige vollständige Source of Truth im Pipeline-nativen Dreispaltenmuster: Stammdaten und Kontaktwege links, Weitere Angaben oberhalb von Adressen/Relationen mittig, fester Werkzeugbereich rechts sowie schwebende Schnellaktionen unten. Die frühere S03-Seite wurde entfernt; `S03 Review – Inline-Zeilen` ist die kanonische Hauptseite. |
| Werkzeugzustände S03a–S03f | **Validiert 2026-08-29** | Sechs isolierte 340-px-Miniscreens für Projekte, Aufgaben, Dateien, Notizen, Verlauf und Aktivitäten. Sie enthalten keine Kopie der übrigen Detailseite und werden nur für den jeweiligen rechten Zustand gepflegt. |
| Organisations-Detail S04 | **Validiert 2026-08-29** | Auf der validierten S03-Struktur aufgebaut und ausschließlich auf Organisationsdaten sowie Primär-/Sekundär-Ansprechpartner angepasst. Zwei interne QA-Durchgänge liegen in der Versionshistorie; David hat den Gesamtflow anschließend abgeschlossen. |
| Archivieren bestätigen | genommen | M08 bleibt als einziger eigener Aktionsdialog neben der Duplikatentscheidung. Dieselbe dynamische Referenz gilt für Personen und Organisationen; bestehende Relationen werden beim Archivieren nicht gelöscht. |
| **Inline-Anlegen in der Liste (Notion-Stil)** | dokumentiert / später | Nicht Bestandteil des aktuellen Drafts. |
## 5. Kontakt-Datenmodell — finaler v1-Vertrag
### 5.1 Begriffe und Ebenen
- **Kontakt** bleibt der technische Oberbegriff. Im UI gibt es **Personen** und **Organisationen**. Der technische Typ sollte langfristig `person` statt `privatperson` heißen, weil eine Person auch Ansprechpartner einer Organisation sein kann und deshalb nicht automatisch ein Privatkunde ist.
- **Stammdaten** beschreiben den Datensatz selbst: Wer ist die Person bzw. Organisation?
- **Verknüpfungsdaten** gelten nur zwischen zwei Datensätzen: Welche Rolle hat diese Person bei dieser Organisation oder gegenüber einer anderen Person?
- **Projektdaten** gelten nur im Projekt: Auftraggeber, Bauherr, Rechnungsempfänger und Projekt-Ansprechpartner bleiben an `ProjektKontakt` und werden nicht zu dauerhaften Personenrollen.
- **Primär/Sekundär** ist nie eine globale Eigenschaft einer Person. Es ist nur die Ablage der konkreten Verknüpfung in einem der beiden Bereiche einer Organisation bzw. eines privaten Personenverbunds.
### 5.2 Empfohlener schlanker Feldumfang
| Ebene | v1-Standardfelder | Später / nur bei echtem Bedarf |
|---|---|---|
| Alle Kontakte | optionaler Beziehungsstatus, Verantwortlich, editierbare und durchsuchbare Quelle, Tags, Notiz, Sprache, Kunden-Nr., Kunde seit, erstellt/geändert/archiviert | weitere tenant-spezifische Werte über Eigene Felder |
| Person | Anrede, Titel, Vorname, Nachname; beliebig viele E-Mails und Telefonnummern mit beschreibbarem Typ + einem Standardwert; beliebig viele Adressen | Geburtsdatum, Geschlecht, Social-Profile und weitere private Daten nicht standardmäßig sammeln |
| Organisation | Organisationsname, Rechtsform, Branche; beliebig viele E-Mails/Telefonnummern und Adressen; Website, USt-IdNr., Handelsregister | Mitarbeiterzahl nur bei nachgewiesenem Filter-/Reporting-Bedarf |
| Rechnungsprofil | Rechnungsempfänger/-name, Rechnungs-E-Mail, Standard-Zahlungsziel, Versandweg, Rechnungsadresse | Werte werden beim Erstellen von Projekt/Rechnung übernommen und dort als eigener Stand überschreibbar bzw. historisch stabil gehalten |
| Person ↔ Organisation | In S03 direkte Organisationszuordnung ohne sichtbare Gruppenwahl und mit Primär als Default; in S04 Zuordnung zu `Primäre Ansprechpartner` oder `Sekundäre Ansprechpartner`; optionale frei benennbare Funktion, z. B. Mitarbeiter oder Verkaufsleiter | Gültigkeitszeitraum erst später, falls ehemalige Ansprechpartner relevant werden |
| Person ↔ Person | Inline-Zuordnung zu Primär/Sekundär; optionale frei benennbare Beziehung, z. B. Ehepartner, Familienmitglied oder Mitbewohner | keine lange Pflicht-Auswahlliste; weitere Semantik erst bei einem konkreten Workflow |
### 5.3 Primärkontakt-Regeln
1. Organisationen dürfen ohne Ansprechpartner existieren.
2. `Primäre Ansprechpartner` und `Sekundäre Ansprechpartner` sind zwei getrennte Listen mit jeweils **0..n** Personen. Es gibt bewusst keine Pflicht und keine Eindeutigkeitsregel für einen Primärkontakt.
3. In S04 startet das Hinzufügen direkt in der gewählten Primär-/Sekundärsektion. In S03 verwendet `Organisation verknüpfen` ohne sichtbare Gruppenwahl den Primärpfad; `Person verknüpfen` fragt Primär/Sekundär einmalig im Dropdown ab. Nach Auswahl des Ziels wird die Relation sofort erzeugt.
4. Die optionale Verknüpfungsbezeichnung wird an der Relation gespeichert und inline ergänzt. Sie blockiert die schnelle Auswahl nicht. Name, E-Mail, Telefon und sonstige Stammdaten des verknüpften Kontakts bleiben unangetastet.
5. Eine Person darf in mehreren Organisationen und in mehreren Person-Verknüpfungen vorkommen; jede Relation besitzt ihre eigene Gruppe und Bezeichnung.
6. Person-Person-Verknüpfungen dürfen keine Selbstbezüge erzeugen. Der private Verbund bleibt in v1 eine flache Liste und wird nicht rekursiv als Baum dargestellt.
### 5.4 Notwendige Backend-Deltas
- `KontaktArt` mischt heute Gruppierung (`hauptkontakt`/`sekundaerkontakt`) mit Beziehungsbezeichnung (`mitarbeiter`/`sonstige`). Diese Dimensionen trennen in **Gruppe** (`primaer`/`sekundaer`) und eine optionale, frei benennbare **Funktion/Beziehung**.
- Es gibt absichtlich keinen Unique-Zwang auf Primärkontakte. Pro Organisation/Person sind 0..n primäre und 0..n sekundäre Relationen erlaubt.
- `Kontakt.adresseId` durch eine Kontakt-Adress-Zuordnung ersetzen. `standard` und `rechnung` sind vorgegebene Adresstypen; weitere Typen/Bezeichnungen sind frei ergänzbar.
- E-Mail-Adressen erhalten wie Telefonnummern einen beschreibbaren Typ. Die Kontaktwege bleiben in v1 am Kontakt; die Relation speichert nur Gruppe und Bezeichnung. Organisationsspezifische Arbeits-E-Mail/Telefonnummern werden erst ergänzt, wenn dafür ein echter Workflow entsteht.
- Der Status ist optional: **kein Status** bedeutet reine gespeicherte Person/reiner Ansprechpartner ohne eigene Kundenbeziehung. `Interessent`, `Kunde`, `Bestandskunde` und `Ehemaliger Kunde` beschreiben nur eine tatsächlich vorhandene eigene Geschäftsbeziehung.
- Kunden-Nr. und `Kunde seit` sind gemeinsame Geschäftsdaten, nicht reine Organisationsfelder; auch eine Person kann selbst Kunde sein.
- Die Kundennummer ist systemgeführt und in der Detailansicht nur lesbar, bevorzugt oben rechts im Kopf statt als bearbeitbares Formularfeld.
- Rechnungsdefaults logisch als eigenes Profil behandeln. Projekt- und Rechnungswerte dürfen davon übernommen, müssen danach aber unabhängig überschrieben bzw. historisch stabil gespeichert werden können.
### 5.5 Bedienmuster für wiederholbare Felder
- Pro Telefonnummer und E-Mail gibt es einen Wert und eine beschreibbare Typbezeichnung. Vorgaben wie `Mobil`, `Privat`, `Geschäftlich` oder `Assistenz` beschleunigen die Auswahl; eigene Bezeichnungen bleiben möglich.
- Ein erster Eintrag ist sichtbar. Über `+ Telefonnummer hinzufügen`, `+ E-Mail-Adresse hinzufügen` bzw. `+ Adresse hinzufügen` können beliebig viele weitere Zeilen ergänzt werden.
- Genau ein Eintrag je Kontaktweg kann als Standard markiert werden; weitere Einträge bleiben gleichwertig erreichbar.
- Standard- und Rechnungsadresse sind als feste Adressblöcke vorbereitet. Weitere Adressen erhalten eine frei benennbare Bezeichnung.
- Adressblöcke sind auf- und zuklappbar, damit mehrere vollständige Adressen die Detailseite nicht unnötig verlängern.
### 5.6 Anlagezustand in S03/S04
- S01 öffnet S03 unmittelbar mit leeren Personenfeldern; S02 öffnet S04 unmittelbar mit leeren Organisationsfeldern.
- Es gibt kein vorgeschaltetes Kurzformular. Stammdaten, Kontaktwege, Adressen und Relationen werden auf derselben Detailarbeitsfläche gepflegt.
- Der erste gültige Speichervorgang legt den Datensatz an; dieselbe Ansicht bleibt geöffnet und wird zum normalen Detailzustand.
- Person: mindestens Vorname oder Nachname. Organisation: Organisationsname. Alle übrigen Felder folgen den Regeln der jeweiligen Detailansicht.
- Der Duplikat-Check führt aus S03 in M01a bzw. aus S04 in M02a. `Abbrechen` erhält die Eingaben im Anlagezustand.
- Geburtsdatum, Bankdaten und private Zusatzinformationen werden ohne konkreten Workflow nicht als Standardfelder aufgenommen.
## 6. Ablauf und Zustände
### Happy Path
1. Sidebar »Kontakte« → Liste, tippen/filtern, Kontakt öffnen.
2. Karteikarte: links Stammdaten direkt editieren; rechts im Verlauf sehen, was zuletzt lief (Anrufe, Mails, Notizen); Schnell-Aktion »Aufgabe« oder »Termin« direkt aus dem Kopf.
3. Neuer Kunde ruft an → `Neue Person` bzw. `Neue Organisation` → S03/S04 öffnet direkt im Anlagezustand → beim Tippen ggf. M01a/M02a `Mögliches Duplikat` → bestehenden öffnen oder bewusst speichern; kein M01/M02-Formular.
4. Relation ergänzen → in S03 Organisation direkt oder Person nach Primär/Sekundär-Wahl verknüpfen; in S04 die gewünschte Ansprechpartner-Sektion verwenden → Ziel suchen/auswählen → Relation steht sofort in der Liste; kein M04-Dialog.
5. Aufräumen: Einstellungen → Duplikat-Tool → Paar nebeneinander → Feld für Feld übernehmen → zusammenführen.
### Meldungs-/Error-States (validiert)
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|---|---|---|---|---|
| Fremder Kontakt bei `read_own` | 404 bzw. taucht in Liste nicht auf | ja | Wiederverwenden | Dev-Vorgabe |
| Mögliches Duplikat beim ersten Speichern | kurzer Entscheidungsdialog M01a aus S03 / M02a aus S04 | ja (Entscheidung) | Bauen · validiert | »Öffnen« / »Trotzdem anlegen« |
| Relationsziel bereits verknüpft | bestehende Zeile hervorheben, keine Dublette erzeugen | nein | Nur dokumentieren | gilt für S03/S04 |
| Person-Person-Selbstbezug | eigener Kontakt nicht auswählbar | ja (Auswahl) | Nur dokumentieren | gilt für S03 |
| Kein Relations-Suchtreffer | Inline-Aktion `Neu anlegen` | nein | Nur dokumentieren | S03/S04 im Anlagezustand öffnen, Relationskontext mitführen und nach dem ersten Speichern einmalig anwenden |
| Relation konnte nicht gespeichert werden | Inline-Fehler mit Wiederholen | ja | Wiederverwenden | Auswahl/Eingabe bleibt erhalten |
| Einzelnen Kontakt archivieren | M08 mit dynamischer Personen-/Organisations-Copy | ja (Aktion) | Bauen | reversibel; Relationen bleiben bestehen |
| Zusammenführen ist endgültig | Bestätigung mit Klartext | ja (Aktion) | Nur dokumentieren | »Kann nicht rückgängig gemacht werden« |
| Großer CSV-Export | läuft im Hintergrund + Meldung | nein | Nur dokumentieren | Benachrichtigung wenn fertig |
| Leere Liste (Filter/read_own) | Leer-Zustand mit Klartext | nein | Nur dokumentieren | »Keine Kontakte für diese Filter« |
### 6.1 Flow-Bereinigung — aktueller Stand
Die Bereinigung betrachtet ausschließlich ganze Funktionsbereiche im Hauptflow. Der Backlog ist ausdrücklich ausgenommen.
- S06 `Tags – Datenpflege` und M06 `Tag anlegen und bearbeiten` wurden aus dem Hauptflow und aus Subframe entfernt.
- Tags selbst bleiben als Kontaktmerkmal, Filter und Mehrfachaktion erhalten; entfernt wurde nur die eigene Verwaltungsoberfläche.
- M08 `Kontakt archivieren` bleibt als eigenständige Referenz, weil die notwendige Bestätigung sichtbar definiert sein soll.
- M01 `Kontakt anlegen` und M02 `Organisation anlegen` sind seit 2026-08-29 aus dem Produktscope und aus Subframe entfernt. S03/S04 übernehmen den Anlagezustand.
- M01a/M02a bleiben als von David bestätigte Duplikatentscheidung und werden direkt aus S03/S04 ausgelöst.
- M04, M04a, M04b und M04c sind seit 2026-08-29 aus dem Produktscope und aus Subframe entfernt. Ihre Aufgaben liegen vollständig als Inline-Interaktion in S03/S04.
- Die frühere S01a-Variante wurde nach Davids Freigabe in S01 integriert: Checkboxen sind dauerhaft links in der Tabelle sichtbar, die `BulkActionBar` erscheint bei aktiver Auswahl. Der separate Screen und der Button `Auswählen` wurden entfernt.
- Im Backlog wurde durch diese Bereinigung nichts geändert.
Der Subframe-Hauptflow umfasst aktuell **13 Seiten**: vier Kernseiten S01–S04, M08, die beiden Duplikatentscheidungen M01a/M02a und sechs isolierte Werkzeugzustände S03a–S03f. Die ausgewählte Inline-Zeilen-Seite ist selbst die kanonische S03; eine zusätzliche S03-Reviewseite existiert nicht mehr. M01/M02 und M04–M04c existieren ebenfalls nicht mehr als Subframe-Seiten.
---
## 7. Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | Kontakte-Liste | Liste | Bauen | `/contacts` | Validiert |
| S02 | Organisationen-Liste | Liste | Bauen | `/contacts/companies` | Validiert |
| S03 | Kontakt-Karteikarte inkl. Anlagezustand | Detail + Anlagezustand | Bauen | `/contacts/:id` + Neue Person | Validiert 2026-08-29 |
| S03a–S03d | Projekte · Aufgaben · Dateien · Notizen | Werkzeug-Miniscreens | Referenz | innerhalb S03 | Validiert 2026-08-29 |
| S03e–S03f | Verlauf · Aktivitäten | Werkzeug-Miniscreens | Referenz | innerhalb S03 | Validiert 2026-08-29 |
| S04 | Organisations-Karteikarte inkl. Anlagezustand | Detail + Anlagezustand | Bauen | `/contacts/companies/:id` + Neue Organisation | Validiert 2026-08-29 |
| M01 | Kontakt anlegen – Person | Entscheidungsdoku | Nicht bauen | ersetzt durch S03 Anlagezustand | Aus Subframe gelöscht 2026-08-29 |
| M01a | Person – Duplikatwarnung | Entscheidungsdialog | Bauen | aus S03 Anlagezustand | Validiert 2026-08-29 |
| M02 | Organisation anlegen | Entscheidungsdoku | Nicht bauen | ersetzt durch S04 Anlagezustand | Aus Subframe gelöscht 2026-08-29 |
| M02a | Organisation – Duplikatwarnung | Entscheidungsdialog | Bauen | aus S04 Anlagezustand | Validiert 2026-08-29 |
| M04–M04c | Relations-Modals | Entscheidungsdoku | Nicht bauen | ersetzt durch Inline in S03/S04 | Aus Subframe gelöscht 2026-08-29 |
| M08 | Kontakt/Organisation archivieren | Bestätigungsdialog | Bauen | aus S01–S04 | Validiert 2026-08-29 |
| S05 | Eigene Felder | Settings-Liste | Später | `/admin/custom-fields` | Backlog |
| S07 | Duplikat-Tool | Settings-Liste | Später | `/admin/duplicates` | Backlog |
| M03 | Zusammenführen (Seite an Seite) | Modal (groß) | Später | aus S07 | Backlog |
| D01 | Inline-Anlegen in Liste (Notion-Stil) | Idee | Später | in S01 | Dokumentiert |
| D02–D05 | Banner/Zustände (s. Tabelle) | Inline/Banner | Nur dokumentieren | — | Validiert |
---
## 8. Grid
```text
Sidebar -> S01 <-> S02 (direkter Switch)
S01 -> S03 (öffnen oder direkt im Anlagezustand) / S02 -> S04 (öffnen oder Anlagezustand)
S03 Anlagezustand -> M01a (mögliches Personenduplikat)
S04 Anlagezustand -> M02a (mögliches Organisationsduplikat)
S03: Organisation direkt über Primärpfad; Person über Primär-/Sekundär-Dropdown verknüpfen; kein M04
S04: Personen direkt in primäre/sekundäre Ansprechpartner-Sektion verknüpfen; kein M04
S03/S04 -> M08 (Archivieren bestätigen)
Einstellungen -> S05 / S07 -> M03 (Zusammenfuehren)
S03: vollständiges Pipeline-Detailmuster als Source of Truth
S03a–S03f: ausschließlich der rechte Werkzeugbereich für Projekte, Aufgaben, Dateien, Notizen, Verlauf und Aktivitäten
S03/S04 betten ein: Aufgaben V01 (P4), Datei-Sektion (P4), Verlauf-Drawer M03 (P3 Audit)
```
---
## 9. Screen-Pakete
- [[S01 Kontakte-Liste]] · [[S02 Organisationen-Liste]]
- [[S03 Kontakt-Karteikarte]] · [[S04 Organisations-Karteikarte]]
- [[M01a Kontakt anlegen Duplikatwarnung]] · [[M02a Organisation anlegen Duplikatwarnung]] — echte Duplikatentscheidungen
- [[M01 Kontakt anlegen]] · [[M02 Organisation anlegen]] — Entscheidungsdoku; nicht bauen
- [[M08 Kontakt archivieren]]
- [[M04 Kontakt verknuepfen]] — Entscheidungsdoku; nicht bauen
- [[S05 Eigene Felder]] · [[S07 Duplikat-Tool]] · [[M03 Zusammenfuehren]]
---
## 10. Nicht blockierende Folgethemen
- Inline-Anlegen in der Liste (D01) bleibt bewusst später und ist kein Bestandteil dieses Handoffs.
- Primär/Sekundär kann bei Person-Person-Verknüpfungen langfristig neutraler benannt werden; Datenmodell und Inline-Mechanik bleiben davon unberührt.
- Die Quick-Action `Anrufen` verwendet in v1 einen `tel:`-Link. AirCall folgt separat mit D-P15.
- Eigene Felder, Duplikat-Tool und Zusammenführen bleiben als S05, S07 und M03 im Backlog.
## Handoff-Check
- [x] Jeder Screen ist mit Umsetzung markiert.
- [x] Meldungs-/Error-State-Matrix ist ausgefüllt.
- [x] Subframe-Link ist eingetragen.
- [x] Alle 13 Live-Seiten wurden am 2026-08-29 per MCP gelesen und gerendert.
- [x] Obsidian-Paket, Canvas, Tracker und Ticket-Handoff sind synchron.