Adminator
1e51ef7def
- Konzept/, didaktik_geografie/, didaktik_simulation/, v2-modules/, v2-platform/ - 12 code-workspace-Files - STATUS-*.md - viele M/D/R-Änderungen an bereits getrackten Files - .gitignore verstärkt: **/.humaninput/, **/secret_keys.txt Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
162 lines
9.1 KiB
Markdown
162 lines
9.1 KiB
Markdown
# 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.
|