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>
87 lines
3.0 KiB
Markdown
87 lines
3.0 KiB
Markdown
---
|
||
von: atlas
|
||
an: klima
|
||
typ: v2-arbeitsmodell-briefing
|
||
datum: 2026-05-16
|
||
prio: hoch (Arbeitsmodell-Wechsel)
|
||
---
|
||
|
||
# V2-Arbeitsmodell — Briefing für Klima
|
||
|
||
Hallo Klima-Instanz.
|
||
|
||
Thomas und ich (Atlas) haben am 16.05.2026 das V2-Arbeitsmodell
|
||
finalisiert. Das ändert ab sofort, wie du dein Modul weiterentwickelst.
|
||
|
||
## Kurz: Was ist neu?
|
||
|
||
V2-Module sind **standalone-Apps** mit klarer Schnittstelle zur
|
||
Plattform. Statt im Atlas-Workspace zu graben (was zu Identitäts-
|
||
verwirrungen geführt hat), lebst du **nur in deinem eigenen
|
||
Sandkasten**:
|
||
|
||
```
|
||
v2-modules/klima/ ← dein Sandkasten (existiert noch nicht — du legst an)
|
||
v2-modules/_spec/ ← Schnittstellen-Spec, read-only
|
||
```
|
||
|
||
Du baust **nichts** in `v2-platform/` und nichts in anderen
|
||
`v2-modules/<modul>/`-Ordnern. Atlas integriert dein fertiges Paket
|
||
am Ende.
|
||
|
||
## Was du JETZT NICHT tun sollst
|
||
|
||
- ❌ Code in `App/sims/klima/` ändern (V1 ist live, nur Bugfixes)
|
||
- ❌ V2 in alten Pfaden wie `App/sims/klima-v2/` bauen — Konvention abgelöst
|
||
- ❌ Andere Module/Plattform-Files anfassen
|
||
- ❌ Eigene Auth/Login bauen (Plattform liefert Token)
|
||
- ❌ Direkten DB-Zugriff auf `students`/`classes`/`teachers` — nur via API
|
||
|
||
## Was du JETZT TUN sollst
|
||
|
||
1. **Spec lesen** — `v2-modules/_spec/README.md` zuerst, dann die 6 Verträge.
|
||
2. **Beispiel-Modul ansehen** — `v2-modules/hallo-welt/` ist die lebende Referenz.
|
||
3. **Mock-Plattform ausprobieren** — `v2-platform/mock/` mit Test-Token.
|
||
4. **Migration planen** — `v2-modules/_spec/migration-from-v1.md`,
|
||
Notizen in `v2-modules/klima/docs/MIGRATION-NOTES.md`.
|
||
|
||
## Wichtige Pflichten in V2
|
||
|
||
- **Easy-Sprache** als zweites i18n-File Pflicht
|
||
- **Live-Telemetry** Pflicht (Heartbeat / Milestones / Stuck)
|
||
- **A11y WCAG 2.1 AA** Pflicht ab Tag 1 (Kontraste, Keyboard, ARIA, High-Contrast)
|
||
- **Sprachregeln** (keine Spielsprache)
|
||
- **iPad-Pattern** (1180×820, dvh, safe-area-inset, sticky Aktions-Buttons)
|
||
- **Bildstil** (Flat Scandinavian)
|
||
|
||
## Klima-spezifische Hinweise
|
||
|
||
Klima hat das größte Modul (3D-Simulation, Save-Cleanup-TODO offen).
|
||
Wenn du V2 baust, ist das eine gute Gelegenheit, den Save-Cleanup
|
||
gleich richtig zu integrieren via `module_state_v2`-Endpoint
|
||
(siehe Output-API).
|
||
|
||
Glossar-Begriffe (Klimazone, Anbaugrenze, etc.) deklarierst du in
|
||
`manifest.json` als `glossarSchwerpunkte` (max ~10 Schlüssel-Begriffe).
|
||
Alles weitere holst du on-demand via `/api/glossary/<slug>`.
|
||
|
||
Canvas/WebGL: A11y ist hier besonders schwierig — bitte Tastatur-
|
||
Modus mitdenken, mind. eine Audio-/Text-Alternative für die
|
||
Schlüssel-Visualisierung.
|
||
|
||
## Atlas-Status (für deine Planung)
|
||
|
||
- V2-Spec liegt als v1.0-draft vor — Thomas ist mitten im Review
|
||
- V2-Plattform-Skelett (PHP-API, DB-Schema) ist gebaut
|
||
- Mock-Plattform läuft lokal
|
||
- `/v2beta` auf Server **noch nicht** eingerichtet
|
||
- Reihenfolge der Modul-Migration: Klima vermutlich Welle 4 (zuletzt, weil komplex)
|
||
|
||
## Fragen / Antworten
|
||
|
||
Sammle Punkte gebündelt in `_inbox/zentrale/`. Spec-Anpassungs-
|
||
Vorschläge: bitte mit genauer Spec-Stelle.
|
||
|
||
Viel Erfolg.
|
||
— Atlas
|