Skip to content

Datenablage

Joel Klein edited this page Aug 27, 2026 · 2 revisions

Datenablage

Es gibt drei Orte: das Gerät als Desktop-Anwendung, das Gerät im Browser und den Sync-Server. Die ersten beiden benutzen dieselben Pfade — src/lib/platform/fs.ts legt eine gemeinsame Abstraktion darüber.

Desktop-Anwendung

JSON im App-Daten-Ordner unter data/:

  • data/activities.json – Aktivitäten (global)
  • data/settings.json – Einstellungen (global)
  • data/entries-YYYY-MM.json – eine Datei pro Monat
  • data/timereport-YYYY-MM.json – eingelesener Zeitwirtschaftsreport, eine Datei pro Monat

Es wird nichts automatisch gelöscht. Unter „Einstellungen → Daten“ lassen sich ganze Jahre gezielt entfernen (mit Rückfrage) – die Reports des Jahres gehen mit; Monate ohne Einträge hinterlassen keine Datei.

Im Browser

Dieselben Pfade, aber kein Dateisystem: die PWA legt sie in IndexedDB ab, Datenbank timetracker, Object Store dateien (src/lib/platform/fs.ts). Löscht man die Websitedaten, sind sie weg — bei einem verknüpften Konto holt der Sync sie vom Server zurück.

Auf dem Server

Eine SQLite-Datei, $DATA_DIR/timetracker.db, vorgabegemäß /data/timetracker.db im Container. Sichern heißt: diese Datei kopieren, im laufenden Betrieb am besten über VACUUM INTO oder sqlite3 ... '.backup'.

Was der Server lesen kann und was nicht

Der Inhalt ist Chiffrat: die Spalte payload in records trägt das verschlüsselte Paket, den Schlüssel dazu hat der Server nie. Zeiten, Aktivitäten, Notizen und Einstellungen kann er nicht lesen.

Im Klartext liegen daneben:

Feld Inhalt
users Kontokennung, Anzeigename, optional E-Mail, Verwalter-Flag, Zeitstempel
credentials Passkeys: öffentlicher Schlüssel, Zähler, Bezeichnung, PRF-Fähigkeit
devices Bezeichnung je Gerät, Token-Hash, zuletzt gesehen, widerrufen
records.kind Art des Datensatzes, z. B. Eintrag oder Aktivität
records.bucket Zeitraum des Datensatzes, für gezieltes Nachladen
records.seq / rev / updated_at Reihenfolge und Stand für den Abgleich

Daraus lässt sich ablesen, wie viele Datensätze welcher Art es gibt, für welche Monate und wann zuletzt etwas geändert wurde — nur nicht, was darin steht. Wer das nicht preisgeben will, betreibt den Server selbst.

Siehe Server betreiben.

Clone this wiki locally