simono41/train-tracker
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
20 commits 1 branch 0 tags 106 KiB
Go 99.2%
Dockerfile 0.8%
Find a file
simono41 0dccca5b03 Dateien nach „/“ hochladen
2025-01-20 00:38:52 +01:00
.dockerignore first commit 2024-09-28 13:00:29 +02:00
.gitignore first commit 2024-09-28 13:00:29 +02:00
docker-compose.yml add better logging 2025-01-19 20:06:39 +01:00
Dockerfile first commit 2024-09-28 13:00:29 +02:00
go.mod first commit 2024-09-28 13:00:29 +02:00
go.sum first commit 2024-09-28 13:00:29 +02:00
init.sql Hinzufügen von der Destination des Zuges 2025-01-19 17:58:45 +01:00
LICENSE add early version without tracking with using db-vendo-client 2025-01-19 02:44:11 +01:00
main.go Überflüssige WHERE Statements entfernt 2025-01-20 00:25:25 +01:00
main.go.old add early version without tracking with using db-vendo-client 2025-01-19 02:44:11 +01:00
README.md Hinzufügen einer Sleeper Function und Anpassung der README 2025-01-19 16:48:15 +01:00
Train Tracker-1737329906903.json Dateien nach „/“ hochladen 2025-01-20 00:38:52 +01:00

README.md

Train Tracker

Beschreibung

Train Tracker ist eine in Go geschriebene Anwendung, die Echtzeitinformationen über Zugbewegungen verfolgt und speichert. Sie nutzt die DB-Vendo-API, um Abfahrtsinformationen von spezifizierten Bahnhöfen abzurufen, berechnet die aktuelle Position der Züge basierend auf ihrer Route und speichert diese Informationen in einer MariaDB-Datenbank.

Funktionen

  • Abrufen von Zugabfahrten für mehrere Bahnhöfe
  • Berechnung der aktuellen Zugposition basierend auf Abfahrtszeit und Routeninformationen
  • Speichern und Aktualisieren von Zuginformationen in einer MariaDB-Datenbank
  • Erfassung und Analyse von Verspätungsdaten
  • Automatisches Löschen veralteter Einträge
  • Tägliche Übertragung und Aggregation von Verspätungsstatistiken

Voraussetzungen

  • Go 1.15 oder höher
  • MariaDB
  • Zugang zur DB-Vendo-API

Installation

  1. Klonen Sie das Repository:

    git clone https://code.brothertec.eu/simono41/train-tracker.git

  2. Navigieren Sie in das Projektverzeichnis:

    cd train-tracker

  3. Installieren Sie die Abhängigkeiten:

    go mod tidy

Konfiguration

Konfigurieren Sie die Anwendung über folgende Umgebungsvariablen:

  • DB_DSN: MariaDB-Datenbankverbindungsstring
  • API_BASE_URL: Basis-URL der DB-Vendo-API
  • DURATION: Zeitspanne in Minuten für die Abfrage von Abfahrten
  • DELETE_AFTER_MINUTES: Zeit in Minuten, nach der alte Einträge gelöscht werden
  • STATION_IDS: Komma-getrennte Liste von Bahnhofs-IDs
  • UPDATE_INTERVAL_MINUTES: Intervall in Minuten, in dem der Algorithmus erneut ausgeführt wird (Standard: 1)
  • TRANSFER_TIME: Uhrzeit für die tägliche Übertragung der Verspätungsstatistiken im Format "HH:MM" (Standard: "23:59")

Datenbankstruktur

Die Anwendung verwendet drei Haupttabellen:

  1. trips: Speichert Informationen zu einzelnen Zugfahrten
  2. today_delay_stats: Speichert tägliche Verspätungsstatistiken
  3. delay_stats: Speichert aggregierte Verspätungsstatistiken

Detaillierte Tabellenstrukturen finden Sie in der init.sql Datei.

Verwendung

  1. Stellen Sie sicher, dass die MariaDB-Datenbank läuft und die Tabellen erstellt wurden.

  2. Setzen Sie die erforderlichen Umgebungsvariablen.

  3. Starten Sie die Anwendung:

    go run main.go

Die Anwendung wird nun kontinuierlich Abfahrtsinformationen abrufen, Zugpositionen berechnen und in der Datenbank speichern.

Entwicklung

Code-Struktur

  • main.go: Hauptanwendungslogik und Einstiegspunkt des Programms
  • Funktionen wie fetchDepartures(), fetchTripDetails(), savePosition(), calculateCurrentPosition(), updateTodayDelayStats(), transferDailyDelayStats() und deleteOldEntries() implementieren die Kernfunktionalität

Beitrag

Beiträge sind willkommen! Bitte erstellen Sie einen Pull Request für Verbesserungen oder Fehlerbehebungen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Kontakt

Bei Fragen oder Problemen öffnen Sie bitte ein Issue im Git-Repository.