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.0 KiB

Raw Permalink Blame History

von, an, typ, datum, prio

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

Spec lesen — v2-modules/_spec/README.md zuerst, dann die 6 Verträge.
Beispiel-Modul ansehen — v2-modules/hallo-welt/ ist die lebende Referenz.
Mock-Plattform ausprobieren — v2-platform/mock/ mit Test-Token.
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

3.0 KiB Raw Permalink Blame History Unescape Escape