Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

TimeTracker

Zeiterfassung für Projektzeiten mit Monatsbericht per E-Mail an die Vorgesetzten. Läuft als Desktop-Anwendung im Tray oder im Browser. Die Zeiten gleichen sich über alle Geräte ab; was dabei auf dem Server liegt, ist Ende-zu-Ende verschlüsselt. Ausnahme ist der optionale Team-Modus: an das Team gesendete Berichte liegen lesbar beim Server, damit der oder die Vorgesetzte sie sieht.

Desktop Tauri 2 (Rust, Edition 2021), nur Windows
Oberfläche SvelteKit SPA (adapter-static), Svelte 5 Runes, TypeScript
Styling Tailwind CSS v4, shadcn-svelte
Server SvelteKit (adapter-node), SQLite über better-sqlite3, Drizzle
Anmeldung WebAuthn/Passkey, kein Passwort, keine E-Mail-Pflicht
Node 22
Lizenz MIT

Ausführliche Dokumentation im Wiki.

Download

Windows-Installer: https://github.com/joe2824/TimeTracker/releases/latest

Danach aktualisiert sich die Anwendung selbst — beim Start und stündlich. Von Hand über Einstellungen → System → „Nach Updates suchen". Kanäle und Manifeste: Releases.

Ohne Installation geht es im Browser gegen einen eigenen Server, siehe Server.

Features

  • Timer — Aktivität wählen, starten, stoppen. „Heute" zeigt alle Zeiten des Tages mit Bilanz aus erfasst, Pausenabzug und Arbeitszeit.
  • Aktivitäten — importieren, umbenennen, sortieren (Drag & Drop), Favoriten, ausblenden, archivieren; je Aktivität eine Farbe und ein globales Tastenkürzel.
  • Einträge — Tagesraster je Monat. Ein Eintrag hat gekoppelte Felder Von/Bis/Stunden, eines wird aus den anderen berechnet. Abwesenheiten als Zeitraum (halbe/ganze Tage, Wochenenden überspringen), Schnelleingabe, Kalender-Import.
  • Bericht — Monatsaggregation je Aktivität, Rundung, HTML-Vorschau, „HTML kopieren", Outlook-Entwurf.
  • Tray-Menü — Links-Klick öffnet Schnellstart mit laufendem Timer, Favoriten und zuletzt benutzten Timern. Tooltip zeigt die laufende Zeit.
  • Leerlauf-Erkennung — nach X Minuten ohne Eingabe: Zeit behalten, Leerlauf abziehen oder Eintrag verwerfen.
  • Auto-Stop-Warnung, Pomodoro/Pausen-Erinnerung, globaler Start/Stop-Hotkey, Autostart mit dem System.
  • Befehlspalette (Strg/Cmd+K) — Timer per Fuzzy-Suche starten und stoppen, Tabs wechseln.
  • Auswertung — Soll/Ist-Saldo, Stunden je Aktivität, Jahres-Heatmap. Lokal, nicht Teil der E-Mail, abschaltbar.
  • Automatischer Pausenabzug — ab 4 h Tagesarbeitszeit 15 Minuten, ab 6 h insgesamt 45. Abschaltbar.
  • Arbeitszeit-Check — schätzt nach ArbZG, ob der 24-Wochen-Schnitt von 8 h zu reißen droht und um wie viel man je Arbeitstag herunter müsste. Lokal, abschaltbar.
  • Zeitwächter-Abgleich — Zeitwirtschaftsreport (.xlsx) aus LOGA/Scout einlesen, fehlende Tage finden, Nachträge in einem Rutsch zuordnen.
  • Team-Modus (optional) — Der oder die Vorgesetzte legt Teams an und lädt per Link ein; Mitglieder brauchen kein Konto. Eine gemeinsame Aktivitätenliste gilt für alle. Wer seinen Monatsbericht sendet, erscheint im Tab „Team“ samt Stunden je Aktivität; diese Kopie liegt unverschlüsselt beim Server. CSV-Export, Sammel-Erinnerung an Fehlende, Verwalter als Vertretung.
  • Sync — Ende-zu-Ende verschlüsselt über einen eigenen Server. Passkey zum Anmelden, 24 Wörter zum Wiederherstellen, Kopplungscode für weitere Geräte.

Ausführlich im Wiki: Pausenabzug · Arbeitszeit-Check · Zeitwächter-Abgleich · Vorgesetzten-Modus · Datenablage

Server

Ein Container, ein Volume. Das Docker-Image enthält Oberfläche und Server.

docker pull ghcr.io/joe2824/timetracker-server:latest

Läuft auf linux/amd64 und linux/arm64 (Raspberry Pi).

Schnelle Verwaltung mit tt:

./tt invite "Für Alex" --days 14   # Einladung ausstellen
./tt users                        # Konten & Einladungen anzeigen
./tt admin "Anna"                 # Zum Verwalter ernennen
./tt backups                      # Vorhandene Sicherungen anzeigen
./tt update                       # Neuesten Code ziehen, sichern & aktualisieren

Pflicht-Umgebungsvariablen:

Variable Bedeutung
ORIGIN Adresse im Browser, z. B. https://tracker.example.de. Muss exakt stimmen, WebAuthn prüft sie.
RP_ID Hostname ohne Schema und Port. Passkeys hängen daran und überleben keinen Wechsel.
INVITE_CODES Temporärer Einladungscode für den ersten Admin-Zugang. Wichtig: Nach Ersteinrichtung leeren und ./tt restart ausführen, um statische Codes zu deaktivieren.

Ausführliche Anleitung: server/README.md und im Wiki unter Server betreiben.

Entwicklung

Voraussetzungen: Node.js 22, Rust-Toolchain, Tauri-Systemabhängigkeiten (https://v2.tauri.app/start/prerequisites/).

npm install            # Abhängigkeiten + svelte-kit sync (prepare)

npm run tauri dev      # Desktop-Anwendung im Entwicklungsmodus
npm run tauri build    # Release-Build inkl. Installer

npm run dev            # nur Oberfläche (Vite) im Browser
npm run dev:web        # dasselbe als PWA-Ziel (BUILD_TARGET=web)
npm run check          # svelte-check (Typen/Templates)
npm test               # Vitest

npm run server:dev     # Sync-Server
npm run server:build   # muss VOR server:test laufen
npm run server:test    # Durchstich spricht den gebauten Server über HTTP an

Autostart und Tray-Verhalten funktionieren nur im installierten Release-Build, nicht im Dev-Binary.

Projektstruktur

src/
  routes/+page.svelte          App-Shell, Tabs, Watcher/Hotkeys
  lib/
    app.svelte.ts              zentraler Zustand (Svelte 5 Runes)
    store.ts                   Datei-Persistenz (tauri-plugin-fs)
    time.ts / report.ts        reine Logik (getestet)
    breaks.ts                  automatischer Pausenabzug (getestet)
    arbzg.ts                   Arbeitszeit-Check, 24-Wochen-Prognose (getestet)
    teamReport.ts              Team-Modus: CSV und Erinnerung (getestet)
    xlsx.ts                    XLSX-Leser (ZIP + XML, ohne Paket; getestet)
    timeReport.ts              LOGA-Zeitwirtschaftsreport auswerten (getestet)
    timeReconcile.ts           Abgleich LOGA ↔ Einträge, Nachtrag planen (getestet)
    shortcuts.ts               globale Tastenkürzel
    reminders.ts               Erinnerungen (Notifications)
    watchers.svelte.ts         Leerlauf, Auto-Stop, Pomodoro, Tray-Tooltip
    components/                UI (Tracking, Einträge, Bericht, Aktivitäten, Einstellungen, …)
src-tauri/                     Rust: Tray, Idle-Query, Outlook, Plugins

Empfohlenes IDE-Setup

VS Code + Svelte + Tauri + rust-analyzer.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages