Backup & Restore¶

Regelmäßige Datensicherung ist wichtig. DiKAS bietet sowohl manuelles als auch automatisches Backup.

Backup erstellen¶

Über die Oberfläche¶

Admin → Einstellungen → System → Backup

„Backup erstellen" klicken
DiKAS erstellt eine ZIP-Datei mit:
*.jsonl.br — Alle Dokumente (Brotli-komprimiert)
attachments/ — Bilder und Dateianhänge
ZIP herunterladen und sicher aufbewahren

Über die API¶

POST /api/v1/backup/create
Authorization: Bearer eyJ...

Was wird gesichert?¶

Daten	Enthalten?
Artikel und Gruppen	Ja
Kunden und Guthaben	Ja
Personal	Ja
Tische und Reservierungen	Ja
Kassenbons und Tagesabschlüsse	Ja
Ausgaben mit Belegen	Ja
Einstellungen	Ja
Gutscheine	Ja
Rechnungen und Mahnungen	Ja
Werkstatt-Aufträge	Ja
Disco-Daten	Ja
Artikelbilder	Ja
Kundendokumente	Ja

Restore (Wiederherstellung)¶

Vollständige Wiederherstellung¶

Admin → Einstellungen → System → Wiederherstellen

ZIP-Datei hochladen (max. 500 MB)
„Alles wiederherstellen" klicken
Fortschrittsbalken zeigt den Verlauf
Nach Abschluss: Neu anmelden

Warnung: Eine vollständige Wiederherstellung überschreibt alle aktuellen Daten!

Selektive Wiederherstellung¶

Sie können auswählen, welche Daten wiederhergestellt werden:

Kategorie	Inhalte	Wann nützlich?
Artikel	Artikel, Gruppen, Optionsvorlagen	Speisekarte zurücksetzen
Kunden	Kunden, Transaktionen	Kundendaten wiederherstellen
Personal	Mitarbeiter, Zeiterfassung	Personalstamm
Tische	Tische, Gruppen, Reservierungen	Tischplan
Einstellungen	Konfiguration, Drucker, Vorlagen	Nach Neuinstallation
Umsatzdaten	Bons, Ausgaben, Tagesabschlüsse	Historische Daten
Disco	Gäste, Eintrittsgruppen	Disco-Modul
Werkstatt	Aufträge	Werkstatt-Modul

Tipp: Nutzen Sie die selektive Wiederherstellung, um z. B. nur die Speisekarte aus einem Backup zu übernehmen, ohne die aktuellen Kassendaten zu verlieren.

Ablauf der Wiederherstellung¶

Upload → Entpacken → Kategorie-Filter → Dokumente einfügen → Anhänge wiederherstellen
                                           ↓
                                    Fortschritt via SignalR
                                    (Echtzeit-Balken im Browser)

Automatisches Backup (empfohlen)¶

Für produktive Systeme empfehlen wir ein automatisches Backup:

Per Cron-Job (Linux)¶

# Tägliches Backup um 4:00 Uhr
0 4 * * * curl -s -X POST http://localhost:5015/api/v1/backup/create \
  -H "Authorization: Bearer $TOKEN" \
  -o /backup/dikas_$(date +\%Y\%m\%d).zip

Docker-Volume sichern¶

# CouchDB-Daten sichern
docker run --rm -v couchdb-data:/data -v /backup:/backup \
  alpine tar czf /backup/couchdb_$(date +%Y%m%d).tar.gz /data

Datenbank-Migration¶

Von CouchDB zu SQLite/SQL Server¶

Wenn Sie die Datenbank wechseln möchten:

POST /api/v1/couch-to-sql/migrate
Content-Type: application/json

{
  "couchDbUrl": "http://localhost:5984",
  "couchDbUser": "admin",
  "couchDbPassword": "password"
}

Alle Daten werden von CouchDB in die SQL-Datenbank übertragen. Anhänge werden ins Dateisystem kopiert.

Nächster Schritt¶

→ TSE & Finanzamt — KassenSichV-Compliance