geograsim/.dontDeploy/kofferdetektiv-verbesserungen-2026-06-15.md

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.