Adminator/geograsim
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Atlas: Live-View-Feature + Submit-Bug-Fixes + Admin-Styleguide

Browse Source 
- Neuer API-Endpoint /api/live (heartbeat / spectator) + DB-Tabelle
  live_sessions + class_modules.paused-Spalte
- Plattform-Live-Client (assets/js/live-client.js): Heartbeat,
  Pause-Overlay, Spectator-Mode bei ?view=teacher
- ggs_inject_live() in _scripts.php als Helper, in alle 11 Sim-Wrapper
  integriert
- Lehrer-Cockpit: tabellarische Klassen-Live-Ansicht pro Sim,
  Pause-Toggle, blinkender Tab-Indikator wenn aktive Sessions
- Submit-Bug erschlagen: progress.php hat jetzt submit_assessment-
  und reflection-Action; saves.php akzeptiert beide Key-Konventionen;
  alle Direkt-Pfad-API-Files mit require_once-Bootstrap
- Avatar-Default: zufaelliger DALL-E-Avatar fuer neue Schueler:innen
- Admin-Styleguide-Seite mit Bildstil, Farb-Tokens, Layout, iPad-Pattern
- Klima 2D + 3D: GGS_LIVE_STATE-Hook, Klima 2D zusaetzlich skipResume
  fuer Klassenaufgaben-Reset
- Test-Lehrer Jakob + 3 Schueler:innen lokal + auf Live angelegt
- Rundbriefe an alle Sim-Instanzen + Submit-Briefe an sonnensystem,
  busfahrt, energiemanager + Glossar-Anfrage zu Grundriess
- Status-Uebergabe in _inbox/zentrale/_status.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Thomas
2026-05-07 01:20:53 +02:00
parent e354a30a44
commit 33fb423967
56 changed files with 4869 additions and 226 deletions
Download Patch File Download Diff File Expand all files Collapse all files
App/php/api/progress.php
+126 -1
View File
@@ -4,7 +4,15 @@
* GET /api/progress?sim_id=X → Level/XP für ein Spiel
* GET /api/progress?student_id=X → Alle Fortschritte (Lehrer-Ansicht)
* POST /api/progress {action} → Level updaten, Pre/Post-Antworten speichern
*
* Bootstrap: idempotent, falls direkt über /php/api/progress.php aufgerufen
* (Klima 2D + 3D rufen diese URL direkt — bisher ergab das einen Fatal Error,
* weil Database/Session/Response erst über index.php geladen werden).
*/
require_once __DIR__ . '/../config/app.php';
require_once __DIR__ . '/../lib/Database.php';
require_once __DIR__ . '/../lib/Session.php';
require_once __DIR__ . '/../lib/Response.php';
$method = $_SERVER['REQUEST_METHOD'];
$db = Database::get();
@@ -29,13 +37,36 @@ if ($method === 'GET') {
Response::ok(['progress' => $progress ?: ['level'=>1,'xp'=>0,'plays'=>0,'best_stars'=>0], 'answers' => $answers]);
}
// Lehrer*in: alle Fortschritte eines/r Schüler*in
// Lehrer*in: alle Fortschritte eines/r bestimmten Schüler*in
if ($studentId && !$simId) {
$teacherId = Session::requireTeacher();
$all = $db->fetchAll('SELECT sim_id, level, xp, plays, best_stars FROM player_progress WHERE student_id = ? ORDER BY sim_id', [$studentId]);
Response::ok($all);
}
// Schüler*in: eigene Fortschritts-Liste (Frontend ruft mit student_id=0 oder ohne)
if (!$simId) {
$sessionId = Session::requireStudent();
$session = $db->fetchOne('SELECT class_id, display_name FROM student_sessions WHERE id = ?', [$sessionId]);
$student = $session ? $db->fetchOne('SELECT id FROM students WHERE class_id = ? AND display_name = ?', [$session['class_id'], $session['display_name']]) : null;
if (!$student) { Response::ok([]); }
$studentId = (int)$student['id'];
$all = $db->fetchAll(
'SELECT pp.sim_id, pp.level, pp.xp, pp.plays, pp.best_stars,
mi.title, mi.icon,
(SELECT MAX(submitted_at) FROM assessments
WHERE session_id IN (SELECT id FROM student_sessions
WHERE class_id = ? AND display_name = ?)
AND sim_id = pp.sim_id) AS last_played_at
FROM player_progress pp
LEFT JOIN module_info mi ON mi.module_id = pp.sim_id
WHERE pp.student_id = ?
ORDER BY pp.xp DESC, pp.plays DESC',
[$session['class_id'], $session['display_name'], $studentId]
);
Response::ok($all);
}
Response::error('sim_id oder student_id erforderlich');
}
@@ -102,6 +133,100 @@ if ($method === 'POST') {
Response::ok();
}
// === Sim-Abschluss speichern (Klima-Format mit nested data) ===
// Klima 2D + 3D senden action: 'submit_assessment' mit Body
// {sim_id, data: {level, stars, score, duration_ms, completed, results, action_log, badges_earned}}.
// 'complete' (oben) erwartet ein anderes Format; daher hier ein eigener Handler.
if ($action === 'submit_assessment') {
$sessionId = Session::requireStudent();
$simId = $body['sim_id'] ?? $body['simId'] ?? '';
if (!$simId) Response::error('sim_id erforderlich');
$payload = is_array($body['data'] ?? null) ? $body['data'] : [];
$stars = max(0, min(5, (int)($payload['stars'] ?? 0)));
$durationMs = (int)($payload['duration_ms'] ?? $body['durationMs'] ?? 0);
$resultsJson = json_encode($payload, JSON_UNESCAPED_UNICODE);
$session = $db->fetchOne('SELECT class_id, display_name FROM student_sessions WHERE id = ?', [$sessionId]);
$student = $session ? $db->fetchOne('SELECT id FROM students WHERE class_id = ? AND display_name = ?', [$session['class_id'], $session['display_name']]) : null;
if (!$student) Response::error('Schüler*in nicht gefunden');
$studentId = (int)$student['id'];
// XP + player_progress upserten (gleiche Logik wie 'complete')
$xpGain = $stars * 10 + ($stars >= 5 ? 5 : 0);
$db->execute(
'INSERT INTO player_progress (student_id, sim_id, level, xp, plays, best_stars)
VALUES (?, ?, 1, ?, 1, ?)
ON DUPLICATE KEY UPDATE xp = xp + VALUES(xp), plays = plays + 1, best_stars = GREATEST(best_stars, VALUES(best_stars))',
[$studentId, $simId, $xpGain, $stars]
);
$progress = $db->fetchOne('SELECT xp FROM player_progress WHERE student_id = ? AND sim_id = ?', [$studentId, $simId]);
$xp = (int)$progress['xp'];
$newLevel = $xp < 50 ? 1 : ($xp < 150 ? 2 : ($xp < 300 ? 3 : 4));
$db->execute('UPDATE player_progress SET level = ? WHERE student_id = ? AND sim_id = ?', [$newLevel, $studentId, $simId]);
// Assessment speichern (zentrale Tabelle für Lehrer-Auswertung)
$db->execute(
'INSERT INTO assessments (session_id, sim_id, class_id, results, duration_ms, submitted_at) VALUES (?, ?, ?, ?, ?, NOW())',
[$sessionId, $simId, $session['class_id'], $resultsJson, $durationMs]
);
// Spiegel in student_results (V2)
$score = isset($payload['score']) ? (float)$payload['score'] : null;
$db->execute(
'INSERT INTO student_results (student_id, class_id, module_id, score, duration_sec, detail_json, completed_at)
VALUES (?, ?, ?, ?, ?, ?, NOW())',
[$studentId, $session['class_id'], $simId, $score, (int)round($durationMs/1000), $resultsJson]
);
Response::ok(['xpGained' => $xpGain, 'totalXp' => $xp + $xpGain, 'level' => $newLevel, 'stars' => $stars]);
}
// === Endscreen-Reflexion speichern (Multiple-Choice-Antwort am Spielende) ===
// Sims senden {action:'reflection', data:{level, question, answer}}.
// Speichert die Antwort an den letzten assessment-Eintrag des Schülers für
// diese Sim — damit Lehrkräfte später nachvollziehen können, was die
// Bearbeiter:in als wirksamste/schwierigste Entscheidung empfunden hat.
if ($action === 'reflection') {
$sessionId = Session::requireStudent();
$simId = $body['sim_id'] ?? $body['simId'] ?? '';
$data = is_array($body['data'] ?? null) ? $body['data'] : [];
if (!$simId) Response::error('sim_id erforderlich');
// Letzten assessment-Eintrag dieser Schüler:in × Sim suchen.
$row = $db->fetchOne(
'SELECT id, reflections FROM assessments
WHERE session_id = ? AND sim_id = ? ORDER BY submitted_at DESC LIMIT 1',
[$sessionId, $simId]
);
$entry = [
'level' => $data['level'] ?? null,
'question' => $data['question'] ?? null,
'answer' => $data['answer'] ?? null,
'recorded_at'=> date('Y-m-d H:i:s'),
];
if ($row) {
$existing = $row['reflections'] ? json_decode($row['reflections'], true) : [];
if (!is_array($existing)) $existing = [];
$existing[] = $entry;
$db->execute(
'UPDATE assessments SET reflections = ? WHERE id = ?',
[json_encode($existing, JSON_UNESCAPED_UNICODE), $row['id']]
);
} else {
// Kein Assessment-Eintrag (z. B. Reflexion vor submit_assessment) →
// schreibe einen Stub mit nur Reflexion. Wird bei späterem Submit
// nicht überschrieben (verschiedene IDs).
$session = $db->fetchOne('SELECT class_id FROM student_sessions WHERE id = ?', [$sessionId]);
$db->execute(
'INSERT INTO assessments (session_id, sim_id, class_id, reflections) VALUES (?, ?, ?, ?)',
[$sessionId, $simId, $session['class_id'] ?? null, json_encode([$entry], JSON_UNESCAPED_UNICODE)]
);
}
Response::ok();
}
// === Wirkungsklammer-Ergebnis abrufen ===
if ($action === 'wirkung') {
$sessionId = $body['sessionId'] ?? Session::studentId();