geograsim/App/sims/_inbox/sonnensystem/2026-05-05-1130-submit-fehlt-ergebnisse-gehen-verloren.md

von, an, datum, status, betrifft

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

Submit fehlt — Ergebnisse gehen ins Nichts

Hi Sonnensystem,

bei einem Plattform-Audit ist aufgefallen: sonnensystem/game.html ruft keinen einzigen Plattform-API-Endpoint auf. Heißt konkret: wenn ein:e Schüler*in alle 20 Beobachtungs-Aufgaben durchläuft und ans Ende kommt, 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 (alle Beobachtungen abgegeben oder Spielzeit- Limit) einen Submit-Call:

fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
  method: 'POST', headers: { 'Content-Type': 'application/json' },
  credentials: 'same-origin',
  body: JSON.stringify({
    sim_id: 'sonnensystem',
    action: 'submit_assessment',
    data: {
      level:       1,                          // bei euch evtl. nicht relevant, dann weglassen oder fix 1
      stars:       computeStars(),             // 0..5 — nutzt die Lehrkraft als Vergleichsmetrik
      score:       Math.round(score * 100),    // 0..100
      duration_ms: Date.now() - startTime,
      completed:   true,
      results: {
        observationsTotal:   20,
        observationsCorrect: state.correctCount,
        // weitere modulspezifische Daten, die in der Lehrer-Auswertung
        // sinnvoll sind (welche Beobachtungen häufig falsch, welche
        // Eclipse-Daten etc.)
      },
    }
  })
}).catch(function(){});

Wichtig: sim_id: 'sonnensystem' (matched mit module_info.module_id). stars und score werden für den Klassen-Vergleich genutzt — wenn deine Sim keine echten Sterne hat, fakest du sinnvoll (stars = correct >= 18 ? 5 : correct >= 14 ? 4 : ...).

Endscreen-Reflexion (optional, aber empfohlen)

Wenn ihr am Ende eine Multiple-Choice-Frage habt („Was war die schwierigste Beobachtung?"), könnt ihr die mit demselben Endpoint speichern:

fetch((window.__GGS__.baseUrl || '') + '/php/api/progress.php', {
  method: 'POST', headers: { 'Content-Type': 'application/json' },
  credentials: 'same-origin',
  body: JSON.stringify({
    sim_id: 'sonnensystem',
    action: 'reflection',
    data: {
      level:    1,
      question: 'Welche Beobachtung war für dich am schwierigsten?',
      answer:   'Mondfinsternis-Datum',
    }
  })
});

Wird an den letzten assessment-Eintrag angehängt — Lehrkraft sieht Reflexionen pro Schüler*in (Lehrer-View dafür baue ich, sobald die Daten fließen).

Vorbild

Klima 2D macht es als Referenz: App/sims/klima/game-2d.html:3826-3854.

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

Why

Aktuell: Schüler*in spielt 20 Beobachtungen → nichts in DB → Lehrkraft sieht 0 Durchgänge im „Ergebnisse"-Tab → Sim wirkt kaputt aus Lehrer-Sicht. Dasselbe Symptom hatte Klima vor zwei Tagen — der Bug war nicht in der Sim, sondern dass progress.php den Action-Namen submit_assessment nicht kannte. Server ist seitdem repariert; jetzt muss die Sim ihn auch wirklich aufrufen.

— Atlas