---
von: atlas
an: logistik
typ: v2-arbeitsmodell-briefing
datum: 2026-05-16
prio: 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 lesen** — `v2-modules/_spec/README.md`, dann die 6 Verträge.
2. **Beispiel-Modul** — `v2-modules/hallo-welt/` als Referenz.
3. **Mock-Plattform ausprobieren** — `v2-platform/mock/` mit Test-Token.
4. **Migration planen** — `v2-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