update

backend/routes.py

@@ -14,12 +14,13 @@ from database import (
     list_progress, set_progress, delete_progress,
     create_element, list_elements, get_element, update_element, delete_element,
     list_baustein_progress, get_baustein_progress, set_offene_frage,
-    set_baustein_score, set_baustein_absolviert, set_baustein_verstanden, set_baustein_gemeistert, delete_baustein_daten,
+    set_baustein_score, set_baustein_absolviert, delete_baustein_daten, count_relevant_subs, subs_count_alle,
     delete_topic_pipeline, delete_quelle, get_guide_content, delete_guide_content,
 )
+from textkit import _norm_titel
 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, 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, _zufall_malus
+from lernen import NIVEAUS, cap_fuer, 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_score, progressiver_malus, stufe_aus_score
 from guide import generate_guide, guide_slot_dateien, guide_fertig_step
 from pipeline import cancel_guide
 from regeln import FORMATE, formate_stats, guide_lock, ist_absolviert, lade_lernstand, thema_abgeschlossen
@@ -221,15 +222,14 @@ async def get_frage_muster(topic: str, baustein: str):
 
 @router.get("/bausteine/lernstand", response_model=BausteinLernstandResponse)
 async def baustein_lernstand(topic: str):
-    """Prüfungs-Stand pro Baustein (roher Titel als Key)."""
+    """Prüfungs-Stand pro Baustein (roher Titel als Key). cap = 2×relevante Subs [10,50]."""
     progress = await list_baustein_progress(topic)
+    caps = await subs_count_alle()
     bausteine = {
         p["baustein"]: {
             "gute_antworten": p["gute_antworten"],
             "streak": p["streak"],
-            "absolviert": p["absolviert"] is not None,
-            "verstanden": p["verstanden"] is not None,
-            "gemeistert": p["gemeistert"] is not None,
+            "cap": cap_fuer(caps.get((topic, _norm_titel(p["baustein"])), 0)),
         }
         for p in progress
     }
@@ -276,42 +276,37 @@ def _erklaeren_delta(niveau: str, nachgefragt: bool) -> int:
     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 def _cap_fuer(topic: str, baustein: str) -> int:
+    """Maximal-Score des Bausteins = clamp(2×relevante Subbausteine, 10, 50)."""
+    return cap_fuer(await count_relevant_subs(topic, baustein))
+
+
+async def _buche(req, frage: str, delta: int, cap: int) -> dict:
+    """Score driftfrei buchen (Lock + offene_frage-Anker). Fehler (delta<0) → progressiver
+    Malus nach Fortschritt. Element einmalig anlegen, sobald Anfänger (20 %) erreicht."""
     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
+        war_stufe = stand["absolviert"] is not None  # Element-Guard: schon je angelegt?
         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, _zufall_malus(basis, delta), floor, req.cap)
+        floor = floor_aus_score(basis, cap)
+        d = progressiver_malus(basis, cap) if delta < 0 else delta
+        score = score_berechnen(basis, d, floor, cap)
         punkte = score - basis
         gute = await set_baustein_score(req.topic, req.baustein, score)
-        if score >= NOETIG and not absolviert:
-            absolviert = True
+        # Lern-Element einmalig anlegen, sobald die erste Stufe (Anfänger) erreicht ist.
+        if not war_stufe and stufe_aus_score(score, cap) is not None:
             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}
+        return {"punkte": punkte, "bewertung": _farbe(punkte), "gute_antworten": gute, "cap": cap}
 
 
 @router.post("/bausteine/pruefung", response_model=BausteinPruefungResponse)
 async def baustein_pruefung_route(req: BausteinPruefungRequest):
     stand = await get_baustein_progress(req.topic, req.baustein)
     gute = stand["gute_antworten"]
-    absolviert = stand["absolviert"] is not None
-    verstanden = stand["verstanden"] is not None
-    gemeistert = stand["gemeistert"] is not None
+    cap = await _cap_fuer(req.topic, req.baustein)
     kompakt = req.section_kompakt
     msgs = [m.model_dump() for m in req.messages]
 
@@ -325,7 +320,7 @@ async def baustein_pruefung_route(req: BausteinPruefungRequest):
             frage = await pruefung_frage(req.topic, req.baustein, req.section, kompakt, msgs, subbausteine=subs, vermeide=req.vermeide, provider=req.provider)
         if frage is None:
             raise HTTPException(502, "Frage fehlgeschlagen — bitte erneut versuchen")
-        return {"frage": frage, "gute_antworten": gute, "absolviert": absolviert, "verstanden": verstanden, "gemeistert": gemeistert}
+        return {"frage": frage, "gute_antworten": gute, "cap": cap}
 
     if req.aktion == "diskussion":
         if not req.frage.strip():
@@ -336,7 +331,7 @@ async def baustein_pruefung_route(req: BausteinPruefungRequest):
         )
         if reply is None:
             raise HTTPException(502, "Diskussion fehlgeschlagen — bitte erneut versuchen")
-        return {"reply": reply, "gute_antworten": gute, "absolviert": absolviert, "verstanden": verstanden, "gemeistert": gemeistert}
+        return {"reply": reply, "gute_antworten": gute, "cap": cap}
 
     # --- Quiz: leicht (1 von 4) +1/−1 · schwer (x von 4) +3/−1 — deterministisch ---
     if req.aktion == "quiz_frage":
@@ -346,14 +341,14 @@ async def baustein_pruefung_route(req: BausteinPruefungRequest):
         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}
+                "gute_antworten": gute, "cap": cap}
 
     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 = await _buche(req, req.frage, delta, cap)
         res["feedback"] = "Richtig — alle korrekten getroffen." if getroffen else "Nicht ganz — die markierten waren richtig."
         return res
 
@@ -366,12 +361,12 @@ async def baustein_pruefung_route(req: BausteinPruefungRequest):
             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}
+                    "gute_antworten": gute, "cap": cap}
         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}
+                "gute_antworten": gute, "cap": cap}
 
     if req.aktion == "lueck_antwort":
         if not req.frage.strip():
@@ -382,7 +377,7 @@ async def baustein_pruefung_route(req: BausteinPruefungRequest):
         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 = await _buche(req, req.frage, (3 if req.schwer else 1) if ok else -1, cap)
         res["feedback"] = feedback
         return res
 
@@ -400,19 +395,19 @@ async def baustein_pruefung_route(req: BausteinPruefungRequest):
         if data is None:
             raise HTTPException(502, "Bewertung fehlgeschlagen — bitte erneut versuchen")
         basis, _ = _basis(stand, req.frage)
-        floor = floor_aus_meilensteinen(absolviert, verstanden, gemeistert)
-        score = score_berechnen(basis, _zufall_malus(basis, _erklaeren_delta(data["niveau"], req.nachgefragt)), floor, req.cap)
+        floor = floor_aus_score(basis, cap)
+        roh = _erklaeren_delta(data["niveau"], req.nachgefragt)
+        d = progressiver_malus(basis, cap) if roh < 0 else roh
+        score = score_berechnen(basis, d, floor, cap)
         punkte = score - basis
         return {"feedback": data["feedback"], "punkte": punkte, "bewertung": _farbe(punkte),
-                "gute_antworten": gute, "absolviert": absolviert, "verstanden": verstanden, "gemeistert": gemeistert}
+                "gute_antworten": gute, "cap": cap}
 
     # aktion "antwort_pruefen" (Agent 2 genau): verbindlich, persistiert. Serialisiert je Baustein,
     # Basis driftfrei über den offene_frage-Anker. NUR hier ändert sich der Score.
     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
+        war_stufe = stand["absolviert"] is not None  # Element-Guard
         basis, re_bewertung = _basis(stand, req.frage)
         if not re_bewertung:
             await set_offene_frage(req.topic, req.baustein, req.frage, basis, 0)
@@ -424,22 +419,17 @@ async def baustein_pruefung_route(req: BausteinPruefungRequest):
         if data is None:
             raise HTTPException(502, "Bewertung fehlgeschlagen — bitte erneut versuchen")
 
-        floor = floor_aus_meilensteinen(absolviert, verstanden, gemeistert)
-        score = score_berechnen(basis, _zufall_malus(basis, _erklaeren_delta(data["niveau"], req.nachgefragt)), floor, req.cap)
+        floor = floor_aus_score(basis, cap)
+        roh = _erklaeren_delta(data["niveau"], req.nachgefragt)
+        d = progressiver_malus(basis, cap) if roh < 0 else roh
+        score = score_berechnen(basis, d, floor, cap)
         punkte = score - basis
         gute = await set_baustein_score(req.topic, req.baustein, score)
-        if score >= NOETIG and not absolviert:
-            absolviert = True
+        if not war_stufe and stufe_aus_score(score, cap) is not None:
             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 {"feedback": data["feedback"], "punkte": punkte, "bewertung": _farbe(punkte),
-                "gute_antworten": gute, "absolviert": absolviert, "verstanden": verstanden, "gemeistert": gemeistert}
+                "gute_antworten": gute, "cap": cap}
 
 
 # --- Guides ---