# 🎓 Exam and Quiz Hub für Obsidian

**Die all-in-one Lern-, Quiz- und Klausursimulation direkt in deinem Obsidian-Vault.**  
Bereite dich optimal auf Prüfungen vor, simuliere echte Klausuren unter realistischem Zeitdruck, lerne entspannt im zeitlimitfreien **Quiz-Modus mit sofortigem Feedback**, füttere deinen virtuellen **Tamagotchi-Drachen** mit täglichen Lernerfolgen und schließe Wissenslücken mit dem intelligenten Fehlerspeicher – **100 % offline, datenschutzsicher und optimiert für Desktop, Smartphone & Tablet**.

---

## 🚀 Schnellstart in 3 Schritten

1. **Plugin öffnen:** Klicke auf das **Doktorhut-Icon** in der linken Obsidian-Seitenleiste (oder drücke `Strg + P` bzw. `Cmd + P` und wähle *„Exam and Quiz Hub: Klausur-Dashboard öffnen“*).
2. **Klausur- oder Quiznotiz anlegen:** Lege im Ordner `exams/` eine Markdown-Notiz an (z. B. `exams/Biologie/Zellbiologie.md`).
   - Nutze `type: exam` für echte Prüfungssimulationen mit Countdown-Timer.
   - Nutze `type: quiz` für entspannte Wissens-Checks mit direktem Feedback nach jeder Frage.
3. **Training starten:** Öffne das Dashboard und klicke auf **„⏱️ Klausur starten“** oder **„⚡ Als Quiz spielen“** – oder trainiere einen gemischten **Modul-Mix** bzw. deinen **Fehlerspeicher**.

---

## ⚡ Klausur-Modus vs. Quiz-Modus: Dual-Play für jedes Bedürfnis

Exam and Quiz Hub bietet zwei perfekt aufeinander abgestimmte Lernmodi:

| Feature | ⏱️ Klausur-Modus (`type: exam`) | ⚡ Quiz-Modus (`type: quiz`) |
| :--- | :--- | :--- |
| **Ziel** | Realistische Prüfungssimulation | Aktives Lernen & Wissensaneignung |
| **Zeitlimit** | Countdown-Timer mit Prüfungsabgabe | 100 % zeitlimitfrei |
| **Feedback** | Gesamtauswertung am Prüfungsende | Sofortiges Feedback (Grün/Rot) nach jeder Frage |
| **Erklärungen** | Nach Abgabe im Ergebnisbericht | Direkt nach Klick auf „Prüfen & Lösung anzeigen“ |
| **Matrix-Anzeige** | Zeigt beantwortete / markierte Fragen | Färbt Kacheln live nach erreichten Punkten (Grün / Gelb / Rot) |
| **Dual-Play** | — | **Jede Klausur kann auf dem Dashboard auch als Quiz gespielt werden!** |

---

## 🐉 Das Tamagotchi: Dein virtueller Lernbegleiter

Auf deinem Dashboard begleitet dich dein persönlicher Wissensdrache durchs Studium:
* **10 liebevolle Evolutionsstufen:** Vom gesprenkelten Drachen-Ei über den frisch geschlüpften Wicht und den Schuldrachen bis zum legendären ehrwürdigen Wissensdrachen.
* **Gekoppelt an deinen Fleiß:** Der Drache wächst mit deiner täglichen **Lern-Streak** oder deinen erreichten **Levels / XP**.
* **Füttern durch Lernen:** Jedes gelöste Quiz schenkt **+25 % Sättigung**, jede absolvierte Klausur **+40 %**.
* **Kein Frust:** Der Drache kann niemals sterben! Bei längerer Inaktivität wird er lediglich schläfrig (min. 15 % Sättigung) und bittet in seiner Sprechblase um kleine Wissens-Snacks.
* **Interaktiv:** Streichle deinen Drachen für Zuneigung (`💖 Streicheln`) oder starte direkt ein 5-Fragen-Schnell-Quiz (`⚡ Jetzt füttern`). Über das Stift-Icon kannst du ihm jederzeit einen individuellen Namen geben!
* **Anpassbar:** In den Einstellungen lässt sich das Tamagotchi auf Wunsch mit einem Klick aktivieren oder deaktivieren.

---

## 💡 Wertvolle Tipps für deinen Prüfungserfolg

### 1. 🤖 Fragenerstellung mit den optimierten KI-Prompts
Du musst Fragen nicht mühsam von Hand tippen:
* Öffne die **Plugin-Einstellungen** in Obsidian.
* Wähle ganz unten den passenden Prompt:
  * **„📋 Klausur-Prompt kopieren“** für Prüfungen mit Zeitlimit (`type: exam`).
  * **„⚡ Quiz-Prompt kopieren“** für schnelle Wissens-Checks (`type: quiz`).
* Füge den Prompt zusammen mit deinen Vorlesungsfolien, Altklausuren oder PDF-Zusammenfassungen in ein beliebiges Sprachmodell (z. B. **ChatGPT, Claude oder Gemini**) ein.
* Kopiere den Markdown-Code als Notiz in deinen `exams/`-Ordner. Fertig!

### 2. 🎯 Der intelligente Fehlerspeicher (2×-Mastery-Regel)
* **Automatisches Sammeln:** Jede Frage, bei der du in einer Klausur oder einem Quiz Punkte verlierst, wandert automatisch in deinen persönlichen Fehlerspeicher.
* **Die 2×-Mastery-Regel:** Eine Frage gilt erst dann als dauerhaft verstanden und gemeistert, wenn du sie im Fehlerspeicher-Training **zweimal hintereinander fehlerfrei** beantwortest. Erst dann verlässt sie den Pool.
* **Tipp:** Starte jeden Lerntag mit einem kurzen Durchlauf des Fehlerspeichers auf dem Dashboard!

### 3. 🔀 Dynamischer Modul-Mix: Klausur oder Quiz auf Knopfdruck
* Nutze auf dem Dashboard den **Modul-Mix Generator**:
  * Wähle die gewünschten Module aus (z. B. `M1 + Biologie`).
  * Wähle zwischen **Klausur** (mit Zeitlimit) oder **Quiz** (mit direktem Feedback).
  * Bestimme die Fragenanzahl (z. B. 15 Fragen). Das Plugin mischt die Fragen zufällig durch.

### 4. 📱 Nahtlos mobil auf dem Smartphone & Tablet lernen
* Vollständig touch-optimiert ($\ge 44 \times 44\,\text{px}$ Touch-Targets) ohne störende Statusleistenüberlagerung.
* Schnelle Daumen-Navigation über die Kacheln (`1`, `2`, `3`...) und die Fußleiste.
* Über die **„Fragen-Matrix“ (▦)** hast du jederzeit den Gesamtüberblick.

### 5. ⌨️ Schneller navigieren am Desktop mit Tastenkürzeln
| Taste | Aktion |
| :--- | :--- |
| `1`, `2`, `3`, `4`, `5` | Antwortoptionen A bis E an- oder abwählen |
| `J` oder `Pfeil rechts` | Nächste Frage |
| `K` oder `Pfeil links` | Vorherige Frage |
| `M` | Frage für spätere Überprüfung markieren / entmarkieren (`⚑`) |
| `Strg + Enter` / `Cmd + Enter` | Klausur abschließen und auswerten |

### 6. 🛡️ Crash-Schutz & Auto-Save
* Alle 15 Sekunden sowie beim Verlassen der App speichert das Plugin deinen Sitzungsstand automatisch. Bei versehentlichem Schließen fragt Obsidian sofort, ob du die Sitzung nahtlos fortsetzen möchtest.

---

## 📝 Formatierung: Klausuren vs. Quizze

Alle Notizen liegen als Markdown-Dateien im Ordner `exams/` (oder Unterordnern wie `exams/M1/`).

### 1. Quiz-Notiz (`type: quiz`)
Perfekt für Übungsfragen, Karteikarten-Ersatz und Wissens-Checks:

```markdown
---
type: quiz
module: M1
title: Wissens-Check Klassische Konditionierung
shuffleQuestions: true
shuffleOptions: true
---

## Welche Aussagen zur klassischen Konditionierung treffen zu? ^q-quiz-01
type: multiple-choice
points: 5

- [x] Ein unkonditionierter Reiz (UCS) löst reflexartig eine UCR aus.
- [ ] Extinktion löscht die Gedächtnisspur vollständig und unwiderruflich.
- [x] Spontanerholung beschreibt das Wiederauftreten der CR nach einer Pause.
- [ ] Generalisierung bedeutet, dass nur der identische Reiz wirkt.
- [x] Konditionierung höherer Ordnung baut auf einem konditionierten Reiz auf.

> [!explanation]
> Extinktion ist Hemmungslernen (Inhibition), keine Löschung. Generalisierung reagiert auch auf Reizähnlichkeiten.
```

### 2. Klausur-Notiz (`type: exam`)
Für realistische Prüfungen mit Zeitdruck und Bestehensgrenze:

```markdown
---
type: exam
module: M1
semester: WiSe26/27
title: Probeklausur Grundlagen
timeLimitMinutes: 90
passingScore: 75%
shuffleQuestions: true
shuffleOptions: true
---

## Erkläre das Modell der Kognitiven Dissonanz nach Festinger. ^q-diss-02
type: freetext
points: 3

Musterloesung:
Kognitive Dissonanz beschreibt einen aversiven motivationalen Spannungszustand bei widersprüchlichen Kognitionen.

Kriterien:
1. Definition des aversiven Spannungszustands (1P)
2. Ursache: Widerspruch relevanter Kognitionen (1P)
3. Mindestens eine Reduktionsstrategie genannt (1P)

> [!explanation]
> Typische Reduktionsstrategien: Einstellungsänderung oder Hinzufügen konsonanter Kognitionen.
```

---

## ⚙️ Einstellungen & Anpassung

Unter **Obsidian-Einstellungen > Community-Plugins > Exam and Quiz Hub** hast du die volle Kontrolle:
* **Audio & Gamification nach Wunsch steuern:** Schalte Tamagotchi, Level-/XP-Leiste, Konfetti-Feuerwerk oder Audio-Töne einzeln ein oder aus.
* **Klausuren-Ordner:** Frei wählbar (Standard: `exams`).
* **Standard-Bestehensgrenze:** Voreingestellt auf **75 %**.
* **Geräte-Synchronisation:** Verwendet `exams/progress.md` für verlustfreien automatischen Abgleich über **Obsidian Sync, iCloud, Git oder Syncthing**.

---

## 🔄 Geräte-Synchronisation & `exams/progress.md`

Damit dein Lernfortschritt nahtlos zwischen Desktop, Laptop, Tablet und Smartphone synchronisiert wird, nutzt Exam and Quiz Hub eine Markdown-basierte Synchronisationsdatei:

* **Speicherort:** Standardmäßig `exams/progress.md` (Name und Ordner können in den Einstellungen angepasst werden).
* **Was wird synchronisiert?** Dein persönlicher **Fehlerspeicher**, **XP & Level**, **Lern-Streak**, **FSRS-Gedächtnisdaten** sowie der Zustand deines **Tamagotchi-Drachen**.
* **100 % zuverlässig mit Obsidian Sync:** Da es sich um eine reguläre Markdown-Notiz (`.md`) handelt, überträgt Obsidian Sync (sowie iCloud, Git oder Syncthing) deinen Lernfortschritt automatisch, sofort und ohne manuelle Konfiguration auf alle mobilen und Desktop-Geräte.
* ⚠️ **Wichtiger Hinweis:** Die Datei `exams/progress.md` ist für das Auslesen, Speichern und Synchronisieren deines Fortschritts zwingend erforderlich. **Bitte verändere oder lösche die Datei und insbesondere den darin eingebetteten JSON-Codeblock nicht manuell**, um Beschädigungen der Lerndaten oder Konflikte beim Zusammenführen zu vermeiden.

---

## 📦 Installation

- **Empfohlen über BRAT:** Füge in den BRAT-Einstellungen das Repository `tobiasottost-cmd/obsidian-quiz-hub` hinzu.
- **Manuell:** Kopiere `main.js`, `manifest.json` und `styles.css` in deinen Vault unter `.obsidian/plugins/exam-quiz-hub/` und aktiviere das Plugin in den Obsidian-Einstellungen.

Viel Erfolg bei deinen Prüfungen und Quizzen! 🎓🐉