Auswertung

1. Wofuer ist diese Funktion

Das Auswertungsmodul ist das zentrale Analyse-Werkzeug in Octoserv. Es ist ueber den Navigationspunkt "Auswertung" in der Sidebar erreichbar und ermoeglicht dynamische, filterbasierte Auswertungen aller Kontaktdaten im CRM-System.

Das Modul bietet eine leistungsfaehige Kombination aus flexiblem Filtersystem, konfigurierbarer Spaltendarstellung, visueller Diagramm-Analyse und einem Vorlagensystem zum Speichern und Wiederverwenden haeufig benoetigter Auswertungskonfigurationen. Ergebnisse koennen als CSV-Tabelle oder als PDF (mit Diagrammen und Tabelle) exportiert werden.

Je nach Berechtigungsstufe sieht ein Benutzer nur seine eigenen Kontakte oder die Daten des gesamten Teams -- inklusive Mitarbeitervergleichs-Diagrammen.

2. Ziel und Vorteil

• Dynamische Kontakt-Auswertung: Alle Kontaktfelder (Standard- und benutzerdefinierte Felder) koennen fuer Filter, Spaltenanzeige und Diagramm-Analyse verwendet werden. Es gibt keine fest vorgegebenen Berichte -- der Benutzer stellt sich seine Auswertung individuell zusammen.
• Visuelles Analyse-System: Bis zu drei Kontaktfelder koennen gleichzeitig als Diagramm visualisiert werden (Tortendiagramm oder Balkendiagramm). Globale Benutzer koennen zusaetzlich Mitarbeitervergleichs-Diagramme anzeigen lassen.
• Vorlagensystem: Haeufig benoetigte Auswertungskonfigurationen (Filter, Spalten, Analyse-Einstellungen) koennen als Vorlagen gespeichert, geladen und geloescht werden. Vorlagen werden beim Anwenden von Filtern automatisch aktualisiert.
• Dashboard-Integration: Gespeicherte Vorlagen koennen auf dem Dashboard angezeigt werden, sodass wichtige Auswertungen beim Einloggen sofort sichtbar sind.
• Export-Funktionen: Ergebnisse lassen sich als CSV-Datei (Tabellendaten) oder als PDF-Dokument (Diagramme und Tabelle) exportieren.
• Berechtigungsbasierte Datensicht: Non-globale Benutzer sehen automatisch nur ihre eigenen Kontakte. Globale Benutzer sehen alle Kontakte und koennen nach Mitarbeitern filtern und gruppieren.
• Flexible Spaltenauswahl: Die anzuzeigenden Tabellenspalten koennen per Checkbox ausgewaehlt und per Drag & Drop in der Reihenfolge angepasst werden.

3. Detaillierte Funktionsbeschreibung

3.1 Seitenstruktur

Die Auswertungsseite besteht aus folgenden Bereichen:

Topbar:

• Seitentitel "Auswertung" mit Ergebnisanzahl.
• Export-Button (Dropdown mit CSV und PDF).
• "Filter & Ansicht"-Button zum Oeffnen des Filterpanels.

Filterleiste (unterhalb der Topbar):

• Bis zu drei Analyse-Feld-Dropdowns (Feld 1, Feld 2, Feld 3) fuer die Diagramm-Visualisierung.
• Vergleichs-Checkboxen fuer Mitarbeitervergleich (nur fuer globale Benutzer sichtbar).
• Diagramm-Typ-Auswahl (Tortendiagramm oder Balkendiagramm).

Analyse-Bereich:

• Zeigt die generierten Diagramme an, wenn Analyse-Felder ausgewaehlt sind.

Ergebnistabelle:

• Tabellarische Darstellung der gefilterten Kontakte mit den ausgewaehlten Spalten.
• Farbmarkierung am linken Rand zur Kennzeichnung des zugehoerigen Mitarbeiters.
• Sortierung per Klick auf Spaltenkoepfe.

Pagination:

• Seitenweise Navigation bei grossen Ergebnismengen (Standard: 50 Eintraege pro Seite).

Filter-Panel (Slide-in von rechts):

• Wird ueber den "Filter & Ansicht"-Button geoeffnet.
• Enthaelt alle Filteroptionen, die Spaltenauswahl und die Vorlagenverwaltung.
• Kann per Schliessen-Button, Overlay-Klick oder Escape-Taste geschlossen werden.

3.2 Filter-Panel im Detail

Das Filter-Panel ist in aufklappbare Sektionen (Collapsibles) unterteilt:

3.2.1 Vorlage

• Dropdown zur Auswahl einer gespeicherten Vorlage.
• "Laden"-Button (Aktualisieren-Symbol): Laedt die ausgewaehlte Vorlage und wendet alle gespeicherten Einstellungen an.
• "Loeschen"-Button (Papierkorb-Symbol): Loescht die ausgewaehlte Vorlage nach Bestaetigungsdialog.

3.2.2 Zeitraum

Vordefinierte Zeitraumfilter fuer das Kontakt-Erstellungsdatum:

• Alle (kein Zeitfilter)
• Heute
• Diese Woche / Letzte Woche
• Dieser Monat / Letzter Monat
• Dieses Quartal / Letztes Quartal
• Dieses Jahr / Letztes Jahr
• Benutzerdefiniert (mit Von/Bis-Datumsfeldern)

3.2.3 Standard-Felder

Filteroptionen fuer haeufig verwendete Kontaktfelder:

3.2.4 Spalten anzeigen

• Alle verfuegbaren Kontaktfelder (Standard- und benutzerdefinierte Felder) werden als Checkbox-Liste angezeigt.
• Feste Spalten (ID, Vorname, Nachname, E-Mail) sind immer sichtbar und koennen nicht abgewaehlt werden.
• Zusaetzliche Spalten koennen per Checkbox ein- und ausgeblendet werden.
• Die Reihenfolge der Spalten kann per Drag & Drop geaendert werden (Drag-Handle am linken Rand jedes Eintrags).

3.2.5 Aktionsbuttons

• Filter anwenden: Wendet die aktuellen Filtereinstellungen an und laedt die Ergebnisse. Wenn eine Vorlage geladen ist, wird diese automatisch mit den neuen Einstellungen aktualisiert.
• Zuruecksetzen: Setzt alle Filter, Spalten und Analyse-Einstellungen auf die Standardwerte zurueck.
• Als Vorlage speichern: Oeffnet den Speichern-Dialog fuer Vorlagen.

3.3 Analyse-System (Diagramme)

Das Analyse-System ermoeglicht die visuelle Auswertung von Kontaktfeldern als Diagramme.

3.3.1 Analyse-Felder

• In der Filterleiste stehen bis zu drei Analyse-Feld-Dropdowns zur Verfuegung (Feld 1, Feld 2, Feld 3).
• Jedes Dropdown enthaelt alle verfuegbaren Kontaktfelder.
• Feld 2 und Feld 3 erscheinen nur, wenn das vorherige Feld einen Wert hat.
• Fuer jedes ausgewaehlte Feld wird ein eigenes Diagramm generiert.

3.3.2 Diagramm-Typen

• Tortendiagramm (Pie): Zeigt die prozentuale Verteilung der Feldwerte als Kreisdiagramm.
• Balkendiagramm (Bar): Zeigt die Feldwerte als horizontale oder vertikale Balken.

Der Diagramm-Typ kann ueber das Dropdown "Diagramm-Anzeige" gewechselt werden.

3.3.3 Einfache Analyse (Non-Global)

Benutzer ohne globale Berechtigung sehen fuer jedes ausgewaehlte Analyse-Feld ein einzelnes Diagramm, das die Verteilung der Feldwerte ueber ihre eigenen Kontakte zeigt.

Beispiel: Feld "Status" zeigt: "Im Gespraech: 3, Neuer Interessent: 3, Bestandskunde: 2" usw.

3.3.4 Mitarbeitervergleich (Global)

Benutzer mit globaler Berechtigung koennen den Mitarbeitervergleich aktivieren. Dabei werden pro Mitarbeiter individuelle Diagramme generiert sowie ein Gesamtueberblick ("Grand Total") und -- wenn die Vergleichs-Checkbox fuer ein Feld aktiviert ist -- ein Vergleichs-Balkendiagramm, das alle Mitarbeiter nebeneinander darstellt.

Vergleichs-Checkboxen:

• Neben jedem Analyse-Feld steht eine "Vergleich"-Checkbox (nur fuer globale Benutzer sichtbar).
• Wenn aktiviert, wird fuer dieses Feld ein zusaetzliches Vergleichs-Diagramm generiert, das die Werte aller Mitarbeiter gegenueberstellt.

Darstellung:

• Pro Mitarbeiter: Individuelle Diagramme fuer alle ausgewaehlten Felder.
• Grand Total: Gesamtuebersicht ueber alle Mitarbeiter.
• Vergleichs-Diagramm: Mehrfarbige Balken, die die Verteilung pro Mitarbeiter vergleichen.

3.4 Ergebnistabelle

• Die Tabelle zeigt die gefilterten Kontakte mit den ausgewaehlten Spalten.
• Am linken Rand jeder Zeile wird eine Farbmarkierung angezeigt, die den zugehoerigen Mitarbeiter kennzeichnet (Owner-Color).
• Sortierung: Die Ergebnisse koennen nach jeder sichtbaren Spalte sortiert werden (aufsteigend/absteigend). Standard-Sortierung ist nach ID absteigend.
• Spezielle Feldformatierung:
  • Mitarbeiter-ID (owner_id) wird als lesbarer Name angezeigt.
  • Datumsfelder werden im deutschen Format formatiert.
• Leer-Werte: Felder ohne Wert werden als Bindestrich "-" dargestellt.

3.5 Pagination

• Bei mehr als 50 Ergebnissen wird eine Seitennavigation angezeigt.
• Standard: 50 Kontakte pro Seite.
• Beim Seitenwechsel werden die Daten per AJAX nachgeladen.

3.6 Vorlagensystem

3.6.1 Vorlage speichern

Beim Klick auf "Als Vorlage speichern" oeffnet sich ein modaler Dialog mit folgenden Optionen:

Eine Vorlage speichert:

• Alle aktiven Filtereinstellungen (Zeitraum, Standard-Filter, benutzerdefinierte Filter).
• Die ausgewaehlten und geordneten Spalten.
• Optional die Analyse-Konfiguration (Felder, Diagramm-Typ, Vergleichs-Checkboxen, Gruppierung nach Mitarbeiter).

3.6.2 Vorlage laden

1. Waehlen Sie eine Vorlage aus dem Dropdown im Filter-Panel.
2. Klicken Sie auf den Laden-Button (Aktualisieren-Symbol).
3. Alle gespeicherten Einstellungen (Filter, Spalten, Analyse) werden wiederhergestellt.
4. Die Auswertung wird automatisch ausgefuehrt.

3.6.3 Automatische Aktualisierung

Wenn eine Vorlage geladen ist und der Benutzer auf "Filter anwenden" klickt, wird die Vorlage im Hintergrund automatisch mit den neuen Einstellungen aktualisiert (Silent Save). Die Einstellungen "Persoenliche Standardvorlage" und "Im Dashboard anzeigen" bleiben dabei unveraendert.

3.6.4 Vorlage loeschen

1. Waehlen Sie die zu loeschende Vorlage aus dem Dropdown.
2. Klicken Sie auf den Loeschen-Button (Papierkorb-Symbol).
3. Bestaetigen Sie den Loeschvorgang.
4. Die Vorlage wird unwiderruflich entfernt.

3.7 Dashboard-Integration

• Vorlagen, bei denen "Im Dashboard anzeigen" aktiviert ist, werden auf dem Octoserv-Dashboard als Diagramm-Widgets angezeigt.
• Mehrere Vorlagen koennen gleichzeitig im Dashboard erscheinen.
• Jedes Widget zeigt den Vorlagennamen als Ueberschrift und die gespeicherten Diagramme.
• Fuer globale Benutzer wird automatisch der Vergleichsmodus aktiviert, wenn mehrere oder alle Mitarbeiter ausgewaehlt sind.
• Die Dashboard-Widgets laden ihre Daten unabhaengig von der Auswertungsseite per AJAX nach.

3.8 Export-Funktionen

3.8.1 CSV-Export

• Exportiert die aktuell angezeigte Tabelle als CSV-Datei.
• Die Datei enthaelt die Spaltenkoepfe und alle sichtbaren Datenzeilen.
• Zusammenfassungszeilen (Auszaehlungen) werden nicht exportiert.
• Der Dateiname folgt dem Muster auswertung_JJJJ-MM-TT.csv.
• Kommas und Anfuehrungszeichen in Feldwerten werden korrekt escaped.

3.8.2 PDF-Export

• Erstellt ein PDF-Dokument mit Diagrammen und Datentabelle.
• Die PDF-Bibliotheken (jsPDF und jspdf-autotable) werden bei Bedarf dynamisch nachgeladen.
• Diagramme werden als Bilder in das PDF eingebettet.
• Waehrend der Erstellung wird ein Lade-Indikator ("PDF wird erstellt...") angezeigt.

3.9 Berechtigungssystem

Typische Rollen:

Datenfilterung im Backend:

• Non-globale Benutzer: Die SQL-Abfrage filtert automatisch mit WHERE owner_id = {user_id}. Der Benutzer sieht ausschliesslich seine eigenen Kontakte.
• Globale Benutzer: Kein automatischer Owner-Filter. Optional kann nach bestimmten Mitarbeitern gefiltert werden.

3.10 Felder-Typen

Das System unterscheidet zwischen zwei Feldtypen:

Core Fields (in der Kontakt-Tabelle):

• ID, Vorname (first_name), Nachname (last_name), E-Mail (email)
• Zugehoeriger Mitarbeiter (owner_id), Opt-In-Status (optin_status)
• Erstelldatum (date_created), Opt-In-Statusaenderung (date_optin_status_changed)

Custom Fields (in der Kontakt-Meta-Tabelle):

• Status, Quelle, Kampagnenstatus und alle weiteren benutzerdefinierten Felder.
• Diese Felder werden automatisch aus der Datenbank ermittelt und stehen in allen Dropdowns zur Verfuegung.

4. Benutzerdokumentation / Anwendung

4.1 Erste Auswertung erstellen

1. Navigieren Sie zu "Auswertung" in der Sidebar.
2. Klicken Sie auf "Filter & Ansicht" (oben rechts), um das Filter-Panel zu oeffnen.
3. Waehlen Sie unter "Zeitraum" den gewuenschten Zeitraum (z.B. "Dieser Monat").
4. Optional: Setzen Sie weitere Filter unter "Standard-Felder" (z.B. bestimmte Tags oder Opt-In-Status).
5. Unter "Spalten anzeigen" waehlen Sie die gewuenschten Spalten per Checkbox aus. Ziehen Sie Spalten per Drag & Drop in die gewuenschte Reihenfolge.
6. Klicken Sie auf "Filter anwenden".
7. Die Ergebnisse werden in der Tabelle angezeigt.

4.2 Diagramm-Analyse durchfuehren

1. Waehlen Sie in der Filterleiste bei "Feld 1" ein Kontaktfeld aus (z.B. "Status").
2. Optional: Waehlen Sie bei "Feld 2" und "Feld 3" weitere Felder fuer zusaetzliche Diagramme.
3. Waehlen Sie den gewuenschten Diagramm-Typ (Torten- oder Balkendiagramm).
4. Klicken Sie auf "Filter anwenden". Die Diagramme erscheinen oberhalb der Ergebnistabelle.
5. Globale Benutzer: Aktivieren Sie die "Vergleich"-Checkbox neben einem Feld, um einen Mitarbeitervergleich fuer dieses Feld zu generieren.

4.3 Vorlage speichern und wiederverwenden

1. Konfigurieren Sie Ihre Auswertung wie gewuenscht (Filter, Spalten, Analyse-Felder).
2. Klicken Sie im Filter-Panel auf "Als Vorlage speichern".
3. Geben Sie einen aussagekraeftigen Namen ein (z.B. "Monatsauswertung Status").
4. Optional: Setzen Sie Haekchen bei "Persoenliche Standardvorlage" und/oder "Im Dashboard anzeigen".
5. Aktivieren Sie "Aktuelle Analyse-Einstellungen speichern", wenn die Diagramme Teil der Vorlage sein sollen.
6. Klicken Sie auf "Speichern".
7. Die Vorlage steht ab sofort im Vorlagen-Dropdown zur Verfuegung.

4.4 Vorlage laden

1. Oeffnen Sie das Filter-Panel ("Filter & Ansicht").
2. Waehlen Sie im Dropdown unter "Vorlage" die gewuenschte Vorlage aus.
3. Klicken Sie auf den Laden-Button (Aktualisieren-Symbol).
4. Alle Filter, Spalten und Analyse-Einstellungen werden automatisch wiederhergestellt und die Auswertung ausgefuehrt.

4.5 Ergebnisse exportieren

CSV-Export:

1. Fuehren Sie die gewuenschte Auswertung durch.
2. Klicken Sie auf den "Export"-Button oben rechts.
3. Waehlen Sie "CSV Tabelle".
4. Die CSV-Datei wird automatisch heruntergeladen.

PDF-Export:

1. Fuehren Sie die gewuenschte Auswertung durch (idealerweise mit Diagrammen).
2. Klicken Sie auf den "Export"-Button oben rechts.
3. Waehlen Sie "PDF Charts + Tabelle".
4. Warten Sie, bis die PDF erstellt wurde (Ladeindikator wird angezeigt).
5. Die PDF-Datei wird automatisch heruntergeladen.

4.6 Tabelle sortieren

1. Klicken Sie auf einen Spaltenkopf in der Ergebnistabelle.
2. Die Tabelle wird nach dieser Spalte sortiert (absteigend).
3. Klicken Sie erneut auf denselben Spaltenkopf, um zwischen aufsteigender und absteigender Sortierung zu wechseln.

4.7 Auswertung auf dem Dashboard anzeigen

1. Erstellen Sie eine Auswertung mit Diagrammen (mindestens ein Analyse-Feld muss ausgewaehlt sein).
2. Speichern Sie diese als Vorlage und aktivieren Sie "Im Dashboard anzeigen" sowie "Aktuelle Analyse-Einstellungen speichern".
3. Beim naechsten Aufrufen des Dashboards werden die Diagramme als Widget angezeigt.
4. Mehrere Vorlagen koennen gleichzeitig fuer das Dashboard aktiviert sein.

5. Anwendungsbeispiele

Beispiel 1: Monatliche Status-Auswertung

Ein Vertriebsmitarbeiter moechte wissen, wie seine Kontakte auf die verschiedenen Status-Stufen verteilt sind. Er waehlt den Zeitraum "Dieser Monat", setzt das Analyse-Feld 1 auf "Status" und waehlt als Diagramm-Typ das Tortendiagramm. Nach dem Anwenden der Filter sieht er auf einen Blick, wie viele Kontakte in jeder Phase stehen ("Im Gespraech", "Neuer Interessent", "Bestandskunde" etc.).

Beispiel 2: Teamvergleich fuer den Manager

Ein Teamleiter mit globaler Berechtigung moechte die Leistung seiner Mitarbeiter vergleichen. Er waehlt als Analyse-Feld 1 "Status" und aktiviert die "Vergleich"-Checkbox. Das System generiert fuer jeden Mitarbeiter ein individuelles Status-Diagramm sowie ein Vergleichs-Balkendiagramm, das alle Mitarbeiter nebeneinander zeigt. Er speichert diese Ansicht als Vorlage mit Dashboard-Anzeige, sodass er den Vergleich taeglich beim Einloggen sieht.

Beispiel 3: Regionale Auswertung nach PLZ-Bereichen

Ein Verkaufsleiter moechte alle Kontakte im PLZ-Bereich 60000 bis 69999 analysieren. Er gibt im PLZ-Filter "60000" als Von-Wert und "69999" als Bis-Wert ein, waehlt als Analyse-Felder "Status" und "Quelle" und klickt auf "Filter anwenden". Er erhaelt eine regionale Uebersicht mit Diagrammen und einer Kontaktliste, die er als CSV fuer die weitere Bearbeitung exportiert.

Beispiel 4: Tag-basierte Kampagnenanalyse

Ein Marketingmitarbeiter moechte den Erfolg einer Kampagne auswerten. Er filtert nach dem entsprechenden Kampagnen-Tag, waehlt als Spalten zusaetzlich "Quelle" und "Kampagnenstatus" aus und setzt das Analyse-Feld auf "Kampagnenstatus". Das Tortendiagramm zeigt ihm die Verteilung der Kampagnenstatus-Werte und die Tabelle listet alle betroffenen Kontakte mit den relevanten Details auf.

Beispiel 5: Standard-Auswertung mit automatischem Laden

Ein Vertriebsmitarbeiter erstellt seine bevorzugte Auswertung (eigene Kontakte, Status und Quelle als Diagramme, alle relevanten Spalten sichtbar) und speichert sie als "Persoenliche Standardvorlage". Ab sofort wird diese Auswertung jedes Mal automatisch geladen, wenn er die Auswertungsseite aufruft -- ohne manuelles Konfigurieren.