migriert von github.com/Kenearos/Dienstplan-Pro
Find a file
Kenearos 262be954bb chore: remove implementation plans for shipped features
The bild-import and bonus-varianten plans were step-by-step build guides
consumed during implementation. Both features are merged and live.
Design specs in docs/specs/ stay for reference.
2026-05-12 19:36:22 +02:00
.github/workflows Add GitHub Actions workflow for Node.js with Webpack 2026-02-03 15:16:41 +02:00
docs/specs chore: remove implementation plans for shipped features 2026-05-12 19:36:22 +02:00
app.js Merge feature/bonus-varianten: 3 variants + vacation + date-stepper 2026-05-12 18:45:31 +02:00
calculator.js fix(calculator): prefer eligible variant over ineligible at bonus-tie 2026-05-12 18:36:24 +02:00
CLAUDE.md docs: replace Railway deployment section with Hetzner setup 2026-05-12 19:16:05 +02:00
Dockerfile fix: Use Node.js serve for robust port binding on Railway 2026-02-02 12:00:25 +00:00
holidays.js feat: Unified PWA release 2026-02-02 11:51:11 +00:00
image-import.js feat(image-import): add resolveImports (pure) and commitImport persisting duties via DataStorage 2026-05-12 18:23:27 +02:00
index.html Merge feature/bonus-varianten: 3 variants + vacation + date-stepper 2026-05-12 18:45:31 +02:00
manifest.json feat: Unified PWA release 2026-02-02 11:51:11 +00:00
README.md feat: Unified PWA release 2026-02-02 11:51:11 +00:00
storage.js Merge feature/bonus-varianten: 3 variants + vacation + date-stepper 2026-05-12 18:45:31 +02:00
styles.css Merge feature/bonus-varianten: 3 variants + vacation + date-stepper 2026-05-12 18:45:31 +02:00
sw.js Merge feature/bonus-varianten: 3 variants + vacation + date-stepper 2026-05-12 18:45:31 +02:00
test-suite.js Merge feature/bonus-varianten: 3 variants + vacation + date-stepper 2026-05-12 18:45:31 +02:00
test.html Merge feature/bonus-varianten: 3 variants + vacation + date-stepper 2026-05-12 18:45:31 +02:00
TEST_GUIDE.md feat: Unified PWA release 2026-02-02 11:51:11 +00:00
variants.js feat: implement variant2 (1 sa + 2 weekday) 2026-05-12 00:14:50 +02:00

Dienstplan Bonusrechner - Web App

Eine Web-Anwendung zur Berechnung von Bonuszahlungen für Wochenend- und Feiertagsdienste nach NRW-Regeln.

Features

  • Mitarbeiterverwaltung: Mehrere Mitarbeiter gleichzeitig verwalten
  • Dienstplanung: Dienste für beliebige Monate eintragen (ganze und halbe Dienste)
  • Automatische Feiertagserkennung: NRW-Feiertage 2025-2030
  • Bonusberechnung: Automatische Berechnung nach festgelegten Regeln
  • Datenexport/Import: JSON-Export für Backup und Migration
  • LocalStorage: Alle Daten werden lokal im Browser gespeichert
  • Responsive Design: Funktioniert auf Desktop und Mobilgeräten

Berechnungsregeln

Qualifizierende Tage (WE/Feiertag)

  • Wochenende: Freitag, Samstag, Sonntag
  • Feiertage: Alle gesetzlichen Feiertage in NRW
  • Tag vor Feiertag: Der Tag vor einem gesetzlichen Feiertag

Bonusberechnung

  1. Schwellenwert: Mindestens 2.0 qualifizierende Tage im Monat erforderlich
  2. Abzug: Bei Erreichen des Schwellenwerts werden 2.0 qualifizierende Tage abgezogen (Freitag-Priorität)
  3. Vergütung:
    • Normale Tage: 250€ pro Tag
    • Qualifizierende Tage (WE/Feiertag): 450€ pro Tag
    • Halbe Dienste: Jeweils die Hälfte

Beispiel

Mitarbeiter hat im Monat:

  • 3 normale Tage (Mo-Do, keine Feiertage)
  • 3 Wochenend-Tage (Fr, Sa, So)

Berechnung:

  • Qualifizierende Tage: 3.0 (Schwellenwert erreicht ✓)
  • Abzug: -2.0 qualifizierende Tage
  • Bezahlt: 3 normale Tage + 1 qualifizierender Tag
  • Bonus: (3 × 250€) + (1 × 450€) = 1.200€

Installation & Nutzung

Lokale Nutzung (einfachste Methode)

  1. Dateien öffnen:

    • Navigieren Sie zum Ordner webapp
    • Öffnen Sie die Datei index.html direkt in Ihrem Browser (Doppelklick)
  2. Fertig! Die App läuft komplett im Browser, keine Installation nötig.

Mit lokalem Webserver (optional)

Wenn Sie lieber einen Webserver verwenden möchten:

# Im webapp-Ordner
python -m http.server 8000
# Oder mit Node.js
npx http-server -p 8000

Dann im Browser öffnen: http://localhost:8000

Bedienung

1. Mitarbeiter hinzufügen

  1. Gehen Sie zum Tab "Mitarbeiter verwalten"
  2. Geben Sie den Namen ein und klicken Sie auf "Hinzufügen"

2. Dienste eintragen

  1. Gehen Sie zum Tab "Dienste eintragen"
  2. Wählen Sie Monat und Jahr
  3. Wählen Sie einen Mitarbeiter
  4. Wählen Sie das Datum
  5. Wählen Sie Dienstanteil (ganz oder halb)
  6. Klicken Sie auf "Dienst hinzufügen"

Hinweis: Qualifizierende Tage (WE/Feiertag) werden grün hervorgehoben.

3. Bonus berechnen

  1. Gehen Sie zum Tab "Berechnung"
  2. Wählen Sie Monat und Jahr
  3. Klicken Sie auf "Berechnung durchführen"
  4. Sehen Sie die Ergebnisse für alle Mitarbeiter

4. Daten exportieren/importieren

  1. Gehen Sie zum Tab "Einstellungen"
  2. Klicken Sie auf "Daten exportieren" für ein Backup
  3. Verwenden Sie "Daten importieren" um gespeicherte Daten zu laden

Datenspeicherung

  • Alle Daten werden im Browser LocalStorage gespeichert
  • Die Daten bleiben erhalten, auch nach Schließen des Browsers
  • Wichtig: Beim Löschen der Browser-Daten gehen die Daten verloren
  • Regelmäßige Exports werden empfohlen!

NRW Feiertage (2025-2030)

Die App enthält alle gesetzlichen Feiertage für NRW von 2025 bis 2030:

  • Neujahr
  • Karfreitag
  • Ostermontag
  • Tag der Arbeit
  • Christi Himmelfahrt
  • Pfingstmontag
  • Fronleichnam
  • Tag der Deutschen Einheit
  • Allerheiligen
    1. und 2. Weihnachtstag

Technische Details

Projektstruktur

webapp/
├── index.html       # Haupt-HTML-Datei
├── styles.css       # Styling
├── app.js           # Haupt-App-Logik & UI
├── calculator.js    # Bonusberechnungs-Logik
├── holidays.js      # NRW-Feiertagsdaten
├── storage.js       # LocalStorage-Verwaltung
└── README.md        # Diese Datei

Technologien

  • Vanilla JavaScript (kein Framework erforderlich)
  • HTML5 & CSS3
  • LocalStorage API
  • Keine externen Abhängigkeiten
  • Funktioniert in allen modernen Browsern

Browser-Kompatibilität

  • Chrome/Edge (empfohlen)
  • Firefox
  • Safari
  • Opera

Tipps & Tricks

  1. Regelmäßige Backups: Exportieren Sie Ihre Daten regelmäßig als JSON-Datei
  2. Drucken: Die Berechnungsseite kann direkt gedruckt werden (Datei → Drucken)
  3. Mehrere Browser: Daten sind browser-spezifisch und werden nicht synchronisiert
  4. Mobile Nutzung: Die App ist mobilfreundlich und kann auch auf Tablets/Smartphones genutzt werden

Unterschiede zu anderen Versionen

Diese Web-App verwendet leicht andere Regeln als die Python/Excel Version:

Web-App Logik (Ihre Anforderungen)

  • Wenn < 2 WE-Tage: Keine Bonuszahlung
  • Wenn ≥ 2 WE-Tage:
    • 1 WE-Tag wird abgezogen
    • Alle übrigen Tage werden bezahlt (normale: 250€, WE: 450€)

Python/Excel Version (Variante 2 "streng")

  • Normale Tage (WT) werden immer bezahlt (250€)
  • WE-Tage nur wenn ≥ 2.0 WE-Einheiten

Die Web-App folgt genau Ihren beschriebenen Anforderungen.

Lizenz

MIT