FAQ & Dépannage¶

Questions fréquentes et solutions pour Stridevox.

Général¶

Quelles données Stridevox accède-t-il depuis mon compte Garmin ?

Stridevox lit vos activités (courses, sorties vélo, natation, etc.), vos données de sommeil (phases, durée) et vos résumés quotidiens (pas, calories, Body Battery, stress). Il n'accède pas à vos informations personnelles comme votre nom, adresse ou coordonnées bancaires.

Mes données sont-elles envoyées à des tiers ?

Vos données fitness sont envoyées au fournisseur d'IA que vous avez configuré (xAI, OpenAI, Anthropic, Google ou Azure) dans le cadre des conversations de chat. Elles ne sont pas partagées avec qui que ce soit d'autre. Vos identifiants Garmin et vos clés API sont chiffrés et stockés localement sur votre serveur.

Puis-je utiliser Stridevox sans compte Garmin ?

Stridevox est conçu autour de l'intégration Garmin Connect. Sans compte Garmin, le Tableau de bord, les Activités, les Graphiques et les Records personnels n'auront pas de données. La fonctionnalité Chat fonctionnerait, mais sans contexte fitness à analyser.

Quelles langues Stridevox prend-il en charge ?

L'interface est disponible en anglais, français et espagnol. Le chat IA peut répondre dans n'importe quelle langue supportée par votre fournisseur d'IA — il suffit de définir la langue du chat ou de poser votre question dans la langue de votre choix.

Problèmes de connexion¶

Je n'arrive pas à me connecter à Garmin — que faire ?

Vérifiez vos identifiants — Assurez-vous que l'email correspond à votre compte Garmin Connect
Code MFA expiré — Les codes MFA Garmin expirent en environ 60 secondes. Cliquez à nouveau sur Connecter pour obtenir un nouveau code
Limitation de débit Garmin — Si vous avez fait trop de tentatives, attendez 2 à 3 minutes
Panne Garmin — Vérifiez connect.garmin.com pour voir si Garmin est en panne

Mes données n'apparaissent pas après la synchronisation

Vérifiez le statut du cache dans les Paramètres pour confirmer que les données ont bien été synchronisées
Assurez-vous que votre Limite d'activités est suffisamment élevée pour inclure les activités attendues
Essayez un Rafraîchissement complet pour reconstruire le cache de zéro
Vérifiez les Tâches en arrière-plan pour tout échec de synchronisation

La synchronisation prend très longtemps

Les synchronisations initiales volumineuses (des centaines d'activités) peuvent prendre plusieurs minutes. Utilisez Lancer un rafraîchissement complet pour l'exécuter en tâche de fond afin de continuer à utiliser l'application. L'indicateur de progression montre l'avancement.

Chat IA¶

L'IA ne connaît pas ma séance récente

L'IA utilise les données en cache. Si vous venez de terminer un entraînement :

Attendez qu'il se synchronise avec Garmin Connect (vérifiez l'application Garmin)
Cliquez sur Synchroniser (Rapide) dans les Paramètres
Retournez dans le Chat et posez à nouveau votre question

L'IA donne des informations incorrectes sur mes données

Assurez-vous que vos données sont synchronisées et à jour
Essayez de démarrer une nouvelle session de chat (les longues sessions accumulent du contexte qui peut perturber l'IA)
Essayez un modèle ou un fournisseur d'IA différent pour comparer
Vérifiez si le problème est spécifique à une séance (elle peut avoir des données Garmin incomplètes)

Puis-je changer de fournisseur d'IA en cours de conversation ?

Oui. Le changement de fournisseur dans les Paramètres prend effet immédiatement pour les nouveaux messages. Votre historique de chat existant est préservé.

Comment réduire les coûts d'API de l'IA ?

Démarrez de nouvelles sessions de chat pour des sujets sans rapport (moins de contexte = moins de tokens)
Utilisez des modèles plus rapides/moins chers (ex. Gemini Flash, GPT-3.5) pour les questions simples
Réservez les modèles avancés pour les analyses approfondies

Activités¶

Pourquoi certaines activités n'ont-elles pas de carte ?

Les cartes nécessitent des données GPS. Les activités en intérieur (courses sur tapis, vélo d'intérieur) et certaines activités créées manuellement n'ont pas de traces GPS, donc aucune carte n'est affichée.

Comment fonctionne la comparaison d'activités ?

Sélectionnez 2 à 5 activités en mode Comparaison, puis cliquez sur Comparer maintenant. Le tableau de comparaison affiche les métriques clés côte à côte avec les meilleures valeurs mises en évidence. Les meilleurs résultats sont colorés pour une identification facile.

Puis-je partager une activité avec quelqu'un qui n'utilise pas Stridevox ?

Oui ! Les liens de partage d'activité sont des pages publiques que n'importe qui peut consulter dans un navigateur sans compte. Vous pouvez éventuellement ajouter un mot de passe et une date d'expiration.

Records personnels¶

Pourquoi mes records personnels ne s'affichent-ils pas ?

Les records sont calculés à partir de vos activités en cache. Assurez-vous d'avoir synchronisé vos données
Cliquez sur Recalculer sur la page des Records personnels pour forcer un rafraîchissement
Seuls certains types d'activités sont éligibles aux records (course à pied, cyclisme, etc.)

Un record semble incorrect — comment le corriger ?

Cliquez sur Recalculer pour reconstruire les records à partir de vos données en cache actuelles. Si les données Garmin sous-jacentes sont incorrectes, le record le reflétera.

Sécurité¶

J'ai perdu mon application d'authentification — comment me connecter ?

Utilisez un de vos codes de secours (si vous les avez sauvegardés lors de la configuration 2FA)
Si vous n'avez pas de codes de secours, demandez à un administrateur de réinitialiser votre MFA depuis le Panneau d'administration
Après la réinitialisation MFA, vous pouvez vous connecter avec votre mot de passe uniquement et éventuellement réactiver la 2FA

J'ai oublié mon mot de passe

Si vous avez un email configuré : Cliquez sur Mot de passe oublié sur l'écran de connexion et vérifiez votre email pour un lien de réinitialisation
Si vous n'avez pas d'email configuré : Demandez à un administrateur de réinitialiser votre mot de passe depuis le Panneau d'administration

Plusieurs personnes peuvent-elles utiliser Stridevox ?

Oui ! Le premier utilisateur est l'administrateur et peut créer des comptes supplémentaires depuis le Panneau d'administration. Chaque utilisateur connecte son propre compte Garmin et dispose de son propre historique de chat, de ses paramètres et de ses données.

Technique¶

Quelle base de données Stridevox utilise-t-il ?

Stridevox prend en charge à la fois SQLite (par défaut, aucune installation nécessaire) et PostgreSQL (pour les déploiements en production/multi-workers). SQLite est recommandé pour les déploiements mono-utilisateur ou en petite équipe.

Puis-je exécuter Stridevox sur un Raspberry Pi ?

Stridevox est suffisamment léger pour fonctionner sur un Raspberry Pi 4 ou plus récent. Utilisez SQLite pour la base de données et un modèle d'IA plus léger pour de meilleures performances.

Comment mettre à jour Stridevox ?

Récupérez le dernier code et redémarrez :

cd stridevox
git pull origin master
cd backend
pip install -r requirements.txt
sudo systemctl restart stridevox

Pour le frontend, copiez les fichiers mis à jour vers la racine de votre serveur web.

Où sont stockées mes sauvegardes ?

Les sauvegardes sont stockées dans le répertoire backups/ à l'intérieur du dossier backend. Vous pouvez également les télécharger depuis les Paramètres pour un stockage hors ligne.