# Leistungstest Statistiken — Design

## Overview

Erweiterung des Leistungstest-Bereichs um Statistiken und Ranglisten auf zwei Ebenen: **Vorlagen** und **Übungen**. Filterbar nach Zeitraum (Monat / Alle Zeiten).

## Features

### 1. Ranglisten pro Vorlage
- Rangliste aller Wrestler nach `score_percent` (absteigend)
- Optional: Sortierung nach `total_time_seconds` (aufsteigend = schnellste Zeit)
- Zeitraum-Filter: "Alle Zeiten" | "Dieser Monat" | "Letzte 3 Monate" | "Dieses Jahr"
- Anzeige: Rank, Wrestler-Name, Score %, Gesamtzeit, Datum

### 2. Ranglisten pro Übung
- Für jede Übung: Rangliste nach `elapsed_seconds` (schnellste Zeit)
- Berechnung: Beste Zeit (niedrigste elapsed_seconds) pro Wrestler pro Übung
- Zeitraum-Filter wie oben
- Anzeige: Rank, Wrestler-Name, Übungsname, Bestzeit, Datum

### 3. Ringer-Statistik (optional)
- Pro Wrestler: Durchschnitts-Score, Anzahl Tests, Trend (besser/schlechter)

## Datenmodell

Keine neuen Modelle — Berechnung erfolgt on-the-fly aus `LeistungstestResult` und `LeistungstestResultItem`.

## API Endpoints (Backend)

### `GET /api/v1/leistungstest/stats/leaderboard/`
Query-Parameter:
- `type`: `"template"` | `"exercise"`
- `template_id`: number (für template-Typ)
- `period`: `"all"` | `"month"` | `"3months"` | `"year"`
- `limit`: number (default: 10)

Response für `type=template`:
```json
{
  "template_id": 1,
  "template_name": "Krafttest Februar",
  "period": "all",
  "results": [
    {
      "rank": 1,
      "wrestler_id": 1,
      "wrestler_name": "Max Mustermann",
      "score_percent": 100.0,
      "total_time_seconds": 342,
      "completed_at": "2026-03-24"
    }
  ]
}
```

Response für `type=exercise`:
```json
{
  "exercise_id": 1,
  "exercise_name": "Liegestütze",
  "period": "all",
  "results": [
    {
      "rank": 1,
      "wrestler_id": 1,
      "wrestler_name": "Max Mustermann",
      "best_time_seconds": 75,
      "completed_at": "2026-03-24"
    }
  ]
}
```

### `GET /api/v1/leistungstest/stats/exercises/`
Liste aller Übungen die jemals in einem Leistungstest verwendet wurden (für Dropdown).

## Frontend

### Neuer Tab: "📊 Statistiken"

Tabs im Leistungstest:
1. Vorlagen (existiert)
2. Zuweisen (existiert)
3. Ergebnisse (existiert, jetzt Karten-Ansicht)
4. **📊 Statistiken** (NEU)

### Statistiken-Tab Layout:
```
[Tab: Vorlagen | Zuweisen | Ergebnisse | 📊 Statistiken]

📊 Statistiken

[Dropdowns: Vorlage auswählen | Zeitraum: Alle Zeiten ▾]

-tabs-
[⊞ Nach Vorlage] [📋 Nach Übung]

--- Nach Vorlage ---
Rangliste: Krafttest Februar
1. 🥇 Max Mustermann — 100% (5:42)
2. 🥈 Anna Schmidt — 87% (6:20)  
3. 🥉 Tom Klein — 65% (8:15)

--- Nach Übung ---
Rangliste: Liegestütze
1. 🥇 Max Mustermann — 1:15
2. 🥈 Anna Schmidt — 1:30
3. 🥉 Tom Klein — 2:00

Rangliste: Kniebeugen
1. 🥇 Max Mustermann — 2:30
...
```

## Backend-Implementierung

### Neue Datei: `leistungstest/stats.py`
```python
def get_template_leaderboard(template_id, period="all", limit=10):
    # Filter results by template and period
    # Order by score_percent DESC, total_time_seconds ASC
    # Return top N with rank

def get_exercise_leaderboard(exercise_id, period="all", limit=10):
    # For each wrestler, find their BEST (lowest) elapsed_seconds
    # Filter by period
    # Order by best_time ASC
    # Return top N
```

### Neue URL: `leistungstest/stats.py` ViewSet
- `GET /leaderboard/` — Template oder Exercise Leaderboard
- `GET /exercises/` — Liste verwendeter Übungen

## Zeitraum-Filter Logik
```python
def get_date_range(period):
    today = date.today()
    if period == "month":
        return today.replace(day=1)
    elif period == "3months":
        return today - timedelta(days=90)
    elif period == "year":
        return today.replace(month=1, day=1)
    return None  # "all"
```

## Implementierungs-Reihenfolge

1. Backend: `stats.py` mit ViewSet + URLs
2. Frontend: Neuer "Statistiken" Tab
3. Toggle zwischen Vorlagen/Übungs-Ansicht
4. Zeitraum-Filter
5. Ranglisten-Anzeige mit Medaillen-Icons