Schnellstart

Ziel: Laufende Simulator-Instanz mit Demo-Daten innerhalb von 5 Minuten.

Voraussetzungen

• Docker + Docker Compose (empfohlen) ODER Python 3.11+
• Mindestens 512 MB RAM
• Port 8000 frei

Option A: Docker (empfohlen)

1. Repository klonen: git clone https://github.com/Veloflott/veloflott-velostack-veloconnect.git
2. Konfiguration erstellen: cp .env.example .env
3. Container starten: docker compose up -d
4. Browser öffnen: http://localhost:8000/admin/
5. Admin-User anlegen: python scripts/create_admin.py

Option B: Manuelle Installation

1. Repository klonen
2. venv erstellen: python3 -m venv .venv && source .venv/bin/activate
3. Dependencies installieren: pip install -e ".[dev]"
4. Konfiguration: cp .env.example .env && bearbeiten
5. Server starten: uvicorn simulator.main:app --reload
6. Admin-User: python scripts/create_admin.py

Verifizierung

Die Startseite zeigt das Admin-Dashboard. Unter /api/v1/health ist der Health-Check erreichbar. Unter /veloconnect GET /veloconnect/profile liefert das Profil.