# Kofferdetektiv · Verbesserungsvorschläge

**Datum:** 2026-06-15
**Sicht:** Atlas (Plattform-Instanz), nach Vollausbau Glossar + Lehrplan
**Vorgehen:** sortiert nach Effekt vs. Aufwand

---

## Sicht von außen — die Sim ist didaktisch eine Schatzkiste

30 Fall-Länder, 20 Hinweis-Kategorien, 30 Fundsachen mit didaktisch starken Info-Texten, 12 Flughäfen weltweit, 16 Hintergrund-Musikstücke, ~190 Länder zum Auswählen. Das macht den Kofferdetektiv zum **inhaltsstärksten** Modul der Plattform. Die meisten Verbesserungen sind keine Lücken-Schließer, sondern Hebel um das Material noch besser sichtbar zu machen.

---

## Hoher Effekt, kleiner Aufwand

### 1. Glossar-Tooltips IN den Fundsachen-Texten verlinken
Die Fundsachen-Toasts erklären jetzt großartige Dinge („100-ml-Regel", „Roaming", „Powerbank-Sicherheit"). Die 26 neuen Glossar-Begriffe sind alle in der DB — aber die Sim-Toasts verlinken sie noch nicht.

**Aufwand:** Sim-Engine markiert in den Texten Schlagwörter mit `<span class="ggs-g" data-glossar="…">…</span>` (Plattform-Standard, glossar-tooltip.js ist schon eingebunden). Vorlage:

```
"Powerbanks müssen ins <span class='ggs-g' data-glossar='akku-handgepaeck'>Handgepäck</span>,
 nie in den aufgegebenen Koffer..."
```

**Effekt:** Lernende klicken den Begriff → sehen Easy-Sprache-Variante. Lehrperson kann darauf bauen, dass das Vokabular klickbar ist.

### 2. Reflexionsfrage prominenter
INTEGRATION.md sagt: Reflexionsfrage „Welcher Hinweis hat dir am meisten geholfen — und welcher Fall war am schwierigsten? Begründe kurz" vor dem Submit. Falls die nur als kleines Textfeld kommt: stärker akzentuieren. Vorschlag: Vollbild-Modal mit dem Bild aus `intro/fall-abgeben.webp`, klares Layout, Submit-Button erst nach Mindest-Text-Länge aktiv (40+ Zeichen).

**Effekt:** echte didaktische Reflexion statt Klick-durch.

### 3. Lehrer-Sicht: case_country prüfen auf Datenschutz
Im Cockpit zeigt `LIVE_PRIMARY_FIELDS['kofferdetektiv']` das Zielland mit Kommentar „nur Lehrpersonen-Sicht". Aber: wenn der Sim den `case_country` in `GGS_LIVE_STATE` einbettet, ist er für Schüler:innen über DevTools im JavaScript sichtbar — der „Lehrer-only" Hinweis ist nur in der teacher.html-Render-Logik. Empfehlung:

- **Variante A:** Sim soll `case_country` **nicht** in GGS_LIVE_STATE liefern. Atlas liest in `/api/live.php` aus der Sim-internen DB (z. B. aus `kofferdetektiv_cases`-Log oder aus dem letzten `assessments.results.countries[]`-Eintrag), nur an Lehrpersonen-Endpoint.
- **Variante B:** Sim verschlüsselt `case_country` mit einem pro-Klasse-Schlüssel, den nur der Lehrer-Cockpit-Backend hat.

Für Pilot-Phase reicht Variante A; das Schüler:innen-Frontend bekommt keinen Anlass, in DevTools zu schauen.

### 4. Welt-Übersicht `welt.html` aus dem Header zugänglich machen
Die existierende `welt.html` (147 LoC, Welt-Atlas-Übersicht aller Länder) ist live unter `/sims/kofferdetektiv/welt.html`, aber nicht verlinkt. Vorschlag: kleiner Header-Button 🌍 im Sim-Header, der die welt.html im neuen Tab öffnet — als Begleit-Referenz „Welt-Übersicht aller 190 Länder".

**Effekt:** Lernende haben ein „großes Bild" zur Hand, didaktisch parallel zur Detektivarbeit.

### 5. Card-Image-Variation für die anderen Cockpit-Stellen
Aktuell: `card-kofferdetektiv.webp` ist die Standard-Karte. Für die Modul-Detailseite + Hero könnte ein zweites Bild („Detektiv mit Lupe über Koffer-Inhalt", aus `assets/img/intro/intro-koffer.webp` oder `intro-terminal.webp`) als Hero-Banner dienen.

---

## Mittlerer Effekt, mittlerer Aufwand

### 6. Easy-Sprache-Modus durch die ganze Sim
Wenn `window.STUDENT_EASY === true`, sollte die Sim:
- statt `KD_GLOSSARY` die Easy-Variante aus DB ziehen (oder lokal eigene Easy-Variante im data.js)
- Hinweis-Texte vereinfachen („Eine Infografik nennt etwa 110 Menschen pro km²" → „Auf einem Bild steht: ungefähr 110 Menschen leben auf 1 Quadrat-Kilometer")
- Wahrzeichen-Bilder ggf. mit Bild-Beschreibung als Alt-Text
- Fundsachen-Infos auf Easy-Sprache-Version umstellen

**Aufwand:** mittel; pro Sektion ein Easy-Pendant. Plattform liefert STUDENT_EASY schon, Sim muss es nur auswerten.

### 7. „Bonus-Material" als Bottom-Sheet zu jedem gelösten Land
Nach Lösung eines Falls könnte ein Bottom-Sheet zusätzliche Info zeigen:
- 1 Wahrzeichen-Foto (gibt's schon in `assets/img/landmarks/`)
- 1 Faktbox aus dem Sim-internen Wissen
- Link zum vollen Glossar-Eintrag der nationalen Symbole (Flagge / Wappen / Staatsform)

**Aufwand:** mittel; UI-Komponente + 30 kurze Texte.
**Effekt:** vertieft das Lernen statt Klick-Bestätigung.

### 8. Performance-Profil dokumentieren
133 MB Sim-Assets, davon 1,8 MB Three.js-Modell (Airport-Diorama) + ~80 MB Hintergrundmusik (16 MP3). Auf Prod ist das fein, weil HTTP/2 und Cache, aber:
- iPad-Erstaufruf könnte langsam wirken
- Schul-Internet mit niedriger Bandbreite testen
- Audio kann später nachgeladen werden (lazy-load nach Boot)

**Empfehlung:** Audio-Verzeichnis `assets/audio/music/` mit `<audio preload="none">` Pattern, lädt erst beim Play.

### 9. Mehrsprachigkeit vorbereitet → tatsächlich Englisch ergänzen
INTEGRATION.md sagt: „Mehrsprachigkeit vorbereitet, alle Texte in data.js/UI-Konstanten gebündelt". Für DACH-Klassen mit nicht-deutschsprachigen Lernenden wäre Englisch-Variante nützlich. Vorschlag: `KD_TEXTS_DE`/`KD_TEXTS_EN`, Schalter im Header.

**Aufwand:** groß (alle Texte übersetzen). **Effekt:** Klassen-Inklusion.

---

## Hoher Effekt, größerer Aufwand

### 10. Lehrer-Auswertung „Fall-Verlauf pro Schüler:in"
Im Lehrer-Cockpit (`results.php`) könnte für Kofferdetektiv ein eigener Tab kommen:
- **Welche Länder** hat Schüler:in X gelöst (Heatmap)
- **Welche Hinweise** wurden am häufigsten gebraucht (Histogramm)
- **Zeit pro Fall** als Trend
- **Reflexionsantworten** als Text-Liste

Schema `assessments.results.countries[]` aus INTEGRATION.md liefert das Material schon. Atlas baut die Auswertung in results.php (ähnlich Heli oder Klima).

### 11. Klassen-Vergleichsmodus
Lehrperson startet `mode='teacher_started'` mit `forcedLevel=2` für die ganze Klasse. Cockpit zeigt: alle Schüler:innen → selbe Stufe → wer hat welches Land schon? Echtzeit-Wettbewerb (ohne Punkte-Druck).

### 12. Globe-Visualisierung im Endscreen
Statt klassischer Score-Liste am Ende: 3D-Globus rotiert, gelöste Länder leuchten goldgelb, ungelöste sind dunkel. „Du hast 4 von 30 Ländern erforscht." Klick auf Land → öffnet noch mal die Visitenkarte.

**Aufwand:** groß (Three.js-Globus + Daten-Binding). **Effekt:** emotionaler Abschluss, klares „mehr ist möglich" Signal.

### 13. Aussprache-Audio für nicht-deutsche Wahrzeichen
30 Wahrzeichen — manche schwer zu lesen (Sigiriya, Mtatsminda, Kotor). Ein 🔊-Knopf in der Visitenkarte spielt die Aussprache (ElevenLabs könnte das vorgenerieren). 30 × ~5 Sekunden = 30 kleine MP3.

**Effekt:** Inklusion für Lernende mit Lese-Schwierigkeiten + Sprach-Vorbild.

---

## Polish und Konsistenz

### 14. Texte-Audit gegen Sprachkonvention
INTEGRATION.md sagt „Lernarbeit-Sprache". Stichprobenartig prüfen:
- Kein „Spiel", „Spielen", „Spieler"
- „Durchgang" statt „Runde"
- „Lehrperson" statt „Lehrkraft"

### 15. Glossar-Begriffe in DB → in `data.js` `KD_GLOSSARY` spiegeln
Die 26 neuen Begriffe sind in der DB, aber `data.js` `KD_GLOSSARY` enthält nur die 20 Hinweis-Kategorien. Für den Fall, dass die Sim offline läuft (Standalone-Test), wäre Konsistenz schön — Atlas könnte ein Python/Node-Script anbieten, das beide Quellen abgleicht.

### 16. Image-Sitemap für Modul-Detailseite
Auf der Modul-Detailseite (`modul-kofferdetektiv`) könnte ein kleiner Bildergalerie-Streifen zeigen: 4-5 In-Sim-Screenshots (Flughafen 3D, Analyse-Ansicht, Visitenkarte, Endscreen, Atlas-Übersicht). Aktuell nur eine Hero-Card.

### 17. Lehrplan-Anker erweitern
Aktuell 8 AT-Anker + 6 CH + 4 DE + 2 LI. Für die volle Tiefe könnten 12 pro Land kommen — z. B. fächerübergreifend in DE die Verbindung zu Wirtschaft/Recht (Verbraucherbildung) und Politik (Internationale Beziehungen).

---

## Was Atlas direkt nachziehen kann (heute oder morgen)

- ✓ Glossar +26 Begriffe (erledigt)
- ✓ Lehrplan-Kompetenzen + 20 Anker (erledigt)
- ✓ Modul-Detail-Seite mit Dual-Button (erledigt)
- ✓ Card-Image (erledigt)
- ⏳ Punkt 4 — Welt-Header-Link auf welt.html
- ⏳ Punkt 5 — Hero-Banner zweites Bild für Modul-Detail
- ⏳ Punkt 16 — Bildergalerie auf Modul-Detail

## Was Sim-Entwickler-Eingriff braucht

- Punkt 1 — Glossar-Tooltips in Fundsachen-Texten
- Punkt 2 — Reflexion-Modal prominenter
- Punkt 3 — case_country aus GGS_LIVE_STATE entfernen
- Punkt 6 — Easy-Sprache durchgängig
- Punkt 7 — Bonus-Material-Bottom-Sheet
- Punkt 9 — Englisch-Variante
- Punkt 12 — Globe-Endscreen
- Punkt 13 — Aussprache-Audio
- Punkt 15 — KD_GLOSSARY mit DB abgleichen

## Was im Plattform-Backend kommt

- Punkt 10 — Lehrer-Cockpit Fall-Verlauf-Tab
- Punkt 11 — Klassen-Vergleichsmodus

---

**Empfehlung Reihenfolge:** Punkt 4 + 5 + 16 sind heute machbar (UI-Polish auf Plattform-Seite). Punkt 1 + 6 sind die größten Hebel für didaktische Tiefe und sollten als nächstes mit dem Sim-Entwickler abgestimmt werden.