ScarriffleandClaude Opus 5
e503baa8a6
Im Downloads-Ordner lagen "certain-finance-export_....json" und "certain-finance-backup_....json" nebeneinander, ohne dass man sah, welche Datei sich zurueckladen laesst. Alle Downloads heissen jetzt certain-finance_<art>_<datum>_<uhrzeit>.<endung>, wobei die Art es sagt: vollbackup, vollbackup-system, datenuebersicht, buchungen, datenbank. Das persoenliche Vollbackup traegt zusaetzlich den Benutzernamen. Den Namen vergibt jetzt allein der Server im Content-Disposition-Kopf; das Frontend liest ihn von dort. Vorher erfanden beide Seiten ihn getrennt und kamen auf unterschiedliche Ergebnisse (Bindestrich gegen Unterstrich, UTC gegen Ortszeit). Zeitstempel ist Ortszeit: wer abends um 20 Uhr exportiert, soll keine Datei von 18 Uhr finden. Passend dazu heisst der Knopf "Alle Daten (JSON)" nun "Datenuebersicht (JSON)", und der Hinweis darueber sagt ausdruecklich, dass sich diese Dateien nicht zurueckladen lassen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
98 lines
4.3 KiB
Markdown
98 lines
4.3 KiB
Markdown
# 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.
|