DHBW-FN-TIT20 / know-where-you-go

Know-Where-You-Go ist eine open-source Webanwendung, die Ihnen hilft herauszufinden wo Sie sind und wohin Sie gehen.

Know Where You Go

Know-Where-You-Go ist eine Webanwendung die Ihnen hilft herauszufinden wo Sie sind und wohin Sie gehen.

🔎 Features

• Bekomme Informationen über jeden Ort mithilfe von Wikipedia
• Finde heraus wo du dich aktuell befindest mithilfe von OpenStreetMap
• Lass dir die schnellsten Routen zu einem Ort deiner Wahl zeigen und öffne sie in GoogleMaps
• Lass die beim Suchen von Länder, Regionen und Städten deren genauen Grenzen anzeigen
• Kann auf jedem Endgerät installiert werden
• Selbst ohne Internetzugang kannst du deine letzten Inhalte sehen
• Hoste die Anwendung auf deinem eigenem Server mit Docker

🔎 Technische Details und Highlights

• Automatische Vervollständigung der Suche abhängig von deinem aktuellen Standort
• Verschiedene Kartenansichten ( "Map" und "Satellite" )
• Speicherung der zuletzt besuchten Orte
• Der aktuelle Zoomgrad der Karte wird beim Reverse Geocoding zu jederzeit berücksichtigt
• Recursive Suche der Wikipediainformationen bis passende Informationen zum Ort gefunden wurden

🐳 Deploy mit Docker

Clonen des Repos:

git clone https://github.com/DHBW-FN-TIT20/know-where-you-go.git

Bauen und starten eines eigenen Image:

# Bauen eines Containers mit dem namen know-where-you-go
cd know-where-you-go
docker build buildx -t know-where-you-go .

# Bei einer alten Docker Version verwende
docker build -t know-where-you-go .

# Starten des Containers
docker run -d --name know-where-you-go know-where-you-go

Alternativ mit docker-compose:

cd know-where-you-go
docker compose up -d

# Bei einer alten Docker / docker-compose Version verwende
docker-compose up -d

🚀 Deploy Manuell

Ein Pre-Build ist unter Releases zu finden.

Entpacke die Datei release.tar.gz unter Windows mit 7-Zip oder vergleichbaren.
Unter Linux kann folgender Befehl eingegeben werden:

tar -xzvf release.tar.gz

Die Daten im Ordner www können nun mit einem beliebigen Server wie z.B. Apache bereitgestellt werden.

🛠 Bauen der Anwendung

Es kann der www Ordner auch selbst gebaut werden.

Node Version >= 16 wird vorausgesetzt.
Eine Anleitung ist hier zu finden: https://nodejs.org/en/

git clone https://github.com/DHBW-FN-TIT20/know-where-you-go.git
cd know-where-you-go
npm install
npm run build

Die Daten befinden sich im Ordner www.

🤓 Entwickler

• Henry Schuler
• Florian Herkommer
• Florian Glaser
• Baldur Siegel
• Johannes Brandenburger
• David Felder
• Lukas Braun
• Phillipp Patzelt