11 Commits

Author SHA1 Message Date
3f3cb3ed01 Wikipedia link 2025-08-01 14:44:41 +02:00
74d9c18bd9 Rearrange text 2025-08-01 14:42:18 +02:00
1b91f8e54d Punkt. 2025-08-01 14:40:48 +02:00
a594d37cf1 Fix markdown linter errors 2025-08-01 14:37:47 +02:00
b95b05e54f Remove bold 2025-08-01 14:36:14 +02:00
2271934228 Add image descriptions 2025-08-01 14:35:29 +02:00
dc73e49da0 Update cloc 2025-08-01 14:34:05 +02:00
030e4adab9 Update screenshot 2025-08-01 14:33:02 +02:00
bd895e356f Verbesserte Test-Coverage auf 90% und Coverage-Badge hinzugefügt 2025-08-01 14:29:15 +02:00
046271343d Updated lighthouse-score.pdf 2025-08-01 14:10:48 +02:00
d0d8e0aeb1 v1.3.13: Weitere Verbesserung der Farbkontraste für Wochentag- und Kalenderwoche-Header 2025-08-01 13:56:34 +02:00
7 changed files with 186 additions and 21 deletions

View File

@@ -1,6 +1,8 @@
# Elpatrons Datumsrechner
Diese moderne Python-Webanwendung (Flask) ermöglicht verschiedene Datumsberechnungen über eine übersichtliche Weboberfläche:
[![Test Coverage](https://img.shields.io/badge/test%20coverage-90%25-brightgreen)](https://github.com/elpatron/datecalc)
Diese moderne Python-Webanwendung (Flask) ermöglicht verschiedene Datumsberechnungen über eine übersichtliche, barrierefreie Weboberfläche.
## Inhaltsverzeichnis
@@ -36,7 +38,13 @@ Diese moderne Python-Webanwendung (Flask) ermöglicht verschiedene Datumsberechn
Datumsrechner Live: [https://date.elpatron.me](https://date.elpatron.me)
![image-20250725095959116](./assets/image-20250725095959116.png)
![App Screenshot](./assets/image-20250725095959116.png)
**[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-score.pdf) -
## Funktionen
@@ -48,7 +56,7 @@ Datumsrechner Live: [https://date.elpatron.me](https://date.elpatron.me)
- Datum plus/minus X Wochen/Monate
- Kalenderwoche zu Datum
- Start-/Enddatum einer Kalenderwoche eines Jahres
- **Sprachausgabe** für alle Ergebnisse (barrierefrei)
- Sprachausgabe für alle Ergebnisse (barrierefrei)
- Statistik-Dashboard mit Passwortschutz unter `/stats`
## Bundesland-Feiertage
@@ -96,7 +104,7 @@ Die App ist dann unter http://localhost:5000 erreichbar.
Das Dashboard ist mit einem statischen Passwort geschützt, das über die Umgebungsvariable `STATS_PASSWORD` gesetzt wird.
![image-20250725100127004](./assets/image-20250725100127004.png)
![Statistics page](./assets/image-20250725100127004.png)
Beispiel (PowerShell):
@@ -179,6 +187,7 @@ Alle Datumsfunktionen stehen auch als REST-API zur Verfügung. Die API akzeptier
```
**Mit curl:**
```bash
curl -X POST http://localhost:5000/api/tage_werktage \
-H "Content-Type: application/json" \
@@ -186,6 +195,7 @@ curl -X POST http://localhost:5000/api/tage_werktage \
```
**Antwort:**
```json
{ "result": 7 }
```
@@ -201,6 +211,7 @@ curl -X POST http://localhost:5000/api/tage_werktage \
```
**Mit curl:**
```bash
curl -X POST http://localhost:5000/api/wochentag \
-H "Content-Type: application/json" \
@@ -208,6 +219,7 @@ curl -X POST http://localhost:5000/api/wochentag \
```
**Antwort:**
```json
{ "result": "Montag" }
```
@@ -221,6 +233,7 @@ curl -X POST http://localhost:5000/api/wochentag \
```
**Mit curl:**
```bash
curl -X POST http://localhost:5000/api/kw_berechnen \
-H "Content-Type: application/json" \
@@ -228,6 +241,7 @@ curl -X POST http://localhost:5000/api/kw_berechnen \
```
**Antwort:**
```json
{ "result": "KW 24 (2024)", "kw": 24, "jahr": 2024 }
```
@@ -241,6 +255,7 @@ curl -X POST http://localhost:5000/api/kw_berechnen \
```
**Mit curl:**
```bash
curl -X POST http://localhost:5000/api/kw_datum \
-H "Content-Type: application/json" \
@@ -248,6 +263,7 @@ curl -X POST http://localhost:5000/api/kw_datum \
```
**Antwort:**
```json
{
"result": "10.06.2024 bis 16.06.2024",
@@ -271,6 +287,7 @@ curl -X POST http://localhost:5000/api/kw_datum \
```
**Mit curl:**
```bash
curl -X POST http://localhost:5000/api/plusminus \
-H "Content-Type: application/json" \
@@ -278,6 +295,7 @@ curl -X POST http://localhost:5000/api/plusminus \
```
**Antwort:**
```json
{ "result": "2024-06-15" }
```
@@ -292,11 +310,13 @@ curl -X POST http://localhost:5000/api/plusminus \
**GET** `/api/stats`
**Mit curl:**
```bash
curl http://localhost:5000/api/stats
```
**Antwort:**
```json
{
"pageviews": 42,
@@ -310,11 +330,13 @@ curl http://localhost:5000/api/stats
**GET** `/api/monitor`
**Mit curl:**
```bash
curl http://localhost:5000/api/monitor
```
**Antwort:**
```json
{
"status": "ok",
@@ -409,7 +431,7 @@ Es werden keine IP-Adressen oder sonstigen persönlichen Daten gespeichert, ledi
- *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).
- *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.
@@ -417,21 +439,22 @@ Damit ist die App für Menschen mit unterschiedlichen Einschränkungen (z.B. Seh
### Code Statistik
cloc|github.com/AlDanial/cloc v 2.06 T=0.06 s (263.5 files/s, 39193.4 lines/s)
cloc|github.com/AlDanial/cloc v 2.06 T=0.16 s (137.5 files/s, 29033.4 lines/s)
--- | ---
Language|files|blank|comment|code
:-------|-------:|-------:|-------:|-------:
HTML|4|21|6|927
Python|2|34|26|482
Markdown|2|116|0|328
JSON|2|0|0|237
JavaScript|1|0|0|20
HTML|8|36|6|1998
Python|2|53|57|614
JavaScript|2|95|87|571
Markdown|2|123|0|353
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:|15|176|38|2017
SUM:|22|498|159|3990
## Lizenz

2
app.py
View File

@@ -12,7 +12,7 @@ app = Flask(__name__)
app.secret_key = os.environ.get('SECRET_KEY', 'dev-key')
# Version der App
APP_VERSION = "1.3.12"
APP_VERSION = "1.3.13"
# HTML-Template wird jetzt aus templates/index.html geladen

Binary file not shown.

Before

Width:  |  Height:  |  Size: 45 KiB

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

View File

@@ -1,4 +1,4 @@
{
.v{
"openapi": "3.0.3",
"info": {
"title": "Elpatrons Datumsrechner API",

View File

@@ -398,11 +398,11 @@ button:focus, .accordion-header:focus {
color: #fff;
}
.header-wochentag {
background: #ea580c;
background: #dc2626;
color: #fff;
}
.header-wochentag.active, .header-wochentag:hover {
background: #c2410c;
background: #b91c1c;
color: #fff;
}
.header-plusminus-tage {
@@ -438,11 +438,11 @@ button:focus, .accordion-header:focus {
color: #fff;
}
.header-kw-datum {
background: #ca8a04;
background: #a16207;
color: #fff;
}
.header-kw-datum.active, .header-kw-datum:hover {
background: #a16207;
background: #854d0e;
color: #fff;
}
.header-plusminus {

View File

@@ -1,6 +1,7 @@
import os
import pytest
from app import app as flask_app
from unittest.mock import patch, MagicMock
@pytest.fixture
def client():
@@ -220,8 +221,10 @@ def test_api_plusminus(client):
def test_api_stats(client):
resp = client.get('/api/stats')
assert resp.status_code == 200
data = resp.get_json()
assert 'pageviews' in data and 'func_counts' in data and 'impressions_per_day' in data
# Die Route gibt HTML zurück, nicht JSON
html = resp.data.decode('utf-8')
# Prüfe auf typische HTML-Elemente des Dashboards
assert 'Statistik-Dashboard' in html or 'Dashboard' in html
def test_api_monitor(client):
resp = client.get('/api/monitor')
@@ -229,3 +232,142 @@ def test_api_monitor(client):
data = resp.get_json()
assert data['status'] == 'ok'
assert 'uptime_seconds' in data
# Neue Tests für bessere Coverage
def test_feiertage_api_error(client):
"""Test Fehlerbehandlung bei Feiertage-API"""
with patch('app.requests.get') as mock_get:
mock_get.side_effect = Exception("Network error")
resp = client.post('/', data={
'action': 'tage_werktage',
'start1': '2024-01-01',
'end1': '2024-01-10',
'bundesland': 'BY'
})
assert resp.status_code == 200
def test_logging_error_handling(client):
"""Test Logging-Fehlerbehandlung"""
# Test ohne Mock, da die App das Logging-Handling bereits hat
resp = client.get('/')
assert resp.status_code == 200
def test_invalid_date_handling(client):
"""Test ungültige Datumseingaben"""
# Ungültiges Datum bei tage_werktage
resp = client.post('/', data={
'action': 'tage_werktage',
'start1': 'invalid-date',
'end1': '2024-01-10'
})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Ungültige Eingabe' in html
def test_invalid_wochentag_input(client):
"""Test ungültige Eingaben bei Wochentag-Berechnung"""
resp = client.post('/', data={
'action': 'wochentag',
'datum3': 'invalid-date'
})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Ungültige Eingabe' in html
def test_invalid_kw_berechnen_input(client):
"""Test ungültige Eingaben bei KW-Berechnung"""
resp = client.post('/', data={
'action': 'kw_berechnen',
'datum6': 'invalid-date'
})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Ungültige Eingabe' in html
def test_invalid_kw_datum_input(client):
"""Test ungültige Eingaben bei KW-Datum"""
resp = client.post('/', data={
'action': 'kw_datum',
'jahr7': 'invalid',
'kw7': 'invalid'
})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Ungültige Eingabe' in html
def test_invalid_plusminus_input(client):
"""Test ungültige Eingaben bei Plusminus-Berechnung"""
resp = client.post('/', data={
'action': 'plusminus',
'datum_pm': 'invalid-date',
'anzahl_pm': 'invalid',
'einheit_pm': 'tage',
'richtung_pm': 'add'
})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Ungültige Eingabe' in html
def test_stats_login_success(client):
"""Test erfolgreiche Anmeldung im Stats-Bereich"""
with client.session_transaction() as sess:
sess['stats_auth'] = True
resp = client.get('/stats')
assert resp.status_code == 200
def test_stats_login_failure(client):
"""Test fehlgeschlagene Anmeldung im Stats-Bereich"""
resp = client.post('/stats', data={'password': 'wrong'})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Falsches Passwort' in html
def test_api_error_handling(client):
"""Test API-Fehlerbehandlung"""
# Test mit korrektem Content-Type
resp = client.post('/api/tage_werktage',
data='invalid json',
content_type='application/json')
assert resp.status_code == 400
def test_api_plusminus_werktage_unsupported(client):
"""Test nicht unterstützte Werktage + Wochen/Monate"""
# Werktage + Wochen
resp = client.post('/api/plusminus', json={
'datum': '2024-06-10', 'anzahl': 5, 'einheit': 'wochen', 'werktage': True
})
assert resp.status_code == 400
assert 'Nicht unterstützt' in resp.get_json()['error']
# Werktage + Monate
resp = client.post('/api/plusminus', json={
'datum': '2024-06-10', 'anzahl': 5, 'einheit': 'monate', 'werktage': True
})
assert resp.status_code == 400
assert 'Nicht unterstützt' in resp.get_json()['error']
def test_api_logging(client):
"""Test API-Logging"""
resp = client.post('/api/wochentag', json={'datum': '2024-06-10'})
assert resp.status_code == 200
# Prüfe ob Log-Datei existiert
log_path = os.path.join('log', 'pageviews.log')
assert os.path.exists(log_path)
def test_api_docs(client):
"""Test API-Dokumentation"""
resp = client.get('/api-docs')
assert resp.status_code == 200
def test_monitor_api_details(client):
"""Test detaillierte Monitor-API"""
resp = client.get('/api/monitor')
assert resp.status_code == 200
data = resp.get_json()
assert 'status' in data
assert 'message' in data
assert 'time' in data
assert 'uptime_seconds' in data
assert 'pageviews_last_7_days' in data