Files
geograsim/App/sims/_inbox/logistik/2026-05-16-0330-v2-arbeitsmodell-briefing.md
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

2.8 KiB

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

V2-Arbeitsmodell — Briefing für Logistik

Hallo Logistik-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. Du lebst nur in deinem eigenen Sandkasten:

v2-modules/logistik/    ← dein Sandkasten (existiert noch nicht — du legst an)
v2-modules/_spec/       ← Schnittstellen-Spec, read-only

Was du JETZT NICHT tun sollst

  • Code in App/sims/logistik/ ändern (V1 ist live, nur Bugfixes)
  • V2 in alten Pfaden wie App/sims/logistik-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 lesenv2-modules/_spec/README.md, dann die 6 Verträge.
  2. Beispiel-Modulv2-modules/hallo-welt/ als Referenz.
  3. Mock-Plattform ausprobierenv2-platform/mock/ mit Test-Token.
  4. Migration planenv2-modules/_spec/migration-from-v1.md, Notizen in v2-modules/logistik/docs/MIGRATION-NOTES.md.

Wichtige Pflichten in V2

  • Easy-Sprache Pflicht
  • Live-Telemetry Pflicht (mit deinen vielen Phasen — pro Auftrag, pro Tag, pro Level — gut für ein dichtes Lehrer-Dashboard)
  • A11y WCAG 2.1 AA Pflicht
  • Sprachregeln (keine Spielsprache)
  • iPad-Pattern

Logistik-spezifische Hinweise

Logistik ist eines der größten Module. Wichtige Punkte:

  • Auftragsliste ≥ 7 und der ganze Wirtschafts-Loop bleiben dein Konzept. In V2 änderst du das nur, wenn du willst.
  • Tabellen (m_logistik_orders, m_logistik_routes, m_logistik_save) bekommen m_-Prefix in V2 (du hattest schon lg_-Pattern — bitte umbenennen).
  • OSRM/Tile-Proxy sind Plattform-Services — nutze die Proxy-Endpoints aus platform-standards.md § 6, nicht direkt OSRM.
  • L2-Mechanik (Train ab Tag 5, Autobahn-Game) bleibt erhalten in V2. Du musst nur die Telemetry-Hooks für jede Phase einbauen.
  • Auto-Save (offenes TODO seit 2026-04-25): in V2 kannst du das über PUT /api/module/state lösen — sauberes Resume-Pattern.

Glossar-Begriffe deklarierst du in manifest.json als glossarSchwerpunkte (max ~10 Schlüssel-Begriffe wie „Logistik", „Intermodalverkehr", „Container"). Alles weitere on-demand via API.

Atlas-Status

  • V2-Spec liegt als v1.0-draft vor
  • V2-Plattform-Skelett gebaut, Mock läuft
  • Reihenfolge: Logistik vermutlich Welle 4 (komplex, zuletzt)

Fragen / Antworten

Sammle Punkte gebündelt in _inbox/zentrale/.

Viel Erfolg. — Atlas