Clustraly
Assistant vocal

Page de diagnostics et de réinitialisation : sachez en un écran si l'assistant vocal fonctionne

Page de diagnostics et de réinitialisation une fonctionnalité du module Assistant vocal de Clustraly. La page de diagnostics et de réinitialisation teste tout le sous-système vocal, serveur et navigateur, en vert/rouge, et remet vos réglages à zéro.

Un auto-test à /admin/voice/diagnostics vérifie le serveur et ce navigateur, lance des tests micro et voix en direct, puis vous laisse tout réinitialiser. L'IA propose, vous décidez.

Vert ou rouge, sans ambiguïté

Un seul écran vous dit si la voix fonctionne

Ouvrez /admin/voice/diagnostics et lisez le verdict. Chaque brique du sous-système vocal, côté serveur et côté navigateur, passe au vert ou au rouge, et une bannière en langage clair résume le diagnostic. Vous arrêtez de deviner pourquoi « OK Clustraly » reste muet.

  • Auto-test serveur + ce navigateur au même endroit
  • Bannière DIAGNOSIS en langage clair
  • Statut vert/rouge pour chaque vérification
Ouvrir /admin/voice/diagnostics
Fini les uploads à moitié à jour

Repérez un déploiement obsolète avant qu'il ne casse la voix

La page relève la signature de chaque fichier vocal déployé existence, taille, date de modification, empreinte md5 courte et vérifie la présence des chaînes-clés comme voice-dialogue, voice-execute ou voice-dictate-btn. Un fichier chargé par FTP et resté à moitié à jour se voit immédiatement.

Le rapport serveur confirme aussi les tables attendues, la clé IA Claude, l'état du kill switch, vos quatre drapeaux, les clés i18n et la liste des endpoints vocaux.

  • Signatures md5, taille, mtime et existence
  • Détection des chaînes-fonctionnalités attendues
  • Tables et clé IA Claude vérifiées
  • Vos 4 drapeaux et le kill switch affichés
Testez pour de vrai, pas en théorie

Micro, voix parlée et endpoint à l'épreuve, en direct

Cliquez pour pinger l'endpoint de recherche, lancer un self-test, parler dans le micro ou écouter une réponse parlée. Côté navigateur, la page contrôle le support de SpeechRecognition et de la synthèse, le chargement des scripts et de la config, le contexte sécurisé, la présence de Brave et l'état de la permission micro.

  • Ping d'endpoint GET /admin/api/command-search
  • Test micro et test de réponse parlée (TTS) en direct
  • Support navigateur, contexte sécurisé, permission micro
  • Détection Brave et scripts/config bien chargés
Repartez proprement

Réinitialisez votre compte ou tout le monde, au choix

« Réinitialiser mon compte » supprime vos quatre drapeaux et rejoue l'onboarding comme au premier jour. « Réinitialiser tout le monde » remet à zéro l'ensemble des comptes, vide les clarifications apprises et réactive la voix pour tous. À vous de décider de la portée.

Un bouton dédié vide aussi le cache vocal local du navigateur (localStorage) pour repartir sur un état propre côté client.

  • Reset compte : rejoue l'onboarding depuis zéro
  • Reset global : tous les comptes d'un seul geste
  • Vide les clarifications apprises (command_menu_learned)
  • Vide le cache vocal local du navigateur
Des garde-fous, pas des surprises

Les actions lourdes restent sous contrôle

La réinitialisation globale exige le droit settings.edit et chaque exécution est auditée sous voice.reset_global. Le kill switch administrateur, s'il est actif, est signalé en ligne rouge sur la page. Rien de destructif ne part sans permission ni trace, et la lecture des réglages reste fail-open pour ne jamais provoquer d'erreur 500.

  • Reset global protégé par le droit settings.edit
  • Chaque reset global audité (voice.reset_global)
  • Kill switch actif signalé en ligne rouge
  • Lecture fail-open, jamais de 500 sur l'admin
Pourquoi ça compte

L'IA propose, vous décidez même pour tout remettre à zéro

La page de diagnostics ne touche à rien sans votre clic. Elle expose l'état réel du sous-système vocal, serveur et navigateur, puis vous laisse le dernier mot sur chaque test et chaque réinitialisation.

FAQ

Questions fréquentes

Où se trouve la page de diagnostics et de réinitialisation ?
Elle est accessible aux administrateurs à /admin/voice/diagnostics. Elle réunit l'auto-test serveur et navigateur, les tests micro et TTS en direct, le ping d'endpoint et les boutons de réinitialisation.
À quoi servent les signatures de fichiers déployés ?
Elles affichent l'existence, la taille, la date de modification et l'empreinte md5 courte de chaque fichier vocal, plus la présence des chaînes-clés attendues. Vous repérez ainsi un upload FTP obsolète ou incomplet avant qu'il ne casse la voix.
Quelle différence entre réinitialiser mon compte et tout le monde ?
« Mon compte » supprime vos quatre drapeaux pour rejouer l'onboarding. « Tout le monde » remet à zéro tous les comptes, vide les clarifications apprises et réactive la voix pour tous ; cette action exige le droit settings.edit et est auditée.
Une réinitialisation peut-elle casser l'administration ?
Les actions restent contrôlées : le reset global demande une permission dédiée et chaque exécution est journalisée. La lecture des réglages est fail-open, donc un incident n'entraîne jamais d'erreur 500 sur l'admin.
Prêt à commencer ?

Gardez l'assistant vocal en pleine forme

Un doute sur le micro, un déploiement récent à vérifier, un onboarding à rejouer ? Ouvrez la page de diagnostics et de réinitialisation, lisez le vert/rouge, testez en direct et repartez sur des bases saines vous gardez la main à chaque étape.