update

backend/routes.py

@@ -18,7 +18,7 @@ from database import (
 )
 from bausteine import generate_bausteine, cancel_bausteine, bausteine_status, active_bausteine, reset_bausteine, lade_quelle, lade_uebersicht, subbausteine_titel, lade_frage_muster
 from elements import generate_element, chat_with_guide, chat_with_element, check_element, style_element, refine_suggestion
-from lernen import NOETIG, MASTERY, MEISTERN, baustein_chat, baustein_diskussion, baustein_element_anlegen, pruefung_bewertung, pruefung_bewertung_schnell, pruefung_frage, pruefung_frage_variante, score_berechnen
+from lernen import NOETIG, MASTERY, MEISTERN, NIVEAUS, baustein_chat, baustein_diskussion, baustein_element_anlegen, pruefung_bewertung, pruefung_bewertung_schnell, pruefung_frage, pruefung_frage_variante, quiz_generieren, lueckwahl_generieren, lueckentext_generieren, lueckentext_pruefen, score_berechnen, floor_aus_meilensteinen
 from guide import generate_guide, guide_slot_dateien
 from pipeline import cancel_guide
 from regeln import FORMATE, formate_stats, guide_lock, ist_absolviert, lade_lernstand, thema_abgeschlossen
@@ -265,6 +265,41 @@ def _farbe(punkte: int) -> str:
     return "gut" if punkte > 0 else ("neutral" if punkte == 0 else "schlecht")
 
 
+def _erklaeren_delta(niveau: str, nachgefragt: bool) -> int:
+    """Erklären-Form: Punkt-Delta aus dem Niveau (−1…+3). Mit Nachfrage höchstens +1."""
+    delta = NIVEAUS.get(niveau, 0)
+    return min(delta, 1) if nachgefragt else delta
+
+
+async def _punkte_buchen(req, frage: str, delta: int) -> dict:
+    """Score driftfrei buchen (Lock + offene_frage-Anker + Meilensteine). Gemeinsam für
+    Quiz/Lückentext (deterministisch/schnell). → Response-Felder ohne feedback."""
+    async with _pruef_lock(req.topic, req.baustein):
+        stand = await get_baustein_progress(req.topic, req.baustein)
+        absolviert = stand["absolviert"] is not None
+        verstanden = stand["verstanden"] is not None
+        gemeistert = stand["gemeistert"] is not None
+        basis, re_bewertung = _basis(stand, frage)
+        if not re_bewertung:
+            await set_offene_frage(req.topic, req.baustein, frage, basis, 0)
+        floor = floor_aus_meilensteinen(absolviert, verstanden, gemeistert)
+        score = score_berechnen(basis, delta, floor, req.cap)
+        punkte = score - basis
+        gute = await set_baustein_score(req.topic, req.baustein, score)
+        if score >= NOETIG and not absolviert:
+            absolviert = True
+            if await set_baustein_absolviert(req.topic, req.baustein):
+                asyncio.create_task(baustein_element_anlegen(req.topic, req.baustein, req.section, req.provider))
+        if score >= MASTERY and not verstanden:
+            await set_baustein_verstanden(req.topic, req.baustein)
+            verstanden = True
+        if score >= MEISTERN and not gemeistert:
+            await set_baustein_gemeistert(req.topic, req.baustein)
+            gemeistert = True
+        return {"punkte": punkte, "bewertung": _farbe(punkte), "gute_antworten": gute,
+                "absolviert": absolviert, "verstanden": verstanden, "gemeistert": gemeistert}
+
+
 @router.post("/bausteine/pruefung", response_model=BausteinPruefungResponse)
 async def baustein_pruefung_route(req: BausteinPruefungRequest):
     stand = await get_baustein_progress(req.topic, req.baustein)
@@ -298,6 +333,54 @@ async def baustein_pruefung_route(req: BausteinPruefungRequest):
             raise HTTPException(502, "Diskussion fehlgeschlagen — bitte erneut versuchen")
         return {"reply": reply, "gute_antworten": gute, "absolviert": absolviert, "verstanden": verstanden, "gemeistert": gemeistert}
 
+    # --- Quiz: leicht (1 von 4) +1/−1 · schwer (x von 4) +3/−1 — deterministisch ---
+    if req.aktion == "quiz_frage":
+        if not req.muster.strip():
+            raise HTTPException(400, "Quiz braucht ein Muster")
+        quiz = await quiz_generieren(req.topic, req.baustein, req.section, kompakt, req.muster, schwer=req.schwer, provider=req.provider)
+        if quiz is None:
+            raise HTTPException(502, "Quiz-Frage fehlgeschlagen — bitte erneut versuchen")
+        return {"frage": quiz["frage"], "optionen": quiz["optionen"],
+                "gute_antworten": gute, "absolviert": absolviert, "verstanden": verstanden, "gemeistert": gemeistert}
+
+    if req.aktion == "quiz_antwort":
+        if not req.frage.strip():
+            raise HTTPException(400, "Quiz-Antwort braucht eine Frage")
+        getroffen = set(req.auswahl) == set(req.korrekt)  # exakt die richtige Menge
+        delta = (3 if req.schwer else 1) if getroffen else -1
+        res = await _punkte_buchen(req, req.frage, delta)
+        res["feedback"] = "Richtig — alle korrekten getroffen." if getroffen else "Nicht ganz — die markierten waren richtig."
+        return res
+
+    # --- Lückentext: leicht (Begriff aus 4) +1/−1 · schwer (frei tippen) +3/−1 ---
+    if req.aktion == "lueck_frage":
+        if not req.muster.strip():
+            raise HTTPException(400, "Lückentext braucht ein Muster")
+        if req.schwer:
+            lt = await lueckentext_generieren(req.topic, req.baustein, req.section, kompakt, req.muster, provider=req.provider)
+            if lt is None:
+                raise HTTPException(502, "Lückentext fehlgeschlagen — bitte erneut versuchen")
+            return {"satz": lt["satz"], "loesung": lt["loesung"], "alternativen": lt["alternativen"],
+                    "gute_antworten": gute, "absolviert": absolviert, "verstanden": verstanden, "gemeistert": gemeistert}
+        lw = await lueckwahl_generieren(req.topic, req.baustein, req.section, kompakt, req.muster, provider=req.provider)
+        if lw is None:
+            raise HTTPException(502, "Lückentext fehlgeschlagen — bitte erneut versuchen")
+        return {"satz": lw["satz"], "optionen": lw["optionen"],
+                "gute_antworten": gute, "absolviert": absolviert, "verstanden": verstanden, "gemeistert": gemeistert}
+
+    if req.aktion == "lueck_antwort":
+        if not req.frage.strip():
+            raise HTTPException(400, "Lückentext-Antwort braucht einen Satz")
+        if req.schwer:  # frei getippt → Synonym-tolerante KI-Prüfung
+            ok = await lueckentext_pruefen(req.topic, req.baustein, req.frage, req.loesung, req.alternativen, req.eingabe, provider=req.provider)
+            feedback = "Richtig!" if ok else f"Nicht ganz — erwartet war „{req.loesung}“."
+        else:  # Begriff aus 4 gewählt → deterministisch
+            ok = set(req.auswahl) == set(req.korrekt)
+            feedback = "Richtig!" if ok else "Nicht ganz — der markierte Begriff war richtig."
+        res = await _punkte_buchen(req, req.frage, (3 if req.schwer else 1) if ok else -1)
+        res["feedback"] = feedback
+        return res
+
     # aktion "antwort" (Agent 1 schnell) / "antwort_pruefen" (Agent 2 genau).
     if not any(m.get("role") == "user" for m in msgs):
         raise HTTPException(400, "Antwort braucht eine Nutzer-Antwort")
@@ -312,7 +395,8 @@ async def baustein_pruefung_route(req: BausteinPruefungRequest):
         if data is None:
             raise HTTPException(502, "Bewertung fehlgeschlagen — bitte erneut versuchen")
         basis, _ = _basis(stand, req.frage)
-        score = score_berechnen(basis, data["niveau"], req.nachgefragt, req.tier2, req.tier3, absolviert, verstanden, gemeistert)
+        floor = floor_aus_meilensteinen(absolviert, verstanden, gemeistert)
+        score = score_berechnen(basis, _erklaeren_delta(data["niveau"], req.nachgefragt), floor, req.cap)
         punkte = score - basis
         return {"feedback": data["feedback"], "punkte": punkte, "bewertung": _farbe(punkte),
                 "gute_antworten": gute, "absolviert": absolviert, "verstanden": verstanden, "gemeistert": gemeistert}
@@ -335,7 +419,8 @@ async def baustein_pruefung_route(req: BausteinPruefungRequest):
         if data is None:
             raise HTTPException(502, "Bewertung fehlgeschlagen — bitte erneut versuchen")
 
-        score = score_berechnen(basis, data["niveau"], req.nachgefragt, req.tier2, req.tier3, absolviert, verstanden, gemeistert)
+        floor = floor_aus_meilensteinen(absolviert, verstanden, gemeistert)
+        score = score_berechnen(basis, _erklaeren_delta(data["niveau"], req.nachgefragt), floor, req.cap)
         punkte = score - basis
         gute = await set_baustein_score(req.topic, req.baustein, score)
         if score >= NOETIG and not absolviert: