Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/HiveGrid_CRM_Datenlogik_UX_Entscheidungen.md
T

9.4 KiB

HiveGrid CRM: Datenlogik und UX-Entscheidungen

Konsolidierte Grundlage fuer CRM-Kern, Pipeline-Views, Kontakte und Relations

Feld Inhalt
Projekt HiveGrid CRM / Pipeline-Grundstruktur
Dokumenttyp Produkt- und UX-Entscheidungsbriefing
Stand Nach Developer-Ruecksprache: keine Aenderungen erforderlich
Hinweis Die Screenshots wurden als Arbeitskontext genutzt, sind aber nicht Teil dieses finalen Dokuments, da mehrere Details inzwischen ueberholt sind.

Ziel: Dieses Dokument beschreibt die fachliche Datenlogik, Relationen und groben UX-Entscheidungen. Es trifft keine technischen Infrastrukturentscheidungen und ersetzt keine spaetere Detailumsetzung.

1. Executive Summary

Das CRM-Modell besteht aus einer klaren Vorstufe und einem zentralen Arbeitskern: LeadInput sammelt und qualifiziert eingehende Leads. Nach Weiterverarbeitung/Freigabe entsteht ein Projekt. Ab diesem Zeitpunkt ist Projekt der zentrale Datensatz, auf den Pipelines, Status, Kontakte, Aufgaben, Checklisten und weitere Arbeitsbereiche schauen.

Pipelines sind keine eigenen Objektarten. Namen wie Deal oder Auftrag sind nur Beispiele fuer frei konfigurierbare Views. Der Admin entscheidet, welche Pipelines existieren, wer sie sehen darf und welche Felder dort sichtbar oder verpflichtend sind.

Kontakt ist der Oberbegriff fuer Personen und Organisationen. Ob ein Kontakt Kunde ist, wird ueber einen Kontaktstatus abgebildet. Hauptkontakt und Sekundaerkontakt beschreiben die Kontaktart bzw. Rolle im jeweiligen Kontext.

Bereich Entscheidung Auswirkung fuer Screens
LeadInput Eigenes Tool und Vorstufe vor Projekt. Lead-Daten koennen spaetere Projektfelder vorbereiten, werden aber erst nach Freigabe vererbt.
Projekt Zentraler Arbeitsdatensatz nach Weiterverarbeitung. Projekt-Detail wird der wichtigste Kontext fuer Pipeline-Arbeit.
Pipeline Frei konfigurierbare View auf Projekte. Pipeline-Name, Zugriff, Felder und Pflichtlogik sind adminseitig steuerbar.
Kontakte Kontakt ist Oberbegriff; Typen sind Privatperson oder Organisation. Organisationen und Personen werden ueber klare Listen und Verknuepfungen erreichbar.
Inline Edit Verknuepfte Daten duerfen direkt inline bearbeitet werden. Edits schreiben auf den verknuepften Datenpunkt zurueck; Verlauf/Rollback sichert nachtraeglich ab.

2. LeadInput und Projekt

Grundlogik

LeadInput ist ein eigenes Tool. Dort werden Leads aus unterschiedlichen Quellen gesammelt, z. B. Formular, Website, Social Media, Leadliste, CSV-Import oder manuelle Erfassung.

LeadInput kann bereits Datenpunkte enthalten, die spaeter auch im Projekt relevant sind. Viele Felder koennen noch leer sein. Wenn eine Quelle oder API bereits passende Daten liefert, koennen diese frueh dem richtigen Datenpunkt zugeordnet werden.

Bei Weiterverarbeitung werden relevante Lead-Daten in ein Projekt vererbt. Die fachliche Trennung liegt zwischen Lead und Projekt, nicht zwischen Deal und Projekt.

Weiterverarbeitungsfreigabe

Jeder Lead braucht den Datenpunkt Weiterverarbeitungsfreigabe. Die genaue DSGVO-/Prozesslogik kann spaeter durch Developer bzw. Datenschutz abgestimmt werden. Fuer diese Strukturentscheidung ist wichtig, dass der Datenpunkt existiert.

Wert Bedeutung fuer die Produktlogik
Ja Lead darf in ein Projekt ueberfuehrt werden; relevante Daten koennen vererbt werden.
Nein Normale Projektanlage soll nicht stattfinden.
Unklar / Pruefen Weiterverarbeitung ist fachlich nicht eindeutig freigegeben; genaue Behandlung wird spaeter festgelegt.

3. Projekt und Pipelines

Projekt als Kern

Projekt ist der zentrale Arbeitsdatensatz. Alle Pipeline-Views, Aufgaben, Kontakte, Checklisten, Termine, Rechnungen und Integrationsdaten beziehen sich auf diesen Kern.

Pipelines als Views

  • Eine Pipeline ist eine frei benennbare Ansicht auf Projekte.
  • Begriffe wie Deal oder Auftrag sind nur Beispielnamen.
  • Ein Projekt ist genau einer Pipeline zugeordnet.
  • Eine Mehrfachsichtbarkeit wuerde ueber Duplikation laufen und waere dann ein eigenes Projekt.
  • Der UI-Begriff Status meint den Status innerhalb der aktuellen Pipeline.
  • Ein separater globaler Projektstatus wird vorerst nicht benoetigt.

Admin-Konfiguration

Admins koennen Pipelines anlegen, benennen und konfigurieren. Dazu gehoert:

  • Zugriff: Welche Personen oder Rollen duerfen die Pipeline sehen?
  • Feldsichtbarkeit: Welche Datenpunkte sind in der Pipeline sichtbar?
  • Pflichtfelder: Welche Felder sind pro Pipeline oder Status verpflichtend?
  • Statuswerte: Welche Spalten oder Schritte hat die Pipeline?

Nicht sichtbare Felder verschwinden nicht. Sie bleiben im Hintergrund erhalten und koennen z. B. fuer Admins oder andere Pipeline-Kontexte sichtbar sein.

4. Projektattribute und Unterbereiche

Projekt kann viele direkte Attribute haben. Gleichzeitig sollten wiederholbare oder eigenstaendige Bereiche nicht in ein einziges flaches Formular gezwungen werden.

Direkte oder direkt sichtbare Projektattribute Verknuepfte Bereiche / Unterbereiche
Projektname, Quelle, Promotion, Projekttyp, Status, Prioritaet, Start, Deadline, Auftragsvolumen, potenzieller Auftragswert, zustaendige Person, Projektleiter, Monteur, Projektadresse, separate Rechnungsadresse, separate Bauherradresse, projektbezogene Kommunikationsdaten. Kontakte, Termine, Rechnungen, Checklisten, Aufgaben, Aktivitaeten, Dokumente, API-/KWP-Felder.

Maengel

Maengel werden nicht als eigenes Modul verstanden. Sie werden ueber Checklisten abgebildet, z. B. als Checkliste mit dem Namen Maengel.

API-/KWP-Felder

API-/KWP-Felder sind im View-Kontext sichtbarkeitssteuerbare Felder. Ob sie in einer Pipeline sichtbar sind, entscheidet der Admin. Separat zu klaeren bleibt nur, welche Felder editierbar oder rein synchronisiert sind.

5. Kontaktmodell

Kontakt ist der Oberbegriff. Ein Kontakt kann eine Privatperson oder Organisation sein. Ob daraus Kunde oder spaeter Bestandskunde wird, laeuft ueber den Kontaktstatus.

Begriff Bedeutung
Kontakt Oberbegriff fuer CRM-Kontakte.
Kontakttyp Privatperson oder Organisation.
Kontaktstatus Klaert, ob der Kontakt z. B. Kontakt, Kunde oder Bestandskunde ist. Werte spaeter final definieren.
Kontaktart Hauptkontakt oder Sekundaerkontakt im jeweiligen Kontext.
Organisation Top-Level-Kontakt fuer Unternehmen, Einrichtungen oder andere Organisationen.

Organisationen

Es gibt keine harte Grundunterscheidung zwischen Unternehmen und oeffentlicher Einrichtung. Der Grundtyp bleibt Organisation. Falls spaeter benoetigt, kann ein optionales Organisationsmerkmal oder Rechtsformfeld ergaenzt werden, z. B. GmbH, KG, oeffentliche Einrichtung oder sonstige Organisation.

Hauptkontakt und Sekundaerkontakte

  • Beim Erstellen einer Organisation soll ein Hauptkontakt mit angelegt bzw. direkt sichtbar sein.
  • Mehrere Hauptkontakte sollen moeglich sein.
  • Sekundaerkontakte koennen zusaetzlich als Liste im Kontext erscheinen.
  • Bei Privatpersonen kann die Privatperson selbst als Hauptkontakt wirken.
  • Weitere Sekundaerkontakte koennen auch bei Privatpersonen verknuepft werden.

Ob diese Verknuepfung technisch Parent, Relation oder Link heisst, ist fuer die UX zweitrangig. Wichtig ist, dass die Kontakte miteinander verknuepft und im richtigen Kontext sichtbar sind.

6. Listen, Navigation und Ansichten

Listen

Fuer die Navigation sind zwei Einstiege sinnvoll:

  • Unternehmen oder Organisationen: Einstieg fuer Organisationsdatensaetze.
  • Kontakte: Einstieg fuer Personen und Ansprechpartner.

Personen sollen direkt suchbar sein, aber auch ueber Unternehmen bzw. Organisationen erreichbar bleiben. Die Kontaktliste sollte nach Unternehmen/Organisation filterbar sein.

Aggregierte und spezifische Ansichten

Pipeline-/Projektansichten sind aggregierte Arbeitsansichten. Sie duerfen Projekt-, Kontakt- und Organisationsdaten zusammen anzeigen, wenn das fuer den Arbeitskontext sinnvoll ist.

Spezifische Ansichten wie Organisation oder Kontakt zeigen primaer die eigenen Daten. Verknuepfte Projekte, Kontakte oder Pipelines erscheinen dort als Referenz oder Liste, nicht als komplett fremdes Hauptformular.

Inline-Bearbeitung und Verlauf

Verknuepfte Daten duerfen direkt inline bearbeitet werden. Ein Feld kann in einer Projektansicht sichtbar sein, fachlich aber zu Kontakt oder Organisation gehoeren. Der Edit schreibt dann auf den verknuepften Datenpunkt zurueck.

Die genaue visuelle Loesung ist UI-Ausfuehrung. Verlauf und Rollback sollen nachvollziehbar machen, was wann und von wem geaendert wurde.

7. Backlog

Folgende Module sind vorgemerkt, werden aber nicht in den ersten CRM-/Pipeline-Kern gezogen:

  • Baustelle
  • Supporttickets
  • Leistungspositionen
  • Zeiterfassung
  • Materialbedarf
  • Abnahme

8. Offene Punkte fuer spaetere Screens

  1. Heisst die Organisationsliste im UI Unternehmen oder Organisationen?
  2. Braucht es ein optionales Organisationsmerkmal/Rechtsform-Feld?
  3. Welche Kontaktstatus-Werte werden final benoetigt?
  4. Welche Pipeline-Statuswerte braucht die erste konkrete Pipeline?
  5. Welche Projektkopf-Felder sind in einer konkreten View sichtbar?
  6. Welche API-/KWP-Felder sind nur synchronisiert und welche editierbar?

Ende des konsolidierten Stands. Screenshots wurden bewusst nicht eingebunden, da sie nur als Arbeitskontext dienten und teilweise nicht mehr dem aktuellen Modell entsprechen.