Stundenfuchs

Stundenfuchs ist eine FastAPI-Anwendung zur Erfassung von Arbeitszeiten mit Benutzerkonten, Wochen- und Monatsansicht, Exportfunktionen und einer serverseitig abgesicherten Web-UI.

Features

Registrierung und Login
Benutzerbezogene Datentrennung
Wochen- und Monatsansicht
Excel-, PDF- und Backup-Export
Backup-Import
Urlaub, Feiertage und Krankheitstage
Mehrfacheingaben für Zeiträume
E-Mail-Verifikation, Passwort-Reset und MFA
Admin-Bereich für Benutzer- und Systemeinstellungen

Stack

FastAPI
SQLAlchemy
SQLite
Jinja2 Templates
Vanilla JavaScript
CSS mit zentralen Design-Tokens

Lokal starten

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python -m app.main

Danach ist die App unter http://localhost:8000 erreichbar.

Docker

cp .env.example .env
docker compose up -d --build

Qualitätssicherung

make policy
make lint
make test
make ci

Dokumentation

Entwicklung: docs/DEVELOPMENT.md
Sicherheit: docs/SECURITY.md

Hinweise zur Veröffentlichung

Dieses Public-Repository enthält bewusst keine produktionsspezifische Infrastruktur, keine internen Betriebsanweisungen und keine Stage-/Live-Dokumentation. Für eine öffentliche Veröffentlichung sollte zusätzlich eine passende LICENSE ergänzt werden.

1.4 KiB Raw Blame History