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>
96 lines
3.6 KiB
Markdown
96 lines
3.6 KiB
Markdown
---
|
||
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
|