Merge pull request #31 from Kenearos/claude/update-claude-md-CwAqk

Create or update CLAUDE.MD file
This commit is contained in:
Kenearos 2025-12-25 10:39:43 +01:00 committed by GitHub
commit 38c7a96a2e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -4,6 +4,25 @@
Dieses Projekt berechnet Bonuszahlungen für Mitarbeiter basierend auf Wochenend- und Feiertagsdiensten nach spezifischen NRW-Regeln. Es existieren drei verschiedene Implementierungen für unterschiedliche Anwendungsfälle. Dieses Projekt berechnet Bonuszahlungen für Mitarbeiter basierend auf Wochenend- und Feiertagsdiensten nach spezifischen NRW-Regeln. Es existieren drei verschiedene Implementierungen für unterschiedliche Anwendungsfälle.
## Quick Start
**Für schnellen Einstieg - Web-App (empfohlen):**
1. Öffne `webapp/index.html` im Browser
2. Füge Mitarbeiter hinzu (Tab "Mitarbeiter")
3. Trage Dienste ein (Tab "Dienste")
4. Berechne Bonus (Tab "Berechnungen")
**Für Python/Excel:**
```bash
python -m venv .venv
.venv\Scripts\activate # Windows
pip install -r requirements.txt
python src/fill_plan_dates.py 2025 12
```
**Für Android:**
Siehe `android-app/README.md` für Build-Anleitung.
## Verfügbare Implementierungen ## Verfügbare Implementierungen
### 1. Web-App (empfohlen) ### 1. Web-App (empfohlen)
@ -123,11 +142,29 @@ Alle Implementierungen nutzen die gleichen NRW-Feiertage:
- Fronleichnam (variabel) - Fronleichnam (variabel)
- Tag der Deutschen Einheit (3. Oktober) - Tag der Deutschen Einheit (3. Oktober)
- Allerheiligen (1. November) - Allerheiligen (1. November)
- Heiligabend (24. Dezember) - *Python/Android 2025-2026*
- 1. Weihnachtstag (25. Dezember) - 1. Weihnachtstag (25. Dezember)
- 2. Weihnachtstag (26. Dezember) - 2. Weihnachtstag (26. Dezember)
- Silvester (31. Dezember) - *Python/Android 2025-2026*
**Abdeckung**: 2025-2030 (Web-App), 2025-2026 (Python/Android) **Abdeckung**: 2025-2030 (Web-App), 2025-2026 (Python/Android)
**Hinweis**: Heiligabend und Silvester wurden kürzlich zur Python/Android-Version hinzugefügt, sind aber noch nicht in der Web-App implementiert.
## Letzte Änderungen & Verbesserungen
### Dezember 2025
- ✅ **Export-Verbesserung**: Abgezogene Tage werden in der Export-Ansicht speziell markiert
- ✅ **UI-Verbesserung**: Euro-Werte werden für abgezogene Tage ausgeblendet (klarere Darstellung)
- ✅ **Neue Feiertage**: Heiligabend (24.12.) und Silvester (31.12.) für Python/Android-Version
- ✅ **Bugfix**: Entfernung ungenutzter `isPartiallyDeducted`-Variable
- ✅ **Korrektur**: Alle Abzugsreferenzen auf 2.0 (statt 1.0) aktualisiert
### Bekannte Unterschiede zwischen Versionen
- **Web-App**: Hat Heiligabend/Silvester noch nicht als Feiertage
- **Python/Android**: Vollständige Feiertage-Liste inklusive Heiligabend/Silvester
- **Berechnungslogik**: Web-App nutzt vereinfachte Logik (siehe "Berechnungsregeln - Unterschiede")
## Entwicklungshinweise ## Entwicklungshinweise
### Web-App erweitern ### Web-App erweitern
@ -313,8 +350,28 @@ Da die App rein client-seitig läuft (keine Server-Logik), ist jeder Static-Host
MIT License - Siehe Hauptprojekt MIT License - Siehe Hauptprojekt
## Export-Funktion (Web-App)
Die Web-App bietet eine Export-Funktion für Mitarbeiterdaten:
### Features
- **Export-Format**: JSON-Datei mit allen Mitarbeiter- und Dienstdaten
- **Import-Funktion**: Wiederherstellen gespeicherter Daten
- **Verbesserte Darstellung** (v3.1):
- Abgezogene Tage werden speziell markiert
- Euro-Werte werden für abgezogene Tage ausgeblendet
- Klarere Unterscheidung zwischen bezahlten und abgezogenen Diensten
### Verwendung
1. Im Tab "Mitarbeiter" auf "Export" klicken
2. JSON-Datei wird heruntergeladen
3. Zum Importieren: "Import" klicken und Datei auswählen
**Tipp**: Regelmäßige Exports als Backup nutzen, da LocalStorage browser-abhängig ist.
## Versionshistorie ## Versionshistorie
- **v3.1** (Dezember 2025): Verbesserte Export-Darstellung, Heiligabend/Silvester für Python/Android
- **v3.0** (2025): Web-App hinzugefügt mit vereinfachter Berechnungslogik - **v3.0** (2025): Web-App hinzugefügt mit vereinfachter Berechnungslogik
- **v2.0** (2024): Android-App implementiert - **v2.0** (2024): Android-App implementiert
- **v1.0**: Python/Excel Version (Variante 2 "streng") - **v1.0**: Python/Excel Version (Variante 2 "streng")