PPartnerDesk

81 — Quiz-System

Aktualisiert am 1. Juni 2026

81 — Quiz-System

Lektionen in der Akademie (siehe 80) können optional mit einem Quiz gekoppelt werden. Erst nach Bestehen gilt die Lektion als abgeschlossen.

Wozu?

  • Sicherstellen, dass Partner den Inhalt verstanden haben.
  • Compliance — z. B. AGB-Quiz mit verpflichtenden Antworten.
  • Engagement — Partner sind aktiver dabei.

Quiz anlegen

Admin → Akademie → Kurs → Lektion → „Quiz hinzufügen".

Modal öffnet sich:

Feld Bedeutung
Titel Optional
Passing-Score Mindest-Prozent (Default 70 %)
Fragen Beliebig viele (siehe unten)

Fragen-Builder

Pro Frage:

  • Fragetext.
  • Antworten (mindestens 2, beliebig viele).
  • Radio-Auswahl für die richtige Antwort.
  • Optional: Erklärung — wird nach Submit dem Partner angezeigt (auch bei falsch — Lerneffekt).

Partner-Sicht

Partner-Portal → Akademie → Lektion mit Quiz → „Quiz starten":

UX

  • Single-Question-View mit „Weiter"-Button (statt langer Liste — bessere mobile UX).
  • Progress-Bar: „Frage 3 von 10".
  • Eingabe via Radio-Buttons.

Nach Submit

  • Score: „8 von 10 — 80 %, bestanden ✓".
  • Pro Frage Anzeige:
    • Eigene Antwort.
    • Richtige Antwort.
    • Erklärung (falls hinterlegt).
  • „Erneut versuchen"-Button — bei Misserfolg unbegrenzte Versuche.

Speicherung

Jeder Versuch wird als AcademyQuizAttempt persistiert:

  • scorePercent.
  • correctCount / totalCount.
  • passed (true/false).
  • completedAt.

Vorteil: Admin sieht, wie oft ein Partner versucht hat (auch fehlgeschlagen) — wichtig für Compliance-Audit.

Bestehens-Logik

Bei Submit:

  1. Server vergleicht Antworten mit correctIndex pro Frage.
  2. Berechnet scorePercent.
  3. Wenn >= passingScore: passed=true, Lektion automatisch als completed markiert.
  4. Andernfalls: Lektion bleibt offen — Partner kann erneut versuchen.

Upsert-Modus

Bei Bearbeitung im Admin-Editor: das gesamte Quiz inkl. Fragen wird ersetzt (kein Inline-Patch). Vereinfacht die UI, vermeidet komplexe Diff-Logik.

Tipp: Beim Bearbeiten zuerst alle Fragen sichten → dann gezielt Änderungen vornehmen → Save. Versehentliche Lösch-Klicks vermeiden.

Default-Passing-Score

70 % ist der Standard. Anpassbar pro Quiz. Für Compliance-Quizze (z. B. AGB-Bestätigung) → 100 % Passing-Score → alle Fragen müssen richtig.

Quiz löschen

Im Editor → „Quiz löschen" → Lektion wird wieder einfaches „Mark Complete" ohne Quiz.

Verwandte Kapitel

Technische Tiefen-Doku: ../106-academy-quiz.md, ../107-quiz-ui.md