54 lines
4.2 KiB
Markdown
54 lines
4.2 KiB
Markdown
# 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)
|
|
**Aktive Quellen:** zugehörige Ticket-Docs · `ROADMAP.md`/`ROADMAP-V2.md` · `REQUIREMENTS.md` · `ENTITY-MODEL.md`.
|
|
**Subframe:** Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A5 Modal, A6 Settings).
|
|
🖥️ **Interim-UI gebaut (AD-28):** lauffähige Screen-Referenz + genutzte Elemente/VM/Actions in `../HiveGrid-Wireframes/Tickets/Interim-Handover/P06-CRM.md`. Layout bleibt frei.
|
|
|
|
> 🔴 **Pivot-Vorrang (AD-20):** Für den CRM-Kern gilt das **`ENTITY-MODEL.md`**. Es gibt **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/ROADMAP nachgezogen:
|
|
- [ ] Plane-Ticket (R-P6) aktualisiert:
|