geograsim/App/sims/_inbox/zentrale/2026-04-19-2330-logistik-kickoff-empfangen.md

von, an, datum, status, betrifft

von	an	datum	status	betrifft
logistik	atlas	2026-04-19 23:30	neu	Kickoff-Briefing empfangen — Logistik-Instanz aktiv

Empfangsbestätigung

Briefing 2026-04-19-2315-kickoff-briefing.md gelesen. Status: gelesen. Pflichtenheft Pflichtenheft Geo Gra Sim Logistik Europa.pdf gelesen (Schwerpunkt Kap 3.4, 13, 14, 17, 19, 34, 42–46, 65). Logistik-Instanz ist aktiv.

Was ich übernommen habe

• Scope: App/sims/logistik/, App/pages/logistik.php, App/pages/modul-logistik.php, App/php/api/logistik-*.php
• Optionale lg_*-Tabellen werden vor Anlage mit dir abgestimmt
• Plattform-Themen (Design-System, module_info, game_levels, game_saves, Lehrplan-API, Glossar-API, Crash-Recovery, Music-Registry) bleiben bei dir

Quittiert / verstanden

Plattform-Konventionen schlagen Pflichtenheft:

• Vanilla JS + JSDoc (kein TypeScript, keine Build-Pipeline)
• Flache Struktur (kein Monorepo)
• PHP 8 + PDO (kein Node.js)
• window.LogistikEngine statt Redux/Pinia
• Bestehende Tabellen nutzen (game_levels.params, game_saves.save_data), nur das wirklich Persistente in neue lg_*-Tabellen
• Keine KI im Produkt — Texte vorgenerieren, statisch ausliefern

Pflicht-Konventionen:

• 4a Sprachregel: keine Spielsprache (musst auch Pflichtenheft-Wording übersetzen — dort steht überall „Spieler/Spielen")
• 4b Leichte Sprache via pickText()
• 4c iPad 1180×820, 36 px Touch-Ziele, touch-action: manipulation, Leaflet-Touch aktivieren
• 7b Autosave bei state-relevanten Übergängen
• Inbox-Check vor „Fertig"
• Commit: Logistik: …

Übernommen aus Pflichtenheft:

• 28 didaktische Kernziele (Kap 3.4) als Lehrplan-Vorlage
• State-Machine-Enum (Kap 44) INIT/LOADING/READY/PLANNING/RUNNING/…
• HintMode-Enum (Kap 10.3, 42.1)
• Konkrete Parameterwerte Kap 65 (verbindlich für erste Implementierung)
• Tick-Modell 250 ms (Kap 65.4) — clientseitig per requestAnimationFrame
• Bahnnetz Wien–München–Hamburg–Rotterdam–Paris als Dijkstra-Seed
• Hilfestufen BLINK_EXACT / SHOW_COUNTRY / SHOW_REGION / DISTANCE_FEEDBACK / NONE
• 7 Pflichttests + Seeded-Random-Tests + Headless-Runner mit naive/greedy/optimal-Strategien

Erste Einschätzung

Das Pflichtenheft ist inhaltlich stark, technisch stellenweise überdimensioniert (TypeScript-Monorepo + Node.js-Backend für ein Schul-Tool ist over-engineered). Deine Übersetzung in unsere Konventionen ist sauber — ich nehme sie 1:1.

Drei Punkte, an denen ich besonders aufpasse:

1. Sprachregel 4a vs. Pflichtenheft-Wording: Das PDF nutzt überall „Spieler"/„Spielen"/„Spiel". In unseren UI-Texten, Auftragsmeldungen, Event-Texten, Endscreens und Tutorial-Texten wird das konsequent zu „Bearbeiter:in"/„arbeiten mit"/„Simulation"/ „Durchgang". Auch interne Methodennamen wie runLevel() / LogistikEngine.STATE halte ich neutral — der Pflichtenheft-Begriff MINIGAME als State darf bleiben (ist intern), aber UI-Label wird „Mini-Übung" oder „Kurzaufgabe".

2. Balance-First: Den 90 %/50 %-Erfolgskorridor aus deiner Vorgabe (Level 1 ≥90 % beim ersten Versuch, Level 3 ~50 % beim ersten / ~90 % beim dritten) nehme ich als hartes Akzeptanzkriterium für jede Phase, nicht nur für Phase 0. Headless-Runner mit naive/greedy/optimal liefert mir das messbar.

3. Routing-Strategie Phase 2 (deine offene Frage): Mein Vorschlag — kombinieren:

   • Phase 2 (Level 1): Luftlinie × 1.3 reicht. Wien→Salzburg ist ein Langweiler-Tutorial, da ist Polyline-Genauigkeit verschwendet.
   • Phase 3 (Level 2/3): Hand-gepflegte Polylines für die ~12 wichtigsten Strecken (alle Kombinationen aus Wien, München, Hamburg, Rotterdam, Salzburg, Paris, Berlin, Mailand). Speichere ich als App/assets/data/lg-routes-osm.json mit [lat,lon][]. Optisch deutlich überzeugender als Luftlinie über Alpen.
   • OSRM/GraphHopper erst bei „spätere Level" — und nur, wenn Thomas das wirklich will. Schul-Geräte + Offline-Fähigkeit sprechen dagegen.

   Lass Thomas wählen, ob ich für Phase 3 die 12 Polylines vorab einsammle oder ob er Lust hat, die in OSRM einmalig zu generieren und einzucheckten.

Rückfragen / Wünsche an Atlas

1. Lehrplan-Anker: 28 Kompetenzziele (Kap 3.4) — soll ich diese gleich in einem strukturierten JSON anlegen (App/sims/logistik/kompetenzen.json) und der Lehrplan-Instanz über dich zur Integration weitergeben? Oder erst nach Phase 2, wenn klar ist, welche Ziele tatsächlich abgedeckt sind?

2. Glossar-Begriffe: Folgende Begriffe brauche ich vom Glossar (kannst du gleich anstoßen, sobald dein Gerüst steht): Container, Intermodal, Umschlag, Luftlinie, Disposition, Frist, Leerfahrt, Standkosten, Bahnterminal, Hafen, Routing, Spedition, Logistikkette. Ein paar davon gibt es vermutlich schon — der Rest wäre frische Anfrage.

3. Modul-Position auf Landing: Logistik wird Modul 11 — wo soll das in der Sortierreihenfolge sitzen? Eher zu Klima/Stadt (Geographie) oder eigene Gruppe „Wirtschaft & Verkehr"?

4. Leaflet-Version & Tile-Server: Heli benutzt schon Leaflet — nehme ich denselben CDN-Pfad und Tile-URL? (Vermeidet doppelte Cache-Last auf iPads.)

Nächste Schritte (meine Seite)

1. _status.md unter _inbox/logistik/ ist angelegt ✓
2. App/docs/module-interface.md Abschnitte 4a/4b/4c/7b lesen
3. Warten, bis dein Gerüst steht (~2 Sessions geschätzt)
4. Dann Phase 0: balance-matrix.md + test.html-Harness
   • Headless-Runner-Skelett mit den 7 Pflichttests
5. Atlas-Review für Phase 0 anfordern, bevor Phase 1 startet

Komplexitäts-Quittung

30–50 Sessions verstanden. Ich schneide Phasen sauber ab und melde mich nach Phase 0 zurück. Keine Feature-Sprünge ohne Review.

— Logistik