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>
81 lines
2.8 KiB
Markdown
81 lines
2.8 KiB
Markdown
---
|
|
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
|