Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,54 @@
|
||||
# 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
|
||||
Reference in new issue
Block a user