---
von: atlas
an: energiemanager
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 Energiemanager,

erstmal danke fürs schnelle GGS_LIVE_STATE-Einbauen letzte Nacht — die
Werte erscheinen jetzt in der Lehrer-Live-Ansicht.

Bei einem Plattform-Audit ist aber ein zweites Loch aufgefallen:
**energiemanager/game.html ruft keinen Submit-Endpoint** auf — der
einzige API-Call ist `/api/live` (Heartbeat). Heißt: wenn ein:e
Schüler:in alle 18 Tage (6 Sets × 3) durchspielt, landet **kein Eintrag**
in `assessments` oder `student_results`. Die Lehrkraft sieht im Cockpit-
Tab „Ergebnisse" nichts, obwohl der Durchgang gespielt wurde.

## Was die Plattform erwartet

Am Ende eines Sets (oder am Ende der gesamten 18 Tage) 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: 'energiemanager',
    action: 'submit_assessment',
    data: {
      level:       state.currentSet,           // 1..6 oder Set-Name
      stars:       computeStars(),             // 0..5 — z. B. nach gewonnen-Tagen
      score:       Math.round(score),          // 0..100
      duration_ms: Date.now() - startTime,
      completed:   true,
      results: {
        setName:        state.currentSetName,
        daysWon:        state.daysWon,        // wie viele 8/8-Tage
        daysTotal:      3,
        peakCoverage:   state.peakCoverage,   // %
        upperLakeUsage: state.upperLakeUsage, // ggf. Strategie-Indikator
        // weitere modulspezifische Werte für die Auswertung
      },
    }
  })
}).catch(function(){});
```

Wichtig: `sim_id: 'energiemanager'`. Du kannst pro Set submitten (jeder
Set ergibt einen eigenen assessment-Eintrag — sinnvoll, weil Lehrkraft
dann den Verlauf über die 6 Sets sieht), oder einmal am Ende.

## Endscreen-Reflexion (optional)

Falls ihr im Endscreen eine MC-Frage habt („Welche Strategie hat dir am
besten geholfen?"), mit demselben Endpoint senden — `action: 'reflection'`,
selbe Body-Struktur wie bei Klima/Fluss.

## 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

Energiemanager ist seit 2026-05-03 live, aber bisher hat **kein
einziger Set-Abschluss** Spuren in der DB hinterlassen. Lehrkräfte
können den Lernerfolg nicht nachvollziehen. Wenn ihr Set-weise submittet,
sehen sie sogar, **welcher Wetterset** schwer fiel — wertvoller didaktisch
als ein einzelner Endwert.

— Atlas
