Skip to content

Latest commit

 

History

22 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BigMap – McDonald's Deutschland Tracker

BigMap ist eine interaktive React-Anwendung, die alle McDonald's Standorte in Deutschland visualisiert.
Ziel ist es, Besuche zu dokumentieren, Fortschritte zu tracken und spielerisch ganz Deutschland zu „erobern“.


🚀 Features

  • Kartenansicht mit allen McDonald's-Filialen in Deutschland
  • Standort-Details: Öffnungszeiten, Adresse, weitere Infos
  • Besuchs-Tracker: Markiere besuchte Restaurants als „erledigt“
  • Regionale Färbung: Bereiche auf der Karte färben sich grün, wenn der nächste McDonald's besucht wurde
  • Account-System mit vorgefertigten Accounts zur Anmeldung
  • Fortschrittsanzeige: Überblick, wie viele Restaurants bereits besucht wurden

📚 Inhaltsverzeichnis


🛠️ Technologien

  • React + TypeScript (Frontend-Framework)
  • Leaflet.js (Kartenbibliothek)
  • GeoJSON (Datenbasis der Standorte)
  • Node.js / Express (Backend-Server)
  • JSON-Server (Mock-Datenbank für Accounts und Standortinfos)
  • CSS/Styled Components (UI-Design)

⚙️ Installation

  1. Repository klonen:
git clone https://github.com/ByCalis/BigMap.git
cd BigMap
  1. Abhängigkeiten installieren (Frontend + Backend):
# im Root-Verzeichnis
npm install

# ggf. in /frontend oder /backend separat
npm install
  1. Entwicklungsserver starten:
# Backend (Mock-API)
node server.js

# Frontend (React-App)
npm start
  1. Anwendung öffnen unter:
    http://localhost:3000

📖 Nutzung

  1. Mit einem der vordefinierten Accounts anmelden.
  2. Karte erkunden und auf einen McDonald's klicken.
  3. Standort als „besucht“ markieren.
  4. Fortschrittsanzeige beobachten – und sehen, wie sich die Karte dynamisch einfärbt.

📂 Projektstruktur

BigMap/
├─ backend/
│  ├─ server.js          # Express/JSON-Server Backend
│  ├─ db.json            # Mock-Datenbank für Accounts & Standorte
│  └─ package.json       # Backend-Dependencies
│
├─ frontend/
│  ├─ public/            # Statische Dateien (index.html, manifest.json, icons)
│  ├─ src/
│  │  ├─ components/     # React-Komponenten (Map, Tracker, Account)
│  │  ├─ data/           # GeoJSON-Daten mit Standorten
│  │  ├─ images/         # Icons, Logos, Bilder
│  │  ├─ pages/          # Login, Dashboard, Map
│  │  ├─ App.tsx         # Haupteinstieg React
│  │  ├─ McDonaldsApp.tsx# Hauptlogik für Standort-Interaktion
│  │  ├─ LoginPage.tsx   # Account-Handling
│  │  └─ index.tsx       # Einstiegspunkt
│  ├─ package.json       # Frontend-Dependencies
│  └─ tsconfig.json      # TypeScript-Konfiguration
│
└─ README.md

⚠️ Hinweis

  • Das Account-System basiert aktuell auf statischen Accounts (kein produktives Auth-System).
  • Die Standortdaten beziehen sich ausschließlich auf Deutschland.
  • Dieses Projekt ist ein privates Hobbyprojekt und steht nicht in Verbindung mit McDonald's.

About

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages