Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/D-CRM.md
T

56 lines
4.4 KiB
Markdown

# D-CRM · CRM-Cluster-Screens
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P6 — CRM-Kern (bedient `R-P6`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-22 → fällig 2026-06-24 |
| **Status** | geplant |
> 🔴 **Pivot-Vorrang (AD-20):** Für den CRM-Kern gilt das **`ENTITY-MODEL.md`**. Es gibt **kein Lead-Promotion-Modal** mehr (gehört zu P7, jetzt Lead→Projekt). `Kontakt` ist Oberbegriff mit **Kontakttyp** (Privatperson/Organisation), **Kontaktstatus** (Kontakt/Kunde/Bestandskunde), **Kontaktart** (Haupt-/Sekundärkontakt = Rolle einer Relation). Zwei Listen-Einstiege: Organisationen **und** Kontakte.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen A2/A3/A5/A6), `R-REFIT` (Boilerplate-Entity-Builder entfernt, Datenmodell-Refit)
- **Blockt:** `N-DEMO1` (Politur für Noah-Demo #1)
- **Bedient (Dev):** `R-P6` (CRM-Kern — Kontakt/Firma/Lead-Kernentitäten, Custom-Felder, Tags, Duplikat-Schutz)
- **Subframe:** Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A5 Modal, A6 Settings).
## Was wir bauen
Den **CRM-Cluster**: Kontakt- und Firmen-/Organisationen-Listen, das **Kontakt-Detail als Muster-Template** für alle Detail-Views (A3), Custom-Felder- und Tag-Verwaltung sowie das Duplikat-Tool. Fundament der Kern-Kette (Lead → Projekt). Erster fachlicher Screen-Cluster nach D0.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Kontakt-Liste [`/contacts`] | Avatar+Name, Firma, Email, Telefon, Tags, Verantwortlicher, letzte Activity · Filter (Verantwortlicher/Tags UND-ODER/Firma/Datum) · Bulk (Tag/Zuweisen/Archiv/CSV) | A2 |
| Organisationen-Liste [`/contacts/companies`] | Name, Branche/Org-Merkmal, Kontakt-Anzahl, Verantwortlicher, letzte Activity | A2 |
| **Kontakt-Detail** [`/contacts/:id`] | Stammdaten inline-editierbar · verknüpfte Firmen + Rolle (haupt/sekundär) · Tags · Panels (Projekte/Dateien/Tasks) · Custom-Felder · Notizen (Markdown) · **Activity-Stream** (inkl. BCC-gelogte Mails + Anrufe) · Quick-Actions (Anrufen/Email/Termin/Task/Tag) | A3 — Muster-Template für alle Detail-Views |
| Organisation-Detail [`/contacts/companies/:id`] | Analog + Kontakt-Verknüpfungen mit Primär-Markierung + Rolle | A3 |
| Custom-Felder [`/admin/custom-fields`] | Felder je Entity-Typ, Typ, Nutzungs-Anzahl, Quelle (SHK-Template/eigen), Sortierung, Archiv | A2 |
| Tag-Verwaltung [`/admin/tags`] | Name, Farbe, Verknüpfungs-Anzahl, Merge | A2 |
| Duplikat-Tool [`/admin/duplicates`] | Duplikat-Paare + Match-Kriterium · Side-by-Side-Merge (Feld-für-Feld) | A5 + Side-by-Side |
*(Lead-Inbox/Lead-Detail/Lead-Statistiken → P7. Audit/Notif/Files/Tasks-Oberflächen → P3/P4. Kein Lead-Promotion-Modal — Pivot.)*
## Features (muss abgedeckt sein)
- [ ] CRM-Kernentitäten typisiert mit RLS (Contact, Company, Lead, KontaktRelation, Activity, CustomField, Tag) — Entity-Builder entfernt (AD-2)
- [ ] Kontakt-Oberbegriff: Kontakttyp (Privatperson/Organisation), Kontaktstatus (Kontakt/Kunde/Bestandskunde), Kontaktart (Haupt-/Sekundärkontakt als Relation)
- [ ] Server-seitig Filtern/Sortieren/Paginieren + Bulk-Actions + CSV-Export
- [ ] Detail mit Inline-Edit, Activity-Stream (append-only Event-Sourcing), verknüpfte Entitäten, Custom-Felder
- [ ] SHK-Branchen-Custom-Felder als Template geseedet
- [ ] Live-Match-Check (Duplikat-Warnung) beim Anlegen
- [ ] `crm.*`-Permission-Bundle (read_own/read_all/write/delete/admin) — serverseitiger Owner-Filter prägt Empty/Permission-Denied-States
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Daten-Tabelle (sortierbar, paginiert); Filter-Bar (Multi-Select Tags UND/ODER); Bulk-Action-Toolbar; Detail-Panel mit Inline-Edit-Feldern; Tag-Chips (farbig); Relations-Liste mit Rollen-Badge; Activity-Timeline (Actor-Kind-Marker); Custom-Feld-Renderer je Typ; Quick-Action-Buttons; Duplikat-Banner/Hinweis; Side-by-Side-Merge-Ansicht; Empty-/Loading-/Permission-Denied-States (Klartext).
## Quellen (granular)
- `designer-briefs/P06-crm-kern.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → **Domäne 5: Projekt-zentrischer CRM-Kern** (Pivot-Vorrang: Kontakt-Oberbegriff/Kontakttyp/-status/-art, KontaktRelation; kein Lead-Promotion-Modal)
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev: