Files

4.1 KiB

Designer-Brief · P6 — CRM-Kern

Phase: 6/21 · Modul: M01 · Owner-Dev: Raffael (R-P6) · Designer: David (D-CRM, fällig 24.06. → Noah-Demo #1) Quellen: ROADMAP.md §Phase 6 · ENTITY-MODEL.md Domäne 5 (Projekt-zentrischer CRM-Kern) · SCREEN-MAP.md §2 · _bmad-output/specs/M01-crm-kern.md Subframe: Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A5 Modal, A6 Settings).

🔴 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 (das gehört zu P7 und ist jetzt Lead→Projekt). Kontakt ist Oberbegriff mit Kontakttyp (Privatperson/Organisation), Kontaktstatus (Kontakt/Kunde/Bestandskunde), Kontaktart (Haupt-/Sekundärkontakt = Rolle einer Relation). Zwei Listen-Einstiege: Unternehmen/Organisationen und Kontakte.

Was dieses Modul tut (Kurzfassung)

Kontakte, Firmen und Leads als typisierte First-Class-Entitäten verwalten — mit Custom-Feldern, Tags, append-only Activity-Stream und Live-Duplikat-Schutz. Es ist das Fundament der Kern-Kette (Lead → Projekt). Der Boilerplate-Entity-Builder ist entfernt (AD-2); Konfigurierbarkeit über CustomFieldDefinition/CustomFieldValue.

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
Firmen-/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
Firma-/Org-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.)

Geplante Features (muss abgedeckt sein)

  • Alle 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

Benötigte 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).

Davids Delta (David füllt aus)

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

Dev-Nachzug (wir nach Davids Delta)

  • Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
  • REQUIREMENTS/PHASE-SOURCES nachgezogen:
  • Plane-Ticket (R-P6) aktualisiert: