Adminator
1e51ef7def
- Konzept/, didaktik_geografie/, didaktik_simulation/, v2-modules/, v2-platform/ - 12 code-workspace-Files - STATUS-*.md - viele M/D/R-Änderungen an bereits getrackten Files - .gitignore verstärkt: **/.humaninput/, **/secret_keys.txt Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
50 lines
1.4 KiB
Markdown
50 lines
1.4 KiB
Markdown
# 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).
|