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,162 @@
|
||||
# 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.
|
||||
|
||||
Reference in new issue
Block a user