PraxisZeit - Zeiterfassungssystem
Webbasierte Arbeitszeiterfassung für Arzt-, Zahnarzt- und Therapiepraxen – nach Arbeitszeitgesetz, DSGVO-freundlich auf dem eigenen Praxis-Rechner (Windows, Linux, macOS, Docker).
Installierbar als Progressive Web App (PWA) auf Smartphone und Desktop.
Website, Download und Anleitungen: praxiszeit.mr-development.de · Download · Handbuch für die Praxisverwaltung · So rechnet PraxisZeit · Ratgeber Arbeitszeiterfassung
Features
Für Mitarbeiter
- ✅ Stempeluhr - Ein-/Ausstempeln direkt auf dem Dashboard
- ✅ Zeiterfassung (von–bis mit Pausen)
- ✅ Dashboard mit Soll/Ist-Vergleich und Überstundenkonto
- ✅ Urlaubsverwaltung (tagebasiert nach Tagesprinzip §3 BUrlG, mit Restanzeige)
- ✅ Abwesenheiten (Urlaub, Krankheit, Fortbildung, Überstundenausgleich, Sonstiges)
- ✅ Abwesenheiten mit Zeiten (Start-/Endzeit oder "ganzer Tag")
- ✅ Zeitraum-Erfassung (mehrere Tage auf einmal)
- ✅ Profilseite (Passwort ändern, persönliche Daten)
- ✅ Änderungsanträge für vergangene Tage (Arbeitszeit + Abwesenheiten)
- ✅ Saldo „bis heute" – Dashboard-Salden bis zum letzten abgeschlossenen Arbeitstag (#313)
Für Admins
- ✅ Benutzerverwaltung mit Rollenverwaltung
- ✅ Arbeitszeiten-Historie (Stundenänderungen nachverfolgen)
- ✅ Individuelle Tagesplanung (Stunden je Wochentag konfigurierbar)
- ✅ Minijob / MiLoG-Arbeitszeitkonto (§2 Abs.2): vereinbarte Monatsarbeitszeit, weiche 50-%-Plausibilität + 12-Monats-Ausgleichsfrist; optionaler Modus „feste Monatsarbeitszeit" — festes Monats-Soll statt schwankender Wochenstunden-Summe, mit Feiertags-/Fehltags-Gutschrift (#377)
- ✅ Urlaubsübersicht (Budget, Verbrauch, Resturlaub pro MA)
- ✅ Eigene Abwesenheitsgründe (Name, Farbe, Grundverhalten als Label-Overlay; #312)
- ✅ Betriebsferien – verordnete Schließtage, optional als Urlaub und/oder Überstundenausgleich (#314)
- ✅ Kalenderfarben für Abwesenheitskalender (auch je Mitarbeiter setzbar)
- ✅ Admin-Dashboard mit Team-Übersicht (umschaltbar Monat ↔ Woche)
- ✅ Berichte & Export:
- Monatsreport (detailliert mit täglichen Einträgen)
- Jahresreport Classic (kompakte 12-Monats-Übersicht)
- Jahresreport Detailliert (365 Tage pro MA)
- ✅ Abwesenheitskalender für das ganze Team
- ✅ Änderungsanträge genehmigen/ablehnen
- ✅ Fehler-Monitoring (Backend-Fehler mit Status und GitHub-Integration)
- ✅ Änderungsprotokoll (Audit-Log aller Systemaktionen)
- ✅ ArbZG-Compliance-Reports: Ruhezeitverstöße (§5), Sonntagsarbeit (§11), Nachtarbeit (§6), Ersatzruhetag-Tracking (§11)
Schichtplanung (optional, Feature-Flag)
- 🗂️ Standorte & Arbeitsplätze sowie wochentagbasierte Schichtpläne mit Slots und Mitarbeiter-Zuweisungen
- 📆 Wochen- und Tagesansicht, Schicht auf Wochentage kopieren, Schichtplan duplizieren
- 🗓️ KW-/Ganzjahres-Planung mit Datums-Fenster und Auto-Generierung (Greedy-Vorschlag)
- 🎓 Einweisungs-/Skill-Matrix (Mitarbeiter ↔ Arbeitsplatz) als weiche Qualifikations-Warnung
- ⚙️ Hinter dem Tenant-Setting
shift_planning_enabled (Default aus), vollständig von ArbZG/Soll-Ist entkoppelt (#305)
ArbZG-Compliance (§3–§18)
- ⚖️ §3: 8h-Warnung überall; 10h-Hard-Stop bei manuellen Eingaben (Admin-Direkteintrag, Änderungsanträge) — Live-Ausstempeln erzeugt nur eine Warnung (die Zeit ist bereits geleistet und §16-aufzeichnungspflichtig)
- ⚖️ §4: Pflichtpause-Prüfung (>6h→30min, >9h→45min) + Mindestdauer-Warnung (<15min, §4 Satz 2)
- ⚖️ §5: 11h-Mindestruhezeit — Echtzeit-Warnung beim Einstempeln + Admin-Report
- ⚖️ §6: Nachtarbeit-Erkennung (23–6 Uhr), Badge im Frontend, Admin-Report mit Nachtarbeitnehmer-Schwellwert (≥48 Tage/Jahr)
- ⚖️ §9/10: Sonn-/Feiertagserkennung, Warnungen, optionales Ausnahmegrund-Feld (
sunday_exception_reason)
- ⚖️ §11: 15-freie-Sonntage-Report + Ersatzruhetag-Tracking (2/8 Wochen)
- ⚖️ §14: 48h-Wochenarbeitszeit-Warnung
- ⚖️ §16: Excel-Export, 2-Jahres-Retention-Dokumentation, Link zum Gesetzestext
- ⚖️ §18:
exempt_from_arbzg-Flag für leitende Angestellte (Chefärzte, Praxisinhaber)
Weitere Features
- 📱 PWA - Installierbar als App auf Smartphone und Desktop
- 🗓️ Bayerischer Feiertagskalender (automatisch berücksichtigt)
- 📅 Wochenenden automatisch ausschließen bei Zeiträumen
- 📊 Historische Stundenänderungen werden korrekt berechnet
- 🎨 Responsive Design – Hamburger-Menü, Card-Layouts auf Mobile für alle Tabellen
- ♿ Barrierefreiheit (A11y) – ARIA-Rollen, FocusTrap, Keyboard-Navigation, screenreader-optimiert
- 🔔 Toast-Notifications – Styled Benachrichtigungen statt browser-native alert/confirm
- ❤️ Health Check (
/api/health) mit DB-Connectivity-Test
Technologie-Stack
- Backend: Python 3.12 + FastAPI + SQLAlchemy + PostgreSQL
- Frontend: React + TypeScript + Vite + Tailwind CSS
- PWA: vite-plugin-pwa + Workbox (Service Worker)
- Deployment: Docker Compose
Installation
PraxisZeit lässt sich auf zwei Wegen betreiben:
Voraussetzungen
- Docker & Docker Compose
- (optional) Node.js 20+ für lokale Frontend-Entwicklung
- (optional) Python 3.12+ für lokale Backend-Entwicklung
Setup
- Repository klonen:
git clone https://github.com/phash/praxiszeit.git
cd praxiszeit
- Environment-Variablen konfigurieren:
cp .env.example .env
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
