Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/R-P6.md
T

3.8 KiB

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