# R-P6 · P6 CRM-Kern | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Raffael | | **Phase** | P6 — CRM-Kern | | **Cycle/Fenster** | W2 — Plattform & CRM · fällig 2026-06-24 · Gate W2 (Noah-Demo #1) | | **Status** | geplant | ## Abhängigkeiten & Parallelität - **Blocked by:** `R-P5` (Apps-Engine), `AK-P4b` (Files/Tasks + EntityLink), `R-REFIT` (ER-Modell-Re-Fit — ✅ erledigt 16.06.) - **Blocks:** `R-P7` (Lead-Inbox), `AK-P14a` (Email/BCC), `AK-P15a` (Telefonie/Auto-Lead) - **Läuft parallel zu:** `AK-P19` (Plattform-Admin, eigener Host `admin.hivegrid.de`) — maximal isoliert, **kein Schema-Konflikt** (CRM-Domäne vs. Admin/Permissions). Eigene `prisma/schema/*.prisma` je Modul (AD-21). ## Was wir bauen Den CRM-Kern: **Kontakte, Firmen/Organisationen und Leads als typisierte First-Class-Entitäten** (kein Entity-Builder, AD-2) — mit Custom-Feldern, farbigen Tags, append-only Activity-Stream und Live-Duplikat-Schutz. Das ist das Fundament der Kern-Kette (**Lead → Projekt**, AD-20). `Kontakt` ist Oberbegriff: Kontakttyp (Privatperson/**Organisation**), Kontaktstatus (Kontakt/Kunde/Bestandskunde), Kontaktart (Haupt-/Sekundärkontakt = Rolle einer Relation). ## Benötigte Screens (Backend bedient — Design liefert `D-CRM`) | Screen [Route] | Kern-Inhalt | |---|---| | Kontakt-Liste [`/contacts`] | Tabelle + Filter (Verantwortlicher/Tags UND-ODER/Firma/Datum) + Bulk (Tag/Zuweisen/Archiv/CSV) | | Organisationen-Liste [`/contacts/companies`] | Name, Branche/Org-Merkmal, Kontakt-Anzahl, letzte Activity | | Kontakt-Detail [`/contacts/:id`] | Inline-Edit, verknüpfte Orgs + Rolle, Tags, Panels (Projekte/Dateien/Tasks), Custom-Felder, **Activity-Stream**, Quick-Actions | | Organisation-Detail [`/contacts/companies/:id`] | Analog + Kontakt-Verknüpfungen mit Primär-Markierung | | Custom-Felder [`/admin/custom-fields`] · Tag-Verwaltung [`/admin/tags`] · Duplikat-Tool [`/admin/duplicates`] | Admin-Verwaltung + Side-by-Side-Merge | ## Definition of Done - [ ] Entitäten typisiert + **RLS** auf allem Tenant-bezogenen; Entity-Builder raus (AD-2) - [ ] Listen server-seitig: filter / sort / paginate / bulk / CSV - [ ] Detail: Inline-Edit + **Activity-Stream** (append-only Event-Sourcing) + Custom-Felder - [ ] **Live-Duplikat-Check** beim Anlegen - [ ] **Lead → Projekt** Extension-Point vorbereitet (AD-20; volle Konvertierung in P7/P8) - [ ] SHK-Branchen-Custom-Felder als Template geseedet (`is_demo_data`) - [ ] Konnektor `tenantHasModule('crm')` (Sidebar + Routes + Actions gated) - [ ] `crm.*`-Permission-Bundle (read_own/read_all/write/delete/admin) + serverseitiger Owner-Filter ## Technische Bausteine - **Entities** (eigene `prisma/schema/crm.prisma`): `Kontakt`, `KontaktRelation` (self-ref Rolle haupt/sekundär), `KontaktEmail`/`KontaktTelefon` (1:N), `Activity` (polymorph `subject_type/id`, append-only), `CustomFieldDefinition`/`CustomFieldValue`, `Tag`/`TagAssignment` (polymorph). `core.prisma`/`accounts.prisma` nur für Relationen zu Tenant/User berühren (AD-21). - **Activity** = Event-Sourcing-Zentrale (Cross-Cutting); `actor_kind` user/system/automation/ki_agent. - Adressen über `Adresse`-Tabelle (Kontakt 1 Slot). - `is_demo_data`-Flag auf seedbaren Entitäten (Bulk-Lösch beim Echt-Start). ## Quellen (granular) - `ENTITY-MODEL.md` → **Domäne 5: Projekt-zentrischer CRM-Kern** (Kontakt/KontaktRelation/Activity/CustomField/Tag) + Cross-Cutting-Tabelle - `REQUIREMENTS.md` → `REQ-crm-*` (Modul 1) - `ROADMAP.md` → Phase 6 - `designer-briefs/P06-crm-kern.md` (Screens + UI-Elemente, Pivot-Vorrang-Hinweis) - `_bmad-output/specs/M01-crm-kern.md` (⚠ teils pre-pivot — ENTITY-MODEL hat Vorrang) ## Dev-Nachzug (nach Davids `D-CRM`-Delta) - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen - [ ] Plane-Ticket `R-P6` aktualisiert