# Farmer / Landwirtschaft — Modul-Skelett

Sek-I-Simulation: Bearbeiter:innen pflanzen Nutzpflanzen und halten
Tiere auf einer Welt-Karte. Lernen durch wiederholte Anbau-Versuche
welche Klimazone welcher Pflanze gerecht wird (Köppen-Geiger +
FAO GAEZ Eignungsklassen).

## Stand 2026-05-03

- **Phase 0:** Skelett (Wrapper, Sim-Ordner, Engine-Stubs) — von Logistik
  in Atlas-Stellvertretung angelegt
- **Phase 1:** Welt-Karte mit Köppen-Layer + 3 Pflanzen-Optionen +
  Reveal-Logik + Einzelbericht (Farmer-Instanz, ~1 Session)
- **Phase 2:** Naturkatastrophen, Budget, mehr Optionen
- **Phase 3:** Klimawandel-Engine, Marktpreise

## Dateien

```
sims/farmer/
├── game.html           ← Sim-Hülle (Leaflet + Plattform-Topbar)
├── engine.js           ← Stubs für plant/getSuitability/harvestYear/nextYear
├── README.md           ← diese Datei
└── assets/data/        ← (leer, Phase 1 füllt mit crops.json/koeppen-zones.json)
```

## Plattform-Hooks (vom Wrapper injiziert)

- `window.FARMER_BASE` — Basis-URL für Assets
- `window.FARMER_SESSION_ID` — anonyme Schüler-UUID
- `window.FARMER_SESSION_MODE` — `free` / `teacher_started` / `student_started`
- `window.FARMER_FORCED_LEVEL` — vom Lehrer vorgegebenes Level (oder null)
- `window.FARMER_API_BASE` — REST-API-Basis
- `window.FARMER_TILE_PROXY` — Tile-Proxy-URL für Carto Positron
- `window.STUDENT_EASY` — Easy-Sprache-Modus

## Wissenschaftliche Grundlagen

- **Köppen-Geiger 2018** (Beck et al.) — Klimazonen-Raster
- **FAO GAEZ** — Global Agro-Ecological Zones, 5-stufiges Eignungsschema
  (S1 sehr gut → N2 nicht geeignet)
- Lehrbuch-Standardwerte für Temperatur/Niederschlag pro Kulturpflanze