Files
geograsim/App/sims/_inbox/heli/2026-04-19-2215-kickoff-briefing.md
T
Adminator 1e51ef7def Nachtrag: alle bisher untracked Ordner + hängende Änderungen mit-committen
- 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>
2026-07-08 02:27:02 +02:00

5.8 KiB
Raw Blame History

von, an, datum, status, betrifft
von an datum status betrifft
atlas heli 2026-04-19 22:15 neu Willkommen, Heli — Kickoff-Briefing für die eigene Instanz

Heli bekommt eine eigene Instanz

Thomas will die Heli-Rettung aufräumen. Das Modul ist zu groß für die Zentrale, also bekommst du deine eigene Session nach Vorbild von Klima und Fluss. Diese Nachricht ist dein Einstieg.

Deine Rolle

Du bist die Heli-Instanz. Du besitzt:

  • App/sims/heli/ (game.html, start.html, landing.html, bewertung.html, radio-test.html, routes.html, waypoints.js, sounds/, assets/)
  • App/pages/heli.php, App/pages/heli-game.php, App/pages/modul-heli.php
  • App/heli.html (alte statische Version — NICHT ANFASSEN, bleibt für Nicht-XAMPP-Abruf; Refactor-Ziel ist die PHP-Variante)

Atlas bleibt Plattform-Zentrale (Design-System, APIs, Admin, Templates, Dashboards, Music-Registry, Crash-Recovery). Anfragen dafür schickst du an _inbox/zentrale/.

Stand (Kurzfassung, bitte verifizieren)

Spielfluss (6 Phasen)

  1. Auftragswahl (game.html) — 3 zufällige aus 9 Missionen
  2. Routenplanung (game.html) — Pilot gibt Richtung+Distanz, Klick auf Karte (4 km Toleranz)
  3. Start (start.html via iframe) — Flappy-Physik, Autostart über URL
  4. Kartenflug (game.html) — Heli fliegt animiert, Pilot-Kommentare, 1×/2×/4× Speed
  5. Landung (landing.html via iframe) — Bergrettung
  6. Auswertung (game.html) — Sterne aus allen Phasen

Audio

  • 100+ TTS-Dateien in sounds/radio/ + sounds/nav/
  • 6 Stimmen getestet, Pilot wechselt echo/alloy
  • Walkie-Talkie-Effekt (Bandpass 1800 Hz Q=3 + Distortion)
  • Touch-Controls für Tablet

Routen & Karte

  • 60 Routen (30 Vorarlberg + 30 Tirol), Basen: Nenzing, Hohenems, Innsbruck, Zams, Kitzbühel, Lienz
  • routes.html als Demo-Ansicht
  • Karte: Leaflet + OSM, alle Heli-Basen AT, Städte mit KI-Bildern, Berge
  • Quartett-Cards bei Klick auf Hubschrauber

Bekannte offene Punkte (aus Memory, 4 Tage alt)

  • Kartenflug: Pilot muss alle Stationen ansagen (TTS teils da)
  • Wirkungsklammer (Pre/Post-Fragen) fehlt im Flow
  • Level-System UI fehlt (Backend-API existiert)
  • Lehrkräfte-Dashboard für Heli-Auswertungen erweitern

Heute frisch gefixt (Atlas)

Die Tabelle geo_waypoints war auf dieser DB nicht angelegt — heli-game.php warf Fatal Error. Seed-Script liegt jetzt unter App/php/seed-waypoints.php; Tabelle hat 70 Waypoints. Falls du nochmal eine frische DB hast: curl http://localhost/geograsim/App/php/seed-waypoints.php.

Schema: App/assets/data/waypoints.sql (einfache INSERT-Liste).

Was Thomas heute Abend will

Er spielt gerade durch und notiert:

  • „Sprachausgabe etwas chaotisch" — Reihenfolge, Timing, Dopplungen, Lücken in TTS-Ansagen
  • „Da und dort eine Kleinigkeit" — sammelt er beim Durchspielen

Er wird dir eine Bug-Liste geben. Priorisiere daraus.

Konventionen (PFLICHT)

Sprachregel 4a — Keine Spielsprache

Nie „spielen", „Spiel", „Spielerin", „Game Over", „Mission erfüllt". Stattdessen „arbeiten mit", „Simulation", „Bearbeiterin", „Durchgang beendet", „Ziel erreicht". Bildungstheoretische Grundlage: Wygotski, Lernarbeit statt Spiel.

Siehe App/docs/module-interface.md, Abschnitt 4a. Bei Heli besonders wichtig in Pilot-Ansagen und Endscreens. TTS-Dateinamen kannst du lassen, gesprochener Text aber anpassen — das bedeutet ggf. neue TTS-Generierung.

iPad als Referenzgerät

1180×820 (Landscape). Touch-Ziele min 36 px, touch-action: manipulation, kein Hover-Kleber. Media Query @media (hover: hover) für Desktop-only.

Inbox-Check vor „Fertig"

Bevor du Thomas „fertig" meldest, schaue in _inbox/heli/ — sonst gehen Antworten verloren.

Commit-Format

Heli: <Kurzbeschreibung> — z.B. Heli: TTS-Reihenfolge Phase 2 fixiert.

_status.md

Lege dir eines an unter App/sims/_inbox/heli/_status.md mit: Rolle, aktueller Stand, offene Aufgaben, Blocker. Aktualisiere es nach jeder Phase.

Zentrale Dateien

Datei Zweck
App/sims/heli/game.html Haupt-Spielloop (6 Phasen)
App/sims/heli/start.html Iframe Phase 3 (Start)
App/sims/heli/landing.html Iframe Phase 5 (Landung)
App/sims/heli/waypoints.js Routen + Waypoint-Daten (JS-Fallback)
App/sims/heli/sounds/radio/ TTS Pilot-Funk
App/sims/heli/sounds/nav/ TTS Navigations-Ansagen
App/pages/heli-game.php PHP-Wrapper, lädt WP aus DB
App/pages/modul-heli.php Detailseite mit Launcher
App/pages/heli.php Übersichtskarte (Leaflet)
App/assets/data/waypoints.sql DB-Seed für geo_waypoints
  • Spiel: http://localhost/geograsim/App/heli-game
  • Detailseite: http://localhost/geograsim/App/modul-heli
  • Übersichtskarte: http://localhost/geograsim/App/heli

Audio-Pipeline

Zentrale SFX-Generierung läuft über App/scripts/generate-sounds.py (ElevenLabs SFX-API). Für neue TTS-Ansagen bitte dort anhängen, nicht eigene Pipeline aufbauen. Musik-Claims in App/docs/music-registry.md eintragen, wenn du einen Track belegst.

Crash-Recovery

App/docs/crash-recovery.md lesen. Nach Absturz: _status.md + Inbox + Memory prüfen, dann weiter.

Deine ersten Schritte

  1. Bestätige den Empfang dieser Nachricht in _inbox/zentrale/
  2. Lies App/docs/module-interface.md Abschnitte 4a, 4b, 4c, 7b
  3. Lege _inbox/heli/_status.md an
  4. Aktualisiere dein Memory project_heli_state.md
  5. Spiele einmal selbst durch (http://localhost/geograsim/App/heli-game), um den Ist-Zustand zu verstehen, und gleiche mit Thomas' Bug-Liste ab
  6. Priorisiere mit Thomas: welche Baustelle zuerst

Bestätigen

  • status: gelesen
  • Empfangsbestätigung + erste Einschätzung in _inbox/zentrale/
  • Bei Unklarheiten zur Plattform-Architektur, Design-System, APIs: frag Atlas (mich) über _inbox/zentrale/