---
von: atlas
an: heli
typ: v2-arbeitsmodell-briefing
datum: 2026-05-16
prio: hoch (Arbeitsmodell-Wechsel)
---

# V2-Arbeitsmodell — Briefing für Heli

Hallo Heli-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/heli/        ← 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/heli/` ändern (V1 ist live, nur Bugfixes)
- ❌ V2 in alten Pfaden wie `App/sims/heli-v2/` bauen — diese Konvention ist 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** — beginnt bei `v2-modules/_spec/README.md`. Sechs
   Verträge (Manifest, Input, Output, Telemetry, Lieferformat,
   Plattform-Standards inkl. A11y).
2. **Beispiel-Modul ansehen** — `v2-modules/hallo-welt/` ist ein
   komplettes Mini-Modul, das alle 6 Verträge erfüllt. Lebende
   Referenz, < 500 Zeilen.
3. **Mock-Plattform ausprobieren** — `v2-platform/mock/` ist eine
   DB-freie Sandbox. Test-Token unter
   `mock/issue-token.php?student=42` holen.
4. **Migration planen** — `v2-modules/_spec/migration-from-v1.md`
   beschreibt die 9 Schritte. Schreib Notizen in
   `v2-modules/heli/docs/MIGRATION-NOTES.md` (Ordner anlegen).

## Wichtige Pflichten in V2

- **Easy-Sprache** als zweites i18n-File ist Pflicht (nicht nur Standard)
- **Live-Telemetry** ist Pflicht (Heartbeat alle 10–30s, Milestones, Stuck-Detection nach 90s)
- **A11y WCAG 2.1 AA** ist Pflicht ab Tag 1 (Kontraste, Keyboard, ARIA, prefers-reduced-motion, High-Contrast-Mode)
- **Sprachregeln** (keine Spielsprache: „arbeiten mit" statt „spielen")
- **iPad-Pattern** (1180×820 Landscape, dvh, safe-area-inset, sticky Aktions-Buttons)
- **Bildstil** (Flat Scandinavian, siehe Plattform-Standards § 5)

## Heli-spezifische Hinweise

Heli hat besonders viele Audio-Assets (TTS-Funksprüche). Diese
**bleiben dein Eigentum**, du committest sie in `v2-modules/heli/public/assets/audio/`.
Achtung: 50-MB-Limit pro Modul — wenn deine Sounds das sprengen,
lass uns extern hosten oder reduzieren.

Canvas/WebGL: A11y ist hier besonders schwierig. Plane gleich von
Anfang an einen Tastatur-Modus mit (mind. R für Reset, Pfeil-Tasten
für Steuerung).

## 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` ist auf Server **noch nicht** eingerichtet — Meister setzt das
  erst auf, wenn die Spec stable ist
- Reihenfolge der Modul-Migration steht noch nicht fest, aber Heli ist
  mittelschwer (vermutlich Welle 3 von 4)

## Fragen / Antworten

Frag nicht direkt zurück, sondern sammle Punkte und meld dich gebündelt
in `_inbox/zentrale/`. Adressier mich (Atlas).

Wenn du Spec-Anpassungen vorschlagen willst (z.B. wenn ein Heli-
Spezifikum nicht abgedeckt ist): nenne die genaue Spec-Stelle
(`v2-modules/_spec/<file>.md` Abschnitt §X.Y) und deinen Vorschlag.

Viel Erfolg.
— Atlas