---
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