DB Departure Tracker

Beschreibung

Dieses Projekt ist ein Go-basierter Service, der Abfahrtsinformationen von verschiedenen Bahnhöfen der Deutschen Bahn abruft und in einer MariaDB-Datenbank speichert. Es verwendet die DB REST API, um Echtzeit-Abfahrtsdaten zu erhalten und aktualisiert die Positionen der Züge in regelmäßigen Abständen.

Funktionen

Abruf von Abfahrtsinformationen für mehrere Bahnhöfe
Konfigurierbare Einstellungen für verschiedene Verkehrsmittel (Bus, Fähre, Straßenbahn, Taxi)
Speicherung und Aktualisierung von Zugpositionen in einer MariaDB-Datenbank
Verwendung von UUIDs für eindeutige Datenbankeinträge
Konfiguration über Umgebungsvariablen

Voraussetzungen

Go 1.17 oder höher
Docker und Docker Compose
Zugang zur DB REST API

Installation

Klonen Sie das Repository:

git clone https://github.com/yourusername/db-departure-tracker.git
cd db-departure-tracker

Erstellen Sie eine .env Datei im Projektverzeichnis und füllen Sie sie mit den erforderlichen Umgebungsvariablen (siehe Konfiguration).
Bauen und starten Sie die Docker-Container:
```
docker-compose up --build
```

Konfiguration

Konfigurieren Sie die Anwendung durch Setzen der folgenden Umgebungsvariablen:

DB_DSN: Datenbankverbindungsstring (z.B. "root:password@tcp(mariadb:3306)/traindb")
API_BASE_URL: Basis-URL der DB REST API
MAX_RESULTS: Maximale Anzahl der abzurufenden Ergebnisse pro Anfrage
DURATION: Zeitspanne in Minuten für die Abfrage der Abfahrten
BUS: Einbeziehung von Busabfahrten (true/false)
FERRY: Einbeziehung von Fährabfahrten (true/false)
TRAM: Einbeziehung von Straßenbahnabfahrten (true/false)
TAXI: Einbeziehung von Taxiabfahrten (true/false)
STATION_IDS: Komma-separierte Liste der Bahnhofs-IDs

Beispiel für eine .env Datei:

DB_DSN=root:password@tcp(mariadb:3306)/traindb
API_BASE_URL=http://db-rest:3000
MAX_RESULTS=10
DURATION=240
BUS=false
FERRY=false
TRAM=false
TAXI=false
STATION_IDS=8000226,8000234

Verwendung

Nach dem Start läuft der Service kontinuierlich und ruft in regelmäßigen Abständen Abfahrtsinformationen ab. Die Daten werden in der konfigurierten MariaDB-Datenbank gespeichert.

Datenbankschema

Die Anwendung verwendet folgendes Datenbankschema:

CREATE TABLE IF NOT EXISTS trips (
    id VARCHAR(36) PRIMARY KEY,
    latitude DOUBLE,
    longitude DOUBLE,
    timestamp DATETIME,
    train_name VARCHAR(50),
    fahrt_nr VARCHAR(20)
);

Entwicklung

Um an diesem Projekt mitzuarbeiten:

Forken Sie das Repository
Erstellen Sie einen Feature Branch (git checkout -b feature/AmazingFeature)
Committen Sie Ihre Änderungen (git commit -m 'Add some AmazingFeature')
Pushen Sie den Branch (git push origin feature/AmazingFeature)
Öffnen Sie einen Pull Request

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe LICENSE Datei für Details.

2.9 KiB Raw Blame History