CRM-Übersicht

Zweck

Die Seite /crm ist die zentrale Vertriebssicht: Sie listet alle Datensätze, für die das CRM-Tracking aktiv ist, mit Status, zuständigem Mitarbeiter, Branche, ICP-Einstufung, letztem Kontakt und Reaktionszeit. Die eigentliche Pflege passiert im CRM-Tab eines Kunden, Kontakts oder Standorts. Die Mechanik beschreibt das Konzept CRM & ICP.

Voraussetzungen

- Berechtigung `view:FE_Crm` + `view:CrmProfile`. - Für die Pflege: `create`/`update`/`delete:CrmProfile`, `create:CrmActivity`, `create:CrmOpportunity`. - Mindestens ein [Kunde](/customers), [Kontakt](/contacts) oder [Standort](/locations) mit aktiviertem CRM-Tracking.

Berechtigungen (CASL)

Action	Subject	Wirkung
view	FE_Crm	CRM-Seite und CRM-Tab sichtbar
view/create/update/delete	CrmProfile	Profil lesen, Tracking aktivieren/deaktivieren, Felder pflegen
view/create	CrmActivity	Timeline lesen, Ereignisse/Wiedervorlagen protokollieren
view/create	CrmOpportunity	Opportunities lesen/anlegen
view	Industry	Branchen-Auswahl
view	SocialLink	Social-Links am Profil

CRM-Tracking aktivieren

Ein CRM-Profil entsteht pro Datensatz über einen Schalter:

1. Öffnen Sie einen Kunden, Kontakt oder Standort.
2. Im Bereich „Allgemeine Daten" den CRM-Tracking-Schalter einschalten → SpeamCore legt das CrmProfile an (POST /crm-profiles) und blendet den Tab CRM ein.
3. Ausschalten löscht das Profil wieder (DELETE /crm-profiles/:id, Soft-Delete) und der Tab verschwindet.

Die Übersichtsseite (/crm)

Die Tabelle (GET /crm-overview) zeigt pro Profil:

Spalte	Bedeutung
Datensatz	Name + Typ (Kunde / Kontakt / Standort)
Status	lead / prospect / customer / inactive (farbcodiert)
Verantwortlich	Vertriebs-Owner (salesEmployeeId)
Branche	aus den Branchen-Stammdaten
ICP	Ja/Nein bzw. ICP-Score
Letzter Kontakt	jüngstes Timeline-Ereignis
Offene Wiedervorlagen	Anzahl fälliger Reminder
Reaktionszeit	Ø/letzte — grün/rot gegen die SLA-Schwelle (crmResponseSlaHours)

Mit Suche (Datensatz/Owner/Branche), Status-Filter und Sortierung (letzter Kontakt, offene Wiedervorlagen, Reaktionszeit). Ein Klick auf eine Zeile öffnet den CRM-Tab des Datensatzes.

Der CRM-Tab (Kunde / Kontakt / Standort)

Der Tab (/customers/:id/crm, /contacts/:id/crm, /locations/:id/crm) ist die Arbeitsfläche pro Datensatz und bündelt:

Profil-Felder

Feldname	Pflicht	Datentyp	Wirkung beim Ausfüllen	Voraussetzung
crmStatus	ja	lead/prospect/customer/inactive	Vertriebs-Status; steuert Filter/Farbe in der Übersicht	—
salesEmployeeId	nein	UUID (Mitarbeiter)	zuständiger Vertriebs-Owner	view:Employee
websiteUrl	nein	String	Website; Basis der KI-Bewertung (aus E-Mail-Domain vorbelegt)	—
industryId	nein	UUID (Branche)	Branche; treibt das automatische ICP	view:Industry
employeeSizeBand	nein	Größenklasse	Mitarbeitergröße (Dropdown)	—
isIcp / icpReason	—	Boolean / Text	Ideal-Customer-Kennzeichen + Begründung (auto oder manuell)	—
icpScore / icpRationale	— (read-only)	0–100 / Text	KI-Fit-Score + KI-Begründung	KI-Bewertung gelaufen

Dazu Social-Links (LinkedIn/Xing/…) und der Button KI-Bewertung (nur bei gesetzter Website) → startet POST /crm-profiles/:id/ai-assessment und zeigt das Ergebnis (Risiko, Trust-Score, Warnsignale, Positives, Empfehlungen, Quellen).

Opportunities

Pro Profil lassen sich Leistungen als Opportunity mit Priorität (low/medium/high) hinterlegen. Es gibt bewusst keine Phasen/Forecast — siehe Konzept.

Aktivitäts-Timeline

Der Verlauf führt automatische Ereignisse (Anlage, Angebote, Briefe, Audit) und manuelle Einträge zusammen. Über + Ereignis protokollieren Sie call / note / meeting / email / reminder — mit Zeitpunkt (rückdatierbar), Text, optionaler Wiedervorlage und Compliance-Markierung (POST /crm-activities).

Eine **Wiedervorlage** (`reminder`) wird aktuell als Timeline-Ereignis mit `remindAt` gespeichert und in der Übersicht als „offene Wiedervorlage" gezählt. Eine echte Aufgabe oder Push-Benachrichtigung daraus ist **noch nicht** angebunden.

Verknüpfungen zu anderen Modulen

• Kunden / Kontakte / Standorte — tragen die CRM-Profile (Tab „CRM").
• Verkaufsbelege / Briefe — speisen automatische Timeline-Ereignisse.
• Digitale Visitenkarten — Visitenkarten-Scan erfasst Kontakte/Leads.

Wiederverwendbare Konzepte

• CRM & ICP
• Berechtigungen verstehen (CASL)

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/crm-overview	zentrale Analyse aller Profile	view CrmProfile
GET	/api/crm-profiles	Profil-Liste	view CrmProfile
POST	/api/crm-profiles	Tracking aktivieren	create CrmProfile
PATCH	/api/crm-profiles/:id	Felder ändern	update CrmProfile
DELETE	/api/crm-profiles/:id	Tracking deaktivieren	delete CrmProfile
POST	/api/crm-profiles/:id/ai-assessment	KI-Website-Bewertung starten	update CrmProfile
GET	/api/crm-timeline	aggregierte Timeline (parentType+parentId)	view CrmActivity
GET/POST	/api/crm-activities	Ereignisse lesen/protokollieren	view/create CrmActivity
GET/POST	/api/crm-opportunities	Opportunities lesen/anlegen	view/create CrmOpportunity

Versionshinweise

• 2026-06-24: Initiale Veröffentlichung — CRM-Übersicht (/crm) und CRM-Tab (Profil-Felder, Opportunities, Timeline, KI-Website-Bewertung, Tracking-Toggle). Verifiziert an crmProfile.model.ts, crmOpportunity.model.ts, crmActivity.model.ts, crmProfile.router.ts, crmActivity.router.ts, CrmOverviewPage.tsx.