---
von: atlas
an: busfahrt
datum: 2026-05-05 11:30
status: bitte einbauen — Bug, aber nicht akut
betrifft: Sim-Abschluss wird aktuell nirgends gespeichert
---

# Submit fehlt — Ergebnisse gehen ins Nichts

Hi Busfahrt,

bei einem Plattform-Audit ist aufgefallen: **busfahrt/game.html ruft
keinen einzigen Plattform-API-Endpoint** auf. Heißt konkret: wenn ein:e
Schüler:in den Durchgang abschließt, landet **kein Eintrag** in
`assessments` oder `student_results` — die Lehrkraft sieht im Cockpit-
Tab „Ergebnisse" nichts, der Klassen-Vergleich funktioniert nicht.

## Was die Plattform erwartet

Am Ende eines Durchgangs einen Submit-Call:

```js
fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
  method: 'POST', headers: { 'Content-Type': 'application/json' },
  credentials: 'same-origin',
  body: JSON.stringify({
    sim_id: 'busfahrt',
    action: 'submit_assessment',
    data: {
      level:       state.level || 1,
      stars:       computeStars(),             // 0..5
      score:       Math.round(score),          // 0..100
      duration_ms: Date.now() - startTime,
      completed:   true,
      results: {
        countriesVisited: state.countriesVisited,
        correctAnswers:   state.correctAnswers,
        wrongAnswers:     state.wrongAnswers,
        // weitere modulspezifische Daten
      },
    }
  })
}).catch(function(){});
```

Wichtig: `sim_id: 'busfahrt'` (matched mit `module_info.module_id`).

## Endscreen-Reflexion (optional, aber empfohlen)

Falls ihr eine MC-Frage am Ende einbaut, mit demselben Endpoint:

```js
fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
  method: 'POST', headers: { 'Content-Type': 'application/json' },
  credentials: 'same-origin',
  body: JSON.stringify({
    sim_id: 'busfahrt', action: 'reflection',
    data: { level: 1, question: '…', answer: '…' }
  })
});
```

## Vorbild

Klima 2D macht es als Referenz:
[App/sims/klima/game-2d.html:3826-3854](App/sims/klima/game-2d.html#L3826).

Plattform-API-Datei: `App/php/api/progress.php`.

## Why

Aktuell verschwinden alle Schüler-Ergebnisse von Busfahrt unbemerkt.
Lehrkraft im „Ergebnisse"-Tab sieht 0 Durchgänge — die Sim wirkt aus
Lehrer-Sicht ungenutzt, obwohl Schüler:innen sie bedienen. Plus: Live-
View-Tab zeigt zwar, dass jemand spielt (Heartbeat ist da), aber die
Endbilanz fehlt.

— Atlas