Résilience Réseau & Circuit-Breaker
Un assistant vocal souverain doit rester opérationnel en toutes circonstances, y compris lorsque la connexion Internet de votre domicile est interrompue ou que les services cloud tiers subissent une panne.
SovereignDot intègre un sous-système de résilience architecturé selon le pattern Circuit-Breaker (core_server/resilience.py).
🛡️ Machine à États du Circuit-Breaker
Le disjoncteur réseau surveille en continu la santé des appels vers les API distantes (Edge-TTS et OpenRouter) :
stateDiagram-v2
[*] --> CLOSED: Démarrage normal
CLOSED --> OPEN: 2 Échecs Consécutifs (Timeout ou Erreur Réseau)
note right of CLOSED: Mode Cloud Standard<br/>Edge-TTS + OpenRouter
OPEN --> HALF_OPEN: Après 30 secondes d'attente
note right of OPEN: Mode Secours Hors-Ligne Instantané<br/>Synthèse Locale Piper ONNX (<300ms)<br/>Modèle Local Ollama (Qwen 2.5)
HALF_OPEN --> CLOSED: 1 Succès Cloud Confirmé
HALF_OPEN --> OPEN: Échec de la sonde cloud
1. État CLOSED (Fonctionnement Normal)
- Toutes les synthèses vocales utilisent Microsoft Edge-TTS haute fidélité (
fr-FR-HenriNeural). - Les requêtes complexes exploitent le modèle distant Google Gemini via OpenRouter.
- Tout appel dépassant le timeout strict de 1,5 seconde est considéré comme une anomalie.
2. État OPEN (Panne Détectée / Mode Hors-Ligne)
- Dès que 2 échecs consécutifs sont constatés, le disjoncteur bascule immédiatement en mode
OPEN. - Zéro tentative d'appel réseau : les requêtes cloud sont court-circuitées sans attendre d'erreur réseau.
- La synthèse vocale est confiée instantanément au moteur neuronal embarqué Piper ONNX.
- Les intentions complexes sont réacheminées vers Ollama (Qwen 2.5) sur le réseau local.
3. État HALF_OPEN (Sonde de Rétablissement)
- Au bout de 30 secondes (paramétrable via
CIRCUIT_BREAKER_RESET_TIMEOUT_SEC), une requête sonde est autorisée vers le cloud. - Si elle aboutit, le circuit se referme (
CLOSED) et reprend son régime de croisière. - Si elle échoue, le circuit se rouvre immédiatement sans perturber l'expérience vocale de l'utilisateur.
🎙️ Le Moteur Hors-Ligne Piper ONNX
Piper est un moteur de synthèse vocale ultra-rapide basé sur l'architecture VITS et exécuté via ONNX Runtime sur CPU.
- Modèle officiel :
fr_FR-upmc-medium(63 Mo). - Auto-Téléchargement : Téléchargé et vérifié automatiquement au premier démarrage de SovereignDot.
- Performances : Synthèse d'une phrase complète en moins de 280 millisecondes sur un processeur standard (sans GPU).
- Empreinte mémoire : Moins de 120 Mo de RAM.
🗣️ Interroger l'État du Réseau à la Voix
Vous pouvez demander à tout moment à l'assistant :
« Régis, quel est l'état du réseau ? »
SovereignDot répondra instantanément avec l'état exact du circuit :
« Le circuit réseau est CLOSED. Nous sommes connecté au cloud. 0 bascules de secours enregistrées. »
ou
« Le circuit réseau est OPEN. Nous sommes hors ligne avec repli local Piper ONNX. 1 bascules de secours enregistrées. »