[FEATURE] Statystyki quizu

[MarvinRucinski]

Jaki problem chcesz rozwiązać?

Endpoint do wyświetlania statystyk danego quizu Solvro/pm-testownik#28

Propozycja rozwiązania

No response

Alternatywy (opcjonalnie)

No response

Kontekst / przykłady

No response

[MoonPrincess06]

Jaki problem chcesz rozwiązać?

Obecnie backend zapisuje postęp rozwiązywania quizu (QuizSession, AnswerRecord) i udostępnia endpointy do bieżącej sesji (GET/DELETE /quizzes/{id}/progress, POST /quizzes/{id}/answer), ale nie ma dedykowanego endpointu zwracającego statystyki quizu w formie podsumowania.

Propozycja rozwiązania

Dodać endpoint statystyk quizu, np. GET /quizzes/{id}/stats, oparty na QuizSession i AnswerRecord, z kontrolą dostępu zgodną z IsQuizReadable.
Endpoint powinien zwracać zagregowane dane dla aktualnego użytkownika:

• total_answers
• correct_answers
• wrong_answers
• accuracy (0-100)
• study_time_seconds (z aktywnej sesji lub sumarycznie)
• sessions_count
• last_activity_at
• opcjonalnie per_question (np. question_id, attempts, correct_attempts, last_answered_at)

Zakres MVP:

• statystyki tylko dla zalogowanego użytkownika i konkretnego quizu,
• agregacja po wszystkich sesjach użytkownika dla danego quizu,
• spójny kontrakt JSON i testy API.

Alternatywy

1. Rozszerzyć istniejący GET /quizzes/{id}/progress o sekcję stats zamiast nowego endpointu.
2. Liczyć statystyki po stronie frontendu na podstawie listy AnswerRecord (szybsze wdrożenie, ale gorsza skalowalność i większa złożoność po stronie klienta).
3. Utrzymywać zdenormalizowaną tabelę/statystyki inkrementalne aktualizowane przy record_answer (wydajniejsze dla dużego ruchu, większy koszt utrzymania).

Przykład

{
  "quiz_id": "uuid",
  "total_answers": 42,
  "correct_answers": 31,
  "wrong_answers": 11,
  "accuracy": 73.81,
  "study_time_seconds": 1850,
  "sessions_count": 4,
  "last_activity_at": "2026-03-05T12:40:00Z"
}