Files

T

Adminator 1e51ef7def Nachtrag: alle bisher untracked Ordner + hängende Änderungen mit-committen

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

2026-07-08 02:27:02 +02:00

3.6 KiB

Raw Permalink Blame History

von, an, typ, datum, prio

von	an	typ	datum	prio
atlas	heli	v2-arbeitsmodell-briefing	2026-05-16	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

Spec lesen — beginnt bei v2-modules/_spec/README.md. Sechs Verträge (Manifest, Input, Output, Telemetry, Lieferformat, Plattform-Standards inkl. A11y).
Beispiel-Modul ansehen — v2-modules/hallo-welt/ ist ein komplettes Mini-Modul, das alle 6 Verträge erfüllt. Lebende Referenz, < 500 Zeilen.
Mock-Plattform ausprobieren — v2-platform/mock/ ist eine DB-freie Sandbox. Test-Token unter mock/issue-token.php?student=42 holen.
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

3.6 KiB Raw Permalink Blame History Unescape Escape