How to work on repos

Diese Seite erklärt, wie man an den EcoSimLab-Repos arbeitet — für externen und internen Gebrauch gleichermaßen. Extern: für Open-Source-Beitragende, die an einem einzelnen Tool mitarbeiten wollen, ohne den ganzen Stack aufzusetzen. Intern: als Übersicht, die sonst nur mündlich weitergegeben wird.

Im Kern ist sie eine Link-/Klon-Sammlung: pro Set bzw. Dev-Set, welche Repos man zusammen klont. Ab dem Klonen übernehmen die READMEs/Docs der einzelnen Repos — diese Seite wiederholt keine Installations- oder Setup-Schritte (Leitprinzip: die Tool-Seiten bewerben, die Docs instruieren, keine Duplikation — dasselbe Prinzip, hier eine Ebene höher).

Die konkreten Klon-Befehle und Repo-URLs fehlen hier noch bewusst: die Tool-Repos liegen aktuell im internen GitLab (git.imis.uni-luebeck.de) und sind noch nicht öffentlich. Sobald die Repos veröffentlicht sind, kommen pro Eintrag die git clone-Links dazu.

Dev-Sets

Nutzungssets (Labor, Video, LEM) bilden fertige Anwendungsfälle für Forschende ab. Dev-Sets sind kleinere, zweckgebundene Tool-Kombinationen zum Entwickeln und Testen der Integration zwischen zwei oder mehr Tools — nicht dazu gedacht, eine Studie zu fahren.

Wichtiger Hintergrund: EcoSimLabPy ohne BeamNG ergibt für echtes Fahren keinen Sinn (die beiden sind für reale Daten praktisch ein Paket). „Tool X + EcoSimLabPy [+ BeamNG]“ ist deshalb meist einfach der volle Live-Stack, kein eigenständiges, kleineres Dev-Set. Der eigentliche Hebel für leichtgewichtige Dev-Sets ist ein BeamNG-Mock, der Fahrdaten direkt per MQTT bereitstellt und damit BeamNG.tech und EcoSimLabPy zusammen ersetzt (siehe offene Punkte unten).

Die folgende Liste ist ein Entwurf — drei der fünf Einträge hängen noch an unbestätigten Annahmen über den Mock.

1 — SCA ↔ BeamNG (voller Stack) · bestätigt

• Repos: StudyControlApp · EcoSimLabPy · echtes BeamNG.tech
• Zweck: MQTT-Anbindung gegen einen echten Datenstrom testen. Von Jan bestätigtes Beispiel.

2 — SCA solo · bestätigt

• Repos: nur StudyControlApp (keine Datenquelle)
• Zweck: Frontend/Backend/UI der StudyControlApp entwickeln, ohne dass überhaupt Fahrdaten fließen müssen. Bestätigt (Jan: „SCA kann man auch alleine entwickeln“).

3 — Beliebiger MQTT-Konsument ↔ BeamNG-Mock · unbestätigt (plausibel)

• Repos: ein MQTT-Konsument (z. B. EcoInterfaces oder StudyControlApp) · BeamNG-Mock
• Zweck: Leichtgewichtiger Integrationstest ohne echtes BeamNG.tech/EcoSimLabPy — der Mock übernimmt beide auf einmal.
• Offen: Hängt daran, dass der BeamNG-Mock existiert und nutzbar ist (noch ungeklärt, siehe unten).

4 — Regler-Tuning braucht den echten Stack · unbestätigt (plausibel)

• Repos: EcoMPC bzw. Steering-Controller · Fahrzeugmodelle · EcoSimLabPy · echtes BeamNG.tech
• Zweck: Geschlossener Regelkreis — der Regler reagiert auf die echte Physik-Antwort. Ein Mock, der nur Daten abspielt, kann darauf vermutlich nicht reagieren, ist also kein Ersatz.
• Offen: Die Annahme „Mock reagiert nicht auf Regler-Ausgabe“ ist noch mit dem Team zu prüfen.

5 — Cockpit-Display-Replay ↔ echtes EcoInterfaces-Repo · bestätigt (offener Task)

• Repos: Cockpit-Display-Replay · EcoInterfaces (eco-displays) — kein BeamNG nötig
• Zweck: Bekannter ausstehender Task — das Replay-Plugin auf das externe eco-displays-Package umstellen anstelle der alten internen Kopie.

Offene Punkte

Diese Seite ist noch ein Gerüst; Umfang und Inhalt sind bewusst als offen markiert (bekannter offener Punkt aus Phase 0). Konkret noch zu klären:

• BeamNG-Mock genauer klären — kein Repo gesichtet, bisher nur mündlich erwähnt (dokumentierte Lücke im Inventar). Publiziert vermutlich auf denselben MQTT-Topics wie EcoSimLabPy (from_beamng_py/beamng_state u. a.), aber mit synthetischen statt echten Simulator-Daten. Bekommt er einen eigenen Tool-Eintrag? Ist er selbst nachnutzbar (z. B. als lizenzfreier Einstieg für EcoInterfaces ohne Simulator-Lizenz)?
• Dev-Sets 3 und 4 hängen an unbestätigten Annahmen über den Mock (welche Topics, ob nur Playback oder auch reaktiv) — mit Jan/Team klären.
• Konkrete Repo-URLs / Klon-Befehle ergänzen, sobald die Repos öffentlich sind.
• Tool-Docs und Set-Docs (die beiden anderen Docs-Kategorien) haben noch keinen Inhalt — sie erhalten Seiten, sobald das Material dafür vorliegt.