# Mock-Plattform für Modul-Entwicklung

Standalone-Sandbox, die alle Spec-Endpoints simuliert — **ohne DB**,
**ohne Login**. Modul-Instanzen können ihre V2-Sims gegen die Mock
testen, bevor Atlas integriert.

## Aktivieren

Ein Modul ruft die Mock einfach unter dem Pfad `mock/api/...` auf
statt unter `php/api/...`:

```
http://localhost/geograsim/v2-platform/mock/api/telemetry
```

## Test-Token holen

```
http://localhost/geograsim/v2-platform/mock/issue-token.php?student=42
http://localhost/geograsim/v2-platform/mock/issue-token.php?teacher=1&class=42
```

Liefert ein 24h-Token. Standardmäßig sind ein paar Test-Schüler und
eine Test-Klasse vorgegeben (siehe `lib/test-data.php`).

## Mocks-Verhalten

- **GET-Endpoints**: liefern fixe, plausible Daten
- **POST/PUT-Endpoints**: validieren Pflichtfelder, loggen die Anfrage
  in `mock/uploads/log.jsonl`, geben 200/201 zurück
- **Telemetry**: kein Rate-Limit, keine 4 KB-Grenze (für Entwicklung)
- **Result**: speichert *nicht* in DB, gibt Fake-`assessmentId` zurück

## Logs ansehen

Alle eingegangenen POST-Bodies werden geloggt:

```
v2-platform/mock/uploads/log.jsonl
```

Eine Zeile pro Event als JSON. Mit `tail -f` live mitverfolgen während
das Modul läuft — sehr hilfreich beim Telemetry-Tuning.

## Achtung

Die Mock ersetzt **nicht** die echten Plattform-Endpoints im Konformitäts-
Check. Vor Lieferung muss das Modul gegen die echte Plattform getestet
werden (mit DB-Schema + Test-Schüler).