Wissenscoach Audio-Guide (kurven-schule-audio-guide)

Interaktive Sprachassistenz, Q&A Mini-Podcasts und Audio-Guide für kurven.schule®.

---

🎯 Zweck

Der Wissenscoach Audio-Guide schließt die Lücke zwischen dem geschriebenen Fahrtechnik-Wissen auf kurven.schule und dem Fahrer im Alltag oder auf Tour:

1. Sprachfrage stellen: Fahrer spricht eine Frage ein (z. B. am Pass, in der Pause oder auf der Couch).
2. Lokale Inferenz-Kette (macii):
   • Transkription via whisper.cpp (large-v3-turbo auf Port 8767).
   • RAG-Abgleich gegen die kuratierte kurven.schule® Trainingsdoktrin via bge-m3 (macii:11434).
   • Generierung eines 45–60 Sekunden Mini-Podcast-Skripts durch gemma4:26b im Ton von Chef-Instruktor André Jung.
   • Sprachsynthese via lokalem TTS (macii:8768).
3. Player & Kurs-Bridge: Der Fahrer hört die fundierte Antwort direkt im Browser-Widget und erhält die passende Kurs-Empfehlung.

---

🏗 Architektur

[Browser: ks-wissen Drawer]
         │ (WebM/Opus Audio)
         ▼
[kurven-schule-audio-guide Service]
   ├── 1. STT:      http://100.107.247.109:8767/inference (Whisper Large-v3-Turbo)
   ├── 2. RAG:      http://100.107.247.109:11434/api/embeddings (BGE-M3)
   ├── 3. LLM:      http://100.107.247.109:11434/api/generate (Gemma4:26b)
   └── 4. TTS:      http://100.107.247.109:8768/synthesize (Kokoro / XTTS)
         │ (MP3/Opus Stream + JSON Metadata)
         ▼
[Browser: Audio-Visualizer + Kurs-Card]

---

📚 Dokumentation & Spezifikationen

Strategie & Betriebskonzept

• One-Man-Show Operating Model — 4 virtuelle KI-Rollen & das 5-Minuten-Tagesritual mit 1-Klick-Freigabe
• motopost-v3 Social Flywheel — B-Roll Dynamic-Video Pipeline & Multi-Channel Post-Erstellung
• Zero-Kamera Video-Pipeline — 5 Säulen für kinoreife 9:16 Reels ohne eigenes Drehen (3D-Physik, Veo 2.0, Kamm'scher Kreis)
• DeepSeek Härtungsplan P0–P2 — Konkrete Maßnahmen zur Anhebung des Scores von 51 auf 88+ Punkte
• DeepSeek-R1 Adversarial Review Report — Vollständiger Prüfbericht (Score 51/100, Top 5 Bruchstellen)

Funktionale Spezifikationen

• Pflichtenheft — User Journey & fachliche Anforderungen
• Lastenheft & Technische Spezifikation — Schnittstellen (Whisper, Gemma 4, RAG, TTS)
• Systemarchitektur & Flow — Caching, Latenzbudget, Token-Effizienz
• Social Media Funnel & Audiogramme — 9:16 Video-Rendering
• Kunden-Akquise Voice Funnel — Vertrauensaufbau & Kursempfehlung
• Trainer-Akquise Voice Audition — 60s Sprachprobe für Expansion 2027

---

📋 Roadmap

Siehe TODO.md für den aktuellen Fortschritt und offene Arbeitspakete.

🧪 Tests

npm test