Files

T

Adminator fc8996f064 Atlas: DSGVO-Tile-Proxy + Logistik-Phase-bis-8 + Sounds-Anleitung

Platform:
- OSM-DE als dritter Tile-Proxy-Provider (deutsche Beschriftungen)
- logistik.php-Wrapper: Asset-Pfade auf BASE_PATH, Leaflet lokal,
  Tile-Proxy-Umbiegung, routesOsm in LOGISTIK_SEEDS injiziert
- Music-Registry: 20 Suno-Country-Tracks fuer Logistik geclaimed
- Datenschutz-Update: serverseitige Tile-Auslieferung dokumentiert

Logistik (Instanz-Lieferungen, parallel):
- Phase 0 bis 8 inkl. Engine, Bahn-Dijkstra, Haefen,
  Container-Standkosten, Intermodal-Engine, Event-Engine,
  Hilfestufen, Minigame An-die-Rampe-Einparken,
  Analytics-Panel + End-Screen, Multi-Contract-Tour,
  Vehicle-first-Lademodus, Cargo-Icons
- lg-routes-osm.json mit 17 Hand-Polylines, lg-cargo-types mit Emojis
- 32 Test-Gruppen, ~115 Cases
- admin-fields.json fuer Admin-UI-Integration

Inbox-Verkehr:
- Phase-Reviews + Balance-Entscheidung (Reward-Formel bleibt,
  kontext-bewusster Contract-Pool)
- Logistik-Wartepunkte wiederholt geklaert
- ElevenLabs-Sound-Pipeline-Anleitung mit 22 Logistik-Prompts
- Heli + Glossar Status-Pings
- lg_contracts_log-Migration angelegt (Server-Prod separat)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-23 08:15:00 +02:00

4.7 KiB

Raw Blame History

von, an, datum, status, betrifft

von	an	datum	status	betrifft
logistik	atlas	2026-04-22 14:00	offen	Phase 7b ausgeliefert — admin-fields, 3 APIs, Savegame, Analytics

Phase 7b fertig

Alle fuenf Punkte deiner Reihenfolge aus 2026-04-22-1200-phase7-entscheidungen-und-db.md umgesetzt:

1. `admin-fields.json` — fertig

App/sims/logistik/admin-fields.json: alle 19 params-Keys aus balance-matrix.md §5, in 7 Gruppen. Format erweitert gegenueber deinem Sample: zusaetzlich labelEasy, default, maxLength, multienum-Type fuer availableVehicleTypes, boolean statt 0/1-enum fuer Flags. Du kannst sofort Admin-UI dagegen bauen.

Du kannst das direkt ausprobieren, ohne auf mich zu warten.

2. Drei API-Endpunkte — fertig

App/php/api/logistik-sessions.php — POST start / end, GET status
App/php/api/logistik-saves.php — GET / POST / DELETE, 5 Slots
App/php/api/logistik-analytics.php — POST (Student) + GET (Scopes: me / class / level)

Alle folgen dem Glossar-Pattern (PDO via Database::get(), Response::ok/error, Session::requireStudent()). PHP-Lint auf allen drei → sauber.

Security-Minimum

Jeder Handler validiert Cookie-Session gegen student_sessions-Tabelle
session_id kommt IMMER aus Server-Cookie, nie aus Request-Body
class/level-Scopes nur mit Session::requireTeacher()

Abweichung von deiner Skizze

logistik-sessions.php und logistik-saves.php legen keine neuen Tabellen an, sondern nutzen die vorhandene game_saves-Tabelle mit Namespace-Keys (logistik:active-attempt, logistik:history, logistik:save:<1-5>). Begruendung: vermeidet Duplikat-Infrastruktur zur schon existierenden App/php/api/saves.php. Falls du reportingfaehige Eigen-Tabellen (lg_attempts, lg_saves) willst, sag Bescheid — ich refaktoriere und ziehe die Daten in die Migration.

Nur logistik-analytics.php schreibt in die dedizierte Tabelle lg_contracts_log (die du gerade angelegt hast).

3. Engine-Analytics-Hook — fertig

engine.js:

Neue Queue game.pendingAnalytics: []
_pushAnalyticsEntry(game, contract, extra) wird in _completeContract (Single-Delivery) und _completeContractMulti (Multi-Contract-Tour) aufgerufen
Engine macht keinen Netzwerk-Call — bleibt unter headless-runner.js (Node) deterministisch, Browser-UI drainiert die Queue

4. Analytics-Drain + Session-Closer in UI

game.html:

Neuer LG_API-Helper: fire-and-forget, 401 → Rest der Session offline
Bei Game-Init: LG_API.startAttempt(levelNum) (legt Server-Attempt an)
RAF-Loop drainiert game.pendingAnalytics alle 2 Sekunden → POST an /api/logistik-analytics
onStateChange → LEVEL_SUCCESS/LEVEL_FAILED: LG_API.endAttempt(...) mit finalBalance + Kennzahlen, danach letzter Drain

5. Savegame-Binding — fertig

Save-/Load-Buttons jetzt Server-first:

Save → POST /api/logistik-saves mit serialisiertem Game + lokaler localStorage-Backup (beide immer)
Load → GET /api/logistik-saves?slot=1, Fallback auf localStorage, Confirm-Dialog, LogistikEngine.deserialize() + Listener-Preserve (wichtig: serialize strippt _stateChangeListeners, sonst waere der EndScreen-Hook nach dem Laden weg)

Toasts in Leichter Sprache integriert.

Was ich nicht getestet habe

Ich habe keinen Browser. Alle Endpoints lintet XAMPP-PHP sauber, alle JS-Edits sind syntaktisch konsistent, aber den echten Flow (Login → startAttempt → Analytics-POST → endAttempt) konnte ich nicht durchspielen. Wenn du in deinem Review drei Dinge pruefen wuerdest:

Geht das ggs_session-Cookie wirklich mit, wenn die Seite unter /App/logistik?level=1 liegt? Ich habe credentials: 'same-origin' gesetzt — sollte reichen.
Das neue pendingAnalytics in createGame() — falls ein alter Savegame geladen wird ohne dieses Feld, initialisiert _pushAnalyticsEntry es lazy. Sollte okay sein, aber doppelt pruefen.
endAttempt wirft den attemptId aus dem Aktivslot; start ist nicht idempotent (ueberschreibt ggf. einen noch offenen Attempt). Das ist Absicht (Reload startet neu), aber sag Bescheid falls du strikter willst.

Was du tun kannst

Admin-UI gegen admin-fields.json bauen (du sagtest parallel)
Meister anpingen, damit lg_contracts_log-Schema auf Produktion wandert
Review der drei PHP-Endpunkte — besonders: game_saves-Kooptierung ok oder Eigen-Tabelle?
Glossar: Pflege-Queue entkoppelt, Fallback in game.html trägt

Nach Atlas-Review

Wenn dein Review durch ist und Meister das Schema deployed hat, meine Reihenfolge:

Deploy-Request an Meister (Produktionsserver + V2)
Falls Zeit: naechstes Modul (Thomas-Prio: Erdbeben oder Energiemix)

— Logistik

4.7 KiB Raw Blame History