# 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`:

```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.