Arbeitseinsätze - Administrationshandbuch¶
Einführung¶
Das Arbeitseinsätze-Modul verwaltet alle Vereinsaktivitäten: von klassischen Arbeitseinsätzen über Vereinsfeste bis hin zu Jugendveranstaltungen. Hier können Sie Termine planen, Anmeldungen verwalten, Teilnahmen dokumentieren und Arbeitszeiten erfassen.
Übersicht der Menüpunkte¶
Im Administrationsbereich finden Sie unter ARBEITSEINSÄTZE folgende Bereiche:
| Menüpunkt | Zweck | Wann verwenden |
|---|---|---|
| Arbeitseinsätze | Hauptbereich für alle Termine und Veranstaltungen | Für Planung und Verwaltung aller Vereinsaktivitäten |
| Teilnehmer-Status | QR-Code An-/Abmeldungen verwalten | Bei Problemen mit der automatischen An-/Abmeldung |
| Arbeitszeiten | Arbeitszeiten erfassen und genehmigen | Für Zeiterfassung und Genehmigungsprozesse |
Arbeitseinsätze (Hauptbereich)¶
Navigation¶
Menüpunkt: Arbeitseinsätze → Arbeitseinsätze
Übersicht¶
In der Terminliste sehen Sie: - Title: Name des Termins/Einsatzes - Type: Art der Veranstaltung (Arbeitseinsatz, Fest, etc.) - Erforderlich: Anzahl benötigter Teilnehmer - Datum: Termin im Format DD.MM.YYYY - Uhrzeit: Startzeit - Dauer: Geplante Dauer in Stunden - Teilnehmer: Anzahl bestätigter Teilnehmer - Anmeldungen: Anzahl angemeldeter Mitglieder - Anmelde/Abmelde Option: QR-Code-Funktionen
Termine filtern und suchen¶
Suchfeld: Suche nach Titel, Beschreibung oder Veranstaltungsart
Filter (rechte Seitenleiste): - Datum: Nach Zeitraum filtern - Type: Nach Veranstaltungsart filtern (Arbeitseinsatz, Fest, etc.)
Neuen Termin anlegen¶
Navigation: Button "Arbeitseinsatz hinzufügen"
Grundinformationen¶
Pflichtfelder: - Title: Aussagekräftiger Name (z.B. "Gewässerpflege Hauptteich") - Type: Veranstaltungsart wählen - Description: Detaillierte Beschreibung der Tätigkeiten
Zeitangaben: - Date: Datum des Termins - Time: Startzeit - Dauer: Geplante Dauer in Dezimalstunden (z.B. 4.5 für 4:30h)
Zusätzliche Angaben: - Benötigte Teilnehmer: Gewünschte Teilnehmerzahl - Location Name: Ortsangabe (z.B. "Vereinsheim") - Location: GPS-Position (optional, über Karte wählbar) - Login/Logout Option: QR-Code-Funktionen aktivieren - Versteckt: Termin wird nicht in der App angezeigt
Veranstaltungsarten¶
| Art | Zweck | Typische Beispiele |
|---|---|---|
| Arbeitseinsatz | Vereinsarbeiten | Gewässerpflege, Reparaturen |
| Fest/Veranstaltung | Vereinsfeste | Sommerfest, Jahresversammlung |
| Räuchertermin | Fischverarbeitung | Forellen räuchern |
| Abgabetermin | Fristen | Fangmeldungen abgeben |
| Jugendtermin | Jugendarbeit | Angelkurse, Jugendausflüge |
| Sonstiges | Andere Termine | Schulungen, Besprechungen |
Gäste-Funktionalität (NEU)¶
Navigation: Termin anklicken → Reiter "Gäste-Einstellungen"
Seit der neuesten Version können bei Terminen auch Gäste zugelassen werden. Dies ist besonders nützlich für Vereinsfeste und Familienveranstaltungen.
Gäste-Einstellungen aktivieren¶
Beim Anlegen/Bearbeiten eines Termins: 1. Gäste erlauben: Aktivieren Sie diese Option 2. Max. Gäste pro Mitglied (optional): Begrenzen Sie die Anzahl der Gäste pro Mitglied (z.B. max. 5) 3. Max. Gesamtteilnehmerzahl (optional): Setzen Sie eine harte Obergrenze für alle Teilnehmer inkl. Gäste (z.B. max. 100 Personen)
Wie funktioniert die Gästeanmeldung?¶
- Standard: Gäste sind NICHT erlaubt (wie bisher)
- Mit Gästen: Mitglieder können bei der Anmeldung angeben, wie viele Gäste sie mitbringen
- Berechnung: Total = Mitglied (1) + Anzahl Gäste (z.B. 1 + 3 = 4 Personen)
- Validierung: System prüft automatisch gegen die gesetzten Limits
Anzeige und Verwaltung¶
In der Übersicht: - Neue Spalte "Personen gesamt" zeigt Gesamtanzahl (Mitglieder + Gäste) - Spalte "Gäste" zeigt ob und wie viele Gäste erlaubt sind
Im Registrierungen-Tab: - Inline-Formular zeigt pro Anmeldung die Gästezahl - Gesamtpersonenzahl wird automatisch berechnet - Bei Überschreitung der Limits erscheint eine Warnung
In Exporten (Excel/PDF): - Gäste werden bei Namen angezeigt: "Mustermann, Max (+3 Gäste)" - Gesamtpersonenzahl wird in Statistiken berücksichtigt
Verwendungsbeispiele
- Familienfest: Gäste erlauben, max. 5 pro Mitglied, max. 200 Personen gesamt
- Jugendveranstaltung: Gäste erlauben (Eltern), max. 2 pro Jugendmitglied
- Arbeitseinsatz: Gäste NICHT erlauben (Standard)
Anmeldungen und Teilnehmer verwalten¶
Navigation: Termin anklicken → Reiter "Teilnehmer"
Angemeldete Mitglieder (mit Through-Model)¶
- Was: Mitglieder, die sich über die App angemeldet haben
- NEU: Anmeldungen werden über das WorkAssignmentRegistration-Model verwaltet
- Gäste: Bei erlaubten Gästen wird die Gästezahl pro Anmeldung gespeichert
- Bearbeitung: Können manuell hinzugefügt/entfernt werden inkl. Gästezahl
Teilnehmer (bestätigt)¶
- Was: Mitglieder mit bestätigter Teilnahme
- Automatik: Bei Hinzufügung werden automatisch Arbeitszeit-Einträge erstellt
- Wichtig: Nur hier aufgeführte Personen erhalten Arbeitszeit gutgeschrieben
- Hinweis: Gäste erhalten KEINE Arbeitszeit, nur das Mitglied selbst
Automatische Arbeitszeit-Erstellung
Wenn Sie Mitglieder zu "Teilnehmer" hinzufügen, erstellt das System automatisch Arbeitszeit-Einträge mit den geplanten Start- und Endzeiten. Diese können später angepasst werden. Gäste werden dabei nicht berücksichtigt.
Aktionen in der Terminliste¶
Einzelne Termine auswählen¶
- Setzen Sie Häkchen bei den gewünschten Terminen
- Wählen Sie eine Aktion aus dem Dropdown-Menü
- Klicken Sie auf "Ausführen"
Verfügbare Aktionen:
| Aktion | Was passiert | Verwendung |
|---|---|---|
| Arbeitsaufträge exportieren | CSV-Export der Termine | Für weitere Bearbeitung in Excel |
| Transferiere Anmeldungen zu Teilnehmern | Angemeldete werden zu bestätigten Teilnehmern | Nach Abschluss der Anmeldephase |
| Export work assignment as excel | Excel-Export einzelner Termine | Detaillierte Teilnehmerlisten |
| Export multiple work assignments as excel | Excel-Export mehrerer Termine | Übersicht über mehrere Veranstaltungen |
Einzelnen Termin bearbeiten¶
Navigation: Klick auf den Terminname
Verfügbare Detail-Aktionen:
| Aktion | Zweck | Wo zu finden |
|---|---|---|
| Excel - Anmeldungen | Excel-Export mit Teilnehmerdaten | Button in der Einzelansicht |
| Email - Anmeldungen | E-Mail an alle angemeldeten Mitglieder | Button in der Einzelansicht |
Anmeldungen zu Teilnehmern übertragen¶
Diese Funktion ist besonders wichtig für den Arbeitsablauf:
- Anmeldephase: Mitglieder melden sich über die App an
- Übertragung: Administrator überträgt Angemeldete zu Teilnehmern
- Automatik: System erstellt Arbeitszeit-Einträge für alle Teilnehmer
- Nachbearbeitung: Zeiten können später angepasst werden
Wichtiger Hinweis
Führen Sie die Übertragung erst nach Abschluss der Anmeldephase durch. Nur als "Teilnehmer" markierte Personen erhalten Arbeitszeit gutgeschrieben.
E-Mail-Versand an Angemeldete¶
Navigation: Einzelnen Termin öffnen → "Email - Anmeldungen"
- Betreff eingeben: Kurze, aussagekräftige Betreffzeile
- Nachricht verfassen: Informationen für die Teilnehmer
- Versenden: E-Mails werden im Hintergrund versendet
Automatische Funktionen: - System prüft auf gültige E-Mail-Adressen - Nur angemeldete Mitglieder erhalten die E-Mail - Versand erfolgt asynchron im Hintergrund
Hintergrundverarbeitung
E-Mails werden im Hintergrund versendet. Sie erhalten eine Bestätigung über den gestarteten Versand. Bei vielen Empfängern kann dies einige Minuten dauern.
Teilnehmer-Status¶
Navigation¶
Menüpunkt: Arbeitseinsätze → Teilnehmer-Status
Zweck¶
Verwaltung und Kontrolle der QR-Code-basierten An- und Abmeldungen bei Terminen.
Übersicht¶
Die Liste zeigt: - Member: Name des Mitglieds - Work assignment: Zugehöriger Termin - Has logged in: Anmeldestatus (Ja/Nein) - Login timestamp: Anmeldezeit - Has logged out: Abmeldestatus (Ja/Nein) - Logout timestamp: Abmeldezeit
QR-Code-System¶
Funktionsweise: - Mitglieder scannen QR-Codes vor Ort - Automatische Erfassung von An-/Abmeldezeiten - Daten werden in Echtzeit gespeichert
Administrator-Aufgaben: - Kontrolle bei Problemen - Manuelle Korrekturen wenn nötig - Nachträgliche Zeiterfassung
Häufige Probleme und Lösungen¶
| Problem | Ursache | Lösung |
|---|---|---|
| Anmeldung fehlt | QR-Code nicht gescannt | Manuell auf "True" setzen und Zeit nachtragen |
| Falsche Zeit | Zeitzone/Uhrzeit-Problem | Timestamp korrigieren |
| Doppelte Einträge | Mehrfaches Scannen | Überflüssige Einträge löschen |
Tipp für Veranstaltungen
Kontrollieren Sie nach großen Veranstaltungen die Teilnehmer-Status, um sicherzustellen, dass alle An-/Abmeldungen korrekt erfasst wurden.
Arbeitszeiten¶
Navigation¶
Menüpunkt: Arbeitseinsätze → Arbeitszeiten
Zweck¶
Erfassung, Verwaltung und Genehmigung aller geleisteten Arbeitszeiten im Verein.
Übersicht¶
Die Liste zeigt: - Member: Name des Mitglieds - Start time: Beginn der Arbeitszeit - Work assignment: Zugehöriger Termin (optional) - End time: Ende der Arbeitszeit - Selbsteintragung: Vom Mitglied selbst erfasst (gelb markiert) - Status: Ausstehend/Genehmigt/Abgelehnt (farbig markiert) - Dauer: Berechnete Arbeitszeit in Stunden
Automatische Arbeitszeit-Erstellung¶
Wann passiert das: - Beim Hinzufügen von Teilnehmern zu einem Termin - Bei der Übertragung von Anmeldungen zu Teilnehmern
Was wird automatisch eingetragen: - Start time: Termindatum + geplante Startzeit - End time: Startzeit + geplante Dauer - Status: Automatisch "Genehmigt" (da vom Administrator erfasst) - Work assignment: Verknüpfung zum Termin
Selbsteingetragene Arbeitszeiten¶
Erkennung: Gelb markierte Zeile bei "Selbsteintragung" Status: Immer "Ausstehend" bis zur Administrator-Prüfung Besonderheiten: - Können Beweisfotos enthalten - Benötigen manuelle Genehmigung - Mitglied kann Grund/Kommentar angeben
Arbeitszeiten genehmigen/ablehnen¶
Einzelne Zeiten bearbeiten¶
- Klick auf den Eintrag: Detailansicht öffnen
- Prüfung: Kontrolle der Angaben und ggf. Beweisfotos
- Entscheidung: Status auf "Genehmigt" oder "Abgelehnt" setzen
- Begründung: Optional Notiz hinzufügen
- Speichern: Änderungen übernehmen
Massenbearbeitung¶
- Auswahl: Häkchen bei gewünschten Einträgen setzen
- Aktion wählen:
- "Ausgewählte Arbeitszeiten genehmigen"
- "Ausgewählte Arbeitszeiten ablehnen"
- Ausführen: Alle ausgewählten Einträge werden entsprechend bearbeitet
Arbeitszeit-Status erklärt¶
| Status | Bedeutung | Aktion erforderlich |
|---|---|---|
| Ausstehend (Gelb) | Selbsteintragung wartet auf Prüfung | Genehmigen oder ablehnen |
| Genehmigt (Grün) | Zeit ist anerkannt | Keine |
| Abgelehnt (Rot) | Zeit wurde nicht anerkannt | Optional: Begründung prüfen |
Besondere Arbeitszeiten¶
Freie Arbeitszeiten (ohne Termin)¶
- Work assignment: Leer/nicht gesetzt
- Zweck: Arbeiten außerhalb offizieller Termine
- Beispiele: Spontane Reparaturen, Einzelarbeiten
- Genehmigung: Immer erforderlich bei Selbsteintragung
Terminbezogene Arbeitszeiten¶
- Work assignment: Mit Termin verknüpft
- Vorteil: Automatische Vorbelegung der Zeiten
- Anpassung: Start-/Endzeiten können nachträglich geändert werden
Hintergrundprozesse¶
Folgende Prozesse laufen automatisch und sind nicht sofort sichtbar:
E-Mail-Versand¶
- Wann: Bei "Email - Anmeldungen" Aktion
- Erkennbar an: Bestätigungsmeldung "E-Mails werden gesendet"
- Dauer: Abhängig von Anzahl der Empfänger
- Fehlerbehandlung: Automatische Prüfung auf gültige E-Mail-Adressen
iCal-Kalender-Versand¶
- Wann: Automatisch bei Kalenderfunktionen in der App
- Was: Generierung und Versand von Kalenderdateien
- Inhalt: Alle aktuellen und zukünftigen Termine
- Format: Standard iCal (.ics) für alle Kalenderprogramme
Arbeitszeit-Einträge¶
- Wann: Bei Hinzufügung von Teilnehmern
- Was: Automatische Erstellung von WorkTimeLog-Einträgen
- Zeitberechnung: Basierend auf Termindatum, -zeit und -dauer
- Status: Automatisch "Genehmigt" (da Administrator-erfasst)
Arbeitsabläufe¶
Typischer Arbeitseinsatz planen¶
- Termin anlegen:
- Arbeitseinsätze → "Arbeitseinsatz hinzufügen"
- Grunddaten eingeben (Titel, Datum, Zeit, Dauer)
-
Anzahl benötigter Teilnehmer festlegen
-
Anmeldephase:
- Mitglieder melden sich über die App an
-
Optional: E-Mail-Erinnerung versenden
-
Vor dem Termin:
- Anmeldungen zu Teilnehmern übertragen
-
Teilnehmerliste als PDF für Unterschriften erstellen
-
Nach dem Termin:
- QR-Code An-/Abmeldungen kontrollieren
- Arbeitszeiten bei Bedarf anpassen
- Selbsteingetragene Zeiten prüfen und genehmigen
Vereinsfest organisieren¶
- Termin anlegen:
- Type: "Fest/Veranstaltung" wählen
- Höhere Teilnehmerzahl einplanen
-
QR-Code-Funktionen aktivieren
-
Vorbereitung:
- Mehrere Termine für Aufbau/Abbau anlegen
-
E-Mail-Kommunikation für Organisation
-
Durchführung:
- QR-Code-Stationen für An-/Abmeldung
- Mobile Kontrolle der Teilnehmer-Status
Selbstgemeldete Arbeitszeiten bearbeiten¶
- Regelmäßige Kontrolle:
- Filter auf "Selbsteintragung" setzen
-
Status "Ausstehend" prüfen
-
Einzelprüfung:
- Beweisfotos kontrollieren
- Kommentare lesen
-
Plausibilität prüfen
-
Entscheidung:
- Bei korrekten Angaben: Genehmigen
- Bei Problemen: Ablehnen mit Begründung
- Bei Nachfragen: Rücksprache mit Mitglied
Excel-Export für Auswertungen¶
- Einzelner Termin:
- Termin öffnen → "Excel - Anmeldungen"
-
Vollständige Teilnehmerliste mit Kontaktdaten
-
Mehrere Termine:
- Termine auswählen → "Export multiple work assignments as excel"
- Übersichtsliste für Statistiken
Arbeitsstunden-Sollvorgaben¶
Hierarchisches Konfigurationssystem¶
Das System verwendet ein hierarchisches Konfigurationssystem für Arbeitsstunden-Sollvorgaben. Die spezifischste verfügbare Konfiguration wird automatisch angewendet:
Prioritätsreihenfolge (höchste zu niedrigste): 1. Individuelle Mitglieder-Konfiguration - Spezifische Vorgaben für einzelne Mitglieder 2. Mitgliedschaftsstatus-Konfiguration - Basierend auf dem Status (z.B. Ehrenmitglied) 3. Gruppen-Konfiguration - Für alle Mitglieder einer Gruppe 4. Allgemeine Konfiguration - Standard für alle anderen
Konfiguration verwalten¶
Die Konfiguration erfolgt über zwei Bereiche:
- Allgemeine Sollstunden:
- Navigation:
Tenant Config → Konfigurationen → Arbeitsstunden-Sollvorgabe -
Basis-Sollstunden für alle Mitglieder
-
Spezifische Konfigurationen:
- Navigation:
Arbeitsstunden-Konfigurationim Hauptmenü - Separate Verwaltung für Gruppen, Status und individuelle Mitglieder
Ausgeschlossene Mitglieder¶
Mitglieder können von den Sollstunden-Vorgaben ausgeschlossen werden: - Automatisch: Durch Gruppen- oder Status-Konfiguration (0 Stunden) - Individuell: Durch spezifische Mitglieder-Konfiguration - In der Statistik: Ausgeschlossene Mitglieder erscheinen nicht in Rankings, sehen aber ihre geleisteten Stunden
API-Integration¶
Das System stellt Statistiken über die API bereit:
Endpunkt für Mitglieder-Statistiken¶
GET /api/workassignments/me/season-stats?season=2024
Response-Struktur:
- stats.target_hours: Sollstunden basierend auf hierarchischer Konfiguration
- stats.target_hours_source: Quelle der Konfiguration (member/status/group/general)
- stats.user_hours: Tatsächlich geleistete Stunden
- flags.is_user_excluded: Ob Mitglied von Sollstunden ausgeschlossen ist
- flags.user_exclusion_reasons: Gründe für Ausschluss
Datenschutz
Die API zeigt nur die eigenen Daten des angemeldeten Mitglieds. Ausschluss-Informationen anderer Mitglieder werden nicht preisgegeben.
Mitglieder-Arbeitsstatistiken¶
Navigation¶
Menüpunkt: Arbeitseinsätze → Mitglieder-Arbeitsstatistiken
Übersicht¶
Das Statistik-Modul bietet eine umfassende Übersicht über die geleisteten Arbeitsstunden aller Mitglieder. Hier können Sie: - Soll- und Ist-Stunden vergleichen - Rankings und Perzentile einsehen - Excel-Berichte generieren - Verschiedene Berechnungsmodi konfigurieren
Berechnungsmodi für Sollstunden¶
Das System unterstützt drei verschiedene Modi zur Berechnung der Sollstunden:
| Modus | Anzeige | Berechnung | Verwendung |
|---|---|---|---|
| Ohne Sollstunden | - |
Keine Sollstunden | Reine Vergleichsansicht |
| Feste Sollstunden | X.XXh (fix) |
Konfigurierter Festwert | Standard-Sollstunden für alle |
| Dynamische Berechnung | X.XXh (dyn) |
Verfügbare Arbeit / Aktive Mitglieder | Faire Verteilung basierend auf tatsächlicher Arbeit |
Dynamische Sollstunden-Berechnung¶
Formel: Gesamte verfügbare Arbeitsstunden / Anzahl berechtigter Mitglieder
Berechnung der verfügbaren Arbeitsstunden:
1. Alle Arbeitseinsätze (WA) und Feste (FE) im Jahr werden erfasst
2. Pro Termin: Dauer × Benötigte Teilnehmer = Verfügbare Stunden
3. Wichtig: Füllen Sie das Feld "Benötigte Teilnehmer" bei allen Terminen aus!
Intelligente Standardwerte: - Wenn "Benötigte Teilnehmer" nicht ausgefüllt ist, verwendet das System einen intelligenten Standardwert - Dieser basiert auf dem Durchschnitt der ausgefüllten Termine (konservativ: 50% des Durchschnitts, mindestens 3) - Empfehlung: Pflegen Sie die "Benötigte Teilnehmer" für genauere Berechnungen
Berechtigte Mitglieder¶
Nicht alle Mitglieder werden in die Statistik einbezogen. Folgende Filter werden angewendet:
Ausgeschlossen werden: 1. Inaktive Mitglieder - Nur aktive Mitglieder werden berücksichtigt 2. Bestimmte Mitgliedschaftsstatus - Konfigurierbar (z.B. Ehrenmitglieder) 3. Bestimmte Gruppen - Konfigurierbar (z.B. Jugend) 4. Altersgruppen - Konfigurierbar (z.B. unter 14 oder über 70 Jahre) 5. Einzelne Mitglieder - Manuell ausgeschlossene Personen
Excel-Export der Arbeitsstatistiken¶
Das System bietet zwei verschiedene Excel-Export-Funktionen für unterschiedliche Zwecke:
1. Export aller Arbeitsstunden (ungefiltert)¶
Navigation: Arbeitszeiten → Button "Alle Arbeitsstunden exportieren (ungefiltert)"
Zweck: Vollständige, ungefilterte Daten für Wirtschaftlichkeitsberechnungen
Besonderheiten: - ✅ ALLE Mitglieder (inkl. ausgeschlossene Gruppen und Status) - ✅ ALLE WorkTimeLogs (auch Ausstehende und Abgelehnte) - ✅ Rohdaten direkt aus der Datenbank - ❌ Keine Soll/Ist-Vergleiche - ❌ Keine Matrix-Ansicht
5 Excel-Sheets: 1. Alle Arbeitslogs - Vollständige Detailliste aller Einträge 2. Zusammenfassung pro Mitglied - ALLE aktiven Mitglieder (inkl. 0 Stunden) 3. Zusammenfassung nach Einsatz - Soll/Ist-Vergleich pro Arbeitseinsatz mit Farbkodierung 4. Zusammenfassung nach Typ - Ressourcenverteilung nach Veranstaltungsart 5. Zeitliche Entwicklung - Monatliche Trends und saisonale Muster
Excel-Features: - ✅ AutoFilter auf allen Sheets - Einfaches Filtern und Sortieren direkt in Excel - ✅ Farbkodierung - Differenzen visuell hervorgehoben (rot = Unterbesetzung, grün = Überbesetzung) - ✅ Formatierte Zahlen - Stunden mit 2 Dezimalstellen, Prozente korrekt formatiert - ✅ Soll/Ist-Analysen - Planungsqualität und Ressourceneffizienz bewerten
Verwendung: - Wirtschaftlichkeitsberechnungen - Buchhaltung und Finanzanalysen - Vollständige Datenarchivierung - Qualitätskontrolle der Rohdaten
2. Arbeitsstunden-Matrix Export¶
Navigation: Mitglieder-Arbeitsstatistiken → Button "Arbeitsstunden-Matrix exportieren"
Zweck: Statistische Auswertung mit Soll/Ist-Vergleich
Besonderheiten: - ✅ Nur berechtigte Mitglieder (gefiltert nach Konfiguration) - ✅ Soll/Ist-Vergleich mit Erfüllungsgrad - ✅ Matrix-Ansicht (Mitglieder × Arbeitseinsätze) - ✅ Monatliche Übersicht und Trends - ❌ Abgelehnte Einträge ausgeschlossen
4 Excel-Sheets: 1. Übersicht - Ranking mit Soll/Ist-Vergleich und Differenz 2. Arbeitsmatrix - Kreuztabelle Mitglieder × Termine (Pivot) 3. Detail-Arbeitslogs - Detaillierte Auflistung gefilterter Logs 4. Pivot-Übersicht - Monatliche Aggregation mit Trends
Verwendung: - Jahresabschluss-Berichte - Mitgliederversammlungen - Leistungsvergleiche und Rankings - Statistische Auswertungen - Planung zukünftiger Arbeitseinsätze
Welchen Export verwenden?¶
| Anwendungsfall | Export verwenden |
|---|---|
| Buchhaltung, Finanzanalyse | Export (ungefiltert) |
| Vollständige Archivierung | Export (ungefiltert) |
| Wirklich ALLE Mitglieder nötig | Export (ungefiltert) |
| Leistungsvergleiche | Matrix Export |
| Soll/Ist-Analysen | Matrix Export |
| Rankings und Statistik | Matrix Export |
| Monatliche Trends | Matrix Export |
Status- und Selbsteintragung-Spalten¶
Wichtig: Beide Exports zeigen die Spalten "Status" und "Selbsteintragung" nur bei Bedarf:
- Status: Nur ausgefüllt, wenn der Eintrag eine Selbsteintragung ist (
is_self_reported = True) - Selbsteintragung: Nur "Ja", wenn der Eintrag selbst eingetragen wurde
- Grund: Bei normalen Arbeitseinträgen (aus Arbeitseinsätzen) ist der Genehmigungsstatus nicht relevant
Technischer Hintergrund:
Normaler Eintrag (aus Arbeitseinsatz):
Status: [leer]
Selbsteintragung: [leer]
Selbsteintragung (genehmigt):
Status: Genehmigt
Selbsteintragung: Ja
Selbsteintragung (ausstehend):
Status: Ausstehend
Selbsteintragung: Ja
Detaillierte Dokumentation
Eine ausführliche Vergleichsdokumentation finden Sie unter:
- /claudedocs/work_hours_export_comparison.md - Vollständiger Vergleich
- /claudedocs/export_quick_reference.md - Schnellreferenz für Entwickler
Statistiken neu berechnen¶
Navigation: Aktionen → "Alle Statistiken neu berechnen"
Wann verwenden: - Nach Änderung der Berechnungsmodus-Konfiguration - Nach Änderung der Ausschluss-Filter - Bei Unstimmigkeiten in den angezeigten Werten - Nach Import/Migration von Daten
Was passiert: 1. Alle bestehenden Statistiken werden gelöscht 2. Für jeden berechtigten Nutzer werden neue Statistiken erstellt 3. Sollstunden werden nach aktuellem Modus berechnet 4. Rankings und Perzentile werden neu ermittelt
Häufige Probleme und Lösungen¶
Problem: Zu wenige Mitglieder in der Statistik¶
Ursache: Zu strenge Ausschluss-Filter
Lösung:
1. Prüfen Sie unter Tenant Config → Konfiguration:
- Ausgeschlossene Mitgliedschaftsstatus
- Ausgeschlossene Gruppen
- Ausgeschlossene Altersgruppen
2. Passen Sie die Filter an
3. Führen Sie "Alle Statistiken neu berechnen" aus
Problem: Dynamische Sollstunden zu niedrig¶
Ursache: Fehlende "Benötigte Teilnehmer" bei vielen Terminen Lösung: 1. Prüfen Sie alle Arbeitseinsätze des Jahres 2. Füllen Sie "Benötigte Teilnehmer" aus (realistische Werte!) 3. Alternative: System verwendet intelligente Standardwerte
Problem: Sollstunden werden angezeigt obwohl "Ohne Sollstunden" eingestellt¶
Ursache: Alte Statistikdaten im Cache Lösung: 1. Führen Sie "Alle Statistiken neu berechnen" aus 2. Ggf. Django-Server neu starten 3. Browser-Cache leeren (F5 / Cmd+R)
Community-Metriken¶
Die Statistik zeigt auch Vergleichswerte zur Vereinsgemeinschaft:
| Metrik | Bedeutung | Berechnung |
|---|---|---|
| Durchschnitt | Mittlere Arbeitsleistung | Summe aller Stunden / Anzahl Mitglieder |
| Median | Typische Arbeitsleistung | Mittlerer Wert bei Sortierung |
| Perzentil | Position im Ranking | % der Mitglieder mit weniger Stunden |
| Z-Score | Statistische Abweichung | Standardabweichungen vom Durchschnitt |
Konfiguration der Ausschluss-Filter¶
Navigation: Tenant Config → Konfiguration
Verfügbare Filter:
- Ausgeschlossene Mitgliedschaftsstatus
- Wählen Sie Status aus, die nicht arbeiten müssen
-
Beispiel: Ehrenmitglieder, Passive Mitglieder
-
Ausgeschlossene Gruppen
- Gruppen ohne Arbeitspflicht
-
Beispiel: Jugend, Senioren
-
Ausgeschlossene Altersgruppen
- Format:
{"min": 14, "max": 16}für 14-16 Jahre {"max": 14}für unter 14 Jahre-
{"min": 70}für über 70 Jahre -
Ausgeschlossene Einzelpersonen
- Manuelle Ausnahmen
- User-IDs als Liste
Wichtiger Hinweis zu Altersgruppen
Altersgruppen-Filter schließen Mitglieder INNERHALB des angegebenen Bereichs aus.
Beispiel: {"min": 14, "max": 16} schließt 14-, 15- und 16-Jährige aus.
Best Practices¶
- Regelmäßige Datenpflege
- Füllen Sie "Benötigte Teilnehmer" bei allen Terminen aus
- Aktualisieren Sie Mitgliedschaftsstatus zeitnah
-
Prüfen Sie Altersgruppen-Filter jährlich
-
Transparenz
- Informieren Sie Mitglieder über den Berechnungsmodus
- Erklären Sie Ausschluss-Kriterien in der Mitgliederversammlung
-
Stellen Sie Excel-Exporte zur Verfügung
-
Fairness
- Nutzen Sie dynamische Berechnung für faire Verteilung
- Berücksichtigen Sie Sonderfälle (Krankheit, Alter)
- Dokumentieren Sie Ausnahmen
Wichtige Hinweise¶
Arbeitszeit-Genehmigung
Selbsteingetragene Arbeitszeiten müssen manuell geprüft und genehmigt werden. Diese Zeiten sind für die Mitgliedschaftsauswertung relevant.
QR-Code-System
Das QR-Code-System funktioniert nur, wenn die entsprechende Option beim Termin aktiviert ist. Ohne Aktivierung können sich Mitglieder nicht vor Ort an-/abmelden.
Regelmäßige Wartung
- Prüfen Sie wöchentlich ausstehende Arbeitszeiten
- Kontrollieren Sie nach Veranstaltungen die QR-Code-Erfassungen
- Exportieren Sie regelmäßig Daten für Ihre Vereinsstatistik
Datenintegrität
- Löschen Sie Arbeitszeit-Einträge nur in Ausnahmefällen
- Arbeitszeiten sind für Mitgliedschaftsnachweise relevant
- Bei Fehlern korrigieren Sie die Daten, anstatt sie zu löschen
Bei Problemen¶
QR-Code funktioniert nicht: - Prüfen Sie die Login/Logout-Option beim Termin - Kontrollieren Sie die Internetverbindung vor Ort - Fallback: Manuelle Erfassung über Teilnehmer-Status
E-Mails kommen nicht an: - Prüfen Sie die E-Mail-Adressen der Mitglieder - Kontrollieren Sie Spam-Ordner der Empfänger - Bei Problemen: Einzelversand testen
Arbeitszeiten fehlen: - Prüfen Sie, ob Mitglieder als "Teilnehmer" (nicht nur "Angemeldet") markiert sind - Kontrollieren Sie die automatisch erstellten WorkTimeLog-Einträge - Bei Bedarf: Manuelle Nacherfassung