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>
127 lines
5.9 KiB
Markdown
127 lines
5.9 KiB
Markdown
# 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.
|