Files
datecalc/README.md

67 lines
1.7 KiB
Markdown

# Elpatrons Datumsrechner
Diese moderne Python-Webanwendung (Flask) ermöglicht verschiedene Datumsberechnungen über eine übersichtliche Weboberfläche:
## Funktionen
- **Anzahl der Tage zwischen zwei Daten**
- **Anzahl der Werktage zwischen zwei Daten**
- **Anzeige des Wochentags eines Datums**
- **Datum plus/minus X Tage**
- **Datum plus/minus X Werktage**
- **Datum plus/minus X Wochen/Monate**
- **Kalenderwoche zu Datum**
- **Start-/Enddatum einer Kalenderwoche eines Jahres**
- **Statistik-Dashboard mit Passwortschutz unter `/stats`**
## Installation (lokal)
1. Python 3.8+ installieren
2. Abhängigkeiten installieren:
```
pip install -r requirements.txt
```
## Starten der App
```
python app.py
```
Die App ist dann unter http://localhost:5000 erreichbar.
## Statistik-Dashboard (/stats) & Passwortschutz
Das Dashboard ist mit einem statischen Passwort geschützt, das über die Umgebungsvariable `STATS_PASSWORD` gesetzt wird.
**Beispiel (PowerShell):**
```powershell
$env:STATS_PASSWORD = "meinSicheresPasswort"
python app.py
```
**Für Docker:**
```powershell
$env:STATS_PASSWORD = "meinSicheresPasswort"
docker run -e STATS_PASSWORD=$env:STATS_PASSWORD -p 5000:5000 datumsrechner
```
## Docker (empfohlen für Produktion)
Die App läuft im Container mit dem WSGI-Server **Gunicorn**:
```
docker build -t datumsrechner .
docker run -p 5000:5000 datumsrechner
```
- Gunicorn startet automatisch (siehe Dockerfile)
- Empfohlen für produktiven Einsatz
## Entwicklung & Hinweise
- Die HTML-Templates liegen im Ordner `templates/` (Trennung von Logik und Darstellung)
- Das Projekt ist auf Gitea gehostet: https://gitea.elpatron.me/elpatron/datecalc
- Modernes, responsives Design mit Akkordeon und Icons
---
(c) Elpatron