# Backup & Wiederherstellung

## In der App

**Einstellungen → Backup & Export:**

- **Voll-Backup (JSON)** — alle eigenen Daten in einem versionierten Format, das
  sich in der App wieder einspielen lässt (siehe unten): Konten, Kategorien,
  Buchungen mit allen Feldern, Budget-Vorlage und Monatswerte, Schlagwortregeln,
  Import-Vorlagen, Dashboard-Layout und die persönlichen Einstellungen.
- **Buchungen (CSV/JSON)** und **Datenübersicht (JSON)** — Ansichts-Exporte zum
  Archivieren und Weiterverarbeiten, etwa in einer Tabellenkalkulation.
  Referenzen laufen dort über Namen und mehrere Tabellen fehlen: zum
  Wiederherstellen taugen sie **nicht**. Die App weist eine solche Datei beim
  Einspielen ausdrücklich ab, statt halb zu raten.
- **Komplettes DB-Backup** (nur Admin) — lädt eine konsistente Kopie der gesamten
  SQLite-Datenbank herunter (alle Nutzer). Erzeugt über die SQLite-Online-Backup-API,
  also auch bei laufendem Betrieb gefahrlos.
- **Systemweites Voll-Backup (JSON)** (nur Admin) — dasselbe JSON-Format über
  alle Benutzer hinweg, inklusive Benutzerkonten. Die Datei enthält
  **Passwort-Hashes und Zwei-Faktor-Geheimnisse** und ist wie ein Passwort zu
  behandeln.

### Dateinamen

Alle Downloads heissen `certain-finance_<art>_<datum>_<uhrzeit>.<endung>`, wobei
`<art>` sagt, worum es geht — das ist der Unterschied, den man im
Downloads-Ordner sehen muss:

| Datei | Zurückladbar |
|---|---|
| `certain-finance_vollbackup_<benutzer>_2026-08-20_1432.json` | ja |
| `certain-finance_vollbackup-system_2026-08-20_1432.json` | ja, nur Admin |
| `certain-finance_datenuebersicht_2026-08-20_1432.json` | nein |
| `certain-finance_buchungen_2026-08-20_1432.csv` / `.json` | nein |
| `certain-finance_datenbank_2026-08-20_1432.db` | ja, aber von Hand (siehe unten) |

Den Namen vergibt der Server im `Content-Disposition`-Kopf; über die Oberfläche
und über einen direkten API-Aufruf kommt dieselbe Datei also gleich benannt an.

## Wiederherstellen (JSON, in der App)

**Einstellungen → Backup zurückladen.** Die Datei wird zuerst nur geprüft; die
Prüfansicht zeigt, was darin steckt. Geschrieben wird erst nach Bestätigung.

Zwei Vorgehen:

- **Ersetzen** — die vorhandenen Daten werden gelöscht und durch das Backup
  ersetzt. Vorher legt der Server automatisch einen Schnappschuss der Datenbank
  unter `/var/lib/certain-finance/backups/pre-restore-*.db` an.
- **Ergänzen** — nichts wird gelöscht, nur Fehlendes kommt hinzu. Konten und
  Kategorien werden über den Namen abgeglichen, Buchungen über ihren
  Import-Hash beziehungsweise über Datum, Konto, Betrag und Empfänger. Budget,
  Regeln und Einstellungen bleiben unangetastet, wenn dazu schon etwas
  vorhanden ist — halb zusammengeführte Budgets wären nicht sinnvoll deutbar.

Ein **systemweites** Backup kann nur ein Admin einspielen, und nur ersetzend.
Da dabei die Benutzertabelle ausgetauscht wird, enden anschliessend alle
Sitzungen und man muss sich neu anmelden. Enthält die Datei keinen
Administrator, wird sie abgelehnt — sonst käme danach niemand mehr hinein.

Das Einspielen läuft in einer einzigen Transaktion: entweder geht alles durch,
oder es wird nichts geschrieben.

## Wiederherstellen (DB-Backup)

Die heruntergeladene `.db`-Datei ist die komplette Datenbank. Zum Wiederherstellen
im LXC:

```bash
systemctl stop certain-finance
cp certain-finance-YYYYMMDD-HHMMSS.db /var/lib/certain-finance/app.db
# WAL-/SHM-Reste entfernen, damit die Kopie sauber übernommen wird:
rm -f /var/lib/certain-finance/app.db-wal /var/lib/certain-finance/app.db-shm
chown certain-finance:certain-finance /var/lib/certain-finance/app.db 2>/dev/null || true
systemctl start certain-finance
```

## Datei-Backup (LXC)

Die Datenbank liegt unter `/var/lib/certain-finance/app.db`.

- **Proxmox-Snapshot:** `vzdump` des Containers sichert alles (empfohlen).
- **Cron-Kopie:** täglich eine konsistente Kopie ablegen und rotieren:

```bash
# /etc/cron.daily/certain-finance-backup  (ausführbar machen)
#!/bin/sh
D=/var/lib/certain-finance
mkdir -p "$D/backups"
sqlite3 "$D/app.db" ".backup '$D/backups/app-$(date +\%Y\%m\%d).db'"
# älter als 30 Tage löschen
find "$D/backups" -name 'app-*.db' -mtime +30 -delete
```

`update.sh` legt außerdem vor jeder Migration automatisch eine Kopie unter
`/var/lib/certain-finance/backups/pre-update-*.db` an.