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>
GeoGraSim V2-Plattform
Status: Skelett-Build (2026-05-16, Atlas-Nachtschicht) Lebensstand: lokal, nicht deployed, kein V1-Eingriff
Dieses Verzeichnis enthält die V2-Plattform — Cockpit, Lehrer-/
Schüler-Bereich, API-Schicht, Telemetry-Aufnahme. Module liegen
parallel in ../v2-modules/<slug>/ und werden über die in
../v2-modules/_spec/ definierte Schnittstelle integriert.
Aufbau
v2-platform/
├── README.md ← du bist hier
├── .env.example ← Template für lokale .env.local
├── .gitignore
├── .htaccess ← Apache-Rewrite für /v2beta
├── db/
│ └── init.sql ← additive V2-Tabellen (IF NOT EXISTS)
├── php/
│ ├── config.php ← Konstanten, Pfade, ENV-Loader
│ ├── bootstrap.php ← Common-Includes, Error-Handling
│ ├── lib/
│ │ ├── db.php ← PDO-Wrapper
│ │ ├── auth.php ← Session-Token (JWT-light)
│ │ ├── response.php ← JSON-Response-Helpers
│ │ └── validation.php ← Request-Validation
│ └── api/
│ ├── student/me.php ← GET — Profil
│ ├── module/state.php ← GET + PUT — Resume-State
│ ├── result.php ← POST — Endergebnis
│ ├── telemetry.php ← POST — Heartbeat/Milestone/Stuck
│ ├── artifact.php ← POST — Datei-Upload
│ ├── glossary.php ← GET — Glossar-Eintrag
│ ├── lehrplan/anker.php ← GET — Lehrplan-Anker
│ └── teacher/live-stream.php ← Server-Sent-Events für Cockpit
├── assets/
│ ├── css/
│ │ └── design-system-v2.css ← V2-Tokens inkl. A11y / High-Contrast
│ └── js/
│ └── (kommt später)
├── lib/
│ └── telemetry-client.js ← (kommt später) ESM-Bibliothek für Module
├── mock/ ← Standalone-Mock für Modul-Entwicklung
└── tools/
├── conformance-check/ ← (kommt später) Modul-Validierung
└── asset-gen/ ← (kommt später) DALL-E/ElevenLabs-Wrapper
Lokal laufen lassen
.env.examplenach.env.localkopieren und Werte eintragen- DB-Schema einspielen:
(Idempotent — kann mehrfach laufen, alle CREATE/ALTER mit IF NOT EXISTS)
mysql -u root -p geograsim < db/init.sql - XAMPP Apache starten
- Im Browser:
http://localhost/geograsim/v2-platform/php/api/student/me(sollte 401 ohne Token zurückgeben)
Für komplette V2-Integration siehe später kommende Doku zu Cockpit/Login.
Was bereits funktioniert
- DB-Schema (alle V2-Tabellen)
- 8 API-Endpoints als funktionierende Skelette mit Auth, Validierung, Responses
- Mock-Plattform unter
mock/für Modul-Entwicklung - A11y-Tokens in design-system-v2.css
Was fehlt (TODO)
- Cockpit-UIs (Lehrer/Schüler) — folgt nach Spec-Stable
- Login-Seite und Token-Issuance — derzeit Test-Token im Mock
- Konformitäts-Check-Skript
- Asset-Generierungs-Tools (DALL-E/ElevenLabs-Proxy)
- Telemetry-Client-JS-Bibliothek
- Live-Stream-Push für Lehrer-Dashboard (SSE)
Wichtig für Mit-Atlas-Sessions
- V1 NICHT anfassen, kein Deploy ohne Thomas-Go
- DB-Änderungen sind additiv (
*_v2-Suffix, IF NOT EXISTS) - Authentifizierung läuft über Stateless-JWT-light (HMAC-SHA256), kein Session-State auf Plattform-Seite zwingend nötig
- Spec ist verbindlich — siehe
../v2-modules/_spec/