Datenbank und Dateien

Verzeichnisstruktur

<InstallRoot>\
|-- TruckSimLogBook.exe          ausführbare App
|-- appsettings.json             ausgelieferte Standardwerte
|-- Defaults\                    mitgelieferte Kataloge
|-- config\
|   |-- settings.json            Benutzereinstellungen
|   |-- ets2-city-countries.json ETS2-Stadt-/Länderregister
|   |-- ats-city-countries.json  ATS-Stadt-/Bundesstaatregister
|   |-- ets2-city-supplement.json ETS2-Ergänzungen
|   |-- ets2-trailer-names.json  ETS2-Trailer-Namen
|   `-- ats-trailer-names.json   ATS-Trailer-Namen
|-- data\
|   `-- trucksimlogbook.db        SQLite-Fahrtenbuch
|-- logs\
|   |-- runtime_YYYYMMDD.txt
|   `-- crash_*.txt
|-- backups\                     Sicherungen vor Ortskorrekturen
|-- cache\
|-- temp\
|-- CHANGELOG.txt
|-- LICENSE
|-- NOTICE
`-- THIRD-PARTY-NOTICES.md

Konfiguration

appsettings.json enthält Standardwerte. Persönliche Änderungen werden getrennt in config/settings.json gespeichert, damit Updates sie nicht überschreiben.

Die SCS-Stadtregister werden bei Updates aktualisiert. Eigene Mod-Zuordnungen stehen separat in config/*-city-overrides.json und bleiben erhalten. Seit 0.13.1 liegen sämtliche Laufzeitdaten im Installationsordner. Frühere externe Profile werden beim ersten Start einmalig übernommen.

Wichtige Gruppen:

• database
• telemetry
• ui
• driver
• costs
• launchers

SQLite-Datenbank

Die Datenbank ist die verbindliche Quelle für Logbuch und Statistiken. Sie sollte nicht während einer laufenden App mit externen Werkzeugen verändert werden.

Seit 0.13.18 ergänzt der Start idempotent nullable Spalten damage_tracking, damage_override und active_session_state; außerdem trailer_damage seit 0.13.10. Historische fehlende Messungen bleiben unbekannt. Beobachtete neue Schäden und manuelle Kennzeichnung sind getrennt vom Abschluss gespeichert. Ein aktiver Checkpoint ermöglicht passende Wiederaufnahme; abgeschlossene Touren behalten den Schadensnachweis ohne aktiven Checkpoint. Tourbezogene Schäden.

JSON-Exporte enthalten Kennzeichnung/Override und bekannte Tour-Zunahmen, keine internen Checkpoints. Eine vollständige DB-Sicherung bleibt nötig; JSON ist kein implementierter Wiederherstellungsweg. Vor externen Eingriffen App schließen und eine konsistente SQLite-Sicherung erstellen.

Logs

Runtime-Logs protokollieren Startphasen, Telemetriezustände, Auftragsübergänge, Kostenereignisse und Warnungen. Crash-Logs enthalten Ausnahme und Stacktrace.

Logs können als Textdatei in Support-Chats geteilt werden. Vorher persönliche Pfade oder sensible Angaben prüfen.

Zurücksetzen

Ein vollständiges Zurücksetzen ist durch Umbenennen der Benutzerkonfiguration und Datenbank bei geschlossener App möglich. Die Originaldateien zunächst als Sicherung behalten.