geograsim/App/sims/_inbox/farmer/_status.md

Farmer — Status

Stand 2026-05-07 — Pausen-Marker (Instanz wird abgeschaltet):

Modul ist in stabilem beta-Zustand. Phase 1 vollständig, alle bisherigen Atlas-Mails beantwortet, Inbox leer. Eine Folge-Instanz kann direkt weitermachen — alles ist persistiert.

Aktueller Code-Stand (DATA_VERSION = 23)

• App/sims/farmer/game.html — UI komplett mit KPI-Sparklines, Endbericht, Audio (Mute-Toggle), Fachinfo-Modal, Live-State-Hook (GGS_LIVE_STATE)
• App/sims/farmer/engine.js — Welt-Engine mit Köppen-Zonen (inkl. Cfa), Continent-Transport, Importpreis-Abschlag, Monokultur, Krankheits-Cluster, Markt-Block-Cycle, Regional-Direkt-Lieferung
• App/sims/farmer/assets/data/ — crops.json (10 Sorten), hubs.json (5 Welt-Hubs mit Konsumcity), koeppen-zones.json (9 Zonen), world-countries.json (177 Länder), info-topics.json (15 Fachbegriffe DE+Easy)
• App/sims/farmer/assets/sounds/ — 24 ElevenLabs-SFX + 12 regionale Musik-Loops
• App/sims/farmer/scripts/generate-sounds.php — idempotenter Sound-Generator

Offene Punkte für Folge-Instanz

1. Atlas-Wrapper-Bug FARMER_API_BASE — zeigt auf /api, sollte /php/api. Mail in _inbox/zentrale/2026-05-03-2230-farmer-api-base-fix.md. Workaround in submitAssessment drin (Multi-Pfad-Fallback).
2. progress.php Database-Class-Bug — Plattform-Bug, gleiche Mail.
3. Card-Bild für module_info.card_image — bisher kein Bild gesetzt. Vorschlag in der Status-Mail an Atlas (2026-05-05 11:00).
4. LIVE_PRIMARY_FIELDS — Atlas soll sie aus meinem Vorschlag in teacher.html eintragen (7 Spalten: Jahr, Markt, Geld €, Treffer %, CO₂ kg, Felder, 🦠).
5. Glossar-Übernahme — Glossar-Instanz hat 15 Fachbegriffe in der Pipe. Mail vom 2026-05-04 04:00.

Phase-2-Kandidaten (didaktisch sinnvoll, nicht akut)

• Naturkatastrophen (Dürre, Frost, Hagel, Hurrikan) als zufällige Events
• Marktpreis-Schwankungen (Welthandel-Realität)
• Klimawandel-Engine über Jahrzehnte (Köppen-Zonen verschieben sich)
• Save/Load via DB (Schüler kann unterbrechen, fortsetzen)
• Lehrplan-Integration durch Lehrplan-Instanz

Zugang für Folge-Instanz

• Modul-URL: http://localhost/geograsim/App/farmer
• Workspace: c:\xampp\htdocs\geograsim\farmer.code-workspace
• ELEVENLABS_API_KEY in App/.env.local
• Sound-Generator: php scripts/generate-sounds.php [--force] [--only=name]
• Memory-Pointer: user_farmer.md, project_farmer_state.md in MEMORY.md

Vorher Phase 1.17 + Live-State (2026-05-05 11:00)

• GGS_LIVE_STATE in game.html eingebaut: Plattform-Live-Client erhält alle 4 s Snapshot mit year, market, cash, hit_rate, co2_kg, fields, diseases, crops_used, countries. ~250 Bytes pro Tick.
• Atlas-Crash-Recovery-Mail (2026-05-04 09:00) und Live-State-Mail (2026-05-05 02:50) beantwortet: _inbox/zentrale/2026-05-05-1100-farmer-status-und-live-state.md. Inkl. LIVE_PRIMARY_FIELDS-Vorschlag (7 Spalten: Jahr, Markt, Geld, Treffer-%, CO2, Felder, Krankheiten).

Vorher Phase 1.17 (04:00)

Fachinfo-Modal mit 15 Begriffen zweisprachig (DE + Leichte Sprache). Plus Glossar-Inbox-Mail.

• Fachinfo-Modal im Spiel via ℹ️-Button in Topbar:
  • 15 Begriffe als Card-Grid (Klimazone, Köppen-Geiger, FAO Eignung, Monokultur, Bodenmüdigkeit, Überweidung, Krankheits-Ausbruch, Welt-Hafen, Reefer-Container, CO₂-Fußabdruck, Importpreis-Abschlag, Aquakultur, Subtropisch, Permafrost, Verderblich)
  • Klick auf Card → Detail-Ansicht mit Standard-DE-Text + grüner Leicht-Sprache-Box (A1-A2-Niveau)
  • Quelle: assets/data/info-topics.json
• Glossar-Mail an Glossar-Instanz: 10 plattformweit relevante Begriffe (Klimazone, Köppen, Hafen, Reefer, CO₂, Permafrost, Cfa, etc.) zur Übernahme ins zentrale glossar-Schema. Inbox: _inbox/glossar/2026-05-04-0400-farmer-fachbegriffe.md

Vorher Phase 1.16 (03:30)

Phase 1.16 — Neue Klimazone subtropisch_feucht (Cfa) für China-Yangtze, US-Südost, Süd-Brasilien etc. + Undo-Pflanzung + Importpreis-Abschlag. Modul bleibt beta.

• Neue Köppen-Zone subtropisch_feucht (Cfa): Heißfeuchte Sommer, milde Winter. Polygone für China-Süd-Mitte (lat 20–32, lon 100–123), US-Südost (lat 25–38, lon −100 bis −75), Süd-Brasilien (lat −33 bis −20, lon −60 bis −45), Süd-Japan, Ost-Australien, NE-Indien. Wird VOR gemaessigt_feucht geprüft (im Polygon-Lookup zuerst gefunden).
• gemaessigt_feucht reduziert auf nur kühle Cfb-Bereiche (Mitteleuropa, US-Pazifik-NW, Nord-China, Nord-Japan, Neuseeland).
• Eignungs-Updates in jeder Sorte: Reis subtropisch_feucht=S1, Mais=S1, Weizen/Kaffee=S2, Banane=S3, Olive/Datteln=N1, Tiere=N1/N2. Schüler kann jetzt Reis in Schanghai/Yangtze pflanzen → S1.
• defaultZoneByLatitude erweitert: 23–32° → subtropisch_feucht, 32–38° → mittelmeer (war 23–35), Verschiebung der Übergänge.
• Verifikation: Schanghai/Guangzhou/Houston/Atlanta/SP-Süd → subtropisch_feucht. Berlin/Wien/Beijing → gemaessigt_feucht (korrekt).
• Plus: Undo-Pflanzung-Button im Picker.
• DATA_VERSION = 23.

Vorher Phase 1.15 (02:30)

• Continent-basierte Modus-Wahl statt Distanz-Schwelle. Origin und Hub im selben Kontinent → 🚚 LKW, sonst → 🚢 Schiff. Damit gehen Ukraine/Rumänien/ Sibirien → Hamburg per LKW (vorher fälschlich Schiff über 1500 km). Hub-Daten in hubs.json haben jetzt continent-Property.
• Importpreis-Abschlag −30 % auf Brutto bei Cross-Continent-Lieferung. Realistik: lokale Konkurrenz drückt Importpreis. Ergebnis didaktisch: Massengut (Weizen, Mais) wird über See unattraktiv, Hochmargen-Tropen (Banane, Datteln, Kaffee) bleiben profitabel. Genau wie echter Welthandel. Bericht zeigt zusätzliche Zeile „🌍 Importpreis-Abschlag (Europa → Nordamerika, −30 %)" zwischen Brutto und Transport.
• CO₂-Lehre wird stärker: LKW hat 6× mehr CO₂ als Schiff pro Tonne-km. Sibirien → Hamburg (4400 km LKW) = 394 kg CO₂ vs. Senegal → Hamburg (4900 km Schiff Reefer) = 147 kg CO₂. Schiff über Ozean ist sauberer als LKW über Eurasien.
• DATA_VERSION = 22.

Phase 1.13/1.14 (zwischen 01:00 und 02:30)

• KPI-Sparklines mit Achsen-Skala (Y auto, X 1..22)
• Schiff-/LKW-/Flieger-Volume separat einstellbar (Schiff 0.35)
• buildKpiTimeSeries iteriert über alle Reports (nicht nur abgeschlossene Jahre)

Vorher Phase 1.12 (00:30)

• KPI-Sparklines statt nur aktueller Zahlenwerte: Einnahmen, Treffer-Quote und CO₂ werden als Mini-SVG-Linien dargestellt.
  • X-Achse fix 1..22 (volle Spielzeit, „geht sich bis zum Schluss aus")
  • Y-Achse auto-skaliert mit 10 % Reserve, außer Treffer-Quote (fix 0..100 %)
  • Gestrichelte vertikale Linie bei Jahr 11 = Endbericht-Trigger zur Orientierung
  • Aktueller Wert mit Punkt markiert, Y-Max-Label oben rechts
  • Farben: Einnahmen grün, Treffer-Quote braun, CO₂ rot
• Per-Sound-Volume-Tabelle (SOUND_VOLUMES): vehicle_ship 0.35 (war 0.7), vehicle_plane/truck 0.55. Andere SFX bleiben bei 0.7 default.

Vorher Phase 1.12 (00:30)

• 24 Sound-Effekte via ElevenLabs Sound Generation API generiert (scripts/generate-sounds.php):
  • 14 Aktions-SFX: harvest_start, vehicle_truck/ship/plane, vehicle_arrive, disease_outbreak, monoculture_warn, year_advance, unlock_crop, negative_balance, end_report_open, reset, report_open/next
  • 10 Per-Sorten-Sounds (Tiere mit Geräuschen, Pflanzen mit Rascheln): crop_wheat (Halme rascheln) · crop_banana (Tropenblätter) · crop_reindeer (Brunftruf) · crop_camel (Kamelgrunzen) · crop_rice (Wasserplätschern) · crop_coffee (Hochlandbrise) · crop_dates (Palmwedel) · crop_corn (Maisrauschen) · crop_fish (Wasser-Splash) · crop_olive (Mediterran-Cicadas)
• 12 Musik-Loops (vom User geliefert) in assets/sounds/music/: hamburg1-2, newyork1-2, shanghai1-2, saopaulo1-2, dubai1-4. Pro Markt zufällige Auswahl, wechselt automatisch beim Markt-Block-Wechsel.
• Audio-System:
  • Mute-Toggle 🔊/🔇 in Topbar (persistiert in localStorage)
  • Sounds preloaded beim Boot
  • playSound() klont Audio-Element für überlappende Wiedergabe
  • Browser-Autoplay-Block durch erste User-Interaktion (Welcome-Close) gelöst
  • Hintergrundmusik bei 20 % Lautstärke (nicht ablenkend)
• API-Key in App/.env.local als ELEVENLABS_API_KEY=... gespeichert.
• Generierungs-Skript idempotent + --force/--only=name Flags.

Vorher Phase 1.11 (23:30)

• Endbericht-Trigger auf Jahr 11 vorgezogen (= 10 abgeschlossene Jahre) → Standard-Spieldauer 10–20 Min wie gewünscht. Schüler*in kann nach Endbericht via „Weiter arbeiten" bis Jahr 22+ (alle 10 Sorten unlocked).
• Audio-System:
  • Mute-Toggle 🔊/🔇 in Topbar, persistiert in localStorage
  • playSound(name, opts) respektiert audioEnabled
  • startBackgroundMusic() Stub für Hintergrundmusik
  • bgMusicAudio wird bei Mute pausiert
• SOUNDS-TODO.md komplett überarbeitet:
  • 15 Sound-Effekte (Sound Effects API)
  • 6 Hintergrundmusik-Loops (Suno/Stable Audio empfohlen)
  • Stil: ambient-akustisch, optional regional pro Markt
  • Generierungs-Prompts für jeden Sound

Vorher Phase 1.10 (23:00)

Sterne-Wertung, Plattform-Submit, Reset-Funktion. Modul bleibt beta.

Phase 1.10 — Endbericht (final step)

• Endbericht-Modal öffnet automatisch nach Erreichen Jahr 16 (= 1 voller Hub-Cycle). Zeigt:
  • ⭐⭐⭐⭐☆ Sterne (1–5 abhängig vom Score)
  • Score 0–100 (gewichteter Durchschnitt aus 7 Kategorien)
  • 6 Stat-Kacheln (Einnahmen, Treffer-Quote, CO₂, Krankheiten, Sortenvielfalt, Länder)
  • Verbesserungs-Tipps (regelbasiert, je nach schwachen Bereichen)
  • Submit-Status zur Plattform
• Score-Berechnung (computeFinalScore):
  • Money 25 % (linear bis 30 000 €)
  • Hit-Rate 20 % (S1+S2 Anteil)
  • CO₂ 15 % (invertiert, < 1 000 kg/Jahr → 100, > 5 000 → 0)
  • Disease-Avoidance 10 %
  • Crops/Countries/Climates je 10 %
• Plattform-Submit: POST /php/api/progress.php mit action='submit_assessment' und vollem data-Payload (level, stars, score, duration_ms, results, action_log mit letzten 100 Reports). Mit Multi-Pfad-Fallback wegen Wrapper-Bug (siehe Inbox).
• Reset-Funktion: kompletter Restart inkl. Marker, Kreise, Counter, Money. Bestätigungs-Dialog vor Löschung.
• Inbox an zentrale: 2026-05-03-2230-farmer-api-base-fix.md — Wrapper-Bug FARMER_API_BASE zeigt auf /api statt /php/api. Plus: progress.php referenziert unbekannte Database-Klasse (Plattform-Bug, nicht Farmer).

Vorher Phase 1.9 (22:00)

• 10 Sorten mit Unlock-Plan über 22 Jahre: Jahr 1: Weizen / Banane / Rentier · Jahr 4: Kamel · Jahr 7: Reis · Jahr 10: Kaffee · Jahr 13: Datteln · Jahr 16: Mais · Jahr 19: Fisch (aquatic) · Jahr 22: Olive
• 🐟 Fisch ist die erste aquatic Sorte: S1 in Wasser, N2 auf Land. Engine unterstützt das via crop.aquatic + crop.suitability.wasser Lookup.
• KPI-Panel links mit 4 Live-Kennzahlen: 💰 Einnahmen (kumulativ) · 🎯 Treffer-Quote (S1+S2 % aller Versuche, mit Bar) · 🌫 CO₂-Fußabdruck (kumulativ, Farb-Hinweis bei >5t/Jahr) · 📦 Versuche · 🦠 Krankheiten
• Marker-Schrumpfung nach RECOVERY_YEARS (4): Symbol schrumpft linear über FADE_YEARS (8) auf min. 32 % der Größe. Banane bleibt erkennbar, alte Felder werden zu kleinen Hinweis-Punkten ohne Wirkung.
• Realistische Frachtraten (UNCTAD/Eurostat 2023): LKW 0,07 / Schiff 0,015 / Flieger 1,5 €/t·km. Reefer-Aufschlag 1,5× Kosten + 2× CO₂.
• CO₂-Faktoren (Umweltbundesamt 2022): LKW 90 / Schiff 15 / Flieger 1000 g/t·km.
• OSM-Deutsch-Karte statt Carto Positron: deutsche Beschriftung + Vegetations-Färbung (Wald grün, Wüste beige, Tundra ocker).
• Welt-Wrap aus + maxBounds (kein Klick mehr in der „zweiten" Welt).
• DATA_VERSION = 20.

Vorher Phase 1.8 (19:30)

• Regionale Lieferung: für jedes Feld wird die nächste Konsumcity des aktiven Markt-Hubs gesucht. Wenn diese < REGIONAL_DELIVERY_KM (2000 km) entfernt ist, fährt das Vehicle direkt dorthin (kein Hub-Umweg). Andernfalls geht es international zum Hub und wird von dort distribuiert.
• Engine speichert pro Report destination, isRegional. Bericht zeigt bei Direktlieferung „🚚 LKW → Paris (Hamburg-Region) (206 km)". Bei Hub-Lieferung wie bisher „🚢 Schiff → Hamburg (4500 km)".
• Distribution-Animation vom Hub läuft nur, wenn mindestens eine internationale Lieferung am Hub angekommen ist. Bei rein regionaler Belieferung sind alle Vehicles bereits direkt bei den Konsument*innen.
• fitBounds zieht jetzt auch die echten Ziele (destination) ein, nicht nur den Hub — Direktlieferungen werden im Welt-View mit eingerahmt.
• DATA_VERSION = 18.

Beispiel-Routen mit Hamburg-Markt

Anbau	Distanz Hub	Distanz nächste City	Direkt?
Frankreich (47°N, 2.5°E) → Paris	901 km	206 km	ja → Paris direkt
Lappland → Berlin	1790 km	1829 km	ja → Berlin direkt
Marokko → Paris	2854 km	2135 km	nein → über Hamburg
Senegal → Paris	4907 km	4176 km	nein → über Hamburg

Vorher Phase 1.7b (18:30)

• Welt-Wrap aus: worldCopyJump: false, maxBounds: [[-85,-180],[85,180]], maxBoundsViscosity: 1.0, noWrap: true auf Tile-Layer. Klick in der „zweiten" Welt rechts vom Bering-Strait nicht mehr möglich → kein Bug „Land als Wasser".
• Bodenwirkungs-Kreise 20 % kleiner: monoculture.radiusKm 1500 → 1200 km (Kreis-Radius pro Feld 750 → 600 km). Karte wirkt aufgeräumter.
• Markt-Hub blinkt grün: aktiver Hub bekommt .active CSS-Klasse mit farmer-hub-pulse Animation (1.4 s Cycle). Wechselt automatisch alle 3 Jahre.
• Distribution-Animation: nach Vehicle-Ankunft am Hub fahren 3 zufällige LKW vom Hub zu regionalen Konsumcity. Pro Hub 5 vordefinierte Cities in hubs.json (Hamburg → Berlin/Paris/Wien/Mailand/Warschau, NY → Toronto/Boston/ Atlanta/Chicago/Miami, Shanghai → Tokyo/Seoul/Hongkong/Taipeh/Manila, São Paulo → Rio/BH/Asunción/BA/Brasília, Dubai → Riyadh/Tehran/Karachi/Mumbai/ Cairo). Pin-Toast mit Stadtname am Zielort. Visuell, kein Geld-Effekt.
• Transport 150 % Zeit: alle speedKmPerSec /1.5 in hubs.json, animateOneTrade Cap auf 2250–12000 ms erhöht.
• DATA_VERSION = 17b.

Vorher Phase 1.7a (17:30)

• Markt-Block: jeder Markt-Hub bleibt 3 Jahre aktiv (war: 1 Jahr) — Schüler*in hat Zeit, Anbau auf die passende Klimazone auszurichten. Anzeige im Chip zeigt Restjahre („🇪🇺 Hamburg (noch 2 Jahre)"). Block-Plan: Jahr 1–3 Hamburg · 4–6 New York · 7–9 Shanghai · 10–12 São Paulo · 13–15 Dubai · ...
• Verschiff-Karte fittet alle Punkte: vor animateTrades wird flyToBounds über alle Reports + Hub gemacht (statt fixem Welt-Center) → USA, Asien etc. immer komplett sichtbar während Vehicle-Animation. maxZoom: 3 hält die Übersicht.
• DATA_VERSION = 17a.

Vorher Phase 1.7 (16:00)

• Markt-Auftrag pro Jahr: zyklisch durch alle 5 Hubs (Jahr 1=Hamburg, 2=New York, 3=Shanghai, 4=São Paulo, 5=Dubai, 6=Hamburg ...). Alle Lieferungen gehen jährlich an den Auftrags-Hub. Anzeige in Year-Bar. Lehrt: Anbau in der Nähe des Marktes ist optimal (klassische Wirtschaftsgeographie).
• Bodenwirkungs-Kreise: Jedes Feld hat einen 750-km-Radius-Kreis (= halber Monokultur-Radius). Berühren sich zwei Kreise gleicher Sorte → Bodenmüdigkeit greift, ab 3 verbundenen → Krankheits-Risiko. Visuell elegant: Sichtbarkeit = Logik.
• Schrumpfung: Pro Jahr schrumpft jeder Kreis um 25 %. Nach 4 Jahren (RECOVERY_YEARS) ist der Boden erholt — Kreis verschwindet, Marker bleibt als Lerngeschichte.
• Reefer-Schiff statt Flieger: Banane wird jetzt realistisch per gekühltem Schiff transportiert (1.5× Standard-Schiff-Preis). Flieger-Trigger raus — entspricht echter Bananenlogistik (Ecuador → Hamburg per Schiff).
• DATA_VERSION = 17.

Vorher

Modul bleibt beta. Vergangene Felder gefüllt eingefärbt (Lerngeschichte sichtbar), Animation halbiert + Welt-Zoom davor.

Monokultur-Mechanik (monoculture in crops.json):

• Radius 1500 km, Bodenmüdigkeit −15 % pro nahem Feld gleicher Sorte (max −60 %)
• Krankheits-Ausbruch: ab 3 verbundenen Feldern (transitive Cluster) jährlich 25 % Wahrscheinlichkeit für Totalausfall — deterministisch via Cluster-Hash
• Diagnose-Pool je Sorte: Schwarzrost (Weizen), Panama-Krankheit / Schwarze Sigatoka (Banane), Hufrehe / Insektenplage (Rentier), MERS / Trypanosomiasis (Kamel)

Unlock-System:

• Jede Sorte hat unlockYear in crops.json
• Counter pro Sorte: 1–3 Sorten=3, 4=2, 5=2, 6+=1 (Gesamt-Interventionen sinken pro Sorte mit zunehmender Vielfalt)
• 🐪 Kamel ab Jahr 4 freigeschaltet (Wüsten-Spezialist, S1 in Wüste + tropisch trocken)
• Toast-Hinweis bei Freischaltung

Sound-System (Stub):

• playSound(name) in game.html als Stub (Console-Log)
• 13 Sound-Hooks an passenden Stellen verdrahtet (plant, harvest, vehicle_*, vehicle_arrive, disease_outbreak, year_advance, unlock_crop, etc.)
• Liste mit ElevenLabs-Prompts: App/sims/farmer/SOUNDS-TODO.md
• Aktivierung sobald ELEVENLABS_API_KEY da ist

Vergangene Felder gefüllt: alte (year < game.year) Marker bekommen Eignungsfarbe als Hintergrund-Füllung (Emoji bleibt sichtbar). Diesjährige Ernte: nur Ring + weißer Hintergrund (frisch-Look).

Animation langsamer + Welt-Zoom: Geschwindigkeiten halbiert (LKW 750/Schiff 2000/Flieger 3000 km/sec), Animation max 8 sec, Geld-Toast 2.5 sec sichtbar. Vor animateTrades zoomt Karte auf Welt-Übersicht (zoom 3, [30,15]).

DATA_VERSION = 16 — JSON-Files cache-bust automatisch.

Country-Lookup: world-land.json ersetzt durch world-countries.json (Natural Earth 110m, 178 KB, 177 Länder mit name_de/iso2/continent). Berichte zeigen jetzt „📍 Brasilien (South America) · Tropisch feucht".

Sortenspezifische Einheiten + Preise:

• 🌾 Weizen: 1 Tonne Weizen, S1 = 250 €
• 🍌 Banane: 1 Tonne Bananen, S1 = 750 €, verderblich (über 4000 km Flieger nötig)
• 🦌 Rentier: 1 Rentier (~80 kg Fleisch), S1 = 1500 €

Transportkosten in € pro Tonne-km × Sorten-Tonnage. LKW 0.15 / Schiff 0.02 / Flieger 0.50. Rentier (0.08 t pro Tier) ist transport-leicht → fast immer profitabel. Banane in Amazonas → Flieger → massiver Verlust (didaktisch perfekt).

UI-Refactor: Berichte rechts statt Modal. Eine Card nach der anderen. Karte fliegt zur Pflanzungs-Position, Marker pulsiert (CSS-Animation). Picker versteckt während Bericht-Modus, kommt nach Trade-Animation mit aufgefüllten Countern zurück.

Diagnose-Texte erweitert — pro Eignungsklasse 2 Texte mit konkretem Wirkmechanismus (Temperaturen, Niederschlagsmengen, Tonnage pro Hektar etc.).

Land-Wasser: Natural Earth 1:110m Land-Polygone (world-land.json, 85 KB, 127 Features, 5143 Punkte). 9/9 Sanity-Tests bestanden: Wien=Land, Hudson Bay=Wasser, Mittelmeer=Wasser, Sahara=Land, etc. Auto-Switch entfernt: wenn die gewählte Sorte aufgebraucht ist, zeigt ein Toast die anderen verfügbaren Sorten — User muss aktiv wechseln (verhindert „ich dachte, ich pflanze noch Rentier").

Was passiert ist

• 2026-05-03 00:30 — Onboarding von Logistik-Instanz erhalten.
• 2026-05-03 00:45 — Konzept mit Thomas iteriert + freigegeben.
• 2026-05-03 00:50 — Atlas-Auftrag in _inbox/zentrale/.
• 2026-05-03 01:25 — Logistik liefert Skelett in Atlas-Stellvertretung.
• 2026-05-03 02:15 — Phase 1 gebaut + DB-Status auf beta gesetzt.

Phase 1.5 — Re-Design (Polygon-Reveal raus, Trade-Mechanik rein)

• Polygone nicht mehr sichtbar — Köppen-Lookup bleibt im Hintergrund, aber visuell verschwinden die rechteckigen Reveal-Flächen (waren didaktisch schlecht: verraten Klimazone vor Lernarbeit, optisch überladen).
• 3 Versuche pro Sorte pro Jahr — Counter im Picker (3/3 → 0/3), Refill bei nextYear. Pflanzen ist überall erlaubt (auch Wasser).
• Field-Marker mit Ring — vor Ernte: dezenter brauner Rand. Nach Ernte: farbiger Ring in Eignungs-Farbe (🟢🟩🟡🟠🔴). Ringe bleiben permanent — Lernkarte wächst sichtbar mit. Klick auf Marker zeigt Diagnose-Popup.
• 5 Welt-Hubs als permanente Karten-Marker (Hamburg, New York, Shanghai, São Paulo, Dubai). Jede Ernte sucht den nächsten Hub.
• Trade-Animation nach Erntebericht: 🚚 / 🚢 / ✈️ rutscht von Marker zu Hub. Verkehrsmittel-Wahl: Verderbliches + Distanz > 4000 km → Flieger; < 1500 km → LKW; sonst Schiff. Beim Ankommen: Geld-Toast am Hub.
• Geld-Bilanz in Topbar — wird grün/rot je nach Vorzeichen. Brutto: 100 € (S1) bis 0 € (N2). Transport: € pro km × Modus-Faktor. Banane mitten im Amazonas → top Eignung, aber langer Schiffstransport → wenig Netto. Banane in Marokko → S2 + kurzer Schiffstransport → bessere Bilanz.

Was vorher Phase 1 war (nicht mehr aktiv)

• Visueller Polygon-Reveal-Layer in Eignungsfarben: ersetzt durch Marker-Ringe.

• Welcome-Text auf neue Mechanik aktualisiert.

• assets/data/koeppen-zones.json — vereinfachte Köppen-Geiger-Zonen (8 Großzonen, 36 Polygone insgesamt) als GeoJSON.

• assets/data/crops.json — 3 L1-Sorten (🌾 🍌 🦌) mit FAO-GAEZ- Eignungsmatrix (3 × 8 = 24 Lookup-Werte) und Diagnose-Texten (5 Eignungsstufen × 2-3 Narrative).

• engine.js — Stubs implementiert: loadData, getZoneAt (Point-in- Polygon), getSuitability, plant (mit Zone-Reveal), harvestYear (mit deterministischem Diagnose-Pick via Mulberry32), nextYear.

• game.html — Welt-Karte mit Picker rechts, Reveal-Layer (eingefärbt nach aktuell gewählter Sorte), Welcome- und Erntebericht-Modal, iPad-Pattern (dvh, safe-area, sticky-actions, Float-✕), Easy-Sprache via pickText().

Verifikation lokal

• curl localhost/geograsim/App/farmer → HTTP 200, 16.8 KB
• engine.js, crops.json, koeppen-zones.json → alle HTTP 200
• Wrapper-Injection korrekt: FARMER_BASE='/geograsim/App/sims/farmer/', FARMER_TILE_PROXY='/geograsim/App/php/tile-proxy.php', engine.js mit absolutem Pfad.
• DB: module_info.status='beta', Title Landwirtschaft, Icon 🌾.

Was nicht in Phase 1 ist (kommt Phase 2 / 3)

• Naturkatastrophen (Dürre, Hagel, Frost) — Phase 2
• Budget / Ökonomie — Phase 2
• Mehr Sorten (Mais, Reis, Kartoffel, Kaffee, Rind, Schaf, Kamel) — Phase 2
• Klimawandel-Engine, Schnellvorlauf, Marktpreise — Phase 3

Test am iPad

URL: https://geograsim.at/farmer (nach Deploy) bzw. lokal: http://localhost/geograsim/App/farmer.

Erwartetes Verhalten:

• Welcome-Modal öffnet sich, schließt mit „Los arbeiten" oder Float-✕.
• Karte zeigt Welt im Carto-Positron-Stil.
• Picker rechts mit 3 Sorten, eine ist aktiv (🌾 default).
• Klick auf Land → Crop-Marker, Köppen-Zone wird in Eignungs-Farbe eingefärbt, „Erntejahr starten" wird klickbar.
• Klick auf Wasser → Toast „🌊 Hier ist Wasser".
• Klick auf andere Sorte im Picker → Reveal-Layer wechselt Farben.
• „Erntejahr starten" → Bericht-Modal mit Diagnose pro Feld.
• „Weiter zum nächsten Jahr" → Year-Counter zählt hoch, Felder werden zu „fallow", Marker bleiben sichtbar.