Update

wiki/Benutzerhandbuch.md

@@ -0,0 +1,261 @@
+# 📖 Benutzerhandbuch
+
+Anleitung für Endbenutzer des Ninja Cross Parkour Systems.
+
+## 🎯 Übersicht
+
+Das Ninja Cross Parkour System ermöglicht es Schwimmbadbesuchern, ihre Parkour-Zeiten zu messen, zu verfolgen und sich mit anderen zu vergleichen.
+
+## 🚀 Erste Schritte
+
+### 1. Registrierung
+1. Öffnen Sie das Web-Interface
+2. Klicken Sie auf "Registrieren"
+3. Füllen Sie das Formular aus:
+   - Vorname
+   - Nachname
+   - Geburtsdatum
+   - RFID-Karten-ID (falls vorhanden)
+
+### 2. RFID-Karte verknüpfen
+Falls Sie eine RFID-Karte haben:
+1. Melden Sie sich an
+2. Gehen Sie zu "Mein Profil"
+3. Klicken Sie auf "RFID-Karte verknüpfen"
+4. Halten Sie Ihre Karte an den Reader
+
+### 3. Erste Zeit messen
+1. Wählen Sie einen Standort aus
+2. Halten Sie Ihre RFID-Karte an den Start-Reader
+3. Laufen Sie den Parkour
+4. Halten Sie Ihre Karte an den Ziel-Reader
+5. Ihre Zeit wird automatisch aufgezeichnet
+
+## 🏠 Dashboard
+
+### Übersicht
+Das Dashboard zeigt:
+- **Aktuelle Zeit** - Ihre letzte gemessene Zeit
+- **Beste Zeit** - Ihr persönlicher Rekord
+- **Achievements** - Ihre Erfolge
+- **Statistiken** - Fortschritt und Trends
+
+### Navigation
+- **🏠 Home** - Dashboard und Übersicht
+- **⏱️ Zeiten** - Alle Ihre gemessenen Zeiten
+- **🏆 Achievements** - Erfolge und Fortschritt
+- **📊 Statistiken** - Detaillierte Analysen
+- **👤 Profil** - Persönliche Einstellungen
+
+## ⏱️ Zeitmessung
+
+### Wie funktioniert es?
+1. **Start:** RFID-Karte an Start-Reader halten
+2. **Parkour:** Den Parcours absolvieren
+3. **Ziel:** RFID-Karte an Ziel-Reader halten
+4. **Ergebnis:** Zeit wird automatisch berechnet und gespeichert
+
+### Zeitformat
+Zeiten werden im Format `MM:SS.mmm` angezeigt:
+- **Minuten:SSekunden.Millisekunden**
+- Beispiel: `01:23.456` = 1 Minute, 23 Sekunden, 456 Millisekunden
+
+### Gültige Zeiten
+- **Minimum:** 30 Sekunden
+- **Maximum:** 10 Minuten
+- **Schwelle:** Konfigurierbar pro Standort
+
+## 🏆 Achievement System
+
+### Was sind Achievements?
+Achievements sind Erfolge, die Sie durch verschiedene Aktivitäten freischalten können.
+
+### Kategorien
+
+#### 🎯 Konsistenz-basierte Achievements
+- **Erste Schritte** 👶 - Erste Zeit aufgezeichnet (5 Punkte)
+- **Durchhalter** 💪 - 3 Versuche an einem Tag (10 Punkte)
+- **Fleißig** 🔥 - 5 Versuche an einem Tag (15 Punkte)
+- **Besessen** 😤 - 10 Versuche an einem Tag (25 Punkte)
+- **Regelmäßig** 📅 - 5 verschiedene Tage gespielt (20 Punkte)
+- **Stammgast** ⭐ - 10 verschiedene Tage gespielt (30 Punkte)
+- **Treue** 💎 - 20 verschiedene Tage gespielt (50 Punkte)
+- **Veteran** 🏆 - 50 verschiedene Tage gespielt (100 Punkte)
+
+#### 📈 Verbesserungs-basierte Achievements
+- **Fortschritt** 📈 - Persönliche Bestzeit um 5 Sekunden verbessert (15 Punkte)
+- **Durchbruch** ⚡ - Persönliche Bestzeit um 10 Sekunden verbessert (25 Punkte)
+- **Transformation** 🔄 - Persönliche Bestzeit um 15 Sekunden verbessert (40 Punkte)
+- **Perfektionist** ✨ - Persönliche Bestzeit um 20 Sekunden verbessert (60 Punkte)
+
+#### 🌍 Saisonale Achievements
+- **Wochenend-Krieger** 🏁 - Am Wochenende gespielt (10 Punkte)
+- **Nachmittags-Sportler** ☀️ - Zwischen 14-18 Uhr gespielt (10 Punkte)
+- **Frühaufsteher** 🌅 - Vor 10 Uhr gespielt (15 Punkte)
+- **Abend-Sportler** 🌙 - Nach 18 Uhr gespielt (10 Punkte)
+
+#### 📅 Monatliche Achievements
+- **Januar-Krieger** ❄️ bis **Dezember-Dynamo** 🎄 (je 20 Punkte)
+
+#### 🌸 Jahreszeiten-Achievements
+- **Frühjahrs-Fighter** 🌱 - Im Frühling gespielt (30 Punkte)
+- **Sommer-Sportler** ☀️ - Im Sommer gespielt (30 Punkte)
+- **Herbst-Held** 🍂 - Im Herbst gespielt (30 Punkte)
+- **Winter-Warrior** ❄️ - Im Winter gespielt (30 Punkte)
+
+### Achievement-Status
+- **✅ Abgeschlossen** - Achievement erreicht
+- **🔄 In Bearbeitung** - Fortschritt wird gemacht
+- **❌ Nicht freigeschaltet** - Noch nicht begonnen
+
+## 📊 Statistiken
+
+### Persönliche Statistiken
+- **Gesamtzeiten** - Anzahl aller gemessenen Zeiten
+- **Beste Zeit** - Schnellste gemessene Zeit
+- **Durchschnittszeit** - Durchschnittliche Zeit
+- **Verbesserung** - Zeitverbesserung seit dem ersten Lauf
+- **Aktivitätstage** - Anzahl der Tage mit Aktivität
+
+### Fortschritts-Tracking
+- **Wöchentlicher Fortschritt** - Zeiten der letzten 7 Tage
+- **Monatlicher Fortschritt** - Zeiten des aktuellen Monats
+- **Jährlicher Fortschritt** - Zeiten des aktuellen Jahres
+
+### Vergleiche
+- **Persönliche Bestenliste** - Ihre eigenen Top-Zeiten
+- **Standort-Vergleich** - Zeiten an verschiedenen Standorten
+- **Zeitverlauf** - Entwicklung Ihrer Zeiten über die Zeit
+
+## 🗺️ Standorte
+
+### Verfügbare Standorte
+Das System unterstützt mehrere Standorte:
+- **Hauptstandort** - Hauptparkour
+- **Training** - Übungsbereich
+- **Wettkampf** - Wettkampfbereich
+
+### Standort-Informationen
+Jeder Standort zeigt:
+- **Name** - Standortbezeichnung
+- **Schwelle** - Mindestzeit für gültige Zeiten
+- **Beste Zeit** - Rekordzeit an diesem Standort
+- **Karte** - Geografische Position
+
+## 🔔 Benachrichtigungen
+
+### Push-Benachrichtigungen
+Aktivieren Sie Push-Benachrichtigungen für:
+- **Neue Rekorde** - Persönliche Bestzeiten
+- **Achievements** - Neue Erfolge
+- **System-Updates** - Wichtige Ankündigungen
+
+### E-Mail-Benachrichtigungen
+Konfigurieren Sie E-Mail-Benachrichtigungen für:
+- **Wöchentliche Zusammenfassung** - Ihre Aktivitäten
+- **Monatliche Statistiken** - Detaillierte Berichte
+- **System-Updates** - Wichtige Änderungen
+
+## 👤 Profil verwalten
+
+### Persönliche Daten
+- **Name** - Vor- und Nachname
+- **Geburtsdatum** - Für Alterskategorien
+- **E-Mail** - Für Benachrichtigungen
+- **RFID-Karte** - Verknüpfte Karten
+
+### Einstellungen
+- **Zeitzone** - Für korrekte Zeitstempel
+- **Sprache** - Interface-Sprache
+- **Benachrichtigungen** - Push und E-Mail Einstellungen
+- **Datenschutz** - Sichtbarkeit Ihrer Daten
+
+### Datenschutz
+- **Öffentliche Profile** - Sichtbar für andere Benutzer
+- **Private Profile** - Nur für Sie sichtbar
+- **Datenexport** - Ihre Daten herunterladen
+- **Konto löschen** - Alle Daten entfernen
+
+## 🏅 Bestenlisten
+
+### Globale Bestenlisten
+- **Schnellste Zeiten** - Alle Zeiten aller Benutzer
+- **Meiste Achievements** - Benutzer mit den meisten Erfolgen
+- **Aktivste Spieler** - Benutzer mit den meisten Läufen
+
+### Kategorien
+- **Gesamt** - Alle Altersgruppen
+- **Jugend** - Unter 18 Jahren
+- **Erwachsene** - 18-65 Jahre
+- **Senioren** - Über 65 Jahre
+
+### Zeiträume
+- **Heute** - Beste Zeiten des Tages
+- **Diese Woche** - Beste Zeiten der Woche
+- **Dieser Monat** - Beste Zeiten des Monats
+- **Dieses Jahr** - Beste Zeiten des Jahres
+- **Alle Zeiten** - Historische Bestenliste
+
+## 🔧 Troubleshooting
+
+### Häufige Probleme
+
+#### RFID-Karte wird nicht erkannt
+1. Karte richtig positionieren
+2. Reader auf Verschmutzung prüfen
+3. Karte auf Beschädigungen prüfen
+4. Administrator kontaktieren
+
+#### Zeit wird nicht gespeichert
+1. Gültige Zeit prüfen (innerhalb der Schwelle)
+2. Standort korrekt ausgewählt
+3. Internetverbindung prüfen
+4. Seite neu laden
+
+#### Achievements werden nicht vergeben
+1. Tägliche Prüfung abwarten
+2. Bedingungen erfüllt prüfen
+3. System-Status prüfen
+4. Administrator kontaktieren
+
+### Support kontaktieren
+- **E-Mail** - support@ninjaparkour.de
+- **Telefon** - +49 (0) 123 456 789
+- **Chat** - Verfügbar im Web-Interface
+
+## 📱 Mobile Nutzung
+
+### Responsive Design
+Das System ist für alle Geräte optimiert:
+- **Desktop** - Vollständige Funktionalität
+- **Tablet** - Touch-optimierte Bedienung
+- **Smartphone** - Kompakte Ansicht
+
+### Mobile App (geplant)
+- **Native App** - Für iOS und Android
+- **Offline-Modus** - Zeiten ohne Internet
+- **Push-Benachrichtigungen** - Sofortige Updates
+
+## 🎓 Tipps und Tricks
+
+### Bessere Zeiten erzielen
+1. **Regelmäßig trainieren** - Konsistenz ist wichtig
+2. **Technik verbessern** - Effiziente Bewegungen
+3. **Kondition aufbauen** - Ausdauer trainieren
+4. **Mental vorbereiten** - Konzentration und Fokus
+
+### Achievements sammeln
+1. **Verschiedene Zeiten** - Morgens, mittags, abends
+2. **Wochenenden** - Zusätzliche Aktivität
+3. **Konsistent bleiben** - Regelmäßige Teilnahme
+4. **Verbesserungen** - Persönliche Bestzeiten brechen
+
+### System optimal nutzen
+1. **Profil vollständig** - Alle Daten ausfüllen
+2. **Benachrichtigungen aktivieren** - Updates erhalten
+3. **Statistiken verfolgen** - Fortschritt beobachten
+4. **Community nutzen** - Mit anderen vergleichen
+
+---
+
+**Hinweis:** Bei technischen Problemen wenden Sie sich an den Systemadministrator oder konsultieren Sie die [Troubleshooting](Troubleshooting)-Seite.