CW Environment 0.1.0-alpha73 · 10.09.2026
======================================

Data Foundation 3.0 · Copernicus-Mehrländer-Nachtlauf

Ziel dieses Releases
--------------------
alpha73 baut auf dem bestehenden alpha72-Themenimport auf und ergänzt die
fehlende robuste RAW-Datenbasis für spätere Karten, Tabellen, Diagramme,
Marker, Formeln und wissenschaftliche Exporte.

Für den ersten produktiven Lauf ist DACH vorbereitet:
- Deutschland
- Schweiz
- Österreich

Im Backend sind zusätzlich Deutschland, ganz Europa und eine freie
Mehrfachauswahl der vorhandenen europäischen Länder verfügbar.

DACH-Paketplan (Stand 10.09.2026)
---------------------------------
- ERA5-Land Historie: 76 Jahrespakete (1950–2025), 50 Monatsvariablen
- ERA5-Land statisch: 1 Paket, 10 Modellfelder
- ERA5 Bewölkung: 76 Jahrespakete (1950–2025), 4 Variablen
- CAMS Europa Reanalyse: 156 Monatspakete (2013–2025), 22 Variablen,
  stündliche Werte innerhalb der Monatsdateien
- CAMS aktueller Forecast: 1 Tagespaket, 13 Variablen (7 Hauptschadstoffe + 6 Pollen),
  0–96 Stunden
- Gesamt: 310 fortsetzbare Pakete / 92 eindeutige Quellvariablen

Hintergrundworker
-----------------
- startet als eigener Python-Prozess; Browser darf anschließend geschlossen werden
- nightly-state.json, nightly-plan.json, Lock und Log unter dem Copernicus-Syncpfad
- Remote-Job-ID bleibt beim Warten/Stop erhalten
- fertige Pakete werden lokal erkannt, validiert und wiederverwendet
- Download zunächst als .part, erst nach Formatprüfung atomare Übernahme
- SHA-256 und Paketmanifest je fertigem Rohpaket
- sicherer Stop und spätere Wiederaufnahme
- deterministische Lizenz-/Request-/Authentifizierungsfehler blockieren nur die
  betroffene Quelle, damit nicht hunderte identische Fehlrequests entstehen

Rohdatenprinzip
---------------
Die Quellpakete werden unverändert regionsbezogen archiviert. Eine DACH-
Bounding-Box darf deshalb Randzellen benachbarter Länder enthalten. Exakte
politische Ländertrennung erfolgt später durch die bereits vorhandenen
Environment-Geometrien in der normalisierten Data-Service-Schicht.

Speicherstruktur (schematisch)
------------------------------
project/storage/environment/copernicus/
  raw/
    dach/
      cds/
      ads/
  sync/
    nightly-plan.json
    nightly-state.json
    nightly.log
    nightly.lock

Voraussetzungen für „Komplettbasis“
-----------------------------------
- CDS API-Token
- ERA5-Land Bedingungen akzeptiert
- ERA5 Single Levels Bedingungen akzeptiert
- ADS API-Token
- CAMS European air quality reanalyses Bedingungen akzeptiert
- CAMS European air quality forecasts Bedingungen akzeptiert
- Python erreichbar
- PHP proc_open verfügbar

Wichtiger Hinweis
-----------------
Die Paketplanung, Resume-Logik, Dateivalidierung, PHP/Python-Syntax und
DACH-Geometrie wurden offline geprüft. Ein echter CDS-/ADS-Produktionslauf
benötigt die persönlichen Tokens und akzeptierten Dataset-Bedingungen und
muss deshalb auf cw.test praktisch bestätigt werden. Der Worker ist so
gebaut, dass ein deterministischer Quellenfehler die Quelle blockiert statt
weiter Requests zu senden.

Nächster Schritt
----------------
Nach dem RAW-Archiv folgt der normalisierte Environment Data Service. Erst
danach werden der geplante Analyse-Workspace, Gruppen, Karten, Tabellen,
Diagramme, Marker T1/T2/T3, CW Formulas und Markdown-Datenwerte auf dieselbe
Datenebene gesetzt.
