Update src/streamlit_app.py

src/streamlit_app.py

@@ -1,40 +1,234 @@
-import altair as alt
-import numpy as np
-import pandas as pd
 import streamlit as st
+import requests
+from bs4 import BeautifulSoup
+from sentence_transformers import SentenceTransformer, util
+import numpy as np
 
-"""
-# Welcome to Streamlit!
 
-Edit `/streamlit_app.py` to customize this app to your heart's desire :heart:.
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
 
-In the meantime, below is an example of what you can do with just a few lines of code:
+# Load an embedding model
+@st.cache_resource
+def load_model():
+  return SentenceTransformer('mixedbread-ai/deepset-mxbai-embed-de-large-v1')
+
+# Ideal answer for comparison
+IDEAL_ANSWER = """
+Das Weihnachtsfest in Deutschland ist geprägt von einer Vielzahl an Bräuchen, Symbolen und Traditionen, die regional unterschiedliche Ausprägungen haben.
+Neben allgemeinen, landesweiten Traditionen existieren in den einzelnen Regionen eigene Bräuche, die das Weihnachtsfest besonders machen.
+
+Allgemeine Bräuche und Symbole
+Zu den bekanntesten Symbolen und Bräuchen, die landesweit verbreitet sind, zählen der Adventskranz, der Weihnachtsbaum, der Nikolaustag, der Weihnachtsmarkt sowie bestimmte kulinarische Spezialitäten.
+Diese Traditionen schaffen eine festliche Atmosphäre und symbolisieren für viele Deutsche die Weihnachtszeit.
+
+Advent und Adventskranz: Der Advent, die Vorbereitungszeit auf Weihnachten, beginnt am vierten Sonntag vor Weihnachten.
+In dieser Zeit wird oft ein Adventskranz mit vier Kerzen aufgestellt, von denen jeden Sonntag eine weitere angezündet wird.
+Dieser Brauch ist besonders im ganzen Land verbreitet und symbolisiert die wachsende Vorfreude auf das Fest.
+
+Weihnachtsbaum: Der Weihnachtsbaum ist das zentrale Symbol des Weihnachtsfestes in Deutschland.
+Meistens wird er am Heiligen Abend aufgestellt und mit Kerzen, Kugeln und manchmal auch selbstgebasteltem Schmuck dekoriert.
+Der Brauch stammt ursprünglich aus dem Elsass und verbreitete sich im 19. Jahrhundert über ganz Deutschland.
+
+Nikolaustag: Am 6. Dezember wird der Nikolaustag gefeiert. Kinder stellen am Abend vorher ihre Stiefel vor die Tür, die über Nacht vom „Nikolaus“ mit Süßigkeiten und kleinen Geschenken gefüllt werden.
+Dieser Brauch ist in vielen Regionen verbreitet, zeigt jedoch in einigen Gebieten, besonders in Süddeutschland, Abweichungen, da dort oft der „Knecht Ruprecht“ oder „Krampus“ den Nikolaus begleitet.
+
+Weihnachtsmärkte: Weihnachtsmärkte sind in Deutschland besonders beliebt und gehören zur Adventszeit.
+Sie bieten regionale Spezialitäten, Weihnachtsdekoration und handgemachte Geschenke. Bekannte Weihnachtsmärkte gibt es in Städten wie Nürnberg, Dresden und München.
+Diese Märkte variieren in ihrem Angebot und Charakter je nach Region, was besonders für Touristen attraktiv ist.
+
+Weihnachtsessen: Traditionell wird am Heiligen Abend oft eine einfache Mahlzeit wie Kartoffelsalat mit Würstchen serviert, während das Festessen am ersten Weihnachtstag stattfindet.
+Gänsebraten, Rotkohl und Klöße sind typische Speisen für das Weihnachtsessen. Auch hier gibt es regionale Unterschiede: Im Süden Deutschlands werden oft Bratwürste serviert, während im Norden Fischgerichte beliebter sind.
+
+Regionale Unterschiede
+Die regionalen Unterschiede beim Weihnachtsfest in Deutschland zeigen sich nicht nur in der Art der Bräuche, sondern auch in speziellen Traditionen:
+
+Bayern und der Alpenraum: In Bayern und im Alpenraum gibt es besonders reichhaltige Bräuche. Hier ist das „Krippenspiel“ weit verbreitet, bei dem die Geburt Jesu in einem kleinen Theaterstück nachgestellt wird.
+In vielen Dörfern und Städten findet auch das „Christkindl-Anschießen“ statt, bei dem Schützenvereine am Heiligen Abend Böllerschüsse abfeuern, um das Christkind willkommen zu heißen.
+
+Norddeutschland: In Norddeutschland sind Weihnachtslieder und das Singen von Shanties, also traditionellen Seemannsliedern, häufig Teil der Festlichkeiten.
+Auch die Dekoration unterscheidet sich leicht, mit einem stärkeren Fokus auf maritime Symbole. Der Weihnachtsmann braven Kindern am Heiligen Abend Geschenke.
+
+Sachsen und das Erzgebirge: Sachsen, insbesondere das Erzgebirge, ist bekannt für seinen reich verzierten Weihnachtsschmuck und das Kunsthandwerk.
+Schwibbögen, Räuchermännchen und Nussknacker sind Symbole dieser Region und stammen ursprünglich aus der Bergbaugeschichte des Erzgebirges, in der Licht eine besondere Rolle spielte.
+
+Rheinland: Im Rheinland ist die Tradition des Sternsingens weit verbreitet. Kinder ziehen als „Heilige Drei Könige“ verkleidet von Haus zu Haus und singen Lieder, um Spenden für wohltätige Zwecke zu sammeln.
+Diese Tradition wird zwar auch in anderen Teilen Deutschlands gepflegt, hat jedoch im Rheinland eine besonders lange Geschichte.
 """
 
-num_points = st.slider("Number of points in spiral", 1, 10000, 1100)
-num_turns = st.slider("Number of turns in spiral", 1, 300, 31)
-
-indices = np.linspace(0, 1, num_points)
-theta = 2 * np.pi * num_turns * indices
-radius = indices
-
-x = radius * np.cos(theta)
-y = radius * np.sin(theta)
-
-df = pd.DataFrame({
-    "x": x,
-    "y": y,
-    "idx": indices,
-    "rand": np.random.randn(num_points),
-})
-
-st.altair_chart(alt.Chart(df, height=700, width=700)
-    .mark_point(filled=True)
-    .encode(
-        x=alt.X("x", axis=None),
-        y=alt.Y("y", axis=None),
-        color=alt.Color("idx", legend=None, scale=alt.Scale()),
-        size=alt.Size("rand", legend=None, scale=alt.Scale(range=[1, 150])),
-    ))
+KEYWORDS = [
+    "Advent", "Adventskranz", "Weihnachtsbaum", "Nikolaus", "Weihnachtsmarkt", "Weihnachtsessen",
+    "Weihnachtslieder", "Weihnachtsschmuck", "Krippenspiel", "Weihnachtsgebäck", "Bescherung", "Wichteln"
+]
+
+REGION_KEYWORDS = {
+    "Süddeutschland": ["Christkind", "Krampus", "Böllerschüsse"],
+    "Norddeutschland": ["Weihnachtsmann", "Weihnachtslieder"],
+    "Ostdeutschland": ["Schwibbogen", "Weihnachtspyramide", "Nussknacker"],
+    "Westdeutschland": ["Sternsingen", "Adventskalender"]
+}
+
+@st.cache_data
+def get_ideal_embedding():
+    model = load_model()
+    return model.encode(IDEAL_ANSWER, convert_to_tensor=True)
+
+# --- HELPER FUNCTIONS ---
+def fetch_wikipedia_content(url):
+  if "wikipedia.org" not in url:
+        return None
+  headers = {'User-Agent': 'EducationalSchoolProject/1.0'}
+  try:
+        response = requests.get(url, headers=headers, timeout=5)
+        if response.status_code != 200:
+            return None
+            
+        soup = BeautifulSoup(response.text, 'html.parser')
+        
+        content_div = soup.find('div', {'id': 'mw-content-text'})
+        if content_div:
+            paragraphs = content_div.find_all('p')
+            content = ' '.join([para.text for para in paragraphs])
+            return content
+        return None
+  except Exception as e:
+        return None
+
+def evaluate_contexts(student_texts):
+    model = load_model()
+    ideal_embedding = get_ideal_embedding()
+    
+    scores = {"relevance": [], "completeness": 0, "regional_completeness": 0}
+    all_found_keywords = set()
+    combined_text = " ".join(student_texts)
+
+    for text in student_texts:
+        student_embedding = model.encode(text, convert_to_tensor=True)
+        relevance_score = util.cos_sim(student_embedding, ideal_embedding).item()
+        scores["relevance"].append(relevance_score)
+
+        found = [k for k in KEYWORDS if k.lower() in text.lower()]
+        all_found_keywords.update(found)
+
+    scores["relevance"] = np.mean(scores["relevance"]) if scores["relevance"] else 0
+    scores["completeness"] = len(all_found_keywords) / len(KEYWORDS)
+
+    regions_covered = 0
+    total_regions = len(REGION_KEYWORDS)
+    for region, words in REGION_KEYWORDS.items():
+        if any(word.lower() in combined_text.lower() for word in words):
+            regions_covered += 1      
+    scores["regional_completeness"] = regions_covered / total_regions
+
+    return scores
+
+# --- STREAMLIT UI ---
+st.set_page_config(page_title="Weihnachts-Elf Trainer", page_icon="🎅")
+
+st.title("🎄 Weihnachts-Traditionen: Kontextbewertung für KI")
+
+st.markdown("""
+    <div style="background-color: #262730; padding: 20px; border-radius: 10px; border: 1px solid #4B4B4B; margin-bottom: 20px;">
+    <h3>🎅 Aufgabe: Trainiere den Weihnachts-Elf</h3>
+    <p>Wir bauen einen KI-Agenten, der Touristen Fragen zu Weihnachten in Deutschland beantwortet. 
+    Aber: <strong>Der Elf weiß nur das, was DU ihm zu lesen gibst!</strong></p>
+    <p>Finde Wikipedia-Artikel, die diese Frage perfekt beantworten:</p>
+    <blockquote style="background-color: #3e3e3e; color: white;"><em>„Welche unterschiedlichen Bräuche, Symbole und Traditionen prägen das Weihnachtsfest in Deutschland, und welche regionalen Unterschiede gibt es dabei?“</em></blockquote>
+    </div>
+    """, unsafe_allow_html=True
+)
+
+with st.expander("📜 Anleitung für Wissens-Trainer (Hier klicken)", expanded=True):
+    st.markdown("""
+    ### 1. Deine Mission
+    Deine Aufgabe ist es, **Quellen auszuwählen**, die dem Elf helfen, eine **vollständige** und **richtige** Antwort zu geben. Du lernst dabei, wie man einer KI Kontext gibt (Prompt Engineering / RAG).
+    
+    ### 2. Werkzeugkiste: Suchstrategien
+    Der Elf akzeptiert nur **Wikipedia-Links**. Nutze Google clever, um die besten Artikel zu finden:
+    
+    * **Der Basis-Trick:** Suche nur auf Wikipedia.
+        * `site:de.wikipedia.org Weihnachten`
+    * **Der Präzisions-Laser (Exakte Suche):** Finde genaue Phrasen.
+        * `"Weihnachtsbräuche in Norddeutschland"` (in Anführungszeichen!)
+    * **Der Inhalt-Scanner (Intext):** Suche Wörter, die im Text vorkommen müssen.
+        * `intext:Erzgebirge intext:Weihnachten`
+    * **Qualität vor Quantität:** Wähle max. 8 Artikel aus, die *wirklich* die Frage beantworten.
+    
+    ### 3. So bewertet der Elf dein Training
+    Sobald du die Links eingibst, prüft der Elf dein Trainingsmaterial auf drei Werte:
+    
+    * 🧠 **Relevanz:** Passt der Artikel wirklich zum Thema "Weihnachten in Deutschland"? (Semantic Similarity)
+    * 📚 **Vollständigkeit:** Kennt der Elf danach die wichtigsten Begriffe (Adventskranz, Nikolaus, etc.)?
+    * 🌍 **Regionale Abdeckung:** Weiß der Elf, dass man in Bayern anders feiert als an der Ostsee?
+    """)
+
+st.write("---")
+st.subheader("🔗 Füttere den Elf mit Wissen")
+
+with st.form("training_form"):
+    num_links = st.number_input("Wie viele Artikel hast du gefunden? (1-8)", min_value=1, max_value=8, value=1)
+    
+    urls = []
+    st.caption("Füge hier deine Wikipedia-Links ein:")
+    for i in range(num_links):
+        urls.append(st.text_input(f"Link {i + 1}", placeholder="https://de.wikipedia.org/wiki/..."))
+    
+    submitted = st.form_submit_button("🚀 Training starten & Auswerten")
+
+if submitted:
+    student_texts = []
+    
+    with st.spinner("Der Elf liest deine Artikel... 📖"):
+        # Fetch content
+        for url in urls:
+            if url.strip():
+                content = fetch_wikipedia_content(url)
+                if content:
+                    student_texts.append(content)
+        
+        if len(student_texts) >= 1:
+            scores = evaluate_contexts(student_texts)
+            
+            st.write("---")
+            st.subheader("📊 Trainings-Ergebnis")
+            
+            # Metrics Columns
+            col1, col2, col3 = st.columns(3)
+            col1.metric("🧠 Relevanz", f"{scores['relevance']:.2f}", help="> 0.6 ist gut")
+            col2.metric("📚 Vollständigkeit", f"{int(scores['completeness']*100)}%", help="Wie viele Keywords gefunden?")
+            col3.metric("🌍 Regional", f"{int(scores['regional_completeness']*100)}%", help="Wie viele Regionen abgedeckt?")
+
+            # Feedback Logic (Rewritten Tone)
+            feedback = []
+            
+            # Relevance Feedback
+            if scores["relevance"] > 0.65:
+                feedback.append("✅ **Super Fokus:** Die Artikel passen perfekt zum Thema.")
+            elif scores["relevance"] > 0.4:
+                feedback.append("⚠️ **Geht so:** Die Artikel passen grob, aber es ist viel unwichtiges Zeug dabei.")
+            else:
+                feedback.append("❌ **Thema verfehlt:** Der Elf ist verwirrt. Die Artikel handeln kaum von Weihnachten.")
+
+            # Completeness Feedback
+            if scores["completeness"] > 0.8:
+                feedback.append("✅ **Weihnachts-Profi:** Du hast fast alle wichtigen Traditionen abgedeckt!")
+            elif scores["completeness"] > 0.5:
+                feedback.append("⚠️ **Lückenhaft:** Einige Klassiker fehlen (vielleicht Essen oder Nikolaus?).")
+            else:
+                feedback.append("❌ **Anfänger-Wissen:** Da fehlen sehr viele Grundlagen.")
+
+            # Regional Feedback
+            if scores["regional_completeness"] > 0.7:
+                feedback.append("✅ **Deutschlandreise:** Von den Alpen bis zur See ist alles dabei!")
+            elif scores["regional_completeness"] > 0.4:
+                feedback.append("⚠️ **Lokalpatriot:** Du hast manche Regionen gut abgedeckt, aber andere fehlen.")
+            else:
+                feedback.append("❌ **Zu allgemein:** Der Elf kennt keine regionalen Unterschiede. Suche nach spezifischen Bundesländern!")
+
+            # Display Feedback
+            st.info("\n\n".join(feedback))
+
+            # Victory Condition
+            if scores["relevance"] > 0.6 and scores["completeness"] > 0.6 and scores["regional_completeness"] > 0.7:
+                st.balloons()
+                st.success("🎉 HERVORRAGEND! Der Elf ist bereit für seinen Einsatz! Die Auswahl der Artikel ist sehr gut!")
+        else:
+            st.error("⚠️ Hoppla! Der Elf konnte die Links nicht lesen. Sind es echte Wikipedia-Links? (Beginnend mit https://de.wikipedia.org...)")