# Plappi — Produkt-Spec v1 (abgestimmt 2026-06-21)

Bilingualer KI-Sprach-Tutor für Kinder. Handy-App jetzt, Raspberry-Pi-Gerät später,
**gleiches Backend**. Status: Scope abgestimmt mit Nemanja. Blocker: ElevenLabs-API-Key.

## Entscheidungen (fix)
- **Engine:** Hosted Realtime-Speech-to-Speech über **ElevenLabs Conversational AI** (<1 s, beste Stimme). Persona/Lernlogik/Sicherheit = unser System-Prompt (`plappi-agent-prompt.md`). Architektur bleibt „dünner Client ↔ Backend-Gehirn ↔ austauschbare Engine".
- **Aktivierung:** **Wake-Word „Plappi"** (KEIN Knopf) → Piep → hört zu → reagiert → Konversationsmodus → zurück ins Lauschen.
  - Handy: Picovoice Porcupine (Browser/WASM, custom „Plappi"), lauscht solange App offen.
  - Pi (später): openWakeWord (OSS), echtes Always-On offline.
- **Bilingualität:** **3 einstellbare Stufen, Default „sanft"** (überwiegend Deutsch + klar markierte, korrekt ausgesprochene serbische Zielwörter). Sanft → ausgewogen → immersiv. Kein chaotisches Mischen.
- **Sprachpaar Start:** Deutsch → Serbisch (Nemanjas Familie). Später bis 27.
- **Pädagogik:** Aussprache-Lob/sanfte Korrektur, Vokabel-Tracking, Spaced Repetition, strukturierte Themen.

## v1-Funktionsumfang (alle 4 Gruppen)
**A · Gespräch & Stimme (Kern)**
- Wake-Word „Plappi" + Piep + Zuhören
- Echtzeit-Sprachdialog <1 s (ElevenLabs S2S)
- Konversationsmodus (Folgefragen ohne erneutes „Plappi")
- Bilingual-Stufe (sanft/ausgewogen/immersiv)
- Aussprache-Lob & sanfte Korrektur
- Plappi-Charakter + Sound-Design (Piep, Chimes)

**B · Lernen & Pädagogik**
- Vokabel-Tracking (welche Wörter gelernt/geübt)
- Spaced Repetition (Wörter kehren gezielt wieder)
- Strukturierte Themen/Lektionen (Tiere, Farben, Zahlen, Familie, Begrüßung, Essen)

**C · Eltern & Einstellungen**
- Einstellungen: Sprachen, Bilingual-Stufe, Stimme, Alter, Zeitlimit
- Einfaches Fortschritts-Dashboard (gelernte Wörter, Zeit)

**D · Sicherheit & Datenschutz**
- Kindersichere Guardrails (Persona)
- „Sprich mit einem Erwachsenen"-Umlenkung bei heiklen Themen
- Eltern-Gate (Einstellungen hinter Rechen-Sperre)
- EU-AI-Act-Transparenz („Ich bin ein Lern-Spielzeug")
- COPPA/DSGVO: Consent, Aufbewahrungs-/Lösch-Kontrolle, keine Kinderdaten ins Training

## Roadmap (nach v1)
Mini-Spiele · interaktive bilinguale Geschichten (knüpft an tiptoi-Erbe) · Level/Streaks/adaptives Niveau ·
Mehrere Kinder-Profile · Curriculum-Updates (Abo-Wert) · Pi-Gerät Always-On · Offline-Fallback (Anti-Brick) ·
native App (echtes Hintergrund-Wake-Word) · weitere Zielsprachen.

## Architektur
```
Wake-Word (lokal, Porcupine/openWakeWord)
   → Piep → Mikro-Stream
      → ElevenLabs-Agent (ASR+LLM+TTS, unser System-Prompt)   ← austauschbar
      → Antwort-Audio + Transkript
   → Konversationsmodus / zurück ins Lauschen
Backend (FastAPI) hält: Sessions, Vokabel-/Fortschritts-Daten, Eltern-Settings, Safety.
Clients: clients/web (Handy-PWA) · clients/pi (Gerät, später) — gleiche API.
```

## Realistische Phasierung (WICHTIG)
Die **volle umfängliche v1 ist ein Mehr-Wochen-Build**, nicht 3 Tage. Daher gestaffelt:

- **Phase 0 — ORF-Demo-Slice (bis 24.06.):** Wake-Word „Plappi" + Piep · Echtzeit-Bilingual-Dialog · Aussprache-Lob · Geräte-Look (Pi/Tablet in Hülle) · einstudierter Golden-Path + Offline-Fallback · DE→SR mit Tochter-Name. *Das ist auf Kamera „fertig".*
- **Phase 1 — Umfängliche v1:** komplette Gruppen A–D (Vokabel-Tracking, Spaced Repetition, Themen, Eltern-Settings, Safety/Datenschutz-Layer).
- **Phase 2 — Roadmap:** s. o.

## Offene Blocker
1. **ElevenLabs-API-Key** (Nemanja) → in `/home/agent/etc/secrets.env` als `ELEVENLABS_API_KEY=…`.
2. **Serbisch-Verifikation** (ich, sobald Key da) — 6 Testwörter synthetisieren + prüfen.
3. **HTTPS/Tunnel** fürs Handy-Mikro (Browser-Mikro braucht TLS/localhost).
4. **Custom Wake-Word „Plappi"** in Picovoice-Console trainieren (.ppn).
5. **Geräte-Hülle** für ORF (Pi/Tablet + simple Hülle) — Einkauf/Bau.