Compare commits
35 Commits
v1.4.4
...
1c9fc93314
| Author | SHA1 | Date | |
|---|---|---|---|
| 1c9fc93314 | |||
| 510f039a2b | |||
| 1967cef7fc | |||
| 0c0997c1bd | |||
| 118c7c1516 | |||
| 773696d6be | |||
| f53a2661da | |||
| 53b40ca91d | |||
| 43eb609b4a | |||
| 53d5309d65 | |||
| a131fc8077 | |||
| deec62fec0 | |||
| 9e5906943d | |||
| cabe628875 | |||
| 35ecba348b | |||
| 31b1c12dcb | |||
| 95ed606796 | |||
| 52eac7530a | |||
| 2f6138b1d6 | |||
| f5a39e80b4 | |||
| f9f73e24c9 | |||
| d697928241 | |||
| f998f7fff8 | |||
| 1a5aa003a2 | |||
| eecc2b8b73 | |||
| 0b13a408cd | |||
| c4a65bba48 | |||
| e4b37d9261 | |||
| 45cc02b4b0 | |||
| 05766d9a97 | |||
| e5fbc14a34 | |||
| 9e025bd4c7 | |||
| f4ffd14624 | |||
| 4740288c45 | |||
| 512898b34b |
493
README.md
493
README.md
@@ -1,500 +1,25 @@
|
|||||||
# Elpatrons Datumsrechner
|
# Elpatrons Date Calculator
|
||||||
|
|
||||||
[](https://github.com/elpatron/datecalc)
|
A modern Python web application (Flask) that enables various date calculations through a clear, accessible web interface. Features include calculating days between dates, working days with state-specific holidays, calendar weeks, date arithmetic, and more. The application supports German and English languages, includes a REST API, and is designed with accessibility in mind.
|
||||||
[](https://date.elpatron.me)
|
|
||||||
[](https://date.elpatron.me)
|
|
||||||
[](https://date.elpatron.me)
|
|
||||||
[](https://date.elpatron.me)
|
|
||||||
|
|
||||||
Diese moderne Python-Webanwendung (Flask) ermöglicht verschiedene Datumsberechnungen über eine übersichtliche, barrierefreie Weboberfläche.
|
## Documentation
|
||||||
|
|
||||||
## Inhaltsverzeichnis
|
- **[English Documentation](README_en.md)** - Complete documentation in English
|
||||||
|
- **[Deutsche Dokumentation](README_de.md)** - Vollständige Dokumentation auf Deutsch
|
||||||
|
|
||||||
- [Demo](#demo)
|
## Quick Start
|
||||||
- [Funktionen](#funktionen)
|
|
||||||
- [Installation (lokal)](#installation-lokal)
|
|
||||||
- [Starten der App](#starten-der-app)
|
|
||||||
- [Statistik-Dashboard & Passwortschutz](#statistik-dashboard-stats--passwortschutz)
|
|
||||||
- [Docker (empfohlen für Produktion)](#docker-empfohlen-für-produktion)
|
|
||||||
- [Log-Verzeichnis mounten](#log-verzeichnis-mounten-logs-auf-dem-host-speichern)
|
|
||||||
- [docker-compose Beispiel](#docker-compose-beispiel)
|
|
||||||
- [REST API](#rest-api)
|
|
||||||
- [Tage/Werktage zwischen zwei Daten](#1-tagewerktage-zwischen-zwei-daten)
|
|
||||||
- [Wochentag zu einem Datum](#2-wochentag-zu-einem-datum)
|
|
||||||
- [Kalenderwoche zu Datum](#3-kalenderwoche-zu-datum)
|
|
||||||
- [Start-/Enddatum einer Kalenderwoche](#4-start-enddatum-einer-kalenderwoche)
|
|
||||||
- [Datum plus/minus Tage, Wochen, Monate](#5-datum-plusminus-tage-wochen-monate)
|
|
||||||
- [Statistik](#6-statistik)
|
|
||||||
- [Monitoring & Healthcheck](#7-monitoring--healthcheck)
|
|
||||||
- [Progressive Web App (PWA)](#progressive-web-app-pwa)
|
|
||||||
- [Monitoring & Healthcheck](#monitoring--healthcheck)
|
|
||||||
- [Entwicklung & Hinweise](#entwicklung--hinweise)
|
|
||||||
- [Automatisierte Tests](#automatisierte-tests)
|
|
||||||
- [Hinweise](#hinweise)
|
|
||||||
- [Motivation](#motivation)
|
|
||||||
- [Vibe Coding](#vibe-coding)
|
|
||||||
- [Statistik-Erfassung, Logging](#statistik-erfassung-logging)
|
|
||||||
- [Barrierefreiheit (Accessibility)](#barrierefreiheit-accessibility)
|
|
||||||
- [Code Statistik](#code-statistik)
|
|
||||||
- [Lizenz](#lizenz)
|
|
||||||
|
|
||||||
## Demo
|
|
||||||
|
|
||||||
Datumsrechner Live: [https://date.elpatron.me](https://date.elpatron.me)
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**[Lighthouse](https://en.wikipedia.org/wiki/Lighthouse_(software))-Performance-Score:**
|
|
||||||
|
|
||||||
Die Webanwendung erreicht hervorragende Performance-Werte in allen Kategorien (Performance, Accessibility, Best Practices, SEO).
|
|
||||||
|
|
||||||
[Lighthouse-Ergebnis (PDF)](./lighthouse/lighthouse-score.pdf)
|
|
||||||
|
|
||||||
## Funktionen
|
|
||||||
|
|
||||||
- Anzahl der Tage zwischen zwei Daten
|
|
||||||
- Anzahl der Werktage zwischen zwei Daten (mit optionaler Berücksichtigung bundeslandspezifischer Feiertage)
|
|
||||||
- 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
|
|
||||||
- Mehrsprachige Unterstützung (Deutsch/Englisch) mit automatischer Browser-Spracherkennung
|
|
||||||
- Sprachausgabe für alle Ergebnisse (barrierefrei)
|
|
||||||
- Statistik-Dashboard mit Passwortschutz unter `/stats`
|
|
||||||
|
|
||||||
## Bundesland-Feiertage
|
|
||||||
|
|
||||||
Die Werktagsberechnung kann optional bundeslandspezifische Feiertage berücksichtigen. Dazu wird die kostenlose API von [feiertage-api.de](https://feiertage-api.de) verwendet.
|
|
||||||
|
|
||||||
**Verfügbare Bundesländer:**
|
|
||||||
- Baden-Württemberg (BW)
|
|
||||||
- Bayern (BY)
|
|
||||||
- Berlin (BE)
|
|
||||||
- Brandenburg (BB)
|
|
||||||
- Bremen (HB)
|
|
||||||
- Hamburg (HH)
|
|
||||||
- Hessen (HE)
|
|
||||||
- Mecklenburg-Vorpommern (MV)
|
|
||||||
- Niedersachsen (NI)
|
|
||||||
- Nordrhein-Westfalen (NW)
|
|
||||||
- Rheinland-Pfalz (RP)
|
|
||||||
- Saarland (SL)
|
|
||||||
- Sachsen (SN)
|
|
||||||
- Sachsen-Anhalt (ST)
|
|
||||||
- Schleswig-Holstein (SH)
|
|
||||||
- Thüringen (TH)
|
|
||||||
|
|
||||||
Die Feiertage werden automatisch für den gewählten Zeitraum abgerufen und bei der Werktagsberechnung als arbeitsfreie Tage behandelt. Im Ergebnis werden zusätzlich die Anzahl der Wochenendtage und Feiertage angezeigt.
|
|
||||||
|
|
||||||
## Mehrsprachige Unterstützung (i18n)
|
|
||||||
|
|
||||||
Die Anwendung unterstützt Deutsch und Englisch mit folgenden Features:
|
|
||||||
|
|
||||||
### Automatische Spracherkennung:
|
|
||||||
- *Browser-Sprache*: Automatische Erkennung der Browser-Einstellung
|
|
||||||
- *URL-Parameter*: Sprachauswahl über `?lang=de` oder `?lang=en`
|
|
||||||
- *localStorage*: Persistente Sprachauswahl im Browser
|
|
||||||
- *Fallback*: Deutsch als Standardsprache
|
|
||||||
|
|
||||||
### *Datenschutzfreundliche Implementierung:*
|
|
||||||
- *Keine Cookies*: Sprachauswahl ohne Cookies
|
|
||||||
- *URL-Parameter*: Transparente Sprachauswahl in der URL
|
|
||||||
- *localStorage*: Lokale Speicherung im Browser
|
|
||||||
- *Teilbare URLs*: URLs mit Sprachauswahl können geteilt werden
|
|
||||||
|
|
||||||
### *Barrierefreiheit:*
|
|
||||||
- *Screenreader*: Vollständige Unterstützung
|
|
||||||
- *Tastatur-Navigation*: Vollständig bedienbar
|
|
||||||
- *ARIA-Attribute*: Korrekte Beschriftungen
|
|
||||||
- *Semantische HTML*: Korrekte Struktur
|
|
||||||
|
|
||||||
### *Technische Details:*
|
|
||||||
- *Flask-Babel*: Professionelle i18n-Implementierung
|
|
||||||
- *Gettext*: Standard für Übersetzungen
|
|
||||||
- *Responsive Design*: Angepasst für alle Geräte
|
|
||||||
- *SEO-freundlich*: URLs sind indexierbar
|
|
||||||
|
|
||||||
## Installation (lokal)
|
|
||||||
|
|
||||||
1. Python 3.8+ installieren
|
|
||||||
2. Abhängigkeiten installieren:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install -r requirements.txt
|
pip install -r requirements.txt
|
||||||
```
|
|
||||||
|
|
||||||
## Starten der App
|
|
||||||
|
|
||||||
```bash
|
|
||||||
python app.py
|
python app.py
|
||||||
```
|
```
|
||||||
|
|
||||||
Die App ist dann unter http://localhost:5000 erreichbar.
|
Visit [https://date.elpatron.me](https://date.elpatron.me) for the live demo.
|
||||||
|
|
||||||
## Statistik-Dashboard (/stats) & Passwortschutz
|
## License
|
||||||
|
|
||||||
Das Dashboard ist mit einem statischen Passwort geschützt, das über die Umgebungsvariable `STATS_PASSWORD` gesetzt wird.
|
This project is licensed under the [MIT License](LICENSE).
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
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**:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker build -t datumsrechner .
|
|
||||||
docker run -p 5000:5000 datumsrechner
|
|
||||||
```
|
|
||||||
|
|
||||||
- Gunicorn startet automatisch (siehe Dockerfile)
|
|
||||||
- Empfohlen für produktiven Einsatz
|
|
||||||
|
|
||||||
### Log-Verzeichnis mounten (Logs auf dem Host speichern)
|
|
||||||
|
|
||||||
Um die Logdateien außerhalb des Containers zu speichern, kannst du das log-Verzeichnis mounten:
|
|
||||||
|
|
||||||
**PowerShell-Beispiel:**
|
|
||||||
|
|
||||||
```powershell
|
|
||||||
docker run -e STATS_PASSWORD=deinPasswort -p 5000:5000 -v ${PWD}/log:/app/log datumsrechner
|
|
||||||
```
|
|
||||||
|
|
||||||
### docker-compose Beispiel
|
|
||||||
|
|
||||||
Erstelle eine Datei `docker-compose.yml`:
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
services:
|
|
||||||
datumsrechner:
|
|
||||||
build: .
|
|
||||||
ports:
|
|
||||||
- "5000:5000"
|
|
||||||
environment:
|
|
||||||
- STATS_PASSWORD=deinPasswort
|
|
||||||
volumes:
|
|
||||||
- ./log:/app/log
|
|
||||||
```
|
|
||||||
|
|
||||||
Starte mit:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker-compose up --build
|
|
||||||
```
|
|
||||||
|
|
||||||
## REST API
|
|
||||||
|
|
||||||
Alle Datumsfunktionen stehen auch als REST-API zur Verfügung. Die API akzeptiert und liefert JSON.
|
|
||||||
**Basis-URL:** `http://localhost:5000/api/`
|
|
||||||
|
|
||||||
**Hinweis:** Die Nutzung der REST API wird im Statistik-Dashboard ausgewertet und als Diagramm angezeigt.
|
|
||||||
|
|
||||||
### Endpunkte und Beispiele
|
|
||||||
|
|
||||||
#### 1. Tage/Werktage zwischen zwei Daten
|
|
||||||
|
|
||||||
**POST** `/api/tage_werktage`
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"start": "2024-06-01",
|
|
||||||
"end": "2024-06-10",
|
|
||||||
"werktage": true,
|
|
||||||
"bundesland": "BY"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Mit curl:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
curl -X POST http://localhost:5000/api/tage_werktage \
|
|
||||||
-H "Content-Type: application/json" \
|
|
||||||
-d '{"start": "2024-06-01", "end": "2024-06-10", "werktage": true, "bundesland": "BY"}'
|
|
||||||
```
|
|
||||||
|
|
||||||
**Antwort:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{ "result": 7 }
|
|
||||||
```
|
|
||||||
|
|
||||||
**Hinweis:** Der Parameter `bundesland` ist optional und wird nur bei `"werktage": true` berücksichtigt. Verfügbare Bundesland-Kürzel siehe oben.
|
|
||||||
|
|
||||||
#### 2. Wochentag zu einem Datum
|
|
||||||
|
|
||||||
**POST** `/api/wochentag`
|
|
||||||
|
|
||||||
```json
|
|
||||||
{ "datum": "2024-06-10" }
|
|
||||||
```
|
|
||||||
|
|
||||||
**Mit curl:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
curl -X POST http://localhost:5000/api/wochentag \
|
|
||||||
-H "Content-Type: application/json" \
|
|
||||||
-d '{"datum": "2024-06-10"}'
|
|
||||||
```
|
|
||||||
|
|
||||||
**Antwort:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{ "result": "Montag" }
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 3. Kalenderwoche zu Datum
|
|
||||||
|
|
||||||
**POST** `/api/kw_berechnen`
|
|
||||||
|
|
||||||
```json
|
|
||||||
{ "datum": "2024-06-10" }
|
|
||||||
```
|
|
||||||
|
|
||||||
**Mit curl:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
curl -X POST http://localhost:5000/api/kw_berechnen \
|
|
||||||
-H "Content-Type: application/json" \
|
|
||||||
-d '{"datum": "2024-06-10"}'
|
|
||||||
```
|
|
||||||
|
|
||||||
**Antwort:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{ "result": "KW 24 (2024)", "kw": 24, "jahr": 2024 }
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 4. Start-/Enddatum einer Kalenderwoche
|
|
||||||
|
|
||||||
**POST** `/api/kw_datum`
|
|
||||||
|
|
||||||
```json
|
|
||||||
{ "jahr": 2024, "kw": 24 }
|
|
||||||
```
|
|
||||||
|
|
||||||
**Mit curl:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
curl -X POST http://localhost:5000/api/kw_datum \
|
|
||||||
-H "Content-Type: application/json" \
|
|
||||||
-d '{"jahr": 2024, "kw": 24}'
|
|
||||||
```
|
|
||||||
|
|
||||||
**Antwort:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"result": "10.06.2024 bis 16.06.2024",
|
|
||||||
"start": "2024-06-10",
|
|
||||||
"end": "2024-06-16"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 5. Datum plus/minus Tage, Wochen, Monate
|
|
||||||
|
|
||||||
**POST** `/api/plusminus`
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"datum": "2024-06-10",
|
|
||||||
"anzahl": 5,
|
|
||||||
"einheit": "tage",
|
|
||||||
"richtung": "add",
|
|
||||||
"werktage": false
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Mit curl:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
curl -X POST http://localhost:5000/api/plusminus \
|
|
||||||
-H "Content-Type: application/json" \
|
|
||||||
-d '{"datum": "2024-06-10", "anzahl": 5, "einheit": "tage", "richtung": "add", "werktage": false}'
|
|
||||||
```
|
|
||||||
|
|
||||||
**Antwort:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{ "result": "2024-06-15" }
|
|
||||||
```
|
|
||||||
|
|
||||||
**Hinweis:**
|
|
||||||
- `"einheit"`: `"tage"`, `"wochen"` oder `"monate"`
|
|
||||||
- `"richtung"`: `"add"` (plus) oder `"sub"` (minus)
|
|
||||||
- `"werktage"`: `true` für Werktage, sonst `false` (nur bei `"tage"` unterstützt)
|
|
||||||
|
|
||||||
#### 6. Statistik
|
|
||||||
|
|
||||||
**GET** `/api/stats`
|
|
||||||
|
|
||||||
**Mit curl:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
curl http://localhost:5000/api/stats
|
|
||||||
```
|
|
||||||
|
|
||||||
**Antwort:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"pageviews": 42,
|
|
||||||
"func_counts": { "plusminus": 10, "tage_werktage": 5 },
|
|
||||||
"impressions_per_day": { "2024-06-10": 7 }
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 7. Monitoring & Healthcheck
|
|
||||||
|
|
||||||
**GET** `/api/monitor`
|
|
||||||
|
|
||||||
**Mit curl:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
curl http://localhost:5000/api/monitor
|
|
||||||
```
|
|
||||||
|
|
||||||
**Antwort:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"status": "ok",
|
|
||||||
"message": "App running",
|
|
||||||
"time": "2025-07-24T13:37:00.123456",
|
|
||||||
"uptime_seconds": 12345,
|
|
||||||
"pageviews_last_7_days": 42
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**Fehlerfälle** liefern immer einen HTTP-Statuscode 400 und ein JSON mit `"error"`-Feld, z.B.:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{ "error": "Ungültige Eingabe", "details": "..." }
|
|
||||||
```
|
|
||||||
|
|
||||||
## Progressive Web App (PWA)
|
|
||||||
|
|
||||||
Elpatrons Datumsrechner ist als PWA installierbar (z.B. auf Android/iOS-Homescreen oder Desktop). Die App funktioniert offline für die Startseite und statische Ressourcen, die Datumsberechnung bleibt serverseitig.
|
|
||||||
|
|
||||||
- Manifest und Service Worker sind integriert
|
|
||||||
- App-Icon und Theme-Color für Homescreen
|
|
||||||
- Installation über Browser-Menü ("Zum Startbildschirm hinzufügen")
|
|
||||||
|
|
||||||
## Monitoring & Healthcheck
|
|
||||||
|
|
||||||
Die App bietet einen Monitoring-Endpunkt unter `/monitor`, der Statusinformationen als JSON zurückgibt (z.B. für Uptime-Robot, Docker Healthcheck oder eigene Tools):
|
|
||||||
|
|
||||||
- Status (ok)
|
|
||||||
- Aktuelle Serverzeit
|
|
||||||
- Uptime (Sekunden seit Start)
|
|
||||||
- Pageviews der letzten 7 Tage
|
|
||||||
|
|
||||||
Beispiel-Aufruf:
|
|
||||||
|
|
||||||
```
|
|
||||||
GET https://date.elpatron.me/monitor
|
|
||||||
```
|
|
||||||
|
|
||||||
Antwort:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"status": "ok",
|
|
||||||
"message": "App running",
|
|
||||||
"time": "2025-07-24T13:37:00.123456",
|
|
||||||
"uptime_seconds": 12345,
|
|
||||||
"pageviews_last_7_days": 42
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Entwicklung & Hinweise
|
|
||||||
|
|
||||||
- Die HTML-Templates liegen im Ordner `templates/` (Trennung von Logik und Darstellung)
|
|
||||||
- Das Projekt ist auf Codeberg gehostet: [https://codeberg.org/elpatron/datecalc](https://codeberg.org/elpatron/datecalc)
|
|
||||||
- Modernes, responsives Design mit Akkordeon und Icons
|
|
||||||
|
|
||||||
## Automatisierte Tests
|
|
||||||
|
|
||||||
Automatisierte Tests sind mit pytest möglich:
|
|
||||||
|
|
||||||
```powershell
|
|
||||||
pip install -r requirements.txt
|
|
||||||
pytest test_app.py
|
|
||||||
```
|
|
||||||
|
|
||||||
Die Tests prüfen u.a. die Erreichbarkeit der App, die wichtigsten Funktionen und den Schutz vor XSS-Angriffen.
|
|
||||||
|
|
||||||
## Hinweise
|
|
||||||
|
|
||||||
### Motivation
|
|
||||||
|
|
||||||
Finde mal eine Datumsrechner- Webapp, die nicht völlig Werbe- und Tracking verseucht ist! Da ich sowas häufiger mal brauche, hab ich mir eine eigene gemacht.
|
|
||||||
|
|
||||||
### Vibe Coding
|
|
||||||
|
|
||||||
Dieses Projekt wurde zu nahezu 100% mit Unterstützung künsticher Intelligenz (*[Vibe Coding](https://de.wikipedia.org/wiki/Vibe_Coding)*) erstellt. Das Grundgerüst war nach ca. 45 Minuten fertig gestellt, insgesamt hat die Entwicklung des Projekts ca. 4 Stunden Zeit beansprucht.
|
|
||||||
|
|
||||||
### Statistik-Erfassung, Logging
|
|
||||||
|
|
||||||
Es werden keine IP-Adressen oder sonstigen persönlichen Daten gespeichert, lediglich die Zahl der Aufrufe der Funktionen in einer kumulierten Darstellung. Die Logdatei enthält nur Einträge der letzten sieben Tage.
|
|
||||||
|
|
||||||
### Barrierefreiheit (Accessibility)
|
|
||||||
|
|
||||||
*Elpatrons Datumsrechner* ist barrierefrei gestaltet und erfüllt zentrale Anforderungen an Accessibility (a11y):
|
|
||||||
|
|
||||||
- *Semantische HTML-Struktur:* Überschriften, Labels und Formularelemente sind korrekt ausgezeichnet und verknüpft.
|
|
||||||
- *ARIA-Attribute:* Accordion und Statusmeldungen sind mit ARIA-Attributen versehen, damit Screenreader die Struktur und Zustände erkennen.
|
|
||||||
- *Tastaturbedienbarkeit:* Alle interaktiven Elemente (Accordion, Buttons, Formulare) sind vollständig per Tastatur bedienbar (inkl. Fokus-Indikator und Pfeiltasten-Navigation im Accordion).
|
|
||||||
- *Fokus-Indikatoren:* Deutliche visuelle Hervorhebung des Fokus für alle Bedienelemente.
|
|
||||||
- *Farbkontraste:* Hohe Kontraste für Texte, Buttons und Ergebnisboxen, geprüft nach WCAG-Richtlinien.
|
|
||||||
- *Status- und Fehlermeldungen:* Ergebnisse und Fehler werden mit `aria-live` für Screenreader zugänglich gemacht.
|
|
||||||
- *Sprachausgabe:* Alle Ergebnisse können über 🔊-Buttons vorgelesen werden (Web Speech API, deutsche Sprache).
|
|
||||||
- *Mobile Optimierung:* Zusätzliche Meta-Tags für bessere Bedienbarkeit auf mobilen Geräten und Unterstützung von Screenreadern.
|
|
||||||
- *SEO:* Das Thema Barrierefreiheit ist in den Meta-Tags für Suchmaschinen sichtbar.
|
|
||||||
|
|
||||||
Damit ist die App für Menschen mit unterschiedlichen Einschränkungen (z.B. Sehbehinderung, motorische Einschränkungen) gut nutzbar und entspricht modernen Webstandards.
|
|
||||||
|
|
||||||
### Code Statistik
|
|
||||||
|
|
||||||
cloc|github.com/AlDanial/cloc v 2.06 T=0.08 s (301.6 files/s, 72354.1 lines/s)
|
|
||||||
--- | ---
|
|
||||||
|
|
||||||
Language|files|blank|comment|code
|
|
||||||
:-------|-------:|-------:|-------:|-------:
|
|
||||||
HTML|8|47|6|2086
|
|
||||||
Python|2|59|68|690
|
|
||||||
JavaScript|2|95|87|571
|
|
||||||
Markdown|3|176|0|492
|
|
||||||
PO File|2|234|240|492
|
|
||||||
JSON|3|0|0|243
|
|
||||||
CSS|1|186|3|188
|
|
||||||
SVG|2|0|0|14
|
|
||||||
Dockerfile|1|5|6|8
|
|
||||||
DOS Batch|1|0|0|1
|
|
||||||
--------|--------|--------|--------|--------
|
|
||||||
SUM:|25|802|410|4785
|
|
||||||
|
|
||||||
## Lizenz
|
|
||||||
|
|
||||||
Dieses Projekt steht unter der [MIT-Lizenz](LICENSE).
|
|
||||||
|
|
||||||
---
|
|
||||||
(c) 2025 [Markus Busche](https://digitalcourage.social/@elpatron)
|
(c) 2025 [Markus Busche](https://digitalcourage.social/@elpatron)
|
||||||
|
|
||||||
**Version 1.4.0** - Mehrsprachige Unterstützung hinzugefügt
|
|
||||||
|
|||||||
512
README_de.md
Normal file
512
README_de.md
Normal file
@@ -0,0 +1,512 @@
|
|||||||
|
# Elpatrons Datumsrechner
|
||||||
|
|
||||||
|
[](https://github.com/elpatron/datecalc)
|
||||||
|
[](https://date.elpatron.me)
|
||||||
|
[](https://date.elpatron.me)
|
||||||
|
[](https://date.elpatron.me)
|
||||||
|
[](https://date.elpatron.me)
|
||||||
|
|
||||||
|
Diese moderne Python-Webanwendung (Flask) ermöglicht verschiedene Datumsberechnungen über eine übersichtliche, barrierefreie Weboberfläche.
|
||||||
|
|
||||||
|
## Inhaltsverzeichnis
|
||||||
|
|
||||||
|
- [Demo](#demo)
|
||||||
|
- [Funktionen](#funktionen)
|
||||||
|
- [Installation (lokal)](#installation-lokal)
|
||||||
|
- [Starten der App](#starten-der-app)
|
||||||
|
- [Statistik-Dashboard & Passwortschutz](#statistik-dashboard-stats--passwortschutz)
|
||||||
|
- [Docker (empfohlen für Produktion)](#docker-empfohlen-für-produktion)
|
||||||
|
- [Log-Verzeichnis mounten](#log-verzeichnis-mounten-logs-auf-dem-host-speichern)
|
||||||
|
- [docker-compose Beispiel](#docker-compose-beispiel)
|
||||||
|
- [REST API](#rest-api)
|
||||||
|
- [Tage/Werktage zwischen zwei Daten](#1-tagewerktage-zwischen-zwei-daten)
|
||||||
|
- [Wochentag zu einem Datum](#2-wochentag-zu-einem-datum)
|
||||||
|
- [Kalenderwoche zu Datum](#3-kalenderwoche-zu-datum)
|
||||||
|
- [Start-/Enddatum einer Kalenderwoche](#4-start-enddatum-einer-kalenderwoche)
|
||||||
|
- [Datum plus/minus Tage, Wochen, Monate](#5-datum-plusminus-tage-wochen-monate)
|
||||||
|
- [Statistik](#6-statistik)
|
||||||
|
- [Monitoring & Healthcheck](#7-monitoring--healthcheck)
|
||||||
|
- [Progressive Web App (PWA)](#progressive-web-app-pwa)
|
||||||
|
- [Monitoring & Healthcheck](#monitoring--healthcheck)
|
||||||
|
- [Entwicklung & Hinweise](#entwicklung--hinweise)
|
||||||
|
- [Automatisierte Tests](#automatisierte-tests)
|
||||||
|
- [Hinweise](#hinweise)
|
||||||
|
- [Motivation](#motivation)
|
||||||
|
- [Vibe Coding](#vibe-coding)
|
||||||
|
- [Statistik-Erfassung, Logging](#statistik-erfassung-logging)
|
||||||
|
- [Barrierefreiheit (Accessibility)](#barrierefreiheit-accessibility)
|
||||||
|
- [Code Statistik](#code-statistik)
|
||||||
|
- [Lizenz](#lizenz)
|
||||||
|
|
||||||
|
## Demo
|
||||||
|
|
||||||
|
Datumsrechner Live: [https://date.elpatron.me](https://date.elpatron.me)
|
||||||
|
|
||||||
|
[](https://date.elpatron.me)
|
||||||
|
|
||||||
|
**[Lighthouse](https://en.wikipedia.org/wiki/Lighthouse_(software))-Performance-Score:**
|
||||||
|
|
||||||
|
Die Webanwendung erreicht hervorragende Performance-Werte in allen Kategorien (Performance, Accessibility, Best Practices, SEO).
|
||||||
|
|
||||||
|
[Lighthouse-Ergebnis (PDF)](./lighthouse/lighthouse-score.pdf)
|
||||||
|
|
||||||
|
## Funktionen
|
||||||
|
|
||||||
|
- Anzahl der Tage zwischen zwei Daten
|
||||||
|
- Anzahl der Werktage zwischen zwei Daten (mit optionaler Berücksichtigung bundeslandspezifischer Feiertage)
|
||||||
|
- 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
|
||||||
|
- Integrierter Taschenrechner mit History und Sprachausgabe
|
||||||
|
- Mehrsprachige Unterstützung (Deutsch/Englisch) mit automatischer Browser-Spracherkennung
|
||||||
|
- Sprachausgabe für alle Ergebnisse (barrierefrei)
|
||||||
|
- Statistik-Dashboard mit Passwortschutz unter `/stats`
|
||||||
|
|
||||||
|
## Bundesland-Feiertage
|
||||||
|
|
||||||
|
Die Werktagsberechnung kann optional bundeslandspezifische Feiertage berücksichtigen. Dazu wird die kostenlose API von [feiertage-api.de](https://feiertage-api.de) verwendet.
|
||||||
|
|
||||||
|
**Verfügbare Bundesländer:**
|
||||||
|
|
||||||
|
- Baden-Württemberg (BW)
|
||||||
|
- Bayern (BY)
|
||||||
|
- Berlin (BE)
|
||||||
|
- Brandenburg (BB)
|
||||||
|
- Bremen (HB)
|
||||||
|
- Hamburg (HH)
|
||||||
|
- Hessen (HE)
|
||||||
|
- Mecklenburg-Vorpommern (MV)
|
||||||
|
- Niedersachsen (NI)
|
||||||
|
- Nordrhein-Westfalen (NW)
|
||||||
|
- Rheinland-Pfalz (RP)
|
||||||
|
- Saarland (SL)
|
||||||
|
- Sachsen (SN)
|
||||||
|
- Sachsen-Anhalt (ST)
|
||||||
|
- Schleswig-Holstein (SH)
|
||||||
|
- Thüringen (TH)
|
||||||
|
|
||||||
|
Die Feiertage werden automatisch für den gewählten Zeitraum abgerufen und bei der Werktagsberechnung als arbeitsfreie Tage behandelt. Im Ergebnis werden zusätzlich die Anzahl der Wochenendtage und Feiertage angezeigt.
|
||||||
|
|
||||||
|
## Mehrsprachige Unterstützung (i18n)
|
||||||
|
|
||||||
|
Die Anwendung unterstützt Deutsch und Englisch mit folgenden Features:
|
||||||
|
|
||||||
|
### Automatische Spracherkennung:
|
||||||
|
|
||||||
|
- *Browser-Sprache*: Automatische Erkennung der Browser-Einstellung
|
||||||
|
- *URL-Parameter*: Sprachauswahl über `?lang=de` oder `?lang=en`
|
||||||
|
- *localStorage*: Persistente Sprachauswahl im Browser
|
||||||
|
- *Fallback*: Deutsch als Standardsprache
|
||||||
|
|
||||||
|
### *Datenschutzfreundliche Implementierung:*
|
||||||
|
|
||||||
|
- *Keine Cookies*: Sprachauswahl ohne Cookies
|
||||||
|
- *URL-Parameter*: Transparente Sprachauswahl in der URL
|
||||||
|
- *localStorage*: Lokale Speicherung im Browser
|
||||||
|
- *Teilbare URLs*: URLs mit Sprachauswahl können geteilt werden
|
||||||
|
|
||||||
|
### *Barrierefreiheit:*
|
||||||
|
|
||||||
|
- *Screenreader*: Vollständige Unterstützung
|
||||||
|
- *Tastatur-Navigation*: Vollständig bedienbar
|
||||||
|
- *ARIA-Attribute*: Korrekte Beschriftungen
|
||||||
|
- *Semantische HTML*: Korrekte Struktur
|
||||||
|
- *Taschenrechner*: Vollständig barrierefrei mit Tastatur-Bedienung und Sprachausgabe
|
||||||
|
|
||||||
|
### *Technische Details:*
|
||||||
|
|
||||||
|
- *Flask-Babel*: Professionelle i18n-Implementierung
|
||||||
|
- *Gettext*: Standard für Übersetzungen
|
||||||
|
- *Responsive Design*: Angepasst für alle Geräte
|
||||||
|
- *SEO-freundlich*: URLs sind indexierbar
|
||||||
|
|
||||||
|
## Installation (lokal)
|
||||||
|
|
||||||
|
1. Python 3.8+ installieren
|
||||||
|
2. Abhängigkeiten installieren:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
|
## Starten der App
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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**:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker build -t datumsrechner .
|
||||||
|
docker run -p 5000:5000 datumsrechner
|
||||||
|
```
|
||||||
|
|
||||||
|
- Gunicorn startet automatisch (siehe Dockerfile)
|
||||||
|
- Empfohlen für produktiven Einsatz
|
||||||
|
|
||||||
|
### Log-Verzeichnis mounten (Logs auf dem Host speichern)
|
||||||
|
|
||||||
|
Um die Logdateien außerhalb des Containers zu speichern, kannst du das log-Verzeichnis mounten:
|
||||||
|
|
||||||
|
**PowerShell-Beispiel:**
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
docker run -e STATS_PASSWORD=deinPasswort -p 5000:5000 -v ${PWD}/log:/app/log datumsrechner
|
||||||
|
```
|
||||||
|
|
||||||
|
### docker-compose Beispiel
|
||||||
|
|
||||||
|
Erstelle eine Datei `docker-compose.yml`:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
services:
|
||||||
|
datumsrechner:
|
||||||
|
build: .
|
||||||
|
ports:
|
||||||
|
- "5000:5000"
|
||||||
|
environment:
|
||||||
|
- STATS_PASSWORD=deinPasswort
|
||||||
|
volumes:
|
||||||
|
- ./log:/app/log
|
||||||
|
```
|
||||||
|
|
||||||
|
Starte mit:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker-compose up --build
|
||||||
|
```
|
||||||
|
|
||||||
|
## REST API
|
||||||
|
|
||||||
|
Alle Datumsfunktionen stehen auch als REST-API zur Verfügung. Die API akzeptiert und liefert JSON.
|
||||||
|
|
||||||
|
**Basis-URL:** `http://localhost:5000/api/`
|
||||||
|
|
||||||
|
**Swagger Dokumentation:** [https://date.elpatron.me/api-docs](https://date.elpatron.me/api-docs)
|
||||||
|
|
||||||
|
**Hinweis:** Die Nutzung der REST API wird im Statistik-Dashboard ausgewertet und als Diagramm angezeigt.
|
||||||
|
|
||||||
|
### Endpunkte und Beispiele
|
||||||
|
|
||||||
|
#### 1. Tage/Werktage zwischen zwei Daten
|
||||||
|
|
||||||
|
**POST** `/api/tage_werktage`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"start": "2024-06-01",
|
||||||
|
"end": "2024-06-10",
|
||||||
|
"werktage": true,
|
||||||
|
"bundesland": "BY"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Mit curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:5000/api/tage_werktage \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"start": "2024-06-01", "end": "2024-06-10", "werktage": true, "bundesland": "BY"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Antwort:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "result": 7 }
|
||||||
|
```
|
||||||
|
|
||||||
|
**Hinweis:** Der Parameter `bundesland` ist optional und wird nur bei `"werktage": true` berücksichtigt. Verfügbare Bundesland-Kürzel siehe oben.
|
||||||
|
|
||||||
|
#### 2. Wochentag zu einem Datum
|
||||||
|
|
||||||
|
**POST** `/api/wochentag`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "datum": "2024-06-10" }
|
||||||
|
```
|
||||||
|
|
||||||
|
**Mit curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:5000/api/wochentag \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"datum": "2024-06-10"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Antwort:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "result": "Montag" }
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. Kalenderwoche zu Datum
|
||||||
|
|
||||||
|
**POST** `/api/kw_berechnen`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "datum": "2024-06-10" }
|
||||||
|
```
|
||||||
|
|
||||||
|
**Mit curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:5000/api/kw_berechnen \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"datum": "2024-06-10"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Antwort:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "result": "KW 24 (2024)", "kw": 24, "jahr": 2024 }
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 4. Start-/Enddatum einer Kalenderwoche
|
||||||
|
|
||||||
|
**POST** `/api/kw_datum`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "jahr": 2024, "kw": 24 }
|
||||||
|
```
|
||||||
|
|
||||||
|
**Mit curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:5000/api/kw_datum \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"jahr": 2024, "kw": 24}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Antwort:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"result": "10.06.2024 bis 16.06.2024",
|
||||||
|
"start": "2024-06-10",
|
||||||
|
"end": "2024-06-16"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5. Datum plus/minus Tage, Wochen, Monate
|
||||||
|
|
||||||
|
**POST** `/api/plusminus`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"datum": "2024-06-10",
|
||||||
|
"anzahl": 5,
|
||||||
|
"einheit": "tage",
|
||||||
|
"richtung": "add",
|
||||||
|
"werktage": false
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Mit curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:5000/api/plusminus \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"datum": "2024-06-10", "anzahl": 5, "einheit": "tage", "richtung": "add", "werktage": false}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Antwort:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "result": "2024-06-15" }
|
||||||
|
```
|
||||||
|
|
||||||
|
**Hinweis:**
|
||||||
|
|
||||||
|
- `"einheit"`: `"tage"`, `"wochen"` oder `"monate"`
|
||||||
|
- `"richtung"`: `"add"` (plus) oder `"sub"` (minus)
|
||||||
|
- `"werktage"`: `true` für Werktage, sonst `false` (nur bei `"tage"` unterstützt)
|
||||||
|
|
||||||
|
#### 6. Statistik
|
||||||
|
|
||||||
|
**GET** `/api/stats`
|
||||||
|
|
||||||
|
**Mit curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl http://localhost:5000/api/stats
|
||||||
|
```
|
||||||
|
|
||||||
|
**Antwort:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"pageviews": 42,
|
||||||
|
"func_counts": { "plusminus": 10, "tage_werktage": 5 },
|
||||||
|
"impressions_per_day": { "2024-06-10": 7 }
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 7. Monitoring & Healthcheck
|
||||||
|
|
||||||
|
**GET** `/api/monitor`
|
||||||
|
|
||||||
|
**Mit curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl http://localhost:5000/api/monitor
|
||||||
|
```
|
||||||
|
|
||||||
|
**Antwort:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"status": "ok",
|
||||||
|
"message": "App running",
|
||||||
|
"time": "2025-07-24T13:37:00.123456",
|
||||||
|
"uptime_seconds": 12345,
|
||||||
|
"pageviews_last_7_days": 42
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Fehlerfälle** liefern immer einen HTTP-Statuscode 400 und ein JSON mit `"error"`-Feld, z.B.:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "error": "Ungültige Eingabe", "details": "..." }
|
||||||
|
```
|
||||||
|
|
||||||
|
## Progressive Web App (PWA)
|
||||||
|
|
||||||
|
Elpatrons Datumsrechner ist als PWA installierbar (z.B. auf Android/iOS-Homescreen oder Desktop). Die App funktioniert offline für die Startseite und statische Ressourcen, die Datumsberechnung bleibt serverseitig.
|
||||||
|
|
||||||
|
- Manifest und Service Worker sind integriert
|
||||||
|
- App-Icon und Theme-Color für Homescreen
|
||||||
|
- Installation über Browser-Menü ("Zum Startbildschirm hinzufügen")
|
||||||
|
- Taschenrechner funktioniert vollständig clientseitig (offline verfügbar)
|
||||||
|
|
||||||
|
## Monitoring & Healthcheck
|
||||||
|
|
||||||
|
Die App bietet einen Monitoring-Endpunkt unter `/monitor`, der Statusinformationen als JSON zurückgibt (z.B. für Uptime-Robot, Docker Healthcheck oder eigene Tools):
|
||||||
|
|
||||||
|
- Status (ok)
|
||||||
|
- Aktuelle Serverzeit
|
||||||
|
- Uptime (Sekunden seit Start)
|
||||||
|
- Pageviews der letzten 7 Tage
|
||||||
|
|
||||||
|
Beispiel-Aufruf:
|
||||||
|
|
||||||
|
`GET https://date.elpatron.me/monitor`
|
||||||
|
|
||||||
|
Antwort:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"status": "ok",
|
||||||
|
"message": "App running",
|
||||||
|
"time": "2025-07-24T13:37:00.123456",
|
||||||
|
"uptime_seconds": 12345,
|
||||||
|
"pageviews_last_7_days": 42
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Entwicklung & Hinweise
|
||||||
|
|
||||||
|
- Die HTML-Templates liegen im Ordner `templates/` (Trennung von Logik und Darstellung)
|
||||||
|
- Das Projekt ist auf Codeberg gehostet: [https://codeberg.org/elpatron/datecalc](https://codeberg.org/elpatron/datecalc)
|
||||||
|
- Modernes, responsives Design mit Akkordeon und Icons
|
||||||
|
|
||||||
|
## Automatisierte Tests
|
||||||
|
|
||||||
|
Automatisierte Tests sind mit pytest möglich:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
pip install -r requirements.txt
|
||||||
|
pytest test_app.py
|
||||||
|
```
|
||||||
|
|
||||||
|
Die Tests prüfen u.a. die Erreichbarkeit der App, die wichtigsten Funktionen und den Schutz vor XSS-Angriffen.
|
||||||
|
|
||||||
|
## Hinweise
|
||||||
|
|
||||||
|
### Motivation
|
||||||
|
|
||||||
|
Finde mal eine Datumsrechner- Webapp, die nicht völlig Werbe- und Tracking verseucht ist! Da ich sowas häufiger mal brauche, hab ich mir eine eigene gemacht.
|
||||||
|
|
||||||
|
### Vibe Coding
|
||||||
|
|
||||||
|
Dieses Projekt wurde zu nahezu 100% mit Unterstützung künsticher Intelligenz (*[Vibe Coding](https://de.wikipedia.org/wiki/Vibe_Coding)*) erstellt. Das Grundgerüst war nach ca. 45 Minuten fertig gestellt, insgesamt hat die Entwicklung des Projekts ca. 12 Stunden Zeit beansprucht.
|
||||||
|
|
||||||
|
### Statistik-Erfassung, Logging
|
||||||
|
|
||||||
|
Es werden keine IP-Adressen oder sonstigen persönlichen Daten gespeichert, lediglich die Zahl der Aufrufe der Funktionen in einer kumulierten Darstellung. Die Logdatei enthält nur Einträge der letzten sieben Tage.
|
||||||
|
|
||||||
|
### Barrierefreiheit (Accessibility)
|
||||||
|
|
||||||
|
*Elpatrons Datumsrechner* ist barrierefrei gestaltet und erfüllt zentrale Anforderungen an Accessibility (a11y):
|
||||||
|
|
||||||
|
- *Semantische HTML-Struktur:* Überschriften, Labels und Formularelemente sind korrekt ausgezeichnet und verknüpft.
|
||||||
|
- *ARIA-Attribute:* Accordion und Statusmeldungen sind mit ARIA-Attributen versehen, damit Screenreader die Struktur und Zustände erkennen.
|
||||||
|
- *Tastaturbedienbarkeit:* Alle interaktiven Elemente (Accordion, Buttons, Formulare) sind vollständig per Tastatur bedienbar (inkl. Fokus-Indikator und Pfeiltasten-Navigation im Accordion).
|
||||||
|
- *Fokus-Indikatoren:* Deutliche visuelle Hervorhebung des Fokus für alle Bedienelemente.
|
||||||
|
- *Farbkontraste:* Hohe Kontraste für Texte, Buttons und Ergebnisboxen, geprüft nach WCAG-Richtlinien.
|
||||||
|
- *Status- und Fehlermeldungen:* Ergebnisse und Fehler werden mit `aria-live` für Screenreader zugänglich gemacht.
|
||||||
|
- *Sprachausgabe:* Alle Ergebnisse können über 🔊-Buttons vorgelesen werden (Web Speech API, deutsche Sprache).
|
||||||
|
- *Taschenrechner:* Vollständig barrierefrei mit Tastatur-Bedienung, Sprachausgabe und History-Funktion.
|
||||||
|
- *Mobile Optimierung:* Zusätzliche Meta-Tags für bessere Bedienbarkeit auf mobilen Geräten und Unterstützung von Screenreadern.
|
||||||
|
- *SEO:* Das Thema Barrierefreiheit ist in den Meta-Tags für Suchmaschinen sichtbar.
|
||||||
|
|
||||||
|
Damit ist die App für Menschen mit unterschiedlichen Einschränkungen (z.B. Sehbehinderung, motorische Einschränkungen) gut nutzbar und entspricht modernen Webstandards.
|
||||||
|
|
||||||
|
### Code Statistik
|
||||||
|
|
||||||
|
cloc|github.com/AlDanial/cloc v 2.06 T=0.22 s (124.7 files/s, 34058.5 lines/s)
|
||||||
|
--- | ---
|
||||||
|
|
||||||
|
Language|files|blank|comment|code
|
||||||
|
:-------|-------:|-------:|-------:|-------:
|
||||||
|
HTML|8|159|8|2806
|
||||||
|
Markdown|5|340|0|876
|
||||||
|
Python|2|68|76|744
|
||||||
|
JavaScript|2|95|88|580
|
||||||
|
PO File|2|260|266|544
|
||||||
|
JSON|3|0|0|243
|
||||||
|
CSS|1|186|3|188
|
||||||
|
XML|1|10|4|69
|
||||||
|
SVG|2|0|0|14
|
||||||
|
Dockerfile|1|5|6|8
|
||||||
|
DOS Batch|1|0|0|1
|
||||||
|
--------|--------|--------|--------|--------
|
||||||
|
SUM:|28|1123|451|6073
|
||||||
|
|
||||||
|
## Lizenz
|
||||||
|
|
||||||
|
Dieses Projekt steht unter der [MIT-Lizenz](LICENSE).
|
||||||
|
|
||||||
|
---
|
||||||
|
(c) 2025 [Markus Busche](https://digitalcourage.social/@elpatron)
|
||||||
|
|
||||||
|
**Version 1.4.12** - Integrierter Taschenrechner mit History und Sprachausgabe hinzugefügt
|
||||||
512
README_en.md
Normal file
512
README_en.md
Normal file
@@ -0,0 +1,512 @@
|
|||||||
|
# Elpatrons Date Calculator
|
||||||
|
|
||||||
|
[](https://github.com/elpatron/datecalc)
|
||||||
|
[](https://date.elpatron.me)
|
||||||
|
[](https://date.elpatron.me)
|
||||||
|
[](https://date.elpatron.me)
|
||||||
|
[](https://date.elpatron.me)
|
||||||
|
|
||||||
|
This modern Python web application (Flask) enables various date calculations through a clear, accessible web interface.
|
||||||
|
|
||||||
|
## Table of Contents
|
||||||
|
|
||||||
|
- [Demo](#demo)
|
||||||
|
- [Features](#features)
|
||||||
|
- [Installation (local)](#installation-local)
|
||||||
|
- [Starting the App](#starting-the-app)
|
||||||
|
- [Statistics Dashboard & Password Protection](#statistics-dashboard--password-protection)
|
||||||
|
- [Docker (recommended for production)](#docker-recommended-for-production)
|
||||||
|
- [Mounting log directory](#mounting-log-directory-logs-stored-on-host)
|
||||||
|
- [docker-compose example](#docker-compose-example)
|
||||||
|
- [REST API](#rest-api)
|
||||||
|
- [Days/Working days between two dates](#1-daysworking-days-between-two-dates)
|
||||||
|
- [Weekday for a date](#2-weekday-for-a-date)
|
||||||
|
- [Calendar week for date](#3-calendar-week-for-date)
|
||||||
|
- [Start/End date of a calendar week](#4-startend-date-of-a-calendar-week)
|
||||||
|
- [Date plus/minus days, weeks, months](#5-date-plusminus-days-weeks-months)
|
||||||
|
- [Statistics](#6-statistics)
|
||||||
|
- [Monitoring & Healthcheck](#7-monitoring--healthcheck)
|
||||||
|
- [Progressive Web App (PWA)](#progressive-web-app-pwa)
|
||||||
|
- [Monitoring & Healthcheck](#monitoring--healthcheck)
|
||||||
|
- [Development & Notes](#development--notes)
|
||||||
|
- [Automated Tests](#automated-tests)
|
||||||
|
- [Notes](#notes)
|
||||||
|
- [Motivation](#motivation)
|
||||||
|
- [Vibe Coding](#vibe-coding)
|
||||||
|
- [Statistics collection, Logging](#statistics-collection-logging)
|
||||||
|
- [Accessibility](#accessibility)
|
||||||
|
- [Code Statistics](#code-statistics)
|
||||||
|
- [License](#license)
|
||||||
|
|
||||||
|
## Demo
|
||||||
|
|
||||||
|
Date Calculator Live: [https://date.elpatron.me](https://date.elpatron.me)
|
||||||
|
|
||||||
|
[](https://date.elpatron.me)
|
||||||
|
|
||||||
|
**[Lighthouse](https://en.wikipedia.org/wiki/Lighthouse_(software)) Performance Score:**
|
||||||
|
|
||||||
|
The web application achieves excellent performance values in all categories (Performance, Accessibility, Best Practices, SEO).
|
||||||
|
|
||||||
|
[Lighthouse Result (PDF)](./lighthouse/lighthouse-score.pdf)
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Number of days between two dates
|
||||||
|
- Number of working days between two dates (with optional consideration of state-specific holidays)
|
||||||
|
- Display of the weekday of a date
|
||||||
|
- Date plus/minus X days
|
||||||
|
- Date plus/minus X working days
|
||||||
|
- Date plus/minus X weeks/months
|
||||||
|
- Calendar week for date
|
||||||
|
- Start/End date of a calendar week of a year
|
||||||
|
- Integrated calculator with history and speech output
|
||||||
|
- Multilingual support (German/English) with automatic browser language detection
|
||||||
|
- Speech output for all results (accessible)
|
||||||
|
- Statistics dashboard with password protection under `/stats`
|
||||||
|
|
||||||
|
## State Holidays
|
||||||
|
|
||||||
|
The working day calculation can optionally consider state-specific holidays. The free API from [feiertage-api.de](https://feiertage-api.de) is used for this purpose.
|
||||||
|
|
||||||
|
**Available States:**
|
||||||
|
|
||||||
|
- Baden-Württemberg (BW)
|
||||||
|
- Bavaria (BY)
|
||||||
|
- Berlin (BE)
|
||||||
|
- Brandenburg (BB)
|
||||||
|
- Bremen (HB)
|
||||||
|
- Hamburg (HH)
|
||||||
|
- Hesse (HE)
|
||||||
|
- Mecklenburg-Vorpommern (MV)
|
||||||
|
- Lower Saxony (NI)
|
||||||
|
- North Rhine-Westphalia (NW)
|
||||||
|
- Rhineland-Palatinate (RP)
|
||||||
|
- Saarland (SL)
|
||||||
|
- Saxony (SN)
|
||||||
|
- Saxony-Anhalt (ST)
|
||||||
|
- Schleswig-Holstein (SH)
|
||||||
|
- Thuringia (TH)
|
||||||
|
|
||||||
|
Holidays are automatically retrieved for the selected time period and treated as non-working days in the working day calculation. The result also shows the number of weekend days and holidays.
|
||||||
|
|
||||||
|
## Multilingual Support (i18n)
|
||||||
|
|
||||||
|
The application supports German and English with the following features:
|
||||||
|
|
||||||
|
### Automatic Language Detection:
|
||||||
|
|
||||||
|
- *Browser Language*: Automatic detection of browser settings
|
||||||
|
- *URL Parameter*: Language selection via `?lang=de` or `?lang=en`
|
||||||
|
- *localStorage*: Persistent language selection in browser
|
||||||
|
- *Fallback*: German as default language
|
||||||
|
|
||||||
|
### *Privacy-friendly Implementation:*
|
||||||
|
|
||||||
|
- *No Cookies*: Language selection without cookies
|
||||||
|
- *URL Parameters*: Transparent language selection in URL
|
||||||
|
- *localStorage*: Local storage in browser
|
||||||
|
- *Shareable URLs*: URLs with language selection can be shared
|
||||||
|
|
||||||
|
### *Accessibility:*
|
||||||
|
|
||||||
|
- *Screen Reader*: Full support
|
||||||
|
- *Keyboard Navigation*: Fully operable
|
||||||
|
- *ARIA Attributes*: Correct labels
|
||||||
|
- *Semantic HTML*: Correct structure
|
||||||
|
- *Calculator*: Fully accessible with keyboard operation and speech output
|
||||||
|
|
||||||
|
### *Technical Details:*
|
||||||
|
|
||||||
|
- *Flask-Babel*: Professional i18n implementation
|
||||||
|
- *Gettext*: Standard for translations
|
||||||
|
- *Responsive Design*: Adapted for all devices
|
||||||
|
- *SEO-friendly*: URLs are indexable
|
||||||
|
|
||||||
|
## Installation (local)
|
||||||
|
|
||||||
|
1. Install Python 3.8+
|
||||||
|
2. Install dependencies:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
|
## Starting the App
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python app.py
|
||||||
|
```
|
||||||
|
|
||||||
|
The app is then accessible at http://localhost:5000.
|
||||||
|
|
||||||
|
## Statistics Dashboard (/stats) & Password Protection
|
||||||
|
|
||||||
|
The dashboard is protected with a static password that is set via the environment variable `STATS_PASSWORD`.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Example (PowerShell):
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$env:STATS_PASSWORD = "mySecurePassword"
|
||||||
|
python app.py
|
||||||
|
```
|
||||||
|
|
||||||
|
For Docker:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
$env:STATS_PASSWORD = "mySecurePassword"
|
||||||
|
docker run -e STATS_PASSWORD=$env:STATS_PASSWORD -p 5000:5000 datumsrechner
|
||||||
|
```
|
||||||
|
|
||||||
|
## Docker (recommended for production)
|
||||||
|
|
||||||
|
The app runs in a container with the **Gunicorn** WSGI server:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker build -t datumsrechner .
|
||||||
|
docker run -p 5000:5000 datumsrechner
|
||||||
|
```
|
||||||
|
|
||||||
|
- Gunicorn starts automatically (see Dockerfile)
|
||||||
|
- Recommended for production use
|
||||||
|
|
||||||
|
### Mounting log directory (Logs stored on host)
|
||||||
|
|
||||||
|
To store log files outside the container, you can mount the log directory:
|
||||||
|
|
||||||
|
**PowerShell Example:**
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
docker run -e STATS_PASSWORD=yourPassword -p 5000:5000 -v ${PWD}/log:/app/log datumsrechner
|
||||||
|
```
|
||||||
|
|
||||||
|
### docker-compose example
|
||||||
|
|
||||||
|
Create a `docker-compose.yml` file:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
services:
|
||||||
|
datumsrechner:
|
||||||
|
build: .
|
||||||
|
ports:
|
||||||
|
- "5000:5000"
|
||||||
|
environment:
|
||||||
|
- STATS_PASSWORD=yourPassword
|
||||||
|
volumes:
|
||||||
|
- ./log:/app/log
|
||||||
|
```
|
||||||
|
|
||||||
|
Start with:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker-compose up --build
|
||||||
|
```
|
||||||
|
|
||||||
|
## REST API
|
||||||
|
|
||||||
|
All date functions are also available as a REST API. The API accepts and returns JSON.
|
||||||
|
|
||||||
|
**Base URL:** `http://localhost:5000/api/`
|
||||||
|
|
||||||
|
**Swagger Documentation:** [https://date.elpatron.me/api-docs](https://date.elpatron.me/api-docs)
|
||||||
|
|
||||||
|
**Note:** The use of the REST API is evaluated in the statistics dashboard and displayed as a chart.
|
||||||
|
|
||||||
|
### Endpoints and Examples
|
||||||
|
|
||||||
|
#### 1. Days/Working days between two dates
|
||||||
|
|
||||||
|
**POST** `/api/tage_werktage`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"start": "2024-06-01",
|
||||||
|
"end": "2024-06-10",
|
||||||
|
"werktage": true,
|
||||||
|
"bundesland": "BY"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**With curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:5000/api/tage_werktage \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"start": "2024-06-01", "end": "2024-06-10", "werktage": true, "bundesland": "BY"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "result": 7 }
|
||||||
|
```
|
||||||
|
|
||||||
|
**Note:** The `bundesland` parameter is optional and is only considered when `"werktage": true`. Available state abbreviations see above.
|
||||||
|
|
||||||
|
#### 2. Weekday for a date
|
||||||
|
|
||||||
|
**POST** `/api/wochentag`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "datum": "2024-06-10" }
|
||||||
|
```
|
||||||
|
|
||||||
|
**With curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:5000/api/wochentag \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"datum": "2024-06-10"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "result": "Monday" }
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3. Calendar week for date
|
||||||
|
|
||||||
|
**POST** `/api/kw_berechnen`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "datum": "2024-06-10" }
|
||||||
|
```
|
||||||
|
|
||||||
|
**With curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:5000/api/kw_berechnen \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"datum": "2024-06-10"}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "result": "CW 24 (2024)", "kw": 24, "jahr": 2024 }
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 4. Start/End date of a calendar week
|
||||||
|
|
||||||
|
**POST** `/api/kw_datum`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "jahr": 2024, "kw": 24 }
|
||||||
|
```
|
||||||
|
|
||||||
|
**With curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:5000/api/kw_datum \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"jahr": 2024, "kw": 24}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"result": "10.06.2024 to 16.06.2024",
|
||||||
|
"start": "2024-06-10",
|
||||||
|
"end": "2024-06-16"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5. Date plus/minus days, weeks, months
|
||||||
|
|
||||||
|
**POST** `/api/plusminus`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"datum": "2024-06-10",
|
||||||
|
"anzahl": 5,
|
||||||
|
"einheit": "tage",
|
||||||
|
"richtung": "add",
|
||||||
|
"werktage": false
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**With curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:5000/api/plusminus \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"datum": "2024-06-10", "anzahl": 5, "einheit": "tage", "richtung": "add", "werktage": false}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "result": "2024-06-15" }
|
||||||
|
```
|
||||||
|
|
||||||
|
**Note:**
|
||||||
|
|
||||||
|
- `"einheit"`: `"tage"`, `"wochen"` or `"monate"`
|
||||||
|
- `"richtung"`: `"add"` (plus) or `"sub"` (minus)
|
||||||
|
- `"werktage"`: `true` for working days, otherwise `false` (only supported for `"tage"`)
|
||||||
|
|
||||||
|
#### 6. Statistics
|
||||||
|
|
||||||
|
**GET** `/api/stats`
|
||||||
|
|
||||||
|
**With curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl http://localhost:5000/api/stats
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"pageviews": 42,
|
||||||
|
"func_counts": { "plusminus": 10, "tage_werktage": 5 },
|
||||||
|
"impressions_per_day": { "2024-06-10": 7 }
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 7. Monitoring & Healthcheck
|
||||||
|
|
||||||
|
**GET** `/api/monitor`
|
||||||
|
|
||||||
|
**With curl:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl http://localhost:5000/api/monitor
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"status": "ok",
|
||||||
|
"message": "App running",
|
||||||
|
"time": "2025-07-24T13:37:00.123456",
|
||||||
|
"uptime_seconds": 12345,
|
||||||
|
"pageviews_last_7_days": 42
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Error cases** always return an HTTP status code 400 and JSON with an `"error"` field, e.g.:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{ "error": "Invalid input", "details": "..." }
|
||||||
|
```
|
||||||
|
|
||||||
|
## Progressive Web App (PWA)
|
||||||
|
|
||||||
|
Elpatron's Date Calculator is installable as a PWA (e.g., on Android/iOS home screen or desktop). The app works offline for the homepage and static resources, date calculation remains server-side.
|
||||||
|
|
||||||
|
- Manifest and Service Worker are integrated
|
||||||
|
- App icon and theme color for home screen
|
||||||
|
- Installation via browser menu ("Add to home screen")
|
||||||
|
- Calculator works completely client-side (available offline)
|
||||||
|
|
||||||
|
## Monitoring & Healthcheck
|
||||||
|
|
||||||
|
The app provides a monitoring endpoint at `/monitor` that returns status information as JSON (e.g., for Uptime Robot, Docker Healthcheck or own tools):
|
||||||
|
|
||||||
|
- Status (ok)
|
||||||
|
- Current server time
|
||||||
|
- Uptime (seconds since start)
|
||||||
|
- Pageviews of the last 7 days
|
||||||
|
|
||||||
|
Example call:
|
||||||
|
|
||||||
|
`GET https://date.elpatron.me/monitor`
|
||||||
|
|
||||||
|
Response:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"status": "ok",
|
||||||
|
"message": "App running",
|
||||||
|
"time": "2025-07-24T13:37:00.123456",
|
||||||
|
"uptime_seconds": 12345,
|
||||||
|
"pageviews_last_7_days": 42
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Development & Notes
|
||||||
|
|
||||||
|
- HTML templates are in the `templates/` folder (separation of logic and presentation)
|
||||||
|
- The project is hosted on Codeberg: [https://codeberg.org/elpatron/datecalc](https://codeberg.org/elpatron/datecalc)
|
||||||
|
- Modern, responsive design with accordion and icons
|
||||||
|
|
||||||
|
## Automated Tests
|
||||||
|
|
||||||
|
Automated tests are possible with pytest:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
pip install -r requirements.txt
|
||||||
|
pytest test_app.py
|
||||||
|
```
|
||||||
|
|
||||||
|
The tests check, among other things, the accessibility of the app, the most important functions, and protection against XSS attacks.
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
|
||||||
|
### Motivation
|
||||||
|
|
||||||
|
Try to find a date calculator web app that isn't completely riddled with ads and tracking! Since I need something like this more often, I made my own.
|
||||||
|
|
||||||
|
### Vibe Coding
|
||||||
|
|
||||||
|
This project was created almost 100% with the support of artificial intelligence (*[Vibe Coding](https://en.wikipedia.org/wiki/Vibe_Coding)*). The basic framework was completed after about 45 minutes, and the total development of the project took about 12 hours.
|
||||||
|
|
||||||
|
### Statistics collection, Logging
|
||||||
|
|
||||||
|
No IP addresses or other personal data are stored, only the number of function calls in a cumulative representation. The log file only contains entries from the last seven days.
|
||||||
|
|
||||||
|
### Accessibility
|
||||||
|
|
||||||
|
*Elpatron's Date Calculator* is designed to be accessible and meets central accessibility (a11y) requirements:
|
||||||
|
|
||||||
|
- *Semantic HTML Structure:* Headings, labels, and form elements are correctly marked and linked.
|
||||||
|
- *ARIA Attributes:* Accordion and status messages are equipped with ARIA attributes so that screen readers can recognize the structure and states.
|
||||||
|
- *Keyboard Operability:* All interactive elements (accordion, buttons, forms) are fully operable by keyboard (including focus indicator and arrow key navigation in accordion).
|
||||||
|
- *Focus Indicators:* Clear visual highlighting of focus for all control elements.
|
||||||
|
- *Color Contrasts:* High contrasts for texts, buttons, and result boxes, tested according to WCAG guidelines.
|
||||||
|
- *Status and Error Messages:* Results and errors are made accessible to screen readers with `aria-live`.
|
||||||
|
- *Speech Output:* All results can be read aloud via 🔊 buttons (Web Speech API, German language).
|
||||||
|
- *Calculator:* Fully accessible with keyboard operation, speech output, and history function.
|
||||||
|
- *Mobile Optimization:* Additional meta tags for better usability on mobile devices and support for screen readers.
|
||||||
|
- *SEO:* The accessibility topic is visible in meta tags for search engines.
|
||||||
|
|
||||||
|
This makes the app well usable for people with different disabilities (e.g., visual impairment, motor limitations) and meets modern web standards.
|
||||||
|
|
||||||
|
### Code Statistics
|
||||||
|
|
||||||
|
cloc|github.com/AlDanial/cloc v 2.06 T=0.22 s (124.7 files/s, 34058.5 lines/s)
|
||||||
|
--- | ---
|
||||||
|
|
||||||
|
Language|files|blank|comment|code
|
||||||
|
:-------|-------:|-------:|-------:|-------:
|
||||||
|
HTML|8|159|8|2806
|
||||||
|
Markdown|5|340|0|876
|
||||||
|
Python|2|68|76|744
|
||||||
|
JavaScript|2|95|88|580
|
||||||
|
PO File|2|260|266|544
|
||||||
|
JSON|3|0|0|243
|
||||||
|
CSS|1|186|3|188
|
||||||
|
XML|1|10|4|69
|
||||||
|
SVG|2|0|0|14
|
||||||
|
Dockerfile|1|5|6|8
|
||||||
|
DOS Batch|1|0|0|1
|
||||||
|
--------|--------|--------|--------|--------
|
||||||
|
SUM:|28|1123|451|6073
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This project is licensed under the [MIT License](LICENSE).
|
||||||
|
|
||||||
|
---
|
||||||
|
(c) 2025 [Markus Busche](https://digitalcourage.social/@elpatron)
|
||||||
|
|
||||||
|
**Version 1.4.12** - Integrated calculator with history and speech output added
|
||||||
142
app.py
142
app.py
@@ -1,5 +1,5 @@
|
|||||||
from flask import Flask, render_template, request, redirect, url_for, session, abort, jsonify, g
|
from flask import Flask, render_template, request, redirect, url_for, session, jsonify, make_response
|
||||||
from flask_babel import Babel, gettext, ngettext, get_locale
|
from flask_babel import Babel, gettext, get_locale
|
||||||
from datetime import datetime, timedelta
|
from datetime import datetime, timedelta
|
||||||
import numpy as np
|
import numpy as np
|
||||||
from dateutil.relativedelta import relativedelta
|
from dateutil.relativedelta import relativedelta
|
||||||
@@ -20,7 +20,23 @@ app.config['BABEL_TRANSLATION_DIRECTORIES'] = 'translations'
|
|||||||
babel = Babel()
|
babel = Babel()
|
||||||
|
|
||||||
# Version der App
|
# Version der App
|
||||||
APP_VERSION = "1.4.3"
|
APP_VERSION = "1.4.18"
|
||||||
|
|
||||||
|
def add_cache_headers(response):
|
||||||
|
"""Fügt Cache-Control-Header hinzu, die den Back-Forward-Cache ermöglichen"""
|
||||||
|
# Cache-Control für statische Inhalte und API-Endpunkte
|
||||||
|
if request.path.startswith('/static/') or request.path.startswith('/api/'):
|
||||||
|
response.headers['Cache-Control'] = 'public, max-age=3600, s-maxage=3600'
|
||||||
|
else:
|
||||||
|
# Für HTML-Seiten: kurze Cache-Zeit, aber Back-Forward-Cache erlauben
|
||||||
|
response.headers['Cache-Control'] = 'public, max-age=60, s-maxage=300'
|
||||||
|
|
||||||
|
# Wichtig: Keine Vary-Header für User-Agent oder andere dynamische Werte
|
||||||
|
# Dies verhindert den Back-Forward-Cache
|
||||||
|
if 'Vary' in response.headers:
|
||||||
|
del response.headers['Vary']
|
||||||
|
|
||||||
|
return response
|
||||||
|
|
||||||
# HTML-Template wird jetzt aus templates/index.html geladen
|
# HTML-Template wird jetzt aus templates/index.html geladen
|
||||||
|
|
||||||
@@ -102,7 +118,7 @@ def index():
|
|||||||
with open(log_path, 'a', encoding='utf-8') as f:
|
with open(log_path, 'a', encoding='utf-8') as f:
|
||||||
from datetime import datetime as dt
|
from datetime import datetime as dt
|
||||||
f.write(f"{dt.now().isoformat()} PAGEVIEW\n")
|
f.write(f"{dt.now().isoformat()} PAGEVIEW\n")
|
||||||
tage = werktage = wochentag = datumsrechnung = werktagsrechnung = kw_berechnen = kw_datum = wochen_monate = None
|
tage = wochentag = kw_berechnen = kw_datum = None
|
||||||
feiertage_anzahl = wochenendtage_anzahl = None
|
feiertage_anzahl = wochenendtage_anzahl = None
|
||||||
active_idx = 0
|
active_idx = 0
|
||||||
plusminus_result = None
|
plusminus_result = None
|
||||||
@@ -229,34 +245,72 @@ def index():
|
|||||||
plusminus_result = f"Datum {d.strftime('%d.%m.%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} Monate: {result.strftime('%d.%m.%Y')}"
|
plusminus_result = f"Datum {d.strftime('%d.%m.%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} Monate: {result.strftime('%d.%m.%Y')}"
|
||||||
except Exception:
|
except Exception:
|
||||||
plusminus_result = gettext('Ungültige Eingabe')
|
plusminus_result = gettext('Ungültige Eingabe')
|
||||||
return render_template('index.html', tage=tage, werktage=werktage, wochentag=wochentag, plusminus_result=plusminus_result, kw_berechnen=kw_berechnen, kw_datum=kw_datum, active_idx=active_idx
|
response = make_response(render_template('index.html', tage=tage, wochentag=wochentag, plusminus_result=plusminus_result, kw_berechnen=kw_berechnen, kw_datum=kw_datum, active_idx=active_idx
|
||||||
, feiertage_anzahl=feiertage_anzahl, wochenendtage_anzahl=wochenendtage_anzahl, app_version=APP_VERSION, get_locale=get_locale
|
, feiertage_anzahl=feiertage_anzahl, wochenendtage_anzahl=wochenendtage_anzahl, app_version=APP_VERSION, get_locale=get_locale
|
||||||
)
|
))
|
||||||
|
return add_cache_headers(response)
|
||||||
|
|
||||||
|
|
||||||
def parse_log_stats(log_path):
|
def parse_log_stats(log_path):
|
||||||
pageviews = 0
|
pageviews = 0
|
||||||
func_counts = {}
|
func_counts = {}
|
||||||
|
func_counts_hourly = {}
|
||||||
impressions_per_day = {}
|
impressions_per_day = {}
|
||||||
|
impressions_per_hour = {}
|
||||||
api_counts = {}
|
api_counts = {}
|
||||||
|
api_counts_hourly = {}
|
||||||
if os.path.exists(log_path):
|
if os.path.exists(log_path):
|
||||||
with open(log_path, encoding='utf-8') as f:
|
with open(log_path, encoding='utf-8') as f:
|
||||||
for line in f:
|
for line in f:
|
||||||
if 'PAGEVIEW' in line:
|
if 'PAGEVIEW' in line:
|
||||||
pageviews += 1
|
pageviews += 1
|
||||||
try:
|
try:
|
||||||
date = line[:10]
|
# Parse timestamp (format: YYYY-MM-DDTHH:MM:SS)
|
||||||
|
timestamp = line[:19] # First 19 chars for YYYY-MM-DDTHH:MM:SS
|
||||||
|
date = timestamp[:10] # YYYY-MM-DD
|
||||||
|
hour = timestamp[11:13] # HH
|
||||||
|
|
||||||
if len(date) == 10 and date[4] == '-' and date[7] == '-':
|
if len(date) == 10 and date[4] == '-' and date[7] == '-':
|
||||||
impressions_per_day[date] = impressions_per_day.get(date, 0) + 1
|
impressions_per_day[date] = impressions_per_day.get(date, 0) + 1
|
||||||
|
|
||||||
|
if len(hour) == 2 and hour.isdigit():
|
||||||
|
hour_key = f"{date} {hour}:00"
|
||||||
|
impressions_per_hour[hour_key] = impressions_per_hour.get(hour_key, 0) + 1
|
||||||
except Exception:
|
except Exception:
|
||||||
pass
|
pass
|
||||||
elif 'FUNC:' in line:
|
elif 'FUNC:' in line:
|
||||||
func = line.split('FUNC:')[1].strip()
|
func = line.split('FUNC:')[1].strip()
|
||||||
func_counts[func] = func_counts.get(func, 0) + 1
|
func_counts[func] = func_counts.get(func, 0) + 1
|
||||||
|
|
||||||
|
# Stündliche Funktionsaufrufe
|
||||||
|
try:
|
||||||
|
timestamp = line[:19]
|
||||||
|
date = timestamp[:10]
|
||||||
|
hour = timestamp[11:13]
|
||||||
|
if len(hour) == 2 and hour.isdigit():
|
||||||
|
hour_key = f"{date} {hour}:00"
|
||||||
|
if hour_key not in func_counts_hourly:
|
||||||
|
func_counts_hourly[hour_key] = {}
|
||||||
|
func_counts_hourly[hour_key][func] = func_counts_hourly[hour_key].get(func, 0) + 1
|
||||||
|
except Exception:
|
||||||
|
pass
|
||||||
elif 'FUNC_API:' in line:
|
elif 'FUNC_API:' in line:
|
||||||
api = line.split('FUNC_API:')[1].strip()
|
api = line.split('FUNC_API:')[1].strip()
|
||||||
api_counts[api] = api_counts.get(api, 0) + 1
|
api_counts[api] = api_counts.get(api, 0) + 1
|
||||||
return pageviews, func_counts, impressions_per_day, api_counts
|
|
||||||
|
# Stündliche API-Aufrufe
|
||||||
|
try:
|
||||||
|
timestamp = line[:19]
|
||||||
|
date = timestamp[:10]
|
||||||
|
hour = timestamp[11:13]
|
||||||
|
if len(hour) == 2 and hour.isdigit():
|
||||||
|
hour_key = f"{date} {hour}:00"
|
||||||
|
if hour_key not in api_counts_hourly:
|
||||||
|
api_counts_hourly[hour_key] = {}
|
||||||
|
api_counts_hourly[hour_key][api] = api_counts_hourly[hour_key].get(api, 0) + 1
|
||||||
|
except Exception:
|
||||||
|
pass
|
||||||
|
return pageviews, func_counts, func_counts_hourly, impressions_per_day, impressions_per_hour, api_counts, api_counts_hourly
|
||||||
|
|
||||||
@app.route('/stats', methods=['GET', 'POST'])
|
@app.route('/stats', methods=['GET', 'POST'])
|
||||||
def stats():
|
def stats():
|
||||||
@@ -267,11 +321,17 @@ def stats():
|
|||||||
session['stats_auth'] = True
|
session['stats_auth'] = True
|
||||||
return redirect(url_for('stats'))
|
return redirect(url_for('stats'))
|
||||||
else:
|
else:
|
||||||
return render_template('stats_login.html', error='Falsches Passwort!')
|
response = make_response(render_template('stats_login.html', error='Falsches Passwort!'))
|
||||||
return render_template('stats_login.html', error=None)
|
return add_cache_headers(response)
|
||||||
|
else:
|
||||||
|
response = make_response(render_template('stats_login.html', error=None))
|
||||||
|
return add_cache_headers(response)
|
||||||
|
|
||||||
|
# Wenn authentifiziert, zeige Dashboard
|
||||||
log_path = os.path.join('log', 'pageviews.log')
|
log_path = os.path.join('log', 'pageviews.log')
|
||||||
pageviews, func_counts, impressions_per_day, api_counts = parse_log_stats(log_path)
|
pageviews, func_counts, func_counts_hourly, impressions_per_day, impressions_per_hour, api_counts, api_counts_hourly = parse_log_stats(log_path)
|
||||||
return render_template('stats_dashboard.html', pageviews=pageviews, func_counts=func_counts, impressions_per_day=impressions_per_day, api_counts=api_counts)
|
response = make_response(render_template('stats_dashboard.html', pageviews=pageviews, func_counts=func_counts, func_counts_hourly=func_counts_hourly, impressions_per_day=impressions_per_day, impressions_per_hour=impressions_per_hour, api_counts=api_counts, api_counts_hourly=api_counts_hourly))
|
||||||
|
return add_cache_headers(response)
|
||||||
|
|
||||||
# --- REST API ---
|
# --- REST API ---
|
||||||
def log_api_usage(api_name):
|
def log_api_usage(api_name):
|
||||||
@@ -305,7 +365,8 @@ def api_tage_werktage():
|
|||||||
tage = int(np.busday_count(d1.date(), (d2 + timedelta(days=1)).date(), holidays=holidays))
|
tage = int(np.busday_count(d1.date(), (d2 + timedelta(days=1)).date(), holidays=holidays))
|
||||||
else:
|
else:
|
||||||
tage = abs((d2 - d1).days)
|
tage = abs((d2 - d1).days)
|
||||||
return jsonify({'result': tage})
|
response = jsonify({'result': tage})
|
||||||
|
return add_cache_headers(response)
|
||||||
except Exception as e:
|
except Exception as e:
|
||||||
return jsonify({'error': 'Ungültige Eingabe', 'details': str(e)}), 400
|
return jsonify({'error': 'Ungültige Eingabe', 'details': str(e)}), 400
|
||||||
|
|
||||||
@@ -318,7 +379,8 @@ def api_wochentag():
|
|||||||
d = datetime.strptime(datum, '%Y-%m-%d')
|
d = datetime.strptime(datum, '%Y-%m-%d')
|
||||||
wochentage = get_wochentage()
|
wochentage = get_wochentage()
|
||||||
wochentag = wochentage[d.weekday()]
|
wochentag = wochentage[d.weekday()]
|
||||||
return jsonify({'result': wochentag})
|
response = jsonify({'result': wochentag})
|
||||||
|
return add_cache_headers(response)
|
||||||
except Exception as e:
|
except Exception as e:
|
||||||
return jsonify({'error': 'Ungültige Eingabe', 'details': str(e)}), 400
|
return jsonify({'error': 'Ungültige Eingabe', 'details': str(e)}), 400
|
||||||
|
|
||||||
@@ -335,7 +397,8 @@ def api_kw_berechnen():
|
|||||||
kw_berechnen = f"Week {kw} ({d.year})"
|
kw_berechnen = f"Week {kw} ({d.year})"
|
||||||
else:
|
else:
|
||||||
kw_berechnen = f"KW {kw} ({d.year})"
|
kw_berechnen = f"KW {kw} ({d.year})"
|
||||||
return jsonify({'result': kw_berechnen, 'kw': kw, 'jahr': d.year})
|
response = jsonify({'result': kw_berechnen, 'kw': kw, 'jahr': d.year})
|
||||||
|
return add_cache_headers(response)
|
||||||
except Exception as e:
|
except Exception as e:
|
||||||
return jsonify({'error': 'Ungültige Eingabe', 'details': str(e)}), 400
|
return jsonify({'error': 'Ungültige Eingabe', 'details': str(e)}), 400
|
||||||
|
|
||||||
@@ -355,7 +418,8 @@ def api_kw_datum():
|
|||||||
kw_datum = f"{start.strftime('%m/%d/%Y')} to {end.strftime('%m/%d/%Y')}"
|
kw_datum = f"{start.strftime('%m/%d/%Y')} to {end.strftime('%m/%d/%Y')}"
|
||||||
else:
|
else:
|
||||||
kw_datum = f"{start.strftime('%d.%m.%Y')} bis {end.strftime('%d.%m.%Y')}"
|
kw_datum = f"{start.strftime('%d.%m.%Y')} bis {end.strftime('%d.%m.%Y')}"
|
||||||
return jsonify({'result': kw_datum, 'start': start.strftime('%Y-%m-%d'), 'end': end.strftime('%Y-%m-%d')})
|
response = jsonify({'result': kw_datum, 'start': start.strftime('%Y-%m-%d'), 'end': end.strftime('%Y-%m-%d')})
|
||||||
|
return add_cache_headers(response)
|
||||||
except Exception as e:
|
except Exception as e:
|
||||||
return jsonify({'error': 'Ungültige Eingabe', 'details': str(e)}), 400
|
return jsonify({'error': 'Ungültige Eingabe', 'details': str(e)}), 400
|
||||||
|
|
||||||
@@ -378,34 +442,26 @@ def api_plusminus():
|
|||||||
if is_werktage:
|
if is_werktage:
|
||||||
result = np.busday_offset(d.date(), anzahl_int, roll='forward')
|
result = np.busday_offset(d.date(), anzahl_int, roll='forward')
|
||||||
result_dt = datetime.strptime(str(result), '%Y-%m-%d')
|
result_dt = datetime.strptime(str(result), '%Y-%m-%d')
|
||||||
if locale == 'en':
|
response = jsonify({'result': result_dt.strftime('%Y-%m-%d')})
|
||||||
plusminus_result = f"Date {d.strftime('%m/%d/%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} workdays: {result_dt.strftime('%m/%d/%Y')}"
|
return add_cache_headers(response)
|
||||||
else:
|
|
||||||
plusminus_result = f"Datum {d.strftime('%d.%m.%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} Werktage: {result_dt.strftime('%d.%m.%Y')}"
|
|
||||||
else:
|
else:
|
||||||
result = d + timedelta(days=anzahl_int)
|
result = d + timedelta(days=anzahl_int)
|
||||||
if locale == 'en':
|
response = jsonify({'result': result.strftime('%Y-%m-%d')})
|
||||||
plusminus_result = f"Date {d.strftime('%m/%d/%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} days: {result.strftime('%m/%d/%Y')}"
|
return add_cache_headers(response)
|
||||||
else:
|
|
||||||
plusminus_result = f"Datum {d.strftime('%d.%m.%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} Tage: {result.strftime('%d.%m.%Y')}"
|
|
||||||
elif einheit == 'wochen':
|
elif einheit == 'wochen':
|
||||||
if is_werktage:
|
if is_werktage:
|
||||||
return jsonify({'error': 'Nicht unterstützt: Werktage + Wochen.'}), 400
|
return jsonify({'error': 'Nicht unterstützt: Werktage + Wochen.'}), 400
|
||||||
else:
|
else:
|
||||||
result = d + timedelta(weeks=anzahl_int)
|
result = d + timedelta(weeks=anzahl_int)
|
||||||
if locale == 'en':
|
response = jsonify({'result': result.strftime('%Y-%m-%d')})
|
||||||
plusminus_result = f"Date {d.strftime('%m/%d/%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} weeks: {result.strftime('%m/%d/%Y')}"
|
return add_cache_headers(response)
|
||||||
else:
|
|
||||||
plusminus_result = f"Datum {d.strftime('%d.%m.%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} Wochen: {result.strftime('%d.%m.%Y')}"
|
|
||||||
elif einheit == 'monate':
|
elif einheit == 'monate':
|
||||||
if is_werktage:
|
if is_werktage:
|
||||||
return jsonify({'error': 'Nicht unterstützt: Werktage + Monate.'}), 400
|
return jsonify({'error': 'Nicht unterstützt: Werktage + Monate.'}), 400
|
||||||
else:
|
else:
|
||||||
result = d + relativedelta(months=anzahl_int)
|
result = d + relativedelta(months=anzahl_int)
|
||||||
if locale == 'en':
|
response = jsonify({'result': result.strftime('%Y-%m-%d')})
|
||||||
plusminus_result = f"Date {d.strftime('%m/%d/%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} months: {result.strftime('%m/%d/%Y')}"
|
return add_cache_headers(response)
|
||||||
else:
|
|
||||||
plusminus_result = f"Datum {d.strftime('%d.%m.%Y')} {'plus' if anzahl_int>=0 else 'minus'} {abs(anzahl_int)} Monate: {result.strftime('%d.%m.%Y')}"
|
|
||||||
else:
|
else:
|
||||||
return jsonify({'error': 'Ungültige Einheit'}), 400
|
return jsonify({'error': 'Ungültige Einheit'}), 400
|
||||||
except Exception as e:
|
except Exception as e:
|
||||||
@@ -414,8 +470,14 @@ def api_plusminus():
|
|||||||
@app.route('/api/stats', methods=['GET'])
|
@app.route('/api/stats', methods=['GET'])
|
||||||
def api_stats():
|
def api_stats():
|
||||||
log_path = os.path.join('log', 'pageviews.log')
|
log_path = os.path.join('log', 'pageviews.log')
|
||||||
pageviews, func_counts, impressions_per_day, api_counts = parse_log_stats(log_path)
|
pageviews, func_counts, func_counts_hourly, impressions_per_day, impressions_per_hour, api_counts, api_counts_hourly = parse_log_stats(log_path)
|
||||||
return render_template('stats_dashboard.html', pageviews=pageviews, func_counts=func_counts, impressions_per_day=impressions_per_day, api_counts=api_counts)
|
response = jsonify({
|
||||||
|
"pageviews": pageviews,
|
||||||
|
"func_counts": func_counts,
|
||||||
|
"impressions_per_day": impressions_per_day,
|
||||||
|
"api_counts": api_counts
|
||||||
|
})
|
||||||
|
return add_cache_headers(response)
|
||||||
|
|
||||||
@app.route('/api/monitor', methods=['GET'])
|
@app.route('/api/monitor', methods=['GET'])
|
||||||
def api_monitor():
|
def api_monitor():
|
||||||
@@ -427,17 +489,25 @@ def api_monitor():
|
|||||||
if 'PAGEVIEW' in line:
|
if 'PAGEVIEW' in line:
|
||||||
pageviews += 1
|
pageviews += 1
|
||||||
uptime = int(time.time() - app_start_time)
|
uptime = int(time.time() - app_start_time)
|
||||||
return jsonify({
|
response = jsonify({
|
||||||
"status": "ok",
|
"status": "ok",
|
||||||
"message": "App running",
|
"message": "App running",
|
||||||
"time": datetime.now().isoformat(),
|
"time": datetime.now().isoformat(),
|
||||||
"uptime_seconds": uptime,
|
"uptime_seconds": uptime,
|
||||||
"pageviews_last_7_days": pageviews
|
"pageviews_last_7_days": pageviews
|
||||||
})
|
})
|
||||||
|
return add_cache_headers(response)
|
||||||
|
|
||||||
@app.route('/api-docs')
|
@app.route('/api-docs')
|
||||||
def api_docs():
|
def api_docs():
|
||||||
return render_template('swagger.html')
|
response = make_response(render_template('swagger.html'))
|
||||||
|
return add_cache_headers(response)
|
||||||
|
|
||||||
|
@app.route('/sitemap.xml')
|
||||||
|
def sitemap():
|
||||||
|
"""Serviert die Sitemap für Suchmaschinen"""
|
||||||
|
from flask import send_file
|
||||||
|
return send_file('sitemap.xml', mimetype='application/xml')
|
||||||
|
|
||||||
|
|
||||||
if __name__ == '__main__':
|
if __name__ == '__main__':
|
||||||
|
|||||||
Binary file not shown.
|
Before Width: | Height: | Size: 13 KiB After Width: | Height: | Size: 57 KiB |
426
bruno/Datecalc.json
Normal file
426
bruno/Datecalc.json
Normal file
@@ -0,0 +1,426 @@
|
|||||||
|
{
|
||||||
|
"name": "Datecalc",
|
||||||
|
"version": "1",
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"type": "folder",
|
||||||
|
"name": "localhost",
|
||||||
|
"filename": "localhost",
|
||||||
|
"seq": 2,
|
||||||
|
"root": {
|
||||||
|
"request": {
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"meta": {
|
||||||
|
"name": "localhost",
|
||||||
|
"seq": 2
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"type": "http",
|
||||||
|
"name": "wochentag",
|
||||||
|
"filename": "wochentag.bru",
|
||||||
|
"seq": 5,
|
||||||
|
"settings": {
|
||||||
|
"encodeUrl": false
|
||||||
|
},
|
||||||
|
"tags": [],
|
||||||
|
"request": {
|
||||||
|
"url": "http://localhost:5000/api/wochentag",
|
||||||
|
"method": "POST",
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"name": "Content-Type",
|
||||||
|
"value": "application/json",
|
||||||
|
"enabled": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"params": [],
|
||||||
|
"body": {
|
||||||
|
"mode": "json",
|
||||||
|
"json": "{\n \"datum\": \"2024-06-10\"\n}",
|
||||||
|
"formUrlEncoded": [],
|
||||||
|
"multipartForm": [],
|
||||||
|
"file": []
|
||||||
|
},
|
||||||
|
"script": {},
|
||||||
|
"vars": {},
|
||||||
|
"assertions": [],
|
||||||
|
"tests": "",
|
||||||
|
"docs": "",
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "http",
|
||||||
|
"name": "kw_berechnen",
|
||||||
|
"filename": "kw_berechnen.bru",
|
||||||
|
"seq": 1,
|
||||||
|
"settings": {
|
||||||
|
"encodeUrl": false
|
||||||
|
},
|
||||||
|
"tags": [],
|
||||||
|
"request": {
|
||||||
|
"url": "http://localhost:5000/api/kw_berechnen",
|
||||||
|
"method": "POST",
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"name": "Content-Type",
|
||||||
|
"value": "application/json",
|
||||||
|
"enabled": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"params": [],
|
||||||
|
"body": {
|
||||||
|
"mode": "json",
|
||||||
|
"json": "{\n \"datum\": \"2024-06-10\"\n}",
|
||||||
|
"formUrlEncoded": [],
|
||||||
|
"multipartForm": [],
|
||||||
|
"file": []
|
||||||
|
},
|
||||||
|
"script": {},
|
||||||
|
"vars": {},
|
||||||
|
"assertions": [],
|
||||||
|
"tests": "",
|
||||||
|
"docs": "",
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "http",
|
||||||
|
"name": "kw_datum",
|
||||||
|
"filename": "kw_datum.bru",
|
||||||
|
"seq": 3,
|
||||||
|
"settings": {
|
||||||
|
"encodeUrl": false
|
||||||
|
},
|
||||||
|
"tags": [],
|
||||||
|
"request": {
|
||||||
|
"url": "http://localhost:5000/api/kw_datum",
|
||||||
|
"method": "POST",
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"name": "Content-Type",
|
||||||
|
"value": "application/json",
|
||||||
|
"enabled": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"params": [],
|
||||||
|
"body": {
|
||||||
|
"mode": "json",
|
||||||
|
"json": "{\n \"jahr\": 2024,\n \"kw\": 24\n}",
|
||||||
|
"formUrlEncoded": [],
|
||||||
|
"multipartForm": [],
|
||||||
|
"file": []
|
||||||
|
},
|
||||||
|
"script": {},
|
||||||
|
"vars": {},
|
||||||
|
"assertions": [],
|
||||||
|
"tests": "",
|
||||||
|
"docs": "",
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "http",
|
||||||
|
"name": "plusminus",
|
||||||
|
"filename": "plusminus.bru",
|
||||||
|
"seq": 4,
|
||||||
|
"settings": {
|
||||||
|
"encodeUrl": false
|
||||||
|
},
|
||||||
|
"tags": [],
|
||||||
|
"request": {
|
||||||
|
"url": "http://localhost:5000/api/plusminus",
|
||||||
|
"method": "POST",
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"name": "Content-Type",
|
||||||
|
"value": "application/json",
|
||||||
|
"enabled": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"params": [],
|
||||||
|
"body": {
|
||||||
|
"mode": "json",
|
||||||
|
"json": "{\n \"datum\": \"2024-06-10\",\n \"anzahl\": 5,\n \"einheit\": \"tage\",\n \"richtung\": \"add\",\n \"werktage\": false\n}",
|
||||||
|
"formUrlEncoded": [],
|
||||||
|
"multipartForm": [],
|
||||||
|
"file": []
|
||||||
|
},
|
||||||
|
"script": {},
|
||||||
|
"vars": {},
|
||||||
|
"assertions": [],
|
||||||
|
"tests": "",
|
||||||
|
"docs": "",
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "http",
|
||||||
|
"name": "tage_werktage",
|
||||||
|
"filename": "tage_werktage.bru",
|
||||||
|
"seq": 2,
|
||||||
|
"settings": {
|
||||||
|
"encodeUrl": false
|
||||||
|
},
|
||||||
|
"tags": [],
|
||||||
|
"request": {
|
||||||
|
"url": "http://localhost:5000/api/tage_werktage",
|
||||||
|
"method": "POST",
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"name": "Content-Type",
|
||||||
|
"value": "application/json",
|
||||||
|
"enabled": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"params": [],
|
||||||
|
"body": {
|
||||||
|
"mode": "json",
|
||||||
|
"json": "{\n \"start\": \"2024-06-01\",\n \"end\": \"2024-06-10\",\n \"werktage\": true,\n \"bundesland\": \"BY\"\n}",
|
||||||
|
"formUrlEncoded": [],
|
||||||
|
"multipartForm": [],
|
||||||
|
"file": []
|
||||||
|
},
|
||||||
|
"script": {},
|
||||||
|
"vars": {},
|
||||||
|
"assertions": [],
|
||||||
|
"tests": "",
|
||||||
|
"docs": "",
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "folder",
|
||||||
|
"name": "public",
|
||||||
|
"filename": "public",
|
||||||
|
"seq": 2,
|
||||||
|
"root": {
|
||||||
|
"request": {
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"meta": {
|
||||||
|
"name": "public",
|
||||||
|
"seq": 2
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"type": "http",
|
||||||
|
"name": "kw_berechnen",
|
||||||
|
"filename": "kw_berechnen.bru",
|
||||||
|
"seq": 6,
|
||||||
|
"settings": {
|
||||||
|
"encodeUrl": false
|
||||||
|
},
|
||||||
|
"tags": [],
|
||||||
|
"request": {
|
||||||
|
"url": "https://date.elpatron.me/api/kw_berechnen",
|
||||||
|
"method": "POST",
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"name": "Content-Type",
|
||||||
|
"value": "application/json",
|
||||||
|
"enabled": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"params": [],
|
||||||
|
"body": {
|
||||||
|
"mode": "json",
|
||||||
|
"json": "{\n \"datum\": \"2024-06-10\"\n}",
|
||||||
|
"formUrlEncoded": [],
|
||||||
|
"multipartForm": [],
|
||||||
|
"file": []
|
||||||
|
},
|
||||||
|
"script": {},
|
||||||
|
"vars": {},
|
||||||
|
"assertions": [],
|
||||||
|
"tests": "",
|
||||||
|
"docs": "",
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "http",
|
||||||
|
"name": "tage_werktage",
|
||||||
|
"filename": "tage_werktage.bru",
|
||||||
|
"seq": 6,
|
||||||
|
"settings": {
|
||||||
|
"encodeUrl": false
|
||||||
|
},
|
||||||
|
"tags": [],
|
||||||
|
"request": {
|
||||||
|
"url": "https://date.elpatron.me/api/tage_werktage",
|
||||||
|
"method": "POST",
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"name": "Content-Type",
|
||||||
|
"value": "application/json",
|
||||||
|
"enabled": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"params": [],
|
||||||
|
"body": {
|
||||||
|
"mode": "json",
|
||||||
|
"json": "{\n \"start\": \"2024-06-01\",\n \"end\": \"2025-06-10\",\n \"werktage\": true,\n \"bundesland\": \"SH\"\n}",
|
||||||
|
"formUrlEncoded": [],
|
||||||
|
"multipartForm": [],
|
||||||
|
"file": []
|
||||||
|
},
|
||||||
|
"script": {},
|
||||||
|
"vars": {},
|
||||||
|
"assertions": [],
|
||||||
|
"tests": "",
|
||||||
|
"docs": "",
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "http",
|
||||||
|
"name": "kw_datum",
|
||||||
|
"filename": "kw_datum.bru",
|
||||||
|
"seq": 6,
|
||||||
|
"settings": {
|
||||||
|
"encodeUrl": false
|
||||||
|
},
|
||||||
|
"tags": [],
|
||||||
|
"request": {
|
||||||
|
"url": "https://date.elpatron.me/api/kw_datum",
|
||||||
|
"method": "POST",
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"name": "Content-Type",
|
||||||
|
"value": "application/json",
|
||||||
|
"enabled": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"params": [],
|
||||||
|
"body": {
|
||||||
|
"mode": "json",
|
||||||
|
"json": "{\n \"jahr\": 2024,\n \"kw\": 24\n}",
|
||||||
|
"formUrlEncoded": [],
|
||||||
|
"multipartForm": [],
|
||||||
|
"file": []
|
||||||
|
},
|
||||||
|
"script": {},
|
||||||
|
"vars": {},
|
||||||
|
"assertions": [],
|
||||||
|
"tests": "",
|
||||||
|
"docs": "",
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "http",
|
||||||
|
"name": "plusminus",
|
||||||
|
"filename": "plusminus.bru",
|
||||||
|
"seq": 6,
|
||||||
|
"settings": {
|
||||||
|
"encodeUrl": false
|
||||||
|
},
|
||||||
|
"tags": [],
|
||||||
|
"request": {
|
||||||
|
"url": "https://date.elpatron.me/api/plusminus",
|
||||||
|
"method": "POST",
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"name": "Content-Type",
|
||||||
|
"value": "application/json",
|
||||||
|
"enabled": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"params": [],
|
||||||
|
"body": {
|
||||||
|
"mode": "json",
|
||||||
|
"json": "{\n \"datum\": \"2024-06-10\",\n \"anzahl\": 5,\n \"einheit\": \"tage\",\n \"richtung\": \"add\",\n \"werktage\": false\n}",
|
||||||
|
"formUrlEncoded": [],
|
||||||
|
"multipartForm": [],
|
||||||
|
"file": []
|
||||||
|
},
|
||||||
|
"script": {},
|
||||||
|
"vars": {},
|
||||||
|
"assertions": [],
|
||||||
|
"tests": "",
|
||||||
|
"docs": "",
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "http",
|
||||||
|
"name": "wochentag",
|
||||||
|
"filename": "wochentag.bru",
|
||||||
|
"seq": 6,
|
||||||
|
"settings": {
|
||||||
|
"encodeUrl": false
|
||||||
|
},
|
||||||
|
"tags": [],
|
||||||
|
"request": {
|
||||||
|
"url": "https://date.elpatron.me/api/wochentag",
|
||||||
|
"method": "POST",
|
||||||
|
"headers": [
|
||||||
|
{
|
||||||
|
"name": "Content-Type",
|
||||||
|
"value": "application/json",
|
||||||
|
"enabled": true
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"params": [],
|
||||||
|
"body": {
|
||||||
|
"mode": "json",
|
||||||
|
"json": "{\n \"datum\": \"2024-06-10\"\n}",
|
||||||
|
"formUrlEncoded": [],
|
||||||
|
"multipartForm": [],
|
||||||
|
"file": []
|
||||||
|
},
|
||||||
|
"script": {},
|
||||||
|
"vars": {},
|
||||||
|
"assertions": [],
|
||||||
|
"tests": "",
|
||||||
|
"docs": "",
|
||||||
|
"auth": {
|
||||||
|
"mode": "inherit"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"environments": [],
|
||||||
|
"brunoConfig": {
|
||||||
|
"version": "1",
|
||||||
|
"name": "Datecalc",
|
||||||
|
"type": "collection",
|
||||||
|
"ignore": [
|
||||||
|
"node_modules",
|
||||||
|
".git"
|
||||||
|
],
|
||||||
|
"size": 0.0014009475708007812,
|
||||||
|
"filesCount": 5
|
||||||
|
}
|
||||||
|
}
|
||||||
File diff suppressed because one or more lines are too long
@@ -1,5 +1,6 @@
|
|||||||
Flask==3.0.0
|
Flask==3.1.1
|
||||||
numpy==1.26.4
|
numpy==2.3.2
|
||||||
python-dateutil==2.9.0.post0
|
python-dateutil==2.9.0.post0
|
||||||
requests==2.31.0
|
requests==2.32.4
|
||||||
Flask-Babel==4.0.0
|
Flask-Babel==4.0.0
|
||||||
|
pytest==8.4.1
|
||||||
12
robots.txt
12
robots.txt
@@ -1,2 +1,14 @@
|
|||||||
User-agent: *
|
User-agent: *
|
||||||
Allow: /
|
Allow: /
|
||||||
|
|
||||||
|
# Sitemap
|
||||||
|
Sitemap: https://date.elpatron.me/sitemap.xml
|
||||||
|
|
||||||
|
# Disallow private areas
|
||||||
|
Disallow: /stats
|
||||||
|
Disallow: /log/
|
||||||
|
Disallow: /htmlcov/
|
||||||
|
|
||||||
|
# Allow API endpoints for documentation
|
||||||
|
Allow: /api-docs
|
||||||
|
Allow: /static/swagger.json
|
||||||
83
sitemap.xml
Normal file
83
sitemap.xml
Normal file
@@ -0,0 +1,83 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
|
||||||
|
<!-- Hauptseite -->
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>weekly</changefreq>
|
||||||
|
<priority>1.0</priority>
|
||||||
|
</url>
|
||||||
|
|
||||||
|
<!-- API-Dokumentation -->
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/api-docs</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>monthly</changefreq>
|
||||||
|
<priority>0.8</priority>
|
||||||
|
</url>
|
||||||
|
|
||||||
|
<!-- Statische Ressourcen -->
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/static/favicon.ico</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>yearly</changefreq>
|
||||||
|
<priority>0.1</priority>
|
||||||
|
</url>
|
||||||
|
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/static/favicon.png</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>yearly</changefreq>
|
||||||
|
<priority>0.1</priority>
|
||||||
|
</url>
|
||||||
|
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/static/favicon.svg</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>yearly</changefreq>
|
||||||
|
<priority>0.1</priority>
|
||||||
|
</url>
|
||||||
|
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/static/logo.svg</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>yearly</changefreq>
|
||||||
|
<priority>0.1</priority>
|
||||||
|
</url>
|
||||||
|
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/static/manifest.json</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>monthly</changefreq>
|
||||||
|
<priority>0.3</priority>
|
||||||
|
</url>
|
||||||
|
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/static/service-worker.js</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>monthly</changefreq>
|
||||||
|
<priority>0.3</priority>
|
||||||
|
</url>
|
||||||
|
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/static/swagger.json</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>monthly</changefreq>
|
||||||
|
<priority>0.5</priority>
|
||||||
|
</url>
|
||||||
|
|
||||||
|
<!-- Sprachversionen der Hauptseite -->
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/?lang=de</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>weekly</changefreq>
|
||||||
|
<priority>0.9</priority>
|
||||||
|
</url>
|
||||||
|
|
||||||
|
<url>
|
||||||
|
<loc>https://date.elpatron.me/?lang=en</loc>
|
||||||
|
<lastmod>2025-08-03</lastmod>
|
||||||
|
<changefreq>weekly</changefreq>
|
||||||
|
<priority>0.9</priority>
|
||||||
|
</url>
|
||||||
|
</urlset>
|
||||||
@@ -1,15 +1,25 @@
|
|||||||
const CACHE_NAME = 'datumsrechner-cache-v1';
|
const CACHE_NAME = 'datumsrechner-cache-v1';
|
||||||
const urlsToCache = [
|
const urlsToCache = [
|
||||||
'/',
|
'/',
|
||||||
'/static/style.css',
|
|
||||||
'/static/favicon.ico',
|
'/static/favicon.ico',
|
||||||
'/static/favicon.png',
|
'/static/favicon.png',
|
||||||
|
'/static/favicon.svg',
|
||||||
'/static/logo.svg',
|
'/static/logo.svg',
|
||||||
|
'/static/manifest.json',
|
||||||
];
|
];
|
||||||
self.addEventListener('install', event => {
|
self.addEventListener('install', event => {
|
||||||
event.waitUntil(
|
event.waitUntil(
|
||||||
caches.open(CACHE_NAME)
|
caches.open(CACHE_NAME)
|
||||||
.then(cache => cache.addAll(urlsToCache))
|
.then(cache => {
|
||||||
|
// Füge nur existierende Dateien zum Cache hinzu
|
||||||
|
return Promise.allSettled(
|
||||||
|
urlsToCache.map(url =>
|
||||||
|
cache.add(url).catch(err => {
|
||||||
|
console.log('Failed to cache:', url, err);
|
||||||
|
})
|
||||||
|
)
|
||||||
|
);
|
||||||
|
})
|
||||||
);
|
);
|
||||||
});
|
});
|
||||||
self.addEventListener('fetch', event => {
|
self.addEventListener('fetch', event => {
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
.v{
|
{
|
||||||
"openapi": "3.0.3",
|
"openapi": "3.0.3",
|
||||||
"info": {
|
"info": {
|
||||||
"title": "Elpatrons Datumsrechner API",
|
"title": "Elpatrons Datumsrechner API",
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@@ -19,6 +19,32 @@
|
|||||||
.stats-label { color: #64748b; }
|
.stats-label { color: #64748b; }
|
||||||
.stats-value { font-size: 1.5em; font-weight: bold; }
|
.stats-value { font-size: 1.5em; font-weight: bold; }
|
||||||
.chart-container { margin: 2em 0; }
|
.chart-container { margin: 2em 0; }
|
||||||
|
.toggle-container {
|
||||||
|
display: flex;
|
||||||
|
justify-content: center;
|
||||||
|
margin-bottom: 1.5em;
|
||||||
|
gap: 0.5em;
|
||||||
|
}
|
||||||
|
.toggle-btn {
|
||||||
|
padding: 0.5em 1em;
|
||||||
|
border: 1px solid #d1d5db;
|
||||||
|
background: #f9fafb;
|
||||||
|
color: #6b7280;
|
||||||
|
border-radius: 6px;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: all 0.2s;
|
||||||
|
}
|
||||||
|
.toggle-btn.active {
|
||||||
|
background: #2563eb;
|
||||||
|
color: white;
|
||||||
|
border-color: #2563eb;
|
||||||
|
}
|
||||||
|
.toggle-btn:hover {
|
||||||
|
background: #e5e7eb;
|
||||||
|
}
|
||||||
|
.toggle-btn.active:hover {
|
||||||
|
background: #1d4ed8;
|
||||||
|
}
|
||||||
</style>
|
</style>
|
||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
@@ -28,6 +54,12 @@
|
|||||||
<div class="stats-label">Gesamt-Pageviews (7 Tage):</div>
|
<div class="stats-label">Gesamt-Pageviews (7 Tage):</div>
|
||||||
<div class="stats-value">{{ pageviews }}</div>
|
<div class="stats-value">{{ pageviews }}</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<div class="toggle-container">
|
||||||
|
<button class="toggle-btn active" data-period="week">Wochenverlauf</button>
|
||||||
|
<button class="toggle-btn" data-period="day">24-Stunden-Verlauf</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
<div class="chart-container">
|
<div class="chart-container">
|
||||||
<canvas id="imprChart" width="400" height="180"></canvas>
|
<canvas id="imprChart" width="400" height="180"></canvas>
|
||||||
</div>
|
</div>
|
||||||
@@ -43,75 +75,196 @@
|
|||||||
</div>
|
</div>
|
||||||
<script type="text/javascript">
|
<script type="text/javascript">
|
||||||
document.addEventListener('DOMContentLoaded', function() {
|
document.addEventListener('DOMContentLoaded', function() {
|
||||||
// Impressions pro Tag
|
// Daten für verschiedene Zeiträume
|
||||||
// eslint-disable-next-line
|
const weekData = {{ impressions_per_day|tojson }};
|
||||||
const imprData = {{ impressions_per_day|tojson }};
|
const dayData = {{ impressions_per_hour|tojson }};
|
||||||
const imprLabels = Object.keys(imprData);
|
const weekFuncData = {{ func_counts|tojson }};
|
||||||
const imprCounts = Object.values(imprData);
|
const dayFuncData = {{ func_counts_hourly|tojson }};
|
||||||
new Chart(document.getElementById('imprChart').getContext('2d'), {
|
const weekApiData = {{ api_counts|tojson }};
|
||||||
type: 'line',
|
const dayApiData = {{ api_counts_hourly|tojson }};
|
||||||
data: {
|
|
||||||
labels: imprLabels,
|
let currentPeriod = 'week';
|
||||||
datasets: [{
|
let currentImprChart = null;
|
||||||
label: 'Impressions/Tag',
|
let currentFuncChart = null;
|
||||||
data: imprCounts,
|
let currentApiChart = null;
|
||||||
borderColor: '#059669',
|
|
||||||
backgroundColor: 'rgba(5,150,105,0.1)',
|
// Toggle-Buttons Event Listener
|
||||||
tension: 0.2,
|
document.querySelectorAll('.toggle-btn').forEach(btn => {
|
||||||
fill: true
|
btn.addEventListener('click', function() {
|
||||||
}]
|
// Aktiven Button aktualisieren
|
||||||
},
|
document.querySelectorAll('.toggle-btn').forEach(b => b.classList.remove('active'));
|
||||||
options: {
|
this.classList.add('active');
|
||||||
plugins: { legend: { display: true } },
|
|
||||||
scales: {
|
// Zeitraum wechseln
|
||||||
y: { beginAtZero: true, ticks: { stepSize: 1 } }
|
currentPeriod = this.dataset.period;
|
||||||
}
|
updateAllCharts();
|
||||||
}
|
});
|
||||||
});
|
});
|
||||||
// Funktionsaufrufe
|
|
||||||
// eslint-disable-next-line
|
function updateImpressionsChart() {
|
||||||
const funcCounts = {{ func_counts|tojson }};
|
const ctx = document.getElementById('imprChart').getContext('2d');
|
||||||
const labels = Object.keys(funcCounts);
|
|
||||||
const data = Object.values(funcCounts);
|
// Bestehenden Chart zerstören
|
||||||
new Chart(document.getElementById('funcChart').getContext('2d'), {
|
if (currentImprChart) {
|
||||||
type: 'bar',
|
currentImprChart.destroy();
|
||||||
data: {
|
|
||||||
labels: labels,
|
|
||||||
datasets: [{
|
|
||||||
label: 'Funktionsaufrufe',
|
|
||||||
data: data,
|
|
||||||
backgroundColor: '#2563eb',
|
|
||||||
}]
|
|
||||||
},
|
|
||||||
options: {
|
|
||||||
plugins: { legend: { display: false } },
|
|
||||||
scales: {
|
|
||||||
y: { beginAtZero: true, ticks: { stepSize: 1 } }
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
});
|
|
||||||
// API-Nutzung
|
let data, labels, counts;
|
||||||
// eslint-disable-next-line
|
|
||||||
const apiCounts = {{ api_counts|tojson }};
|
if (currentPeriod === 'week') {
|
||||||
if (Object.keys(apiCounts).length > 0 && document.getElementById('apiChart')) {
|
data = weekData;
|
||||||
new Chart(document.getElementById('apiChart').getContext('2d'), {
|
labels = Object.keys(data);
|
||||||
type: 'bar',
|
counts = Object.values(data);
|
||||||
|
} else {
|
||||||
|
data = dayData;
|
||||||
|
labels = Object.keys(data);
|
||||||
|
counts = Object.values(data);
|
||||||
|
}
|
||||||
|
|
||||||
|
currentImprChart = new Chart(ctx, {
|
||||||
|
type: 'line',
|
||||||
data: {
|
data: {
|
||||||
labels: Object.keys(apiCounts),
|
labels: labels,
|
||||||
datasets: [{
|
datasets: [{
|
||||||
label: 'API-Aufrufe nach Endpunkt',
|
label: currentPeriod === 'week' ? 'Impressions/Tag' : 'Impressions/Stunde',
|
||||||
data: Object.values(apiCounts),
|
data: counts,
|
||||||
backgroundColor: '#f59e42',
|
borderColor: '#059669',
|
||||||
|
backgroundColor: 'rgba(5,150,105,0.1)',
|
||||||
|
tension: 0.2,
|
||||||
|
fill: true
|
||||||
}]
|
}]
|
||||||
},
|
},
|
||||||
options: {
|
options: {
|
||||||
plugins: { legend: { display: false } },
|
plugins: {
|
||||||
|
legend: { display: true },
|
||||||
|
title: {
|
||||||
|
display: true,
|
||||||
|
text: currentPeriod === 'week' ? 'Wochenverlauf' : '24-Stunden-Verlauf'
|
||||||
|
}
|
||||||
|
},
|
||||||
scales: {
|
scales: {
|
||||||
y: { beginAtZero: true, ticks: { stepSize: 1 } }
|
y: { beginAtZero: true, ticks: { stepSize: 1 } }
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
function updateFunctionChart() {
|
||||||
|
const ctx = document.getElementById('funcChart').getContext('2d');
|
||||||
|
|
||||||
|
// Bestehenden Chart zerstören
|
||||||
|
if (currentFuncChart) {
|
||||||
|
currentFuncChart.destroy();
|
||||||
|
}
|
||||||
|
|
||||||
|
let data, labels, counts;
|
||||||
|
|
||||||
|
if (currentPeriod === 'week') {
|
||||||
|
data = weekFuncData;
|
||||||
|
labels = Object.keys(data);
|
||||||
|
counts = Object.values(data);
|
||||||
|
} else {
|
||||||
|
// Für stündliche Daten: Summe aller Stunden für jede Funktion
|
||||||
|
const aggregatedData = {};
|
||||||
|
Object.values(dayFuncData).forEach(hourData => {
|
||||||
|
Object.keys(hourData).forEach(func => {
|
||||||
|
aggregatedData[func] = (aggregatedData[func] || 0) + hourData[func];
|
||||||
|
});
|
||||||
|
});
|
||||||
|
data = aggregatedData;
|
||||||
|
labels = Object.keys(data);
|
||||||
|
counts = Object.values(data);
|
||||||
|
}
|
||||||
|
|
||||||
|
currentFuncChart = new Chart(ctx, {
|
||||||
|
type: 'bar',
|
||||||
|
data: {
|
||||||
|
labels: labels,
|
||||||
|
datasets: [{
|
||||||
|
label: 'Funktionsaufrufe',
|
||||||
|
data: counts,
|
||||||
|
backgroundColor: '#2563eb',
|
||||||
|
}]
|
||||||
|
},
|
||||||
|
options: {
|
||||||
|
plugins: {
|
||||||
|
legend: { display: false },
|
||||||
|
title: {
|
||||||
|
display: true,
|
||||||
|
text: currentPeriod === 'week' ? 'Funktionsaufrufe (Woche)' : 'Funktionsaufrufe (24h)'
|
||||||
|
}
|
||||||
|
},
|
||||||
|
scales: {
|
||||||
|
y: { beginAtZero: true, ticks: { stepSize: 1 } }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
function updateApiChart() {
|
||||||
|
const apiChartElement = document.getElementById('apiChart');
|
||||||
|
if (!apiChartElement) return;
|
||||||
|
|
||||||
|
const ctx = apiChartElement.getContext('2d');
|
||||||
|
|
||||||
|
// Bestehenden Chart zerstören
|
||||||
|
if (currentApiChart) {
|
||||||
|
currentApiChart.destroy();
|
||||||
|
}
|
||||||
|
|
||||||
|
let data, labels, counts;
|
||||||
|
|
||||||
|
if (currentPeriod === 'week') {
|
||||||
|
data = weekApiData;
|
||||||
|
} else {
|
||||||
|
// Für stündliche Daten: Summe aller Stunden für jede API
|
||||||
|
const aggregatedData = {};
|
||||||
|
Object.values(dayApiData).forEach(hourData => {
|
||||||
|
Object.keys(hourData).forEach(api => {
|
||||||
|
aggregatedData[api] = (aggregatedData[api] || 0) + hourData[api];
|
||||||
|
});
|
||||||
|
});
|
||||||
|
data = aggregatedData;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (Object.keys(data).length === 0) return;
|
||||||
|
|
||||||
|
labels = Object.keys(data);
|
||||||
|
counts = Object.values(data);
|
||||||
|
|
||||||
|
currentApiChart = new Chart(ctx, {
|
||||||
|
type: 'bar',
|
||||||
|
data: {
|
||||||
|
labels: labels,
|
||||||
|
datasets: [{
|
||||||
|
label: 'API-Aufrufe nach Endpunkt',
|
||||||
|
data: counts,
|
||||||
|
backgroundColor: '#f59e42',
|
||||||
|
}]
|
||||||
|
},
|
||||||
|
options: {
|
||||||
|
plugins: {
|
||||||
|
legend: { display: false },
|
||||||
|
title: {
|
||||||
|
display: true,
|
||||||
|
text: currentPeriod === 'week' ? 'API-Nutzung (Woche)' : 'API-Nutzung (24h)'
|
||||||
|
}
|
||||||
|
},
|
||||||
|
scales: {
|
||||||
|
y: { beginAtZero: true, ticks: { stepSize: 1 } }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
function updateAllCharts() {
|
||||||
|
updateImpressionsChart();
|
||||||
|
updateFunctionChart();
|
||||||
|
updateApiChart();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Initial Charts erstellen
|
||||||
|
updateAllCharts();
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
</body>
|
</body>
|
||||||
|
|||||||
@@ -221,10 +221,11 @@ def test_api_plusminus(client):
|
|||||||
def test_api_stats(client):
|
def test_api_stats(client):
|
||||||
resp = client.get('/api/stats')
|
resp = client.get('/api/stats')
|
||||||
assert resp.status_code == 200
|
assert resp.status_code == 200
|
||||||
# Die Route gibt HTML zurück, nicht JSON
|
data = resp.get_json()
|
||||||
html = resp.data.decode('utf-8')
|
assert "pageviews" in data
|
||||||
# Prüfe auf typische HTML-Elemente des Dashboards
|
assert "func_counts" in data
|
||||||
assert 'Statistik-Dashboard' in html or 'Dashboard' in html
|
assert "impressions_per_day" in data
|
||||||
|
assert "api_counts" in data
|
||||||
|
|
||||||
def test_api_monitor(client):
|
def test_api_monitor(client):
|
||||||
resp = client.get('/api/monitor')
|
resp = client.get('/api/monitor')
|
||||||
|
|||||||
Binary file not shown.
@@ -481,3 +481,107 @@ msgstr "Select German"
|
|||||||
#: templates/index.html:131
|
#: templates/index.html:131
|
||||||
msgid "English auswählen"
|
msgid "English auswählen"
|
||||||
msgstr "Select English"
|
msgstr "Select English"
|
||||||
|
|
||||||
|
#: templates/index.html:132
|
||||||
|
msgid "Taschenrechner"
|
||||||
|
msgstr "Calculator"
|
||||||
|
|
||||||
|
#: templates/index.html:133
|
||||||
|
msgid "Taschenrechner öffnen"
|
||||||
|
msgstr "Open calculator"
|
||||||
|
|
||||||
|
#: templates/index.html:134
|
||||||
|
msgid "Taschenrechner schließen"
|
||||||
|
msgstr "Close calculator"
|
||||||
|
|
||||||
|
#: templates/index.html:135
|
||||||
|
msgid "Verwenden Sie die Tab-Taste um durch die Tasten zu navigieren. Tastatur-Kurzbefehle: Zahlen 0-9, Punkt oder Komma für Dezimal, Plus (+) oder P für Addition, Minus (-) oder M für Subtraktion, Stern (*) oder X für Multiplikation, Schrägstrich (/) oder D für Division, Enter oder Leertaste für Gleich, C für Löschen, Backspace für letzte Ziffer löschen."
|
||||||
|
msgstr "Use the Tab key to navigate through the buttons. Keyboard shortcuts: Numbers 0-9, period or comma for decimal, Plus (+) or P for addition, Minus (-) or M for subtraction, Asterisk (*) or X for multiplication, Slash (/) or D for division, Enter or Space for equals, C for clear, Backspace for delete last digit."
|
||||||
|
|
||||||
|
#: templates/index.html:136
|
||||||
|
msgid "Taschenrechner Anzeige"
|
||||||
|
msgstr "Calculator display"
|
||||||
|
|
||||||
|
#: templates/index.html:137
|
||||||
|
msgid "Berechnungsverlauf"
|
||||||
|
msgstr "Calculation history"
|
||||||
|
|
||||||
|
#: templates/index.html:138
|
||||||
|
msgid "Löschen (Taste: C)"
|
||||||
|
msgstr "Clear (key: C)"
|
||||||
|
|
||||||
|
#: templates/index.html:139
|
||||||
|
msgid "Letzte Ziffer löschen (Taste: Backspace)"
|
||||||
|
msgstr "Delete last digit (key: Backspace)"
|
||||||
|
|
||||||
|
#: templates/index.html:140
|
||||||
|
msgid "Dividieren (Taste: / oder D)"
|
||||||
|
msgstr "Divide (key: / or D)"
|
||||||
|
|
||||||
|
#: templates/index.html:141
|
||||||
|
msgid "Multiplizieren (Taste: * oder X)"
|
||||||
|
msgstr "Multiply (key: * or X)"
|
||||||
|
|
||||||
|
#: templates/index.html:142
|
||||||
|
msgid "Sieben"
|
||||||
|
msgstr "Seven"
|
||||||
|
|
||||||
|
#: templates/index.html:143
|
||||||
|
msgid "Acht"
|
||||||
|
msgstr "Eight"
|
||||||
|
|
||||||
|
#: templates/index.html:144
|
||||||
|
msgid "Neun"
|
||||||
|
msgstr "Nine"
|
||||||
|
|
||||||
|
#: templates/index.html:145
|
||||||
|
msgid "Subtrahieren (Taste: - oder M)"
|
||||||
|
msgstr "Subtract (key: - or M)"
|
||||||
|
|
||||||
|
#: templates/index.html:146
|
||||||
|
msgid "Vier"
|
||||||
|
msgstr "Four"
|
||||||
|
|
||||||
|
#: templates/index.html:147
|
||||||
|
msgid "Fünf"
|
||||||
|
msgstr "Five"
|
||||||
|
|
||||||
|
#: templates/index.html:148
|
||||||
|
msgid "Sechs"
|
||||||
|
msgstr "Six"
|
||||||
|
|
||||||
|
#: templates/index.html:149
|
||||||
|
msgid "Addieren (Taste: + oder P)"
|
||||||
|
msgstr "Add (key: + or P)"
|
||||||
|
|
||||||
|
#: templates/index.html:150
|
||||||
|
msgid "Eins"
|
||||||
|
msgstr "One"
|
||||||
|
|
||||||
|
#: templates/index.html:151
|
||||||
|
msgid "Zwei"
|
||||||
|
msgstr "Two"
|
||||||
|
|
||||||
|
#: templates/index.html:152
|
||||||
|
msgid "Drei"
|
||||||
|
msgstr "Three"
|
||||||
|
|
||||||
|
#: templates/index.html:153
|
||||||
|
msgid "Gleich (Taste: Enter oder Leertaste)"
|
||||||
|
msgstr "Equals (key: Enter or Space)"
|
||||||
|
|
||||||
|
#: templates/index.html:154
|
||||||
|
msgid "Null"
|
||||||
|
msgstr "Zero"
|
||||||
|
|
||||||
|
#: templates/index.html:155
|
||||||
|
msgid "Komma (Taste: . oder ,)"
|
||||||
|
msgstr "Decimal (key: . or ,)"
|
||||||
|
|
||||||
|
#: templates/index.html:156
|
||||||
|
msgid "Fehler"
|
||||||
|
msgstr "Error"
|
||||||
|
|
||||||
|
#: templates/index.html:157
|
||||||
|
msgid "Berechnung"
|
||||||
|
msgstr "Calculation"
|
||||||
|
|||||||
Reference in New Issue
Block a user