From 1649a046d2872191c4b0274944592eb17906aa1c Mon Sep 17 00:00:00 2001
From: Team3 <team3@mitho-media.de>
Date: Sun, 7 Jun 2026 12:18:07 +0200
Subject: [PATCH] update

---
 backend/routes.py                        | 42 ++++++++++++++++++++----
 frontend/src/App.vue                     |  8 +++--
 frontend/src/api.js                      |  5 +++
 frontend/src/components/TopicSidebar.vue | 16 ++++++---
 4 files changed, 59 insertions(+), 12 deletions(-)

diff --git a/backend/routes.py b/backend/routes.py
index 7bd0905..3b363b2 100644
--- a/backend/routes.py
+++ b/backend/routes.py
@@ -46,10 +46,31 @@ async def get_topics():
     return db_topics + sorted(derived - set(db_topics))
 
 
-# Lernschulden-Regel: JE Format (MiniGuide/Guide/FullGuide) höchstens 5 erstellte,
-# aber nicht absolvierte Guides. Darüber sind nur Neu-Generierungen bereits
-# erstellter Guides erlaubt. Themen, Bausteine und OnePager sind unbegrenzt.
-MAX_OFFENE_GUIDES = 5
+# Lernschulden-Regeln (nur Neu-Erstellungen; Themen, Bausteine, OnePager unbegrenzt):
+# - JE Format (MiniGuide/Guide/FullGuide) höchstens 3 erstellte, nicht absolvierte Guides
+# - Progression pro Thema: Guide erst nach absolviertem MiniGuide, FullGuide erst nach absolviertem Guide
+MAX_OFFENE_GUIDES = 3
+VORSTUFE = {"Guide": "MiniGuide", "FullGuide": "Guide"}
+
+
+async def _ist_absolviert(topic: str, fmt: str) -> bool:
+    """Alle Kapitel des neuesten fertigen Guides (Thema+Format) abgehakt?"""
+    neueste = None
+    for g in await list_guides():
+        if g["topic"] == topic and g["format"] == fmt and g["status"] == "done":
+            if neueste is None or g["created_at"] > neueste["created_at"]:
+                neueste = g
+    if neueste is None:
+        return False
+    path = guide_content_path(topic, fmt)
+    if not path.exists():
+        return False
+    try:
+        chapters = json.loads(path.read_text(encoding="utf-8")).get("chapters", [])
+    except ValueError:
+        return False
+    titles = {c.get("title") for c in chapters}
+    return bool(titles) and titles <= set(await list_progress(neueste["id"]))
 
 
 async def _formate_stats() -> dict:
@@ -88,6 +109,12 @@ async def get_stats():
     return {"themen": len(themen), "formate": await _formate_stats()}
 
 
+@router.get("/topics/fortschritt")
+async def topic_fortschritt(topic: str):
+    """Absolviert-Status pro Format — fürs Freischalten der nächsten Ausbaustufe."""
+    return {fmt: await _ist_absolviert(topic, fmt) for fmt in ("MiniGuide", "Guide", "FullGuide")}
+
+
 @router.post("/topics")
 async def add_topic(req: TopicCreateRequest):
     await create_topic(req.name.strip())
@@ -169,10 +196,13 @@ async def create(req: GuideCreateRequest):
     for g in await list_guides():
         if g["topic"] == req.topic.strip() and g["format"] == req.format and g["status"] in ("queued", "generating"):
             raise HTTPException(409, "Generierung läuft bereits")
-    # Lernschulden-Regel: neue Guides nur, wenn das Format weniger als 5 offene hat (erstellt, nicht absolviert).
-    # Resume (Schritt-Dateien vorhanden) ist ausgenommen — der Guide wurde bereits angefangen.
+    # Lernschulden-Regeln — nur für Neu-Erstellungen; Resume (Schritt-Dateien
+    # vorhanden) und Neu-Generieren bestehender Guides sind ausgenommen.
     content = guide_content_path(req.topic.strip(), req.format)
     if req.format != "OnePager" and not content.exists() and not guide_slot_dateien(content):
+        vorstufe = VORSTUFE.get(req.format)
+        if vorstufe and not await _ist_absolviert(req.topic.strip(), vorstufe):
+            raise HTTPException(409, f"Erst den {vorstufe} dieses Themas absolvieren")
         stat = (await _formate_stats()).get(req.format, {"erstellt": 0, "absolviert": 0})
         offen = stat["erstellt"] - stat["absolviert"]
         if offen >= MAX_OFFENE_GUIDES:
diff --git a/frontend/src/App.vue b/frontend/src/App.vue
index fbb0fea..b83e77b 100644
--- a/frontend/src/App.vue
+++ b/frontend/src/App.vue
@@ -1,6 +1,6 @@
 <script setup>
 import { ref, computed, watch, onMounted, onUnmounted, nextTick } from 'vue'
-import { fetchGuides, fetchTopics, createTopic as apiCreateTopic, deleteTopic as apiDeleteTopic, createGuide as apiCreate, deleteGuide, cancelGuide as apiCancel, fetchBausteineStatus, fetchActiveBausteine, createBausteine as apiCreateBausteine, cancelBausteine as apiCancelBausteine, deleteBausteine as apiDeleteBausteine, fetchProjects, deleteProject as apiDeleteProject, fetchProviders, fetchStats } from './api.js'
+import { fetchGuides, fetchTopics, createTopic as apiCreateTopic, deleteTopic as apiDeleteTopic, createGuide as apiCreate, deleteGuide, cancelGuide as apiCancel, fetchBausteineStatus, fetchActiveBausteine, createBausteine as apiCreateBausteine, cancelBausteine as apiCancelBausteine, deleteBausteine as apiDeleteBausteine, fetchProjects, deleteProject as apiDeleteProject, fetchProviders, fetchStats, fetchTopicFortschritt } from './api.js'
 import TopicSidebar from './components/TopicSidebar.vue'
 import TopicDetail from './components/TopicDetail.vue'
 
@@ -22,6 +22,7 @@ const activeBausteine = ref([])
 const provider = ref(localStorage.getItem('provider') || 'claude')
 const providers = ref([])
 const stats = ref(null)
+const fortschritt = ref({})
 
 async function loadStats() {
   try {
@@ -145,8 +146,10 @@ async function loadBausteine() {
     activeBausteine.value = await fetchActiveBausteine()
     if (selectedTopic.value) {
       bausteine.value = await fetchBausteineStatus(selectedTopic.value)
+      fortschritt.value = await fetchTopicFortschritt(selectedTopic.value)
     } else {
       bausteine.value = { ...EMPTY_BAUSTEINE }
+      fortschritt.value = {}
     }
     if (activeBausteine.value.length && !pollTimer) startPolling()
   } catch (e) {
@@ -325,6 +328,7 @@ onUnmounted(() => {
       :projects="projectNames"
       :selectedTopic="selectedTopic"
       :stats="stats"
+      :fortschritt="fortschritt"
       :doneByFormat="doneByFormat"
       :latestByFormat="latestByFormat"
       :allGuides="guides"
@@ -357,7 +361,7 @@ onUnmounted(() => {
       :previewGuide="previewGuide"
       :dark="darkMode"
       :provider="provider"
-      @progressChanged="loadStats"
+      @progressChanged="loadStats(); loadBausteine()"
     />
     <div v-else class="empty-main">
       <p>Thema in der Sidebar anlegen oder auswählen.</p>
diff --git a/frontend/src/api.js b/frontend/src/api.js
index 7c6b30a..8fb56a2 100644
--- a/frontend/src/api.js
+++ b/frontend/src/api.js
@@ -41,6 +41,11 @@ export async function deleteBausteine(topic) {
   await fetch(`${BASE}/bausteine?topic=${encodeURIComponent(topic)}`, { method: 'DELETE' })
 }
 
+export async function fetchTopicFortschritt(topic) {
+  const res = await fetch(`${BASE}/topics/fortschritt?topic=${encodeURIComponent(topic)}`)
+  return res.json()
+}
+
 export async function fetchStats() {
   const res = await fetch(`${BASE}/stats`)
   return res.json()
diff --git a/frontend/src/components/TopicSidebar.vue b/frontend/src/components/TopicSidebar.vue
index c874a9f..65d0429 100644
--- a/frontend/src/components/TopicSidebar.vue
+++ b/frontend/src/components/TopicSidebar.vue
@@ -6,6 +6,7 @@ const props = defineProps({
   projects: { type: Array, default: () => [] },
   selectedTopic: { type: String, default: null },
   stats: { type: Object, default: null },
+  fortschritt: { type: Object, default: () => ({}) },
   doneByFormat: { type: Object, default: () => ({}) },
   latestByFormat: { type: Object, default: () => ({}) },
   allGuides: { type: Array, default: () => [] },
@@ -146,8 +147,10 @@ function handleFormatClick(format) {
   }
 }
 
-// Lernschulden-Regel: JE Format max. 5 erstellte, aber nicht absolvierte Guides —
-// darüber sind nur Neu-Generierungen bereits erstellter Guides erlaubt.
+// Lernschulden-Regeln (nur Neu-Erstellungen; Resume + Neu-Generieren bestehender erlaubt):
+// Progression pro Thema (MiniGuide → Guide → FullGuide) + max. 3 offene je Format.
+const VORSTUFE = { Guide: 'MiniGuide', FullGuide: 'Guide' }
+
 function offeneGuides(format) {
   const f = props.stats?.formate?.[format]
   return (f?.erstellt ?? 0) - (f?.absolviert ?? 0)
@@ -156,9 +159,14 @@ function offeneGuides(format) {
 function playLock(format) {
   if (format === 'OnePager') return null
   if (!props.bausteine.ready) return 'Erst Bausteine erstellen'
+  if (props.doneByFormat[format] || abgebrochen(format)) return null
+  const vorstufe = VORSTUFE[format]
+  if (vorstufe && !props.fortschritt?.[vorstufe]) {
+    return `Erst den ${vorstufe} dieses Themas absolvieren`
+  }
   const offen = offeneGuides(format)
-  if (offen >= 5 && !props.doneByFormat[format]) {
-    return `Erst ${format}s absolvieren — ${offen} offen (max. 5)`
+  if (offen >= 3) {
+    return `Erst ${format}s absolvieren — ${offen} offen (max. 3)`
   }
   return null
 }