test: Coverage für Gender-/Stimm-System + hermetische Suite

Schließt die Test-Lücken der Gender-/Stimm-Arbeit der letzten Tage:
- test_routing.py: voice_for_route über alle Sprachen × Geschlechter
  (inkl. ES Multi-Speaker #0/#1, "any"→weiblich, Gegengeschlecht-Fallback,
  AR/PT/ZH Einzelstimmen, unbekannte Sprache → None).
- test_piper_tts.py: _parse_speaker (#id) + Gender-Code-Auflösung in
  synthesize() + speaker_id-Durchreichung für Multi-Speaker.
- test_cartesia_tts.py (neu): Voice-Map-Parsing, _resolve_voice_id-Präzedenz,
  nicht unterstützte Sprachen, direkte-UUID-Durchreichung, Cartesia→Piper-Fallback.

Hermetik-Fix in conftest.py: Deployment-Fallback-Ketten (stt/llm/tts_fallback)
werden pro Test auf "" gesetzt. Vorher schlugen 3 WS-Streaming-Tests fehl, weil
llm_fallback="openrouter" aus der TOML durchsickerte und Stub-LLMs ohne stream()
auf den echten OpenRouter durchfielen ("OPENROUTER_API_KEY is empty").

Ergebnis: 213 passed (vorher 164 passed / 3 failed). DEPLOYMENT.md Teil 4.0
dokumentiert den Pflicht-Testlauf vor jedem Deploy.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Dieter Schlüter 2026-06-25 00:32:47 +02:00
commit 3c549a05b1
5 changed files with 280 additions and 1 deletions

View file

@ -1032,7 +1032,26 @@ sudo systemctl reload nginx
## Teil 4: Verifikation
> Zuletzt vollständig getestet: 2026-06-24 — Piper alle 10 Sprachen ✓, Cartesia DE/EN/FR/ES/PT/ZH ✓
> Zuletzt vollständig getestet: 2026-06-25 — pytest 213 passed ✓, Piper alle 10 Sprachen ✓, Cartesia DE/EN/FR/ES/PT/ZH ✓
### 4.0 Automatische Test-Suite (PFLICHT vor jedem Deploy)
Die pytest-Suite läuft offline und deterministisch (keine echten Netz-/API-Aufrufe,
keine Stimm-Modelle nötig). Vor jedem Deploy ausführen — muss **grün** sein:
```bash
cd /opt/voice-assistant
sudo -u voice .venv/bin/pip install -q -e '.[test]' # einmalig: pytest installieren
sudo -u voice .venv/bin/python -m pytest -q
# Erwartet: "213 passed"
```
Abdeckung u. a.: Stimm-/Geschlechts-Routing (`voice_for_route`), Piper Multi-Speaker
(`#speaker_id`) und Gender-Code-Auflösung, Cartesia Voice-Map + nicht unterstützte
Sprachen, Cartesia→Piper-Fallback. Die Fixture in `tests/conftest.py` neutralisiert
die Deployment-Fallback-Ketten (`*_fallback`), damit Tests hermetisch bleiben.
### 4.1 Manuelle Smoke-Checks
```bash
# Service läuft?