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

4.5 KiB

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, nicht die teils noch pre-Pivot-SCREEN-MAP. Konkret: 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)
  • SCREEN-MAP.md → §2 · ROADMAP.md → Phase 6 · _bmad-output/specs/M01-crm-kern.md

Davids Delta (David füllt aus)

  • Überschriebene/geänderte Spec-Punkte:
  • Neue UI/UX-Entscheidungen:
  • Subframe-Screen-Link(s):
  • Offene Fragen an Dev: