its-consulting/Dienstplan
Archived
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge: Resolved README conflict

Browse source
This commit is contained in:
Kenearos 2025-11-14 14:54:47 +01:00
commit d02543351c
1 changed files with 43 additions and 28 deletions
Download patch file Download diff file Expand all files Collapse all files

69
README.md
View file

@ -1,27 +1,30 @@
# Excel XLSX Generator # Dienstplan Generator (NRW - Variante 2)
Ein Python-Projekt zum Erstellen von Excel-Dateien (.xlsx) mit der openpyxl-Bibliothek. Python-Projekt zum automatischen Erstellen von Dienstplänen mit Vergütungsberechnung nach NRW-Regeln (Variante 2 "streng").
## Voraussetzungen ## Features
- Python 3.8 oder höher - ✅ Automatische Erkennung von Wochenenden (Fr–So), Feiertagen und Vortagen
- pip (Python Package Installer) - ✅ 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 ## Installation
1. Erstellen Sie eine virtuelle Umgebung (empfohlen): 1. Virtuelle Umgebung erstellen:
```powershell ```powershell
python -m venv venv python -m venv .venv
``` ```
1. Aktivieren Sie die virtuelle Umgebung: 2. Umgebung aktivieren:
```powershell ```powershell
.\venv\Scripts\Activate.ps1 .\.venv\Scripts\Activate.ps1
``` ```
1. Installieren Sie die erforderlichen Pakete: 3. Abhängigkeiten installieren:
```powershell ```powershell
pip install -r requirements.txt pip install -r requirements.txt
@ -29,37 +32,49 @@ pip install -r requirements.txt
## Verwendung ## Verwendung
Führen Sie das Hauptskript aus: ### Monat erstellen
```powershell ```powershell
python src/main.py python src/fill_plan_dates.py 2025 11 # November 2025
python src/fill_plan_dates.py 2025 12 # Dezember 2025
``` ```
Dies erstellt eine Excel-Datei `output/example.xlsx` mit Beispieldaten. Die Datei landet in `output/Dienstplan_YYYY_MM_NRW.xlsx`.
### NRW-Dienstplan-Vorlage erstellen ### Daten eintragen
Das Skript `src/build_template.py` erzeugt eine leere Excel-Vorlage mit allen Regeln für NRW (Wochenenddefinition Fr–So, Feiertage + Vortag, automatische Abzüge). 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
```powershell **Fertig!** Alle Berechnungen erfolgen automatisch.
python src/build_template.py
```
Die Vorlage wird unter `templates/Dienstplan_Template_NRW.xlsx` abgelegt. Dort tragen Sie lediglich Namen/Anteile ein; die Abrechnung erfolgt über die vorbereiteten Formeln.
## Projektstruktur ## Projektstruktur
```text ```text
. .
├── src/ ├── src/
│ ├── main.py # Beispielskript für XLSX-Ausgabe │ ├── build_template.py # Erstellt die Basis-Vorlage
│ └── build_template.py # Generator für die NRW-Dienstplan-Vorlage │ ├── fill_plan_dates.py # Füllt Monate mit Datumszeilen
├── output/ # Ausgabeverzeichnis für erstellte Excel-Dateien │ └── read_excel.py # Liest xlsx-Dateien aus
├── templates/ # Enthält die generierte Dienstplan-Vorlage ├── output/ # Generierte Monatspläne
├── requirements.txt # Python-Abhängigkeiten ├── templates/ # Basis-Vorlage
├── requirements.txt # Python-Abhängigkeiten (openpyxl)
├── SPECIFICATION.md # Vollständige Regeln & Formeln
└── README.md # Diese Datei └── README.md # Diese Datei
``` ```
## Anpassung ## Regeln (Variante 2 - streng)
Bearbeiten Sie `src/main.py`, um Ihre eigenen Excel-Dateien zu erstellen. - **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