# Wetter-Puls.de — Autarke Wetter- & Unwetterplattform für Deutschland
> https://wetter-puls.de

## Überblick
Wetter-Puls ist eine moderne, 100% DSGVO-konforme Wetter- und Unwetter-Plattform für Deutschland. Die Plattform arbeitet trackerfrei und kombiniert amtliche Modelldaten des Deutschen Wetterdienstes (DWD ICON-D2) mit eigener physikalischer Modellierung und KI-Analyse.

## Hauseigenes Wettermodell: Wetter-Puls Modell (WPM)
Das **Wetter-Puls Modell (WPM)** ist ein eigenständiges, mathematisch-thermodynamisches Vorhersage- und Anomalie-Erkennungsmodell, das speziell für convective Events, Superzellen, Schwergewitter und High-Shear-Low-CAPE (HSLC) Lagen entwickelt wurde.

### Kernfunktionalität & Physik:
1. **Thermodynamischer Faktor ($F_{thermo}$):** Verrechnet Convective Available Potential Energy (CAPE) und Convective Inhibition (CIN) mit der vertikalen Wolkenmächtigkeit ($\Delta h_{cloud}$):
   $$F_{thermo} = \frac{\text{CAPE}}{\max(18, |\text{CIN}|)} \times \left(1 + \frac{\Delta h_{cloud}}{8000}\right)$$
2. **Kinematischer Faktor ($F_{kinematic}$):** Bewertet die vertikale Windscherung (0–6 km Bulk Shear und 10m–120m Low-Level Shear):
   $$F_{kinematic} = \frac{\text{Bulk Shear}_{0-6km}}{14\text{ m/s}} + \frac{\text{Low-Level Shear}_{120m-10m}}{8\text{ m/s}}$$
3. **Wetter-Puls Threat Score (0 bis 100):** Skaliert die Gesamteinstufung hyperbel-harmonisch und erkennt verdeckte HSLC-Lagen:
   $$S_{threat} = \min(100, \text{Round}(40 \tanh(F_{thermo}/25) + 30 \tanh(F_{kinematic}/1.8) + 30 \tanh((F_{thermo} \times F_{kinematic})/35) + \text{HSLC\_Bonus}))$$
4. **Diskrepanz-System (Dreiklang):** Identifiziert Frühwarnlagen, in denen amtliche Warnstufen noch auf Stufe 0 (Grün) stehen, während die physikalische Instabilität bereits Alarmstufe signalisiert.

### Wichtiger Haftungsausschluss:
> **Hinweis & Disclaimer:** Alle Berechnungen, Indizes, Warnstufen und Prognosen des Wetter-Puls Modells (WPM) erfolgen **ohne Gewähr**. Wetter-Puls ist eine unabhängige Plattform und ersetzt keine behördlichen Evakuierungs- oder Katastrophenschutzanordnungen.

## Öffentliche REST-APIs (Pro & Entwickler)
- `GET /api/v1/pulse-engine?plz={PLZ}` oder `?lat={LAT}&lon={LON}` — Liefert die vollständige WPM Threat-Matrix, Thermodynamik, Kinematik und Diskrepanz-Analyse in < 3ms aus dem Redis-Cache.
- `GET /api/v1/warnungen?plz={PLZ}` — Amtliche DWD-Warnungen nach Postleitzahl.
- `GET /api/v1/forecast?plz={PLZ}` — Hochaufgelöste 10-Tage und Stundenvorhersage.
- `POST /api/v1/meteorologist/ask` — KI-Meteorologe mit physikalisch fundierten regionalen Analysen.

## Hauptbereiche & Module
- **Dashboard (`/index.php?dashboard`):** Frei konfigurierbare Kacheln inkl. CAPE-Rechner, Taupunkt-Spiegel, kombiniertem Wolkenschichten-Widget (`cloud_layers`), Solar-Ertrag und DWD-Warnkarte.
- **24/7 Live-Stream (`/index.php?livestream`):** Autarker OBS/MediaMTX Wetterkanal mit automatischer Anomalie-Sprachsynthese (TTS) und Live-Radar.
- **Polarlicht & Weltraumwetter (`/index.php?aurora`):** NOAA Ovation-Modell, Sonnenwind (EPAM, Bz-Index, Kp-Index) und Live-Prognose.
- **Dürre & Bodenfeuchte (`/index.php?duerre`):** Dürremonitor bis 1,8m Bodentiefe und Waldbrandgefahrenindex.