## 1. Überblick

Das Wetterstation-Dashboard zeigt die Messwerte einer Davis VantagePro in interaktiven Diagrammen an. Alle Daten werden aus einer PostgreSQL-Datenbank bezogen und im Browser aufbereitet.

Die Oberfläche besteht aus drei Bereichen:

1. Zeitraum-Navigation (oben) – wählt den dargestellten Zeitraum.
2. Diagramme / Tabelle (Mitte) – zeigt die Wetterdaten an.
3. Fußzeile (unten) – zeigt Version, Build-Datum und Kontakt.

## 2. Zeitraum-Auswahl

In der Navigationsleiste am oberen Rand können Sie den Darstellungszeitraum wählen:

24 Stunden 7 Tage 30 Tage 365 Tage Bereich Tabelle

Schaltfläche | Dargestellter Zeitraum | Auflösung
--- | --- | ---
24 Stunden | Letzte 24 Stunden ab jetzt | Einzelmessungen (~5 min)
7 Tage | Letzte 7 Tage ab heute | Tagesmittel / Tages-Min+Max
30 Tage | Letzte 30 Tage ab heute | Tagesmittel / Tages-Min+Max
365 Tage | Letzte 365 Tage ab heute | Tagesmittel, Regen pro Woche
Bereich | Frei wählbar (max. 1 Jahr) | Stundenmittel (< 7 Tage) oder Tagesmittel (≥ 7 Tage)

Der aktuell aktive Zeitraum wird unterhalb der Navigationsleiste als Text angezeigt, z. B. „Die letzten 24 Stunden" oder „01.01.2026 00:00 – 31.01.2026 23:59".

## 3. Aktuelle Werte

Über jedem Diagramm wird der aktuellste Messwert angezeigt (grauer Hinweistext, z. B. „Aktuell: 18,4 °C"). Dieser Wert stammt immer aus den letzten 24 Stunden – unabhängig vom gewählten Zeitraum.

Unterhalb jedes Diagramms erscheinen die Minimum- und Maximumwerte des gewählten Zeitraums mit dem zugehörigen Zeitpunkt.

## 4. Diagramme im Überblick

🌡️
Temperatur °C
🌐
Luftdruck hPa
💧
Luftfeuchtigkeit %
🌧️
Regen mm / mm/h
🧭
Windrichtung °
💨
Wind & Böen km/h

Alle Diagramme sind interaktiv: Fahren Sie mit der Maus über eine Kurve, um den genauen Messwert und Zeitpunkt als Tooltip anzuzeigen.

## 5. Diagramme im Detail

### 🌡️ Temperatur

Im 24h-Modus wird der Temperaturverlauf als Flächendiagramm dargestellt. Bei längeren Zeiträumen (7 d, 30 d, 365 d, benutzerdefiniert ≥ 7 Tage) werden Tages-Minimum und -Maximum als Band angezeigt, sodass die tägliche Schwankungsbreite sofort erkennbar ist.

### 🌐 Luftdruck

Zeigt den barometrischen Druck in hPa. Im Diagrammtitel erscheint ein Trendpfeil, der die Druckentwicklung der letzten Stunden anzeigt:

Pfeil | Bedeutung
--- | ---
⬇⬇ | Fällt schnell (–60)
⬇ | Fällt langsam (–20)
→ | Stabil (0)
⬆ | Steigt langsam (+20)
⬆⬆ | Steigt schnell (+60)

### 💧 Luftfeuchtigkeit

Relative Luftfeuchtigkeit in Prozent als Flächendiagramm.

### 🌧️ Regen

Im 24h-Modus werden zwei Kurven überlagert:

- Regen (mm) – kumulierter Regenfall als Fläche.
- Regenrate (mm/h) – aktuelle Intensität als gestrichelte Linie.

Bei längeren Zeiträumen (7 d, 30 d) wird der Tagesregen als Balkendiagramm dargestellt; bei 365 Tagen der Wochenregen.

Tipp: Im 24h-Modus ist eine Legende eingeblendet, die Regen und Regenrate unterscheidet. Klicken Sie auf einen Legendeneintrag, um eine Serie ein- oder auszublenden.

### 🧭 Windrichtung

Die Windrichtung wird als Punktewolke (Streudiagramm) angezeigt. Die Y-Achse zeigt die Himmelsrichtungen von 0° bis 360°: N = 0°/360°, NO = 45°, O = 90°, SO = 135°, S = 180°, SW = 225°, W = 270°, NW = 315°.

### 💨 Wind & Böen

Zeigt Windgeschwindigkeit (lila) und Böen (orange) in km/h. Bei 365 Tagen und benutzerdefinierten Zeiträumen über einem Jahr werden Böen ausgeblendet, da keine aussagekräftigen Tagesmaxima vorliegen. Unterhalb des Diagramms erscheint die maximale Böe des gewählten Zeitraums mit Zeitpunkt.

Tipp: Im Wind-Diagramm ist eine Legende eingeblendet, die Windgeschwindigkeit und Böen unterscheidet. Klicken Sie auf einen Legendeneintrag, um eine Serie ein- oder auszublenden.

## 6. Tabellenansicht

Klicken Sie auf die Schaltfläche Tabelle, um statt der Diagramme eine tabellarische Tagesübersicht anzuzeigen. Ein Klick auf Grafik kehrt zur Diagrammansicht zurück.

Die Tabelle enthält je Tag:

- Temperatur-Minimum und -Maximum (°C)
- Luftfeuchtigkeit-Minimum und -Maximum (%)
- Luftdruck-Minimum und -Maximum (hPa)
- Regen gesamt (mm)
- Maximale Windböe (km/h)

Im 24h-Modus werden die vorliegenden Einzelmessungen automatisch pro Tag aggregiert, sodass immer eine Tageszeile erscheint.

## 7. Benutzerdefinierter Zeitbereich

Mit der Schaltfläche Bereich öffnet sich ein Dialog, in dem Sie ein Start- und Enddatum frei eingeben können.

Regeln:

- Das Enddatum muss nach dem Startdatum liegen.
- Der maximale Zeitraum beträgt 365 Tage.

Darstellungsauflösung:

- < 7 Tage: Stundenmittelwerte, X-Achse mit Datum und Uhrzeit.
- ≥ 7 Tage: Tagesmittel- bzw. Min/Max-Werte, X-Achse mit Datum.

Der zuletzt gewählte benutzerdefinierte Zeitbereich wird im Browser (`localStorage`) gespeichert und beim nächsten Öffnen des Dialogs vorausgefüllt.

Hinweis: Schließen Sie den Dialog mit Abbrechen, um ohne Änderung zurückzukehren. Ein Klick auf den dunklen Hintergrund schließt den Dialog ebenfalls.

## 8. Automatische Aktualisierung

Im 24h-Modus werden die Daten automatisch alle 5 Minuten neu geladen. Dabei bleibt die aktuelle Ansicht sichtbar – die Seite flackert nicht.

Bei allen anderen Zeiträumen (7 d, 30 d, 365 d, benutzerdefiniert) findet kein automatisches Neuladen statt. Laden Sie die Seite manuell neu (F5 / ⌘R), um aktuelle Daten für diese Zeiträume zu erhalten.

## 9. Drucken

In der Tabellenansicht erscheint oben links die Schaltfläche 🖨️ Drucken. Ein Klick darauf öffnet den Druckdialog des Browsers.

Die Schaltflächen-Leiste und der Drucken-Button werden beim Ausdruck automatisch ausgeblendet, sodass nur die Tabelle erscheint.

Tipp für PDF-Export: Wählen Sie im Druckdialog „Als PDF speichern", um die Tabelle als PDF-Datei zu exportieren.

## 10. Hinweise & Grenzen

Thema | Details
--- | ---
Messsystem | Davis VantagePro Wetterstation
Datenbank | PostgreSQL, Tabelle `weather_data`
Messintervall | ca. 5 Minuten (Rohwerte); längere Zeiträume werden serverseitig aggregiert
Max. Zeitraum | 365 Tage bei benutzerdefiniertem Bereich
Datenlücken | Ausfälle der Station oder des Collectors erscheinen als Unterbrechung in den Kurven
Browserkompatibilität | Alle modernen Browser (Chrome, Firefox, Safari, Edge) in aktueller Version
Mobil | Die Oberfläche ist für Mobilgeräte optimiert; Zeitraum-Buttons zeigen Kurzbezeichnungen
Zeitzone | Alle Zeitangaben in lokaler Browserzeit (keine UTC-Umrechnung)