Dienstplan Generator (NRW - Variante 2)

Python-Projekt zum automatischen Erstellen von Dienstplänen mit Vergütungsberechnung nach NRW-Regeln (Variante 2 "streng").

Features

• ✅ Automatische Erkennung von Wochenenden (Fr–So), Feiertagen und Vortagen
• ✅ Vergütungslogik: WT 250€, WE 450€ (nur ab Schwelle ≥ 2,0 WE-Einheiten)
• ✅ Abzug 1,0 WE-Einheit (Freitag-Priorität) nach Erreichen der Schwelle
• ✅ Vorbefüllte Monatsvorlagen mit allen Datumswerten
• ✅ Excel-kompatibel (ohne Office 365 Funktionen)

Installation

1. Virtuelle Umgebung erstellen:

python -m venv .venv

2. Umgebung aktivieren:

.\.venv\Scripts\Activate.ps1

3. Abhängigkeiten installieren:

pip install -r requirements.txt

Verwendung

Monat erstellen

python src/fill_plan_dates.py 2025 11  # November 2025
python src/fill_plan_dates.py 2025 12  # Dezember 2025

Die Datei landet in output/Dienstplan_YYYY_MM_NRW.xlsx.

Daten eintragen

1. Öffne die generierte Datei
2. Gehe zum Blatt "Plan"
3. Trage in Spalte B die Mitarbeiter-Namen ein
4. Trage in Spalte C den Anteil ein (1 = voll, 0.5 = halb)
5. Gehe zum Blatt "Auswertung" und trage in Spalte A alle Mitarbeiter ein

Fertig! Alle Berechnungen erfolgen automatisch.

Projektstruktur

.
├── src/
│   ├── build_template.py   # Erstellt die Basis-Vorlage
│   ├── fill_plan_dates.py  # Füllt Monate mit Datumszeilen
│   └── read_excel.py       # Liest xlsx-Dateien aus
├── output/                 # Generierte Monatspläne
├── templates/              # Basis-Vorlage
├── requirements.txt        # Python-Abhängigkeiten (openpyxl)
├── SPECIFICATION.md        # Vollständige Regeln & Formeln
└── README.md              # Diese Datei

Regeln (Variante 2 - streng)

• WE-Tag: Fr/Sa/So + Feiertag + Vortag Feiertag
• WT-Tag: Alle anderen Tage (250 € pro Einheit)
• WE-Vergütung: Nur wenn Monatssumme ≥ 2,0 WE-Einheiten → 450 €/Einheit, dann Abzug 1,0 (zuerst von Freitag)
• Unter Schwelle: WE-Dienste = 0 € (nicht als WT vergütet)

Details siehe SPECIFICATION.md.

Lizenz

MIT