update lesson -alanna

phase/Student_view/lesson.py

@@ -1,7 +1,11 @@
-import streamlit as st
-from utils import db as dbapi
 import os
+import re
+import random
+import requests
+from typing import List, Dict
 
+import streamlit as st
+from utils import db as dbapi
 
 # --- Load external CSS ---
 def load_css(file_name):
@@ -11,6 +15,11 @@ def load_css(file_name):
     except FileNotFoundError:
         st.warning("⚠️ Stylesheet not found. Please ensure 'assets/styles.css' exists.")
 
+# --- Settings ---
+MAX_TOPICS = 5  # show topics 1..5 only, then Summary
+MINI_QUIZ_MIN = 2
+MINI_QUIZ_MAX = 4
+BACKEND_URL = os.getenv("BACKEND_URL", "http://localhost:8000")  # FastAPI backend (optional)
 
 # --- Data structure for lessons ---
 lessons_by_level = {
@@ -24,12 +33,14 @@ lessons_by_level = {
             "locked": False,
             "difficulty": "Easy",
             "content": "",
-            "topics": ["What is money? (coins, notes, digital money)",
-                       "History of money in Jamaica (Jamaican coins, notes, and famous historical figures)",
-                       "How money is used in daily life",
-                       "Different types of currencies",
-                       "Recognizing and counting Jamaican coins and notes",
-                       "Play: Money Match","Quiz", "Summary"]
+            "topics": [
+                "What is money? (coins, notes, digital money)",
+                "History of money in Jamaica (Jamaican coins, notes, and famous historical figures)",
+                "How money is used in daily life",
+                "Different types of currencies",
+                "Recognizing and counting Jamaican coins and notes",
+                "Play: Money Match", "Quiz", "Summary"
+            ]
         },
         {
             "id": 2,
@@ -39,12 +50,14 @@ lessons_by_level = {
             "completed": False,
             "locked": False,
             "difficulty": "Easy",
-             "topics": ["Jobs people do to earn money",
-                       "Allowances and pocket money",
-                       "Basic needs vs wants",
-                       "Making choices when spending",
-                       "Simple budget for small items",
-                       "Play: Budget Builder","Quiz", "Summary"]
+            "topics": [
+                "Jobs people do to earn money",
+                "Allowances and pocket money",
+                "Basic needs vs wants",
+                "Making choices when spending",
+                "Simple budget for small items",
+                "Play: Budget Builder", "Quiz", "Summary"
+            ]
         },
         {
             "id": 3,
@@ -54,14 +67,16 @@ lessons_by_level = {
             "completed": False,
             "locked": False,
             "difficulty": "Easy",
-             "topics": ["Why saving is important",
-                       "Where to save (piggy banks, banks)",
-                       "Basic needs vs wants",
-                       "Setting small savings goals",
-                       "Reward of saving (buying a toy, snack, or school supplies)",
-                       "Play Piggy Bank challenge","Quiz", "Summary"]
+            "topics": [
+                "Why saving is important",
+                "Where to save (piggy banks, banks)",
+                "Basic needs vs wants",
+                "Setting small savings goals",
+                "Reward of saving (buying a toy, snack, or school supplies)",
+                "Play Piggy Bank challenge", "Quiz", "Summary"
+            ]
         },
-         {
+        {
             "id": 4,
             "title": "Simple Financial Responsibility",
             "description": "Learn to distinguish between essential and optional purchases",
@@ -69,11 +84,13 @@ lessons_by_level = {
             "completed": False,
             "locked": False,
             "difficulty": "Easy",
-             "topics": ["Making smart choices with money",
-                       "Giving and sharing (donations, helping family/friends)",
-                       "Recognizing scams or unsafe spending",
-                       "Introduction to keeping a simple money diary",
-                       "Play Smart Shopper","Quiz", "Summary"]
+            "topics": [
+                "Making smart choices with money",
+                "Giving and sharing (donations, helping family/friends)",
+                "Recognizing scams or unsafe spending",
+                "Introduction to keeping a simple money diary",
+                "Play Smart Shopper", "Quiz", "Summary"
+            ]
         }
     ],
     "intermediate": [
@@ -144,13 +161,87 @@ lessons_by_level = {
 
 # --- Utility functions ---
 
+def get_display_topics(lesson: dict) -> List[str]:
+    """Limit to topics 1..5 + Summary placeholder, hiding Play/old Quiz."""
+    base = (lesson.get("topics") or [])[:MAX_TOPICS]
+    return base + ["Summary"]
+
+def summarize_first_n_topics(lesson_id: int, n: int = MAX_TOPICS) -> str:
+    """Very simple, deterministic summary of the first N topics (no LLM)."""
+    bullets = []
+    for i in range(1, n + 1):
+        text = load_topic_content(lesson_id, i)
+        first_sentence = re.split(r'(?<=[.!?])\s+', (text or "").strip())[:1]
+        bullets.append(f"• {first_sentence[0] if first_sentence else ('Key idea from topic ' + str(i))}")
+    return "<br>".join(bullets) or "No summary available."
+
+# ---------- Mini-quiz generation ----------
+_DEFAULT_BANK: List[Dict] = [
+    {"id": "b1", "question": "Why do people make a budget?",
+     "options": ["To plan money and make choices", "To waste money", "To hide money", "To lose track"],
+     "answer_key": "A"},
+    {"id": "b2", "question": "A 'need' is best described as:",
+     "options": ["A video game", "Shoes for school", "Candy", "Toy car"],
+     "answer_key": "B"},
+    {"id": "b3", "question": "Saving money means you:",
+     "options": ["Keep some for later", "Spend it all now", "Borrow more", "Lose it"],
+     "answer_key": "A"},
+    {"id": "b4", "question": "Which amount is greater?",
+     "options": ["$10", "$5", "$1", "$2"],
+     "answer_key": "A"},
+]
+
+def _fallback_auto_quiz() -> List[Dict]:
+    k = random.randint(MINI_QUIZ_MIN, MINI_QUIZ_MAX)
+    return random.sample(_DEFAULT_BANK, k)
+
+def _backend_post(path: str, payload: dict, timeout=6) -> dict | None:
+    try:
+        r = requests.post(f"{BACKEND_URL}{path}", json=payload, timeout=timeout)
+        if r.ok:
+            return r.json()
+    except Exception:
+        pass
+    return None
+
+def fetch_auto_quiz_from_backend() -> List[Dict] | None:
+    # Uses your legacy stub: /agent/quiz returns {"items":[{question,options,answer_key,points}...]}
+    resp = _backend_post("/agent/quiz", payload={"lesson_id": 0, "level_slug": "beginner"})
+    if resp and isinstance(resp.get("items"), list) and resp["items"]:
+        out = []
+        for i, it in enumerate(resp["items"], start=1):
+            out.append({
+                "id": f"auto_{i}",
+                "question": it.get("question",""),
+                "options": it.get("options", []),
+                "answer_key": it.get("answer_key","A")
+            })
+        return out
+    return None
+
+def grade_via_backend(answers: List[str]) -> dict | None:
+    # /agent/grade expects {"answers":[...]} and returns {"score": int, "total": int}
+    return _backend_post("/agent/grade", payload={"answers": answers, "lesson_id": 0, "level_slug": "beginner"})
+
+def coach_or_celebrate_via_backend(answers: List[str]) -> dict | None:
+    # returns {"route":"coach"/"celebrate", "feedback": "..."} (legacy)
+    return _backend_post("/agent/coach_or_celebrate", payload={"answers": answers, "lesson_id": 0, "level_slug": "beginner"})
+
+def generate_mini_quiz() -> List[Dict]:
+    return fetch_auto_quiz_from_backend() or _fallback_auto_quiz()
+
+def grade_locally(items: List[Dict], answers: List[str]) -> tuple[int, int]:
+    keys = [it.get("answer_key","A").strip().upper() for it in items]
+    raw = (answers or []) + [""]*len(keys)
+    score = sum(1 for a, k in zip(raw, keys) if (a or "").strip().upper() == k)
+    return score, len(keys)
+
 def _db_to_general_lesson_shape(L: dict, sections: list) -> dict:
     """Convert a DB lesson+sections into the same dict shape used by general lessons."""
     level = (L.get("level") or "beginner").lower()
     difficulty = {"beginner": "Easy", "intermediate": "Medium", "advanced": "Hard"}.get(level, "Easy")
-    topics = [ (s.get("title") or f"Topic {i+1}") for i, s in enumerate(sections) ]
+    topics = [(s.get("title") or f"Topic {i+1}") for i, s in enumerate(sections)]
 
-    # pick a duration heuristic if you don’t store it
     duration = L.get("duration") or f"{max(6, len(topics)*6)} min"
 
     return {
@@ -162,39 +253,20 @@ def _db_to_general_lesson_shape(L: dict, sections: list) -> dict:
         "locked": False,
         "difficulty": difficulty,
         "topics": topics,
-        # keep optional extra fields if you like:
-        "_db_sections": sections,     # stash raw sections so our DB renderer can use them
+        "_db_sections": sections,
         "_db_level": level,
     }
 
-
 def get_difficulty_color(difficulty):
     """Return color based on difficulty level"""
-    colors = {
-        "Easy": "#28a745",      # Green
-        "Medium": "#ffc107",    # Yellow
-        "Hard": "#dc3545"       # Red
-    }
+    colors = {"Easy": "#28a745", "Medium": "#ffc107", "Hard": "#dc3545"}
     return colors.get(difficulty, "#6c757d")
 
 def get_level_info(level):
-
     level_info = {
-        "beginner": {
-            "display": "🌱 Beginner",
-            "color": "#28a745",
-            "description": "Build your financial foundation"
-        },
-        "intermediate": {
-            "display": "🚀 Intermediate", 
-            "color": "#007bff",
-            "description": "Grow your financial knowledge"
-        },
-        "advanced": {
-            "display": "🎓 Advanced",
-            "color": "#6f42c1",
-            "description": "Master advanced strategies"
-        }
+        "beginner": {"display": "🌱 Beginner", "color": "#28a745", "description": "Build your financial foundation"},
+        "intermediate": {"display": "🚀 Intermediate", "color": "#007bff", "description": "Grow your financial knowledge"},
+        "advanced": {"display": "🎓 Advanced", "color": "#6f42c1", "description": "Master advanced strategies"},
     }
     return level_info.get(level, level_info["beginner"])
 
@@ -217,16 +289,13 @@ def _is_lesson_completed(lesson_id: int) -> bool:
 def _complete_lesson(lesson):
     _ensure_progress_state()
     st.session_state.lesson_completed[lesson["id"]] = True
-    # reflect in the in-memory lessons list too (so the cards show ✓)
     lesson["completed"] = True
 
-
 #-----
 
 def show_lesson_cards(lessons, user_level):
-
     level_info = get_level_info(user_level)
-    
+
     # Level header
     st.markdown(f"""
     <div style="background-color: {level_info['color']}; color: white; padding: 1.5rem; border-radius: 12px; margin-bottom: 2rem;">
@@ -234,32 +303,31 @@ def show_lesson_cards(lessons, user_level):
         <p style="margin: 0.5rem 0 0 0; font-size: 1.1rem; opacity: 0.9;">{level_info['description']}</p>
     </div>
     """, unsafe_allow_html=True)
-    
+
     # Stats
     total_lessons = len(lessons)
     completed_lessons = sum(1 for lesson in lessons if lesson["completed"])
-    
+    progress_pct = int((completed_lessons / total_lessons) * 100) if total_lessons else 0
+
     col1, col2, col3, col4 = st.columns(4)
     with col1:
         st.metric("📚 Total Lessons", total_lessons)
     with col2:
         st.metric("✅ Completed", completed_lessons)
     with col3:
-        st.metric("📈 Progress", f"{int((completed_lessons/total_lessons)*100)}%")
+        st.metric("📈 Progress", f"{progress_pct}%")
     with col4:
         available_lessons = sum(1 for lesson in lessons if not lesson["locked"])
         st.metric("🔓 Available", available_lessons)
-    
+
     st.markdown("---")
-    
+
     # Display lessons in a 3-column grid like Microsoft Learn
     cols = st.columns(3)
-    
     for i, lesson in enumerate(lessons):
         lesson["completed"] = lesson.get("completed") or _is_lesson_completed(lesson["id"])
 
         with cols[i % 3]:
-            # Determine card status and styling
             if lesson["locked"]:
                 icon_html = '🔒'
                 card_opacity = "0.6"
@@ -269,7 +337,7 @@ def show_lesson_cards(lessons, user_level):
             else:
                 icon_html = '📖'
                 card_opacity = "1"
-            
+
             card_html = f"""
             <div class="lesson-card" style="
                 background: white; 
@@ -294,10 +362,8 @@ def show_lesson_cards(lessons, user_level):
                 <div style="color: #0078d4; font-size: 14px; font-weight: 500;">{lesson['duration']}</div>
             </div>
             """
-            
             st.markdown(card_html, unsafe_allow_html=True)
-            
-            # Native Streamlit buttons that actually work
+
             if lesson["locked"]:
                 st.button("🔒 Locked", key=f"lesson_locked_{lesson['id']}", disabled=True, use_container_width=True)
             elif lesson["completed"]:
@@ -309,21 +375,17 @@ def show_lesson_cards(lessons, user_level):
                     st.session_state.selected_lesson = lesson["id"]
                     st.rerun()
 
-
-
 def show_lesson_detail(lesson):
+    units = len(get_display_topics(lesson))
     st.markdown(f"""
         <h1 style="font-size:2.5rem; margin-bottom:0;">{lesson['title']}</h1>
-        <p style="color: #666; margin-top:0;">{lesson['duration']} &nbsp;•&nbsp; Module &nbsp;•&nbsp; {len(lesson.get("topics", []))} units</p>
+        <p style="color: #666; margin-top:0;">{lesson['duration']} &nbsp;•&nbsp; Module &nbsp;•&nbsp; {units} units</p>
         <hr style="margin:1rem 0;"/>
     """, unsafe_allow_html=True)
 
     # Learning objectives section
     st.subheader("Learning objectives")
-    st.markdown("""
-    <p style="color:#888; margin-bottom:0.5rem;">In this module, you'll</p>
-    """, unsafe_allow_html=True)
-    
+    st.markdown("<p style='color:#888; margin-bottom:0.5rem;'>In this module, you'll</p>", unsafe_allow_html=True)
     st.markdown(
         "- Focus on: Basic money concepts  \n"
         "- Saving  \n"
@@ -335,18 +397,17 @@ def show_lesson_detail(lesson):
     if st.button("▶ Start", key=f"start_{lesson['id']}", type="primary"):
         st.session_state.start_lesson = True
         st.session_state.current_topic = 1
-        # reset progress for this lesson only if not previously completed
         _ensure_progress_state()
         if not _is_lesson_completed(lesson["id"]):
             st.session_state.topic_progress[lesson["id"]] = 1
         st.rerun()
 
-
     st.markdown("---")
 
     # Topics list (with clickable links)
     st.subheader("Topics")
-    for i, t in enumerate(lesson.get("topics", []), start=1):
+    display_topics = get_display_topics(lesson)
+    for i, t in enumerate(display_topics, start=1):
         st.markdown(f"- [{t}](#topic-{i})")
 
     st.markdown("---")
@@ -356,8 +417,6 @@ def show_lesson_detail(lesson):
         st.session_state.selected_lesson = None
         st.rerun()
 
-
-
 def load_topic_content(lesson_id, topic_index):
     """Load topic content for a specific lesson and topic index"""
     file_path = os.path.join("phase", "Student_view", "lessons", f"lesson_{lesson_id}", f"topic_{topic_index}.txt")
@@ -369,7 +428,6 @@ def load_topic_content(lesson_id, topic_index):
             return f"⚠️ Error loading topic content: {e}"
     return "⚠️ Topic content not available."
 
-
 def show_lesson_page(lesson, lessons):
     # Back link
     if st.button("⬅ Back to Lessons", key=f"back_top_{lesson['id']}"):
@@ -397,7 +455,12 @@ def show_lesson_page(lesson, lessons):
 
     # --- LEFT COLUMN: Lesson content ---
     with col1:
-        topics = lesson.get("topics", [])
+        # If the mini-quiz is active, render it and return early
+        if st.session_state.get("show_mini_quiz"):
+            render_mini_quiz_ui(lesson)
+            return
+
+        topics = get_display_topics(lesson)
         if "current_topic" not in st.session_state:
             st.session_state.current_topic = 1
 
@@ -411,32 +474,25 @@ def show_lesson_page(lesson, lessons):
 
         st.subheader(f"Topic {st.session_state.current_topic}: {topic_name}")
 
-        # --- Special handling for Play / Quiz / Normal ---
+        # --- Special handling for Play / Quiz / Summary / Normal ---
         if topic_name.lower().startswith("play"):
             st.info("🎮 This is a game-based activity to reinforce learning.")
             st.write("👉 Instructions on how to play go here.")
             if st.button("▶ Play Game", key=f"play_game_{lesson['id']}_{topic_idx}"):
-                st.markdown(
-                    '<a href="http://your-game-url.com" target="_blank">Open Game in New Tab</a>',
-                    unsafe_allow_html=True
-                )
+                st.markdown('<a href="http://your-game-url.com" target="_blank">Open Game in New Tab</a>', unsafe_allow_html=True)
 
         elif "quiz" in topic_name.lower():
-            st.info("📝 Time for a quick quiz!")
-            st.write("👉 Answer the following questions to test your knowledge.")
-            answer = st.radio("Q1. What is money?", ["Coins", "Bananas", "Shoes"])
-            if st.button("Submit Answer", key=f"quiz_submit_{lesson['id']}_{topic_idx}"):
-                if answer == "Coins":
-                    st.success("✅ Correct!")
-                else:
-                    st.error("❌ Try again.")
+            # kept only for compatibility; normally hidden by get_display_topics
+            st.info("📝 Quick quiz (legacy). This is superseded by the auto mini-quiz at completion.")
+
+        elif topic_name.lower() == "summary":
+            st.info("🧾 Module Summary")
+            summary_html = summarize_first_n_topics(lesson["id"], MAX_TOPICS)
+            st.markdown(f"<div class='topic-content'>{summary_html}</div>", unsafe_allow_html=True)
+
         else:
             content = load_topic_content(lesson["id"], st.session_state.current_topic)
-            st.markdown(f"""
-            <div class="topic-content">
-                {content}
-            </div>
-            """, unsafe_allow_html=True)
+            st.markdown(f"<div class='topic-content'>{content}</div>", unsafe_allow_html=True)
 
         # Topic navigation buttons
         prev_col, next_col = st.columns([1, 1])
@@ -454,37 +510,29 @@ def show_lesson_page(lesson, lessons):
             is_last_topic = (st.session_state.current_topic >= len(topics))
 
             if not is_last_topic:
-                # Normal next
                 if st.button("Next Topic ➡", key=f"next_topic_{lesson['id']}", type="primary"):
                     st.session_state.current_topic += 1
                     st.rerun()
             else:
-                # 🔥 Replace Next with Complete on the last topic
+                # Last page = Summary → trigger the mini-quiz (2–4 questions)
                 if not _is_lesson_completed(lesson["id"]):
                     if st.button("✅ Complete Module", key=f"complete_{lesson['id']}", type="primary"):
-                        _complete_lesson(lesson)
-                        st.success("🎉 Module completed! Great job.")
-                        # After completion, bounce back to lessons
-                        st.session_state.selected_lesson = None
-                        st.session_state.current_topic = 1
-                        st.session_state.start_lesson = False
+                        st.session_state.mini_quiz_items = generate_mini_quiz()
+                        st.session_state.mini_quiz_answers = {}
+                        st.session_state.mini_q_idx = 0
+                        st.session_state.show_mini_quiz = True
                         st.rerun()
                 else:
                     st.button("✅ Completed", key=f"completed_{lesson['id']}", disabled=True)
             st.markdown("</div>", unsafe_allow_html=True)
 
-
     # --- RIGHT COLUMN: Progress + Lesson navigation ---
     with col2:
         st.subheader("📊 Progress")
         _ensure_progress_state()
-        topics_count = max(1, len(lesson.get("topics", [])))
+        topics_count = max(1, len(get_display_topics(lesson)))
         seen = st.session_state.topic_progress.get(lesson["id"], 0)
-        # progress is capped at total topics, and if marked complete, force to full
-        if _is_lesson_completed(lesson["id"]):
-            pct = 1.0
-        else:
-            pct = min(seen / topics_count, 1.0)
+        pct = 1.0 if _is_lesson_completed(lesson["id"]) else min(seen / topics_count, 1.0)
         st.progress(pct)
 
         st.subheader("➡ Lesson Navigation")
@@ -502,9 +550,93 @@ def show_lesson_page(lesson, lessons):
                 st.session_state.current_topic = 1
                 st.rerun()
 
-
     st.markdown("---")
-   
+
+def render_mini_quiz_ui(lesson: dict):
+    st.markdown("### 📝 Mini Quiz")
+    items = st.session_state.get("mini_quiz_items") or []
+    if not items:
+        st.warning("No questions available.")
+        if st.button("Back"):
+            st.session_state.show_mini_quiz = False
+            st.rerun()
+        return
+
+    idx = int(st.session_state.get("mini_q_idx", 0))
+    idx = max(0, min(idx, len(items)))
+    st.session_state.mini_q_idx = idx
+
+    # Not finished → show current question
+    if idx < len(items):
+        q = items[idx]
+        st.subheader(f"Q{idx+1}. {q.get('question','')}")
+        opts = q.get("options", []) or []
+        key = f"mini_{idx}"
+        prev = st.session_state.mini_quiz_answers.get(idx)
+        default_index = (opts.index(prev) if (isinstance(prev, str) and prev in opts) else 0) if opts else 0
+        choice = st.radio("Select one:", opts or ["(no options)"], index=default_index, key=key)
+        st.session_state.mini_quiz_answers[idx] = choice
+
+        c1, c2 = st.columns(2)
+        with c1:
+            if idx > 0 and st.button("⬅ Previous"):
+                st.session_state.mini_q_idx -= 1
+                st.rerun()
+        with c2:
+            if st.button("Next ➡" if idx < len(items)-1 else "Submit Quiz"):
+                if idx < len(items)-1:
+                    st.session_state.mini_q_idx += 1
+                else:
+                    # grade
+                    def _letter_for(item, selected_text):
+                        ops = item.get("options", []) or []
+                        if selected_text in ops:
+                            return chr(65 + ops.index(selected_text))
+                        return ""
+
+                    letters = [_letter_for(items[i], st.session_state.mini_quiz_answers.get(i, "")) for i in range(len(items))]
+                    backend_score = grade_via_backend(letters)
+                    if backend_score:
+                        score, total = backend_score.get("score", 0), backend_score.get("total", len(items))
+                    else:
+                        score, total = grade_locally(items, letters)
+
+                    st.session_state.mini_quiz_result = {"score": score, "total": total, "answers": letters}
+                    st.session_state.mini_q_idx = len(items)  # mark finished
+                st.rerun()
+        return
+
+    # Finished → results and tutor handoff
+    res = st.session_state.get("mini_quiz_result") or {"score": 0, "total": len(items)}
+    percent = int(round(100 * res["score"] / max(1, res["total"])))
+    st.success(f"🎉 Mini Quiz Completed — Score: {percent}% ({res['score']}/{res['total']})")
+
+    # Tutor handoff (backend preferred; fallback message)
+    tutor = coach_or_celebrate_via_backend(res.get("answers", []))
+    if tutor and tutor.get("route") == "coach":
+        st.info(f"💬 Tutor: {tutor.get('feedback','Great effort—review the tricky parts and try again!')}")
+    elif tutor and tutor.get("route") == "celebrate":
+        st.success(f"🏆 Tutor: {tutor.get('message','Excellent work!')}")
+    else:
+        st.info("💬 Tutor: Nice work! If anything felt tricky, review the Summary above and try a practice game.")
+
+    colA, colB = st.columns(2)
+    with colA:
+        if st.button("🔁 Retake Mini Quiz"):
+            st.session_state.mini_q_idx = 0
+            st.session_state.mini_quiz_answers = {}
+            st.session_state.mini_quiz_result = None
+            st.rerun()
+    with colB:
+        if st.button("Finish Module ✅"):
+            _complete_lesson(lesson)
+            # reset quiz state
+            for k in ["show_mini_quiz", "mini_quiz_items", "mini_quiz_answers", "mini_q_idx", "mini_quiz_result"]:
+                st.session_state.pop(k, None)
+            st.session_state.selected_lesson = None
+            st.session_state.current_topic = 1
+            st.session_state.start_lesson = False
+            st.rerun()
 
 def render_assigned_lesson(lesson_id: int, assignment_id: int | None = None):
     """Render a teacher-assigned lesson from the DB using the SAME structure/CSS as general lessons."""
@@ -521,24 +653,19 @@ def render_assigned_lesson(lesson_id: int, assignment_id: int | None = None):
 
     L = data["lesson"]
     sections = sorted(data.get("sections", []), key=lambda s: int(s.get("position", 0)))
-    # 👉 adapt to the same card/page structure used by general lessons
     lesson = _db_to_general_lesson_shape(L, sections)
 
-    # initialization flags (mirror general flow)
     if "start_lesson" not in st.session_state:
         st.session_state.start_lesson = False
     if "selected_lesson" not in st.session_state:
         st.session_state.selected_lesson = lesson["id"]
 
-    # Show like general: first a detail screen with Start, then topic pages
     if st.session_state.start_lesson:
         show_db_lesson_page(lesson)
     else:
         show_db_lesson_detail(lesson)
 
-
 def show_db_lesson_detail(lesson):
-    # Same header + objectives block as your general detail view
     st.markdown(f"""
         <h1 style="font-size:2.5rem; margin-bottom:0;">{lesson['title']}</h1>
         <p style="color: #666; margin-top:0;">{lesson['duration']} &nbsp;•&nbsp; Module &nbsp;•&nbsp; {len(lesson.get("topics", []))} units</p>
@@ -573,7 +700,6 @@ def show_db_lesson_detail(lesson):
         st.session_state.selected_lesson = None
         st.rerun()
 
-
 def show_db_lesson_page(lesson):
     # Back link – same as general
     if st.button("⬅ Back to Lessons", key=f"db_back_top_{lesson['id']}"):
@@ -613,11 +739,9 @@ def show_db_lesson_page(lesson):
 
         st.subheader(f"Topic {st.session_state.current_topic}: {topic_name}")
 
-        # Same content container + CSS class as general
         body = (sections[idx].get("content") or "⚠️ Topic content not available.")
         st.markdown(f"<div class='topic-content'>{body}</div>", unsafe_allow_html=True)
 
-        # Prev/Next / Complete – identical logic
         prev_col, next_col = st.columns([1, 1])
         with prev_col:
             st.markdown("<div class='topic-nav-btn prev-btn'>", unsafe_allow_html=True)
@@ -657,7 +781,6 @@ def show_db_lesson_page(lesson):
         st.progress(pct)
 
         st.subheader("➡ Lesson Navigation")
-        # For DB lessons, we don’t have a linear list like catalog; just basic controls
         if st.button("⬅ Back to Lessons", key=f"db_back_side_{lesson['id']}"):
             st.session_state.selected_lesson = None
             st.session_state.current_topic = 1
@@ -665,7 +788,6 @@ def show_db_lesson_page(lesson):
 
     st.markdown("---")
 
-
 def show_page():
     # Load CSS
     css_path = os.path.join("assets", "styles.css")
@@ -682,8 +804,7 @@ def show_page():
     user = st.session_state.user
     user_level = user.get("level", "beginner").lower()
 
-    # Deep link from Teacher Link: if a selected_lesson isn't in the catalog,
-    # render it from the DB instead.
+    # Deep link from Teacher Link: if a selected_lesson isn't in the catalog, render it from the DB instead.
     deep_lesson_id = st.session_state.get("selected_lesson")
     deep_assignment_id = st.session_state.get("selected_assignment")