Administration

⚙️ Administration & Wartung

Die Administration umfasst Backup, Datenwiederherstellung und das Aktivitätsprotokoll.

---

💾 Backup & Restore

Das Backup-System sichert alle Datenbankdateien in einem komprimierten Archiv.

Backup erstellen

1. Navigiere zu Administration → Backup
2. Klicke auf 💾 Backup erstellen
3. Optional: Backup-Kommentar eingeben (z. B. „Vor Jahresabschluss 2024")
4. Bestätigen

Was gesichert wird:

• Alle .DBF-Datenbankdateien im SP5_DB_PATH
• Alle .CDX-Indexdateien
• Anwendungskonfiguration

Speicherort: Die Backup-Datei wird als sp5_backup_YYYY-MM-DD_HH-MM.zip im backups/-Unterordner des Datenbankpfads gespeichert.

Automatische Backups: Konfigurierbar in den Einstellungen — tägliches oder wöchentliches automatisches Backup.

---

Backup herunterladen

1. Klicke auf das Backup in der Liste
2. ⬇️ Herunterladen — lädt die ZIP-Datei herunter

---

Backup wiederherstellen

⚠️ Achtung: Die Wiederherstellung überschreibt alle aktuellen Daten ohne Rückfrage. Erstelle vorher ein neues Backup!

Im Browser:

1. Navigiere zu Administration → Backup
2. Klicke auf das wiederherzustellende Backup
3. Klicke auf ↩️ Wiederherstellen
4. Bestätige den Warndialog
5. Die Anwendung startet automatisch neu

Manuell (Kommandozeile):

# Aktuellen Stand sichern
cp -r $SP5_DB_PATH $SP5_DB_PATH.bak.$(date +%Y%m%d)

# Backup entpacken
cd $SP5_DB_PATH
unzip /pfad/zum/backup/sp5_backup_2024-01-15_08-00.zip

# Backend neu starten
systemctl restart openschichtplaner5

---

Backup-Strategie (Empfehlung)

Frequenz	Wann
Täglich	Automatisches Backup nach Mitternacht
Vor jedem Jahresabschluss	Manuelles Backup mit Kommentar
Vor großen Importen	Manuelles Backup
Wöchentlich extern	Backup auf NAS oder Cloud kopieren

Aufbewahrung: Mindestens 4 Wochen lokal, 1 Jahr auf externem Medium.

---

📋 Aktivitätsprotokoll

Das Protokoll dokumentiert alle Änderungen, die im System vorgenommen wurden.

Was wird protokolliert?

Bereich	Protokollierte Aktionen
Dienstplan	Schicht eingetragen, geändert, gelöscht
Abwesenheiten	Eingetragen, geändert, gelöscht
Mitarbeiter	Angelegt, bearbeitet, gelöscht
Stammdaten	Schichtarten, Gruppen, Feiertage geändert
Zeitkonto	Manuelle Buchungen, Jahresabschluss
Benutzer	Login, Logout, Passwort geändert
Backup	Backup erstellt, wiederhergestellt
Import	Datei importiert (Anzahl Zeilen, Fehler)

Filter-Optionen

Filter	Beschreibung
Zeitraum	Von-Bis-Datum
Benutzer	Welcher Benutzer hat die Aktion ausgeführt
Bereich	Dienstplan / Mitarbeiter / Stammdaten / System
Mitarbeiter	Welcher Mitarbeiter war betroffen
Aktion	Erstellt / Geändert / Gelöscht

Protokoll-Eintrag Struktur

2024-03-15 09:23:14  |  admin  |  Dienstplan  |  GEÄNDERT
Mitarbeiter: Musterfrau Maria
Tag: 15.03.2024
Alt: Frühschicht (F)  →  Neu: Spätschicht (S)

Protokoll exportieren

Das Protokoll kann als CSV exportiert werden:

1. Filter setzen
2. Klicke auf 📤 Export als CSV

---

Datenbank-Wartung

CDX-Indexdateien

Die .CDX-Dateien sind Indexdateien zu den .DBF-Datenbankdateien.

⚠️ Niemals manuell bearbeiten! Beschädigte CDX-Dateien können zu Datenverlust führen.

Wenn ein CDX-Fehler auftritt:

1. Stoppe den Backend-Server
2. Spiele das letzte Backup ein
3. Starte neu

Speicherplatz prüfen

du -sh $SP5_DB_PATH
ls -lah $SP5_DB_PATH/*.DBF | sort -k5 -h

---

Weiter: Datenbankformat — Technisches zum DBF-Format