# TC Ingelfingen

## Arbeitsstundenverwaltung

### Benutzeranleitung Für Administratoren

Diese Anleitung beschreibt die wichtigsten Funktionen der Arbeitsstundenverwaltung aus Sicht eines Administrators.

Administratoren verwalten die Anwendung, pflegen Vereinswerte und führen Sicherungs- und Wiederherstellungsaufgaben durch.

## 1. Anmeldung

Melden Sie sich mit Ihrer E-Mail-Adresse und Ihrem Passwort an.

Falls Sie Ihr Passwort vergessen haben, können Sie den Passwort-Reset über die Anmeldeseite nutzen.

## 2. Dashboard

Als Administrator sehen Sie im Dashboard die Gesamtübersicht über alle Mitglieder.

Angezeigt werden insbesondere:

- Pflichtstunden gesamt
- geleistete Stunden gesamt
- noch offene Stunden gesamt
- die jeweiligen Werte in EUR
- der Fortschritt der geleisteten Arbeitsstunden in Prozent

Zusätzlich wird ein Informationskasten angezeigt, sofern dieser vom Verein gepflegt wurde.

## 3. Profil

Über Ihren Namen oben rechts gelangen Sie in Ihr Profil.

Dort können Sie:

- Ihren Vornamen ändern
- Ihren Nachnamen ändern
- Ihr eigenes Passwort ändern

## 4. Benutzerverwaltung

Im Bereich `Benutzerverwaltung` können Sie:

- neue Benutzer anlegen
- Benutzer löschen
- Benutzerpasswörter zurücksetzen
- Benutzerrollen ändern

Die Benutzerliste ist nach Nachnamen sortiert und auf 50 Einträge pro Seite paginiert.

## 5. Stundenbuchung

Im Bereich `Stundenbuchung` können Sie:

- Stunden für Mitglieder buchen
- alle Stundenbuchungen einsehen
- einzelne Stundenbuchungen löschen

Die Liste der Stundenbuchungen ist auf 50 Einträge pro Seite paginiert.

## 6. Vereinskonfiguration

Im Bereich `Vereinskonfiguration` können Sie:

- Pflichtstunden pro Mitglied festlegen
- den Wert pro Stunde festlegen
- den Informationskasten im Dashboard pflegen
- Benutzerdaten als CSV exportieren
- Stundenbuchungen als CSV exportieren

## 7. Administration

Im Bereich `Administration` finden Sie erweiterte Verwaltungsfunktionen.

Dazu gehören:

- SQL-Dump herunterladen
- SQL-Dump wiederherstellen
- Benutzerdaten per CSV importieren
- alle Arbeitsstunden auf 0 zurücksetzen
- Logansicht aller Verwaltungsaktionen
- Logansicht als CSV exportieren

Die Logansicht ist auf 50 Einträge pro Seite paginiert.

## 8. SQL-Backup Und Wiederherstellung

Für vollständige Datensicherungen steht ein SQL-Dump zur Verfügung.

Empfohlene Vorgehensweise:

1. Laden Sie vor größeren Änderungen einen SQL-Dump herunter.
2. Bewahren Sie die Datei an einem sicheren Ort auf.
3. Verwenden Sie für eine Wiederherstellung ausschließlich vertrauenswürdige SQL-Dateien.

Wichtiger Hinweis:

- Die Wiederherstellung eines SQL-Dumps überschreibt die bestehenden App-Daten.

## 9. CSV-Import

Der CSV-Import dient zur Übernahme von Benutzerdaten.

Erwartet werden folgende Spalten:

- `firstname`
- `lastname`
- `email`
- `role`
- `hours_worked`

Benutzer werden anhand der E-Mail-Adresse erkannt.

## 10. Arbeitsstunden Zurücksetzen

Mit dieser Funktion werden alle gebuchten Arbeitsstunden aller Mitglieder auf 0 gesetzt.

Diese Funktion ist insbesondere für den Jahreswechsel vorgesehen und sollte nur mit entsprechender Sorgfalt verwendet werden.

## 11. Logansicht

In der Logansicht werden unter anderem folgende Aktionen protokolliert:

- Benutzer anlegen
- Benutzer löschen
- Rollen ändern
- Passwort zurücksetzen
- eigenes Passwort ändern
- Passwort per Reset-Link neu setzen
- erfolgreiche Anmeldungen
- erfolgreiche Abmeldungen
- Speichern von Vereinswerten
- CSV-Exporte
- CSV-Import
- Arbeitsstunden auf 0 setzen
- SQL-Dump exportieren und wiederherstellen

## 12. Passwort Vergessen

Falls Sie Ihr Passwort vergessen haben, können Sie den Reset-Link über die Anmeldeseite anfordern und anschließend ein neues Passwort vergeben.

## 13. Darkmode

Über den Schalter links neben `Abmelden` kann zwischen hellem und dunklem Farbschema gewechselt werden.

## 14. Abmelden

Bitte melden Sie sich nach Abschluss Ihrer Arbeiten stets über `Abmelden` ab.

## 15. Empfehlungen Für Den Betrieb

- Erstellen Sie regelmäßig SQL-Backups.
- Nutzen Sie CSV-Exporte für Auswertungen und Weitergaben.
- Prüfen Sie Importe vor der Ausführung sorgfältig.
- Dokumentieren Sie größere organisatorische oder technische Änderungen zusätzlich außerhalb der Anwendung.