geograsim/.dontDeploy/kofferdetektiv-folge-auftraege-2026-06-15.md

Kofferdetektiv · Folge-Aufträge für Sim-Entwickler

Datum: 2026-06-15 Kontext: Nach Vollausbau-Iteration sind drei Punkte aus dem 17-Punkte-Brief offen, weil sie externe Werkzeuge oder größere Sim-Code-Architektur benötigen. Atlas liefert hier Briefing-Material für die nächste Welle.

Was die Plattform schon liefert

• 46 Glossar-Begriffe (DB), 41 Lehrplan-Anker (AT/CH/DE/LI), Modul-Detailseite mit Bildergalerie
• Sim-Engine: 35 Glossar-Tooltips in Fundsachen, Joystick-Vollanschlag-Sprint (Touch), Audio-Lazy-Load (preload='metadata' statt 'auto'), prominenter Reflexionsfrage-Block mit 40-Zeichen-Minimum
• Datenschutz: case_country nur nach Lösung im GGS_LIVE_STATE, vorher nur case_iso2 für die Lehrer-Sicht
• Reflexionen sichtbar bei Lehrer (Cockpit) + Schüler (Profil)
• 2D-Variante (/kofferdetektiv-2d) als WIP-Slot vorbereitet

Punkt 9 — Englisch-Variante

Status: Vorbereitet (alle Texte in data.js und UI-Konstanten gebündelt laut INTEGRATION.md).

Aufgabe:

• Pro Text-Block zweite Sprach-Variante: KD_HINTS_EN, KD_TUTORIAL_EN, KD_FUNDSACHEN_EN, KD_GLOSSARY_EN
• Sprach-Toggle im Header (🌐 DE/EN, persistent in localStorage)
• Plattform-Glossar glossar.php müsste eine ?lang=en-Variante unterstützen — dafür DB-Spalten short_en, text_en ergänzen
• Lehrplan-Anker bleiben sprachneutral (Quote ist Original-Lehrplan-Text)

Umfang:

• ~3.000 Strings zu übersetzen
• DB-Erweiterung + glossar-API-Anpassung
• Sim-Code Sprach-Switch-Logik
• Erweiterung der Plattform: STUDENT_LANG parallel zu STUDENT_EASY

Empfehlung: Erst dann angehen, wenn eine nicht-deutschsprachige Klasse das Modul testet — sonst Investition ohne Validierung.

Punkt 12 — 3D-Globe-Endscreen

Status: Konzept skizziert im 17-Punkte-Brief.

Aufgabe: Im Endscreen statt klassischer Score-Liste eine Three.js-Globus-Komponente:

• Erde rotiert (Geschwindigkeit ~10°/s)
• Gelöste Länder leuchten goldgelb (#e8c547)
• Ungelöste Länder dunkel
• Klick auf Land → Visitenkarte
• Hover-Hint: „Du hast 4 von 30 Ländern erforscht"

Technik:

• Eigene Three.js-Komponente, nicht im Halle-Scene-Graph
• Erd-Modell: Sphere mit Texture (Natural Earth oder NASA Blue Marble, ~2 MB)
• Länder-Polygone: GeoJSON aus Natural Earth 50m (schon in assets/data/outlines.json vorhanden)
• Polygon-Extrusion in Three.js für Hover-Effekt
• Performance: Geometrie pre-computed, einmal pro Modul-Start

Vorbild: Sonnensystem-Sim hat ähnliche Three.js-Globus-Mechanik.

Empfehlung: Größerer Edit, etwa 600-800 LoC. Würde von Sim-Entwickler-Welle (Three.js-erfahren) gut hingebracht werden.

Punkt 13 — Aussprache-Audio für Wahrzeichen

Status: Konzept skizziert.

Aufgabe: Schwer auszusprechende Ländernamen und Wahrzeichen bekommen einen 🔊-Knopf in der Visitenkarte, der die Aussprache als kurze MP3 abspielt.

Liste der Audio-Files (Beispiele):

• Sigiriya (Sri Lanka)
• Mtatsminda (Georgien)
• Petra tou Romiou (Zypern)
• São Tomé und Príncipe
• Côte d'Ivoire
• Bhutan (Druk Yul)
• ~30 Wahrzeichen + ~30 Hauptstädte = ~60 Audio-Dateien

Generierung:

• ElevenLabs (gleicher Workflow wie die 5 PA-Durchsagen im Modul)
• Stimme: ruhig, klar, mit korrekter Phonetik
• Format: MP3, 64 kbps mono, ~3-5 Sek pro Datei, Gesamtgröße ~3 MB
• Pfad: App/sims/kofferdetektiv/assets/audio/pronounce/<iso2>-<slug>.mp3

Sim-Code-Edit:

• In fillCountryCard() einen 🔊-Button neben dem Wahrzeichen-Namen
• Click → neues Audio-Element mit lazy load
• Persistente Audio-Cache wie bei den SFX

Empfehlung: Aussprache-Audio ist ein Inklusions-Feature — hilfreich besonders für Lernende mit Lese-Schwierigkeiten oder Easy-Sprache-Flag. Sehr empfehlenswert, mittlerer Aufwand.

Offene Punkte (kleiner — Atlas oder Sim-Entwickler)

Punkt 10 — Lehrer-Fall-Verlauf-Tab (Heatmap)

Der View view=module&student_id=X liefert schon runs mit results.countries[]. Atlas könnte im Modul-Detail-Modal (teacher.html openModuleDetail) für Kofferdetektiv einen Spezialfall einbauen:

• Heatmap-Tabelle: Schüler × Land × Status (gelöst/teilweise/nicht-gelöst)
• Histogramm Hinweis-Effizienz pro Schüler:in
• Trend „Zeit pro Fall" über Durchgänge

Aufwand: mittel (200-300 LoC), reines Frontend.

Punkt 6 — Easy-Sprache durchgängig in Sim-Tutorial

Glossar-Begriffe nutzen schon die Plattform-Mechanik (DB easy_language-Auto-Switch). Aber die in-Sim-Texte (Tutorial, Hinweise, Fundsachen-Infos) sind nicht Easy-versioniert. Lösung: pro Text-Block zwei Varianten in data.js:

const KD_HINTS_EASY = [
  { key:'population', text: c => `Auf einem Bild steht: In dem Land wohnen etwa ${c.population} Menschen.` },
  // …
];

Sim zieht Easy-Variante wenn window.STUDENT_EASY === true.

Aufwand: mittel (~500 Strings zu schreiben).

Punkt 7 — Bonus-Material Bottom-Sheet

Aktuell zeigt fillCountryCard() nach Lösung schon Wahrzeichen-Bild + Trivia + Daten. Ein zusätzlicher Bottom-Sheet wäre Polish, kein Muss. Verschiebbar bis Lehrperson-Feedback.

Was Atlas selbst noch nachziehen kann

• Punkt 10 Heatmap (mittel, ohne Sim-Entwickler)
• KD_GLOSSARY DB-Spiegelung (erledigt am 2026-06-15)
• Easy-Sprache-Test mit echtem Schüler-Account (STUDENT_EASY=true)

Briefing-Sicht

Die 3 großen Punkte sind alle „Polish-Plus" — keine blockiert die produktive Nutzung. Empfohlene Reihenfolge:

1. Punkt 13 Aussprache-Audio — höchster Inklusions-Wert, mittlerer Aufwand, kann direkt nach Klassen-Test in Auftrag
2. Punkt 6/10 Easy-Sprache Sim-Tutorial + Lehrer-Heatmap — Atlas-Inhouse-Arbeit, kann beim nächsten Atlas-Sprint
3. Punkt 12 3D-Globe-Endscreen — Sim-Entwickler-Welle, wenn Wal oder andere Three.js-Sim ohnehin in Arbeit
4. Punkt 9 Englisch — erst wenn Bedarf konkret vorhanden ist

---

Kontakt: Atlas (Plattform-Instanz) — bei Plattform-Fragen direkt fragen, dies hier ist nur ein Auftrags-Briefing.